pytest-isolated 0.3.0__py3-none-any.whl → 0.4.1__py3-none-any.whl

{pytest_isolated-0.3.0.dist-info → pytest_isolated-0.4.1.dist-info}/METADATA

@@ -1,9 +1,12 @@
 Metadata-Version: 2.4
 Name: pytest-isolated
-Version: 0.3.0
+Version: 0.4.1
 Summary: Run marked pytest tests in grouped subprocesses (cross-platform).
 Author: pytest-isolated contributors
 License-Expression: MIT
+Project-URL: Homepage, https://github.com/dyollb/pytest-isolated
+Project-URL: Repository, https://github.com/dyollb/pytest-isolated
+Project-URL: Issues, https://github.com/dyollb/pytest-isolated/issues
 Classifier: Development Status :: 4 - Beta
 Classifier: Framework :: Pytest
 Classifier: Intended Audience :: Developers
@@ -17,11 +20,11 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pytest>=7.0
 Provides-Extra: dev
-Requires-Dist: pre-commit; extra == "dev"
 Requires-Dist: build; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: pytest-timeout; extra == "dev"
 Requires-Dist: ruff; extra == "dev"
-Provides-Extra: test
-Requires-Dist: pytest-timeout; extra == "test"
 Dynamic: license-file
 
 # pytest-isolated
