pragmatiks-cli 0.5.1__py3-none-any.whl

pragma_cli/commands/resources.py

@@ -0,0 +1,199 @@
+"""CLI commands for resource management with lifecycle operations."""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from typing import Annotated
+
+import typer
+import yaml
+from rich import print
+from rich.console import Console
+from rich.markup import escape
+
+from pragma_cli import get_client
+from pragma_cli.commands.completions import (
+    completion_resource_ids,
+    completion_resource_names,
+)
+from pragma_cli.helpers import parse_resource_id
+
+
+console = Console()
+app = typer.Typer()
+
+
+def resolve_file_references(resource: dict, base_dir: Path) -> dict:
+    """Resolve file references in secret resource config.
+
+    For pragma/secret resources, scans config.data values for '@' prefix
+    and replaces them with the file contents.
+
+    Args:
+        resource: Resource dictionary from YAML.
+        base_dir: Base directory for resolving relative paths.
+
+    Returns:
+        Resource dictionary with file references resolved.
+
+    Raises:
+        typer.Exit: If a referenced file is not found.
+    """
+    is_secret = resource.get("provider") == "pragma" and resource.get("resource") == "secret"
+    if not is_secret:
+        return resource
+
+    config = resource.get("config")
+    if not config or not isinstance(config, dict):
+        return resource
+
+    data = config.get("data")
+    if not data or not isinstance(data, dict):
+        return resource
+
+    resolved_data = {}
+    for key, value in data.items():
+        if isinstance(value, str) and value.startswith("@"):
+            file_path = Path(value[1:])
+            if not file_path.is_absolute():
+                file_path = base_dir / file_path
+
+            if not file_path.exists():
+                console.print(f"[red]Error:[/red] File not found: {file_path}")
+                raise typer.Exit(1)
+
+            try:
+                resolved_data[key] = file_path.read_text()
+            except OSError as e:
+                console.print(f"[red]Error:[/red] Cannot read file {file_path}: {e}")
+                raise typer.Exit(1)
+        else:
+            resolved_data[key] = value
+
+    resolved_resource = resource.copy()
+    resolved_resource["config"] = {**config, "data": resolved_data}
+    return resolved_resource
+
+
+def format_state(state: str) -> str:
+    """Format lifecycle state for display, escaping Rich markup.
+
+    Returns:
+        State string wrapped in brackets and escaped for Rich console.
+    """
+    return escape(f"[{state}]")
+
+
+@app.command("list")
+def list_resources(
+    provider: Annotated[str | None, typer.Option("--provider", "-p", help="Filter by provider")] = None,
+    resource: Annotated[str | None, typer.Option("--resource", "-r", help="Filter by resource type")] = None,
+    tags: Annotated[list[str] | None, typer.Option("--tag", "-t", help="Filter by tags")] = None,
+):
+    """List resources, optionally filtered by provider, resource type, or tags."""
+    client = get_client()
+    for res in client.list_resources(provider=provider, resource=resource, tags=tags):
+        print(f"{res['provider']}/{res['resource']}/{res['name']} {format_state(res['lifecycle_state'])}")
+
+
+@app.command()
+def get(
+    resource_id: Annotated[str, typer.Argument(autocompletion=completion_resource_ids)],
+    name: Annotated[str | None, typer.Argument(autocompletion=completion_resource_names)] = None,
+):
+    """Get resources by provider/resource type, optionally filtered by name."""
+    client = get_client()
+    provider, resource = parse_resource_id(resource_id)
+    if name:
+        res = client.get_resource(provider=provider, resource=resource, name=name)
+        print(f"{resource_id}/{res['name']} {format_state(res['lifecycle_state'])}")
+    else:
+        for res in client.list_resources(provider=provider, resource=resource):
+            print(f"{resource_id}/{res['name']} {format_state(res['lifecycle_state'])}")
+
+
+@app.command()
+def apply(
+    file: list[typer.FileText],
+    pending: Annotated[
+        bool, typer.Option("--pending", "-p", help="Queue for processing (set lifecycle_state to PENDING)")
+    ] = False,
+):
+    """Apply resources from YAML files (multi-document supported).
+
+    By default, resources are created in DRAFT state (not processed).
+    Use --pending to queue for immediate processing.
+
+    For pragma/secret resources, file references in config.data values
+    are resolved before submission. Use '@path/to/file' syntax to inline
+    file contents.
+    """
+    client = get_client()
+    for f in file:
+        base_dir = Path(f.name).parent
+        resources = yaml.safe_load_all(f.read())
+
+        for resource in resources:
+            resource = resolve_file_references(resource, base_dir)
+            if pending:
+                resource["lifecycle_state"] = "pending"
+            result = client.apply_resource(resource=resource)
+            res_id = f"{result['provider']}/{result['resource']}/{result['name']}"
+            print(f"Applied {res_id} {format_state(result['lifecycle_state'])}")
+
+
+@app.command()
+def delete(
+    resource_id: Annotated[str, typer.Argument(autocompletion=completion_resource_ids)],
+    name: Annotated[str, typer.Argument(autocompletion=completion_resource_names)],
+):
+    """Delete a resource."""
+    client = get_client()
+    provider, resource = parse_resource_id(resource_id)
+    client.delete_resource(provider=provider, resource=resource, name=name)
+    print(f"Deleted {resource_id}/{name}")
+
+
+@app.command()
+def register(
+    resource_id: Annotated[str, typer.Argument(help="Resource type in provider/resource format")],
+    description: Annotated[str | None, typer.Option("--description", "-d", help="Resource type description")] = None,
+    schema_file: Annotated[typer.FileText | None, typer.Option("--schema", "-s", help="JSON schema file")] = None,
+    tags: Annotated[list[str] | None, typer.Option("--tag", "-t", help="Tags for categorization")] = None,
+):
+    """Register a new resource type.
+
+    Registers a resource type so that resources of this type can be created.
+    Providers use this to declare what resources they can manage.
+    """
+    client = get_client()
+    provider, resource = parse_resource_id(resource_id)
+
+    schema = None
+    if schema_file:
+        schema = json.load(schema_file)
+
+    client.register_resource(
+        provider=provider,
+        resource=resource,
+        schema=schema,
+        description=description,
+        tags=tags,
+    )
+    print(f"Registered {resource_id}")
+
+
+@app.command()
+def unregister(
+    resource_id: Annotated[str, typer.Argument(autocompletion=completion_resource_ids)],
+):
+    """Unregister a resource type.
+
+    Removes a resource type registration. Existing resources of this type
+    will no longer be manageable.
+    """
+    client = get_client()
+    provider, resource = parse_resource_id(resource_id)
+    client.unregister_resource(provider=provider, resource=resource)
+    print(f"Unregistered {resource_id}")

