repo-tool

README

repo-tool

A tool to handle multiple git repositories.

• Requirements git and go

This tool uses the same format for configuration manifest files that google uses with its python tool Note it is NOT compatible with a project checked out using the git-repo tool, it only reads the same type of manifest files

As time passes this will become more complete, currently it only works with a single manifest (default.xml), you can do something like

repo-tool init -u git@github.com/notzippy/some_test_manifest.git

and volia you have a project folder with your repository tree nicely checked out in it. Besides repo-tool init and repo-tool sync repo-tool status is also supported to let you know what state all the repositories are in.

Your manifest file can have different branches, based on your manifest branch you can checkout different branches for your project. For example look at this manifest and this one. If you have initialized the repo with the first you can switch to the develop branch (of the manifest, which will automatically switch all the projects to the appropriate branch as well). Like this

repo-tool sync -b develop

Future work to do (in no particular order)

1. Support committing all or list of repositories
2. Support multiple manifest files (and see if remove-project works)
3. Check windows support (it should work)
4. Support running an arbitrary git command against all the projects

##Details

Each project is checked out using the url, revision and path specified in the project manifest file. When the project is checked out the branch is not in a detached state, it is pointing to the branch specified in the manifest file.

Overlay Support

Typical workflow for Github and others now has the developers use their own repository to commit changes to and then do a pull request to the master repository. With overlay support this repository manager now allows you to do the same. The workflow is the same, you create a manifest file for the repositories in the master. Then you create another manifest file for your own repository. You can fork the master or have a custom subset, or even include additional repositories

For example lets say your main repository looks like this

<?xml version="1.0" encoding="UTF-8"?>
<manifest>
  <remote  name="gh" revision="master"
           fetch="https://github.com/" />

  <remote  name="nz"
           fetch="git://github.com/notzippy"
           revision="master"/>
  <default revision="refs/heads/master"
           remote="nz"/>

  <project name="repo-tool"   remote="repo-tool" path="src/github.com/notzippy/repo-tool" groups="core,all" />

  <project name="examples"  remote="revel" path="src/github.com/revel/examples"   groups="docs,all" />
  <project name="rfcs"     remote="revel" path="src/github.com/revel/rfcs"      groups="docs,all,notdefault" />
  <project name="revel.github.io"  remote="revel" path="src/github.com/revel/revel.github.io"   groups="docs,all,notdefault" />
  <project name="revelframework.com"  remote="revel" path="src/github.com/revel/revelframework.com"   groups="docs,all,notdefault" />

</manifest>

###Updates

• Switched to worker pools for checkout process, errors are summarized at bottom
• Fixed out of range issue
• Add hg support, repotype attribute supported in both project and remote levels. Defaults to "git" supports "hg" as well
• Added -j flag, applicable to both sync and init, defaults to 1 job (ie checkout one project at a time), can be set higher sub in a number after the j for example -j4 (checkout 4 projects at a time)
• Added -g flag, applicable to init, checkout specific groups see manifest for details
• Added switching based on branch of manifest file