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

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

@@ -7,6 +7,21 @@ 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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lib_detect_testenv
-Version: 3.0.6
+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,6 +27,7 @@ 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'
@@ -34,11 +35,12 @@ 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
@@ -254,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
@@ -297,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.6 → 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.6 → 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.6 → lib_detect_testenv-3.0.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "lib_detect_testenv"
-version = "3.0.6"
+version = "3.0.7"
 description = "Detect test environment - pytest, doctest, unittest, or regular execution"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -33,9 +33,10 @@ 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'",
@@ -55,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]
@@ -122,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.6 → 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.6"
+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.6 → 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.6 → 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()
 # ============================================================================