ibee-cli 0.1.0__py3-none-any.whl

ibee_cli/__init__.py

@@ -0,0 +1,3 @@
+"""IBEE Solutions command-line interface."""
+
+__version__ = "0.1.0"

ibee_cli/commands/buckets.py

@@ -0,0 +1,83 @@
+"""Object storage bucket commands."""
+
+from __future__ import annotations
+
+import typer
+
+from ..context import get_client, get_settings, require_workspace
+from ..render import handle_api_errors, print_json, print_table
+
+app = typer.Typer(help="Object storage buckets", no_args_is_help=True)
+
+
+def _human_size(num: int | None) -> str:
+    if num is None:
+        return "-"
+    size = float(num)
+    for unit in ("B", "KB", "MB", "GB", "TB"):
+        if size < 1024 or unit == "TB":
+            return f"{size:.1f} {unit}" if unit != "B" else f"{int(size)} B"
+        size /= 1024
+    return str(num)
+
+
+@app.command("list")
+@handle_api_errors
+def list_buckets(ctx: typer.Context) -> None:
+    """List buckets in the workspace."""
+    settings = get_settings(ctx)
+    client = get_client(settings)
+    result = client.object_storage.list_buckets(workspace_id=require_workspace(settings))
+    if settings.as_json:
+        print_json(result)
+        return
+    buckets = result.buckets or []
+    print_table(
+        "Buckets",
+        ["Name", "Objects", "Size"],
+        [(b.name, b.object_count, _human_size(b.total_size)) for b in buckets],
+    )
+
+
+@app.command("create")
+@handle_api_errors
+def create_bucket(
+    ctx: typer.Context,
+    name: str = typer.Argument(..., help="Bucket name (unique within the workspace)"),
+    public: bool = typer.Option(False, "--public", help="Allow unauthenticated read access"),
+    region: str = typer.Option(
+        "in-south-1",
+        "--region",
+        envvar="IBEE_REGION",
+        help="Storage region for the bucket",
+    ),
+) -> None:
+    """Create a bucket."""
+    settings = get_settings(ctx)
+    client = get_client(settings)
+    result = client.object_storage.create_bucket(
+        workspace_id=require_workspace(settings),
+        name=name,
+        region=region,
+        is_public=public,
+    )
+    if settings.as_json:
+        print_json(result)
+        return
+    typer.secho(f"Bucket '{name}' created in {region}.", fg=typer.colors.GREEN)
+
+
+@app.command("delete")
+@handle_api_errors
+def delete_bucket(
+    ctx: typer.Context,
+    name: str = typer.Argument(..., help="Bucket name"),
+    yes: bool = typer.Option(False, "--yes", "-y", help="Skip confirmation"),
+) -> None:
+    """Delete a bucket."""
+    settings = get_settings(ctx)
+    if not yes:
+        typer.confirm(f"Delete bucket '{name}'?", abort=True)
+    client = get_client(settings)
+    client.object_storage.delete_bucket(workspace_id=require_workspace(settings), bucket_name=name)
+    typer.secho(f"Bucket '{name}' deleted.", fg=typer.colors.GREEN)

ibee_cli/commands/gpus.py

@@ -0,0 +1,41 @@
+"""GPU VM commands."""
+
+from __future__ import annotations
+
+import typer
+
+from ..context import get_client, get_settings, require_workspace
+from ..render import handle_api_errors, print_json, print_table
+
+app = typer.Typer(help="GPU VMs", no_args_is_help=True)
+
+
+@app.command("list")
+@handle_api_errors
+def list_gpu_vms(ctx: typer.Context) -> None:
+    """List GPU VMs in the workspace."""
+    settings = get_settings(ctx)
+    client = get_client(settings)
+    result = client.gpu_vms.list_gpu_vms(workspace_id=require_workspace(settings))
+    if settings.as_json:
+        print_json(result)
+        return
+    vms = getattr(result, "items", None) or getattr(result, "vms", None) or []
+    print_table(
+        "GPU VMs",
+        ["ID", "Name", "Status", "CPU", "RAM (MB)", "Public IP"],
+        [
+            (v.id, v.name, getattr(v.status, "value", v.status), v.cpu, v.ram_mb, v.public_ip)
+            for v in vms
+        ],
+    )
+
+
+@app.command("get")
+@handle_api_errors
+def get_gpu_vm(ctx: typer.Context, vm_id: str = typer.Argument(..., help="GPU VM ID")) -> None:
+    """Show one GPU VM."""
+    settings = get_settings(ctx)
+    client = get_client(settings)
+    result = client.gpu_vms.get_gpu_vm(workspace_id=require_workspace(settings), vm_id=vm_id)
+    print_json(result)

