Edgewall Software

Version 8 (modified by Christian Boos, 11 years ago) ( diff )

thanks!

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:

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
  1. Copy the mercurial plugin egg file to the <trac-env>/plugins directory
  1. 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
    
  2. Cross your fingers, and hope it works :)
    It really should or it's a bug ;-)

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
Note: See TracWiki for help on using the wiki.