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 |