pico-testing 0.1.0__py3-none-any.whl

pico_testing/__init__.py

@@ -0,0 +1 @@
+from .plugin import AUTO_PLUGINS_MARKER as AUTO_PLUGINS_MARKER

pico_testing/_version.py

@@ -0,0 +1 @@
+__version__ = '0.1.0'

pico_testing/plugin.py

@@ -0,0 +1,55 @@
+"""Pytest plugin: isolated pico containers by default.
+
+Installed as a ``pytest11`` entry point — active in any venv that has
+pico-testing, no conftest wiring needed.
+"""
+
+import pytest
+
+AUTO_PLUGINS_MARKER = "pico_auto_plugins"
+
+
+def pytest_configure(config):
+    config.addinivalue_line(
+        "markers",
+        f"{AUTO_PLUGINS_MARKER}: allow pico-boot plugin auto-discovery in this test "
+        "(by default pico-testing sets PICO_BOOT_AUTO_PLUGINS=false)",
+    )
+
+
+@pytest.fixture(autouse=True)
+def pico_isolation(request, monkeypatch):
+    """Tests must not depend on which pico plugins happen to be installed
+    in the venv — auto-discovery is opt-in via the pico_auto_plugins marker."""
+    if request.node.get_closest_marker(AUTO_PLUGINS_MARKER) is None:
+        monkeypatch.setenv("PICO_BOOT_AUTO_PLUGINS", "false")
+
+
+@pytest.fixture
+def make_container():
+    """Factory for pico containers with automatic shutdown on teardown.
+
+    Usage::
+
+        def test_service(make_container):
+            container = make_container("my_pkg", config={"my": {"key": "value"}})
+            svc = container.get(MyService)
+    """
+    created = []
+
+    def _make(*modules, config=None, boot=False):
+        from pico_ioc import DictSource, configuration
+
+        if config is None or isinstance(config, dict):
+            config = configuration(DictSource(config or {}))
+        if boot:
+            from pico_boot import init
+        else:
+            from pico_ioc import init
+        container = init(modules=list(modules), config=config)
+        created.append(container)
+        return container
+
+    yield _make
+    for container in reversed(created):
+        container.shutdown()

