Multiple Repository Support for 0.12

This branch adds support for accessing multiple repositories inside one Trac project.

For now, there is support for the Mercurial (hg) and Subversion (direct-svnfs) type of repositories.

See:

• log:sandbox/multirepos
• log:sandbox/mercurial-plugin-0.12

Checkpoints:

• r6465: initial "release" of the branch, worksforme
• r6469: a few bug fixes

The approach is quite simple: beyond repository connectors, there's now repository providers (IRepositoryProvider components) which are responsible for make available a list of named repositories. That name can be arbitrary (in particular, it may contain '/' to denote a pseudo-hierarchy) and will be used as a prefix for any repository path. Actually, a more complete description of the approach can be found in this mail: ​One trac env for X repositories ?.

If the only repository known is the default one (i.e. the one defined in TracIni, section [trac] repository_...), then Trac behaves exactly as before. But IRepositoryProvider components can make other repositories available. In particular, the default RepositoryManager itself provides a list of repositories listed in a new [repositories] section in TracIni. See r6447 for more details.

Installation (with mercurial)

A current installation procedure which works is the following:

1. Check out the mercurial plugin:

   svn co http://svn.edgewall.com/repos/trac/sandbox/mercurial-plugin-0.12
   

2. build the mercurial plugin. From within the checked-out directory, build the egg file (it will end up in the dist subdirectory):

   python setup.py bdist_egg
   

3. Check out the multirepos branch:

   svn co http://svn.edgewall.com/repos/trac/sandbox/multirepos
   

4. Install the multirepos version of trac (from within the multirepos directory, as root):

   python setup.py install
   

5. Create your trac environment directory

6. Copy the mercurial plugin egg file to the <trac-env>/plugins directory

7. make sure the following is somewhere in <trac-env>/conf/trac.ini, adding all the desired repositories to the [repositories] section:

   [components]
   tracext.hg.* = enabled
   
   [repositories]
   my_repository_a.dir = <path_to_a_repository>
   my_repository_b.dir = <path_to_another_repository>
   
   [trac]
   repository_dir = <path_to_default_repository>
   repository_type = hg
   

8. Cross your fingers, and hope it works :)

TODO

• More IRepositoryProvider components:
  • HgForestRepositoryProvider, for providing forest repositories and all sub-repositories managed by each forest
    • work-in-progress on ​http://hg.trbs.net
    • in trac.conf use:

      [hg-forest]
      jdk7.dir = /path/to/mercurial/root/forest/repository/jdk7
      

  • HgParentDirRepositoryProvider, for listing all the working copies present in a given folder
    • work-in-progress on ​http://hg.trbs.net
    • in trac.conf use:

      [hg-parents]
      bunch.dir = /path/to/parent/directory/somedir
      

  • SvnParentDirRepositoryProvider, for listing all the Subversion repositories present in a given folder
• currently, a default repository needs to be defined, otherwise the versioncontrol modules are disabled
• fix AJAX query in annotate
• extend to cached repositories
• IRepositoryProvider must have a way to signal new content, in order to rebuild the repository name cache