Go to file
Josip Sokcevic 5554572f02 sync: Introduce git checkout levels
If a repo manifest is updated so that project B is placed within a
project A, and if project A had content in new B's location in the old
checkout, then repo sync could break depending on checkout order, since
B can't be checked out before A.

This change introduces checkout levels which enforces right sequence of
checkouts while still allowing for parallel checkout. In an example
above, A will always be checked out first before B.

BUG=b:325119758
TEST=./run_tests, manual sync on ChromeOS repository

Change-Id: Ib3b5e4d2639ca56620a1e4c6bf76d7b1ab805250
Reviewed-on: https://gerrit-review.googlesource.com/c/git-repo/+/410421
Tested-by: Josip Sokcevic <sokcevic@google.com>
Reviewed-by: Greg Edelston <gredelston@google.com>
Commit-Queue: Josip Sokcevic <sokcevic@google.com>
Reviewed-by: Gavin Mak <gavinmak@google.com>
2024-02-27 17:28:33 +00:00
.github/workflows tests: added python 3.12 2023-10-17 13:58:33 +00:00
docs docs: fix some grammar typos 2024-01-04 17:19:33 +00:00
hooks Update commit-msg hook 2023-12-04 17:43:33 +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 sync: Introduce git checkout levels 2024-02-27 17:28:33 +00:00
tests sync: Introduce git checkout levels 2024-02-27 17:28:33 +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 cleanup: Update codebase to expect Python 3.6 2023-10-31 16:03:54 +00:00
command.py cleanup: use new dict & set generator styles 2023-10-21 00:55:01 +00:00
completion.bash bash-completion: complete projects with repo forall 2021-07-27 06:20:52 +00:00
editor.py cleanup: Update codebase to expect Python 3.6 2023-10-31 16:03:54 +00:00
error.py gitc: drop support 2023-08-15 22:14:52 +00:00
event_log.py delete Python 2 (object) compat 2023-10-20 04:51:01 +00:00
fetch.py isort: format codebase 2023-08-22 18:32:22 +00:00
git_command.py git_command: Return None from GetEventTargetPath() if set to empty string 2024-02-26 17:51:11 +00:00
git_config.py cleanup: Update codebase to expect Python 3.6 2023-10-31 16:03:54 +00:00
git_refs.py cleanup: convert exceptions to OSError 2023-10-21 00:56:10 +00:00
git_ssh add license header to a few more files 2019-06-13 13:23:19 -04:00
git_superproject.py git_superproject: tell git that superproject is bare 2023-11-09 22:13:17 +00:00
git_trace2_event_log_base.py git_trace2: Add socket timeout 2023-12-19 19:38:52 +00:00
git_trace2_event_log.py Log ErrorEvent for failing GitCommands 2023-09-06 18:22:33 +00:00
hooks.py cleanup: Update codebase to expect Python 3.6 2023-10-31 16:03:54 +00:00
LICENSE setup.py: add basic packaging files 2019-12-02 04:23:31 +00:00
main.py trace: Save trace2 sid in REPO_TRACE file 2024-02-22 20:55:09 +00:00
manifest_xml.py manifest_xml: fix url normalization for inits and remotes 2023-12-20 07:38:49 +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 cleanup: Update codebase to expect Python 3.6 2023-10-31 16:03:54 +00:00
platform_utils.py cleanup: Update codebase to expect Python 3.6 2023-10-31 16:03:54 +00:00
progress.py cleanup: Update codebase to expect Python 3.6 2023-10-31 16:03:54 +00:00
project.py project: Rename if deletion fails 2024-01-25 21:32:58 +00:00
pyproject.toml tests: added python 3.12 2023-10-17 13:58:33 +00:00
README.md update links from monorail to issuetracker 2023-06-14 21:19:58 +00:00
repo launcher: Set shebang to python3 2024-02-07 20:44:32 +00:00
repo_logging.py repo_logging: Ensure error details are printed 2023-11-13 20:51:19 +00:00
repo_trace.py cleanup: delete redundant "r" open mode 2023-10-21 00:55:33 +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 cleanup: Update codebase to expect Python 3.6 2023-10-31 16:03:54 +00:00
SUBMITTING_PATCHES.md SUBMITTING_PATCHES: update with commit queue details 2023-05-11 19:27:57 +00:00
tox.ini tox: Remove pylint timeout 2023-12-08 22:55:22 +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