Mercurial > kallithea
annotate README.rst @ 549:f99075170eb4
more renames for rhode code !!
| author | Marcin Kuzminski <marcin@python-works.com> |
|---|---|
| date | Wed, 06 Oct 2010 03:34:18 +0200 |
| parents | 1e757ac98988 |
| children | 2642f128ad46 |
| rev | line source |
|---|---|
|
549
f99075170eb4
more renames for rhode code !!
Marcin Kuzminski <marcin@python-works.com>
parents:
547
diff
changeset
|
1 -------------------------------------------------------------- |
|
f99075170eb4
more renames for rhode code !!
Marcin Kuzminski <marcin@python-works.com>
parents:
547
diff
changeset
|
2 Pylons based repository management for mercurial (and soon git) |
|
f99075170eb4
more renames for rhode code !!
Marcin Kuzminski <marcin@python-works.com>
parents:
547
diff
changeset
|
3 -------------------------------------------------------------- |
|
253
7effcce03192
docs update, developments serves statics as default
Marcin Kuzminski <marcin@python-works.com>
parents:
244
diff
changeset
|
4 |
|
7effcce03192
docs update, developments serves statics as default
Marcin Kuzminski <marcin@python-works.com>
parents:
244
diff
changeset
|
5 Fully customizable, with authentication, permissions. Based on vcs library. |
| 254 | 6 |
| 7 **Overview** | |
| 8 | |
| 9 - has it's own middleware to handle mercurial protocol request each request can | |
|
253
7effcce03192
docs update, developments serves statics as default
Marcin Kuzminski <marcin@python-works.com>
parents:
244
diff
changeset
|
10 be logged and authenticated + threaded performance unlikely to hgweb |
| 325 | 11 - full permissions per project read/write/admin access even on mercurial request |
|
540
efbab97c3aca
fixed some spelling mistakes
Marcin Kuzminski <marcin@python-works.com>
parents:
523
diff
changeset
|
12 - mako templates let's you customize look and feel of application. |
|
224
fdcef6ea3b55
Added readme, and changed version display
Marcin Kuzminski <marcin@python-works.com>
parents:
0
diff
changeset
|
13 - diffs annotations and source code all colored by pygments. |
| 523 | 14 - mercurial branch graph and yui-flot powered graphs with zooming and statistics |
|
540
efbab97c3aca
fixed some spelling mistakes
Marcin Kuzminski <marcin@python-works.com>
parents:
523
diff
changeset
|
15 - admin interface for performing user/permission managements as well as repository |
|
549
f99075170eb4
more renames for rhode code !!
Marcin Kuzminski <marcin@python-works.com>
parents:
547
diff
changeset
|
16 management. |
|
f99075170eb4
more renames for rhode code !!
Marcin Kuzminski <marcin@python-works.com>
parents:
547
diff
changeset
|
17 - server side forks, it's possible to fork a project and hack it free without |
|
f99075170eb4
more renames for rhode code !!
Marcin Kuzminski <marcin@python-works.com>
parents:
547
diff
changeset
|
18 breaking the main. |
|
498
6aa7db1c083a
version bump, small readme update
Marcin Kuzminski <marcin@python-works.com>
parents:
402
diff
changeset
|
19 - full text search of source codes with indexing daemons using whoosh |
|
6aa7db1c083a
version bump, small readme update
Marcin Kuzminski <marcin@python-works.com>
parents:
402
diff
changeset
|
20 (no external search servers required all in one application) |
|
6aa7db1c083a
version bump, small readme update
Marcin Kuzminski <marcin@python-works.com>
parents:
402
diff
changeset
|
21 - async tasks for speed and performance using celery (works without them too) |
|
402
757c7eef0dcd
implemented gravatars into main bar.
Marcin Kuzminski <marcin@python-works.com>
parents:
392
diff
changeset
|
22 - Additional settings for mercurial web, (hooks editable from admin |
|
757c7eef0dcd
implemented gravatars into main bar.
Marcin Kuzminski <marcin@python-works.com>
parents:
392
diff
changeset
|
23 panel !) also manage paths, archive, remote messages |
| 325 | 24 - backup scripts can do backup of whole app and send it over scp to desired location |
|
290
702c7e565c56
docs update, version bump
Marcin Kuzminski <marcin@python-works.com>
parents:
254
diff
changeset
|
25 - setup project descriptions and info inside built in db for easy, non |
|
702c7e565c56
docs update, version bump
Marcin Kuzminski <marcin@python-works.com>
parents:
254
diff
changeset
|
26 file-system operations |
|
540
efbab97c3aca
fixed some spelling mistakes
Marcin Kuzminski <marcin@python-works.com>
parents:
523
diff
changeset
|
27 - added cache with invalidation on push/repo management for high performance and |
|
efbab97c3aca
fixed some spelling mistakes
Marcin Kuzminski <marcin@python-works.com>
parents:
523
diff
changeset
|
28 always up to date data. |
|
402
757c7eef0dcd
implemented gravatars into main bar.
Marcin Kuzminski <marcin@python-works.com>
parents:
392
diff
changeset
|
29 - rss / atom feeds, gravatar support |
|
224
fdcef6ea3b55
Added readme, and changed version display
Marcin Kuzminski <marcin@python-works.com>
parents:
0
diff
changeset
|
30 - based on pylons 1.0 / sqlalchemy 0.6 |
| 0 | 31 |
| 254 | 32 **Incoming** |
|
253
7effcce03192
docs update, developments serves statics as default
Marcin Kuzminski <marcin@python-works.com>
parents:
244
diff
changeset
|
33 |
| 325 | 34 - code review based on hg-review (when it's stable) |
|
498
6aa7db1c083a
version bump, small readme update
Marcin Kuzminski <marcin@python-works.com>
parents:
402
diff
changeset
|
35 - git support (when vcs can handle it - almost there !) |
|
6aa7db1c083a
version bump, small readme update
Marcin Kuzminski <marcin@python-works.com>
parents:
402
diff
changeset
|
36 - commit based wikis |
|
549
f99075170eb4
more renames for rhode code !!
Marcin Kuzminski <marcin@python-works.com>
parents:
547
diff
changeset
|
37 - clonning from remote repositories into rhodecode (git/mercurial) |
|
498
6aa7db1c083a
version bump, small readme update
Marcin Kuzminski <marcin@python-works.com>
parents:
402
diff
changeset
|
38 - other cools stuff that i can figure out (or You can help me figure out) |
|
241
48727add84c9
Made repos path config configurable from pylons app configs. update Readme
Marcin Kuzminski <marcin@python-works.com>
parents:
224
diff
changeset
|
39 |
|
253
7effcce03192
docs update, developments serves statics as default
Marcin Kuzminski <marcin@python-works.com>
parents:
244
diff
changeset
|
40 .. note:: |
|
392
b27d32cb3157
Implemented hooks system,
Marcin Kuzminski <marcin@python-works.com>
parents:
364
diff
changeset
|
41 This software is still in beta mode. |
|
b27d32cb3157
Implemented hooks system,
Marcin Kuzminski <marcin@python-works.com>
parents:
364
diff
changeset
|
42 I don't guarantee that it'll work correctly. |
|
253
7effcce03192
docs update, developments serves statics as default
Marcin Kuzminski <marcin@python-works.com>
parents:
244
diff
changeset
|
43 |
|
241
48727add84c9
Made repos path config configurable from pylons app configs. update Readme
Marcin Kuzminski <marcin@python-works.com>
parents:
224
diff
changeset
|
44 |
|
253
7effcce03192
docs update, developments serves statics as default
Marcin Kuzminski <marcin@python-works.com>
parents:
244
diff
changeset
|
45 ------------- |
|
7effcce03192
docs update, developments serves statics as default
Marcin Kuzminski <marcin@python-works.com>
parents:
244
diff
changeset
|
46 Installation |
|
7effcce03192
docs update, developments serves statics as default
Marcin Kuzminski <marcin@python-works.com>
parents:
244
diff
changeset
|
47 ------------- |
| 523 | 48 |
|
549
f99075170eb4
more renames for rhode code !!
Marcin Kuzminski <marcin@python-works.com>
parents:
547
diff
changeset
|
49 - I highly recommend to install new virtualenv for rhodecode see |
| 523 | 50 http://pypi.python.org/pypi/virtualenv |
|
549
f99075170eb4
more renames for rhode code !!
Marcin Kuzminski <marcin@python-works.com>
parents:
547
diff
changeset
|
51 - Create new virtualenv using `virtualenv --no-site-packages /var/www/rhodecode-venv` |
|
f99075170eb4
more renames for rhode code !!
Marcin Kuzminski <marcin@python-works.com>
parents:
547
diff
changeset
|
52 this will install new virtual env into /var/www/rhodecode-venv. |
| 523 | 53 Activate the virtualenv by running |
|
549
f99075170eb4
more renames for rhode code !!
Marcin Kuzminski <marcin@python-works.com>
parents:
547
diff
changeset
|
54 `source activate /var/www/rhodecode-venv/bin/activate` |
|
f99075170eb4
more renames for rhode code !!
Marcin Kuzminski <marcin@python-works.com>
parents:
547
diff
changeset
|
55 - Make a folder for rhodecode somewhere on the filesystem for example /var/www/rhodecode |
|
f99075170eb4
more renames for rhode code !!
Marcin Kuzminski <marcin@python-works.com>
parents:
547
diff
changeset
|
56 - Download and extract http://bitbucket.org/marcinkuzminski/rhodecode/get/tip.zip |
| 523 | 57 into created directory. |
| 58 - Run `python setup.py install` in order to install the application and all | |
| 59 needed dependencies. Make sure that You're using activated virutalenv | |
| 60 - Run `paster setup-app production.ini` it should create all needed tables | |
|
498
6aa7db1c083a
version bump, small readme update
Marcin Kuzminski <marcin@python-works.com>
parents:
402
diff
changeset
|
61 and an admin account make sure You specify correct path to repositories. |
| 523 | 62 - Remember that the given path for mercurial repositories must be write |
|
327
0e87466a117e
updated installation instruction, made more user friendly way of creating all needed configs. All is done now from paster setup-app
Marcin Kuzminski <marcin@python-works.com>
parents:
325
diff
changeset
|
63 accessible for the application |
| 523 | 64 - Run paster serve development.ini - or you can use sample init.d scripts. |
| 254 | 65 the app should be available at the 127.0.0.1:5000 |
| 523 | 66 - Use admin account you created to login. |
| 67 - Default permissions on each repository is read, and owner is admin. So remember | |
|
402
757c7eef0dcd
implemented gravatars into main bar.
Marcin Kuzminski <marcin@python-works.com>
parents:
392
diff
changeset
|
68 to update these. |
| 523 | 69 - In order to use full power of async tasks, You must install message broker |
|
549
f99075170eb4
more renames for rhode code !!
Marcin Kuzminski <marcin@python-works.com>
parents:
547
diff
changeset
|
70 preferably rabbitmq and start celeryd daemon together with rhodecode. |
| 523 | 71 The app should gain a lot of speed and become much more responsible. |
| 72 For installation instructions You can visit: | |
| 73 http://ask.github.com/celery/getting-started/index.html. | |
|
549
f99075170eb4
more renames for rhode code !!
Marcin Kuzminski <marcin@python-works.com>
parents:
547
diff
changeset
|
74 - All needed configs are inside rhodecode ie. celeryconfig.py , production.ini |
| 523 | 75 You can configure the email, ports, loggers, workers from there. |
| 76 - For full text search You can either put crontab entry for | |
|
549
f99075170eb4
more renames for rhode code !!
Marcin Kuzminski <marcin@python-works.com>
parents:
547
diff
changeset
|
77 `python /var/www/rhodecode/rhodecode/lib/indexers/daemon.py incremental <path_to_repos>` |
| 523 | 78 or run indexer from admin panel. This will scann the repos given in the |
| 79 application setup or given path for daemon.py and each scann in incremental | |
| 80 mode will scann only changed files, | |
| 81 Hg Update hook must be activated to index the content it's enabled by default | |
| 82 after setup |