pragmatiks-cli 0.9.3__tar.gz

pragmatiks_cli-0.9.3/PKG-INFO

@@ -0,0 +1,201 @@
+Metadata-Version: 2.3
+Name: pragmatiks-cli
+Version: 0.9.3
+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
+
+<p align="center">
+  <img src="assets/wordmark.png" alt="Pragma-OS" width="800">
+</p>
+
+# Pragma CLI
+
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/pragmatiks/pragma-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/pragma-sdk)** | **[Providers](https://github.com/pragmatiks/pragma-providers)**
+
+Command-line interface for managing pragma-os resources.
+
+## 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.9.3/README.md

@@ -0,0 +1,189 @@
+<p align="center">
+  <img src="assets/wordmark.png" alt="Pragma-OS" width="800">
+</p>
+
+# Pragma CLI
+
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/pragmatiks/pragma-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/pragma-sdk)** | **[Providers](https://github.com/pragmatiks/pragma-providers)**
+
+Command-line interface for managing pragma-os resources.
+
+## 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.9.3/pyproject.toml

@@ -0,0 +1,64 @@
+[project]
+name = "pragmatiks-cli"
+version = "0.9.3"
+description = "Command-line interface for Pragmatiks"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "typer>=0.15.3",
+    "pragmatiks-sdk>=0.6.0",
+    "pyyaml>=6.0.3",
+    "copier>=9.0.0",
+    "rich>=13.9.0",
+]
+
+[project.scripts]
+pragma = "pragma_cli.main:app"
+
+[tool.uv.sources]
+# In workspace: resolved from local packages/sdk
+# Standalone: falls back to PyPI (pragmatiks-sdk)
+pragmatiks-sdk = { workspace = true }
+
+[tool.ruff]
+target-version = "py313"
+line-length = 120
+
+[tool.ruff.lint]
+preview = true
+select = ["E", "W", "F", "I", "UP", "D", "DOC", "PT"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.isort]
+lines-after-imports = 2
+known-first-party = ["pragma_cli"]
+
+[tool.ruff.lint.per-file-ignores]
+"**/tests/**/*.py" = ["D100", "D101", "D102", "D103", "D104", "D107", "DOC"]
+
+[tool.ruff.format]
+preview = true
+
+[tool.pytest.ini_options]
+addopts = ["-v"]
+
+[tool.commitizen]
+name = "cz_conventional_commits"
+version = "0.9.3"
+version_files = ["pyproject.toml:^version"]
+tag_format = "v$version"
+update_changelog_on_bump = true
+changelog_file = "CHANGELOG.md"
+
+[dependency-groups]
+test = ["pytest>=8.4.1", "pytest-cov>=7.0.0", "pytest-mock>=3.14.0"]
+dev = ["commitizen>=4.11.0", "pre-commit>=4.0.0", "ruff>=0.11.0"]
+
+[tool.uv.build-backend]
+module-name = "pragma_cli"
+
+[build-system]
+requires = ["uv_build>=0.9.8"]
+build-backend = "uv_build"

pragmatiks_cli-0.9.3/src/pragma_cli/__init__.py

@@ -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

pragmatiks_cli-0.9.3/src/pragma_cli/commands/__init__.py

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