llamactl 0.2.7a1__tar.gz

llamactl-0.2.7a1/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.3
+Name: llamactl
+Version: 0.2.7a1
+Summary: A command-line interface for managing LlamaDeploy projects and deployments
+Author: Adrian Lyjak
+Author-email: Adrian Lyjak <adrianlyjak@gmail.com>
+License: MIT
+Requires-Dist: llama-deploy-core>=0.2.7a1,<0.3.0
+Requires-Dist: llama-deploy-appserver>=0.2.7a1,<0.3.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: click>=8.2.1
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: tenacity>=9.1.2
+Requires-Dist: textual>=4.0.0
+Requires-Dist: aiohttp>=3.12.14
+Requires-Python: >=3.12, <4
+Description-Content-Type: text/markdown
+
+# llamactl
+
+> [!WARNING]
+> This repository contains pre-release software. It is unstable, incomplete, and subject to breaking changes. Not recommended for use.
+
+
+A command-line interface for managing LlamaDeploy projects and deployments.
+
+## Installation
+
+Install from PyPI:
+
+```bash
+pip install llamactl
+```
+
+Or using uv:
+
+```bash
+uv add llamactl
+```
+
+## Quick Start
+
+1. **Configure your profile**: Set up connection to your LlamaDeploy control plane
+   ```bash
+   llamactl profile configure
+   ```
+
+2. **Check health**: Verify connection to the control plane
+   ```bash
+   llamactl health
+   ```
+
+3. **Create a project**: Initialize a new deployment project
+   ```bash
+   llamactl project create my-project
+   ```
+
+4. **Deploy**: Deploy your project to the control plane
+   ```bash
+   llamactl deployment create my-deployment --project-name my-project
+   ```
+
+## Commands
+
+### Profile Management
+- `llamactl profile configure` - Configure connection to control plane
+- `llamactl profile show` - Show current profile configuration
+- `llamactl profile list` - List all configured profiles
+
+### Project Management
+- `llamactl project create <name>` - Create a new project
+- `llamactl project list` - List all projects
+- `llamactl project show <name>` - Show project details
+- `llamactl project delete <name>` - Delete a project
+
+### Deployment Management
+- `llamactl deployment create <name>` - Create a new deployment
+- `llamactl deployment list` - List all deployments
+- `llamactl deployment show <name>` - Show deployment details
+- `llamactl deployment delete <name>` - Delete a deployment
+- `llamactl deployment logs <name>` - View deployment logs
+
+### Health & Status
+- `llamactl health` - Check control plane health
+- `llamactl serve` - Start local development server
+
+## Configuration
+
+llamactl stores configuration in your home directory at `~/.llamactl/`. 
+
+### Profile Configuration
+Profiles allow you to manage multiple control plane connections:
+
+```bash
+# Configure default profile
+llamactl profile configure
+
+# Configure named profile
+llamactl profile configure --profile production
+
+# Use specific profile for commands
+llamactl --profile production deployment list
+```
+
+## Development
+
+This CLI is part of the LlamaDeploy ecosystem. For development setup:
+
+1. Clone the repository
+2. Install dependencies: `uv sync`
+3. Run tests: `uv run pytest`
+
+## Requirements
+
+- Python 3.12+
+- Access to a LlamaDeploy control plane
+
+## License
+
+This project is licensed under the MIT License.

llamactl-0.2.7a1/README.md

@@ -0,0 +1,102 @@
+# llamactl
+
+> [!WARNING]
+> This repository contains pre-release software. It is unstable, incomplete, and subject to breaking changes. Not recommended for use.
+
+
+A command-line interface for managing LlamaDeploy projects and deployments.
+
+## Installation
+
+Install from PyPI:
+
+```bash
+pip install llamactl
+```
+
+Or using uv:
+
+```bash
+uv add llamactl
+```
+
+## Quick Start
+
+1. **Configure your profile**: Set up connection to your LlamaDeploy control plane
+   ```bash
+   llamactl profile configure
+   ```
+
+2. **Check health**: Verify connection to the control plane
+   ```bash
+   llamactl health
+   ```
+
+3. **Create a project**: Initialize a new deployment project
+   ```bash
+   llamactl project create my-project
+   ```
+
+4. **Deploy**: Deploy your project to the control plane
+   ```bash
+   llamactl deployment create my-deployment --project-name my-project
+   ```
+
+## Commands
+
+### Profile Management
+- `llamactl profile configure` - Configure connection to control plane
+- `llamactl profile show` - Show current profile configuration
+- `llamactl profile list` - List all configured profiles
+
+### Project Management
+- `llamactl project create <name>` - Create a new project
+- `llamactl project list` - List all projects
+- `llamactl project show <name>` - Show project details
+- `llamactl project delete <name>` - Delete a project
+
+### Deployment Management
+- `llamactl deployment create <name>` - Create a new deployment
+- `llamactl deployment list` - List all deployments
+- `llamactl deployment show <name>` - Show deployment details
+- `llamactl deployment delete <name>` - Delete a deployment
+- `llamactl deployment logs <name>` - View deployment logs
+
+### Health & Status
+- `llamactl health` - Check control plane health
+- `llamactl serve` - Start local development server
+
+## Configuration
+
+llamactl stores configuration in your home directory at `~/.llamactl/`. 
+
+### Profile Configuration
+Profiles allow you to manage multiple control plane connections:
+
+```bash
+# Configure default profile
+llamactl profile configure
+
+# Configure named profile
+llamactl profile configure --profile production
+
+# Use specific profile for commands
+llamactl --profile production deployment list
+```
+
+## Development
+
+This CLI is part of the LlamaDeploy ecosystem. For development setup:
+
+1. Clone the repository
+2. Install dependencies: `uv sync`
+3. Run tests: `uv run pytest`
+
+## Requirements
+
+- Python 3.12+
+- Access to a LlamaDeploy control plane
+
+## License
+
+This project is licensed under the MIT License.

