laco-typer 1.0.0__tar.gz

laco_typer-1.0.0/PKG-INFO

@@ -0,0 +1,29 @@
+Metadata-Version: 2.4
+Name: laco-typer
+Version: 1.0.0
+Summary: Typer CLI generation from @L.params blocks.
+Author-email: Kurt Stolle <kurt@khws.io>
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: laco>=1.0.0
+Requires-Dist: typer>=0.12
+
+# Laco-Typer
+
+Typer CLI generation from `@L.params` blocks.
+
+Part of the [laco](https://github.com/khwstolle/laco) project — see the [root README](../../README.md) for an overview.
+
+## Installation
+
+```bash
+pip install laco-typer
+```
+
+## Features
+
+`make_app()`, `register()`
+
+## Usage
+
+See [`docs/index.md`](docs/index.md) for the full guide.

laco_typer-1.0.0/README.md

@@ -0,0 +1,19 @@
+# Laco-Typer
+
+Typer CLI generation from `@L.params` blocks.
+
+Part of the [laco](https://github.com/khwstolle/laco) project — see the [root README](../../README.md) for an overview.
+
+## Installation
+
+```bash
+pip install laco-typer
+```
+
+## Features
+
+`make_app()`, `register()`
+
+## Usage
+
+See [`docs/index.md`](docs/index.md) for the full guide.

laco_typer-1.0.0/pyproject.toml

@@ -0,0 +1,19 @@
+[build-system]
+requires = ["setuptools>=75", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "laco-typer"
+version = "1.0.0"
+description = "Typer CLI generation from @L.params blocks."
+readme = "README.md"
+requires-python = ">=3.13"
+authors = [{ name = "Kurt Stolle", email = "kurt@khws.io" }]
+dependencies = ["laco>=1.0.0", "typer>=0.12"]
+
+[tool.setuptools.packages.find]
+where = ["sources"]
+namespaces = true
+
+[tool.uv.sources]
+laco = { workspace = true }

laco_typer-1.0.0/setup.cfg

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

laco_typer-1.0.0/sources/laco/integrations/typer/__init__.py

@@ -0,0 +1,21 @@
+"""Typer CLI generation from @L.params blocks for laco.
+
+Examples
+--------
+::
+
+    import laco.integrations.typer as laco_typer
+    import typer
+
+    app = laco_typer.make_app("configs/train.py", callback=train)
+    app()
+
+    # Or register onto an existing Typer app:
+    root = typer.Typer()
+    laco_typer.register(root, "configs/train.py", callback=train)
+"""
+
+from laco.integrations.typer._core import make_app as make_app
+from laco.integrations.typer._core import register as register
+
+__all__ = ["make_app", "register"]

laco_typer-1.0.0/sources/laco/integrations/typer/_core.py

@@ -0,0 +1,147 @@
+"""Implementation for laco-typer."""
+
+from __future__ import annotations
+
+import typing
+
+if typing.TYPE_CHECKING:
+    import typer
+    from omegaconf import DictConfig
+
+
+def _build_typer_command(
+    config_path: str,
+    callback: typing.Callable[[DictConfig], typing.Any],
+) -> typing.Callable[..., None]:
+    """Return a Typer-compatible command function with typed Option parameters."""
+    import inspect
+
+    import typer as _typer
+    from laco._io import _load_with_namespace
+    from laco._overrides import apply_overrides
+    from laco.language import LacoParam, ParamsWrapper
+
+    cfg_base, nsp = _load_with_namespace(config_path)
+
+    params_blocks: list[tuple[str, ParamsWrapper]] = [
+        (k, v)
+        for k, v in nsp.items()
+        if isinstance(v, ParamsWrapper) and not v._exclude and not k.startswith("_")
+    ]
+    module_params: list[tuple[str, LacoParam]] = [
+        (k, v)
+        for k, v in nsp.items()
+        if isinstance(v, LacoParam) and not k.startswith("_")
+    ]
+
+    # Build (cli_name, config_key, default, annotation, help) tuples
+    params_spec: list[tuple[str, str, typing.Any, type, str | None]] = []
+
+    for var_name, wrapper in params_blocks:
+        prefix = wrapper._prefix
+        if prefix is None:
+            flag_prefix = var_name + "_"
+        elif prefix == "":
+            flag_prefix = ""
+        else:
+            flag_prefix = prefix + "_"
+        annotations = (
+            typing.get_type_hints(wrapper._cls) if hasattr(wrapper, "_cls") else {}
+        )
+        for field_name, raw_val in wrapper._dict.items():
+            if field_name in wrapper._hidden:
+                continue
+            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 str
+            )
+            help_text = laco_p.help if laco_p else None
+            cli_name = f"{flag_prefix}{field_name}"
+            config_key = f"{var_name}.{field_name}"
+            params_spec.append((cli_name, config_key, default, ann, help_text))
+
+    for field_name, laco_p in module_params:
+        default = laco_p.default
+        ann = type(default) if default is not None else str
+        params_spec.append((field_name, field_name, default, ann, laco_p.help))
+
+    # Dynamically build the function signature using inspect.Parameter
+    sig_params = [
+        inspect.Parameter(
+            name=cli_name,
+            kind=inspect.Parameter.KEYWORD_ONLY,
+            default=_typer.Option(default, help=help_text or ""),
+            annotation=ann,
+        )
+        for cli_name, _config_key, default, ann, help_text in params_spec
+    ]
+
+    def _command(**kwargs: typing.Any) -> None:
+        overrides: list[str] = []
+        for cli_name, config_key, default, _ann, _help in params_spec:
+            val = kwargs[cli_name]
+            if val != default:
+                v = repr(val) if isinstance(val, str) else str(val)
+                overrides.append(f"{config_key}={v}")
+        cfg = apply_overrides(cfg_base, overrides) if overrides else cfg_base
+        callback(cfg)
+
+    _command.__signature__ = inspect.Signature(sig_params)  # type: ignore[attr-defined]
+    _command.__name__ = callback.__name__
+    _command.__doc__ = callback.__doc__ or ""
+    return _command
+
+
+def make_app(
+    config_path: str,
+    callback: typing.Callable[[DictConfig], typing.Any],
+    *,
+    name: str | None = None,
+) -> typer.Typer:
+    """Create a Typer application from a laco config file.
+
+    Parameters
+    ----------
+    config_path : str
+        Path to the laco config file.
+    callback : Callable
+        Function called with the resolved DictConfig.
+    name : str | None
+        Optional Typer app name.
+
+    Returns
+    -------
+    typer.Typer
+        App ready to be invoked.
+    """
+    import typer as _typer
+
+    app = _typer.Typer(name=name)
+    cmd = _build_typer_command(config_path, callback)
+    app.command()(cmd)
+    return app
+
+
+def register(
+    app: typer.Typer,
+    config_path: str,
+    callback: typing.Callable[[DictConfig], typing.Any],
+    *,
+    name: str | None = None,
+) -> None:
+    """Register a laco config as a command on an existing Typer app.
+
+    Parameters
+    ----------
+    app : typer.Typer
+        Existing Typer application.
+    config_path : str
+        Path to the laco config file.
+    callback : Callable
+        Function called with the resolved DictConfig.
+    name : str | None
+        Command name override. Defaults to ``callback.__name__``.
+    """
+    cmd = _build_typer_command(config_path, callback)
+    app.command(name=name)(cmd)

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

@@ -0,0 +1,29 @@
+Metadata-Version: 2.4
+Name: laco-typer
+Version: 1.0.0
+Summary: Typer CLI generation from @L.params blocks.
+Author-email: Kurt Stolle <kurt@khws.io>
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: laco>=1.0.0
+Requires-Dist: typer>=0.12
+
+# Laco-Typer
+
+Typer CLI generation from `@L.params` blocks.
+
+Part of the [laco](https://github.com/khwstolle/laco) project — see the [root README](../../README.md) for an overview.
+
+## Installation
+
+```bash
+pip install laco-typer
+```
+
+## Features
+
+`make_app()`, `register()`
+
+## Usage
+
+See [`docs/index.md`](docs/index.md) for the full guide.

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

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

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,2 @@
+laco>=1.0.0
+typer>=0.12

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

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

laco_typer-1.0.0/tests/test_laco_typer.py

@@ -0,0 +1,77 @@
+"""Tests for laco-typer."""
+
+import inspect
+
+
+def test_import():
+    import laco.integrations.typer  # noqa: F401
+
+
+def test_public_api():
+    import laco.integrations.typer as laco_typer
+
+    assert set(laco_typer.__all__) == {"make_app", "register"}
+
+
+def test_make_app_signature():
+    import laco.integrations.typer as laco_typer
+
+    sig = inspect.signature(laco_typer.make_app)
+    params = list(sig.parameters)
+
+    assert "config_path" in params
+    assert "callback" in params
+    assert "name" in params
+
+
+def test_register_signature():
+    import laco.integrations.typer as laco_typer
+
+    sig = inspect.signature(laco_typer.register)
+    params = list(sig.parameters)
+
+    assert "app" in params
+    assert "config_path" in params
+    assert "callback" in params
+    assert "name" in params
+
+
+def test_make_app_with_mock_laco(tmp_path):
+    from unittest.mock import MagicMock, patch
+
+    import laco.integrations.typer as laco_typer
+
+    config_file = tmp_path / "config.py"
+    config_file.write_text("lr = 1e-3\n")
+    callback = MagicMock()
+
+    mock_cfg = MagicMock()
+    mock_nsp = {}
+
+    with patch("laco._io._load_with_namespace", return_value=(mock_cfg, mock_nsp)):
+        import typer
+
+        app = laco_typer.make_app(str(config_file), callback)
+        assert isinstance(app, typer.Typer)
+
+
+def test_register_with_mock_laco(tmp_path):
+    from unittest.mock import MagicMock, patch
+
+    import laco.integrations.typer as laco_typer
+    import typer
+
+    config_file = tmp_path / "config.py"
+    config_file.write_text("lr = 1e-3\n")
+    callback = MagicMock()
+    callback.__name__ = "train"
+    callback.__doc__ = "Train the model."
+
+    root = typer.Typer()
+    mock_cfg = MagicMock()
+    mock_nsp = {}
+
+    with patch("laco._io._load_with_namespace", return_value=(mock_cfg, mock_nsp)):
+        laco_typer.register(root, str(config_file), callback)
+
+    assert len(root.registered_commands) == 1