| OLD | NEW |
| 1 Structure of the infra.git repository | 1 Structure of the infra.git repository |
| 2 ===================================== | 2 ===================================== |
| 3 | 3 |
| 4 Please also read the root README.md file in the source tree. The following | 4 Please also read the root README.md file in the source tree. The following |
| 5 sections contain an overview of the directory layout. All paths are relative to | 5 sections contain an overview of the directory layout. All paths are relative to |
| 6 the root one, which means that infra/ refers to infra/infra/. | 6 the root one, which means that infra/ refers to infra/infra/. |
| 7 | 7 |
| 8 Entry points | 8 Entry points |
| 9 ------------ | 9 ------------ |
| 10 * run.py: wrapper script to run programs contained in subdirectories without | 10 * run.py: wrapper script to run programs contained in subdirectories without |
| (...skipping 24 matching lines...) Expand all Loading... |
| 35 --------------- | 35 --------------- |
| 36 * gnumbd: git numbering daemon. Adds a monotonically-increasing number to git | 36 * gnumbd: git numbering daemon. Adds a monotonically-increasing number to git |
| 37 commits. | 37 commits. |
| 38 * gsubtreed: git subtree daemon. Mirrors subdirectories of some repositories | 38 * gsubtreed: git subtree daemon. Mirrors subdirectories of some repositories |
| 39 into independent repos so they can be consumed by downstream projects. | 39 into independent repos so they can be consumed by downstream projects. |
| 40 * lkgr_finder / lkgr_tag_pusher: computes last known good revision, based on | 40 * lkgr_finder / lkgr_tag_pusher: computes last known good revision, based on |
| 41 test results. | 41 test results. |
| 42 | 42 |
| 43 appengine/ and appengine_modules/ | 43 appengine/ and appengine_modules/ |
| 44 --------------------------------- | 44 --------------------------------- |
| 45 appengine/ should only contain appengine applications (i.e. directories | 45 ``appengine/`` is meant to contain appengine applications, one per directory |
| 46 containing an app.yaml file), appengine_modules/ should contain python packages | 46 (the testing framework relies on this assumption to list all tests). |
| 47 that can be shared between appengine apps. The correct way to use one of them is | 47 To be consistent with appengine principles, each of these directories must |
| 48 to symlink the directory inside the application directory. | 48 contain everything it needs to work. Code shared between several applications |
| 49 should live in ``appengine_modules/`` and be symlinked into each application |
| 50 directory that need it. |
| 49 | 51 |
| 50 Example: the `myapp` application should live in `appengine/myapp`. To use | 52 Example: the `myapp` application should live in `appengine/myapp`. To use |
| 51 `appengine_module/testing_utils`, create a symlink to it in | 53 `appengine_module/testing_utils`, create a symlink to it in |
| 52 `appengine/myapp/testing_utils`. The name should remain the same as Python | 54 `appengine/myapp/testing_utils`. The name should remain the same as Python |
| 53 relies on directory names for its import system. | 55 relies on directory names for its import system. |
| 54 | 56 |
| 57 For more details, see :doc:`appengine` |
| OLD | NEW |