pytest-threadpool 0.2.0__tar.gz → 0.3.3__tar.gz

{pytest_threadpool-0.2.0 → pytest_threadpool-0.3.3}/.github/workflows/ci.yml

@@ -5,12 +5,15 @@ on:
     branches: [main]
   pull_request:
     branches: [main]
+  workflow_call:
 
 jobs:
   lint:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
       - uses: astral-sh/setup-uv@v6
       - run: uv sync --python 3.14t --group dev
       - run: uv run ruff format --check src/ tests/
@@ -25,6 +28,8 @@ jobs:
         python: ["3.13t", "3.14t", "3.15t"]
     steps:
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
       - uses: astral-sh/setup-uv@v6
       - run: uv python install ${{ matrix.python }}
       - run: uv sync --python ${{ matrix.python }} --group dev

pytest_threadpool-0.3.3/.github/workflows/publish.yml

@@ -0,0 +1,25 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  ci:
+    uses: ./.github/workflows/ci.yml
+    secrets: inherit
+
+  publish:
+    needs: ci
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@v6
+      - run: uv build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

{pytest_threadpool-0.2.0 → pytest_threadpool-0.3.3}/.gitignore

@@ -163,3 +163,6 @@ cython_debug/
 .idea/
 uv.lock
 
+# hatch-vcs generated version file
+src/pytest_threadpool/_version.py
+

{pytest_threadpool-0.2.0 → pytest_threadpool-0.3.3}/CONTRIBUTING.md

@@ -40,10 +40,13 @@ Any mutable state needed across tests or across a test run must be held as
 class attributes or instance attributes — never as module-level variables.
 
 ```python
+import threading
+
 # Good
 class TestState:
-    log = {}
-    barrier = threading.Barrier(3, timeout=10)
+  log = {}
+  barrier = threading.Barrier(3, timeout=10)
+
 
 # Bad
 _log = {}
@@ -67,9 +70,11 @@ subprocess with the exact thread count needed. Use explicit thread counts for
 barrier-based tests (not `auto`) to avoid deadlocks on low-core machines.
 
 ```python
+import threading
+
 # Good — isolated subprocess via ftdir, explicit thread count
 def test_children_run_concurrently(self, ftdir):
