laco-pytest 1.0.0__tar.gz

laco_pytest-1.0.0/PKG-INFO

@@ -0,0 +1,29 @@
+Metadata-Version: 2.4
+Name: laco-pytest
+Version: 1.0.0
+Summary: pytest fixtures and helpers for laco.
+Author-email: Kurt Stolle <kurt@khws.io>
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: laco>=1.0.0
+Requires-Dist: pytest>=8.0
+
+# Laco-Pytest
+
+Pytest plugin and fixtures for laco.
+
+Part of the [laco](https://github.com/khwstolle/laco) project — see the [root README](../../README.md) for an overview.
+
+## Installation
+
+```bash
+pip install laco-pytest
+```
+
+## Features
+
+`laco_config` fixture, `laco_config_file` fixture, `--laco-config` CLI option
+
+## Usage
+
+See [`docs/index.md`](docs/index.md) for the full guide.

laco_pytest-1.0.0/README.md

@@ -0,0 +1,19 @@
+# Laco-Pytest
+
+Pytest plugin and fixtures for laco.
+
+Part of the [laco](https://github.com/khwstolle/laco) project — see the [root README](../../README.md) for an overview.
+
+## Installation
+
+```bash
+pip install laco-pytest
+```
+
+## Features
+
+`laco_config` fixture, `laco_config_file` fixture, `--laco-config` CLI option
+
+## Usage
+
+See [`docs/index.md`](docs/index.md) for the full guide.

laco_pytest-1.0.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=75", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "laco-pytest"
+version = "1.0.0"
+description = "pytest fixtures and helpers for laco."
+readme = "README.md"
+requires-python = ">=3.13"
+authors = [{ name = "Kurt Stolle", email = "kurt@khws.io" }]
+dependencies = ["laco>=1.0.0", "pytest>=8.0"]
+
+[project.entry-points."pytest11"]
+laco = "laco.integrations.pytest.plugin"
+
+[tool.setuptools.packages.find]
+where = ["sources"]
+namespaces = true
+
+[tool.uv.sources]
+laco = { workspace = true }

laco_pytest-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

laco_pytest-1.0.0/sources/laco/integrations/pytest/__init__.py

@@ -0,0 +1,6 @@
+"""pytest helpers for laco — re-exports the plugin fixtures for direct import."""
+
+from laco.integrations.pytest.plugin import laco_config as laco_config
+from laco.integrations.pytest.plugin import laco_config_file as laco_config_file
+
+__all__ = ["laco_config", "laco_config_file"]

laco_pytest-1.0.0/sources/laco/integrations/pytest/plugin.py

@@ -0,0 +1,131 @@
+"""pytest plugin — auto-registered via the ``pytest11`` entry point.
+
+Provides:
+
+- ``laco_config_file`` — session-scoped fixture: path to the config under
+  test, resolved from the ``--laco-config`` CLI option.
+- ``laco_config`` — function-scoped fixture: loaded DictConfig with optional
+  per-test overrides via indirect parametrize.
+
+Examples
+--------
+::
+
+    # Override the default config path for the whole session:
+    # pytest --laco-config configs/train.py
+
+    # In tests:
+    def test_lr(laco_config):
+        assert laco_config.lr > 0
+
+
+    # Parametrise overrides:
+    @pytest.mark.parametrize("laco_config", [{"lr": 1e-3}, {"lr": 1e-4}], indirect=True)
+    def test_lr_values(laco_config):
+        assert laco_config.lr in (1e-3, 1e-4)
+"""
+
+from __future__ import annotations
+
+import typing
+
+import pytest
+
+if typing.TYPE_CHECKING:
+    from omegaconf import DictConfig
+
+
+def pytest_addoption(parser: pytest.Parser) -> None:
+    parser.addoption(
+        "--laco-config",
+        default=None,
+        metavar="PATH",
+        help="Path to the default laco config file used by the laco_config fixture.",
+    )
+
+
+@pytest.fixture(scope="session")
+def laco_config_file(request: pytest.FixtureRequest) -> str | None:
+    """Return the path to the laco config under test (``--laco-config`` option).
+
+    Returns
+    -------
+    str | None
+        The path passed to ``--laco-config``, or ``None`` if not provided.
+    """
+    return request.config.getoption("--laco-config")
+
+
+@pytest.fixture
+def laco_config(
+    request: pytest.FixtureRequest,
+    laco_config_file: str | None,
+) -> DictConfig:
+    """Load and return a laco DictConfig, optionally with per-test overrides.
+
+    When used with ``indirect=True`` parametrize, the parameter may be:
+
+    - A ``dict`` of override key-value pairs (e.g. ``{"lr": 1e-3}``).
+    - A ``list[str]`` of Hydra-style override strings (e.g. ``["lr=1e-3"]``).
+    - A path ``str`` overriding the config file for this test only.
+
+    Parameters
+    ----------
+    request : pytest.FixtureRequest
+        Pytest fixture request object.
+    laco_config_file : str | None
+        Session-level config path from ``--laco-config``, or ``None``.
+
+    Returns
+    -------
+    DictConfig
+        Resolved laco DictConfig, with any per-test overrides applied.
+
+    Examples
+    --------
+    ::
+
+        def test_default(laco_config):
+            assert laco_config.epochs == 10
+
+
+        @pytest.mark.parametrize("laco_config", [{"epochs": 5}], indirect=True)
+        def test_overridden(laco_config):
+            assert laco_config.epochs == 5
+    """
+    import laco
+    from laco._overrides import apply_overrides
+
+    param = getattr(request, "param", None)
+
+    # Determine config path
+    if isinstance(param, str) and not isinstance(param, dict):
+        # The param is itself a config path
+        path = param
+        overrides: list[str] = []
+    else:
+        path = laco_config_file
+        if path is None:
+            msg = (
+                "laco_config fixture requires either --laco-config CLI option "
+                "or a path string passed via indirect parametrize."
+            )
+            pytest.fail(msg)
+        if isinstance(param, dict):
+            overrides = []
+            for k, v in param.items():
+                if v is None:
+                    overrides.append(f"{k}=null")
+                elif isinstance(v, str):
+                    overrides.append(f"{k}={v!r}")
+                else:
+                    overrides.append(f"{k}={v}")
+        elif isinstance(param, list):
+            overrides = param
+        else:
+            overrides = []
+
+    cfg = laco.load(path)
+    if overrides:
+        cfg = apply_overrides(cfg, overrides)
+    return cfg

laco_pytest-1.0.0/sources/laco_pytest.egg-info/PKG-INFO

@@ -0,0 +1,29 @@
+Metadata-Version: 2.4
+Name: laco-pytest
+Version: 1.0.0
+Summary: pytest fixtures and helpers for laco.
+Author-email: Kurt Stolle <kurt@khws.io>
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: laco>=1.0.0
+Requires-Dist: pytest>=8.0
+
+# Laco-Pytest
+
+Pytest plugin and fixtures for laco.
+
+Part of the [laco](https://github.com/khwstolle/laco) project — see the [root README](../../README.md) for an overview.
+
+## Installation
+
+```bash
+pip install laco-pytest
+```
+
+## Features
+
+`laco_config` fixture, `laco_config_file` fixture, `--laco-config` CLI option
+
+## Usage
+
+See [`docs/index.md`](docs/index.md) for the full guide.

laco_pytest-1.0.0/sources/laco_pytest.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+sources/laco/integrations/pytest/__init__.py
+sources/laco/integrations/pytest/plugin.py
+sources/laco_pytest.egg-info/PKG-INFO
+sources/laco_pytest.egg-info/SOURCES.txt
+sources/laco_pytest.egg-info/dependency_links.txt
+sources/laco_pytest.egg-info/entry_points.txt
+sources/laco_pytest.egg-info/requires.txt
+sources/laco_pytest.egg-info/top_level.txt
+tests/test_laco_pytest.py

laco_pytest-1.0.0/sources/laco_pytest.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

laco_pytest-1.0.0/sources/laco_pytest.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[pytest11]
+laco = laco.integrations.pytest.plugin

laco_pytest-1.0.0/sources/laco_pytest.egg-info/requires.txt

@@ -0,0 +1,2 @@
+laco>=1.0.0
+pytest>=8.0

laco_pytest-1.0.0/sources/laco_pytest.egg-info/top_level.txt

@@ -0,0 +1 @@
+laco

laco_pytest-1.0.0/tests/test_laco_pytest.py

@@ -0,0 +1,40 @@
+"""Tests for laco-pytest."""
+
+
+def test_import():
+    import laco.integrations.pytest  # noqa: F401
+
+
+def test_public_api():
+    import laco.integrations.pytest as laco_pytest
+
+    assert hasattr(laco_pytest, "laco_config")
+    assert hasattr(laco_pytest, "laco_config_file")
+    assert set(laco_pytest.__all__) == {"laco_config", "laco_config_file"}
+
+
+def test_plugin_registers_option(pytestconfig):
+    """The --laco-config option should be registered by the plugin."""
+    known = {opt.dest for opt in pytestconfig._parser._anonymous.options}
+    assert "laco_config" in known
+
+
+def test_laco_config_file_fixture_default(testdir):
+    """laco_config_file returns None when --laco-config is not passed."""
+    testdir.makepyfile("""
+        def test_default(laco_config_file):
+            assert laco_config_file is None
+    """)
+    result = testdir.runpytest()
+    result.assert_outcomes(passed=1)
+
+
+def test_laco_config_fixture_fails_without_path(testdir):
+    """laco_config fails with a clear message when no path is configured."""
+    testdir.makepyfile("""
+        def test_no_path(laco_config):
+            pass
+    """)
+    result = testdir.runpytest()
+    result.assert_outcomes(failed=1)
+    result.stdout.fnmatch_lines(["*--laco-config*"])