PyPI - pragmatiks-cli - Versions diffs - 0.5.1__py3-none-any.whl - Mend

pragmatiks-cli 0.5.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (17) hide show

pragma_cli/__init__.py +32 -0
pragma_cli/commands/__init__.py +1 -0
pragma_cli/commands/auth.py +247 -0
pragma_cli/commands/completions.py +54 -0
pragma_cli/commands/config.py +79 -0
pragma_cli/commands/dead_letter.py +233 -0
pragma_cli/commands/ops.py +14 -0
pragma_cli/commands/provider.py +1165 -0
pragma_cli/commands/resources.py +199 -0
pragma_cli/config.py +86 -0
pragma_cli/helpers.py +21 -0
pragma_cli/main.py +67 -0
pragma_cli/py.typed +0 -0
pragmatiks_cli-0.5.1.dist-info/METADATA +199 -0
pragmatiks_cli-0.5.1.dist-info/RECORD +17 -0
pragmatiks_cli-0.5.1.dist-info/WHEEL +4 -0
pragmatiks_cli-0.5.1.dist-info/entry_points.txt +3 -0

pragma_cli/__init__.py ADDED Viewed

@@ -0,0 +1,32 @@
+"""CLI global client management."""
+from __future__ import annotations
+from pragma_sdk import PragmaClient
+_client: PragmaClient | None = None
+def get_client() -> PragmaClient:
+    """Get the initialized client.
+    Returns:
+        Initialized PragmaClient instance.
+    Raises:
+        RuntimeError: If client has not been initialized via main().
+    """
+    if _client is None:
+        raise RuntimeError("Client not initialized. This should not happen.")
+    return _client
+def set_client(client: PragmaClient):
+    """Set the global client instance.
+    Args:
+        client: The PragmaClient instance to use globally
+    """
+    global _client
+    _client = client

pragma_cli/commands/__init__.py ADDED Viewed

	@@ -0,0 +1 @@
1	+ """Commands package."""

pragma_cli/commands/auth.py ADDED Viewed

