xref: /aosp_15_r20/external/bazelbuild-rules_python/tests/integration/README.md (revision 60517a1edbc8ecf509223e9af94a7adec7d736b8)
1# Bazel-in-Bazel integration tests
2
3The tests in this directory are Bazel-in-Bazel integration tests. These are
4necessary because our CI has a limit of 80 jobs, and our test matrix uses most
5of those for more important end-to-end tests of user-facing examples.
6
7The tests in here are more for testing internal aspects of the rules that aren't
8easily tested as tests run by Bazel itself (basically anything that happens
9prior to the analysis phase).
10
11## Adding a new directory
12
13When adding a new diretory, a couple files need to be updated to tell the outer
14Bazel to ignore the nested workspace.
15
16* Add the directory to the `--deleted_packages` flag. Run `pre-commit` and it
17  will do this for you. This also allows the integration test to see the
18  nested workspace files correctly.
19* Update `.bazelignore` and add `tests/integration/<directory>/bazel-<name>`.
20  This prevents Bazel from following infinite symlinks and freezing.
21* Add a `rules_python_integration_test` target to the BUILD file.
22