[[PageOutline(2-5,Contents,pullout)]]

= Integrate a directory of Mercurial repositories =

== Description ==

Allows one to add a whole directory of Mercurial repositories to Trac. Also adds the optional ability to create and delete repositories.

The plugin requires Trac-0.12 (which supports multiple repositories).

== Bugs/Feature Requests == 

Existing bugs and feature requests for HgDirManagerPlugin are 
[https://bitbucket.org/avakar/trac-hgdirmanager/issues here].

If you have any issues, create a 
[https://bitbucket.org/avakar/trac-hgdirmanager/issues/new new ticket].

== Download and Install ==

You will have to download and install [http://trac.edgewall.org/wiki/TracMercurial TracMercurial] first.

Once that's done, checkout the sources for the !HgDirManager plugin [http://bitbucket.org/avakar/trac-hgdirmanager from the repository].
Use the setup script to create an egg, which you can then copy to the {{{plugin}}} directory in your Trac environment.
{{{
hg clone http://bitbucket.org/avakar/trac-hgdirmanager
cd trac-hgdirmanager
python ./setup.py bdist_egg
}}}

== Example ==

Add the following to your trac.ini.

{{{
[hgdir]
base_path = /path/to/hg/repos
recurse = False
url_prefix = http://base/url/where/repos/are/mapped
}}}

You'll then see all Mercurial repos in {{{base_path}}} in the Trac's source browser.

Users that have REPO_CREATE privilege can create new repositories in that path by navigating to /newhgrepo page (you can add a link to your WikiStart page for example).

You can give users the REPO_DELETE privilege, which will allow them to delete ''empty'' repositories (navigate to /deletehgrepo/name-of-repo).

In the unlikely case you want to give your users the ability to ''irreversibly'' delete non-empty repositories, give them both REPO_DELETE and REPO_DELETE_NONEMPTY privileges.

== Author/Contributors ==

'''Author:''' [wiki:avakar] [[BR]]
'''Maintainer:''' [wiki:avakar] [[BR]]
'''Contributors:'''