lcloud-cli 0.1.0__py3-none-any.whl

lambda_cloud/mngr/models.py

@@ -0,0 +1,198 @@
+"""Pydantic models for Lambda Cloud API resources.
+
+All models ignore unknown fields so the CLI keeps working when the API adds
+new attributes.
+"""
+
+from __future__ import annotations
+
+from datetime import datetime
+from enum import Enum
+
+from pydantic import BaseModel, ConfigDict
+
+
+class APIModel(BaseModel):
+    """Base model that tolerates unknown fields from the API."""
+
+    model_config = ConfigDict(extra="ignore")
+
+
+class Region(APIModel):
+    name: str
+    description: str = ""
+
+
+class InstanceTypeSpecs(APIModel):
+    vcpus: int
+    memory_gib: int
+    storage_gib: int
+    gpus: int
+
+
+class InstanceType(APIModel):
+    name: str
+    description: str = ""
+    gpu_description: str = ""
+    price_cents_per_hour: int
+    specs: InstanceTypeSpecs
+    architecture: str = ""
+
+    @property
+    def price_per_hour(self) -> float:
+        return self.price_cents_per_hour / 100
+
+
+class InstanceTypeOffer(APIModel):
+    """An instance type together with the regions where capacity is available."""
+
+    instance_type: InstanceType
+    regions_with_capacity_available: list[Region] = []
+
+
+class InstanceStatus(str, Enum):
+    BOOTING = "booting"
+    ACTIVE = "active"
+    UNHEALTHY = "unhealthy"
+    TERMINATED = "terminated"
+    TERMINATING = "terminating"
+    PREEMPTED = "preempted"
+
+
+class FilesystemMountEntry(APIModel):
+    mount_point: str
+    file_system_id: str
+
+
+class TagEntry(APIModel):
+    key: str
+    value: str
+
+
+class FirewallRulesetEntry(APIModel):
+    id: str
+
+
+class Instance(APIModel):
+    id: str
+    name: str | None = None
+    ip: str | None = None
+    private_ip: str | None = None
+    status: InstanceStatus
+    ssh_key_names: list[str] = []
+    file_system_names: list[str] = []
+    file_system_mounts: list[FilesystemMountEntry] | None = None
+    region: Region | None = None
+    instance_type: InstanceType | None = None
+    hostname: str | None = None
+    jupyter_url: str | None = None
+    tags: list[TagEntry] | None = None
+    firewall_rulesets: list[FirewallRulesetEntry] | None = None
+
+
+class InstanceLaunchResponse(APIModel):
+    instance_ids: list[str]
+
+
+class InstanceRestartResponse(APIModel):
+    restarted_instances: list[Instance]
+
+
+class InstanceTerminateResponse(APIModel):
+    terminated_instances: list[Instance]
+
+
+class SSHKey(APIModel):
+    id: str
+    name: str
+    public_key: str
+
+
+class GeneratedSSHKey(SSHKey):
+    private_key: str
+
+
+class User(APIModel):
+    id: str
+    email: str
+    status: str = ""
+
+
+class Filesystem(APIModel):
+    id: str
+    name: str
+    mount_point: str
+    created: datetime | None = None
+    created_by: User | None = None
+    is_in_use: bool = False
+    region: Region | None = None
+    bytes_used: int | None = None
+
+
+class Image(APIModel):
+    id: str
+    name: str
+    description: str = ""
+    family: str = ""
+    version: str = ""
+    architecture: str = ""
+    region: Region | None = None
+    created_time: datetime | None = None
+    updated_time: datetime | None = None
+
+
+class NetworkProtocol(str, Enum):
+    TCP = "tcp"
+    UDP = "udp"
+    ICMP = "icmp"
+    ALL = "all"
+
+
+class FirewallRule(APIModel):
+    protocol: NetworkProtocol
+    port_range: tuple[int, int] | None = None
+    source_network: str
+    description: str = ""
+
+    @property
+    def ports_display(self) -> str:
+        if self.protocol is NetworkProtocol.ICMP or self.port_range is None:
+            return "-"
+        low, high = self.port_range
+        return str(low) if low == high else f"{low}-{high}"
+
+
+class FirewallRuleset(APIModel):
+    id: str
+    name: str
+    region: Region | None = None
+    rules: list[FirewallRule] = []
+    created: datetime | None = None
+    instance_ids: list[str] = []
+
+
+class GlobalFirewallRuleset(APIModel):
+    id: str
+    name: str = ""
+    rules: list[FirewallRule] = []
+
+
+class AuditResult(APIModel):
+    status: str
+    status_code: int | None = None
+
+
+class AuditEvent(APIModel):
+    event_id: str
+    event_time: datetime | str
+    action: str
+    service_name: str = ""
+    resource_name: str = ""
+    catalog_version: str = ""
+    actor_email: str | None = None
+    actor_display_name: str | None = None
+    resource_lrns: list[str] = []
+    client_ip: str | None = None
+    client_user_agent: str | None = None
+    surface: str | None = None
+    result: AuditResult | None = None