llamactl-0.2.7a1/pyproject.toml

@@ -0,0 +1,42 @@
+[project]
+name = "llamactl"
+version = "0.2.7a1"
+description = "A command-line interface for managing LlamaDeploy projects and deployments"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [
+    { name = "Adrian Lyjak", email = "adrianlyjak@gmail.com" }
+]
+requires-python = ">=3.12, <4"
+dependencies = [
+    "llama-deploy-core>=0.2.7a1,<0.3.0",
+    "llama-deploy-appserver>=0.2.7a1,<0.3.0",
+    "httpx>=0.24.0",
+    "rich>=13.0.0",
+    "questionary>=2.0.0",
+    "click>=8.2.1",
+    "python-dotenv>=1.0.0",
+    "tenacity>=9.1.2",
+    "textual>=4.0.0",
+    "aiohttp>=3.12.14",
+]
+
+[project.scripts]
+llamactl = "llama_deploy.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.7.20,<0.8.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.3.4",
+    "pytest-asyncio>=0.25.3",
+    "respx>=0.22.0",
+]
+
+[tool.uv.build-backend]
+module-name = "llama_deploy.cli"
+
+[tool.uv.sources]
+llama-deploy-appserver = { workspace = true }

llamactl-0.2.7a1/src/llama_deploy/cli/__init__.py

@@ -0,0 +1,32 @@
+import click
+from .commands import projects, deployments, profile, health_check, serve
+from .options import global_options
+
+
+# Main CLI application
+@click.group(help="LlamaDeploy CLI - Manage projects and deployments")
+@global_options
+def app():
+    """LlamaDeploy CLI - Manage projects and deployments"""
+    pass
+
+
+# Add sub-commands
+app.add_command(profile, name="profile")
+app.add_command(projects, name="project")
+app.add_command(deployments, name="deployment")
+
+# Add health check at root level
+app.add_command(health_check, name="health")
+
+# Add serve command at root level
+app.add_command(serve, name="serve")
+
+
+# Main entry point function (called by the script)
+def main() -> None:
+    app()
+
+
+if __name__ == "__main__":
+    app()

llamactl-0.2.7a1/src/llama_deploy/cli/client.py

