llamactl 0.2.7a1__py3-none-any.whl

llama_deploy/cli/textual/profile_form.py

@@ -0,0 +1,171 @@
+"""Textual-based forms for CLI interactions"""
+
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Optional
+
+from textual.app import App, ComposeResult
+from textual.containers import (
+    Container,
+    HorizontalGroup,
+)
+from textual.validation import Length
+from textual.widgets import Button, Input, Label, Static
+
+from ..config import Profile
+from ..config import config_manager
+
+
+@dataclass
+class ProfileForm:
+    """Form data for profile editing/creation"""
+
+    name: str = ""
+    api_url: str = ""
+    active_project_id: str = ""
+    existing_name: Optional[str] = None
+
+    @classmethod
+    def from_profile(cls, profile: Profile) -> "ProfileForm":
+        """Create form from existing profile"""
+        return cls(
+            name=profile.name,
+            api_url=profile.api_url,
+            active_project_id=profile.active_project_id or "",
+        )
+
+
+class ProfileEditApp(App[Optional[ProfileForm]]):
+    """Textual app for editing profiles"""
+
+    CSS_PATH = Path(__file__).parent / "styles.tcss"
+
+    def __init__(self, initial_data: ProfileForm):
+        super().__init__()
+        self.form_data = initial_data
+
+    def on_mount(self) -> None:
+        self.theme = "tokyo-night"
+
+    def on_key(self, event) -> None:
+        """Handle key events, including Ctrl+C"""
+        if event.key == "ctrl+c":
+            self.exit(None)
+
+    def compose(self) -> ComposeResult:
+        with Container(classes="form-container"):
+            title = "Edit Profile" if self.form_data.existing_name else "Create Profile"
+            yield Static(title, classes="primary-message")
+            yield Static("", id="error-message", classes="error-message hidden")
+            with Static(classes="two-column-form-grid"):
+                yield Label(
+                    "Profile Name: *", classes="required form-label", shrink=True
+                )
+                yield Input(
+                    value=self.form_data.name,
+                    placeholder="Enter profile name",
+                    validators=[Length(minimum=1)],
+                    id="name",
+                    compact=True,
+                )
+                yield Label("API URL: *", classes="required form-label", shrink=True)
+                yield Input(
+                    value=self.form_data.api_url,
+                    placeholder="https://prod-cloud-llama-deploy",
+                    validators=[Length(minimum=1)],
+                    id="api_url",
+                    compact=True,
+                )
+                yield Label("Project ID:", classes="form-label", shrink=True)
+                yield Input(
+                    value=self.form_data.active_project_id,
+                    placeholder="Optional project ID",
+                    id="project_id",
+                    compact=True,
+                )
+            with HorizontalGroup(classes="button-row"):
+                yield Button("Save", variant="primary", id="save", compact=True)
+                yield Button("Cancel", variant="default", id="cancel", compact=True)
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        if event.button.id == "save":
+            if self._validate_form():
+                result = self._get_form_data()
+                try:
+                    if result.existing_name:
+                        config_manager.delete_profile(result.existing_name)
+                    profile = config_manager.create_profile(
+                        result.name,
+                        result.api_url,
+                        result.active_project_id,
+                    )
+                    self.exit(profile)
+                except Exception as e:
+                    self._handle_error(e)
+
+        elif event.button.id == "cancel":
+            self.exit(None)
+
+    def _handle_error(self, error: Exception) -> None:
+        error_message = self.query_one("#error-message", Static)
+        error_message.update(f"Error creating profile: {error}")
+        error_message.add_class("visible")
+
+    def _validate_form(self) -> bool:
+        """Validate required fields"""
+        name_input = self.query_one("#name", Input)
+        api_url_input = self.query_one("#api_url", Input)
+        error_message = self.query_one("#error-message", Static)
+
+        errors = []
+
+        # Clear previous error state
+        name_input.remove_class("error")
+        api_url_input.remove_class("error")
+
+        if not name_input.value.strip():
+            name_input.add_class("error")
+            errors.append("Profile name is required")
+
+        if not api_url_input.value.strip():
+            api_url_input.add_class("error")
+            errors.append("API URL is required")
+
+        if errors:
+            error_message.update("; ".join(errors))
+            error_message.add_class("visible")
+            return False
+        else:
+            error_message.update("")
+            error_message.remove_class("visible")
+            return True
+
+    def _get_form_data(self) -> ProfileForm:
+        """Extract form data from inputs"""
+        name_input = self.query_one("#name", Input)
+        api_url_input = self.query_one("#api_url", Input)
+        project_id_input = self.query_one("#project_id", Input)
+
+        return ProfileForm(
+            name=name_input.value.strip(),
+            api_url=api_url_input.value.strip(),
+            active_project_id=project_id_input.value.strip(),
+            existing_name=self.form_data.existing_name,
+        )
+
+
+def edit_profile_form(profile: Profile) -> ProfileForm | None:
+    """Launch profile edit form and return result"""
+    initial_data = ProfileForm.from_profile(profile)
+    initial_data.existing_name = profile.name or None
+    app = ProfileEditApp(initial_data)
+    return app.run()
+
+
+def create_profile_form() -> Optional[ProfileForm]:
+    """Launch profile creation form and return result"""
+    return edit_profile_form(
+        Profile(
+            name="", api_url="https://prod-cloud-llama-deploy", active_project_id=None
+        )
+    )

