Add infra_superproject context.

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