hexastack-cli 0.1.0__tar.gz → 0.3.0__tar.gz

{hexastack_cli-0.1.0 → hexastack_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hexastack-cli
-Version: 0.1.0
+Version: 0.3.0
 Summary: Hexastack CLI presentation adapter with Typer and Rich
 Author: Richard West
 Author-email: Richard West <dopplereffect.us@gmail.com>
@@ -43,8 +43,8 @@ Description-Content-Type: text/markdown
 ```
 hexastack_cli/
 ├── domain/          # CliContext, OutputFormat enum
-├── adapters/        # create_cli_app, Rich presenters, Typer command runners
-└── infra/           # CliBootstrapper (order=30), @cli_command, @cli_query, @cli_group, @feature_flag_command
+├── adapters/        # Rich presenters, Typer command runners
+└── infra/           # create_cli_app, CliBootstrapper (order=40), @cli_command, @cli_query, @cli_group, @feature_flag_command
 ```
 
 ### Key Exports

{hexastack_cli-0.1.0 → hexastack_cli-0.3.0}/README.md

@@ -27,8 +27,8 @@
 ```
 hexastack_cli/
 ├── domain/          # CliContext, OutputFormat enum
-├── adapters/        # create_cli_app, Rich presenters, Typer command runners
-└── infra/           # CliBootstrapper (order=30), @cli_command, @cli_query, @cli_group, @feature_flag_command
+├── adapters/        # Rich presenters, Typer command runners
+└── infra/           # create_cli_app, CliBootstrapper (order=40), @cli_command, @cli_query, @cli_group, @feature_flag_command
 ```
 
 ### Key Exports

{hexastack_cli-0.1.0 → hexastack_cli-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "hexastack-cli"
-version = "0.1.0"
+version = "0.3.0"
 description = "Hexastack CLI presentation adapter with Typer and Rich"
 readme = "README.md"
 license = "Apache-2.0"
@@ -34,3 +34,24 @@ workspace = true
 
 [tool.importlinter]
 root_packages = ["hexastack_cli"]
+
+[[tool.importlinter.contracts]]
+name = "Hexagonal architecture layer hierarchy"
+type = "layers"
+containers = ["hexastack_cli"]
+layers = [
+    "infra",
+    "adapters",
+]
+
+[[tool.importlinter.contracts]]
+name = "Forbidden imports for adapters"
+type = "forbidden"
+source_modules = ["hexastack_cli.adapters"]
+forbidden_modules = ["hexastack_cli.testing"]
+
+[[tool.importlinter.contracts]]
+name = "Forbidden imports for infra"
+type = "forbidden"
+source_modules = ["hexastack_cli.infra"]
+forbidden_modules = ["hexastack_cli.testing"]

{hexastack_cli-0.1.0 → hexastack_cli-0.3.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "hexastack-cli"
-version = "0.1.0"
+version = "0.3.0"
 description = "Hexastack CLI presentation adapter with Typer and Rich"
 readme = "README.md"
 license = "Apache-2.0"
@@ -33,3 +33,28 @@ hexastack-cqrs = { workspace = true }
 
 [tool.importlinter]
 root_packages = ["hexastack_cli"]
+
+[[tool.importlinter.contracts]]
+name = "Hexagonal architecture layer hierarchy"
+type = "layers"
+containers = ["hexastack_cli"]
+layers = [
+    "infra",
+    "adapters",
+]
+
+[[tool.importlinter.contracts]]
+name = "Forbidden imports for adapters"
+type = "forbidden"
+source_modules = ["hexastack_cli.adapters"]
+forbidden_modules = [
+    "hexastack_cli.testing",
+]
+
+[[tool.importlinter.contracts]]
+name = "Forbidden imports for infra"
+type = "forbidden"
+source_modules = ["hexastack_cli.infra"]
+forbidden_modules = [
+    "hexastack_cli.testing",
+]

{hexastack_cli-0.1.0 → hexastack_cli-0.3.0}/src/hexastack_cli/adapters/__init__.py

@@ -1,4 +1,3 @@
-from hexastack_cli.adapters.app import create_cli_app
 from hexastack_cli.adapters.presenter import RichTerminalPresenter
 from hexastack_cli.adapters.routing import (
     register_cqrs_command,
@@ -6,7 +5,6 @@ from hexastack_cli.adapters.routing import (
 )
 
 __all__ = [
-    "create_cli_app",
     "register_cqrs_command",
     "register_cqrs_query",
     "RichTerminalPresenter",

{hexastack_cli-0.1.0/src/hexastack_cli/infra → hexastack_cli-0.3.0/src/hexastack_cli/domain}/config.py

@@ -1,10 +1,6 @@
 from pydantic import BaseModel, Field
 
-from hexastack_core.infra.decorators import config_section
-from hexastack_core.infra.registries.config import ConfigRegistry
 
-
-@config_section("cli")
 class HexastackCliConfig(BaseModel):
     """Configuration schema for Hexastack CLI presentation adapter.
 
@@ -24,20 +20,4 @@ class HexastackCliConfig(BaseModel):
 
 __all__ = [
     "HexastackCliConfig",
-    "register_cli_config",
 ]
-
-
-def register_cli_config(registry: ConfigRegistry) -> None:
-    """Register CLI configuration schema with a ConfigRegistry under 'cli'.
-
-    Args:
-        registry: Target ConfigRegistry instance.
-
-    Returns:
-        None.
-
-    Raises:
-        None.
-    """
-    registry.register_config_section("cli", HexastackCliConfig)

{hexastack_cli-0.1.0 → hexastack_cli-0.3.0}/src/hexastack_cli/infra/__init__.py

@@ -1,3 +1,4 @@
+from hexastack_cli.infra.app import create_cli_app
 from hexastack_cli.infra.autodiscovery import (
     autodiscover_cli_commands,
     create_cli_visitor,
@@ -22,6 +23,7 @@ __all__ = [
     "cli_query",
     "CliBootstrapper",
     "CliMetadata",
+    "create_cli_app",
     "create_cli_visitor",
     "GroupMetadata",
     "HexastackCliConfig",

{hexastack_cli-0.1.0/src/hexastack_cli/adapters → hexastack_cli-0.3.0/src/hexastack_cli/infra}/app.py

@@ -51,7 +51,7 @@ def create_cli_app(
     def _version_callback(value: bool) -> None:
         if value:
             active_console.print(f"{cfg.app_name} {cfg.version}")
-            raise typer.Exit()
+            raise typer.Exit
 
     # Establish root callback to enforce multi-command structure and handle --version
     @app.callback()

{hexastack_cli-0.1.0 → hexastack_cli-0.3.0}/src/hexastack_cli/infra/bootstrap.py

@@ -34,7 +34,7 @@ class CliBootstrapper(BootstrapperPort):
         Raises:
             None.
         """
-        from hexastack_cli.adapters.app import create_cli_app
+        from hexastack_cli.infra.app import create_cli_app
         from hexastack_cli.infra.autodiscovery import create_cli_visitor
 
         cfg = HexastackCliConfig()

hexastack_cli-0.3.0/src/hexastack_cli/infra/config.py

@@ -0,0 +1,19 @@
+from hexastack_cli.domain.config import HexastackCliConfig
+from hexastack_core.infra.decorators import config_section
+from hexastack_core.infra.registries.config import ConfigRegistry
+
+config_section("cli")(HexastackCliConfig)
+
+__all__ = [
+    "HexastackCliConfig",
+    "register_cli_config",
+]
+
+
+def register_cli_config(registry: ConfigRegistry) -> None:
+    """Register CLI configuration schema with a ConfigRegistry under 'cli'.
+
+    Args:
+        registry: Target ConfigRegistry instance.
+    """
+    registry.register_config_section("cli", HexastackCliConfig)

{hexastack_cli-0.1.0 → hexastack_cli-0.3.0}/src/hexastack_cli/infra/decorators.py

@@ -1,9 +1,12 @@
 from collections.abc import Callable, Sequence
 from dataclasses import dataclass, field
-from typing import Any, Literal
+from typing import Any, Literal, TypeVar
 
 from hexastack_core.domain import Command, Query
 
+TCommand = TypeVar("TCommand", bound=Command)
+TQuery = TypeVar("TQuery", bound=Query)
+
 _CLI_METADATA_ATTR = "__hexastack_cli__"
 _CLI_GROUP_ATTR = "__hexastack_cli_group__"
 
@@ -58,7 +61,7 @@ def _normalize_tokens(tokens: Sequence[str] | str | None) -> tuple[str, ...]:
     return tuple(str(t).strip() for t in tokens if str(t).strip())
 
 
-def cli_command[TCommand: Command](
+def cli_command(
     name: str | None = None,
     *,
     positional: Sequence[str] | str | None = None,
@@ -129,7 +132,7 @@ def cli_group(
     return decorator
 
 
-def cli_query[TQuery: Query](
+def cli_query(
     name: str | None = None,
     *,
     positional: Sequence[str] | str | None = None,

hexastack_cli-0.3.0/src/hexastack_cli/testing/__init__.py

@@ -0,0 +1,9 @@
+from hexastack_cli.testing.events import TerminalEvent
+from hexastack_cli.testing.narrator import CliNarrator
+from hexastack_cli.testing.terminal import render_cli_demo_video
+
+__all__ = [
+    "CliNarrator",
+    "render_cli_demo_video",
+    "TerminalEvent",
+]

hexastack_cli-0.3.0/src/hexastack_cli/testing/events.py

@@ -0,0 +1,16 @@
+"""Domain models and data contracts for CLI testing and narrative demonstration."""
+
+from dataclasses import dataclass
+
+__all__ = [
+    "TerminalEvent",
+]
+
+
+@dataclass(frozen=True)
+class TerminalEvent:
+    """A discrete timestamped event within a CLI demo recording session."""
+
+    event_type: str  # "step" | "input" | "output"
+    payload: str
+    timestamp: float

{hexastack_cli-0.1.0 → hexastack_cli-0.3.0}/src/hexastack_cli/testing/narrator.py

@@ -4,20 +4,12 @@ from __future__ import annotations
 
 import os
 import time
-from dataclasses import dataclass
 from pathlib import Path
 from typing import Any
 
 from typer.testing import CliRunner, Result
 
-
-@dataclass(frozen=True)
-class TerminalEvent:
-    """A discrete timestamped event within a CLI demo recording session."""
-
-    event_type: str  # "step" | "input" | "output"
-    payload: str
-    timestamp: float
+from hexastack_cli.testing.events import TerminalEvent
 
 
 class CliNarrator:

{hexastack_cli-0.1.0 → hexastack_cli-0.3.0}/src/hexastack_cli/testing/terminal.py

@@ -9,7 +9,7 @@ import re
 import shutil
 from pathlib import Path
 
-from hexastack_cli.testing.narrator import TerminalEvent
+from hexastack_cli.testing.events import TerminalEvent
 from hexastack_core.domain.exceptions import MissingDependencyError
 
 TERMINAL_HTML_TEMPLATE = """<!DOCTYPE html>

hexastack_cli-0.1.0/src/hexastack_cli/testing/__init__.py

@@ -1,7 +0,0 @@
-"""Testing utilities and demo recording engine for CLI applications."""
-
-from hexastack_cli.testing.narrator import CliNarrator
-
-__all__ = [
-    "CliNarrator",
-]