@@ -29,18 +32,22 @@ Dynamic: license-file
 [![Tests](https://github.com/dyollb/pytest-isolated/actions/workflows/test.yml/badge.svg)](https://github.com/dyollb/pytest-isolated/actions/workflows/test.yml)
 [![PyPI](https://img.shields.io/pypi/v/pytest-isolated.svg)](https://pypi.org/project/pytest-isolated/)
 
-A pytest plugin that runs marked tests in isolated subprocesses with intelligent grouping.
+A cross-platform pytest plugin that runs marked tests in isolated subprocesses with intelligent grouping.
 
 ## Features
 
 - Run tests in fresh Python subprocesses to prevent state pollution
 - Group related tests to run together in the same subprocess
 - Handles crashes, timeouts, and setup/teardown failures
-- Captures stdout/stderr for failed tests
+- Respects pytest's standard output capture settings (`-s`, `--capture`)
 - Works with pytest reporters (JUnit XML, etc.)
 - Configurable timeouts to prevent hanging subprocesses
 - Cross-platform: Linux, macOS, Windows
 
+## Cheatsheet for pytest-forked users
+
+This plugin is inspired by [pytest-forked](https://github.com/pytest-dev/pytest-forked). See [pytest-forked migration guide](docs/pytest-forked-migration.md) for a quick reference comparing features.
+
 ## Installation
 
 ```bash
@@ -63,6 +70,7 @@ def test_isolated():
 Tests with the same group run together in one subprocess:
 
 ```python
+# Using keyword argument
 @pytest.mark.isolated(group="mygroup")
 def test_one():
     shared_state.append(1)
@@ -71,6 +79,11 @@ def test_one():
 def test_two():
     # Sees state from test_one
     assert len(shared_state) == 2
+
+# Or using positional argument
+@pytest.mark.isolated("mygroup")
+def test_three():
+    shared_state.append(3)
 ```
 
 Set timeout per test group:
@@ -82,19 +95,58 @@ def test_with_timeout():
     expensive_operation()
 ```
 
-Tests without an explicit group are automatically grouped by module.
+**Note:** Tests without an explicit `group` parameter each run in their own unique subprocess for maximum isolation.
+
+### Class and Module Markers
+
+Apply to entire classes to share state between methods:
+
+```python
+@pytest.mark.isolated
+class TestDatabase:
+    def test_setup(self):
+        self.db = create_database()
+
+    def test_query(self):
+        # Shares state with test_setup
+        result = self.db.query("SELECT 1")
+        assert result
+```
+
+Apply to entire modules using `pytestmark`:
+
+```python
+import pytest
+
+pytestmark = pytest.mark.isolated
+
+def test_one():
+    # Runs in isolated subprocess
+    pass
+
+def test_two():
+    # Shares subprocess with test_one
+    pass
+```
 
 ## Configuration
 
 ### Command Line
 
 ```bash
+# Run all tests in isolation (even without @pytest.mark.isolated)
+pytest --isolated
+
 # Set isolated test timeout (seconds)
 pytest --isolated-timeout=60
 
 # Disable subprocess isolation for debugging
 pytest --no-isolation
 
+# Control output capture (standard pytest flags work with isolated tests)
+pytest -s                    # Disable capture, show all output
+pytest --capture=sys         # Capture at sys.stdout/stderr level
+
 # Combine with pytest debugger
 pytest --no-isolation --pdb
 ```
@@ -104,7 +156,6 @@ pytest --no-isolation --pdb
 ```ini
 [pytest]
 isolated_timeout = 300
-isolated_capture_passed = false
 ```
 
 Or in `pyproject.toml`:
@@ -112,7 +163,6 @@ Or in `pyproject.toml`:
 ```toml
 [tool.pytest.ini_options]
 isolated_timeout = "300"
-isolated_capture_passed = false
 ```
 
 ## Use Cases
@@ -184,6 +234,18 @@ pytest --junitxml=report.xml --durations=10
 
 ## Advanced
 
+### Coverage Integration
+
+To collect coverage from isolated tests, enable subprocess tracking in `pyproject.toml`:
+
+```toml
+[tool.coverage.run]
+parallel = true
+concurrency = ["subprocess"]
+```
+
+See the [coverage.py subprocess documentation](https://coverage.readthedocs.io/en/latest/subprocess.html) for details.
+
 ### Timeout Handling
 
 ```bash
@@ -210,7 +272,7 @@ if os.environ.get("PYTEST_RUNNING_IN_SUBPROCESS") == "1":
 
 **Tests timing out**: Increase timeout with `--isolated-timeout=600`
 
-**Missing output**: Enable capture for passed tests with `isolated_capture_passed = true`
+**Missing output**: Use `-s` or `--capture=no` to see output from passing tests, or `-v` for verbose output. pytest-isolated respects pytest's standard capture settings.
 
 **Subprocess crashes**: Check for segfaults, OOM, or signal issues. Run with `-v` for details.
 

pytest_isolated-0.4.1.dist-info/RECORD

@@ -0,0 +1,13 @@
+pytest_isolated/__init__.py,sha256=Rx5JwthqrahraDXAeDQkxTV9WXyw29nlQCrL-6RC72s,89
+pytest_isolated/config.py,sha256=z8g5Pw5NUKuCuTosRtxR9IkzE6WaHhG2Zh8jJgBqwBU,2383
+pytest_isolated/execution.py,sha256=tzYGwrbtfOAZHEX3mu52Du1iTm7T5fuiHNZRcIx6EWg,16644
+pytest_isolated/grouping.py,sha256=jWYX8cdhqjIXVnq5DrSYImulPDsolPSb1DFGNUGBGvU,3248
+pytest_isolated/plugin.py,sha256=Ieubhh2-CcmCS7IYf5HrGYFGstMyHzjNRpYTrWr-ghs,562
+pytest_isolated/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pytest_isolated/reporting.py,sha256=VXM8rc1o5-ug2aj02nkv87DtxDs43dejkN-udUPh59U,5869
+pytest_isolated-0.4.1.dist-info/licenses/LICENSE,sha256=WECJyowi685PZSnKcA4Tqs7jukfzbnk7iMPLnm_q4JI,1067
+pytest_isolated-0.4.1.dist-info/METADATA,sha256=S68b4OkZct1vVMJ3RAUml3us44kNox0ivnOILDSzr_k,7259
+pytest_isolated-0.4.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+pytest_isolated-0.4.1.dist-info/entry_points.txt,sha256=HgRNPjIGoPBF1pkhma4UtaSwhpOVB8oZRZ0L1FcZXgk,45
+pytest_isolated-0.4.1.dist-info/top_level.txt,sha256=FAtpozhvI-YaiFoZMepi9JAm6e87mW-TM1Ovu5xLOxg,16
+pytest_isolated-0.4.1.dist-info/RECORD,,

pytest_isolated-0.3.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-pytest_isolated/__init__.py,sha256=b7RfFW9uJXumJ6DTDdg-VvSUEeh-Pc2srTjCKJRxB7k,89
-pytest_isolated/plugin.py,sha256=ISfxTMyJVaddrqCFZOdBXFnC4E_Lh22gRUaNRb1Wo8I,15179
-pytest_isolated/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pytest_isolated-0.3.0.dist-info/licenses/LICENSE,sha256=WECJyowi685PZSnKcA4Tqs7jukfzbnk7iMPLnm_q4JI,1067
-pytest_isolated-0.3.0.dist-info/METADATA,sha256=CDzpvrFqvUFguTk9_Yr32h88GatvKDHCO0d7CsVC5Ug,5384
-pytest_isolated-0.3.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-pytest_isolated-0.3.0.dist-info/entry_points.txt,sha256=HgRNPjIGoPBF1pkhma4UtaSwhpOVB8oZRZ0L1FcZXgk,45
-pytest_isolated-0.3.0.dist-info/top_level.txt,sha256=FAtpozhvI-YaiFoZMepi9JAm6e87mW-TM1Ovu5xLOxg,16
-pytest_isolated-0.3.0.dist-info/RECORD,,