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
Edward Lesmes c1afadf801 Add gavinmak@ to owners
Change-Id: I309bfc112966a84c55d881fe874abfc7842c4a6d
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/tools/depot_tools/+/2698787
Auto-Submit: Edward Lesmes <ehmaldonado@chromium.org>
Commit-Queue: Josip Sokcevic <sokcevic@google.com>
Reviewed-by: Josip Sokcevic <sokcevic@google.com>
5 years ago
bootstrap
fetch_configs
git-templates
infra
man Add documentation for --inject_current 5 years ago
python-bin depot_tools: Don't add a python3 shim to depot_tools on bootstrap. 6 years ago
python2-bin
recipes
testing_support
tests
third_party
win_toolchain
zsh-goodies
.cipd_impl.ps1
.gitattributes
.gitignore
.style.yapf
.vpython
.vpython3
CROS_OWNERS
DIR_METADATA
GOMA_OWNERS
LICENSE
LUCI_OWNERS
OWNERS Add gavinmak@ to owners 5 years ago
PRESUBMIT.py
README.gclient.md
README.git-cl.md
README.md
WATCHLISTS
auth.py
autoninja
autoninja.bat
autoninja.py
bb
bb.bat
bootstrap_python3
breakpad.py
cbuildbot
chrome_set_ver
cipd
cipd.bat
cipd_bin_setup.bat
cipd_bin_setup.sh
cipd_client_version
cipd_client_version.digests
cipd_manifest.txt
cipd_manifest.versions
cit
cit.bat
cit.py
clang-format
clang-format.bat
clang_format.py Convert print statements to Python 3 style 6 years ago
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 remove reference to jumbo build 5 years ago
cpplint.bat
cpplint.py
cpplint_chromium.py
cros
cros_sdk
crosjobs
detect_host_arch.py
dirmd
dirmd.bat
download_from_google_storage
download_from_google_storage.bat
download_from_google_storage.py
ensure_bootstrap
fetch
fetch.bat
fetch.py Make fetch compatible with py 3.5 5 years ago
fix_encoding.py
gclient
gclient-new-workdir.py Revert "depot_tools: Run Python scripts using vpython (Part 2)" 6 years ago
gclient.bat
gclient.py
gclient_completion.sh
gclient_eval.py Revert "Remove use_relative_hooks now that all deprecated uses are removed." 5 years ago
gclient_paths.py
gclient_scm.py Use real default branch in gclient 5 years ago
gclient_utils.py
gerrit_client.py Add change HEAD cli option to gerrit_client 5 years ago
gerrit_util.py
git-cache
git-cl Add quotes around paths in bash scripts. 5 years 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-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 Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git-squash-branch
git-thaw
git-upstream-diff Add quotes around paths in bash scripts 5 years ago
git_cache.py
git_cl.py Add escalation instructions to git cl upload 5 years ago
git_cl_completion.sh
git_common.py
git_dates.py Added git hyper-blame, a tool that skips unwanted commits in git blame. 10 years ago
git_drover.py
git_find_releases.py Add unit tests for git_find_releases 5 years ago
git_footers.py Replace non-inclusive terms 5 years ago
git_freezer.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_hyper_blame.py Add support for git_hyper_blame for Windows 5 years ago
git_map.py git-map: Refactor and add simple tests 6 years ago
git_map_branches.py Replace non-inclusive terms 5 years ago
git_mark_merge_base.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_migrate_default_branch.py Add git-migrate-default-branch 5 years ago
git_nav_downstream.py
git_new_branch.py
git_number.py
git_rebase_update.py Added option to keep empty branches in rebase-update. 5 years ago
git_rename_branch.py git-rebase-update: Make tests run on Python 3. 6 years ago
git_reparent_branch.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_retry.py Replace non-inclusive terms 5 years ago
git_squash_branch.py Revert "depot_tools: Run Python scripts using vpython (Part 1)" 6 years ago
git_upstream_diff.py
gn
gn.bat
gn.py
goma_auth
goma_auth.bat
goma_ctl
goma_ctl.bat
gsutil.py depot_tools: Make gsutil compatible with python3. 6 years ago
gsutil.py.bat
gsutil.vpython Replace non-inclusive terms 5 years ago
led
led.bat
lockfile.py
luci-auth
luci-auth.bat
lucicfg
lucicfg.bat
mac_toolchain
metrics.README.md
metrics.py Adding AIX 5 years ago
metrics_utils.py depot_tools: Make some changes to make metrics collection compatible with Python 3. 6 years ago
my_activity.py
ninja
ninja-linux32
ninja-linux64
ninja-mac
ninja.exe
ninjalog.README.md
ninjalog_uploader.py
ninjalog_uploader_wrapper.py
owners.py Change to slash separator to fix a bug on Windows in owners.py 5 years ago
owners_client.py
owners_finder.py
post_build_ninja_summary.py
presubmit_canned_checks.py
presubmit_support.py
profile.xml
prpc
prpc.bat
pylint
pylint-1.5
pylint-1.6
pylint-1.7
pylint-1.8
pylint-1.9
pylint-2.6
pylint.bat
pylint_main.py
pylintrc
python_runner.sh
rdb
rdb.bat
rdb_wrapper.py
repo
repo_launcher
roll-dep
roll-dep.bat
roll_dep.py
scm.py Use real default branch in gclient 5 years ago
setup_color.py
split_cl.py split-cl: Use owners client to suggest owners. 5 years ago
subcommand.py
subprocess2.py [subprocess2] Replace VOID with DEVNULL 5 years ago
update_depot_tools
update_depot_tools.bat
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 Improve upload_to_google_storage.py missing file handling 5 years ago
vpython
vpython.bat
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 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.

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.