gitrepo 2.4.1.post28

Repo helps manage many Git repositories, does the uploads to revision control systems, and automates parts of the development workflow.

repo

Repo is a tool built on top of Git. Repo helps manage many Git repositories, does the uploads to revision control systems, and automates parts of the development workflow. Repo is not meant to replace Git, only to make it easier to work with Git. The repo command is an executable Python script that you can put anywhere in your path.

• Homepage: https://gerrit.googlesource.com/git-repo/
• Mailing list: repo-discuss on Google Groups
• Bug reports: https://bugs.chromium.org/p/gerrit/issues/list?q=component:repo
• Source: https://gerrit.googlesource.com/git-repo/
• Overview: https://source.android.com/source/developing.html
• Docs: https://source.android.com/source/using-repo.html
• repo Manifest Format
• repo Hooks
• Submitting patches
• Running Repo in Microsoft Windows
• GitHub mirror: https://github.com/GerritCodeReview/git-repo
• Postsubmit tests: https://github.com/GerritCodeReview/git-repo/actions

Contact

Please use the repo-discuss mailing list or issue tracker for questions.

You can file a new bug report under the "repo" component.

Please do not e-mail individual developers for support. They do not have the bandwidth for it, and often times questions have already been asked on repo-discuss or bugs posted to the issue tracker. So please search those sites first.

Install

Many distros include repo, so you might be able to install from there.

# Debian/Ubuntu.
$ sudo apt-get install repo

# Gentoo.
$ sudo emerge dev-vcs/repo

You can install it manually as well as it's a single script.

$ mkdir -p ~/.bin
$ PATH="${HOME}/.bin:${PATH}"
$ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/.bin/repo
$ chmod a+rx ~/.bin/repo

About pypi version

Version in pypi is not the official version from google, but a friendly fork (https://github.com/tardyp/google-repo), with support for normal setup.py style installation

• local imports replaced by module imports, "repo" being the name of the python module
• subcommand discovery uses the python entrypoint system
• support for custom repo subcommand in an separate python package

It would be difficult to support a version that supports all of that and the legacy installation mode, this is why we didn't work on upstreaming it yet.

This version is used in a large installation and backup by automated internal tests that we cannot really share yet (as dependent on our infra)

Installation

pip3 install --user gitrepo

Custom commands

• create a python module starting from any example in the repo/subcmds directory

• add an entrypoint to your setup.py module:

  setup(...,
    install_requires=["gitrepo"],
    entry_points={
      'repo.subcmds': [
        'my_custom_cmd = mycustomrepo.my_custom_cmd:CustomCmd',
    }
  )

Then you can ask your developers to install your own mycustomrepo package instead of the gitrepo package.