pragma_cli/config.py

@@ -0,0 +1,86 @@
+"""CLI configuration management for contexts and credentials."""
+
+from __future__ import annotations
+
+import os
+from pathlib import Path
+
+import yaml
+from pydantic import BaseModel
+
+
+def _get_config_dir() -> Path:
+    """Get the configuration directory following XDG Base Directory specification.
+
+    Returns:
+        Path to configuration directory (~/.config/pragma by default).
+    """
+    xdg_config_home = os.getenv("XDG_CONFIG_HOME")
+    if xdg_config_home:
+        return Path(xdg_config_home) / "pragma"
+    return Path.home() / ".config" / "pragma"
+
+
+CONFIG_DIR = _get_config_dir()
+CONFIG_PATH = CONFIG_DIR / "config"
+CREDENTIALS_FILE = CONFIG_DIR / "credentials"
+
+
+class ContextConfig(BaseModel):
+    """Configuration for a single CLI context."""
+
+    api_url: str
+
+
+class PragmaConfig(BaseModel):
+    """CLI configuration with multiple named contexts."""
+
+    current_context: str
+    contexts: dict[str, ContextConfig]
+
+
+def load_config() -> PragmaConfig:
+    """Load config from ~/.config/pragma/config.
+
+    Returns:
+        PragmaConfig with contexts loaded from file, or default if not found.
+    """
+    if not CONFIG_PATH.exists():
+        return PragmaConfig(
+            current_context="default", contexts={"default": ContextConfig(api_url="https://api.pragmatiks.io")}
+        )
+
+    with open(CONFIG_PATH) as f:
+        data = yaml.safe_load(f)
+        return PragmaConfig.model_validate(data)
+
+
+def save_config(config: PragmaConfig):
+    """Save config to ~/.config/pragma/config."""
+    CONFIG_PATH.parent.mkdir(parents=True, exist_ok=True)
+    with open(CONFIG_PATH, "w") as f:
+        yaml.safe_dump(config.model_dump(), f)
+    CONFIG_PATH.chmod(0o644)
+
+
+def get_current_context(context_name: str | None = None) -> tuple[str, ContextConfig]:
+    """Get context name and configuration.
+
+    Args:
+        context_name: Explicit context name. If None, uses current context from config.
+
+    Returns:
+        Tuple of (context_name, context_config).
+
+    Raises:
+        ValueError: If context not found in configuration.
+    """
+    config = load_config()
+
+    if context_name is None:
+        context_name = config.current_context
+
+    if context_name not in config.contexts:
+        raise ValueError(f"Context '{context_name}' not found in configuration")
+
+    return context_name, config.contexts[context_name]

