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
Allen Li 41c749b26d [git_cl] Use named fields for URL manipulation
Change-Id: I575b91f6b6e28ac58160e3c0fc59398df222b150
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/tools/depot_tools/+/5677608
Auto-Submit: Allen Li <ayatane@chromium.org>
Reviewed-by: Yiwei Zhang <yiwzhang@google.com>
Commit-Queue: Allen Li <ayatane@chromium.org>
Commit-Queue: Yiwei Zhang <yiwzhang@google.com>
1 year ago
bootstrap
fetch_configs Add fetch config for web-workload 1 year ago
hooks
infra Roll recipe dependencies (trivial). 1 year ago
man Add --tree option to rebase-update. 1 year ago
metadata Updating Revision presubmit to check for valid commit hash 1 year ago
python-bin
python2-bin
recipes Roll recipe dependencies (trivial). 1 year ago
testing_support Add git squash-branch-tree 1 year ago
tests gn_helper: ignore spaces on gn lines 1 year ago
third_party
win_toolchain
zsh-goodies
.cipd_impl.ps1
.flake8
.gitattributes [cipd] Add git-credential-luci (reland) 1 year ago
.gitignore Use $HOME/.config/depot_tools on linux for .cfg files 1 year ago
.isort.cfg
.style.yapf
.vpython3
BUILD_OWNERS
CROS_OWNERS
DIR_METADATA
LICENSE
LUCI_OWNERS
OWNERS remove goma CIPD package 1 year ago
PRESUBMIT.py
README.gclient.md
README.git-cl.md
README.md
RECLIENT_OWNERS
WATCHLISTS
auth.py [gerrit_util] Add dogfoodable luci-auth Authenticator (reland) 1 year ago
autoninja
autoninja.bat
autoninja.py ninja: error if trying to build for use_remoteexec=true 1 year ago
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
cipd_client_version.digests
cipd_manifest.txt [depot_tools] roll led 1 year ago
cipd_manifest.versions [depot_tools] roll led 1 year ago
cipd_manifest_cros_python2.txt remove goma CIPD package 1 year ago
cipd_manifest_cros_python2.versions
clang-format
clang-format.bat
clang_format.py [clang_format] Update clang path 1 year ago
codereview.settings
compile_single_file
compile_single_file.bat
compile_single_file.py
cpplint.bat
cpplint.py
cpplint_chromium.py
cros
cros_python2.vpython
cros_sdk
detect_host_arch.py
dirmd
dirmd.bat
download_from_google_storage
download_from_google_storage.bat
download_from_google_storage.py [depot_tools] Update GCS dotfile naming 1 year ago
ensure_bootstrap
fetch
fetch.bat
fetch.py fail if fetch command is called in Cog 1 year ago
gclient
gclient-new-workdir.py fail gracefully if gclient-new-workdir.py is called in non-git env 1 year ago
gclient.bat
gclient.py Skip run() for GCS/CIPD dependencies during runhooks and revinfo. 1 year ago
gclient_completion.sh
gclient_eval.py [gclient] remove output_file from gcs object setdep 1 year ago
gclient_paths.py gclient: resolve symlink in gclient_entries before checking with current path 1 year ago
gclient_scm.py [depot_tools] auto correct url always 1 year ago
gclient_utils.py [gclient] Use lowercase and when merging conditions 1 year ago
gerrit
gerrit_client.py
gerrit_util.py [gerrit_util] Update docstring for new param 1 year ago
git-cache
git-cl
git-credential-luci [cipd] Add git-credential-luci (reland) 1 year ago
git-credential-luci.bat [cipd] Add git-credential-luci (reland) 1 year ago
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-nav-downstream
git-nav-upstream print slightly better message if git nav-upstream is not called in git repo 1 year ago
git-new-branch
git-number
git-rebase-update
git-rename-branch
git-reparent-branch
git-retry
git-runhooks
git-squash-branch
git-squash-branch-tree Add git squash-branch-tree 1 year ago
git-thaw
git-upstream-diff
git_cache.py error if git cache commands are called in cog env. 1 year ago
git_cl.py [git_cl] Use named fields for URL manipulation 1 year ago
git_cl_completion.sh
git_common.py [git_common] Relocate comment 1 year ago
git_completion.sh
git_dates.py
git_find_releases.py fail gracefully if git find-releases is called in cog 1 year ago
git_footers.py fail gracefully if git footers is called in cog 1 year ago
git_freezer.py fail gracefully if git freeze or git thaw are called in cog 1 year ago
git_hyper_blame.py fail gracefully if git hyper-blame are called in cog 1 year ago
git_map.py fail gracefully if git map is called in cog 1 year ago
git_map_branches.py fail gracefully if git map-branches is called in cog 1 year ago
git_mark_merge_base.py fail gracefully if git mark-merge-base is called in cog 1 year ago
git_nav_downstream.py fail gracefully if git nav-downstream is called in cog 1 year ago
git_new_branch.py fail gracefully if git new-branch is called in cog 1 year ago
git_number.py
git_rebase_update.py Add --tree option to rebase-update. 1 year ago
git_rename_branch.py fail gracefully if git rename-branch is called in cog 1 year ago
git_reparent_branch.py fail gracefully if git reparent-branch is called in cog 1 year ago
git_retry.py
git_squash_branch.py fail gracefully if git squash-branch is called in cog 1 year ago
git_squash_branch_tree.py Add git squash-branch-tree 1 year ago
git_upstream_diff.py fail gracefully if git upstream-diff is called in cog 1 year ago
gn
gn.bat
gn.py Reland "[depot_tools] Support both gn paths in gn.py" 1 year ago
gn_helper.py gn_helper: ignore spaces on gn lines 1 year ago
google-java-format [depot_tools] add google_java_format.py 1 year ago
google-java-format.bat [depot_tools] add google_java_format.py 1 year ago
google_java_format.py Fix google-java-format/cipd exists check. 1 year ago
gsutil.py [gsutil] Fix race when downloading gsutil 1 year ago
gsutil.py.bat
gsutil.vpython3
isort
led
led.bat
lockfile.py [gsutil] Fix race when downloading gsutil 1 year ago
luci-auth
luci-auth.bat
lucicfg
lucicfg.bat
mac_toolchain
metrics.README.md
metrics.py Use $HOME/.config/depot_tools on linux for .cfg files 1 year ago
metrics_utils.py remove references to goma client repository 1 year ago
my_activity.py
newauth.py [newauth] Accept standard Git bool values 1 year ago
ninja
ninja.bat
ninja.py ninja: error if trying to build for use_remoteexec=true 1 year ago
ninja_reclient.py
ninjalog.README.md remove references to goma 1 year ago
ninjalog_uploader.py remove references to goma 1 year ago
ninjalog_uploader_wrapper.py Use $HOME/.config/depot_tools on linux for .cfg files 1 year ago
owners_client.py
owners_finder.py
pinpoint
pinpoint.bat
post_build_ninja_summary.py allow v6 ninja log format 1 year ago
presubmit_canned_checks.py Reland "[presubmit checks] Check if files are written to a dep dir" 1 year ago
presubmit_diff.py
presubmit_support.py Create scm.DIFF.GetAllFiles 1 year ago
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
reclient_helper.py Remove a space between a value and its unit 1 year ago
reclient_metrics
reclient_metrics.README.md
reclient_metrics.bat
reclient_metrics.py Use $HOME/.config/depot_tools on linux for .cfg files 1 year ago
reclientreport
reclientreport.bat
reclientreport.py
repo error if repo command is called in Cog environment 1 year ago
repo_launcher
roll-dep
roll-dep.bat
roll_dep.py error if roll-dep command is called in Cog environment 1 year ago
rustfmt.py
scm.py [scm] Add append to SetConfig 1 year ago
setup_color.py
siso
siso.bat
siso.py Add a new possible siso path 1 year ago
split_cl.py split_cl: do not prepend '/' in $directory 1 year ago
subcommand.py
subprocess2.py
swift-format
swift_format.py
update_depot_tools remove goma CIPD package 1 year ago
update_depot_tools.bat remove goma CIPD package 1 year ago
update_depot_tools_toggle.py
upload_metrics.py
upload_to_google_storage.py
upload_to_google_storage_first_class.py [GCS] Add prefix option to upload_to_gs_f_c 1 year ago
utils.py Use $HOME/.config/depot_tools on linux for .cfg files 1 year ago
vpython3
vpython3.bat
watchlists.py
whitespace.txt
win32imports.py
yapf
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.