lcloud_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,217 @@
+Metadata-Version: 2.5
+Name: lcloud-cli
+Version: 0.1.0
+Summary: Unofficial community command-line interface for the Lambda Cloud API
+Project-URL: Homepage, https://github.com/mrprokl/lambda-cloud-cli
+Project-URL: Repository, https://github.com/mrprokl/lambda-cloud-cli
+Project-URL: Issues, https://github.com/mrprokl/lambda-cloud-cli/issues
+Project-URL: Changelog, https://github.com/mrprokl/lambda-cloud-cli/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://docs.lambda.ai/public-cloud/
+Author: Thomas Gomez
+License: MIT
+License-File: LICENSE
+Keywords: cli,cloud,gpu,lambda,lambda-labs
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2
+Requires-Dist: rich>=13
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# lambda-cloud-cli
+
+[![CI](https://github.com/mrprokl/lambda-cloud-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/mrprokl/lambda-cloud-cli/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/lcloud-cli)](https://pypi.org/project/lcloud-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](pyproject.toml)
+
+Unofficial community command-line interface for the
+[Lambda Cloud](https://cloud.lambda.ai) API.
+
+> **Disclaimer**: this project is **not** affiliated with, endorsed by, or
+> supported by Lambda, Inc. It is built against the
+> [public Lambda Cloud API](https://docs.lambda.ai/public-cloud/).
+
+## Installation
+
+Requires Python 3.10+.
+
+```bash
+# Option 1 — uv (recommended)
+uv tool install lcloud-cli
+
+# Option 2 — pipx
+pipx install lcloud-cli
+
+# Option 3 — plain pip
+pip install lcloud-cli
+
+# Option 4 — straight from GitHub (bleeding edge)
+uv tool install git+https://github.com/mrprokl/lambda-cloud-cli
+```
+
+From source, for development:
+
+```bash
+git clone https://github.com/mrprokl/lambda-cloud-cli.git
+cd lambda-cloud-cli
+uv venv
+uv pip install -e '.[dev]'
+```
+
+## Quickstart
+
+```bash
+# 1. Authenticate (get your key at https://cloud.lambda.ai/api-keys)
+lambda-cloud login
+
+# 2. See what's available
+lambda-cloud regions list
+lambda-cloud types list
+lambda-cloud images list
+
+# 3. Launch a GPU instance
+lambda-cloud instances launch \
+    --type gpu_1x_a10 \
+    --region us-west-1 \
+    --ssh-key my-key
+
+# 4. Watch it boot
+lambda-cloud instances list
+lambda-cloud instances get <instance-id>
+
+# 5. Clean up
+lambda-cloud instances terminate <instance-id>
+```
+
+Output is human-friendly tables by default; add `--output json` (or `-o json`)
+to any command for scripting:
+
+```bash
+lambda-cloud -o json instances list | jq '.[].ip'
+```
+
+## Authentication
+
+The API key is resolved in this order:
+
+1. `--api-key` flag
+2. `LAMBDA_API_KEY` environment variable
+3. Config file written by `lambda-cloud login`
+   (`$XDG_CONFIG_HOME/lambda-cloud/config.json`, default
+   `~/.config/lambda-cloud/config.json`, mode `0600`)
+
+```bash
+lambda-cloud login               # interactive prompt, key is validated
+lambda-cloud login --api-key X   # non-interactive
+lambda-cloud whoami              # which key is in use? is it valid?
+lambda-cloud logout              # remove stored key
+lambda-cloud config show         # inspect configuration & defaults
+```
+
+## Commands
+
+| Command | Description |
+| --- | --- |
+| `instances list` | List running instances |
+| `instances get <id>` | Instance details |
+| `instances launch` | Launch an on-demand instance |
+| `instances restart <id>...` | Restart instances |
+| `instances terminate <id>...` | Terminate instances (destructive!) |
+| `instances rename <id> --name X` | Rename an instance |
+| `types list` | Instance types, specs, prices, regional capacity |
+| `ssh-keys list` / `add` / `delete` | Manage SSH keys (can generate a pair) |
+| `filesystems list` / `create` / `delete` | Manage shared filesystems |
+| `images list [--region R] [--family F]` | List machine images |
+| `regions list` | List regions |
+| `firewall rulesets ...` | CRUD on regional firewall rulesets |
+| `firewall global get` / `update` | Global firewall ruleset |
+| `audit list [--all]` | Account audit events (paginated) |
+| `config show` | Show CLI configuration |
+| `login` / `logout` / `whoami` | Credential management |
+
+### Launching instances
+
+```bash
+lambda-cloud instances launch \
+    --type gpu_8x_h100_sxm5 \
+    --region us-south-1 \
+    --ssh-key my-key \
+    --name training-run \
+    --filesystem shared-data \
+    --tag env=prod --tag team=ml \
+    --image-family lambda-stack \
+    --user-data ./cloud-init.yaml
+```
+
+### Firewall rules files
+
+`firewall rulesets create --rules-file rules.json` expects a JSON list:
+
+```json
+[
+  {"protocol": "tcp", "port_range": [22, 22], "source_network": "0.0.0.0/0", "description": "SSH"},
+  {"protocol": "tcp", "port_range": [8888, 8888], "source_network": "203.0.113.0/24", "description": "Jupyter"},
+  {"protocol": "icmp", "source_network": "0.0.0.0/0", "description": "Ping"}
+]
+```
+
+Rules are validated locally before submission: `icmp` must not define
+`port_range`, every other protocol must.
+
+## Environment variables
+
+| Variable | Purpose |
+| --- | --- |
+| `LAMBDA_API_KEY` | API key (overrides stored config) |
+| `LAMBDA_CLOUD_CONFIG_DIR` | Override the config directory |
+| `LAMBDA_CLOUD_API_URL` | Override the API base URL (useful for testing) |
+| `LAMBDA_CLOUD_MIN_INTERVAL` | Min seconds between API calls (default `1.05`, per documented rate limit) |
+
+## Rate limits
+
+Per the API documentation: 1 request/second in general, and 1 request per
+12 seconds on `instance-operations/launch`. The client throttles requests
+client-side and retries `429` responses honouring `Retry-After`.
+
+## Development
+
+```bash
+uv venv
+uv pip install -e '.[dev]'
+uv run ruff check src tests
+uv run pytest
+```
+
+Layout follows a strict layered architecture:
+
+```
+src/lambda_cloud/
+├── cli/        # interface: commands, state, ui (console/tables/formatters)
+├── api/        # http client + service layer (request shaping, validation)
+├── core/       # foundations: config, errors
+└── mngr/       # pydantic resource models
+```
+
+Dependencies flow strictly downward: `cli → api → core/mngr`.
+
+## Contributing
+
+Issues and pull requests are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

lcloud_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,34 @@
+lambda_cloud/__init__.py,sha256=Vor4v_WsX85G0EngVv5YRj3_mXIwDZUg68OZHsSXn5E,80
+lambda_cloud/__main__.py,sha256=4fC1kF8-teRPt8naDGjGMzFAQjoIQndyA-Q26ueL8cc,104
+lambda_cloud/api/__init__.py,sha256=m2-ps6t6CfGtrYO5KjmtB2s-iliqxTJWsnbXUIWShI4,363
+lambda_cloud/api/client.py,sha256=eb-g2FOsy1WCUEJ8vgr9Qe9GXAvsvos_1JpdNdD0GuA,5089
+lambda_cloud/api/service.py,sha256=oHgmYSG6Z-tZGopqr8j7fkzrYMzO_BDj5zBHD6gPMt4,8427
+lambda_cloud/cli/__init__.py,sha256=dHVLlTp2UXSVSSLvgrwWhik79t7HJD17zGiyt0Ixxps,36
+lambda_cloud/cli/app.py,sha256=_mHGR_s59-hNJpqAh-39mRfapneZ_nLkQohjJYsQb_Q,3110
+lambda_cloud/cli/state.py,sha256=exb7y8jHnI05kEtYIMcJs_VvtUOxMczvXlzpFDnGdGA,2181
+lambda_cloud/cli/commands/__init__.py,sha256=rJF3EBYw66IPPeaGbZsk4ujIsEvEH08ls3TDbpYFSQ8,60
+lambda_cloud/cli/commands/audit.py,sha256=l_VwEbxY-F1ZUuS3YxBNpCWJg3M17xW0D0Wm76HXGnw,1137
+lambda_cloud/cli/commands/auth.py,sha256=8XV2xfchBegiw9XxFduk1ml7xGdDcDZFBb0AckuNy9k,2075
+lambda_cloud/cli/commands/completion.py,sha256=ZQVrH3DE18IYXE254mQMxGikhuY2BGn3TWUIKeHCdAI,1176
+lambda_cloud/cli/commands/config_cmd.py,sha256=qoWeCQ0DvA8G_0nBlYc8fsdLn1TvBAFY9Nwga7oRxVo,1436
+lambda_cloud/cli/commands/filesystems.py,sha256=0CIEFqpeLI3Z5Qs_lp4RGNIpDZKsCNE5kFofZD2npV0,1763
+lambda_cloud/cli/commands/firewall.py,sha256=_GYzFwzZhYgMD_g4oZWxY8QcnPb5iXmeO-pCxr4Uvic,5657
+lambda_cloud/cli/commands/images.py,sha256=HRaXwe_83cIoKPGKE5Q4kU-U0aFvA_ZhHzB3tm32Cu8,776
+lambda_cloud/cli/commands/instance_types.py,sha256=B0rrwwdefcfZPuDkKBm8hWGmExbrBUVkSD2cymDpDfs,599
+lambda_cloud/cli/commands/instances.py,sha256=KBu5ib446ptAcRLCi9GtmqiW2Cd8Pqf2Lo4v8NAJ3a0,7584
+lambda_cloud/cli/commands/regions.py,sha256=Q86KvgfSJOYFd_6dpDh_Luq_Vv3ekX3_CJgzvqoQXT4,501
+lambda_cloud/cli/commands/ssh_keys.py,sha256=FUGlHuIrSYkQY3clV8ae5fWxLFPz9A0d7lbT7EZVE4w,3255
+lambda_cloud/cli/ui/__init__.py,sha256=kPHAqtlN0TYe9QYADKE3C2kHzMycIZAEar3c0ww3Is0,298
+lambda_cloud/cli/ui/console.py,sha256=jglSJ_8SYO9HUWDARNLI1Xxaa42xbMSSX0w5WpGwtUs,2845
+lambda_cloud/cli/ui/history.py,sha256=Fi1e3DJweCZw1EaG_NAsARzHANVXblaPrJTyZA6Az78,1707
+lambda_cloud/cli/ui/tables.py,sha256=1rufRsRNVSBInHHtqX5F4VuOTfDhOSCV3ql-2Mq8szg,8229
+lambda_cloud/core/__init__.py,sha256=_93pFaX96u1AgjToqJp5EYgKIT5rM--LGw_tdGdoccg,69
+lambda_cloud/core/config.py,sha256=MIcjfPm0jssJ9O9cbxJNXxiA7u29FSobgSCSAKBvC5E,3859
+lambda_cloud/core/errors.py,sha256=qVL-ONLe5ZMcqwxQ1CkhpevaHAWp7LKwWBiScG0BXAg,1742
+lambda_cloud/mngr/__init__.py,sha256=duIKAAb8NMHWAqWS_5K2OjHSzgENQzEC0ufPGBEBwB4,100
+lambda_cloud/mngr/models.py,sha256=Me0earhloYsjdrDeswT4cXotzvFVYjSXlhkw4SoUlK0,4294
+lcloud_cli-0.1.0.dist-info/METADATA,sha256=iQZkXWFZhhr5jK4bHgweneGLnTf9DISi9zA4GFAoiMA,6896
+lcloud_cli-0.1.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+lcloud_cli-0.1.0.dist-info/entry_points.txt,sha256=g6jPOX-Pw1ZaNhI_eqyak8o_HbKa7Bn--vQ93sasfgA,59
+lcloud_cli-0.1.0.dist-info/licenses/LICENSE,sha256=iN6c6rS4SgEwg2PMC9JjG3BC-OpZLGa6IDPglK572iw,1069
+lcloud_cli-0.1.0.dist-info/RECORD,,

lcloud_cli-0.1.0.dist-info/WHEEL

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

lcloud_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+lambda-cloud = lambda_cloud.cli.app:main

lcloud_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thomas Gomez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.