[py3.12] Use a Raw String in post_build_ninja_summary

depot_tools/post_build_ninja_summary.py:5: SyntaxWarning: invalid
escape sequence '\d'
  """Summarize the last ninja build, invoked with ninja's -C syntax.

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