tests: implement pytest_test rule for internal test usage (#3931)

This implements a pytest_test rule based upon the pytest_bazel library.

The core implementation of this is fairly simple: a file is generated
that calls
`pytest.main()` with the `srcs` to test. This generated file is the file
that is
run by `py_test`.

For now, this is kept under tests/support soas to use it for our own
tests
while some design decisions are figured out.

Work towards #3594

Author: rickeylev

.bazelversion

@@ -1 +1 @@
-9.x
+9.1.1

AGENTS.md

@@ -121,7 +121,6 @@ The `repository_ctx` API docs are at: https://bazel.build/rules/lib/builtins/rep
     e.g. given `load("//foo:bar.bzl", ...)`, the target is `//foo:bar_bzl`.
   * For files outside rules_python: remove the `.bzl` suffix. e.g. given
     `load("@foo//foo:bar.bzl", ...)`, the target is `@foo//foo:bar`.
-* `bzl_library()` targets should be kept in alphabetical order by name.
 
 Example:
 

BUILD.bazel

@@ -38,6 +38,7 @@ load("@bazel_skylib//:bzl_library.bzl", "bzl_library")
 # Exclude directories that are separate packages/workspaces or only for testing/examples
 # gazelle:exclude tests
 # gazelle:exclude examples
+# gazelle:exclude gazelle
 
 # Exclude internal development tools and dependencies that users don't need
 # gazelle:exclude internal_dev_setup.bzl

MODULE.bazel

@@ -214,7 +214,7 @@ dev_pip.parse(
     python_version = "3.11",
     requirements_lock = "//tests/multi_pypi/beta:requirements.txt",
 )
-use_repo(dev_pip, "dev_pip", "pypi_alpha", "pypi_beta", "pypiserver")
+use_repo(dev_pip, "dev_pip", "pypi", "pypi_alpha", "pypi_beta", "pypiserver")
 
 # Bazel integration test setup below
 

docs/BUILD.bazel

@@ -198,6 +198,7 @@ sphinx_build_binary(
     target_compatible_with = _TARGET_COMPATIBLE_WITH,
     deps = [
         "@dev_pip//myst_parser",
+        "@dev_pip//pytest",
         "@dev_pip//readthedocs_sphinx_ext",
         "@dev_pip//sphinx",
         "@dev_pip//sphinx_autodoc2",

docs/pyproject.toml

@@ -17,4 +17,6 @@ dependencies = [
     "pyelftools",
     "macholib",
     "markupsafe",
+    "pytest",
+    "pytest-bazel",
 ]

docs/requirements.txt

@@ -0,0 +1,22 @@
+load("//tests/support:support.bzl", "SUPPORTS_BZLMOD")
+load("//tests/support/pytest_test:pytest_test.bzl", "pytest_test")
+
+pytest_test(
+    name = "pytest_script_venv_test",
+    srcs = [
+        "basic_test.py",
+    ],
+    config_settings = {
+        "@rules_python//python/config_settings:bootstrap_impl": "script",
+        "@rules_python//python/config_settings:venvs_site_packages": "yes",
+    },
+    target_compatible_with = SUPPORTS_BZLMOD,
+)
+
+pytest_test(
+    name = "pytest_default_test",
+    srcs = [
+        "basic_test.py",
+    ],
+    target_compatible_with = SUPPORTS_BZLMOD,
+)

docs/uv.lock

@@ -0,0 +1,2 @@
+def test_foo():
+    assert True