llama_deploy/cli/textual/secrets_form.py

@@ -0,0 +1,186 @@
+"""Textual-based deployment forms for CLI interactions"""
+
+from llama_deploy.cli.env import load_env_secrets_from_string
+
+from textual.app import ComposeResult
+from textual.containers import HorizontalGroup, Widget
+from textual.widgets import Button, Input, Label, Static, TextArea
+from textual.reactive import reactive
+
+
+class SecretsWidget(Widget):
+    """Widget for managing deployment secrets with reactive updates"""
+
+    DEFAULT_CSS = """
+    SecretsWidget {
+        padding-top: 1;
+        border-top: wide $secondary-muted;
+        layout: vertical;
+        height: auto;
+        overflow-y: auto;
+    }
+
+
+    .secrets-grid {
+        layout: grid;
+        grid-size: 4;
+        grid-columns: auto 1fr auto auto;
+        grid-rows: auto;
+        margin-bottom: 1;
+        grid-gutter: 0 1;
+    }
+
+    .secrets-header {
+        text-style: bold;
+        color: $text-accent;
+        margin-bottom: 1;
+    }
+
+    .add-secrets-button-row {
+        layout: horizontal;
+        align: right middle;
+        margin: 1 0;
+    }
+    #new_secrets {
+        max-height: 7;
+    }
+    SecretsWidget .secret-label {
+        color: $text-accent;
+    }
+
+    SecretsWidget .text-container {
+        padding: 0;
+        height: 7;
+    }
+    #new_secrets {
+        margin: 0;
+        padding: 0;
+        height: 7;
+    }
+
+
+    """
+    secrets = reactive({}, recompose=True)  # Auto-recompose when secrets change
+    prior_secrets = reactive(set(), recompose=True)
+    visible_secrets = reactive(
+        set(), recompose=True
+    )  # Auto-recompose when visible secrets change
+
+    def __init__(
+        self,
+        initial_secrets: dict[str, str] | None = None,
+        prior_secrets: set[str] | None = None,
+    ):
+        super().__init__()
+        self.secrets = initial_secrets or {}
+        self.prior_secrets = prior_secrets or set()
+        self.visible_secrets = set()
+
+    def compose(self) -> ComposeResult:
+        """Compose the secrets section - called automatically when secrets change"""
+        yield Static("Environment Variables", classes="secrets-header")
+        secret_names = self.prior_secrets.union(self.secrets.keys())
+        hidden = len(secret_names) == 0
+        with Static(
+            classes="secrets-grid" + (" hidden" if hidden else ""),
+            id="secrets-grid",
+        ):
+            for secret_name in secret_names:
+                yield Label(f"{secret_name}:", classes="secret-label", shrink=True)
+                is_unknown = secret_name in self.prior_secrets
+                visible = secret_name in self.visible_secrets
+                yield Input(
+                    value=self.secrets.get(secret_name, "***"),
+                    placeholder="Leave blank to delete",
+                    password=not visible,
+                    id=f"secret_{secret_name}",
+                    compact=True,
+                )
+                yield Button(
+                    "hide" if visible and not is_unknown else "show",
+                    id=f"show_{secret_name}",
+                    compact=True,
+                    disabled=is_unknown,
+                )
+                yield Button(
+                    "delete",
+                    id=f"delete_{secret_name}",
+                    compact=True,
+                )
+
+        with HorizontalGroup(classes="text-container"):
+            yield TextArea(
+                "",
+                id="new_secrets",
+                show_line_numbers=True,
+                highlight_cursor_line=True,
+            )
+        with HorizontalGroup(classes="add-secrets-button-row"):
+            yield Button(
+                "Update Secrets",
+                classes="add-secret",
+                id="add_secrets",
+                compact=True,
+            )
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        """Handle button presses within the secrets widget"""
+        if event.button.id == "add_secrets":
+            self._add_secrets_from_textarea()
+        elif event.button.id and event.button.id.startswith("delete_"):
+            secret_name = event.button.id.removeprefix("delete_")
+            self._delete_secret(secret_name)
+        elif event.button.id and event.button.id.startswith("show_"):
+            secret_name = event.button.id.removeprefix("show_")
+            self._toggle_secret_visibility(secret_name)
+
+    def _add_secrets_from_textarea(self) -> None:
+        """Parse and add secrets from the textarea"""
+        textarea = self.query_one("#new_secrets", TextArea)
+        content = textarea.text.strip()
+
+        if not content:
+            return
+
+        # Parse .env format
+        new_secrets = load_env_secrets_from_string(content)
+
+        # Update secrets - this will trigger automatic recompose
+        updated_secrets = self.secrets.copy()
+        updated_secrets.update(new_secrets)
+        updated_prior_secrets = self.prior_secrets.copy()
+        updated_prior_secrets = updated_prior_secrets.difference(new_secrets.keys())
+        self.secrets = updated_secrets
+
+        # Clear textarea
+        textarea.text = ""
+
+    def _toggle_secret_visibility(self, secret_name: str) -> None:
+        """Toggle the visibility of a secret"""
+        visible_secrets = self.visible_secrets.copy()
+        if secret_name in visible_secrets:
+            visible_secrets.remove(secret_name)
+        else:
+            visible_secrets.add(secret_name)
+        self.visible_secrets = visible_secrets
+
+    def _delete_secret(self, secret_name: str) -> None:
+        """Delete a secret from the form"""
+        if secret_name in self.secrets:
+            updated_secrets = self.secrets.copy()
+            del updated_secrets[secret_name]
+            self.secrets = updated_secrets  # Triggers automatic recompose
+        if secret_name in self.prior_secrets:
+            updated_prior_secrets = self.prior_secrets.copy()
+            updated_prior_secrets.remove(secret_name)
+            self.prior_secrets = updated_prior_secrets
+
+    def get_updated_secrets(self) -> dict[str, str]:
+        """Get current secrets with values from input fields"""
+        self._add_secrets_from_textarea()
+        return self.secrets
+
+    def get_updated_prior_secrets(self) -> set[str]:
+        """Get current prior secrets"""
+        self._add_secrets_from_textarea()
+        return self.prior_secrets

