InTheForest/chromium_depot_tools
1
0
Fork 0
mirror of https://chromium.googlesource.com/chromium/tools/depot_tools.git synced 2026-01-11 18:51:29 +00:00
Code Issues Packages Projects Releases Wiki Activity

[win-bootstrap] Update docs for removal of git

Browse Source 
Bug: b/360206460
Change-Id: I19da03909a082ac0414b751bf316600fa1bed403
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/tools/depot_tools/+/6205107
Commit-Queue: Anne Redulla <aredulla@google.com>
Reviewed-by: Josip Sokcevic <sokcevic@chromium.org>
This commit is contained in:
Anne Redulla
2025-01-28 15:47:03 -08:00
committed by LUCI CQ
parent 03aad37858
commit 9f48a4ca85
2 changed files with 17 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
README.md
View File

@@ -32,7 +32,7 @@ run `./update_depot_tools_toggle.py --disable`.
To update package manually, run `update_depot_tools.bat` on Windows, To update package manually, run `update_depot_tools.bat` on Windows,
or `./update_depot_tools` on Linux or Mac. or `./update_depot_tools` on Linux or Mac.
On Windows only, running `gclient` will install `git` and `python`. On Windows only, running `gclient` will install `python`.
## Contributing ## Contributing

34
bootstrap/README.md
View File

@@ -4,19 +4,15 @@ This directory has the 'magic' for the `depot_tools` windows binary update
mechanisms. mechanisms.
A previous Python may actually be in use when it is run, preventing us A previous Python may actually be in use when it is run, preventing us
from replacing it outright without breaking running code. To from replacing it outright without breaking running code. To accommodate this,
ommodate this, and Python cleanup, we handle Python in two stages: and Python cleanup, we handle Python in two stages:
1. Use CIPD to install both Git and Python at once. 1. Use CIPD to install Python.
2. Use "bootstrap.py" as a post-processor to install generated files and 2. Use "bootstrap.py" as a post-processor to install generated files and
fix-ups. fix-ups.
## Software bootstrapped ## Software bootstrapped
* Python 3 (https://www.python.org/) * Python 3 (https://www.python.org/)
* Git for Windows (https://git-for-windows.github.io/)
* This will soon be unbundled from depot_tools. To prepare for this change,
please install Git directly. See the instructions in the
[Windows build docs](https://chromium.googlesource.com/chromium/src/+/main/docs/windows_build_instructions.md#Install-git).
## Mechanism ## Mechanism
@@ -29,34 +25,36 @@ work.
package is present, and if so, if it's the expected version. If either of those package is present, and if so, if it's the expected version. If either of those
cases is not true, it will download and unpack the respective binary. cases is not true, it will download and unpack the respective binary.
Installation of Git and Python is done by the [win_tools.bat](./win_tools.bat) Installation of Python is done by the [win_tools.bat](./win_tools.bat)
script, which uses CIPD (via the [cipd](/cipd.bat) bootstrap) to acquire and script, which uses CIPD (via the [cipd](/cipd.bat) bootstrap) to acquire and
install each package into the root of the `depot_tools` repository. Afterwards, install each package into the root of the `depot_tools` repository. Afterwards,
the [bootstrap.py](./bootstrap.py) Python script is invoked to install stubs, the [bootstrap.py](./bootstrap.py) Python script is invoked to install stubs,
wrappers, and support scripts into `depot_tools` for end-users. wrappers, and support scripts into `depot_tools` for end-users. This includes
checking whether the current global Git config matches recommended settings.
### Manifest ### Manifest
The Git and Python versions are specified in [manifest.txt](./manifest.txt). The Python version is specified in [manifest.txt](./manifest.txt).
There is an associated file, There is an associated file,
[manifest_bleeding_edge.txt](./manifest_bleeding_edge.txt), that can be used [manifest_bleeding_edge.txt](./manifest_bleeding_edge.txt), that can be used
to canary new versions on select bots. Any bots with a `.bleeding_edge` file to canary a new version on select bots. Any bots with a `.bleeding_edge` file
in their `depot_tools` root will automatically use the bleeding edge manifest. in their `depot_tools` root will automatically use the bleeding edge manifest.
This allows opt-in systems to test against new versions of Python or Git. Once This allows opt-in systems to test against new versions of Python. Once
those versions have been verified correct, `manifest.txt` can be updated to the the version has been verified correct, `manifest.txt` can be updated to the
same specification, which will cause the remainder of systems to update. same specification, which will cause the remainder of systems to update.
### Bundles ### Bundles
Git and Python bundle construction is documented in Python bundles are maintained by 3pp builders. See the
[infra packaging](https://chromium.googlesource.com/infra/infra/+/HEAD/doc/packaging/). [3pp docs](https://chromium.googlesource.com/infra/infra/+/HEAD/3pp/README.md)
for more info.
Note that in order for the update to take effect, `gclient` currently needs to Note that in order for the update to take effect, `gclient` currently needs to
run twice. The first time it will update the `depot_tools` repo, and the second run twice. The first time it will update the `depot_tools` repo, and the second
time it will see the new git version and update to it. This is a bug that should time it will see the new Python version and update to it. This is a bug that
be fixed, in case you're reading this and this paragraph infuriates you more should be fixed, in case you're reading this and this paragraph infuriates you
than the rest of this README. more than the rest of this README.
## Testing ## Testing