@@ -0,0 +1,247 @@
+"""Authentication commands for browser-based Clerk login."""
+import os
+import webbrowser
+from http.server import BaseHTTPRequestHandler, HTTPServer
+from urllib.parse import parse_qs, urlparse
+import typer
+from pragma_sdk.config import load_credentials
+from rich import print
+from pragma_cli.config import CREDENTIALS_FILE, get_current_context, load_config
+app = typer.Typer()
+CALLBACK_PORT = int(os.getenv("PRAGMA_AUTH_CALLBACK_PORT", "8765"))
+CALLBACK_PATH = os.getenv("PRAGMA_AUTH_CALLBACK_PATH", "/auth/callback")
+CLERK_FRONTEND_URL = os.getenv("PRAGMA_CLERK_FRONTEND_URL", "https://app.pragmatiks.io")
+CALLBACK_URL = f"http://localhost:{CALLBACK_PORT}{CALLBACK_PATH}"
+LOGIN_URL = f"{CLERK_FRONTEND_URL}/auth/callback?callback={CALLBACK_URL}"
+class CallbackHandler(BaseHTTPRequestHandler):
+    """HTTP handler for OAuth callback from Clerk."""
+    token = None
+    def do_GET(self):
+        """Handle GET request from Clerk redirect."""
+        parsed = urlparse(self.path)
+        if parsed.path == CALLBACK_PATH:
+            params = parse_qs(parsed.query)
+            token = params.get("token", [None])[0]
+            if token:
+                CallbackHandler.token = token
+                self.send_response(200)
+                self.send_header("Content-type", "text/html")
+                self.end_headers()
+                self.wfile.write(
+                    b"""
+                    <html>
+                        <body style="font-family: sans-serif; text-align: center; padding: 50px;">
+                            <h1 style="color: green;">&#10003; Authentication Successful</h1>
+                            <p>You can close this window and return to the terminal.</p>
+                        </body>
+                    </html>
+                """
+                )
+            else:
+                self.send_response(400)
+                self.send_header("Content-type", "text/html")
+                self.end_headers()
+                self.wfile.write(
+                    b"""
+                    <html>
+                        <body style="font-family: sans-serif; text-align: center; padding: 50px;">
+                            <h1 style="color: red;">&#10007; Authentication Failed</h1>
+                            <p>No token received. Please try again.</p>
+                        </body>
+                    </html>
+                """
+                )
+        else:
+            self.send_response(404)
+            self.end_headers()
+    def log_message(self, format, *args):
+        """Suppress server logs."""
+def save_credentials(token: str, context_name: str = "default"):
+    """Save authentication token to local credentials file.
+    Args:
+        token: JWT token from Clerk
+        context_name: Context to associate with this token
+    """
+    CREDENTIALS_FILE.parent.mkdir(parents=True, exist_ok=True)
+    credentials = {}
+    if CREDENTIALS_FILE.exists():
+        with open(CREDENTIALS_FILE) as f:
+            for line in f:
+                line = line.strip()
+                if not line or line.startswith("#"):
+                    continue
+                if "=" in line:
+                    key, value = line.split("=", 1)
+                    credentials[key.strip()] = value.strip()
+    credentials[context_name] = token
+    with open(CREDENTIALS_FILE, "w") as f:
+        for key, value in credentials.items():
+            f.write(f"{key}={value}\n")
+    CREDENTIALS_FILE.chmod(0o600)
+def clear_credentials(context_name: str | None = None):
+    """Clear stored credentials.
+    Args:
+        context_name: Specific context to clear, or None for all
+    """
+    if not CREDENTIALS_FILE.exists():
+        return
+    if context_name is None:
+        CREDENTIALS_FILE.unlink()
+        return
+    credentials = {}
+    with open(CREDENTIALS_FILE) as f:
+        for line in f:
+            line = line.strip()
+            if not line or line.startswith("#"):
+                continue
+            if "=" in line:
+                key, value = line.split("=", 1)
+                credentials[key.strip()] = value.strip()
+    credentials.pop(context_name, None)
+    if credentials:
+        with open(CREDENTIALS_FILE, "w") as f:
+            for key, value in credentials.items():
+                f.write(f"{key}={value}\n")
+        CREDENTIALS_FILE.chmod(0o600)
+    else:
+        CREDENTIALS_FILE.unlink()
+@app.command()
+def login(context: str = typer.Option("default", help="Context to authenticate for")):
+    """Authenticate with Pragma using browser-based Clerk login.
+    Opens your default browser to Clerk authentication page. After successful
+    login, your credentials are stored locally in ~/.config/pragma/credentials.
+    Example:
+        pragma login
+        pragma login --context production
+    Raises:
+        typer.Exit: If context not found or authentication fails/times out.
+    """
+    config = load_config()
+    if context not in config.contexts:
+        print(f"[red]\u2717[/red] Context '{context}' not found")
+        print(f"Available contexts: {', '.join(config.contexts.keys())}")
+        raise typer.Exit(1)
+    api_url = config.contexts[context].api_url
+    print(f"[cyan]Authenticating for context:[/cyan] {context}")
+    print(f"[cyan]API URL:[/cyan] {api_url}")
+    print()
+    server = HTTPServer(("localhost", CALLBACK_PORT), CallbackHandler)
+    print(f"[yellow]Opening browser to:[/yellow] {CLERK_FRONTEND_URL}")
+    print()
+    print("[dim]If browser doesn't open automatically, visit:[/dim]")
+    print(f"[dim]{LOGIN_URL}[/dim]")
+    print()
+    print("[yellow]Waiting for authentication...[/yellow]")
+    webbrowser.open(LOGIN_URL)
+    server.timeout = 300
+    server.handle_request()
+    if CallbackHandler.token:
+        save_credentials(CallbackHandler.token, context)
+        print()
+        print("[green]\u2713 Successfully authenticated![/green]")
+        print(f"[dim]Credentials saved to {CREDENTIALS_FILE}[/dim]")
+        print()
+        print("[bold]You can now use pragma commands:[/bold]")
+        print("  pragma resources list-groups")
+        print("  pragma resources get <resource-id>")
+        print("  pragma resources apply <file.yaml>")
+    else:
+        print()
+        print("[red]\u2717 Authentication failed or timed out[/red]")
+        print("[dim]Please try again[/dim]")
+        raise typer.Exit(1)
+@app.command()
+def logout(
+    context: str | None = typer.Option(None, help="Context to logout from (all if not specified)"),
+    all: bool = typer.Option(False, "--all", help="Logout from all contexts"),
+):
+    """Clear stored authentication credentials.
+    Example:
+        pragma logout                    # Clear current context
+        pragma logout --all              # Clear all contexts
+        pragma logout --context staging  # Clear specific context
+    """
+    if all:
+        clear_credentials(None)
+        print("[green]\u2713[/green] Cleared all credentials")
+    elif context:
+        clear_credentials(context)
+        print(f"[green]\u2713[/green] Cleared credentials for context '{context}'")
+    else:
+        context_name, _ = get_current_context()
+        clear_credentials(context_name)
+        print(f"[green]\u2713[/green] Cleared credentials for current context '{context_name}'")
+@app.command()
+def whoami():
+    """Show current authentication status.
+    Displays which contexts have stored credentials and current authentication state.
+    """
+    config = load_config()
+    current_context_name, _ = get_current_context()
+    print()
+    print("[bold]Authentication Status[/bold]")
+    print()
+    has_any_creds = False
+    for context_name in config.contexts.keys():
+        token = load_credentials(context_name)
+        marker = "[green]*[/green]" if context_name == current_context_name else " "
+        if token:
+            has_any_creds = True
+            print(f"{marker} [cyan]{context_name}[/cyan]: [green]\u2713 Authenticated[/green]")
+        else:
+            print(f"{marker} [cyan]{context_name}[/cyan]: [dim]Not authenticated[/dim]")
+    print()
+    if not has_any_creds:
+        print("[yellow]No stored credentials found[/yellow]")
+        print("[dim]Run 'pragma login' to authenticate[/dim]")

