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
Josip Sokcevic 7d95eb2eb0 [gclient] Delete GCS output_dir on download
GCS output_directory needs to be cleaned up prior to extracting new
content. At the same time, it can't be cleaned up by individual GCS
fetcher as there can be multiple objects in the same output_dir.

This change adds a top level support to delete old GCS output_dir. If
any of objects need to be downloaded, the output_dir will be completely
deleted and all objects will be redownloaded.

R=jojwang@google.com

Bug: 342522902, 338612245
Change-Id: Icbe4f1238cac54d7390bbb9b6fc5f17c538cca62
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/tools/depot_tools/+/5570466
Reviewed-by: Joanna Wang <jojwang@chromium.org>
Commit-Queue: Josip Sokcevic <sokcevic@chromium.org>
1 year ago
bootstrap New cpython3 and vpython3 packages to depot_tools. 1 year ago
fetch_configs remove references to goma client repository 1 year ago
hooks
infra Roll recipe dependencies (trivial). 1 year ago
man
metadata metadata: treats CPEPrefix "unknown" as None 1 year ago
python-bin
python2-bin
recipes Roll recipe dependencies (trivial). 1 year ago
testing_support [git_cl.py] Remove all usage and messages around netrc. 1 year ago
tests [git_cl.py] Remove all usage and messages around netrc. 1 year ago
third_party
win_toolchain Revert "Reland "Add support for GCS deps"" 1 year ago
zsh-goodies
.cipd_impl.ps1
.flake8
.gitattributes
.gitignore
.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
autoninja
autoninja.bat Remove obsolete autoninja.bat comment 1 year ago
autoninja.py autoninja: fix behavior when passed args after '--' 1 year ago
autosiso
autosiso.bat
autosiso.py Revert "[siso] Limit remote jobs on Windows to 1000" 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 New vpython3 to depot_tools. 1 year ago
cipd_manifest.versions New vpython3 to depot_tools. 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 [depot_tools] Update clang_format.py with new path 1 year ago
codereview.settings
compile_single_file
compile_single_file.bat
compile_single_file.py
cpplint.bat
cpplint.py [cpplint] Update for c++20 1 year ago
cpplint_chromium.py
cros
cros_python2.vpython
cros_sdk
crosjobs
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
gclient
gclient-new-workdir.py
gclient.bat
gclient.py [gclient] Delete GCS output_dir on download 1 year ago
gclient_completion.sh
gclient_eval.py [gclient] remove output_file from gcs object setdep 1 year ago
gclient_paths.py
gclient_scm.py Use git_common to call git 1 year ago
gclient_utils.py [gclient] Use lowercase and when merging conditions 1 year ago
gerrit
gerrit_client.py
gerrit_util.py [git_cl.py] Remove all usage and messages around netrc. 1 year 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-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-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.py] Remove all usage and messages around netrc. 1 year ago
git_cl_completion.sh
git_common.py Resolve git.bat to git.exe without using shell=True 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 fail gracefully if git rebase-update is called in cog 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_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
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 [depot_tools] add google_java_format.py 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
metrics_utils.py remove references to goma client repository 1 year ago
my_activity.py
ninja
ninja.bat
ninja.py Add "ninja -t targets" to the command allowlist 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
owners_client.py
owners_finder.py
pinpoint
pinpoint.bat
post_build_ninja_summary.py
presubmit_canned_checks.py [presubmit] Add check for recursedeps entries 1 year ago
presubmit_diff.py Handle diff without chunk header 1 year ago
presubmit_support.py Provide useful submodule info for all Change classes 1 year 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
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
reclientreport
reclientreport.bat
reclientreport.py
repo
repo_launcher [repo_launcher] Update repo_launcher to v2.45 1 year ago
roll-dep
roll-dep.bat
roll_dep.py Hide git log by default if rolling from a non-public host 1 year ago
rustfmt.py
scm.py Use git_common to call git 1 year ago
setup_color.py
siso
siso.bat
siso.py Reland "siso.py check ninja marker" 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 Revert "Reland "Add support for GCS deps"" 1 year ago
upload_to_google_storage_first_class.py Remove <> from upload_to_google_storage_first_class output 1 year ago
utils.py
vpython3
vpython3.bat
watchlists.py
weekly
whitespace.txt
win32imports.py
wtf
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.