ibee_cli/commands/secrets.py

@@ -0,0 +1,72 @@
+"""Secret Store commands."""
+
+from __future__ import annotations
+
+import typer
+
+from ..context import get_client, get_settings, require_workspace
+from ..render import handle_api_errors, print_json, print_table
+
+app = typer.Typer(help="Secret Store: stores and secrets", no_args_is_help=True)
+
+
+@app.command("stores")
+@handle_api_errors
+def list_stores(ctx: typer.Context) -> None:
+    """List secret stores in the workspace."""
+    settings = get_settings(ctx)
+    client = get_client(settings)
+    result = client.secret_store.list_secret_stores(workspace_id=require_workspace(settings))
+    if settings.as_json:
+        print_json(result)
+        return
+    stores = result.stores or []
+    print_table(
+        "Secret stores",
+        ["ID", "Name", "Store key", "Status", "Updated"],
+        [
+            (s.id, s.name, s.store_key, getattr(s.status, "value", s.status), str(s.updated_at or "")[:19])
+            for s in stores
+        ],
+    )
+
+
+@app.command("list")
+@handle_api_errors
+def list_secrets(
+    ctx: typer.Context,
+    store_id: str = typer.Option(..., "--store-id", "-s", help="Secret store ID"),
+) -> None:
+    """List secrets inside a store."""
+    settings = get_settings(ctx)
+    client = get_client(settings)
+    result = client.secret_store.list_secrets(
+        workspace_id=require_workspace(settings), store_id=store_id
+    )
+    if settings.as_json:
+        print_json(result)
+        return
+    secrets = getattr(result, "secrets", None) or []
+    print_table(
+        "Secrets",
+        ["ID", "Name", "Status", "Updated"],
+        [
+            (s.id, s.name, getattr(s.status, "value", s.status), str(getattr(s, "updated_at", "") or "")[:19])
+            for s in secrets
+        ],
+    )
+
+
+@app.command("value")
+@handle_api_errors
+def get_value(
+    ctx: typer.Context,
+    secret_id: str = typer.Argument(..., help="Secret ID"),
+) -> None:
+    """Print a secret's current value as JSON. Requires secret-store.read scope."""
+    settings = get_settings(ctx)
+    client = get_client(settings)
+    result = client.secret_store.get_secret_value(
+        workspace_id=require_workspace(settings), secret_id=secret_id
+    )
+    print_json(result)

ibee_cli/commands/vms.py