@@ -0,0 +1,173 @@
+import logging
+from typing import List, Optional
+
+import httpx
+from llama_deploy.core.schema.deployments import (
+    DeploymentCreate,
+    DeploymentResponse,
+    DeploymentsListResponse,
+    DeploymentUpdate,
+)
+from llama_deploy.core.schema.git_validation import (
+    RepositoryValidationRequest,
+    RepositoryValidationResponse,
+)
+from llama_deploy.core.schema.projects import ProjectSummary, ProjectsListResponse
+from rich.console import Console
+
+from .config import config_manager
+
+
+class LlamaDeployClient:
+    """HTTP client for communicating with the LlamaDeploy control plane API"""
+
+    def __init__(
+        self, base_url: Optional[str] = None, project_id: Optional[str] = None
+    ):
+        """Initialize the client with a configured profile"""
+        self.console = Console()
+
+        # Get profile data
+        profile = config_manager.get_current_profile()
+        if not profile:
+            self.console.print("\n[bold red]No profile configured![/bold red]")
+            self.console.print("\nTo get started, create a profile with:")
+            self.console.print("[cyan]llamactl profile create[/cyan]")
+            raise SystemExit(1)
+
+        # Use profile data with optional overrides
+        self.base_url = base_url or profile.api_url
+        self.project_id = project_id or profile.active_project_id
+
+        if not self.base_url:
+            raise ValueError("API URL is required")
+
+        if not self.project_id:
+            raise ValueError("Project ID is required")
+
+        self.base_url = self.base_url.rstrip("/")
+
+        # Create persistent client with event hooks
+        self.client = httpx.Client(
+            base_url=self.base_url, event_hooks={"response": [self._handle_response]}
+        )
+
+    def _handle_response(self, response: httpx.Response) -> None:
+        """Handle response middleware - warnings and error conversion"""
+        # Check for warnings in response headers
+        if "X-Warning" in response.headers:
+            self.console.print(
+                f"[yellow]Warning: {response.headers['X-Warning']}[/yellow]"
+            )
+
+        # Convert httpx errors to our current exception format
+        try:
+            response.raise_for_status()
+        except httpx.HTTPStatusError as e:
+            # Try to parse JSON error response
+            try:
+                response.read()  # need to collect streaming data before calling json
+                error_data = e.response.json()
+                if isinstance(error_data, dict) and "detail" in error_data:
+                    error_message = error_data["detail"]
+                else:
+                    error_message = str(error_data)
+            except (ValueError, KeyError):
+                # Fallback to raw response text
+                error_message = e.response.text
+
+            raise Exception(f"HTTP {e.response.status_code}: {error_message}") from e
+        except httpx.RequestError as e:
+            raise Exception(f"Request failed: {e}") from e
+
+    # Health check
+    def health_check(self) -> dict:
+        """Check if the API server is healthy"""
+        response = self.client.get("/health")
+        return response.json()
+
+    # Projects
+    def list_projects(self) -> List[ProjectSummary]:
+        """List all projects with deployment counts"""
+        response = self.client.get("/projects/")
+        projects_response = ProjectsListResponse.model_validate(response.json())
+        return [project for project in projects_response.projects]
+
+    # Deployments
+    def list_deployments(self) -> List[DeploymentResponse]:
+        """List deployments for the configured project"""
+        response = self.client.get(f"/{self.project_id}/deployments/")
+        deployments_response = DeploymentsListResponse.model_validate(response.json())
+        return [deployment for deployment in deployments_response.deployments]
+
+    def get_deployment(self, deployment_id: str) -> DeploymentResponse:
+        """Get a specific deployment"""
+        response = self.client.get(f"/{self.project_id}/deployments/{deployment_id}")
+        deployment = DeploymentResponse.model_validate(response.json())
+        return deployment
+
+    def create_deployment(
+        self,
+        deployment_data: DeploymentCreate,
+    ) -> DeploymentResponse:
+        """Create a new deployment"""
+
+        response = self.client.post(
+            f"/{self.project_id}/deployments/",
+            json=deployment_data.model_dump(exclude_none=True),
+        )
+        deployment = DeploymentResponse.model_validate(response.json())
+        return deployment
+
+    def delete_deployment(self, deployment_id: str) -> None:
+        """Delete a deployment"""
+        self.client.delete(f"/{self.project_id}/deployments/{deployment_id}")
+
+    def update_deployment(
+        self,
+        deployment_id: str,
+        update_data: DeploymentUpdate,
+        force_git_sha_update: bool = False,
+    ) -> DeploymentResponse:
+        """Update an existing deployment"""
+
+        params = {}
+        if force_git_sha_update:
+            params["force_git_sha_update"] = True
+
+        response = self.client.patch(
+            f"/{self.project_id}/deployments/{deployment_id}",
+            json=update_data.model_dump(),
+            params=params,
+        )
+        deployment = DeploymentResponse.model_validate(response.json())
+        return deployment
+
+    def validate_repository(
+        self,
+        repo_url: str,
+        deployment_id: str | None = None,
+        pat: str | None = None,
+    ) -> RepositoryValidationResponse:
+        """Validate a repository URL"""
+        logging.info(
+            f"Validating repository with params: {repo_url}, {deployment_id}, {pat}"
+        )
+        response = self.client.post(
+            f"/{self.project_id}/deployments/validate-repository",
+            json=RepositoryValidationRequest(
+                repository_url=repo_url,
+                deployment_id=deployment_id,
+                pat=pat,
+            ).model_dump(),
+        )
+        logging.info(f"Response: {response.json()}")
+        return RepositoryValidationResponse.model_validate(response.json())
+
+
+# Global client factory function
+def get_client(
+    base_url: Optional[str] = None, project_id: Optional[str] = None
+) -> LlamaDeployClient:
+    """Get a client instance with optional overrides"""
+    return LlamaDeployClient(base_url=base_url, project_id=project_id)