llama_deploy/cli/textual/styles.tcss

@@ -0,0 +1,162 @@
+/* =============================================== */
+/* GLOBAL LAYOUT & CONTAINERS                    */
+/* =============================================== */
+
+Screen {
+    align: center middle;
+}
+
+Container {
+    padding: 2;
+    margin: 2;
+    border: round $primary;
+}
+
+.form-container {
+    max-width: 100;
+    height: auto;
+}
+
+/* =============================================== */
+/* FORM STRUCTURE & GRIDS                        */
+/* =============================================== */
+
+.two-column-form-grid {
+    layout: grid;
+    grid-size: 2;
+    grid-columns: auto 1fr;
+    grid-gutter: 0 1;
+    grid-rows: auto;
+    height: auto;
+}
+
+/* =============================================== */
+/* FORM ELEMENTS                                  */
+/* =============================================== */
+
+Label.required {
+    text-style: bold;
+}
+
+Label.form-label {
+    color: $text;
+}
+
+
+Input.error {
+    border: heavy $error;
+}
+
+Input.disabled {
+    color: $text-muted;
+    background: $surface-lighten-1;
+}
+
+/* =============================================== */
+/* UTILITIES, MESSAGES & NOTIFICATIONS                       */
+/* =============================================== */
+
+.mb-1 {
+    margin-bottom: 1;
+}
+
+.mb-2 {
+    margin-bottom: 2;
+}
+
+.mt-1 {
+    margin-top: 1;
+}
+
+.mt-2 {
+    margin-top: 2;
+}
+
+.text-error {
+    color: $error;
+}
+
+.text-success {
+    color: $success;
+}
+
+.text-warning {
+    color: $warning;
+}
+.primary-message {
+    color: $text-accent;
+    background: $accent-muted;
+    border-left: heavy $accent;
+    margin: 0 0 1 0;
+    padding: 0 0 0 1
+}
+
+.error-message {
+    color: $text-error;
+    background: $error-muted;
+    border-left: heavy $error;
+    margin: 0 0 1 0;
+    padding: 0 0 0 1
+}
+
+.primary-message {
+    color: $text-primary;
+    background: $primary-muted;
+    border-left: heavy $primary;
+    margin: 0 0 1 0;
+    padding: 0 0 0 1
+}
+
+.secondary-message {
+    color: $text-secondary;
+    background: $secondary-muted;
+    border-left: heavy $secondary;
+    margin: 0 0 1 0;
+    padding: 0 0 0 1
+}
+
+.success-message {
+    color: $text-success;
+    background: $success-muted;
+    border-left: heavy $success;
+    padding: 1;
+    margin: 1 0;
+}
+
+.hidden {
+    display: none
+}
+
+.hidden.visible {
+    display: block;
+}
+
+.layout-horizontal {
+    layout: horizontal;
+}
+.layout-vertical {
+    layout: vertical;
+}
+
+/* =============================================== */
+/* BUTTONS & ACTIONS                              */
+/* =============================================== */
+
+.button-row {
+    align: right middle;
+}
+.button-row Button {
+    margin-left: 1;
+}
+
+
+Button.danger {
+    background: $error;
+    color: $text-error;
+}
+
+Button.secondary {
+    margin-left: 1;
+}
+
+