pragma_cli/commands/completions.py ADDED Viewed

@@ -0,0 +1,54 @@
+"""CLI auto-completion functions for resource operations."""
+from __future__ import annotations
+import typer
+from pragma_cli import get_client
+def completion_resource_ids(incomplete: str):
+    """Complete resource identifiers in provider/resource format based on existing resources.
+    Args:
+        incomplete: Partial input to complete against available resource types.
+    Yields:
+        Resource identifiers matching the incomplete input.
+    """
+    client = get_client()
+    try:
+        resources = client.list_resources()
+    except Exception:
+        return
+    seen = set()
+    for res in resources:
+        resource_id = f"{res['provider']}/{res['resource']}"
+        if resource_id not in seen and resource_id.lower().startswith(incomplete.lower()):
+            seen.add(resource_id)
+            yield resource_id
+def completion_resource_names(ctx: typer.Context, incomplete: str):
+    """Complete resource instance names.
+    Args:
+        ctx: Typer context containing parsed parameters including resource_id.
+        incomplete: Partial input to complete.
+    Yields:
+        Resource names matching the incomplete input for the selected resource type.
+    """
+    client = get_client()
+    resource_id = ctx.params.get("resource_id")
+    if not resource_id or "/" not in resource_id:
+        return
+    provider, resource = resource_id.split("/", 1)
+    try:
+        resources = client.list_resources(provider=provider, resource=resource)
+    except Exception:
+        return
+    for res in resources:
+        if res["name"].startswith(incomplete):
+            yield res["name"]

pragma_cli/commands/config.py ADDED Viewed

