| OLD | NEW |
| 1 # Bootstrapping infra.git | 1 # Bootstrapping infra.git |
| 2 | 2 |
| 3 [TOC] | 3 [TOC] |
| 4 | 4 |
| 5 The [infra.git](/) repo uses python [wheel files][wheel files], | 5 The [infra.git](/) repo uses python [wheel files][wheel files], |
| 6 [virtualenv][virtualenv] and [pip][pip] to manage dependencies. The process for | 6 [virtualenv][virtualenv] and [pip][pip] to manage dependencies. The process for |
| 7 bootstrapping these is contained entirely within [bootstrap/ directory](.). | 7 bootstrapping these is contained entirely within [bootstrap/ directory](.). |
| 8 | 8 |
| 9 ## TL;DR - Workflows | 9 ## TL;DR - Workflows |
| 10 | 10 |
| (...skipping 69 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 80 See [custom builds](#Custom-builds) below for more detail. | 80 See [custom builds](#Custom-builds) below for more detail. |
| 81 | 81 |
| 82 ## bootstrap.py (a.k.a. "I just want a working infra repo!") | 82 ## bootstrap.py (a.k.a. "I just want a working infra repo!") |
| 83 | 83 |
| 84 Run `gclient runhooks`. Under the hood, this runs: | 84 Run `gclient runhooks`. Under the hood, this runs: |
| 85 | 85 |
| 86 ./bootstrap/bootstrap.py --deps_file bootstrap/deps.pyl ENV | 86 ./bootstrap/bootstrap.py --deps_file bootstrap/deps.pyl ENV |
| 87 | 87 |
| 88 This creates a virtualenv called `{repo_root}/ENV` with all the deps | 88 This creates a virtualenv called `{repo_root}/ENV` with all the deps |
| 89 contained in `bootstrap/deps.pyl`. You must be online, or must already | 89 contained in `bootstrap/deps.pyl`. You must be online, or must already |
| 90 have the wheels for your system cached in `{repo_root}/.wheelcache`. | 90 have the wheels for your system in cache. |
| 91 | 91 |
| 92 If you already have an `ENV` directory, [bootstrap.py](bootstrap.py) will check | 92 If you already have an `ENV` directory, [bootstrap.py](bootstrap.py) will check |
| 93 the manifest in `ENV` to see if it matches [deps.pyl](#deps_pyl) (i.e. the diff | 93 the manifest in `ENV` to see if it matches [deps.pyl](#deps_pyl) (i.e. the diff |
| 94 is zero). If it's not, then `ENV` directory will be re-created *from scratch*. | 94 is zero). If it's not, then `ENV` directory will be re-created *from scratch*. |
| 95 | 95 |
| 96 [run.py](../run.py) will automatically use the environment `ENV`. It is | 96 [run.py](../run.py) will automatically use the environment `ENV`. It is |
| 97 an error to use `run.py` without first setting up `ENV`. | 97 an error to use `run.py` without first setting up `ENV`. |
| 98 | 98 |
| 99 ## [deps.pyl](deps.pyl) | 99 ## [deps.pyl](deps.pyl) |
| 100 | 100 |
| (...skipping 130 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 231 an additional component to the version field). | 231 an additional component to the version field). |
| 232 | 232 |
| 233 For example, given the package `jane` at version `2.1.3`, we would | 233 For example, given the package `jane` at version `2.1.3`, we would |
| 234 create a branch `2.1.3-cr`. On this branch we would commit any changes | 234 create a branch `2.1.3-cr`. On this branch we would commit any changes |
| 235 necessary to `2.1.3`, and would adjust the version number in the builds | 235 necessary to `2.1.3`, and would adjust the version number in the builds |
| 236 to be e.g. `2.1.3.0`. | 236 to be e.g. `2.1.3.0`. |
| 237 | 237 |
| 238 [wheel files]: https://www.python.org/dev/peps/pep-0427/ | 238 [wheel files]: https://www.python.org/dev/peps/pep-0427/ |
| 239 [virtualenv]: https://github.com/pypa/virtualenv | 239 [virtualenv]: https://github.com/pypa/virtualenv |
| 240 [pip]: https://github.com/pypa/pip | 240 [pip]: https://github.com/pypa/pip |
| OLD | NEW |