wayscloud-cli 0.1.0__tar.gz → 0.2.0__tar.gz

wayscloud_cli-0.2.0/PKG-INFO

@@ -0,0 +1,149 @@
+Metadata-Version: 2.4
+Name: wayscloud-cli
+Version: 0.2.0
+Summary: Command-line interface for WAYSCloud — manage VPS, DNS, databases, storage, apps, IoT, and more
+License: MIT
+Project-URL: Homepage, https://wayscloud.services
+Project-URL: Documentation, https://docs.wayscloud.services/integrations/cli
+Project-URL: Repository, https://github.com/wayscloudas/wayscloud-provision-api
+Project-URL: Issues, https://github.com/wayscloudas/wayscloud-provision-api/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: wayscloud>=0.1.0
+Requires-Dist: typer>=0.9
+Requires-Dist: rich>=13.0
+Requires-Dist: websockets>=12.0
+
+# WAYSCloud CLI
+
+Command-line interface for [WAYSCloud](https://wayscloud.services). Built on the [Python SDK](https://pypi.org/project/wayscloud/).
+
+## Installation
+
+```bash
+pip install wayscloud-cli
+```
+
+## Authentication
+
+```bash
+cloud login --token wayscloud_pat_...
+cloud whoami
+cloud logout
+```
+
+Priority: `--token` flag > `WAYSCLOUD_TOKEN` env var > `~/.wayscloud/credentials` file.
+
+## Commands
+
+### VPS
+
+```bash
+cloud vps list
+cloud vps create --hostname web01 --plan vps-medium --region no --os ubuntu-24.04
+cloud vps info <id>
+cloud vps delete <id> --confirm
+cloud vps start <id>
+cloud vps stop <id>
+cloud vps plans
+cloud vps os-templates
+```
+
+### DNS
+
+```bash
+cloud dns zones
+cloud dns zones-create example.com
+cloud dns records example.com
+cloud dns records-create example.com --type A --name www --value 192.0.2.1
+cloud dns records-delete example.com <record-id> --confirm
+```
+
+### Database
+
+```bash
+cloud db list
+cloud db create mydb --type postgresql --tier standard
+cloud db info postgresql mydb
+cloud db delete postgresql mydb --confirm
+```
+
+### Redis
+
+```bash
+cloud redis list
+cloud redis create myredis --plan redis-starter --region no
+cloud redis info <id>
+cloud redis delete <id> --confirm
+cloud redis plans
+```
+
+### Storage
+
+```bash
+cloud storage buckets
+cloud storage buckets-create my-bucket
+cloud storage buckets-delete my-bucket --confirm
+cloud storage credentials
+```
+
+### Apps
+
+```bash
+cloud app list
+cloud app create my-app --plan app-basic --region eu
+cloud app deploy <id> --image ghcr.io/org/app:latest
+cloud app start <id>
+cloud app stop <id>
+cloud app delete <id> --confirm
+```
+
+### IoT
+
+```bash
+cloud iot devices
+cloud iot devices-create --device-id sensor-01 --name "Temperature Sensor"
+cloud iot devices-info <device-id>
+cloud iot devices-delete <device-id> --confirm
+cloud iot groups
+cloud iot groups-create --name "Floor 2"
+```
+
+### Shell
+
+```bash
+cloud shell connect
+```
+
+## Output formats
+
+```bash
+# Default: formatted tables
+cloud vps list
+
+# JSON (for scripting)
+cloud vps list --json
+```
+
+## Requirements
+
+- Python 3.9+
+- wayscloud (SDK)
+
+## Documentation
+
+Full reference: [docs.wayscloud.services/cli](https://docs.wayscloud.services/cli)
+
+## License
+
+MIT

wayscloud_cli-0.2.0/README.md

@@ -0,0 +1,123 @@
+# WAYSCloud CLI
+
+Command-line interface for [WAYSCloud](https://wayscloud.services). Built on the [Python SDK](https://pypi.org/project/wayscloud/).
+
+## Installation
+
+```bash
+pip install wayscloud-cli
+```
+
+## Authentication
+
+```bash
+cloud login --token wayscloud_pat_...
+cloud whoami
+cloud logout
+```
+
+Priority: `--token` flag > `WAYSCLOUD_TOKEN` env var > `~/.wayscloud/credentials` file.
+
+## Commands
+
+### VPS
+
+```bash
+cloud vps list
+cloud vps create --hostname web01 --plan vps-medium --region no --os ubuntu-24.04
+cloud vps info <id>
+cloud vps delete <id> --confirm
+cloud vps start <id>
+cloud vps stop <id>
+cloud vps plans
+cloud vps os-templates
+```
+
+### DNS
+
+```bash
+cloud dns zones
+cloud dns zones-create example.com
+cloud dns records example.com
+cloud dns records-create example.com --type A --name www --value 192.0.2.1
+cloud dns records-delete example.com <record-id> --confirm
+```
+
+### Database
+
+```bash
+cloud db list
+cloud db create mydb --type postgresql --tier standard
+cloud db info postgresql mydb
+cloud db delete postgresql mydb --confirm
+```
+
+### Redis
+
+```bash
+cloud redis list
+cloud redis create myredis --plan redis-starter --region no
+cloud redis info <id>
+cloud redis delete <id> --confirm
+cloud redis plans
+```
+
+### Storage
+
+```bash
+cloud storage buckets
+cloud storage buckets-create my-bucket
+cloud storage buckets-delete my-bucket --confirm
+cloud storage credentials
+```
+
+### Apps
+
+```bash
+cloud app list
+cloud app create my-app --plan app-basic --region eu
+cloud app deploy <id> --image ghcr.io/org/app:latest
+cloud app start <id>
+cloud app stop <id>
+cloud app delete <id> --confirm
+```
+
+### IoT
+
+```bash
+cloud iot devices
+cloud iot devices-create --device-id sensor-01 --name "Temperature Sensor"
+cloud iot devices-info <device-id>
+cloud iot devices-delete <device-id> --confirm
+cloud iot groups
+cloud iot groups-create --name "Floor 2"
+```
+
+### Shell
+
+```bash
+cloud shell connect
+```
+
+## Output formats
+
+```bash
+# Default: formatted tables
+cloud vps list
+
+# JSON (for scripting)
+cloud vps list --json
+```
+
+## Requirements
+
+- Python 3.9+
+- wayscloud (SDK)
+
+## Documentation
+
+Full reference: [docs.wayscloud.services/cli](https://docs.wayscloud.services/cli)
+
+## License
+
+MIT

wayscloud_cli-0.2.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "wayscloud-cli"
+version = "0.2.0"
+description = "Command-line interface for WAYSCloud — manage VPS, DNS, databases, storage, apps, IoT, and more"
+readme = "README.md"
+requires-python = ">=3.9"
+license = {text = "MIT"}
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "wayscloud>=0.1.0",
+    "typer>=0.9",
+    "rich>=13.0",
+    "websockets>=12.0",
+]
+
+[project.urls]
+Homepage = "https://wayscloud.services"
+Documentation = "https://docs.wayscloud.services/integrations/cli"
+Repository = "https://github.com/wayscloudas/wayscloud-provision-api"
+Issues = "https://github.com/wayscloudas/wayscloud-provision-api/issues"
+
+[tool.setuptools.packages.find]
+include = ["wayscloud_cli*"]
+exclude = ["tests*"]
+
+[project.scripts]
+cloud = "wayscloud_cli.__main__:main"

{wayscloud_cli-0.1.0 → wayscloud_cli-0.2.0}/setup.cfg

@@ -1,10 +1,14 @@
 [metadata]
 name = wayscloud-cli
-version = 0.1.0
+version = 0.2.0
 
 [options]
 packages = find:
 
+[options.entry_points]
+console_scripts = 
+	cloud = wayscloud_cli.__main__:main
+
 [egg_info]
 tag_build = 
 tag_date = 0

wayscloud_cli-0.2.0/tests/test_smoke.py

@@ -0,0 +1,146 @@
+"""CLI smoke tests — verify app structure, command registration, flags, and token resolution."""
+
+import json
+import os
+from unittest.mock import patch
+
+from typer.testing import CliRunner
+
+from wayscloud_cli.__main__ import app
+from wayscloud_cli import __version__
+from wayscloud_cli.config import resolve_token
+from wayscloud_cli.output import set_json_mode, is_json_mode
+
+runner = CliRunner()
+
+
+# ── App structure ───────────────────────────────────────────────
+
+def test_app_has_help():
+    result = runner.invoke(app, ["--help"])
+    assert result.exit_code == 0
+    assert "WAYSCloud CLI" in result.output
+
+
+def test_version_flag():
+    result = runner.invoke(app, ["--version"])
+    assert result.exit_code == 0
+    assert __version__ in result.output
+
+
+# ── Command groups registered ───────────────────────────────────
+
+EXPECTED_GROUPS = ["auth", "vps", "dns", "storage", "db", "redis", "app", "iot", "shell"]
+
+
+def test_all_command_groups_registered():
+    result = runner.invoke(app, ["--help"])
+    for group in EXPECTED_GROUPS:
+        assert group in result.output, f"Command group '{group}' not in help output"
+
+
+def test_each_group_has_help():
+    for group in EXPECTED_GROUPS:
+        result = runner.invoke(app, [group, "--help"])
+        assert result.exit_code == 0, f"{group} --help failed with exit {result.exit_code}"
+
+
+# ── Top-level shortcuts ─────────────────────────────────────────
+
+def test_login_shortcut_exists():
+    result = runner.invoke(app, ["login", "--help"])
+    assert result.exit_code == 0
+    assert "token" in result.output.lower()
+
+
+def test_whoami_shortcut_exists():
+    result = runner.invoke(app, ["whoami", "--help"])
+    assert result.exit_code == 0
+
+
+def test_logout_shortcut_exists():
+    result = runner.invoke(app, ["logout", "--help"])
+    assert result.exit_code == 0
+
+
+# ── Token resolution ────────────────────────────────────────────
+
+def test_explicit_token_wins(monkeypatch):
+    monkeypatch.setenv("WAYSCLOUD_TOKEN", "env_token")
+    assert resolve_token("explicit_token") == "explicit_token"
+
+
+def test_env_var_used_when_no_explicit(monkeypatch):
+    monkeypatch.setenv("WAYSCLOUD_TOKEN", "env_token")
+    assert resolve_token(None) == "env_token"
+
+
+def test_returns_none_when_nothing(monkeypatch, tmp_path):
+    monkeypatch.delenv("WAYSCLOUD_TOKEN", raising=False)
+    # Point credentials file to nonexistent path
+    monkeypatch.setattr("wayscloud_cli.config.CREDENTIALS_FILE", tmp_path / "nope")
+    assert resolve_token(None) is None
+
+
+def test_reads_credentials_file(monkeypatch, tmp_path):
+    monkeypatch.delenv("WAYSCLOUD_TOKEN", raising=False)
+    cred_file = tmp_path / "credentials"
+    cred_file.write_text(json.dumps({"version": 1, "token": "file_token"}))
+    monkeypatch.setattr("wayscloud_cli.config.CREDENTIALS_FILE", cred_file)
+    assert resolve_token(None) == "file_token"
+
+
+# ── Output modes ────────────────────────────────────────────────
+
+def test_json_mode_toggle():
+    set_json_mode(False)
+    assert not is_json_mode()
+    set_json_mode(True)
+    assert is_json_mode()
+    set_json_mode(False)
+
+
+def test_json_flag_accepted():
+    result = runner.invoke(app, ["--json", "--help"])
+    assert result.exit_code == 0
+
+
+# ── VPS commands exist with correct args ────────────────────────
+
+def test_vps_list_help():
+    result = runner.invoke(app, ["vps", "list", "--help"])
+    assert result.exit_code == 0
+    assert "--token" in result.output
+
+
+def test_vps_create_requires_flags():
+    result = runner.invoke(app, ["vps", "create", "--help"])
+    assert result.exit_code == 0
+    for flag in ["--hostname", "--plan", "--region", "--os"]:
+        assert flag in result.output, f"Missing {flag} in vps create"
+
+
+# ── DNS commands ────────────────────────────────────────────────
+
+def test_dns_records_create_has_type_flag():
+    result = runner.invoke(app, ["dns", "records-create", "--help"])
+    assert result.exit_code == 0
+    assert "--type" in result.output
+    assert "--value" in result.output
+
+
+# ── DB commands ─────────────────────────────────────────────────
+
+def test_db_create_has_type_flag():
+    result = runner.invoke(app, ["db", "create", "--help"])
+    assert result.exit_code == 0
+    assert "--type" in result.output
+
+
+# ── IoT commands ────────────────────────────────────────────────
+
+def test_iot_devices_create_has_required_flags():
+    result = runner.invoke(app, ["iot", "devices-create", "--help"])
+    assert result.exit_code == 0
+    assert "--device-id" in result.output
+    assert "--name" in result.output

wayscloud_cli-0.2.0/wayscloud_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.0"

{wayscloud_cli-0.1.0 → wayscloud_cli-0.2.0}/wayscloud_cli/__main__.py

@@ -3,15 +3,23 @@ WAYSCloud CLI entry point.
 
 Binary name: cloud (C21)
 Package name: wayscloud-cli (C21)
+
+Principle: CLI = provisioning + control, NOT observability.
 """
 
 import typer
 
 from . import __version__
 from .output import set_json_mode, set_no_color
-from .commands.login import app as login_app
+from .commands.login import app as login_app, login, logout, whoami
 from .commands.vps import app as vps_app
 from .commands.shell import app as shell_app
+from .commands.dns import app as dns_app
+from .commands.storage import app as storage_app
+from .commands.db import app as db_app
+from .commands.redis import app as redis_app
+from .commands.app import app as app_platform_app
+from .commands.iot import app as iot_app
 
 app = typer.Typer(
     name="cloud",
@@ -43,14 +51,20 @@ def global_options(
 
 
 # Register command groups
-app.add_typer(login_app, name="auth", help="Login, logout, whoami")
+app.add_typer(login_app, name="auth", help="Authentication")
 app.add_typer(vps_app, name="vps", help="Virtual Private Servers")
-app.add_typer(shell_app, name="shell", help="Interactive CloudShell")
+app.add_typer(dns_app, name="dns", help="DNS zones and records")
+app.add_typer(storage_app, name="storage", help="Object storage (S3)")
+app.add_typer(db_app, name="db", help="Managed databases")
+app.add_typer(redis_app, name="redis", help="Managed Redis")
+app.add_typer(app_platform_app, name="app", help="App platform")
+app.add_typer(iot_app, name="iot", help="IoT platform")
+app.add_typer(shell_app, name="shell", help="CloudShell")
 
 # Top-level shortcuts for login/logout/whoami
-app.command("login")(login_app.registered_commands[0].callback)
-app.command("logout")(login_app.registered_commands[1].callback)
-app.command("whoami")(login_app.registered_commands[2].callback)
+app.command("login")(login)
+app.command("logout")(logout)
+app.command("whoami")(whoami)
 
 
 def main():

wayscloud_cli-0.2.0/wayscloud_cli/commands/app.py

@@ -0,0 +1,136 @@
+"""
+cloud app commands — App Platform provisioning and control.
+"""
+
+import typer
+from typing import Optional
+
+from ..sdk import get_client, sdk_call
+from ..output import print_table, print_object, print_json, is_json_mode
+
+app = typer.Typer(help="App platform")
+
+
+@app.command("list")
+def list_apps(
+    token: Optional[str] = typer.Option(None, "--token", help="Override token"),
+):
+    """List your apps."""
+    c = get_client(token)
+    data = sdk_call(c.apps.list)
+    apps_list = data if isinstance(data, list) else data.get("apps", []) if isinstance(data, dict) else []
+
+    if is_json_mode():
+        print_json(apps_list)
+        return
+
+    if not apps_list:
+        print("No apps found.")
+        return
+
+    rows = [{"id": str(a.get("id", ""))[:14], "name": a.get("name", ""),
+             "status": a.get("status", ""), "plan": a.get("plan", a.get("plan_code", "")),
+             "url": a.get("default_url", ""), "created_at": a.get("created_at", "")}
+            for a in apps_list]
+
+    print_table(rows, [
+        ("id", "ID", 14), ("name", "Name", 20), ("status", "Status", 10),
+        ("plan", "Plan", 16), ("url", "URL", 30), ("created_at", "Created", 20),
+    ])
+
+
+@app.command("create")
+def create_app(
+    name: str = typer.Argument(..., help="App name"),
+    plan: str = typer.Option("app-basic", "--plan", help="Plan code"),
+    region: str = typer.Option("no", "--region", help="Region"),
+    port: int = typer.Option(8080, "--port", help="Application port"),
+    token: Optional[str] = typer.Option(None, "--token", help="Override token"),
+):
+    """Create a new app."""
+    c = get_client(token)
+    data = sdk_call(c.apps.create, name, plan=plan, region=region, port=port)
+    if is_json_mode():
+        print_json(data)
+    else:
+        print(f"App created: {data.get('name', name)}")
+        print_object(data, [("id", "ID"), ("name", "Name"), ("status", "Status"),
+                            ("plan", "Plan"), ("default_url", "URL")])
+
+
+@app.command("info")
+def info_app(
+    app_id: str = typer.Argument(..., help="App ID"),
+    token: Optional[str] = typer.Option(None, "--token", help="Override token"),
+):
+    """Show app details."""
+    c = get_client(token)
+    data = sdk_call(c.apps.get, app_id)
+    print_object(data, [
+        ("id", "ID"), ("name", "Name"), ("status", "Status"), ("plan", "Plan"),
+        ("region", "Region"), ("port", "Port"), ("default_url", "URL"),
+        ("image_uri", "Image"), ("created_at", "Created"),
+    ])
+
+
+@app.command("delete")
+def delete_app(
+    app_id: str = typer.Argument(..., help="App ID"),
+    token: Optional[str] = typer.Option(None, "--token", help="Override token"),
+    confirm: bool = typer.Option(False, "--confirm", help="Skip confirmation"),
+):
+    """Delete an app (permanent)."""
+    if not confirm:
+        print(f"This will permanently delete app {app_id} and all its data.")
+        print("Use --confirm to proceed.")
+        raise typer.Exit(code=1)
+
+    c = get_client(token)
+    data = sdk_call(c.apps.delete, app_id)
+    if is_json_mode():
+        print_json(data)
+    else:
+        print(f"App {app_id}: deleted")
+
+
+@app.command("deploy")
+def deploy_app(
+    app_id: str = typer.Argument(..., help="App ID"),
+    image: str = typer.Option(..., "--image", help="Container image URI"),
+    token: Optional[str] = typer.Option(None, "--token", help="Override token"),
+):
+    """Deploy an app from a container image."""
+    c = get_client(token)
+    data = sdk_call(c.apps.deploy, app_id, image)
+    if is_json_mode():
+        print_json(data)
+    else:
+        print(f"App {app_id}: deploying image {image}")
+
+
+@app.command("start")
+def start_app(
+    app_id: str = typer.Argument(..., help="App ID"),
+    token: Optional[str] = typer.Option(None, "--token", help="Override token"),
+):
+    """Start an app."""
+    c = get_client(token)
+    data = sdk_call(c.apps.start, app_id)
+    if is_json_mode():
+        print_json(data)
+    else:
+        print(f"App {app_id}: {data.get('message', 'starting')}")
+
+
+@app.command("stop")
+def stop_app(
+    app_id: str = typer.Argument(..., help="App ID"),
+    token: Optional[str] = typer.Option(None, "--token", help="Override token"),
+):
+    """Stop an app."""
+    c = get_client(token)
+    data = sdk_call(c.apps.stop, app_id)
+    if is_json_mode():
+        print_json(data)
+    else:
+        print(f"App {app_id}: {data.get('message', 'stopping')}")