@@ -0,0 +1,79 @@
+"""Context and configuration management commands."""
+import typer
+from rich import print
+from pragma_cli.config import ContextConfig, get_current_context, load_config, save_config
+app = typer.Typer()
+@app.command()
+def use_context(context_name: str):
+    """Switch to a different context.
+    Raises:
+        typer.Exit: If context not found.
+    """
+    config = load_config()
+    if context_name not in config.contexts:
+        print(f"[red]\u2717[/red] Context '{context_name}' not found")
+        print(f"Available contexts: {', '.join(config.contexts.keys())}")
+        raise typer.Exit(1)
+    config.current_context = context_name
+    save_config(config)
+    print(f"[green]\u2713[/green] Switched to context '{context_name}'")
+@app.command()
+def get_contexts():
+    """List available contexts."""
+    config = load_config()
+    print("\n[bold]Available contexts:[/bold]")
+    for name, ctx in config.contexts.items():
+        marker = "[green]*[/green]" if name == config.current_context else " "
+        print(f"{marker} [cyan]{name}[/cyan]: {ctx.api_url}")
+    print()
+@app.command()
+def current_context():
+    """Show current context."""
+    context_name, context_config = get_current_context()
+    print(f"[bold]Current context:[/bold] [cyan]{context_name}[/cyan]")
+    print(f"[bold]API URL:[/bold] {context_config.api_url}")
+@app.command()
+def set_context(
+    name: str = typer.Argument(..., help="Context name"),
+    api_url: str = typer.Option(..., help="API endpoint URL"),
+):
+    """Create or update a context."""
+    config = load_config()
+    config.contexts[name] = ContextConfig(api_url=api_url)
+    save_config(config)
+    print(f"[green]\u2713[/green] Context '{name}' configured")
+@app.command()
+def delete_context(name: str):
+    """Delete a context.
+    Raises:
+        typer.Exit: If context not found or is current context.
+    """
+    config = load_config()
+    if name not in config.contexts:
+        print(f"[red]\u2717[/red] Context '{name}' not found")
+        raise typer.Exit(1)
+    if name == config.current_context:
+        print("[red]\u2717[/red] Cannot delete current context")
+        raise typer.Exit(1)
+    del config.contexts[name]
+    save_config(config)
+    print(f"[green]\u2713[/green] Context '{name}' deleted")

pragma_cli/commands/dead_letter.py ADDED Viewed

