You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Go to file
Joanna Wang b415544db4 Add cog/ cwd for fetch.
Bug: 1354709, b/242209562

Change-Id: I48b5575c7a4b8855a8b1f95ced24acadaea39a59
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/tools/depot_tools/+/3865737
Commit-Queue: Aravind Vasudevan <aravindvasudev@google.com>
Auto-Submit: Joanna Wang <jojwang@chromium.org>
Reviewed-by: Aravind Vasudevan <aravindvasudev@google.com>
3 years ago
bootstrap ensure depot_tools and cipd can bootstrap on all windows paths 3 years ago
fetch_configs Add a fetch config for GN. 3 years ago
git-templates
infra Roll recipe dependencies (trivial). 3 years ago
man Use py3 in documentation generation 3 years ago
python-bin
python2-bin
recipes Roll recipe dependencies (trivial). 3 years ago
testing_support [no-sync] Set _should_sync and add flag to control if the experiment should be enabled. 3 years ago
tests Fix flaky testPreDepsHooks test 3 years ago
third_party [depot tools] Update six version. 3 years ago
win_toolchain
zsh-goodies
.cipd_impl.ps1
.gitattributes Setup cipd bin before calling ninja/autoninja 3 years ago
.gitignore Revert "Retry switching to use CIPD ninja v1.8.2" 3 years ago
.isort.cfg
.style.yapf
.vpython
.vpython3
CROS_OWNERS CROS_OWNERS: switch to our common shared lists 3 years ago
DIR_METADATA
GOMA_OWNERS
LICENSE
LUCI_OWNERS
OWNERS Add jojwang to OWNERS 3 years ago
PRESUBMIT.py Add a presubmit check to enforce that code is formatted. 3 years ago
README.gclient.md
README.git-cl.md
README.md
WATCHLISTS
auth.py
autoninja
autoninja.bat autoninja.bat: have space suffix in ninja status 3 years ago
autoninja.py Add reclient error messaging for developer builds. 3 years ago
bb
bb.bat
black
bootstrap_python3
breakpad.py
cbuildbot
cipd Add riscv64 architecture detection 3 years ago
cipd.bat ensure depot_tools and cipd can bootstrap on all windows paths 3 years ago
cipd_bin_setup.bat Revert "Retry switching to use CIPD ninja v1.8.2" 3 years ago
cipd_bin_setup.sh
cipd_client_version [cipd] Update CIPD client v2.6.7 => v2.6.8. 3 years ago
cipd_client_version.digests [cipd] Update CIPD client v2.6.7 => v2.6.8. 3 years ago
cipd_manifest.txt Update goma client 3 years ago
cipd_manifest.versions Update goma client 3 years ago
cit
cit.bat
cit.py
clang-format
clang-format.bat
clang_format.py
clang_format_merge_driver
clang_format_merge_driver.bat
clang_format_merge_driver.py
codereview.settings
compile_single_file
compile_single_file.bat
compile_single_file.py
cpplint.bat
cpplint.py Add some c++17 headers to the list of known headers. 3 years ago
cpplint_chromium.py
cros
cros_sdk
crosjobs
detect_host_arch.py Add riscv64 architecture detection 3 years ago
dirmd
dirmd.bat
download_from_google_storage
download_from_google_storage.bat
download_from_google_storage.py
ensure_bootstrap
fetch
fetch.bat Reland "Make depot_tools scripts return exit codes properly on all platforms." 3 years ago
fetch.py Add cog/ cwd for fetch. 3 years ago
fix_encoding.py
gclient
gclient-new-workdir.py
gclient.bat Reland "Make depot_tools scripts return exit codes properly on all platforms." 3 years ago
gclient.py [no-sync] Save previous values to files. 3 years ago
gclient_completion.sh
gclient_eval.py Allow 'noparent' in DEPS 3 years ago
gclient_paths.py
gclient_scm.py Add cog/ cwd. 3 years ago
gclient_utils.py [no-sync] Add a skip_sync_revisions and process it before running deps. 3 years ago
gerrit_client.py
gerrit_util.py Add BatchListBestOwners and ListBestOwners to GerritClient 3 years ago
git-cache
git-cl
git-crrev-parse
git-drover
git-find-releases
git-footers
git-freeze
git-gs
git-hyper-blame
git-map
git-map-branches
git-mark-merge-base
git-migrate-default-branch
git-nav-downstream
git-nav-upstream
git-new-branch
git-number
git-rebase-update
git-rename-branch
git-reparent-branch
git-retry
git-runhooks
git-squash-branch
git-thaw
git-upstream-diff
git_cache.py git_cache: wrap "git remote show" call in retries 3 years ago
git_cl.py Introduce --send-email flag as an alias to --send-mail for `git cl upload` 3 years ago
git_cl_completion.sh
git_common.py
git_dates.py
git_drover.py
git_find_releases.py
git_footers.py
git_freezer.py
git_hyper_blame.py
git_map.py
git_map_branches.py
git_mark_merge_base.py
git_migrate_default_branch.py
git_nav_downstream.py
git_new_branch.py
git_number.py
git_rebase_update.py
git_rename_branch.py
git_reparent_branch.py
git_retry.py
git_squash_branch.py
git_upstream_diff.py
gn
gn.bat
gn.py
goma_auth
goma_auth.bat
goma_ctl
goma_ctl.bat
gsutil.py
gsutil.py.bat Reland "Make depot_tools scripts return exit codes properly on all platforms." 3 years ago
gsutil.vpython3
isort
led
led.bat
lockfile.py
luci-auth
luci-auth.bat
lucicfg
lucicfg.bat
mac_toolchain
metrics.README.md
metrics.py
metrics_utils.py
my_activity.py
ninja Revert "Retry switching to use CIPD ninja v1.8.2" 3 years ago
ninja-linux64 Revert "Retry switching to use CIPD ninja v1.8.2" 3 years ago
ninja-mac Revert "Retry switching to use CIPD ninja v1.8.2" 3 years ago
ninja.exe Revert "Retry switching to use CIPD ninja v1.8.2" 3 years ago
ninjalog.README.md
ninjalog_uploader.py
ninjalog_uploader_wrapper.py
owners.py Revert "Remove old DepotToolsOwners implementation" 3 years ago
owners_client.py Add BatchListBestOwners and ListBestOwners to GerritClient 3 years ago
owners_finder.py
pinpoint
pinpoint.bat
post_build_ninja_summary.py
presubmit_canned_checks.py Don't do double-serial Pylint checks 3 years ago
presubmit_canned_checks_test.py
presubmit_canned_checks_test_mocks.py
presubmit_support.py presubmit_support: remove backslash from log 3 years ago
profile.xml
prpc
prpc.bat
pylint-1.5
pylint-1.5.bat
pylint-2.6 Update pylint vpython specs to use a specific minor version. 3 years ago
pylint-2.6.bat
pylint-2.7 Update pylint vpython specs to use a specific minor version. 3 years ago
pylint-2.7.bat
pylint_main.py
pylintrc
python_runner.sh
rdb
rdb.bat
rdb_wrapper.py
repo
repo_launcher repo: update to 2.29 launcher 3 years ago
roll-dep
roll-dep.bat
roll_dep.py
rustfmt.py
scm.py
setup_color.py
split_cl.py
subcommand.py Use empty argument list in cmdhelp 3 years ago
subprocess2.py
swift-format
swift_format.py
update_depot_tools Reland "Make depot_tools scripts return exit codes properly on all platforms." 3 years ago
update_depot_tools.bat Allow depot_tools/.git to be a file 3 years ago
update_depot_tools_toggle.py
upload_metrics.py
upload_to_google_storage.py
utils.py
vpython vpython(3) no longer needs to bootstrap python. 3 years ago
vpython.bat Use the bundled interpreter instead of passing -vpython-interpreter. 3 years ago
vpython3 vpython(3) no longer needs to bootstrap python. 3 years ago
vpython3.bat Use the bundled interpreter instead of passing -vpython-interpreter. 3 years ago
watchlists.py
weekly
whitespace.txt
win32imports.py
wtf
yapf yapf: remove unused `re` import 3 years ago
yapf.bat

