README.rst
55 lines
| 2.2 KiB
| text/x-rst
|
RstLexer
r254 | ------------------------------------- | ||
r253 | Pylons based replacement for hgwebdir | ||
r254 | ------------------------------------- | ||
r253 | |||
Fully customizable, with authentication, permissions. Based on vcs library. | |||
r254 | |||
**Overview** | |||
- has it's own middleware to handle mercurial protocol request each request can | |||
r253 | be logged and authenticated + threaded performance unlikely to hgweb | ||
r325 | - full permissions per project read/write/admin access even on mercurial request | ||
r253 | - mako templates let's you cusmotize look and feel of appplication. | ||
- diffs annotations and source code all colored by pygments. | |||
r290 | - mercurial branch graph | ||
r253 | - admin interface for performing user/permission managments as well as repository | ||
managment | |||
r325 | - backup scripts can do backup of whole app and send it over scp to desired location | ||
r290 | - setup project descriptions and info inside built in db for easy, non | ||
file-system operations | |||
r253 | - added cache with invalidation on push/repo managment for high performance and | ||
always upto date data. | |||
- rss /atom feed customizable | |||
- future support for git | |||
- based on pylons 1.0 / sqlalchemy 0.6 | |||
r254 | **Incoming** | ||
r253 | |||
r325 | - code review based on hg-review (when it's stable) | ||
r253 | - git support (when vcs can handle it) | ||
r325 | - other cools stuff that i can figure out | ||
r253 | |||
.. note:: | |||
This software is still in beta mode. I don't guarantee that it'll work. | |||
------------- | |||
Installation | |||
------------- | |||
r325 | .. note:: | ||
I recomend to install tip version of vcs while the app is in beta mode. | |||
r327 | - create new virtualenv and activate it - highly recommend that you use separate | ||
virtual-env for whole application | |||
r325 | - download hg app from default (not demo) branch from bitbucket and run | ||
'python setup.py install' this will install all required dependencies needed | |||
r327 | - run paster setup-app production.ini it should create all needed tables | ||
and an admin account. Also it will create repositories.config for mercurial | |||
commands, remember that the given path for mercurial repositories must be write | |||
accessible for the application | |||
- run paster serve development.ini - or you can use manage-hg_app script. | |||
r254 | the app should be available at the 127.0.0.1:5000 | ||
r325 | - use admin account you created to login. | ||
- default permissions on each repository is read, and owner is admin. So remember | |||
to update those. | |||