@@ -0,0 +1,233 @@
+"""Dead letter event management commands.
+Commands for listing, inspecting, retrying, and deleting dead letter events
+from the Pragmatiks platform. Dead letter events are failed resource
+operations that exceeded retry attempts.
+"""
+from __future__ import annotations
+import json
+from typing import Annotated
+import httpx
+import typer
+from rich import print
+from rich.console import Console
+from rich.table import Table
+from pragma_cli import get_client
+app = typer.Typer(help="Dead letter event management commands")
+console = Console()
+def truncate(text: str, max_length: int = 50) -> str:
+    """Truncate text to max_length, adding ellipsis if needed.
+    Args:
+        text: Text to truncate.
+        max_length: Maximum length including ellipsis.
+    Returns:
+        Truncated text with ellipsis if exceeded max_length.
+    """
+    if len(text) <= max_length:
+        return text
+    return text[: max_length - 3] + "..."
+@app.command("list")
+def list_events(
+    provider: Annotated[
+        str | None,
+        typer.Option("--provider", "-p", help="Filter by provider name"),
+    ] = None,
+):
+    """List dead letter events.
+    Displays a table of all dead letter events, optionally filtered by provider.
+    The error_message column is truncated to 50 characters for readability.
+    Example:
+        pragma ops dead-letter list
+        pragma ops dead-letter list --provider postgres
+    """
+    client = get_client()
+    events = client.list_dead_letter_events(provider=provider)
+    if not events:
+        print("[dim]No dead letter events found.[/dim]")
+        return
+    table = Table()
+    table.add_column("Event ID", style="cyan")
+    table.add_column("Provider", style="green")
+    table.add_column("Resource Type")
+    table.add_column("Resource Name")
+    table.add_column("Error Message", style="red")
+    table.add_column("Failed At")
+    for event in events:
+        table.add_row(
+            event.get("id", ""),
+            event.get("provider", ""),
+            event.get("resource_type", ""),
+            event.get("resource_name", ""),
+            truncate(event.get("error_message", ""), 50),
+            event.get("failed_at", ""),
+        )
+    console.print(table)
+@app.command()
+def show(
+    event_id: Annotated[str, typer.Argument(help="Dead letter event ID")],
+):
+    """Show detailed information about a dead letter event.
+    Displays the full event data as formatted JSON.
+    Example:
+        pragma ops dead-letter show evt_123abc
+    Raises:
+        typer.Exit: If event not found (code 1).
+    """  # noqa: DOC501
+    client = get_client()
+    try:
+        event = client.get_dead_letter_event(event_id)
+    except httpx.HTTPStatusError as e:
+        if e.response.status_code == 404:
+            print(f"[red]Event not found:[/red] {event_id}")
+            raise typer.Exit(1)
+        raise
+    print(json.dumps(event, indent=2, default=str))
+@app.command()
+def retry(
+    event_id: Annotated[
+        str | None,
+        typer.Argument(help="Dead letter event ID to retry"),
+    ] = None,
+    all_events: Annotated[
+        bool,
+        typer.Option("--all", help="Retry all dead letter events"),
+    ] = False,
+):
+    """Retry dead letter event(s).
+    Retries a single event by ID, or all events with --all flag.
+    The --all flag requires confirmation.
+    Example:
+        pragma ops dead-letter retry evt_123abc
+        pragma ops dead-letter retry --all
+    Raises:
+        typer.Exit: If event not found (code 1) or user cancels (code 0).
+    """  # noqa: DOC501
+    client = get_client()
+    if all_events:
+        events = client.list_dead_letter_events()
+        count = len(events)
+        if count == 0:
+            print("[dim]No dead letter events to retry.[/dim]")
+            return
+        if not typer.confirm(f"Retry {count} event(s)?"):
+            raise typer.Exit(0)
+        retried = client.retry_all_dead_letter_events()
+        print(f"[green]Retried {retried} event(s)[/green]")
+    elif event_id:
+        try:
+            client.retry_dead_letter_event(event_id)
+        except httpx.HTTPStatusError as e:
+            if e.response.status_code == 404:
+                print(f"[red]Event not found:[/red] {event_id}")
+                raise typer.Exit(1)
+            raise
+        print(f"[green]Retried event:[/green] {event_id}")
+    else:
+        print("[red]Error:[/red] Provide an event_id or use --all")
+        raise typer.Exit(1)
+@app.command()
+def delete(
+    event_id: Annotated[
+        str | None,
+        typer.Argument(help="Dead letter event ID to delete"),
+    ] = None,
+    all_events: Annotated[
+        bool,
+        typer.Option("--all", help="Delete all dead letter events"),
+    ] = False,
+    provider: Annotated[
+        str | None,
+        typer.Option("--provider", "-p", help="Delete all events for this provider"),
+    ] = None,
+):
+    """Delete dead letter event(s).
+    Deletes a single event by ID, all events for a provider, or all events.
+    The --all and --provider flags require confirmation.
+    Example:
+        pragma ops dead-letter delete evt_123abc
+        pragma ops dead-letter delete --all
+        pragma ops dead-letter delete --provider postgres
+    Raises:
+        typer.Exit: If event not found (code 1) or user cancels (code 0).
+    """  # noqa: DOC501
+    client = get_client()
+    if all_events:
+        events = client.list_dead_letter_events()
+        count = len(events)
+        if count == 0:
+            print("[dim]No dead letter events to delete.[/dim]")
+            return
+        if not typer.confirm(f"Delete {count} event(s)?"):
+            raise typer.Exit(0)
+        deleted = client.delete_dead_letter_events(all=True)
+        print(f"[green]Deleted {deleted} event(s)[/green]")
+    elif provider:
+        events = client.list_dead_letter_events(provider=provider)
+        count = len(events)
+        if count == 0:
+            print(f"[dim]No dead letter events found for provider '{provider}'.[/dim]")
+            return
+        if not typer.confirm(f"Delete {count} event(s) for provider '{provider}'?"):
+            raise typer.Exit(0)
+        deleted = client.delete_dead_letter_events(provider=provider)
+        print(f"[green]Deleted {deleted} event(s) for provider '{provider}'[/green]")
+    elif event_id:
+        try:
+            client.delete_dead_letter_event(event_id)
+        except httpx.HTTPStatusError as e:
+            if e.response.status_code == 404:
+                print(f"[red]Event not found:[/red] {event_id}")
+                raise typer.Exit(1)
+            raise
+        print(f"[green]Deleted event:[/green] {event_id}")
+    else:
+        print("[red]Error:[/red] Provide an event_id, --provider, or --all")
+        raise typer.Exit(1)

pragma_cli/commands/ops.py ADDED Viewed

@@ -0,0 +1,14 @@
+"""Operational commands for platform administration.
+Commands for managing operational concerns like dead letter events,
+system health, and other administrative tasks.
+"""
+import typer
+from pragma_cli.commands import dead_letter
+app = typer.Typer(help="Operational commands for platform administration")
+app.add_typer(dead_letter.app, name="dead-letter")