Roll recipe dependencies (trivial).

This is an automated CL created by the recipe roller. This CL rolls
recipe changes from upstream projects (recipe_engine) into this repository.

The build that created this CL was
https://ci.chromium.org/b/8695016752459418833

recipe_engine:
https://chromium.googlesource.com/infra/luci/recipes-py.git/+/cdde04afdd77b51baf4df39d8ca6f54eba99fb3d
  cdde04a (iannucci@chromium.org)
      [TurboCI] Fix fake to have more internal coherency.

Please check the following references for more information:
- autoroller, https://chromium.googlesource.com/infra/luci/recipes-py/+/main/doc/workflow.md#autoroller
- rollback, https://chromium.googlesource.com/infra/luci/recipes-py/+/main/doc/workflow.md#rollback
- cross-repo dependencies, https://chromium.googlesource.com/infra/luci/recipes-py/+/main/doc/cross_repo.md

Use https://goo.gl/noib3a to file a bug.

R=iannucci@chromium.org

Recipe-Tryjob-Bypass-Reason: Autoroller
Ignore-Freeze: Autoroller
Bugdroid-Send-Email: False
Change-Id: I905d08d09ee00f4b5dde596afc58e6b7d2a36fa7
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/tools/depot_tools/+/7281347
Commit-Queue: Recipe Roller <recipe-mega-autoroller@chops-service-accounts.iam.gserviceaccount.com>
Bot-Commit: Recipe Roller <recipe-mega-autoroller@chops-service-accounts.iam.gserviceaccount.com>
2 files changed
tree: 2cbeb477a8c194a516a6c3bcd0b3e15654b4c864
  1. .vscode/
  2. bootstrap/
  3. fetch_configs/
  4. hooks/
  5. infra/
  6. infra_lib/
  7. man/
  8. mcp/
  9. metadata/
  10. python-bin/
  11. python2-bin/
  12. recipes/
  13. testing_support/
  14. tests/
  15. third_party/
  16. win_toolchain/
  17. zsh-goodies/
  18. .cipd_impl.ps1
  19. .flake8
  20. .git-blame-ignore-revs
  21. .gitattributes
  22. .gitignore
  23. .isort.cfg
  24. .style.yapf
  25. .vpython3
  26. android_build_server_helper.py
  27. auth.py
  28. autoninja
  29. autoninja.bat
  30. autoninja.py
  31. bazel.py
  32. bb
  33. bb.bat
  34. black
  35. bootstrap_python3
  36. breakpad.py
  37. BUILD_OWNERS
  38. build_telemetry
  39. build_telemetry.bat
  40. build_telemetry.py
  41. caffeinate.py
  42. cipd
  43. cipd.bat
  44. cipd_bin_setup.bat
  45. cipd_bin_setup.sh
  46. cipd_client_version
  47. cipd_client_version.digests
  48. cipd_manifest.txt
  49. cipd_manifest.versions
  50. cipd_manifest_cros_python2.txt
  51. cipd_manifest_cros_python2.versions
  52. clang-format
  53. clang-format.bat
  54. clang_format.py
  55. codereview.settings
  56. compile_single_file
  57. compile_single_file.bat
  58. compile_single_file.py
  59. cpplint.bat
  60. cpplint.py
  61. cpplint_chromium.py
  62. create_temp_file.py
  63. cros
  64. CROS_OWNERS
  65. cros_python2.vpython
  66. detect_host_arch.py
  67. DIR_METADATA
  68. dirmd
  69. dirmd.bat
  70. download_from_google_storage
  71. download_from_google_storage.bat
  72. download_from_google_storage.py
  73. ensure_bootstrap
  74. fetch
  75. fetch.bat
  76. fetch.py
  77. gclient
  78. gclient-new-workdir.py
  79. gclient.bat
  80. gclient.py
  81. gclient_completion.sh
  82. gclient_eval.py
  83. gclient_paths.py
  84. gclient_scm.py
  85. gclient_utils.py
  86. gerrit_cache.py
  87. gerrit_client.py
  88. gerrit_util.py
  89. git-cache
  90. git-cl
  91. git-credential-luci
  92. git-credential-luci.bat
  93. git-crrev-parse
  94. git-drover
  95. git-find-releases
  96. git-footers
  97. git-freeze
  98. git-gs
  99. git-hyper-blame
  100. git-map
  101. git-map-branches
  102. git-mark-merge-base
  103. git-nav-downstream
  104. git-nav-upstream
  105. git-new-branch
  106. git-number
  107. git-rebase-update
  108. git-rename-branch
  109. git-reparent-branch
  110. git-retry
  111. git-runhooks
  112. git-squash-branch
  113. git-squash-branch-tree
  114. git-thaw
  115. git-upstream-diff
  116. git_auth.py
  117. git_cache.py
  118. git_cl.py
  119. git_cl_completion.sh
  120. git_common.py
  121. git_completion.sh
  122. git_dates.py
  123. git_find_releases.py
  124. git_footers.py
  125. git_freezer.py
  126. git_hyper_blame.py
  127. git_map.py
  128. git_map_branches.py
  129. git_mark_merge_base.py
  130. git_nav_downstream.py
  131. git_new_branch.py
  132. git_number.py
  133. git_rebase_update.py
  134. git_rename_branch.py
  135. git_reparent_branch.py
  136. git_retry.py
  137. git_squash_branch.py
  138. git_squash_branch_tree.py
  139. git_upstream_diff.py
  140. gn
  141. gn.bat
  142. gn.py
  143. gn_helper.py
  144. google-java-format
  145. google-java-format.bat
  146. google_java_format.py
  147. gsutil.py
  148. gsutil.py.bat
  149. gsutil.py.vpython3
  150. isort
  151. led
  152. led.bat
  153. LICENSE
  154. lockfile.py
  155. luci-auth
  156. luci-auth-fido2-plugin.bat
  157. luci-auth-ssh-helper
  158. luci-auth-ssh-helper.bat
  159. luci-auth-ssh-plugin
  160. luci-auth-ssh-plugin.bat
  161. luci-auth.bat
  162. luci_auth_fido2_plugin.py
  163. LUCI_OWNERS
  164. lucicfg
  165. lucicfg.bat
  166. mac_toolchain
  167. metrics-xml-format
  168. metrics.py
  169. metrics.README.md
  170. metrics_utils.py
  171. metrics_xml_format.py
  172. my_activity.py
  173. newauth.py
  174. ninja
  175. ninja.bat
  176. ninja.py
  177. ninjalog_uploader.py
  178. OWNERS
  179. owners_client.py
  180. owners_finder.py
  181. pinpoint
  182. pinpoint.bat
  183. post_build_ninja_summary.py
  184. PRESUBMIT.py
  185. presubmit_canned_checks.py
  186. presubmit_diff.py
  187. presubmit_support.py
  188. prpc
  189. prpc.bat
  190. pylint-2.17
  191. pylint-2.17.bat
  192. pylint-2.6
  193. pylint-2.6.bat
  194. pylint-2.7
  195. pylint-2.7.bat
  196. pylint-3.2
  197. pylint-3.2.bat
  198. pylint_main.py
  199. pylintrc-2.17
  200. pylintrc-2.6
  201. pylintrc-2.7
  202. pylintrc-3.2
  203. pyproject.toml
  204. python_runner.sh
  205. rdb
  206. rdb.bat
  207. rdb_wrapper.py
  208. README.gclient.md
  209. README.git-cl.md
  210. README.google_cloud_storage.md
  211. README.md
  212. reclient_helper.py
  213. RECLIENT_OWNERS
  214. reclientreport
  215. reclientreport.bat
  216. reclientreport.py
  217. repo
  218. repo_launcher
  219. roll-dep
  220. roll-dep.bat
  221. roll_dep.py
  222. roll_downstream_gcs_deps.py
  223. rustfmt.py
  224. scm.py
  225. setup_color.py
  226. siso
  227. siso.bat
  228. siso.py
  229. split_cl.py
  230. subcommand.py
  231. subprocess2.py
  232. swift-format
  233. swift_format.py
  234. update_depot_tools
  235. update_depot_tools.bat
  236. update_depot_tools_toggle.py
  237. upload_metrics.py
  238. upload_to_google_storage.py
  239. upload_to_google_storage_first_class.py
  240. utils.py
  241. vpython3
  242. vpython3.bat
  243. WATCHLISTS
  244. watchlists.py
  245. whitespace.txt
  246. win32imports.py
  247. yapf
  248. yapf.bat
README.md

depot_tools

Tools for Chromium development. Requires Python 3.8+.

gsutil: Python 3.9–3.13 required.

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.

Also, includes shell script/batch file for tools required to build chromium, e.g.

  • gn: a meta-build system that generates build files for Ninja
  • autoninja: a wrapper for siso and ninja.
  • siso: a build tool that aims to significantly speed up Chromium's build.
  • ninja: a small build system with a focus on speed. deprecated by Siso.

These shell script/batch file runs python script with python-bin/python3 that find binaries in chromium checkout, and run with proper setup/check. To use these wrappers, you need to initialize/bootstrap depot_tools (using gclient, update_depot_tools or ensure_bootstrap).

Installing

See set-up documentation.

depot_tools is also available in

These depot_tools would not be initialized/bootstrapped (i.e. no python-bin/python3 binary available), so the build tool wrapper won't work, unless it is explicitly initialized by ensure_bootstrap. Or, directly call the python script instead of using the shell script/batch file.

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.

Running gclient will install python3 binary.

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.