mirror of
https://chromium.googlesource.com/chromium/tools/depot_tools.git
synced 2026-01-11 18:51:29 +00:00
f0bc2d2404
This is a reland of crrev/c/3461263 with fix for crbug/1298289 This change includes commits: 0a242ce3e02a0e7d9c519601ed4fafb073fc98da Update vpython tests to use py3 fc06fd6815873bc40819476f88808b61ac447739 Change vpython spec search order c6a2eb6ed31e0c815d7f28a42d7f12ee4cb47119 Update to latest virtualenv package. 038156fc1ffffa56b19c2c60674415eceb95f6bc New virtualenv to vpython. ef44f81748a55c3aaf028ccfa2ee11876cee1285 Fix vpython filelock 275c4196540e1ca41384031b292ad0b89393a5dc Revert "Fix vpython filelock" 8aadd8b60a6d3801f62c7e5cebdfe3dc828a1546 Fix vpython filelock 43c99d88a24870240c9ca50d67dcfade40b516cc Use resolved path when searching spec ffda9381bc01fd33e3c5a889e2ed374312c64ec6 Don't eval python symbol link on windows 30a66930f4037fff949d36c45b12f60a40ec524b Include GOARCH to verify cached environment 748dcd23529b6b138424914f1e6e265ed70d377b [vpython] Add period to log Bug:1279621,1158462,1278132,1279684 Change-Id: I224d6abf6e106116da83aa2c34447e8601e48c67 Reviewed-on: https://chromium-review.googlesource.com/c/chromium/tools/depot_tools/+/3530470 Reviewed-by: Josip Sokcevic <sokcevic@google.com> Commit-Queue: Chenlin Fan <fancl@chromium.org>
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: Agclientwrapper to checkout a project. Usefetch --helpfor 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. Usegclient helpfor more details and README.gclient.md.git cl: A code review tool to interact with Rietveld or Gerrit. Usegit cl helpfor 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.