lib-detect-testenv 3.0.5__tar.gz → 3.0.7__tar.gz

{lib_detect_testenv-3.0.5 → lib_detect_testenv-3.0.7}/CHANGELOG.md

@@ -7,6 +7,42 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.0.7] 2026-10-29 00:44:33
+
+### Fixed
+
+- `is_pytest_active()` and `is_testenv_active()` called without an `arg_string` return `True`
+  inside a pytest-xdist worker. A worker runs as `python -c`, so its `sys.argv` names neither
+  pytest nor a test file and both returned `False` there; they now also check the
+  `PYTEST_XDIST_WORKER` variable xdist sets in every worker. A call given an `arg_string` is still
+  judged on that string alone.
+
+### Tests
+
+- The suite runs in parallel: `pytest-xdist` joins the dev extra and the `workers = 1` setting that
+  kept `make test` serial is gone.
+
+## [3.0.6] 2026-10-15 16:35:25
+
+### Fixed
+
+- The source distribution ships only the package, its tests, its docs, `README.md`, `LICENSE`,
+  `CHANGELOG.md` and `pyproject.toml` (an include list). Earlier sdists also carried every other
+  root file and, in a local build, anything hidden only through `.git/info/exclude` or a nested
+  `.gitignore`. `tests/test_packaging.py` builds the sdist and wheel and checks both; `hatchling`
+  joins the dev extra for it.
+
+### Changed
+
+- Ruff selects `C90` (mccabe), so a function over cyclomatic complexity 10, the house hard limit,
+  now fails `make test`; before, nothing enforced it.
+
+### Tests
+
+- The `os_windows`, `os_macos`, `os_linux` and `os_posix` markers now skip a test off its platform
+  (`pytest_runtest_setup` in `tests/conftest.py`); registered in `pyproject.toml` alone they skipped
+  nothing, so a test trusting its marker ran everywhere. `tests/test_platform_markers.py` pins it.
+
 ## [3.0.5] 2026-10-15 14:11:33
 
 ### Added