llamactl-0.2.7a1.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,19 @@
+llama_deploy/cli/__init__.py,sha256=d0cda44bc0c9b76a5bff53f216c558541485910be36e94bd306dd0eeee8048c5,740
+llama_deploy/cli/client.py,sha256=1518e395291356538e2c7c63b1ad424c5484161b921fc0f54d7f6ad5cdcd0ccc,6385
+llama_deploy/cli/commands.py,sha256=d8ce617e18d0a7220d9c7f467f71db54bc6cfc49c3447fd5ae81c84bc95afe8f,17586
+llama_deploy/cli/config.py,sha256=b339d95fceb7a15a183663032396aaeb2afffe1ddf06494416a6a0183a6658ca,6275
+llama_deploy/cli/debug.py,sha256=e85a72d473bbe1645eb31772f7349bde703d45704166f767385895c440afc762,496
+llama_deploy/cli/env.py,sha256=bb1dcde428c779796ad2b39b58d84f08df75a15031afca577aca0db5ce9a9ea0,1015
+llama_deploy/cli/interactive_prompts/utils.py,sha256=59bd7cab8fe359d5a52e1805e8c9555b5cdf16f3699d7fa3be4d189503c4617f,2482
+llama_deploy/cli/options.py,sha256=78b6e36e39fa88f0587146995e2cb66418b67d16f945f0b7570dab37cf5fc673,576
+llama_deploy/cli/textual/deployment_form.py,sha256=7e7d0e40ae451ca7bf202be746378ae54af30b94b85a3c524ad02933c66cc182,15107
+llama_deploy/cli/textual/git_validation.py,sha256=a00ab16b104b9f2f6c989243a65fb19f4b177562798a1174027e70b596fcb5c9,13378
+llama_deploy/cli/textual/github_callback_server.py,sha256=a74b1f5741bdaa682086771fd73a145e1e22359601f16f036f72a87e64b0a152,7444
+llama_deploy/cli/textual/llama_loader.py,sha256=dfef7118eb42d0fec033731b3f3b16ed4dbf4c551f4059c36e290e73c9aa5d13,1244
+llama_deploy/cli/textual/profile_form.py,sha256=2c6ca4690c22b499cc327b117c97e7914d4243b73faa92c0f5ac9cfdcf59b3d7,6015
+llama_deploy/cli/textual/secrets_form.py,sha256=1fd47a5a5ee9dfa0fd2a86f5888894820897c55fbb0cd30e60d6bc08570288b5,6303
+llama_deploy/cli/textual/styles.tcss,sha256=72338c5634bae0547384669382c4e06deec1380ef7bbc31099b1dca8ce49b2d0,2711
+llamactl-0.2.7a1.dist-info/WHEEL,sha256=cc8ae5806c5874a696cde0fcf78fdf73db4982e7c824f3ceab35e2b65182fa1a,79
+llamactl-0.2.7a1.dist-info/entry_points.txt,sha256=b67e1eb64305058751a651a80f2d2268b5f7046732268421e796f64d4697f83c,52
+llamactl-0.2.7a1.dist-info/METADATA,sha256=b74e8a9886a9823e5b65476b5b0712a17d73d3ef6117e058c86bd290a70fac8a,3137
+llamactl-0.2.7a1.dist-info/RECORD,,

llamactl-0.2.7a1.dist-info/WHEEL

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

llamactl-0.2.7a1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+llamactl = llama_deploy.cli:main
+