Go to file
Mike Frysinger 1544afe460 python-support: update with current status & guidelines
This doc was written back in 2019 when we were planning on the Python 3
migration.  It isn't relevant anymore, and people are reading it thinking
we still support Python 2.  Rewrite it to match current requirements and
to make it clear there is no support for older versions.

Bug: 302871152
Change-Id: I2acf3aee1816a03ee0a70774db8bf4a23713a03f
Reviewed-on: https://gerrit-review.googlesource.com/c/git-repo/+/389455
Commit-Queue: Mike Frysinger <vapier@google.com>
Reviewed-by: Aravind Vasudevan <aravindvasudev@google.com>
Tested-by: Mike Frysinger <vapier@google.com>
2023-10-14 06:22:53 +00:00
.github/workflows github: add PR closer 2023-09-13 18:42:18 +00:00
docs python-support: update with current status & guidelines 2023-10-14 06:22:53 +00:00
hooks commit-msg: Sync commit-msg from gerrit 3.6.1 2022-07-29 01:29:19 +00:00
man update links from monorail to issuetracker 2023-06-14 21:19:58 +00:00
release isort: format codebase 2023-08-22 18:32:22 +00:00
subcmds Update logger.warn to logger.warning 2023-10-13 19:34:26 +00:00
tests git_command: Augment underlying git errors with suggestions 2023-10-06 18:21:45 +00:00
.flake8 flake8: exclude venv and .tox folder 2023-08-15 15:46:52 +00:00
.gitattributes Adds additional crlf clobber avoidance. 2016-06-22 08:36:45 +00:00
.gitignore Add parallelism to 'branches' command 2020-12-14 23:35:12 +00:00
.gitreview git-review: add config file 2021-11-15 01:39:36 +00:00
.isort.cfg isort: format codebase 2023-08-22 18:32:22 +00:00
.mailmap Update .mailmap 2020-02-13 04:49:55 +00:00
.project Set correct name in PyDev and Eclipse project config 2013-04-19 09:35:43 +09:00
.pydevproject Leverage the next keyword from python 2.7 2018-12-19 11:06:35 -08:00
color.py isort: format codebase 2023-08-22 18:32:22 +00:00
command.py isort: format codebase 2023-08-22 18:32:22 +00:00
completion.bash bash-completion: complete projects with repo forall 2021-07-27 06:20:52 +00:00
editor.py isort: format codebase 2023-08-22 18:32:22 +00:00
error.py gitc: drop support 2023-08-15 22:14:52 +00:00
event_log.py isort: format codebase 2023-08-22 18:32:22 +00:00
fetch.py isort: format codebase 2023-08-22 18:32:22 +00:00
git_command.py git_command: read1 needs a size in py3.6 2023-10-09 17:04:38 +00:00
git_config.py Use non-deprecated API for obtaining UTC time 2023-09-18 23:59:37 +00:00
git_refs.py isort: format codebase 2023-08-22 18:32:22 +00:00
git_ssh add license header to a few more files 2019-06-13 13:23:19 -04:00
git_superproject.py isort: format codebase 2023-08-22 18:32:22 +00:00
git_trace2_event_log_base.py Use non-deprecated API for obtaining UTC time 2023-09-18 23:59:37 +00:00
git_trace2_event_log.py Log ErrorEvent for failing GitCommands 2023-09-06 18:22:33 +00:00
hooks.py hooks: drop support for Python 2 2023-10-13 20:52:46 +00:00
LICENSE setup.py: add basic packaging files 2019-12-02 04:23:31 +00:00
main.py main: drop Python 2 check 2023-10-13 20:08:33 +00:00
manifest_xml.py manifest_xml: use a set instead of (sorted) list in projectsDiff 2023-09-10 19:24:56 +00:00
MANIFEST.in setup.py: add basic packaging files 2019-12-02 04:23:31 +00:00
pager.py isort: format codebase 2023-08-22 18:32:22 +00:00
platform_utils_win32.py isort: format codebase 2023-08-22 18:32:22 +00:00
platform_utils.py Format codebase with black and check formatting in CQ 2023-03-22 17:46:28 +00:00
progress.py isort: format codebase 2023-08-22 18:32:22 +00:00
project.py Update logger.warn to logger.warning 2023-10-13 19:34:26 +00:00
pyproject.toml tox: enable python 3.11 testing 2023-08-15 15:47:28 +00:00
README.md update links from monorail to issuetracker 2023-06-14 21:19:58 +00:00
repo Use non-deprecated API for obtaining UTC time 2023-09-18 23:59:37 +00:00
repo_logging.py Reset info logs back to print in sync 2023-09-28 19:46:49 +00:00
repo_trace.py isort: format codebase 2023-08-22 18:32:22 +00:00
requirements.json Drop support for Python 3.5 2021-06-03 11:34:17 +00:00
run_tests fix black formatting of standalone programs 2023-09-01 18:08:58 +00:00
run_tests.vpython3 isort: format codebase 2023-08-22 18:32:22 +00:00
setup.py isort: format codebase 2023-08-22 18:32:22 +00:00
ssh.py Parse OpenSSH versions with no SSH_EXTRAVERSION 2023-05-24 17:33:08 +00:00
SUBMITTING_PATCHES.md SUBMITTING_PATCHES: update with commit queue details 2023-05-11 19:27:57 +00:00
tox.ini tests: Fix tox error in py36 use virtualenv<20.22.0 2023-09-27 18:47:04 +00:00
wrapper.py Format codebase with black and check formatting in CQ 2023-03-22 17:46:28 +00:00

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.

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