Allow TLS 1.2 and print error codes

An external developer reported that gclient sync fails on Windows 8.1
unless TLS 1.2 is explicitly enabled. This allows that security protocol
and prints a more detailed error message on failures.

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

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.