README.md

depot_tools

Tools for working with Chromium development. It requires python 2.7 or 3.8 for python 3 support.

Tools

The most important tools are:

  • fetch: A gclient wrapper to checkout a project. Use fetch --help for more details.
  • gclient: A meta-checkout tool. Think repo or git submodules, except that it support OS-specific rules, e.g. do not checkout Windows only dependencies when checking out for Android. Use gclient help for more details and README.gclient.md.
  • git cl: A code review tool to interact with Rietveld or Gerrit. Use git cl help for more details and README.git-cl.md.
  • roll-dep: A gclient dependency management tool to submit a dep roll, updating a dependency to a newer revision.

There are a lot of git utilities included.

Updating

depot_tools updates itself automatically when running gclient tool. To disable auto update, set the environment variable DEPOT_TOOLS_UPDATE=0 or run ./update_depot_tools_toggle.py --disable.

To update package manually, run update_depot_tools.bat on Windows, or ./update_depot_tools on Linux or Mac.

On Windows only, running gclient will install git and python.

Contributing

To contribute change for review:

git new-branch <somename>
# Hack
git add .
git commit -a -m "Fixes goat teleporting"
# find reviewers
git cl owners
git log -- <yourfiles>

# Request a review.
git cl upload -r reviewer1@chromium.org,reviewer2@chromium.org --send-mail

# Edit change description if needed.
git cl desc

# If change is approved, flag it to be committed.
git cl set-commit

# If change needs more work.
git rebase-update
...
git cl upload -t "Fixes goat teleporter destination to be Australia"

See also open bugs, open reviews, forum or report problems.

cpplint.py

Until 2018, our cpplint.py was a copy of the upstream version at https://github.com/google/styleguide/tree/gh-pages/cpplint. Unfortunately, that repository is not maintained any more. If you want to update cpplint.py in depot_tools, just upload a patch to do so. We will figure out a long-term strategy via issue https://crbug.com/916550.

Note that the cpplint.py here is also used by the Tricium analyzer, so if the cpplint.py here changes, we should also update the copy used there.