pragma_cli/helpers.py

@@ -0,0 +1,21 @@
+"""CLI helper functions for parsing resource identifiers."""
+
+from __future__ import annotations
+
+
+def parse_resource_id(resource_id: str) -> tuple[str, str]:
+    """Parse resource identifier into provider and resource type.
+
+    Args:
+        resource_id: Resource identifier in format 'provider/resource'.
+
+    Returns:
+        Tuple of (provider, resource).
+
+    Raises:
+        ValueError: If resource_id format is invalid.
+    """
+    if "/" not in resource_id:
+        raise ValueError(f"Invalid resource ID format: {resource_id}. Expected 'provider/resource'.")
+    provider, resource = resource_id.split("/", 1)
+    return provider, resource

pragma_cli/main.py

@@ -0,0 +1,67 @@
+"""CLI entry point with Typer application setup and command routing."""
+
+from typing import Annotated
+
+import typer
+from pragma_sdk import PragmaClient
+
+from pragma_cli import set_client
+from pragma_cli.commands import auth, config, ops, provider, resources
+from pragma_cli.config import get_current_context
+
+
+app = typer.Typer()
+
+
+@app.callback()
+def main(
+    ctx: typer.Context,
+    context: Annotated[
+        str | None,
+        typer.Option(
+            "--context",
+            "-c",
+            help="Configuration context to use",
+            envvar="PRAGMA_CONTEXT",
+        ),
+    ] = None,
+    token: Annotated[
+        str | None,
+        typer.Option(
+            "--token",
+            "-t",
+            help="Override authentication token (not recommended, use environment variable instead)",
+        ),
+    ] = None,
+):
+    """Pragma CLI - Declarative resource management.
+
+    Authentication (industry-standard pattern):
+      - CLI writes credentials: 'pragma login' stores tokens in ~/.config/pragma/credentials
+      - SDK reads credentials: Automatic token discovery via precedence chain
+
+    Token Discovery Precedence:
+      1. --token flag (explicit override)
+      2. PRAGMA_AUTH_TOKEN_<CONTEXT> context-specific environment variable
+      3. PRAGMA_AUTH_TOKEN environment variable
+      4. ~/.config/pragma/credentials file (from pragma login)
+      5. No authentication
+    """
+    context_name, context_config = get_current_context(context)
+
+    if token:
+        client = PragmaClient(base_url=context_config.api_url, auth_token=token)
+    else:
+        client = PragmaClient(base_url=context_config.api_url, context=context_name, require_auth=False)
+
+    set_client(client)
+
+
+app.add_typer(resources.app, name="resources")
+app.add_typer(auth.app, name="auth")
+app.add_typer(config.app, name="config")
+app.add_typer(ops.app, name="ops")
+app.add_typer(provider.app, name="provider")
+
+if __name__ == "__main__":  # pragma: no cover
+    app()

