Google Git
Sign in
chromium / chromium / tools / depot_tools / af68505dfe0c6f4d42dc6847bf1c2469f4305181
commitaf68505dfe0c6f4d42dc6847bf1c2469f4305181[log] [tgz]
authorJordan Brown <rop@google.com>Thu Jan 09 07:54:11 2025
committerLUCI CQ <infra-scoped@luci-project-accounts.iam.gserviceaccount.com>Thu Jan 09 07:54:11 2025
treed81a857a47b95d408da652924eca4e04be5c7718
parentec23ea2c79cea23d75807f1bf1324e8f352a685b [diff]
Add an open source only licenses set.

This is a list of licenses classified as 'reciprocal'. Due to the requirements of licenses of this type we can only allow their use in open source projects. This change introduces the variable 'OPEN_SOURCE_SPDX_LICENSES' with an initial set of reciprocal licenses currently used in chromium.

Change-Id: I376a7623e3685d67edd63ceb3088ca68c9d2fb7e
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/tools/depot_tools/+/6107860
Reviewed-by: Rachael Newitt <renewitt@google.com>
Commit-Queue: Jordan Brown <rop@google.com>
1 file changed
tree: d81a857a47b95d408da652924eca4e04be5c7718
  1. bootstrap/
  2. fetch_configs/
  3. hooks/
  4. infra/
  5. infra_lib/
  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. bazel ⇨ bazel.py
  17. cbuildbot ⇨ cros
  18. cros_sdk ⇨ cros
  19. gerrit ⇨ cros
  20. .cipd_impl.ps1
  21. .flake8
  22. .git-blame-ignore-revs
  23. .gitattributes
  24. .gitignore
  25. .isort.cfg
  26. .style.yapf
  27. .vpython3
  28. android_build_server_helper.py
  29. auth.py
  30. autoninja
  31. autoninja.bat
  32. autoninja.py
  33. bazel.py
  34. bb
  35. bb.bat
  36. black
  37. bootstrap_python3
  38. breakpad.py
  39. BUILD_OWNERS
  40. build_telemetry
  41. build_telemetry.bat
  42. build_telemetry.py
  43. cipd
  44. cipd.bat
  45. cipd_bin_setup.bat
  46. cipd_bin_setup.sh
  47. cipd_client_version
  48. cipd_client_version.digests
  49. cipd_manifest.txt
  50. cipd_manifest.versions
  51. cipd_manifest_cros_python2.txt
  52. cipd_manifest_cros_python2.versions
  53. clang-format
  54. clang-format.bat
  55. clang_format.py
  56. codereview.settings
  57. compile_single_file
  58. compile_single_file.bat
  59. compile_single_file.py
  60. cpplint.bat
  61. cpplint.py
  62. cpplint_chromium.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_client.py
  87. gerrit_util.py
  88. git-cache
  89. git-cl
  90. git-credential-luci
  91. git-credential-luci.bat
  92. git-crrev-parse
  93. git-drover
  94. git-find-releases
  95. git-footers
  96. git-freeze
  97. git-gs
  98. git-hyper-blame
  99. git-map
  100. git-map-branches
  101. git-mark-merge-base
  102. git-nav-downstream
  103. git-nav-upstream
  104. git-new-branch
  105. git-number
  106. git-rebase-update
  107. git-rename-branch
  108. git-reparent-branch
  109. git-retry
  110. git-runhooks
  111. git-squash-branch
  112. git-squash-branch-tree
  113. git-thaw
  114. git-upstream-diff
  115. git_auth.py
  116. git_cache.py
  117. git_cl.py
  118. git_cl_completion.sh
  119. git_common.py
  120. git_completion.sh
  121. git_dates.py
  122. git_find_releases.py
  123. git_footers.py
  124. git_freezer.py
  125. git_hyper_blame.py
  126. git_map.py
  127. git_map_branches.py
  128. git_mark_merge_base.py
  129. git_nav_downstream.py
  130. git_new_branch.py
  131. git_number.py
  132. git_rebase_update.py
  133. git_rename_branch.py
  134. git_reparent_branch.py
  135. git_retry.py
  136. git_squash_branch.py
  137. git_squash_branch_tree.py
  138. git_upstream_diff.py
  139. gn
  140. gn.bat
  141. gn.py
  142. gn_helper.py
  143. google-java-format
  144. google-java-format.bat
  145. google_java_format.py
  146. gsutil.py
  147. gsutil.py.bat
  148. gsutil.vpython3
  149. isort
  150. led
  151. led.bat
  152. LICENSE
  153. lockfile.py
  154. luci-auth
  155. luci-auth.bat
  156. LUCI_OWNERS
  157. lucicfg
  158. lucicfg.bat
  159. mac_toolchain
  160. metrics-xml-format
  161. metrics.py
  162. metrics.README.md
  163. metrics_utils.py
  164. metrics_xml_format.py
  165. my_activity.py
  166. newauth.py
  167. ninja
  168. ninja.bat
  169. ninja.py
  170. ninjalog_uploader.py
  171. OWNERS
  172. owners_client.py
  173. owners_finder.py
  174. pinpoint
  175. pinpoint.bat
  176. post_build_ninja_summary.py
  177. PRESUBMIT.py
  178. presubmit_canned_checks.py
  179. presubmit_diff.py
  180. presubmit_support.py
  181. prpc
  182. prpc.bat
  183. pylint-2.17
  184. pylint-2.17.bat
  185. pylint-2.6
  186. pylint-2.6.bat
  187. pylint-2.7
  188. pylint-2.7.bat
  189. pylint-3.2
  190. pylint-3.2.bat
  191. pylint_main.py
  192. pylintrc-2.17
  193. pylintrc-2.6
  194. pylintrc-2.7
  195. pylintrc-3.2
  196. python_runner.sh
  197. rdb
  198. rdb.bat
  199. rdb_wrapper.py
  200. README.gclient.md
  201. README.git-cl.md
  202. README.md
  203. reclient_helper.py
  204. RECLIENT_OWNERS
  205. reclientreport
  206. reclientreport.bat
  207. reclientreport.py
  208. repo
  209. repo_launcher
  210. roll-dep
  211. roll-dep.bat
  212. roll_dep.py
  213. roll_downstream_gcs_deps.py
  214. rustfmt.py
  215. scm.py
  216. setup_color.py
  217. siso
  218. siso.bat
  219. siso.py
  220. split_cl.py
  221. subcommand.py
  222. subprocess2.py
  223. swift-format
  224. swift_format.py
  225. update_depot_tools
  226. update_depot_tools.bat
  227. update_depot_tools_toggle.py
  228. upload_metrics.py
  229. upload_to_google_storage.py
  230. upload_to_google_storage_first_class.py
  231. utils.py
  232. vpython3
  233. vpython3.bat
  234. WATCHLISTS
  235. watchlists.py
  236. whitespace.txt
  237. win32imports.py
  238. yapf
  239. 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.