laco-pydantic 1.0.0__tar.gz

laco_pydantic-1.0.0/PKG-INFO

@@ -0,0 +1,29 @@
+Metadata-Version: 2.4
+Name: laco-pydantic
+Version: 1.0.0
+Summary: Pydantic v2 bridge for laco structured configs.
+Author-email: Kurt Stolle <kurt@khws.io>
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: laco>=1.0.0
+Requires-Dist: pydantic>=2.0
+
+# Laco-Pydantic
+
+Pydantic v2 bridge for laco structured configs.
+
+Part of the [laco](https://github.com/khwstolle/laco) project — see the [root README](../../README.md) for an overview.
+
+## Installation
+
+```bash
+pip install laco-pydantic
+```
+
+## Features
+
+`validate()`, `to_config()`, `json_schema()`, `model_from_params()`
+
+## Usage
+
+See [`docs/index.md`](docs/index.md) for the full guide.

laco_pydantic-1.0.0/README.md

@@ -0,0 +1,19 @@
+# Laco-Pydantic
+
+Pydantic v2 bridge for laco structured configs.
+
+Part of the [laco](https://github.com/khwstolle/laco) project — see the [root README](../../README.md) for an overview.
+
+## Installation
+
+```bash
+pip install laco-pydantic
+```
+
+## Features
+
+`validate()`, `to_config()`, `json_schema()`, `model_from_params()`
+
+## Usage
+
+See [`docs/index.md`](docs/index.md) for the full guide.

laco_pydantic-1.0.0/pyproject.toml

@@ -0,0 +1,19 @@
+[build-system]
+requires = ["setuptools>=75", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "laco-pydantic"
+version = "1.0.0"
+description = "Pydantic v2 bridge for laco structured configs."
+readme = "README.md"
+requires-python = ">=3.13"
+authors = [{ name = "Kurt Stolle", email = "kurt@khws.io" }]
+dependencies = ["laco>=1.0.0", "pydantic>=2.0"]
+
+[tool.setuptools.packages.find]
+where = ["sources"]
+namespaces = true
+
+[tool.uv.sources]
+laco = { workspace = true }

laco_pydantic-1.0.0/setup.cfg

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

laco_pydantic-1.0.0/sources/laco/integrations/pydantic/__init__.py

@@ -0,0 +1,25 @@
+"""Pydantic v2 bridge for laco structured configs.
+
+Examples
+--------
+::
+
+    import laco
+    import laco.integrations.pydantic as laco_pydantic
+    from pydantic import BaseModel
+
+    class TrainConfig(BaseModel):
+        lr: float = 1e-3
+        epochs: int = 10
+
+    cfg = laco.load("configs/train.py")
+    validated = laco_pydantic.validate(cfg, TrainConfig)
+    print(validated.lr)
+"""
+
+from laco.integrations.pydantic._core import json_schema as json_schema
+from laco.integrations.pydantic._core import model_from_params as model_from_params
+from laco.integrations.pydantic._core import to_config as to_config
+from laco.integrations.pydantic._core import validate as validate
+
+__all__ = ["json_schema", "model_from_params", "to_config", "validate"]

laco_pydantic-1.0.0/sources/laco/integrations/pydantic/_core.py

@@ -0,0 +1,116 @@
+"""Implementation for laco-pydantic."""
+
+from __future__ import annotations
+
+import typing
+
+if typing.TYPE_CHECKING:
+    import pydantic
+    from omegaconf import DictConfig
+
+_ModelT = typing.TypeVar("_ModelT", bound="pydantic.BaseModel")
+
+
+def validate(cfg: DictConfig, model: type[_ModelT]) -> _ModelT:
+    """Validate a laco DictConfig against a Pydantic model.
+
+    Resolves OmegaConf interpolations before validation so ``${...}``
+    references are expanded to their concrete values.
+
+    Parameters
+    ----------
+    cfg : DictConfig
+        Resolved (or partially resolved) laco DictConfig.
+    model : type[BaseModel]
+        Pydantic v2 ``BaseModel`` subclass to validate against.
+
+    Returns
+    -------
+    _ModelT
+        A validated instance of *model*.
+
+    Raises
+    ------
+    pydantic.ValidationError
+        If the config does not match the model schema.
+    """
+    from omegaconf import OmegaConf
+
+    raw = OmegaConf.to_container(cfg, resolve=True, throw_on_missing=False)
+    return model.model_validate(raw)
+
+
+def to_config(instance: pydantic.BaseModel) -> DictConfig:
+    """Convert a Pydantic model instance to a laco DictConfig.
+
+    Parameters
+    ----------
+    instance : BaseModel
+        A validated Pydantic v2 model instance.
+
+    Returns
+    -------
+    DictConfig
+        OmegaConf ``DictConfig`` with the same fields and values.
+    """
+    from omegaconf import OmegaConf
+
+    data = instance.model_dump()
+    return OmegaConf.create(data)
+
+
+def json_schema(model: type[pydantic.BaseModel]) -> dict[str, typing.Any]:
+    """Return the JSON Schema for a Pydantic model.
+
+    Parameters
+    ----------
+    model : type[BaseModel]
+        Pydantic v2 ``BaseModel`` subclass.
+
+    Returns
+    -------
+    dict
+        JSON Schema as produced by ``model.model_json_schema()``.
+    """
+    return model.model_json_schema()
+
+
+def model_from_params(
+    wrapper: typing.Any,
+    *,
+    model_name: str = "LacoModel",
+) -> type[pydantic.BaseModel]:
+    """Dynamically build a Pydantic model from a laco ``ParamsWrapper``.
+
+    Parameters
+    ----------
+    wrapper : ParamsWrapper
+        A ``ParamsWrapper`` instance (the result of ``@L.params``).
+    model_name : str
+        Class name for the generated Pydantic model. Default: ``"LacoModel"``.
+
+    Returns
+    -------
+    type[BaseModel]
+        Pydantic ``BaseModel`` subclass with fields matching the params block.
+    """
+    import pydantic
+    from laco.language import LacoParam
+
+    try:
+        annotations = typing.get_type_hints(wrapper._cls) if hasattr(wrapper, "_cls") else {}
+    except Exception:  # noqa: BLE001
+        annotations = getattr(wrapper._cls, "__annotations__", {}) if hasattr(wrapper, "_cls") else {}
+    fields: dict[str, typing.Any] = {}
+    for field_name, raw_val in wrapper._dict.items():
+        laco_p = raw_val if isinstance(raw_val, LacoParam) else None
+        default = laco_p.default if laco_p else raw_val
+        ann = annotations.get(field_name, type(default) if default is not None else typing.Any)
+        fields[field_name] = (
+            ann,
+            pydantic.Field(
+                default=default, description=laco_p.help if laco_p else None
+            ),
+        )
+
+    return pydantic.create_model(model_name, **fields)

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

@@ -0,0 +1,29 @@
+Metadata-Version: 2.4
+Name: laco-pydantic
+Version: 1.0.0
+Summary: Pydantic v2 bridge for laco structured configs.
+Author-email: Kurt Stolle <kurt@khws.io>
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: laco>=1.0.0
+Requires-Dist: pydantic>=2.0
+
+# Laco-Pydantic
+
+Pydantic v2 bridge for laco structured configs.
+
+Part of the [laco](https://github.com/khwstolle/laco) project — see the [root README](../../README.md) for an overview.
+
+## Installation
+
+```bash
+pip install laco-pydantic
+```
+
+## Features
+
+`validate()`, `to_config()`, `json_schema()`, `model_from_params()`
+
+## Usage
+
+See [`docs/index.md`](docs/index.md) for the full guide.

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

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+sources/laco/integrations/pydantic/__init__.py
+sources/laco/integrations/pydantic/_core.py
+sources/laco_pydantic.egg-info/PKG-INFO
+sources/laco_pydantic.egg-info/SOURCES.txt
+sources/laco_pydantic.egg-info/dependency_links.txt
+sources/laco_pydantic.egg-info/requires.txt
+sources/laco_pydantic.egg-info/top_level.txt
+tests/test_laco_pydantic.py

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,2 @@
+laco>=1.0.0
+pydantic>=2.0

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

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

laco_pydantic-1.0.0/tests/test_laco_pydantic.py

@@ -0,0 +1,99 @@
+"""Tests for laco-pydantic."""
+
+import pytest
+
+
+def test_import():
+    import laco.integrations.pydantic  # noqa: F401
+
+
+def test_public_api():
+    import laco.integrations.pydantic as laco_pydantic
+
+    assert set(laco_pydantic.__all__) == {
+        "json_schema",
+        "model_from_params",
+        "to_config",
+        "validate",
+    }
+
+
+def test_validate_basic():
+    import laco.integrations.pydantic as laco_pydantic
+    from omegaconf import OmegaConf
+    from pydantic import BaseModel
+
+    class Config(BaseModel):
+        lr: float = 1e-3
+        epochs: int = 10
+
+    cfg = OmegaConf.create({"lr": 0.01, "epochs": 5})
+    result = laco_pydantic.validate(cfg, Config)
+
+    assert isinstance(result, Config)
+    assert result.lr == pytest.approx(0.01)
+    assert result.epochs == 5
+
+
+def test_validate_type_coercion():
+    import laco.integrations.pydantic as laco_pydantic
+    from omegaconf import OmegaConf
+    from pydantic import BaseModel
+
+    class Config(BaseModel):
+        value: float
+
+    cfg = OmegaConf.create({"value": 1})
+    result = laco_pydantic.validate(cfg, Config)
+
+    assert result.value == pytest.approx(1.0)
+    assert isinstance(result.value, float)
+
+
+def test_validate_raises_on_invalid():
+    import laco.integrations.pydantic as laco_pydantic
+    from omegaconf import OmegaConf
+    from pydantic import BaseModel, ValidationError
+
+    class Config(BaseModel):
+        count: int
+
+    cfg = OmegaConf.create({"count": "not-a-number"})
+    with pytest.raises(ValidationError):
+        laco_pydantic.validate(cfg, Config)
+
+
+def test_to_config_roundtrip():
+    import laco.integrations.pydantic as laco_pydantic
+    from omegaconf import OmegaConf
+    from pydantic import BaseModel
+
+    class Config(BaseModel):
+        lr: float = 1e-3
+        epochs: int = 10
+
+    original = OmegaConf.create({"lr": 0.001, "epochs": 10})
+    model_instance = laco_pydantic.validate(original, Config)
+    recovered = laco_pydantic.to_config(model_instance)
+
+    assert OmegaConf.to_container(recovered) == {
+        "lr": pytest.approx(0.001),
+        "epochs": 10,
+    }
+
+
+def test_json_schema_has_properties():
+    import laco.integrations.pydantic as laco_pydantic
+    from pydantic import BaseModel
+
+    class Config(BaseModel):
+        lr: float = 1e-3
+        epochs: int = 10
+
+    schema = laco_pydantic.json_schema(Config)
+
+    assert "properties" in schema
+    assert "lr" in schema["properties"]
+    assert "epochs" in schema["properties"]
+    assert schema["properties"]["lr"]["type"] == "number"
+    assert schema["properties"]["epochs"]["type"] == "integer"