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
Robert Iannucci a19649b86b Clean up cache_dir handling in gclient/git_cache/bot_update.
This CL makes a couple changes:
  * The goal here is to be able to specify git cache entirely from the
    environment variable $GIT_CACHE_PATH and not require special treatment from
    bot_update. Eventually this will be specified at the swarming task level
    instead of in the recipe (i.e. "cached git" will eventually be an
    implementation detail of git on the bots and completely transparent to
    all other software).
  * Removal of the general --cache-dir option from gclient. This option was
    error-prone; it doesn't actually make sense to configure this on
    a per-invocation basis. The sole exception was `gclient config`, which
    now allows this option to be set directly.
  * Consolidation of GitWrapper.cache_dir and GitWrapper._GetMirror; previously
    these two things could disagree, leading to weird intermediate states. Now
    they're the same value.

R=agable@chromium.org, ehmaldonado@chromium.org, tandrii@chromium.org

Bug: 823434
Change-Id: I14adc7619b5fc10768ce32be2651c6215ba94aff
Reviewed-on: https://chromium-review.googlesource.com/1105473
Reviewed-by: Aaron Gable <agable@chromium.org>
Reviewed-by: Edward Lesmes <ehmaldonado@chromium.org>
Reviewed-by: Andrii Shyshkalov <tandrii@chromium.org>
Commit-Queue: Robbie Iannucci <iannucci@chromium.org>
7 years ago
bootstrap/win Update windows git to 2.17.1 7 years ago
fetch_configs fetch: stop specifying .DEPS.git for any repos 7 years ago
git-templates
infra Roll recipe dependencies (trivial). 7 years ago
man Fix minor regression in git_upstream_diff. 7 years ago
recipes Roll recipe dependencies (trivial). 7 years ago
support chromite_wrapper: add python3 support for except 7 years ago
testing_support gclient: escape cipd variables when flattening DEPS. 7 years ago
tests Clean up cache_dir handling in gclient/git_cache/bot_update. 7 years ago
third_party pylint: update to 1.4.5 7 years ago
win_toolchain [win-cross] Support using a zip file for the Windows SDK 7 years ago
zsh-goodies
.gitattributes Add yapf 7 years ago
.gitignore Add vs_files.ciopfs to gitignore 8 years ago
.style.yapf
LICENSE
OWNERS Remove petermayo from OWNERS 7 years ago
PRESUBMIT.py Demote linux-386 to "best effort support", just like e.g. linux-ppc64. 7 years ago
README.gclient.md
README.git-cl.md
README.md Third whitespace change to test builder. 7 years ago
README.testing
WATCHLISTS Remove tandrii@ from watching git cl changes. 7 years ago
annotated_gclient.py
appengine_mapper.py
auth.py auth: request refresh tokens with expiry <3 minutes. 7 years ago
autoninja Fix autoninja && chrome on failed builds 8 years ago
autoninja.bat Fix autoninja && chrome on failed builds 8 years ago
autoninja.py Teach autoninja.py to support GOMA_DISABLED env var 7 years ago
breakpad.py
buildbucket.py
cbuildbot
checkout.py Use core.quotePath=false for more git diffs 8 years ago
chrome_set_ver
cipd AIX: Enable usage of fetch and gclient 7 years ago
cipd.bat [cipd] Do not rewrite ERRORLEVEL 7 years ago
cipd.ps1 [cipd] Bump version, log at warning (#2). 8 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] Bump cipd and vpython to versions that use v2 protocol by default. 7 years ago
cipd_manifest.txt [cipd] Bump cipd and vpython to versions that use v2 protocol by default. 7 years ago
cit
cit.bat [.bat] Remove "depot_tools" override. (#2) 8 years ago
cit.py [cit] Use subprocess2 to properly sink stdout. 8 years ago
clang-format
clang-format.bat [.bat] Remove "depot_tools" override. (#2) 8 years ago
clang_format.py Improve clang-format error messages when run outside of chromium checkout 9 years ago
clang_format_merge_driver
clang_format_merge_driver.bat [.bat] Remove "depot_tools" override. (#2) 8 years ago
clang_format_merge_driver.py
codereview.settings
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 Add a script to make it easier to build a single source file with ninja 8 years ago
cpplint.bat [.bat] Remove "depot_tools" override. (#2) 8 years ago
cpplint.py Revert "cpplint: Pull in upstream changes" 7 years ago
cpplint_chromium.py
cros
cros_sdk
dart_format.py
depot-tools-auth
depot-tools-auth.bat [.bat] Remove "depot_tools" override. (#2) 8 years ago
depot-tools-auth.py
detect_host_arch.py Add target_cpu builtin variable to gclient 8 years ago
download_from_google_storage
download_from_google_storage.bat [.bat] Remove "depot_tools" override. (#2) 8 years ago
download_from_google_storage.py AIX: Enable usage of fetch and gclient 7 years ago
ensure_bootstrap [depot_tools] Add "ensure_bootstrap" script. 8 years ago
fetch
fetch.bat [.bat] Remove "depot_tools" override. (#2) 8 years ago
fetch.py Don't fetch tags when using --no-history. 8 years ago
fix_encoding.py depot_tools: Replace pylint error numbers with symbolic names. 9 years ago
gclient
gclient-new-workdir.py os.realpath => os.path.realpath in gclient-new-workdir.py 8 years ago
gclient.bat [.bat] Remove "depot_tools" override. (#2) 8 years ago
gclient.py Clean up cache_dir handling in gclient/git_cache/bot_update. 7 years ago
gclient_completion.sh
gclient_eval.py Reland "Reland "Expand variables in gclient flattened output."" 7 years ago
gclient_scm.py Clean up cache_dir handling in gclient/git_cache/bot_update. 7 years ago
gclient_utils.py Reland "gclient: Add commands to edit dependencies and variables in DEPS" 7 years ago
gerrit_client.py depot_tools: Fix executable bit for gerrit_*.py 8 years ago
gerrit_util.py Add gerrit retries for HTTP 409 Conflict responses. 7 years ago
git-cache
git-cl
git-crrev-parse Fix git-crrev-parse on Mac. 8 years ago
git-crsync
git-drover
git-find-releases
git-footers
git-freeze
git-gs Add *.proto to git-gs 8 years ago
git-hyper-blame
git-map
git-map-branches
git-mark-merge-base
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 Clean up cache_dir handling in gclient/git_cache/bot_update. 7 years ago
git_cl.py Add an `--ignore-current` flag to `git cl owners` to start from scratch. 7 years ago
git_cl_completion.sh
git_common.py os.realpath => os.path.realpath in gclient-new-workdir.py 8 years ago
git_dates.py
git_drover.py Reland "Use core.quotePath=false when git is listing files" 8 years ago
git_find_releases.py
git_footers.py Let git_footers split final paragraphs in specific cases 8 years ago
git_freezer.py
git_hyper_blame.py git hyper-blame: Fix tabulation of Unicode characters in author name. 8 years ago
git_map.py git-map: use committer date instead of author date 8 years ago
git_map_branches.py Update help text for git-map-branches 8 years ago
git_mark_merge_base.py
git_nav_downstream.py
git_new_branch.py Add a '--inject-current' option to 'git new-branch' 7 years ago
git_number.py Pass user name and email to git-number's initial commit. 8 years ago
git_rebase_update.py Flush stdout before squash attempt 8 years ago
git_rename_branch.py
git_reparent_branch.py
git_retry.py [git retry] Fix Git wrapper fallthrough. 8 years ago
git_squash_branch.py Include branch name in git-squash-branch's default message 9 years ago
git_upstream_diff.py Fix minor regression in git_upstream_diff. 7 years ago
gn
gn.bat [.bat] Remove "depot_tools" override. (#2) 8 years ago
gn.py gn: Look in src for gn binaries before trying old buildtools location 7 years ago
gsutil.py gsutil update default version to 4.30 7 years ago
gsutil.vpython [gsutil.vpython] Update packages. 8 years ago
led [bootstraps] Sync at gclient, suppress output (#2) 8 years ago
led.bat [bootstraps] Sync at gclient, suppress output (#2) 8 years ago
luci-auth [luci-auth] Add statically-linked luci-auth CLI tool. 8 years ago
luci-auth.bat [luci-auth] Add statically-linked luci-auth CLI tool. 8 years ago
mac_toolchain depot_tools: add mac_toolchain shim 8 years ago
my_activity.py Print access errors using logging.error 7 years ago
my_reviews.py Use dateutil.parser for parsing dates. 8 years ago
ninja Update ninja to v1.8.2 8 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
owners.py owners: Add support for comments at the end of the line. 7 years ago
owners_finder.py Skip files owned by reviewers when quering for missing owners. 8 years ago
patch.py Revert "Fix checkout.py issues when p.patchlevel > 1." 8 years ago
post_build_ninja_summary.py Improve post_build_ninja_summary.py's incremental build handling 7 years ago
presubmit_canned_checks.py Allow CheckPatchFormatted to cause a failure 7 years ago
presubmit_support.py Add gclient_utils to InputAPI export. 7 years ago
profile.xml
prpc [prpc] Add pRPC CLI tool to depot_tools. 8 years ago
prpc.bat [prpc] Add pRPC CLI tool to depot_tools. 8 years ago
pylint
pylint.py
pylintrc depot_tools: Replace pylint error numbers with symbolic names. 9 years ago
python_runner.sh
repo
rietveld.py Change rietveld.py to use GET on get_depends_on_patchset 8 years ago
roll-dep
roll-dep-svn
roll-dep-svn.bat [.bat] Remove "depot_tools" override. (#2) 8 years ago
roll-dep.bat [.bat] Remove "depot_tools" override. (#2) 8 years ago
roll_dep.py Reland "Reland "Expand variables in gclient flattened output."" 7 years ago
roll_dep_svn.py Update roll_dep_svn for new DEPS syntax 8 years ago
scm.py Use core.quotePath=false for more git diffs 8 years ago
setup_color.py setup_color.py should not be executable, as it pollutes $PATH. 8 years ago
split_cl.py Add a --dry-run option to git cl split 8 years ago
subcommand.py Revert "gclient: return non-zero exit code on unknown command" 8 years ago
subprocess2.py depot_tools: Replace pylint error numbers with symbolic names. 9 years ago
update_depot_tools Revert "update_depot_tools: make cipd_bin_setup failures fatal" 8 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_to_google_storage.py Make download_from_google_storage.py print nothing in the happy case where it needs to do nothing. 8 years ago
vpython [vpython] Implement developer bypass parser in vpython wrapper. 8 years ago
vpython.bat [bootstraps] Sync at gclient, suppress output (#2) 8 years ago
watchlists.py watchlists: Precompile filepath regular expressions before using them. 8 years ago
weekly
wtf
yapf Add yapf 7 years ago
yapf.bat Add yapf 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

To update cpplint.py, please submit the change upstream first at https://github.com/google/styleguide/tree/gh-pages/cpplint then copy it down.