@@ -0,0 +1,84 @@
+"""Cloud VM commands."""
+
+from __future__ import annotations
+
+import uuid
+
+import typer
+
+from ..context import get_client, get_settings, require_workspace
+from ..render import handle_api_errors, print_json, print_table
+
+app = typer.Typer(help="Cloud VMs", no_args_is_help=True)
+
+
+@app.command("list")
+@handle_api_errors
+def list_vms(ctx: typer.Context) -> None:
+    """List cloud VMs in the workspace."""
+    settings = get_settings(ctx)
+    client = get_client(settings)
+    result = client.cloud_vms.list_cloud_vms(workspace_id=require_workspace(settings))
+    if settings.as_json:
+        print_json(result)
+        return
+    vms = getattr(result, "items", None) or getattr(result, "vms", None) or []
+    print_table(
+        "Cloud VMs",
+        ["ID", "Name", "Status", "CPU", "RAM (MB)", "Public IP"],
+        [
+            (v.id, v.name, getattr(v.status, "value", v.status), v.cpu, v.ram_mb, v.public_ip)
+            for v in vms
+        ],
+    )
+
+
+@app.command("get")
+@handle_api_errors
+def get_vm(ctx: typer.Context, vm_id: str = typer.Argument(..., help="VM ID")) -> None:
+    """Show one cloud VM."""
+    settings = get_settings(ctx)
+    client = get_client(settings)
+    result = client.cloud_vms.get_cloud_vm(workspace_id=require_workspace(settings), vm_id=vm_id)
+    print_json(result)
+
+
+def _power_action(ctx: typer.Context, vm_id: str, action: str) -> None:
+    settings = get_settings(ctx)
+    client = get_client(settings)
+    method = getattr(client.cloud_vms, f"{action}_cloud_vm")
+    result = method(
+        workspace_id=require_workspace(settings),
+        vm_id=vm_id,
+        idempotency_key=f"cli-{action}-{vm_id}-{uuid.uuid4().hex[:8]}",
+    )
+    if settings.as_json:
+        print_json(result)
+        return
+    op_id = getattr(result, "operation_id", None) or getattr(result, "id", None)
+    typer.secho(
+        f"{action.capitalize()} accepted for VM {vm_id}"
+        + (f" (operation {op_id})" if op_id else ""),
+        fg=typer.colors.GREEN,
+    )
+
+
+@app.command("start")
+@handle_api_errors
+def start_vm(ctx: typer.Context, vm_id: str = typer.Argument(...)) -> None:
+    """Start a cloud VM."""
+    _power_action(ctx, vm_id, "start")
+
+
+@app.command("stop")
+@handle_api_errors
+def stop_vm(ctx: typer.Context, vm_id: str = typer.Argument(...)) -> None:
+    """Stop a cloud VM."""
+    _power_action(ctx, vm_id, "stop")
+
+
+@app.command("reboot")
+@handle_api_errors
+def reboot_vm(ctx: typer.Context, vm_id: str = typer.Argument(...)) -> None:
+    """Reboot a cloud VM."""
+    _power_action(ctx, vm_id, "reboot")

ibee_cli/context.py

@@ -0,0 +1,70 @@
+"""Shared CLI state: authentication, environment, and client construction."""
+
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+
+import typer
+from ibee import Ibee
+from ibee.environment import IbeeEnvironment
+
+
+@dataclass
+class Settings:
+    token: str | None
+    workspace: str | None
+    dev: bool
+    base_url: str | None
+    as_json: bool
+
+
+def get_settings(ctx: typer.Context) -> Settings:
+    return ctx.obj
+
+
+def require_token(settings: Settings) -> str:
+    if settings.token:
+        return settings.token
+    typer.secho(
+        "No API token. Set IBEE_TOKEN (or pass --token). "
+        "Create one in the portal under Settings > API Tokens.",
+        fg=typer.colors.RED,
+        err=True,
+    )
+    raise typer.Exit(code=2)
+
+
+def require_workspace(settings: Settings) -> str:
+    if settings.workspace:
+        return settings.workspace
+    typer.secho(
+        "No workspace. Set IBEE_WORKSPACE_ID (or pass --workspace).",
+        fg=typer.colors.RED,
+        err=True,
+    )
+    raise typer.Exit(code=2)
+
+
+def get_client(settings: Settings) -> Ibee:
+    token = require_token(settings)
+    if settings.base_url:
+        return Ibee(token=token, base_url=settings.base_url, timeout=30)
+    env = IbeeEnvironment.DEVELOPMENT if settings.dev else IbeeEnvironment.DEFAULT
+    return Ibee(token=token, environment=env, timeout=30)
+
+
+def settings_from_env(
+    token: str | None,
+    workspace: str | None,
+    dev: bool,
+    base_url: str | None,
+    as_json: bool,
+) -> Settings:
+    return Settings(
+        token=token or os.environ.get("IBEE_TOKEN") or os.environ.get("IBEE_API_TOKEN"),
+        workspace=workspace or os.environ.get("IBEE_WORKSPACE_ID"),
+        dev=dev or os.environ.get("IBEE_ENV", "").lower() in ("dev", "development"),
+        base_url=base_url or os.environ.get("IBEE_BASE_URL"),
+        as_json=as_json,
+    )

ibee_cli/main.py