pico_testing-0.1.0.dist-info/METADATA

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: pico-testing
+Version: 0.1.0
+Summary: Pytest plugin for the Pico ecosystem: isolated containers by default and a make_container fixture.
+Author-email: David Perez Cabrera <dperezcabrera@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 David Pérez Cabrera
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/dperezcabrera/pico-testing
+Project-URL: Documentation, https://dperezcabrera.github.io/pico-testing/
+Project-URL: Repository, https://github.com/dperezcabrera/pico-testing
+Project-URL: Changelog, https://github.com/dperezcabrera/pico-testing/blob/main/CHANGELOG.md
+Project-URL: Issue Tracker, https://github.com/dperezcabrera/pico-testing/issues
+Keywords: testing,pytest,fixtures,ioc,dependency injection,spring boot
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: Pytest
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pico-ioc>=2.2.0
+Requires-Dist: pytest>=8
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: pytest-cov>=5; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: pico-boot>=0.1.0; extra == "dev"
+Dynamic: license-file
+
+# pico-testing
+
+[![PyPI version](https://img.shields.io/pypi/v/pico-testing.svg)](https://pypi.org/project/pico-testing/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI](https://github.com/dperezcabrera/pico-testing/actions/workflows/ci.yml/badge.svg)](https://github.com/dperezcabrera/pico-testing/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/dperezcabrera/pico-testing/branch/main/graph/badge.svg)](https://codecov.io/gh/dperezcabrera/pico-testing)
+[![Docs](https://img.shields.io/badge/docs-mkdocs-blue)](https://dperezcabrera.github.io/pico-testing/)
+
+Pytest plugin for the [pico ecosystem](https://github.com/dperezcabrera/pico-ioc): isolated containers by default and a `make_container` fixture with automatic shutdown.
+
+## Why
+
+Any `pico_boot.init()` in a test auto-discovers every pico plugin installed in the venv — so a test suite passes or fails depending on what else happens to be installed. Every pico project ends up copying the same two conftest fixtures. This plugin ships them once:
+
+- **Isolation by default**: `PICO_BOOT_AUTO_PLUGINS=false` is set for every test. Opt back in per-test with `@pytest.mark.pico_auto_plugins`.
+- **`make_container`**: builds containers from explicit modules and config, and shuts them all down on teardown.
+
+## Installation
+
+```bash
+pip install pico-testing
+```
+
+No conftest wiring — installing it activates the plugin.
+
+## Quick start
+
+```python
+import sys
+
+def test_my_service(make_container):
+    container = make_container(
+        "my_package",
+        config={"my_prefix": {"key": "value"}},
+    )
+    service = container.get(MyService)
+    assert service.do_something() == "expected"
+```
+
+`make_container(*modules, config=None, boot=False)`:
+
+- `modules`: module objects or import strings, passed to `init(modules=[...])`.
+- `config`: a plain dict (wrapped in `configuration(DictSource(...))`) or a ready `configuration(...)` object.
+- `boot=True`: use `pico_boot.init` instead of `pico_ioc.init` (plugin auto-discovery still off unless the test is marked).
+
+Re-enable plugin auto-discovery for a single test:
+
+```python
+import pytest
+
+@pytest.mark.pico_auto_plugins
+def test_full_boot(make_container):
+    container = make_container(boot=True)
+```
+
+## Documentation
+
+Full documentation: https://dperezcabrera.github.io/pico-testing/
+
+## License
+
+MIT

pico_testing-0.1.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+pico_testing/__init__.py,sha256=C14pqnBELqlAZ5tN0POqpT83_4cQLWqb05524vHLBOI,63
+pico_testing/_version.py,sha256=IMjkMO3twhQzluVTo8Z6rE7Eg-9U79_LGKMcsWLKBkY,22
+pico_testing/plugin.py,sha256=vSbgXueEs63z3eyYS2JN88XzroZ8wQm3pEb4bsIOr3s,1692
+pico_testing/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pico_testing-0.1.0.dist-info/licenses/LICENSE,sha256=N1_nOvHTM6BobYnOTNXiQkroDqCEi6EzfGBv8lWtyZ0,1077
+pico_testing-0.1.0.dist-info/METADATA,sha256=2I1nswpAhbYWx9EJk3HJNrsuyfLHBT9odo_iTSgoXcQ,5267
+pico_testing-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+pico_testing-0.1.0.dist-info/entry_points.txt,sha256=blnvNLQ9vWeTZnS3jvesXemggAIs-M_fn-tlenVuacQ,46
+pico_testing-0.1.0.dist-info/scm_file_list.json,sha256=gkegZm4QUM-OaMylR6fhmdafTSgvm2DLMuubqlLR3ec,1001
+pico_testing-0.1.0.dist-info/scm_version.json,sha256=gBMY4WkX0FZTEmS4trQBNaZj0SKmvLihS_JjPRVSlDY,160
+pico_testing-0.1.0.dist-info/top_level.txt,sha256=OlSqE-jADkU2Pt5ROtsr5ONRYHFXHQaRvOcreVqtDK8,13
+pico_testing-0.1.0.dist-info/RECORD,,

pico_testing-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pico_testing-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[pytest11]
+pico_testing = pico_testing.plugin

pico_testing-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 David Pérez Cabrera
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pico_testing-0.1.0.dist-info/scm_file_list.json

@@ -0,0 +1,40 @@
+{
+  "files": [
+    ".coveragerc",
+    "README.md",
+    "Makefile",
+    "tox.ini",
+    "LICENSE",
+    "pyproject.toml",
+    "SECURITY.md",
+    "mkdocs.yml",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "MANIFEST.in",
+    ".sonarcloud.properties",
+    "Dockerfile.test",
+    ".gitignore",
+    "CODE_OF_CONDUCT.md",
+    "docs/getting-started.md",
+    "docs/requirements.txt",
+    "docs/CHANGELOG.md",
+    "docs/faq.md",
+    "docs/index.md",
+    "docs/hooks.py",
+    "docs/stylesheets/extra.css",
+    "docs/javascripts/extra.js",
+    "src/pico_testing/py.typed",
+    "src/pico_testing/__init__.py",
+    "src/pico_testing/plugin.py",
+    "tests/test_plugin.py",
+    "tests/conftest.py",
+    ".github/PULL_REQUEST_TEMPLATE.md",
+    ".github/dependabot.yml",
+    ".github/ISSUE_TEMPLATE/bug_report.yml",
+    ".github/ISSUE_TEMPLATE/feature_request.yml",
+    ".github/workflows/docs.yml",
+    ".github/workflows/codeql.yml",
+    ".github/workflows/ci.yml",
+    ".github/workflows/publish-to-pypi.yml"
+  ]
+}

pico_testing-0.1.0.dist-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "0.1.0",
+  "distance": 0,
+  "node": "g68689a55b7a0f2ffc44269262159e386fb3c06de",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-07-10"
+}

pico_testing-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+pico_testing