-    ftdir.makepyfile("""
+  ftdir.makepyfile("""
         import threading, pytest
         @pytest.mark.parallelizable("children")
         class TestBarrier:
@@ -77,16 +82,25 @@ def test_children_run_concurrently(self, ftdir):
             def test_a(self): self.barrier.wait()
             def test_b(self): self.barrier.wait()
     """)
-    result = ftdir.run_pytest("--threadpool", "2")
-    result.assert_outcomes(passed=2)
+  result = ftdir.run_pytest("--threadpool", "2")
+  result.assert_outcomes(passed=2)
+
 
 # Bad — depends on outer runner flags
 class TestBarrier:
-    barrier = threading.Barrier(2, timeout=10)
-    def test_a(self): self.barrier.wait()
-    def test_b(self): self.barrier.wait()
+  barrier = threading.Barrier(2, timeout=10)
+
+  def test_a(self): self.barrier.wait()
+
+  def test_b(self): self.barrier.wait()
 ```
 
+### Use `pytest.fail()` for intentional failures
+
+In test cases that need to intentionally fail (e.g., verifying teardown after
+failure), use `pytest.fail("reason")` instead of `assert False, "reason"`.
+The latter triggers ruff PT015 and B011.
+
 ### Constants over strings
 
 Use `ParallelScope` enum and `_constants` module instead of bare string
@@ -107,7 +121,7 @@ src/pytest_threadpool/
     _constants.py     # ParallelScope and _GroupPrefix enums
     _markers.py       # MarkerResolver: marker introspection
     _grouping.py      # GroupKeyBuilder: parallel batch grouping
-    _fixtures.py      # FixtureManager: finalizer save/restore
+    _fixtures.py      # FixtureManager: fixture cloning, shared cache population, finalizer save/restore
     _runner.py        # ParallelRunner: parallel execution orchestration
     plugin.py         # pytest hook implementations (wiring only)
 
@@ -128,18 +142,19 @@ Every commit message starts with one or more tags in brackets:
 
 ### Tags
 
-| Tag | Scope |
-|-----|-------|
-| `[Runner]` | Core parallel execution engine (`_runner.py`, `_fixtures.py`) |
-| `[Markers]` | Marker resolution and grouping (`_markers.py`, `_grouping.py`, `_constants.py`) |
-| `[Report]` | Terminal reporting and display (`_LiveReporter`) |
-| `[Plugin]` | Plugin hooks and CLI options (`plugin.py`) |
-| `[API]` | Public API changes (`_api.py`, `__init__.py`) |
-| `[Test]` | Test additions or changes only |
-| `[Tooling]` | Ruff, pyright, pre-commit, CI, scripts |
-| `[Docs]` | README, CONTRIBUTING, docstrings |
-| `[Refactor]` | Internal restructuring, no behavior change |
-| `[Fix]` | Bug fix — must include issue number if fixing a known issue |
+| Tag          | Scope                                                                           |
+|--------------|---------------------------------------------------------------------------------|
+| `[Runner]`   | Core parallel execution engine (`_runner.py`, `_fixtures.py`)                   |
+| `[Markers]`  | Marker resolution and grouping (`_markers.py`, `_grouping.py`, `_constants.py`) |
+| `[Report]`   | Terminal reporting and display (`_LiveReporter`)                                |
+| `[Plugin]`   | Plugin hooks and CLI options (`plugin.py`)                                      |
+| `[API]`      | Public API changes (`_api.py`, `__init__.py`)                                   |
+| `[Test]`     | Test additions or changes only                                                  |
+| `[Build]`    | CI/CD pipelines, publishing, versioning                                         |
+| `[Tooling]`  | Ruff, pyright, pre-commit, scripts                                              |
+| `[Docs]`     | README, CONTRIBUTING, docstrings                                                |
+| `[Refactor]` | Internal restructuring, no behavior change                                      |
+| `[Fix]`      | Bug fix — must include issue number if fixing a known issue                     |
 
 ### Combining tags
 

{pytest_threadpool-0.2.0 → pytest_threadpool-0.3.3}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: pytest-threadpool
-Version: 0.2.0
+Version: 0.3.3
 Summary: Parallel test execution for free-threaded Python builds
 License-Expression: MIT
 License-File: LICENSE
-Keywords: free-threaded,nogil,parallel,pytest,testing,threadpool
+Keywords: free-threaded,nogil,parallel,pytest,pytest parallel,testing,threadpool
 Classifier: Development Status :: 4 - Beta
 Classifier: Framework :: Pytest
 Classifier: Intended Audience :: Developers
@@ -17,8 +17,8 @@ Description-Content-Type: text/markdown
 
 # pytest-threadpool
 
-[![PyPI](https://img.shields.io/pypi/v/pytest-threadpool.svg)](https://pypi.org/project/pytest-threadpool/)
-[![Python](https://img.shields.io/pypi/pyversions/pytest-threadpool.svg)](https://pypi.org/project/pytest-threadpool/)
+[![PyPI - Version](https://img.shields.io/pypi/v/pytest-threadpool)](https://pypi.org/project/pytest-threadpool/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pytest-threadpool)](https://pypi.org/project/pytest-threadpool/)
 [![License](https://img.shields.io/github/license/pytest-threadpool/pytest-threadpool)](https://github.com/pytest-threadpool/pytest-threadpool/blob/main/LICENSE)
 [![GitHub](https://img.shields.io/badge/GitHub-pytest--threadpool-blue?logo=github)](https://github.com/pytest-threadpool/pytest-threadpool)
 [![CI](https://github.com/pytest-threadpool/pytest-threadpool/actions/workflows/ci.yml/badge.svg)](https://github.com/pytest-threadpool/pytest-threadpool/actions/workflows/ci.yml)
@@ -26,8 +26,9 @@ Description-Content-Type: text/markdown
 
 **Status: Beta** · Parallel test execution for free-threaded Python builds (3.13t+).
 
-Runs test *bodies* concurrently in a `ThreadPoolExecutor` while keeping
-fixture setup/teardown sequential (pytest internals are not thread-safe).
+Runs test *bodies*, function-scoped fixture setup, and function-scoped fixture
+teardown concurrently in a thread pool while keeping shared fixtures
+(module/class/session scope) sequential.
 
 ## Installation
 
@@ -75,6 +76,24 @@ def test_must_be_sequential(): ...
 | `parameters` | Parametrized variants of the same test run concurrently           |
 | `all`        | Combines `children` + `parameters`                                |
 
+## Fixture handling
+
+Function-scoped fixtures are cloned per-item and set up in parallel alongside
+test calls. Each worker gets independent fixture instances — no shared mutable
+state between concurrent fixture setups.
+
+Shared fixtures (module, class, and session scope) are resolved once
+sequentially before workers launch and served from cache to all items.
+
+| Scope      | Behavior                                        |
+|------------|-------------------------------------------------|
+| `function` | Cloned per-item, setup and teardown in parallel workers |
+| `class`    | Resolved once, cached, shared across items              |
+| `module`   | Resolved once, cached, shared across items              |
+| `session`  | Resolved once, cached, shared across items              |
+
+Shared fixture teardown runs sequentially after the parallel group completes.
+
 ## Marker levels
 
 Markers can be applied at function, class, module (`pytestmark`), or

{pytest_threadpool-0.2.0 → pytest_threadpool-0.3.3}/README.md

@@ -1,7 +1,7 @@
 # pytest-threadpool
 
-[![PyPI](https://img.shields.io/pypi/v/pytest-threadpool.svg)](https://pypi.org/project/pytest-threadpool/)
-[![Python](https://img.shields.io/pypi/pyversions/pytest-threadpool.svg)](https://pypi.org/project/pytest-threadpool/)
+[![PyPI - Version](https://img.shields.io/pypi/v/pytest-threadpool)](https://pypi.org/project/pytest-threadpool/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pytest-threadpool)](https://pypi.org/project/pytest-threadpool/)
 [![License](https://img.shields.io/github/license/pytest-threadpool/pytest-threadpool)](https://github.com/pytest-threadpool/pytest-threadpool/blob/main/LICENSE)
 [![GitHub](https://img.shields.io/badge/GitHub-pytest--threadpool-blue?logo=github)](https://github.com/pytest-threadpool/pytest-threadpool)
 [![CI](https://github.com/pytest-threadpool/pytest-threadpool/actions/workflows/ci.yml/badge.svg)](https://github.com/pytest-threadpool/pytest-threadpool/actions/workflows/ci.yml)
@@ -9,8 +9,9 @@
 
 **Status: Beta** · Parallel test execution for free-threaded Python builds (3.13t+).
 
-Runs test *bodies* concurrently in a `ThreadPoolExecutor` while keeping
-fixture setup/teardown sequential (pytest internals are not thread-safe).
+Runs test *bodies*, function-scoped fixture setup, and function-scoped fixture
+teardown concurrently in a thread pool while keeping shared fixtures
+(module/class/session scope) sequential.
 
 ## Installation
 
@@ -58,6 +59,24 @@ def test_must_be_sequential(): ...
 | `parameters` | Parametrized variants of the same test run concurrently           |
 | `all`        | Combines `children` + `parameters`                                |
 
+## Fixture handling
+
+Function-scoped fixtures are cloned per-item and set up in parallel alongside
+test calls. Each worker gets independent fixture instances — no shared mutable
+state between concurrent fixture setups.
+
+Shared fixtures (module, class, and session scope) are resolved once
+sequentially before workers launch and served from cache to all items.
+
+| Scope      | Behavior                                        |
+|------------|-------------------------------------------------|
+| `function` | Cloned per-item, setup and teardown in parallel workers |
+| `class`    | Resolved once, cached, shared across items              |
+| `module`   | Resolved once, cached, shared across items              |
+| `session`  | Resolved once, cached, shared across items              |
+
+Shared fixture teardown runs sequentially after the parallel group completes.
+
 ## Marker levels
 
 Markers can be applied at function, class, module (`pytestmark`), or

{pytest_threadpool-0.2.0 → pytest_threadpool-0.3.3}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "pytest-threadpool"
-version = "0.2.0"
+dynamic = ["version"]
 description = "Parallel test execution for free-threaded Python builds"
 requires-python = ">=3.13"
 license = "MIT"
 readme = "README.md"
-keywords = ["pytest", "parallel", "free-threaded", "nogil", "testing", "threadpool"]
+keywords = ["pytest", "parallel", "free-threaded", "nogil", "testing", "threadpool", "pytest parallel"]
 classifiers = [
     "Framework :: Pytest",
     "Development Status :: 4 - Beta",
@@ -29,24 +29,32 @@ dev = [
 ]
 
 [build-system]
-requires = ["hatchling"]
+requires = ["hatchling", "hatch-vcs"]
 build-backend = "hatchling.build"
 
+[tool.hatch.version]
+source = "vcs"
+
+[tool.hatch.build.hooks.vcs]
+version-file = "src/pytest_threadpool/_version.py"
+
 [tool.hatch.build.targets.wheel]
 packages = ["src/pytest_threadpool"]
 
 [tool.pytest.ini_options]
 addopts = ["--threadpool", "auto"]
+norecursedirs = ["cases"]
 
 [tool.pyright]
 pythonVersion = "3.13"
 include = ["src", "tests"]
 typeCheckingMode = "standard"
 reportPrivateUsage = false
-ignore = ["tests/unit_tests"]
+ignore = ["tests/unit_tests", "src/pytest_threadpool/_version.py"]
 
 [tool.ruff]
 target-version = "py313"
+exclude = ["src/pytest_threadpool/_version.py"]
 src = ["src", "tests"]
 line-length = 99
 

{pytest_threadpool-0.2.0 → pytest_threadpool-0.3.3}/src/pytest_threadpool/_fixtures.py

@@ -1,5 +1,6 @@
 """Fixture finalizer save/restore helpers for parallel execution."""
 
+from _pytest.fixtures import FixtureDef
 from _pytest.scope import Scope
 
 
@@ -12,6 +13,40 @@ class FixtureManager:
     runner.py and fixtures.py use.
     """
 
+    @staticmethod
+    def clone_function_fixturedefs(item) -> None:
+        """Clone function-scoped FixtureDefs so this item has its own copies.
+
+        Shared (module/class/session) FixtureDefs are kept as-is — their
+        cached values are read-only after the first item's setup.
+        Function-scoped FixtureDefs get independent copies with fresh
+        cached_result and _finalizers, allowing concurrent fixture setup
+        across items without racing on shared singleton state.
+        """
+        # noinspection PyProtectedMember
+        # request._arg2fixturedefs, fixturedef._scope: no public API;
+        # mirrors pytest's own TopRequest/FixtureDef internals.
+        request = getattr(item, "_request", None)
+        if not request or not hasattr(request, "_arg2fixturedefs"):
+            return
+
+        new_arg2fds = {}
+        for argname, fds in request._arg2fixturedefs.items():  # pyright: ignore[reportPrivateUsage]
+            new_fds = []
+            for fd in fds:
+                if fd._scope is Scope.Function:  # pyright: ignore[reportPrivateUsage]
+                    clone = FixtureDef.__new__(FixtureDef)
+                    clone.__dict__.update(fd.__dict__)
+                    clone.cached_result = None
+                    clone._finalizers = []  # pyright: ignore[reportPrivateUsage, reportAttributeAccessIssue]
+                    new_fds.append(clone)
+                else:
+                    new_fds.append(fd)
+            new_arg2fds[argname] = new_fds
+
+        # _arg2fixturedefs is typed Final but not enforced at runtime
+        object.__setattr__(request, "_arg2fixturedefs", new_arg2fds)
+
     @staticmethod
     def save_and_clear_function_fixtures(item) -> list:
         """After an item's setup, save its function-scoped fixture finalizers
@@ -58,6 +93,39 @@ class FixtureManager:
                 if fixturedef._scope is Scope.Function and fixturedef.cached_result is not None:  # pyright: ignore[reportPrivateUsage]
                     fixturedef.cached_result = None
 
+    @staticmethod
+    def populate_shared_fixtures(item) -> None:
+        """Resolve only non-function-scoped fixtures for the item.
+
+        Populates shared fixture caches (module/class/session scope) by
+        calling getfixturevalue for each non-function-scoped fixture.
+        Function-scoped fixtures are skipped — they will be created later
+        from cloned FixtureDefs in parallel workers.
+
+        Must be called inside a setup hook context (item in setupstate)
+        so that addfinalizer works for the resolved fixtures.
+        """
+        # noinspection PyProtectedMember
+        # request._arg2fixturedefs, fixturedef._scope: no public API;
+        # mirrors pytest's own TopRequest/FixtureDef internals.
+        request = getattr(item, "_request", None)
+        if not request or not hasattr(request, "_arg2fixturedefs"):
+            return
+
+        for argname in item.fixturenames:
+            if argname in item.funcargs:
+                continue
+            fds = request._arg2fixturedefs.get(argname, [])  # pyright: ignore[reportPrivateUsage]
+            if fds and fds[-1]._scope is not Scope.Function:  # pyright: ignore[reportPrivateUsage]
+                value = request.getfixturevalue(argname)
+                item.funcargs[argname] = value
+                # Eagerly initialize lazy state on shared fixture values.
+                # TmpPathFactory.getbasetemp() lazily creates the basetemp
+                # directory; without this, parallel workers would race on
+                # the first tmp_path_factory.mktemp() call.
+                if hasattr(value, "getbasetemp"):
+                    value.getbasetemp()
+
     @staticmethod
     def save_collector_finalizers(session, next_item) -> list:
         """Save finalizers from stack nodes that would be torn down when