aegis-stack 0.2.0rc2__py3-none-any.whl

aegis/__init__.py

@@ -0,0 +1,5 @@
+"""
+Aegis Stack CLI - Component generation and project management tools.
+"""
+
+__version__ = "0.2.0rc2"

aegis/__main__.py

@@ -0,0 +1,51 @@
+#!/usr/bin/env python3
+"""
+Aegis Stack CLI - Main entry point
+
+Usage:
+    aegis init PROJECT_NAME
+    aegis components
+    aegis --help
+"""
+
+import typer
+
+from .commands.add import add_command
+from .commands.add_service import add_service_command
+from .commands.components import components_command
+from .commands.init import init_command
+from .commands.remove import remove_command
+from .commands.services import services_command
+from .commands.update import update_command
+from .commands.version import version_command
+
+# Create the main Typer application
+app = typer.Typer(
+    name="aegis",
+    help=(
+        "🛡️ Aegis Stack - Production-ready Python foundation\n\n"
+        "Quick start: uvx aegis-stack init my-project\n\n"
+        "Available components: redis, worker, scheduler, scheduler[sqlite], database\n"
+        "Backend selection: Use --backend flag or bracket syntax (sqlite only)"
+    ),
+    epilog=(
+        "💡 Try it instantly: uvx aegis-stack init my-project\n"
+        "📚 More info: https://lbedner.github.io/aegis-stack/"
+    ),
+    add_completion=False,
+)
+
+# Register commands
+app.command(name="version")(version_command)
+app.command(name="components")(components_command)
+app.command(name="services")(services_command)
+app.command(name="init")(init_command)
+app.command(name="add")(add_command)
+app.command(name="add-service")(add_service_command)
+app.command(name="remove")(remove_command)
+app.command(name="update")(update_command)
+
+
+# This is what runs when you do: aegis
+if __name__ == "__main__":
+    app()

aegis/cli/__init__.py

@@ -0,0 +1,6 @@
+"""
+CLI helper utilities for Aegis Stack.
+
+This module contains validation functions, callbacks, and interactive
+components used by CLI commands.
+"""

aegis/cli/callbacks.py

@@ -0,0 +1,114 @@
+"""
+Typer callback functions for CLI options.
+
+This module contains callback functions used to validate and process
+CLI options before command execution.
+"""
+
+import typer
+
+from ..core.component_utils import (
+    clean_component_names,
+    restore_engine_info,
+)
+from ..core.dependency_resolver import DependencyResolver
+from ..core.service_resolver import ServiceResolver
+from ..core.services import SERVICES
+from .utils import expand_scheduler_dependencies
+
+
+def validate_and_resolve_components(
+    ctx: typer.Context, param: typer.CallbackParam, value: str | None
+) -> list[str] | None:
+    """Validate and resolve component dependencies."""
+    if not value:
+        return None
+
+    # Skip validation during help generation, but not for tests
+    # Mock objects don't have a real resilient_parsing attribute set to True
+    if hasattr(ctx, "resilient_parsing") and ctx.resilient_parsing is True:
+        return None
+
+    # Parse comma-separated string
+    components_raw = [c.strip() for c in value.split(",")]
+
+    # Check for empty components before filtering
+    if any(not c for c in components_raw):
+        typer.echo("❌ Empty component name is not allowed", err=True)
+        raise typer.Exit(1)
+
+    selected = [c for c in components_raw if c]
+
+    # Expand scheduler[backend] dependencies first
+    selected = expand_scheduler_dependencies(selected)
+
+    # Validate components exist (use clean names for validation)
+    clean_selected = clean_component_names(selected)
+    errors = DependencyResolver.validate_components(clean_selected)
+    if errors:
+        for error in errors:
+            typer.echo(f"❌ {error}", err=True)
+        raise typer.Exit(1)
+
+    # Resolve dependencies (using clean names)
+    resolved_clean = DependencyResolver.resolve_dependencies(clean_selected)
+
+    # Restore engine info to resolved components
+    resolved = restore_engine_info(resolved_clean, selected)
+
+    # Show dependency resolution (use clean names for dependency calculation)
+    original_clean = clean_component_names(selected)
+    auto_added = DependencyResolver.get_missing_dependencies(original_clean)
+    if auto_added:
+        typer.echo(f"📦 Auto-added dependencies: {', '.join(auto_added)}")
+
+    # Show recommendations
+    recommendations = DependencyResolver.get_recommendations(resolved_clean)
+    if recommendations:
+        rec_list = ", ".join(recommendations)
+        typer.echo(f"💡 Recommended: {rec_list}")
+        # Note: Skip interactive recommendations for now to keep it simple
+
+    return resolved
+
+
+def validate_and_resolve_services(
+    ctx: typer.Context, param: typer.CallbackParam, value: str | None
+) -> list[str] | None:
+    """Validate and resolve service dependencies to components."""
+    if not value:
+        return None
+
+    # Skip validation during help generation, but not for tests
+    # Mock objects don't have a real resilient_parsing attribute set to True
+    if hasattr(ctx, "resilient_parsing") and ctx.resilient_parsing is True:
+        return None
+
+    # Parse comma-separated string
+    services_raw = [s.strip() for s in value.split(",")]
+
+    # Check for empty services before filtering
+    if any(not s for s in services_raw):
+        typer.echo("❌ Empty service name is not allowed", err=True)
+        raise typer.Exit(1)
+
+    selected_services = [s for s in services_raw if s]
+
+    # Validate services exist
+    unknown_services = [s for s in selected_services if s not in SERVICES]
+    if unknown_services:
+        typer.echo(f"❌ Unknown services: {', '.join(unknown_services)}", err=True)
+        available = list(SERVICES.keys())
+        typer.echo(f"Available services: {', '.join(available)}", err=True)
+        raise typer.Exit(1)
+
+    # Resolve services to components
+    resolved_components, service_added = ServiceResolver.resolve_service_dependencies(
+        selected_services
+    )
+
+    # Show what components were added by services
+    if service_added:
+        typer.echo(f"📦 Services require components: {', '.join(service_added)}")
+
+    return selected_services