@@ -0,0 +1,47 @@
+"""ibee — the IBEE Solutions CLI."""
+
+from __future__ import annotations
+
+import typer
+
+from . import __version__
+from .commands import buckets, gpus, secrets, vms
+from .context import settings_from_env
+
+app = typer.Typer(
+    name="ibee",
+    help="IBEE Solutions cloud platform CLI. Auth: set IBEE_TOKEN and IBEE_WORKSPACE_ID.",
+    no_args_is_help=True,
+)
+
+app.add_typer(buckets.app, name="buckets")
+app.add_typer(secrets.app, name="secrets")
+app.add_typer(vms.app, name="vms")
+app.add_typer(gpus.app, name="gpus")
+
+
+def _version_callback(value: bool) -> None:
+    if value:
+        typer.echo(f"ibee-cli {__version__}")
+        raise typer.Exit()
+
+
+@app.callback()
+def main(
+    ctx: typer.Context,
+    token: str = typer.Option(None, "--token", help="API token (default: IBEE_TOKEN env)"),
+    workspace: str = typer.Option(
+        None, "--workspace", "-w", help="Workspace ID (default: IBEE_WORKSPACE_ID env)"
+    ),
+    dev: bool = typer.Option(False, "--dev", help="Use the development environment"),
+    base_url: str = typer.Option(None, "--base-url", help="Override the API base URL"),
+    as_json: bool = typer.Option(False, "--json", help="Output raw JSON"),
+    version: bool = typer.Option(
+        None, "--version", callback=_version_callback, is_eager=True, help="Show version"
+    ),
+) -> None:
+    ctx.obj = settings_from_env(token, workspace, dev, base_url, as_json)
+
+
+if __name__ == "__main__":
+    app()

ibee_cli/render.py

@@ -0,0 +1,64 @@
+"""Output rendering: rich tables by default, raw JSON with --json."""
+
+from __future__ import annotations
+
+import functools
+import json
+from typing import Any, Callable, Iterable, Sequence
+
+import typer
+from ibee.core.api_error import ApiError
+from rich.console import Console
+from rich.table import Table
+
+console = Console()
+
+
+def print_json(payload: Any) -> None:
+    if hasattr(payload, "dict"):
+        payload = payload.dict()
+    console.print_json(json.dumps(payload, default=str))
+
+
+def print_table(title: str, columns: Sequence[str], rows: Iterable[Sequence[Any]]) -> None:
+    table = Table(title=title, title_justify="left")
+    for col in columns:
+        table.add_column(col)
+    count = 0
+    for row in rows:
+        table.add_row(*[("-" if v is None else str(v)) for v in row])
+        count += 1
+    if count == 0:
+        console.print(f"{title}: none found")
+        return
+    console.print(table)
+
+
+def handle_api_errors(fn: Callable) -> Callable:
+    """Convert ApiError / connection failures into clean CLI errors."""
+
+    @functools.wraps(fn)
+    def wrapper(*args: Any, **kwargs: Any) -> Any:
+        try:
+            return fn(*args, **kwargs)
+        except ApiError as exc:
+            if exc.status_code == 401:
+                msg = "Unauthorized (401): the API token is invalid or revoked."
+            elif exc.status_code == 403:
+                msg = f"Forbidden (403): the token is missing a required scope. body={exc.body!r}"
+            elif exc.status_code == 404:
+                msg = (
+                    "Not found (404): this API route is not enabled on the gateway yet "
+                    "(compute routes are rolling out) or the resource does not exist."
+                )
+            else:
+                msg = f"API error {exc.status_code}: {exc.body!r}"
+            typer.secho(msg, fg=typer.colors.RED, err=True)
+            raise typer.Exit(code=1)
+        except Exception as exc:  # httpx connection errors etc.
+            if type(exc).__module__.startswith("httpx"):
+                typer.secho(f"Connection error: {exc}", fg=typer.colors.RED, err=True)
+                raise typer.Exit(code=1)
+            raise
+
+    return wrapper

