You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Gavin Mak 62dc9f462e Implement support for change info thru diff file 8 hours ago
bootstrap Reland^3 "Upgrade python to 3.11" 1 month ago
fetch_configs Add fetch config node 4 weeks ago
hooks
infra Roll recipe dependencies (trivial). 4 days ago
man Switch to using issues.chromium.org bug links 2 weeks ago
metadata
python-bin
python2-bin
recipes Roll recipe dependencies (trivial). 4 days ago
testing_support Fix multiline comment formatting 2 months ago
tests Implement support for change info thru diff file 8 hours ago
third_party
win_toolchain Delete py2 checks 3 weeks ago
zsh-goodies
.cipd_impl.ps1
.flake8
.gitattributes
.gitignore autoninja: cache negative result of gcloud account check 2 months ago
.isort.cfg
.style.yapf
.vpython Revert "Delete vpython, leaving only vpython3." 2 weeks ago
.vpython3 Update the CheckInfraFreeze canned check to use datetime & zoneinfo. 3 weeks ago
BUILD_OWNERS
CROS_OWNERS
DIR_METADATA
LICENSE
LUCI_OWNERS
OWNERS
PRESUBMIT.py [PRESUBMIT] Increase unit test timeout 1 month ago
README.gclient.md
README.git-cl.md
README.md Switch to using issues.chromium.org bug links 2 weeks ago
RECLIENT_OWNERS
WATCHLISTS
auth.py Fix multiline comment formatting 2 months ago
autoninja
autoninja.bat
autoninja.py Revert "Remove ability to use_goma via autoninja." 22 hours ago
autosiso
autosiso.bat
autosiso.py
bazel
bazel.py
bb
bb.bat
black
bootstrap_python3
breakpad.py
cbuildbot
cipd
cipd.bat
cipd_bin_setup.bat
cipd_bin_setup.sh
cipd_client_version Update to 2.6.16 2 months ago
cipd_client_version.digests Update to 2.6.16 2 months ago
cipd_manifest.txt [ResultDB] Roll RDB CLI. 6 days ago
cipd_manifest.versions [ResultDB] Roll RDB CLI. 6 days ago
cipd_manifest_cros_python2.txt
cipd_manifest_cros_python2.versions
clang-format
clang-format.bat
clang_format.py
codereview.settings
compile_single_file Make 'compile_single_file' use vpython3 1 month ago
compile_single_file.bat Make 'compile_single_file' use vpython3 1 month ago
compile_single_file.py Make 'compile_single_file' use vpython3 1 month ago
cpplint.bat
cpplint.py Remove deprecated sre_compile from cpplint 1 month ago
cpplint_chromium.py
cros cros: expand to cover more roots 2 months ago
cros_python2.vpython
cros_sdk
crosjobs
detect_host_arch.py Fix multiline comment formatting 2 months ago
dirmd
dirmd.bat
download_from_google_storage
download_from_google_storage.bat
download_from_google_storage.py Fix multiline comment formatting 2 months ago
ensure_bootstrap
fetch
fetch.bat
fetch.py Use shlex instead of pipes 3 weeks ago
gclient
gclient-new-workdir.py
gclient.bat
gclient.py [fix_encoding] Remove fix_encoding 2 weeks ago
gclient_completion.sh
gclient_eval.py Fix multiline comment formatting 2 months ago
gclient_paths.py
gclient_scm.py [gclient_scm] Use --replace-all within set_config 1 week ago
gclient_utils.py Use shlex instead of pipes 3 weeks ago
gerrit
gerrit_client.py [fix_encoding] Remove fix_encoding 2 weeks ago
gerrit_util.py Reland "Update gclient to use git config caching" 1 week ago
git-cache
git-cl
git-crrev-parse
git-drover
git-find-releases
git-footers
git-freeze
git-gs Enable searching starlark files with git gs. 2 months ago
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] Allow expansion of `~` in git cache.cachepath parameter. 4 weeks ago
git_cl.py Move LSC check into pan project presubmit checks and check num files 5 days ago
git_cl_completion.sh
git_common.py Reland "Update gclient to use git config caching" 1 week ago
git_completion.sh
git_dates.py Fix multiline comment formatting 2 months ago
git_find_releases.py
git_footers.py Fix multiline comment formatting 2 months ago
git_freezer.py
git_hyper_blame.py Fix multiline comment formatting 2 months ago
git_map.py
git_map_branches.py Fix multiline comment formatting 2 months ago
git_mark_merge_base.py
git_migrate_default_branch.py [fix_encoding] Remove fix_encoding 2 weeks ago
git_nav_downstream.py
git_new_branch.py
git_number.py Fix multiline comment formatting 2 months ago
git_rebase_update.py Reland "Update gclient to use git config caching" 1 week ago
git_rename_branch.py
git_reparent_branch.py
git_retry.py Fix multiline comment formatting 2 months ago
git_squash_branch.py
git_upstream_diff.py
gn
gn.bat
gn.py Revert "Delete vpython, leaving only vpython3." 2 weeks ago
goma_auth
goma_auth.bat
goma_ctl
goma_ctl.bat
gsutil.py
gsutil.py.bat
gsutil.vpython3
infra_to_superproject
infra_to_superproject.bat
infra_to_superproject.py
isort
led
led.bat
lockfile.py Fix multiline comment formatting 2 months ago
luci-auth
luci-auth.bat
lucicfg
lucicfg.bat
mac_toolchain
metrics.README.md
metrics.py Clean up stacked-changes dogfood 2 weeks ago
metrics_utils.py Fix multiline comment formatting 2 months ago
my_activity.py [fix_encoding] Remove fix_encoding 2 weeks ago
ninja
ninja.bat
ninja.py
ninja_reclient.py
ninjalog.README.md
ninjalog_uploader.py
ninjalog_uploader_wrapper.py
owners_client.py [owners] Limit number of concurrent Gerrit connections 1 month ago
owners_finder.py
pinpoint
pinpoint.bat
post_build_ninja_summary.py
presubmit_canned_checks.py Move LSC check into pan project presubmit checks and check num files 5 days ago
presubmit_support.py Implement support for change info thru diff file 8 hours ago
profile.xml
prpc
prpc.bat
pylint-2.6
pylint-2.6.bat
pylint-2.7
pylint-2.7.bat
pylint-2.17
pylint-2.17.bat
pylint_main.py
pylintrc
pylintrc-2.17
python_runner.sh
rdb
rdb.bat
rdb_wrapper.py Fix multiline comment formatting 2 months ago
reclient_helper.py Change source of hash for reproxy socket. 4 days ago
reclient_metrics
reclient_metrics.README.md
reclient_metrics.bat
reclient_metrics.py Fix multiline comment formatting 2 months ago
reclientreport
reclientreport.bat
reclientreport.py
repo
repo_launcher Update repo_launcher to 2.40 2 months ago
roll-dep
roll-dep.bat
roll_dep.py Fix multiline comment formatting 2 months ago
rustfmt.py
scm.py [scm] Clean up unused functions 1 week ago
setup_color.py Fix multiline comment formatting 2 months ago
siso
siso.bat
siso.py siso: use stderr to print message from siso.py 1 month ago
split_cl.py Improve git cl split warning if more than 10 CLs will be created. 4 weeks ago
subcommand.py Fix multiline comment formatting 2 months ago
subprocess2.py Fix multiline comment formatting 2 months ago
swift-format
swift_format.py
update_depot_tools Don't print "Updating depot_tools" 2 months ago
update_depot_tools.bat
update_depot_tools_toggle.py
upload_metrics.py
upload_to_google_storage.py
utils.py
vpython Revert "Delete vpython, leaving only vpython3." 2 weeks ago
vpython.bat Revert "Delete vpython, leaving only vpython3." 2 weeks ago
vpython3
vpython3.bat
watchlists.py Fix multiline comment formatting 2 months ago
weekly
whitespace.txt
win32imports.py
wtf
yapf Always run yapf with vpython3. 1 month ago
yapf.bat

README.md

depot_tools

Tools for working with Chromium development. It requires python 3.8.

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.