{lib_detect_testenv-3.0.5 → lib_detect_testenv-3.0.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lib_detect_testenv
-Version: 3.0.5
+Version: 3.0.7
 Summary: Detect test environment - pytest, doctest, unittest, or regular execution
 Project-URL: Homepage, https://github.com/bitranox/lib_detect_testenv
 Project-URL: Repository, https://github.com/bitranox/lib_detect_testenv.git
@@ -27,17 +27,20 @@ Provides-Extra: dev
 Requires-Dist: bandit<1.9,>=1.8.6; (python_version < '3.10') and extra == 'dev'
 Requires-Dist: bandit>=1.9.4; (python_version >= '3.10') and extra == 'dev'
 Requires-Dist: build>=1.6.1; extra == 'dev'
+Requires-Dist: certifi>=2026.10.23; extra == 'dev'
 Requires-Dist: click>=8.5.0; extra == 'dev'
+Requires-Dist: hatchling>=1.32.4; extra == 'dev'
 Requires-Dist: import-linter<2.6,>=2.5.2; (python_version < '3.10') and extra == 'dev'
 Requires-Dist: import-linter>=2.15; (python_version >= '3.10') and extra == 'dev'
 Requires-Dist: pip-audit>=2.10.1; extra == 'dev'
 Requires-Dist: pyright[nodejs]>=1.1.414; extra == 'dev'
 Requires-Dist: pytest-cov>=7.1.0; extra == 'dev'
+Requires-Dist: pytest-xdist>=3.8.0; extra == 'dev'
 Requires-Dist: pytest<9,>=8.4.2; (python_version < '3.10') and extra == 'dev'
-Requires-Dist: pytest>=9.1.1; (python_version >= '3.10') and extra == 'dev'
+Requires-Dist: pytest>=9.2.0; (python_version >= '3.10') and extra == 'dev'
 Requires-Dist: rtoml>=0.14.0; extra == 'dev'
-Requires-Dist: ruff>=0.17.0; extra == 'dev'
-Requires-Dist: setuptools>=84.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.17.3; extra == 'dev'
+Requires-Dist: setuptools>=84.2.1; extra == 'dev'
 Requires-Dist: textual>=8.2.8; extra == 'dev'
 Requires-Dist: twine>=7.0.0; extra == 'dev'
 Description-Content-Type: text/markdown
@@ -253,7 +256,9 @@ else:
 Returns `True` if any test environment is detected (pytest, doctest, or setup.py test).
 
 **Parameters:**
-- `arg_string` (optional): If `None`, uses `str(sys.argv())`
+- `arg_string` (optional): If `None`, uses `str(sys.argv())`, and a pytest-xdist worker
+  (`PYTEST_XDIST_WORKER` set) counts as pytest: its `sys.argv` does not name pytest. A given
+  `arg_string` is judged on its own.
 
 **Returns:**
 - `True` if test environment is detected
@@ -296,7 +301,9 @@ assert is_doctest_active(arg_string="doctest.py") == True
 Returns `True` if pytest is detected.
 
 **Parameters:**
-- `arg_string` (optional): If `None`, uses `str(sys.argv())`
+- `arg_string` (optional): If `None`, uses `str(sys.argv())`, and a pytest-xdist worker
+  (`PYTEST_XDIST_WORKER` set) counts as pytest: its `sys.argv` does not name pytest. A given
+  `arg_string` is judged on its own.
 
 **Returns:**
 - `True` if pytest is detected

{lib_detect_testenv-3.0.5 → lib_detect_testenv-3.0.7}/README.md

@@ -209,7 +209,9 @@ else:
 Returns `True` if any test environment is detected (pytest, doctest, or setup.py test).
 
 **Parameters:**
-- `arg_string` (optional): If `None`, uses `str(sys.argv())`
+- `arg_string` (optional): If `None`, uses `str(sys.argv())`, and a pytest-xdist worker
+  (`PYTEST_XDIST_WORKER` set) counts as pytest: its `sys.argv` does not name pytest. A given
+  `arg_string` is judged on its own.
 
 **Returns:**
 - `True` if test environment is detected
@@ -252,7 +254,9 @@ assert is_doctest_active(arg_string="doctest.py") == True
 Returns `True` if pytest is detected.
 
 **Parameters:**
-- `arg_string` (optional): If `None`, uses `str(sys.argv())`
+- `arg_string` (optional): If `None`, uses `str(sys.argv())`, and a pytest-xdist worker
+  (`PYTEST_XDIST_WORKER` set) counts as pytest: its `sys.argv` does not name pytest. A given
+  `arg_string` is judged on its own.
 
 **Returns:**
 - `True` if pytest is detected

{lib_detect_testenv-3.0.5 → lib_detect_testenv-3.0.7}/docs/systemdesign/module_reference.md

@@ -77,11 +77,12 @@ Behaviors Layer (behaviors.py)           ← Demo commands only
 **Purpose:** Detect if any test environment is active (pytest, doctest, or setup.py test).
 
 **Input:**
-- `arg_string` (optional): Custom argument string to check. If None, uses `str(sys.argv)`.
+- `arg_string` (optional): Custom argument string to check. If None, uses `str(sys.argv)`, and a
+  pytest-xdist worker (`PYTEST_XDIST_WORKER` set) counts as pytest.
 
 **Output:** `True` if test environment detected, `False` otherwise.
 
-**Location:** src/lib_detect_testenv/lib_detect_testenv.py:9
+**Location:** src/lib_detect_testenv/lib_detect_testenv.py:10
 
 **Example:**
 ```python
@@ -102,12 +103,14 @@ if is_testenv_active():
 - Checks for `/pytest/__main__.py` in arguments
 - Checks for `python -m pytest` pattern
 - Checks `PYTEST_IS_RUNNING` environment variable
+- Without an `arg_string`, also checks `PYTEST_XDIST_WORKER`: a pytest-xdist worker runs as
+  `python -c`, so its `sys.argv` does not name pytest
 
 **Input:** `arg_string` (optional): Custom argument string to check.
 
 **Output:** `True` if pytest detected, `False` otherwise.
 
-**Location:** src/lib_detect_testenv/lib_detect_testenv.py:68
+**Location:** src/lib_detect_testenv/lib_detect_testenv.py:70
 
 **Example:**
 ```python
@@ -132,7 +135,7 @@ if is_pytest_active():
 
 **Output:** `True` if doctest detected, `False` otherwise.
 
-**Location:** src/lib_detect_testenv/lib_detect_testenv.py:38
+**Location:** src/lib_detect_testenv/lib_detect_testenv.py:42
 
 ---
 
@@ -147,7 +150,7 @@ if is_pytest_active():
 
 **Output:** `True` if setup.py detected, `False` otherwise.
 
-**Location:** src/lib_detect_testenv/lib_detect_testenv.py:105
+**Location:** src/lib_detect_testenv/lib_detect_testenv.py:108
 
 ---
 
@@ -162,7 +165,7 @@ if is_pytest_active():
 
 **Output:** `True` if `setup.py test` detected, `False` otherwise.
 
-**Location:** src/lib_detect_testenv/lib_detect_testenv.py:132
+**Location:** src/lib_detect_testenv/lib_detect_testenv.py:135
 
 ---
 
@@ -174,7 +177,7 @@ if is_pytest_active():
 
 **Output:** `True` if docrunner.py found, `False` otherwise.
 
-**Location:** src/lib_detect_testenv/lib_detect_testenv.py:164
+**Location:** src/lib_detect_testenv/lib_detect_testenv.py:167
 
 ---
 
@@ -193,7 +196,7 @@ if is_pytest_active():
 
 **Output:** None (modifies sys.path in place)
 
-**Location:** src/lib_detect_testenv/lib_detect_testenv.py:188
+**Location:** src/lib_detect_testenv/lib_detect_testenv.py:198
 
 **Example:**
 ```python

{lib_detect_testenv-3.0.5 → lib_detect_testenv-3.0.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "lib_detect_testenv"
-version = "3.0.5"
+version = "3.0.7"
 description = "Detect test environment - pytest, doctest, unittest, or regular execution"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -33,13 +33,15 @@ Issues = "https://github.com/bitranox/lib_detect_testenv/issues"
 [project.optional-dependencies]
 dev = [
   "pytest>=8.4.2,<9; python_version<'3.10'",
-  "pytest>=9.1.1; python_version>='3.10'",
+  "pytest>=9.2.0; python_version>='3.10'",
   "pytest-cov>=7.1.0",
-  "ruff>=0.17.0",
+  "pytest-xdist>=3.8.0",
+  "ruff>=0.17.3",
   "pyright[nodejs]>=1.1.414",
   "bandit>=1.8.6,<1.9; python_version<'3.10'",
   "bandit>=1.9.4; python_version>='3.10'",
   "build>=1.6.1",
+  "hatchling>=1.32.4",
   "twine>=7.0.0",
   # codecov-cli is disabled, not dropped: it requires click<8.3.0, which drags click back to
   # 8.2.1 - the version with CVE-2026-7246 (command injection in click.edit(), fixed in 8.3.3).
@@ -54,8 +56,9 @@ dev = [
   "textual>=8.2.8",
   "import-linter>=2.5.2,<2.6; python_version<'3.10'",
   "import-linter>=2.15; python_version>='3.10'",
-  "setuptools>=84.0.0",
+  "setuptools>=84.2.1",
   "rtoml>=0.14.0",
+  "certifi>=2026.10.23",         # PYSEC-2026-4320
 ]
 
 [project.scripts]
@@ -71,6 +74,21 @@ build-backend = "hatchling.build"
 packages = ["src/lib_detect_testenv"]
 include = ["src/lib_detect_testenv/py.typed"]
 
+# An allowlist, never a denylist: hatchling reads only the root .gitignore, so tracked working
+# files and files hidden through .git/info/exclude or a nested .gitignore (session records,
+# review notes, helper scripts) would ship. tests/test_packaging.py builds the sdist and
+# refuses any other top-level entry.
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src/lib_detect_testenv",
+    "/tests/*.py",
+    "/docs",
+    "/README.md",
+    "/LICENSE",
+    "/CHANGELOG.md",
+    "/pyproject.toml",
+]
+
 [tool.ruff]
 line-length = 160
 target-version = "py39"
@@ -85,6 +103,7 @@ select = [
   "B",           # bugbear
   "A",           # builtins shadowing
   "C4",          # comprehension simplification
+  "C90",         # mccabe: cyclomatic complexity <= 10 (the house hard limit)
   "SIM",         # simplification
   "TCH",         # type-checking imports
   "RUF",         # ruff-specific
@@ -105,7 +124,10 @@ convention = "google"
 
 [tool.ruff.lint.per-file-ignores]
 # ignore the "unused import sys" in the jupyter notebook - which we need (it is a linter hickup)
-"notebooks/*.ipynb" = ["F401"]
+# A `!cmd` never raises, so CI sees a failing shell command only through
+# `assert _exit_code == N` after it: IPython injects `_exit_code` at run time (F821)
+# and those asserts are the gate (S101).
+"notebooks/*.ipynb" = ["F401", "F821", "S101"]
 # Tests: assert is standard, test fixtures have passwords, magic values are clearer inline, temp paths are fine.
 # PLC0415: local/deferred imports are a deliberate test idiom - several tests import inside the test
 # body to exercise import-time and cache behaviour, so moving them to module top would defeat intent.

{lib_detect_testenv-3.0.5 → lib_detect_testenv-3.0.7}/src/lib_detect_testenv/__init__conf__.py

@@ -26,7 +26,7 @@ name = "lib_detect_testenv"
 #: Human-readable summary shown in CLI help output.
 title = "Detect test environment - pytest, doctest, unittest, or regular execution"
 #: Current release version pulled from ``pyproject.toml`` by automation.
-version = "3.0.5"
+version = "3.0.7"
 #: Repository homepage presented to users.
 homepage = "https://github.com/bitranox/lib_detect_testenv"
 #: Author attribution surfaced in CLI output.

{lib_detect_testenv-3.0.5 → lib_detect_testenv-3.0.7}/src/lib_detect_testenv/lib_detect_testenv.py

@@ -14,7 +14,8 @@ def is_testenv_active(arg_string: Optional[str] = None) -> bool:
 
     Parameter
     ----------
-    arg_string  : optional, if None : str(sys.argv())
+    arg_string  : optional, if None : str(sys.argv()), and a pytest-xdist worker
+                  (PYTEST_XDIST_WORKER set) counts as pytest
 
 
     Result
@@ -32,6 +33,8 @@ def is_testenv_active(arg_string: Optional[str] = None) -> bool:
 
     >>> assert is_testenv_active() == True
     """
+    if arg_string is None and _is_pytest_xdist_worker():
+        return True
     arg_string = _get_sys_argv_str(arg_string)
     return is_doctest_active(arg_string=arg_string) or is_pytest_active(arg_string=arg_string) or is_setup_test_active(arg_string=arg_string)
 
@@ -71,7 +74,8 @@ def is_pytest_active(arg_string: Optional[str] = None) -> bool:
 
     Parameter
     ----------
-    arg_string  : optional, if None : str(sys.argv())
+    arg_string  : optional, if None : str(sys.argv()), and a pytest-xdist worker
+                  (PYTEST_XDIST_WORKER set) counts as pytest
 
 
     Result
@@ -88,6 +92,8 @@ def is_pytest_active(arg_string: Optional[str] = None) -> bool:
 
     """
 
+    if arg_string is None and _is_pytest_xdist_worker():
+        return True
     arg_string = _get_sys_argv_str(arg_string)
     # this is used in our tests when we test cli-commands
     if os.getenv("PYTEST_IS_RUNNING"):
@@ -167,6 +173,17 @@ def is_doctest_in_arg_string(arg_string: str) -> bool:
     return "docrunner.py" in arg_string
 
 
+def _is_pytest_xdist_worker() -> bool:
+    """
+    returns True inside a pytest-xdist worker process
+
+    A worker is started by execnet as "python -c <bootstrap>", so its sys.argv names neither
+    pytest nor a test file; pytest-xdist sets PYTEST_XDIST_WORKER (gw0, gw1, ...) in every worker.
+    Only a call that reads the real process asks this: an explicit arg_string is judged alone.
+    """
+    return bool(os.getenv("PYTEST_XDIST_WORKER"))
+
+
 def _get_sys_argv_str(arg_string: Optional[str] = None) -> str:
     """
     gets the sys.argv as string. backslashes in Windows are replaced with slashes

{lib_detect_testenv-3.0.5 → lib_detect_testenv-3.0.7}/tests/conftest.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import re
+import sys
 from typing import TYPE_CHECKING
 
 import pytest
@@ -48,3 +49,20 @@ def strip_ansi() -> Callable[[str], str]:
         return _remove_ansi_codes(value)
 
     return _strip
+
+
+#: Which platforms each ``os_*`` marker lets a test run on. Registering a marker in pyproject only
+#: silences pytest's unknown-marker warning; without this table a marked test runs everywhere.
+_PLATFORM_MARKERS: dict[str, Callable[[str], bool]] = {
+    "os_windows": lambda platform: platform == "win32",
+    "os_macos": lambda platform: platform == "darwin",
+    "os_linux": lambda platform: platform.startswith("linux"),
+    "os_posix": lambda platform: platform != "win32",
+}
+
+
+def pytest_runtest_setup(item: pytest.Item) -> None:
+    """Skip a test whose ``os_*`` marker names a platform other than the running one."""
+    for name, runs_on in _PLATFORM_MARKERS.items():
+        if item.get_closest_marker(name) is not None and not runs_on(sys.platform):
+            pytest.skip(f"marked {name}; this is {sys.platform}")

{lib_detect_testenv-3.0.5 → lib_detect_testenv-3.0.7}/tests/test_lib_detect_testenv.py

@@ -113,6 +113,45 @@ def test_is_pytest_active_with_pytest_env_var(monkeypatch: pytest.MonkeyPatch) -
     assert is_pytest_active(arg_string="") is True
 
 
+#: The argv a pytest-xdist worker process runs with: execnet starts it as ``python -c <bootstrap>``.
+_XDIST_WORKER_ARGV = ["-c"]
+
+
+@pytest.fixture
+def worker_process_argv(monkeypatch: pytest.MonkeyPatch) -> pytest.MonkeyPatch:
+    """Make the process look like an xdist worker's argv, with neither pytest variable set."""
+    monkeypatch.setattr(sys, "argv", _XDIST_WORKER_ARGV)
+    monkeypatch.delenv("PYTEST_IS_RUNNING", raising=False)
+    monkeypatch.delenv("PYTEST_XDIST_WORKER", raising=False)
+    return monkeypatch
+
+
+@pytest.mark.os_agnostic
+def test_a_worker_argv_alone_does_not_read_as_pytest(worker_process_argv: pytest.MonkeyPatch) -> None:
+    """The control: with the argv replaced and no xdist variable, nothing names pytest."""
+    assert is_pytest_active() is False
+    assert is_testenv_active() is False
+
+
+@pytest.mark.os_agnostic
+def test_an_xdist_worker_reads_as_pytest(worker_process_argv: pytest.MonkeyPatch) -> None:
+    """A pytest-xdist worker's argv does not name pytest; xdist sets PYTEST_XDIST_WORKER in it."""
+    worker_process_argv.setenv("PYTEST_XDIST_WORKER", "gw0")
+
+    assert is_pytest_active() is True
+    assert is_testenv_active() is True
+
+
+@pytest.mark.os_agnostic
+def test_an_explicit_arg_string_ignores_the_xdist_worker_variable(worker_process_argv: pytest.MonkeyPatch) -> None:
+    """Only a call reading the real process consults the worker variable; a given string is judged alone."""
+    worker_process_argv.setenv("PYTEST_XDIST_WORKER", "gw0")
+
+    assert is_pytest_active(arg_string="") is False
+    assert is_pytest_active(arg_string="python test.py") is False
+    assert is_testenv_active(arg_string="python script.py") is False
+
+
 # ============================================================================
 # Tests for is_doctest_active()
 # ============================================================================

lib_detect_testenv-3.0.7/tests/test_packaging.py

@@ -0,0 +1,127 @@
+"""The source distribution carries the package, its tests and its docs, and nothing else.
+
+A working tree holds files that must never be published: session records, backlogs, scratch
+review notes and helper scripts. Some are tracked, some are hidden only through
+``.git/info/exclude`` or a nested ``.gitignore``, which hatchling does not read. The sdist is
+therefore built from an allowlist, and this test builds one from a copy of the tree that also
+holds such decoys. The wheel must still carry the package data the runtime loads.
+"""
+
+from __future__ import annotations
+
+import shutil
+import tarfile
+import zipfile
+from pathlib import Path
+
+import pytest
+from hatchling.builders.sdist import SdistBuilder
+from hatchling.builders.wheel import WheelBuilder
+
+PROJECT_ROOT = Path(__file__).resolve().parent.parent
+PACKAGE = "lib_detect_testenv"
+
+# hatchling force-includes the root .gitignore into every sdist (so a build from the unpacked
+# sdist applies the same exclusions); no include/exclude setting removes it.
+ALLOWED_TOP_LEVEL = frozenset(
+    {
+        "PKG-INFO",
+        "pyproject.toml",
+        "README.md",
+        "LICENSE",
+        "CHANGELOG.md",
+        ".gitignore",
+        "src",
+        "tests",
+        "docs",
+    }
+)
+REQUIRED_TOP_LEVEL = frozenset({"PKG-INFO", "pyproject.toml", "src", "tests"})
+
+# Files and directories that exist in working trees and must never ship. Tracked ones are
+# named in the repository; the others are hidden locally through .git/info/exclude.
+DECOY_FILES = ("handover.md", "OPEN-WORK.md", "EXECUTION-USER-REVIEW.md", "reset_git_history.sh", ".private/notes.txt")
+
+REQUIRED_WHEEL_DATA = ("lib_detect_testenv/py.typed",)
+
+
+def _copy_tree_with_decoys(destination: Path) -> Path:
+    """Copy the buildable tree and plant the files a working tree carries but must not ship."""
+    root = destination / "tree"
+    root.mkdir()
+    for name in ("pyproject.toml", "README.md", "LICENSE", "CHANGELOG.md", ".gitignore"):
+        shutil.copy2(PROJECT_ROOT / name, root / name)
+    for name in ("src", "docs", "tests"):
+        shutil.copytree(PROJECT_ROOT / name, root / name, ignore=shutil.ignore_patterns("__pycache__", "*.pyc"))
+    for decoy in DECOY_FILES:
+        path = root / decoy
+        path.parent.mkdir(parents=True, exist_ok=True)
+        path.write_text("decoy\n", encoding="utf-8")
+    return root
+
+
+def _build_sdist(root: Path, directory: Path) -> Path:
+    built = list(SdistBuilder(str(root)).build(directory=str(directory), versions=["standard"]))
+    assert len(built) == 1, f"expected one sdist, got {built}"
+    return Path(built[0])
+
+
+def _strip_root(names: list[str]) -> list[str]:
+    """Drop the ``<name>-<version>/`` prefix every member carries."""
+    return [name.split("/", 1)[1] for name in names if "/" in name]
+
+
+@pytest.fixture(scope="module")
+def built_tree(tmp_path_factory: pytest.TempPathFactory) -> Path:
+    return _copy_tree_with_decoys(tmp_path_factory.mktemp("packaging"))
+
+
+@pytest.fixture(scope="module")
+def sdist_members(built_tree: Path, tmp_path_factory: pytest.TempPathFactory) -> list[str]:
+    sdist = _build_sdist(built_tree, tmp_path_factory.mktemp("sdist"))
+    with tarfile.open(sdist, "r:gz") as archive:
+        members = _strip_root(archive.getnames())
+    assert members, "the sdist is empty, so nothing below would be judged"
+    return members
+
+
+@pytest.fixture(scope="module")
+def wheel_members(built_tree: Path, tmp_path_factory: pytest.TempPathFactory) -> list[str]:
+    built = list(WheelBuilder(str(built_tree)).build(directory=str(tmp_path_factory.mktemp("wheel")), versions=["standard"]))
+    assert len(built) == 1, f"expected one wheel, got {built}"
+    with zipfile.ZipFile(built[0]) as archive:
+        members = archive.namelist()
+    assert members, "the wheel is empty, so nothing below would be judged"
+    return members
+
+
+@pytest.mark.os_agnostic
+def test_the_sdist_holds_only_allowlisted_top_level_entries(sdist_members: list[str]) -> None:
+    top_level = {member.split("/", 1)[0] for member in sdist_members}
+
+    unexpected = sorted(top_level - ALLOWED_TOP_LEVEL)
+    missing = sorted(REQUIRED_TOP_LEVEL - top_level)
+
+    assert not unexpected, f"the sdist ships files outside the allowlist: {unexpected}"
+    assert not missing, f"the sdist lacks required entries: {missing}"
+
+
+@pytest.mark.os_agnostic
+def test_the_sdist_ships_only_the_package_under_src(sdist_members: list[str]) -> None:
+    under_src = {member.split("/")[1] for member in sdist_members if member.startswith("src/") and member.count("/") >= 1}
+
+    assert under_src == {PACKAGE}
+
+
+@pytest.mark.os_agnostic
+def test_the_sdist_carries_no_compiled_bytecode(sdist_members: list[str]) -> None:
+    compiled = [member for member in sdist_members if "__pycache__" in member or member.endswith(".pyc")]
+
+    assert not compiled, f"the sdist ships bytecode: {compiled[:5]}"
+
+
+@pytest.mark.os_agnostic
+def test_the_wheel_carries_the_package_data_the_runtime_loads(wheel_members: list[str]) -> None:
+    missing = [name for name in REQUIRED_WHEEL_DATA if name not in wheel_members]
+
+    assert not missing, f"the wheel lacks package data: {missing}"

lib_detect_testenv-3.0.7/tests/test_platform_markers.py

@@ -0,0 +1,31 @@
+"""The ``os_*`` markers skip a test off its platform; registering them alone would skip nothing.
+
+Each test asserts the platform its own marker names, so it fails wherever conftest lets it run by
+mistake, and passes where the marker lets it run.
+"""
+
+from __future__ import annotations
+
+import sys
+
+import pytest
+
+
+@pytest.mark.os_windows
+def test_an_os_windows_test_runs_only_on_windows() -> None:
+    assert sys.platform == "win32"
+
+
+@pytest.mark.os_macos
+def test_an_os_macos_test_runs_only_on_macos() -> None:
+    assert sys.platform == "darwin"
+
+
+@pytest.mark.os_linux
+def test_an_os_linux_test_runs_only_on_linux() -> None:
+    assert sys.platform.startswith("linux")
+
+
+@pytest.mark.os_posix
+def test_an_os_posix_test_never_runs_on_windows() -> None:
+    assert sys.platform != "win32"

lib_detect_testenv-3.0.5/.devcontainer/devcontainer.json

@@ -1,22 +0,0 @@
-{
-  "image": "mcr.microsoft.com/devcontainers/python:3.13",
-
-  "postCreateCommand": "bash -lc '\nPY=/usr/local/bin/python;\n$PY -m pip install -U pip && \\\n$PY -m pip install ipykernel && \\\n$PY -m pip install -e . && \\\n# register kernel using this exact interpreter\n$PY -m ipykernel install --name=python3 --display-name=\"Python 3 (3.13)\" --user && \\\n# patch the notebook to point to the python3 kernelspec (VS Code will bind to /usr/local/bin/python)\n$PY - <<\"PY\"\nimport json, pathlib\np = pathlib.Path(\"notebooks/Quickstart.ipynb\")\nif p.exists():\n    nb = json.loads(p.read_text(encoding=\"utf-8\"))\n    md = nb.setdefault(\"metadata\", {})\n    md[\"kernelspec\"] = {\n        \"name\": \"python3\",\n        \"display_name\": \"Python 3 (3.13)\",\n        \"language\": \"python\"\n    }\n    md[\"language_info\"] = {\"name\": \"python\"}\n    p.write_text(json.dumps(nb, ensure_ascii=False, indent=1), encoding=\"utf-8\")\n    print(\"Pinned kernelspec to python3 in\", p)\nelse:\n    print(\"Notebook not found:\", p)\nPY'\n",
-
-  "customizations": {
-    "vscode": {
-      "extensions": ["ms-toolsai.jupyter", "ms-python.python"],
-      "settings": {
-        "workbench.startupEditor": "none",
-        "jupyter.alwaysTrustNotebooks": true,
-        "jupyter.kernelPickerType": "OnlyRecommended",
-        "python.defaultInterpreterPath": "/usr/local/bin/python"
-      }
-    },
-    "codespaces": {
-      "openFiles": ["README.md"]
-    }
-  },
-
-  "postAttachCommand": "bash -lc 'if [ -f notebooks/Quickstart.ipynb ]; then code -r notebooks/Quickstart.ipynb; fi'"
-}

lib_detect_testenv-3.0.5/.devcontainer/settings.json

@@ -1,6 +0,0 @@
-{
-  "python.defaultInterpreterPath": "/usr/local/bin/python3.13",
-  "jupyter.alwaysTrustNotebooks": true,
-  "jupyter.kernelPickerType": "OnlyRecommended",
-  "jupyter.askForKernelRestart": false
-}

lib_detect_testenv-3.0.5/.env.example

@@ -1,11 +0,0 @@
-# Copy to .env and fill values as needed.
-
-# Codecov upload token (required for private repos; optional for public repos)
-CODECOV_TOKEN=
-
-# PyPI API token for release workflow (.github/workflows/release.yml)
-# Format: pypi-AgENdGVzdC5weXBpLm9yZwIk...
-PYPI_API_TOKEN=
-
-# Optional: GitHub token for API-limited tasks
-GITHUB_TOKEN=