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
George Engelbrecht 30f9664b48 Add 'stat' to gsutil module.
In support of the signing rework we're going to want to have
the signers keep track of the calculated hash to ensure that
we don't have a TOCTOU type issue. This commit adds the stat
command to the gsutil module so that we can ask gs a files hash.

Change-Id: Ib35d1541292a18fbfc26fab50f594c682ba4109d
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/tools/depot_tools/+/1754262
Reviewed-by: Robbie Iannucci <iannucci@chromium.org>
Commit-Queue: George Engelbrecht <engeg@google.com>
6 years ago
bootstrap/win [bootstrap/win] Release Python 2.7.15 6 years ago
fetch_configs Invert ios_internal fetch spec. 6 years ago
git-templates
infra Roll recipe dependencies (trivial). 6 years ago
man Convert print statements to Python 3 style 7 years ago
recipes Add 'stat' to gsutil module. 6 years ago
support chromite_wrapper: add python3 support for except 7 years ago
testing_support depot_tools: Make scm Python 3 compatible. 6 years ago
tests depot_tools: Make scm Python 3 compatible. 6 years ago
third_party Revert "Reland "depot_tools: Move six to depot_tools' .vpython"" 6 years ago
win_toolchain Convert print statements to Python 3 style 7 years ago
zsh-goodies
.gitattributes Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
.gitignore git-cl: Always collect git traces. 7 years ago
.style.yapf
.vpython Revert "Reland "depot_tools: Move six to depot_tools' .vpython"" 6 years ago
.vpython3 [vpython] Roll to 98a268c6432f18aedd55d62b9621765316dc2a16 6 years ago
CROS_OWNERS CROS_OWNERS: update 6 years ago
LICENSE
OWNERS [OWNERS] revive agable 7 years ago
PRESUBMIT.py Call new CheckJsonParses in PRESUBMIT 6 years ago
README.gclient.md docs: Removing references to SVN 9 years ago
README.git-cl.md Proofread README.git-cl.md. 9 years ago
README.md Update depot_tools README cpplint section 7 years ago
annotated_gclient.py Convert print statements to Python 3 style 7 years ago
auth.py Convert print statements to Python 3 style 7 years ago
autoninja [depot_tools] Cap num_cores to RAM/2GB under local jumbo builds 6 years ago
autoninja.bat [depot_tools] Cap num_cores to RAM/2GB under local jumbo builds 6 years ago
autoninja.py Update autoninja's psutil from v5.2.2 to v5.6.2 6 years ago
bb do not hardcode the path to bash by using the #!/usr/bin/env bash shebang 7 years ago
bb.bat [bb] Deploy bb 7 years ago
breakpad.py
buildbucket.py Convert print statements to Python 3 style 7 years ago
cbuildbot
chrome_set_ver
cipd do not hardcode the path to bash by using the #!/usr/bin/env bash shebang 7 years ago
cipd.bat [cipd] Check CIPD client hash during updates on Windows. 7 years ago
cipd.ps1 [cipd] More careful error handling during CIPD bootstrap on Windows. 7 years ago
cipd_bin_setup.bat [cipd] Bump version, log at warning (#2). 8 years ago
cipd_bin_setup.sh Fix depot_tools errors that cause runhooks to be inoperable for Cygwin 8 years ago
cipd_client_version [cipd] Update CIPD client to v2.2.19. 6 years ago
cipd_client_version.digests [cipd] Update CIPD client to v2.2.19. 6 years ago
cipd_manifest.txt Add crosjobs to cipd_manifest 6 years ago
cipd_manifest.versions Add crosjobs to cipd_manifest 6 years ago
cit Revert "Reland "depot_tools: Move six to depot_tools' .vpython"" 6 years ago
cit.bat Revert "Reland "depot_tools: Move six to depot_tools' .vpython"" 6 years ago
cit.py Revert "Reland "depot_tools: Move six to depot_tools' .vpython"" 6 years ago
clang-format
clang-format.bat [.bat] Remove "depot_tools" override. (#2) 8 years ago
clang_format.py Convert print statements to Python 3 style 7 years ago
clang_format_merge_driver Introduce git merge driver for the blink reformatting 9 years ago
clang_format_merge_driver.bat [.bat] Remove "depot_tools" override. (#2) 8 years ago
clang_format_merge_driver.py Convert except statements to be Python 3 compatible 6 years ago
codereview.settings Make depot_tools upload reviews to Gerrit by default 9 years ago
compile_single_file Add a script to make it easier to build a single source file with ninja 8 years ago
compile_single_file.bat Add a script to make it easier to build a single source file with ninja 8 years ago
compile_single_file.py Make it clear that compile_single_file.py doesn't support Jumbo builds 6 years ago
cpplint.bat [.bat] Remove "depot_tools" override. (#2) 8 years ago
cpplint.py CppLint changes for VSCode cpplint plugin 7 years ago
cpplint_chromium.py
cros
cros_sdk
crosjobs Add crosjobs shim script 6 years ago
dart_format.py Convert except statements to be Python 3 compatible 6 years ago
depot-tools-auth
depot-tools-auth.bat [.bat] Remove "depot_tools" override. (#2) 8 years ago
depot-tools-auth.py Convert print statements to Python 3 style 7 years ago
detect_host_arch.py Improve gclient Python 3 compatibility 7 years ago
download_from_google_storage Revert "depot_tools: Run Python scripts using vpython (Part 2)" 6 years ago
download_from_google_storage.bat Revert "depot_tools: Run Python scripts using vpython (Part 2)" 6 years ago
download_from_google_storage.py Revert "depot_tools: Run Python scripts using vpython (Part 2)" 6 years ago
ensure_bootstrap [depot_tools] Add "ensure_bootstrap" script. 8 years ago
fetch Revert "depot_tools: Run Python scripts using vpython (Part 2)" 6 years ago
fetch.bat Revert "depot_tools: Run Python scripts using vpython (Part 2)" 6 years ago
fetch.py Revert "depot_tools: Run Python scripts using vpython (Part 2)" 6 years ago
fix_encoding.py fix_encoding: Do unicode type checks only on Python 2 6 years ago
gclient Revert "depot_tools: Run Python scripts using vpython (Part 2)" 6 years ago
gclient-new-workdir.py Revert "depot_tools: Run Python scripts using vpython (Part 2)" 6 years ago
gclient.bat Revert "depot_tools: Run Python scripts using vpython (Part 2)" 6 years ago
gclient.py Revert "depot_tools: Run Python scripts using vpython (Part 2)" 6 years ago
gclient_completion.sh
gclient_eval.py Revert "Reland "depot_tools: Move six to depot_tools' .vpython"" 6 years ago
gclient_paths.py Improve gclient Python 3 compatibility 7 years ago
gclient_scm.py depot_tools: Make gclient_scm Python 3 compatible. 6 years ago
gclient_utils.py Make gclient_utils work with Python 3 6 years ago
gerrit_client.py Add gerrit.abandon_change command 7 years ago
gerrit_util.py Convert print statements to Python 3 style 7 years ago
git-cache
git-cl
git-crrev-parse Fix git-crrev-parse on Mac. 8 years ago
git-drover
git-find-releases
git-footers
git-freeze
git-gs Add *.proto to git-gs 9 years ago
git-hyper-blame
git-map
git-map-branches
git-mark-merge-base
git-nav-downstream
git-nav-upstream Make git-nav-upstream use the upstream branch name 7 years ago
git-new-branch
git-number
git-rebase-update
git-rename-branch
git-reparent-branch
git-retry
git-runhooks Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git-squash-branch
git-thaw
git-upstream-diff
git_cache.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_cl.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_cl_completion.sh
git_common.py Ignore git submodules when calculating dirty files. 6 years ago
git_dates.py
git_drover.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_find_releases.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_footers.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_freezer.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_hyper_blame.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_map.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_map_branches.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_mark_merge_base.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_nav_downstream.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_new_branch.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_number.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_rebase_update.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_rename_branch.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_reparent_branch.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_retry.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_squash_branch.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_upstream_diff.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
gn
gn.bat [.bat] Remove "depot_tools" override. (#2) 8 years ago
gn.py Convert print statements to Python 3 style 7 years ago
gsutil.py Improve gclient Python 3 compatibility 7 years ago
gsutil.py.bat Add windows .bat file for gsutil.py. 7 years ago
gsutil.vpython Add the crcmod wheel for gsutil, to get it to shut up. 7 years ago
led do not hardcode the path to bash by using the #!/usr/bin/env bash shebang 7 years ago
led.bat [bootstraps] Sync at gclient, suppress output (#2) 8 years ago
luci-auth do not hardcode the path to bash by using the #!/usr/bin/env bash shebang 7 years ago
luci-auth.bat [luci-auth] Add statically-linked luci-auth CLI tool. 8 years ago
lucicfg do not hardcode the path to bash by using the #!/usr/bin/env bash shebang 7 years ago
lucicfg.bat [cipd] Add lucicfg tool. 7 years ago
mac_toolchain do not hardcode the path to bash by using the #!/usr/bin/env bash shebang 7 years ago
metrics.README.md metrics: Collect full timestamps. 7 years ago
metrics.py depot_tools: Make some changes to make metrics collection compatible with Python 3. 6 years ago
metrics_utils.py depot_tools: Make some changes to make metrics collection compatible with Python 3. 6 years ago
my_activity.py depot_tools: Remove rietvelt code. 6 years ago
ninja [ninja] update ninja repository url 7 years ago
ninja-linux32 Update ninja to v1.8.2 8 years ago
ninja-linux64 Update ninja to v1.8.2 8 years ago
ninja-mac Update ninja to v1.8.2 8 years ago
ninja.exe Update ninja to v1.8.2 8 years ago
ninjalog.README.md [ninjalog] add ninjalog.README.md 7 years ago
ninjalog_uploader.py [ninjalog_uploader] add path for httplib2 7 years ago
ninjalog_uploader_wrapper.py Convert print statements to Python 3 style 7 years ago
owners.py Improved comments for the recent optimization in owners.py 6 years ago
owners_finder.py Convert print statements to Python 3 style 7 years ago
post_build_ninja_summary.py Convert print statements to Python 3 style 7 years ago
presubmit_canned_checks.py Make presubmit emit a warning when it can't find the desired luci config set. 6 years ago
presubmit_support.py Make sure PresubmitResult can be converted to a json. 6 years ago
profile.xml
prpc do not hardcode the path to bash by using the #!/usr/bin/env bash shebang 7 years ago
prpc.bat [prpc] Add pRPC CLI tool to depot_tools. 8 years ago
pylint Revert "Reland "depot_tools: Move six to depot_tools' .vpython"" 6 years ago
pylint.py Revert "Reland "depot_tools: Move six to depot_tools' .vpython"" 6 years ago
pylintrc pylint: reland upgrade to 1.5.6 7 years ago
python_runner.sh Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
repo repo: pull in v1.13.4 changes 6 years ago
roll-dep Revert "depot_tools: Run Python scripts using vpython (Part 2)" 6 years ago
roll-dep-svn Revert "depot_tools: Run Python scripts using vpython (Part 2)" 6 years ago
roll-dep-svn.bat Revert "depot_tools: Run Python scripts using vpython (Part 2)" 6 years ago
roll-dep.bat Revert "depot_tools: Run Python scripts using vpython (Part 2)" 6 years ago
roll_dep.py Revert "depot_tools: Run Python scripts using vpython (Part 2)" 6 years ago
roll_dep_svn.py Revert "depot_tools: Run Python scripts using vpython (Part 2)" 6 years ago
scm.py scm: Replace invalid UTF-8 in Git output 7 years ago
setup_color.py setup_color: Don't fill created string buffer with nulls 6 years ago
split_cl.py Convert print statements to Python 3 style 7 years ago
subcommand.py depot_toools: Make subcommand Python 3 compatible. 6 years ago
subprocess2.py depot_tools: Simplify subprocess2. 6 years ago
update_depot_tools fix fetch on aix 7 years ago
update_depot_tools.bat [bootstraps] Sync at gclient, suppress output (#2) 8 years ago
update_depot_tools_toggle.py [auto_update] Add control script, allow disable. 8 years ago
upload_metrics.py Revert "Reland "depot_tools: Move six to depot_tools' .vpython"" 6 years ago
upload_to_google_storage.py Convert print statements to Python 3 style 7 years ago
vpython do not hardcode the path to bash by using the #!/usr/bin/env bash shebang 7 years ago
vpython.bat [bootstraps] Sync at gclient, suppress output (#2) 8 years ago
vpython3 [vpython] Roll to 98a268c6432f18aedd55d62b9621765316dc2a16 6 years ago
vpython3.bat [vpython] Roll to 98a268c6432f18aedd55d62b9621765316dc2a16 6 years ago
watchlists.py Convert except statements to be Python 3 compatible 6 years ago
weekly Convert print statements to Python 3 style 7 years ago
wtf Convert print statements to Python 3 style 7 years ago
yapf Update yapf version 0.22 -> 0.24 7 years ago
yapf.bat Fix git cl format --python on windows 7 years ago

README.md

depot_tools

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

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.

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.