pragmatiks_cli-0.5.1.dist-info/METADATA

@@ -0,0 +1,199 @@
+Metadata-Version: 2.3
+Name: pragmatiks-cli
+Version: 0.5.1
+Summary: Command-line interface for Pragmatiks
+Requires-Dist: typer>=0.15.3
+Requires-Dist: pragmatiks-sdk>=0.6.0
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: copier>=9.0.0
+Requires-Dist: rich>=13.9.0
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+# Pragmatiks CLI
+
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/pragmatiks/cli)
+[![PyPI version](https://img.shields.io/pypi/v/pragmatiks-cli.svg)](https://pypi.org/project/pragmatiks-cli/)
+[![Python 3.13+](https://img.shields.io/badge/python-3.13+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
+
+**[Documentation](https://docs.pragmatiks.io/cli/overview)** | **[SDK](https://github.com/pragmatiks/sdk)** | **[Providers](https://github.com/pragmatiks/providers)**
+
+Command-line interface for managing Pragmatiks resources.
+
+<!-- TODO: Add logo and demo GIF -->
+
+## Quick Start
+
+```bash
+# Authenticate
+pragma auth login
+
+# Apply a resource
+pragma resources apply bucket.yaml
+
+# Check status
+pragma resources get gcp/storage my-bucket
+```
+
+## Installation
+
+```bash
+pip install pragmatiks-cli
+```
+
+Or with uv:
+
+```bash
+uv add pragmatiks-cli
+```
+
+Enable shell completion for intelligent command-line assistance:
+
+```bash
+pragma --install-completion
+```
+
+## Features
+
+- **Declarative Resources** - Apply, get, and delete resources with YAML manifests
+- **Smart Completion** - Tab completion for providers, resources, and names
+- **Provider Development** - Initialize, sync, and deploy custom providers
+- **Multi-document Support** - Apply multiple resources from a single YAML file
+
+## Resource Management
+
+### Apply Resources
+
+```yaml
+# bucket.yaml
+provider: gcp
+resource: storage
+name: my-bucket
+config:
+  location: US
+  storage_class: STANDARD
+```
+
+```bash
+# Apply from file
+pragma resources apply bucket.yaml
+
+# Apply multiple files
+pragma resources apply *.yaml
+
+# Apply with pending flag to execute immediately
+pragma resources apply --pending bucket.yaml
+```
+
+### List and Get Resources
+
+```bash
+# List all resources
+pragma resources list
+
+# Filter by provider
+pragma resources list --provider gcp
+
+# Filter by resource type
+pragma resources list --resource storage
+
+# Get specific resource
+pragma resources get gcp/storage my-bucket
+```
+
+### Delete Resources
+
+```bash
+pragma resources delete gcp/storage my-bucket
+```
+
+## Provider Development
+
+Build and deploy custom providers:
+
+```bash
+# Initialize a new provider project
+pragma provider init mycompany
+
+# Sync resource schemas with the platform
+pragma provider sync
+
+# Build and deploy
+pragma provider push --deploy
+```
+
+## Authentication
+
+```bash
+# Login (opens browser)
+pragma auth login
+
+# Check current user
+pragma auth whoami
+
+# Logout
+pragma auth logout
+```
+
+## Configuration
+
+Set environment variables to configure the CLI:
+
+```bash
+export PRAGMA_API_URL=https://api.pragmatiks.io
+export PRAGMA_AUTH_TOKEN=sk_...
+```
+
+## Command Reference
+
+### Resources
+
+| Command | Description |
+|---------|-------------|
+| `pragma resources list` | List resources with optional filters |
+| `pragma resources get <provider/resource> <name>` | Get a specific resource |
+| `pragma resources apply <file>` | Apply resources from YAML |
+| `pragma resources delete <provider/resource> <name>` | Delete a resource |
+
+### Providers
+
+| Command | Description |
+|---------|-------------|
+| `pragma provider init <name>` | Initialize a new provider project |
+| `pragma provider sync` | Sync resource schemas with platform |
+| `pragma provider push` | Build and push provider image |
+| `pragma provider push --deploy` | Build, push, and deploy |
+
+### Authentication
+
+| Command | Description |
+|---------|-------------|
+| `pragma auth login` | Authenticate with the platform |
+| `pragma auth whoami` | Show current user |
+| `pragma auth logout` | Clear credentials |
+
+### Operations
+
+| Command | Description |
+|---------|-------------|
+| `pragma ops dead-letter list` | List failed events |
+| `pragma ops dead-letter retry <id>` | Retry a failed event |
+
+## Development
+
+```bash
+# Run tests
+task cli:test
+
+# Format code
+task cli:format
+
+# Type check and lint
+task cli:check
+```
+
+## License
+
+MIT

pragmatiks_cli-0.5.1.dist-info/RECORD

@@ -0,0 +1,17 @@
+pragma_cli/__init__.py,sha256=9REbOdKs9CeuOd-rxeFs17gWtou1dUdCogYU8G5Cz6c,682
+pragma_cli/commands/__init__.py,sha256=zltFPaCZgkeTdOH1YWrUEqqBF9Dg6tokgAFcmqP4_n4,24
+pragma_cli/commands/auth.py,sha256=6VqLTD8sZ7LRmI8RXEkSze1Ctnq5oM_1Zv0Br-HuFIA,8198
+pragma_cli/commands/completions.py,sha256=ZCW38A1-6l_IcGC7Gj2CP5VL6PzaY4zKdcxylDuCoWM,1609
+pragma_cli/commands/config.py,sha256=Bow71Tg_zeprHlbn_6y8g2YsV_k9nRobA6ooYfaxtWE,2281
+pragma_cli/commands/dead_letter.py,sha256=8Mh_QVZiwkbOA1fYkw1O9BeHgPdqepis6tSJOAY3vhA,6754
+pragma_cli/commands/ops.py,sha256=ztx0Gx2L2mEqJQpbgDHgfOUZ4uaD132NxgKohaPOWv8,361
+pragma_cli/commands/provider.py,sha256=BX1NqGbH9XOrYFrWb92UpZhjTJA5qJ_U6cppMB1_lq0,36271
+pragma_cli/commands/resources.py,sha256=BzwFKK5vqDo37wUPwRkulKdC4TFEJEoSXLlzsxQFD6w,6904
+pragma_cli/config.py,sha256=kcU4tJUV1DfnXC_ydQbgQoJzjdGB1s-6-7g4cwA1nZw,2340
+pragma_cli/helpers.py,sha256=dVxokT-sqF08oY0O35QZ64QyNC0PHZEBJYTvZ726UtI,650
+pragma_cli/main.py,sha256=3UAKMsgc5u2v55ykWy-o_XC5W2CwyDNGfTSFhSvsLfU,1970
+pragma_cli/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pragmatiks_cli-0.5.1.dist-info/WHEEL,sha256=XjEbIc5-wIORjWaafhI6vBtlxDBp7S9KiujWF1EM7Ak,79
+pragmatiks_cli-0.5.1.dist-info/entry_points.txt,sha256=9xeQQlnHxq94dks6mlJ2I9LuMUKmqxuJzyKSZCb9iJM,48
+pragmatiks_cli-0.5.1.dist-info/METADATA,sha256=N3AEoBl0p7bLIpxYtZtI7mltnY4xdKVHnO9iSIg4njs,4400
+pragmatiks_cli-0.5.1.dist-info/RECORD,,

pragmatiks_cli-0.5.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.9.25
+Root-Is-Purelib: true
+Tag: py3-none-any

pragmatiks_cli-0.5.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+pragma = pragma_cli.main:app
+