ibee_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: ibee-cli
+Version: 0.1.0
+Summary: Official command-line interface for the IBEE Solutions cloud platform
+Author-email: IBEE Solutions <support@ibee.ai>
+License: MIT
+Project-URL: Homepage, https://ibee.ai
+Project-URL: Documentation, https://ibee.ai/docs/api-reference
+Project-URL: Repository, https://github.com/devs-ibee/ibee-cli
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ibee>=0.1.2
+Requires-Dist: typer>=0.12
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Dynamic: license-file
+
+# IBEE Solutions CLI
+
+Official command-line interface for the IBEE Solutions cloud platform. Built on the [`ibee` Python SDK](https://github.com/devs-ibee/ibee-python).
+
+## Installation
+
+```bash
+pip install ibee-cli
+```
+
+Requires Python 3.10+.
+
+## Authentication
+
+Create an API token in the portal under **Settings > API Tokens**, then:
+
+```bash
+export IBEE_TOKEN="ibee_live_xxxxxxxxxxxx"
+export IBEE_WORKSPACE_ID="710995"
+```
+
+Both can also be passed per command with `--token` and `--workspace`.
+
+## Usage
+
+```bash
+# Object storage
+ibee buckets list
+ibee buckets create my-bucket
+ibee buckets delete my-bucket --yes
+
+# Secret Store
+ibee secrets stores
+ibee secrets list --store-id STORE_ID
+ibee secrets value SECRET_ID
+
+# Cloud VMs
+ibee vms list
+ibee vms get VM_ID
+ibee vms start VM_ID
+ibee vms stop VM_ID
+ibee vms reboot VM_ID
+
+# GPU VMs
+ibee gpus list
+```
+
+Every command accepts `--json` for raw output:
+
+```bash
+ibee --json buckets list
+```
+
+## Environments
+
+The CLI targets production by default. Use `--dev` (or `IBEE_ENV=dev`) for the development environment, or `--base-url` for a custom endpoint:
+
+```bash
+ibee --dev buckets list
+```
+
+## Related
+
+- [Python SDK](https://github.com/devs-ibee/ibee-python) — `pip install ibee`
+- [API documentation](https://ibee.ai/docs/api-reference)

ibee_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+ibee_cli/__init__.py,sha256=yR6Elo-jC1yPR2Wh0amOleuJW7sReozjpN5U-YW2KYI,68
+ibee_cli/context.py,sha256=hodAfKSq1jyplfMDXOqW4ni8HpOLVIYxcx24ysOYKS4,1879
+ibee_cli/main.py,sha256=TxU-ZLJjhpRyvLZaJ9Aqd8U9eQIGvhn4UzFdBYw2u4E,1431
+ibee_cli/render.py,sha256=m7rlE_Bi0bHfK5QZ4e5Y6qiYGh1OAcJNBYlJHx9rTP8,2193
+ibee_cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ibee_cli/commands/buckets.py,sha256=ZwtUhB8mdbsKhk_5ZUq4UJ-hnvVh8xn7wq-1UagmQGg,2571
+ibee_cli/commands/gpus.py,sha256=9wCDDtXhBcC_gw5slQj04ENL2e1JfwaQfyNKXD1lc3g,1283
+ibee_cli/commands/secrets.py,sha256=JNBk8coxbCHbLuZfBSnzWkBuHa8akGPiqVOtoqXqFLI,2179
+ibee_cli/commands/vms.py,sha256=M3e9_8jOeu8ZQdYt2d7kvTT9C2I_H5cmnjtYIEoB3EM,2545
+ibee_cli-0.1.0.dist-info/licenses/LICENSE,sha256=X_PXeOEmTSLBRI0ICuQ_YSyl8mb9HZ5OcrX7315cf84,1071
+ibee_cli-0.1.0.dist-info/METADATA,sha256=sHdwg9I3GAjAo8f1UQ7c6xMAtXMWUgG00tYnjqgfAFg,2121
+ibee_cli-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+ibee_cli-0.1.0.dist-info/entry_points.txt,sha256=WyBnzgSCyIxebC5IIAZkRAcFo4RbXz3dB3V7sJbDaIg,43
+ibee_cli-0.1.0.dist-info/top_level.txt,sha256=ciWcLaIHTM2nXVH8-QqyYH9avexVL8lPocaTECmMNW0,9
+ibee_cli-0.1.0.dist-info/RECORD,,

ibee_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ibee_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ibee = ibee_cli.main:app

ibee_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 IBEE Solutions
+
+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.

ibee_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+ibee_cli