drown 0.1.0__py3-none-any.whl

drown/__init__.py

@@ -0,0 +1,3 @@
+"""Drown Platform CLI - Manage your self-hosted PaaS from the command line."""
+
+__version__ = "0.1.0"

drown/api.py

@@ -0,0 +1,130 @@
+"""API wrapper functions for Drown Platform."""
+
+import requests
+from drown.config import get_api_base
+
+
+def _make_request(method, endpoint, token=None, data=None):
+    """
+    Make an HTTP request to the API.
+    
+    Returns: (success: bool, result: dict)
+    """
+    api_base = get_api_base()
+    url = f"{api_base}{endpoint}"
+    
+    headers = {}
+    if token:
+        headers["Authorization"] = f"Bearer {token}"
+    
+    try:
+        if method == "GET":
+            response = requests.get(url, headers=headers, timeout=10)
+        elif method == "POST":
+            headers["Content-Type"] = "application/json"
+            response = requests.post(url, headers=headers, json=data, timeout=10)
+        else:
+            return False, {"error": f"Unsupported HTTP method: {method}"}
+        
+        # Handle different status codes
+        if response.status_code == 200:
+            try:
+                return True, response.json()
+            except ValueError:
+                return True, {"message": response.text}
+        elif response.status_code == 201:
+            try:
+                return True, response.json()
+            except ValueError:
+                return True, {"message": "Created successfully"}
+        elif response.status_code == 401:
+            return False, {"error": "Invalid credentials. Please run 'drown login' again."}
+        elif response.status_code == 403:
+            return False, {"error": "Forbidden: You don't have access to this resource."}
+        elif response.status_code == 404:
+            return False, {"error": "Not found. The app or resource doesn't exist."}
+        elif response.status_code == 400:
+            try:
+                error_data = response.json()
+                error_msg = error_data.get("error", "Bad request")
+            except ValueError:
+                error_msg = "Bad request"
+            return False, {"error": error_msg}
+        elif response.status_code >= 500:
+            return False, {"error": "Server error. Please try again later."}
+        else:
+            return False, {"error": f"Unexpected response: {response.status_code}"}
+    
+    except requests.exceptions.ConnectionError:
+        return False, {"error": f"Unable to connect to {api_base}. Please check your internet connection."}
+    except requests.exceptions.Timeout:
+        return False, {"error": "Request timed out. Please try again."}
+    except requests.exceptions.RequestException as e:
+        return False, {"error": f"Network error: {str(e)}"}
+
+
+def login(username, password):
+    """
+    Authenticate with the platform.
+    
+    Returns: (success: bool, result: dict)
+    result contains: {"token": "...", "username": "..."} or {"error": "..."}
+    """
+    return _make_request("POST", "/api/auth/login", data={
+        "username": username,
+        "password": password
+    })
+
+
+def get_apps(token):
+    """
+    Get list of all apps.
+    
+    Returns: (success: bool, result: dict)
+    result contains: {"apps": [...]} or {"error": "..."}
+    """
+    return _make_request("GET", "/api/apps", token=token)
+
+
+def create_app(token, app_name):
+    """
+    Create a new app.
+    
+    Returns: (success: bool, result: dict)
+    result contains: {"app": {...}, "domain": "...", "git_remote": "...", "push_instructions": "..."} or {"error": "..."}
+    """
+    return _make_request("POST", "/api/apps/create", token=token, data={
+        "name": app_name
+    })
+
+
+def scale_app(token, app_name, replicas):
+    """
+    Scale an app to specified replica count.
+    
+    Returns: (success: bool, result: dict)
+    result contains: {"app": {...}, "replicas": ...} or {"error": "..."}
+    """
+    return _make_request("POST", f"/api/apps/{app_name}/scale", token=token, data={
+        "replicas": replicas
+    })
+
+
+def get_logs(token, app_name):
+    """
+    Get logs for an app.
+    
+    Returns: (success: bool, result: dict)
+    result contains: {"app": "...", "logs": "..."} or {"error": "..."}
+    """
+    return _make_request("GET", f"/api/apps/{app_name}/logs", token=token)
+
+
+def get_metrics(token, app_name):
+    """
+    Get metrics for an app.
+    
+    Returns: (success: bool, result: dict)
+    result contains: {"app": "...", "replicas": [...]} or {"error": "..."}
+    """
+    return _make_request("GET", f"/api/apps/{app_name}/metrics", token=token)

drown/cli.py

@@ -0,0 +1,248 @@
+"""CLI commands for Drown Platform."""
+
+import click
+import getpass
+import subprocess
+import sys
+from pathlib import Path
+
+from drown import api, config
+
+
+@click.group()
+@click.version_option(version="0.1.0", prog_name="drown")
+def cli():
+    """Drown Platform CLI - Manage your self-hosted PaaS."""
+    pass
+
+
+@cli.command()
+def login():
+    """Login to Drown Platform."""
+    click.echo("Login to Drown Platform")
+    click.echo(f"API: {config.get_api_base()}\n")
+    
+    username = click.prompt("Username")
+    password = getpass.getpass("Password: ")
+    
+    click.echo("\nAuthenticating...")
+    
+    success, result = api.login(username, password)
+    
+    if success:
+        token = result.get("token")
+        username = result.get("username")
+        
+        config.save_config(token, username)
+        
+        click.secho(f"✓ Logged in as {username}", fg="green")
+        click.echo(f"Config saved to {config.CONFIG_FILE}")
+    else:
+        click.secho(f"✗ Login failed: {result.get('error')}", fg="red", err=True)
+        sys.exit(1)
+
+
+@cli.command()
+def logout():
+    """Logout and remove saved credentials."""
+    if config.delete_config():
+        click.secho("✓ Logged out successfully", fg="green")
+        click.echo(f"Removed {config.CONFIG_FILE}")
+    else:
+        click.echo("Not logged in")
+
+
+@cli.command()
+def apps():
+    """List all your apps."""
+    token = config.get_token()
+    if not token:
+        click.secho("✗ Please run 'drown login' first", fg="red", err=True)
+        sys.exit(1)
+    
+    success, result = api.get_apps(token)
+    
+    if not success:
+        click.secho(f"✗ Error: {result.get('error')}", fg="red", err=True)
+        sys.exit(1)
+    
+    apps_list = result.get("apps", [])
+    
+    if not apps_list:
+        click.echo("No apps found. Create one with 'drown create <app-name>'")
+        return
+    
+    # Print table header
+    click.echo(f"{'NAME':<20} {'DOMAIN':<35} {'STATUS':<10} {'REPLICAS':<8}")
+    click.echo("-" * 75)
+    
+    # Print each app
+    for app in apps_list:
+        name = app.get("name", "")
+        domain = app.get("domain", "N/A")
+        status = app.get("status", "unknown")
+        replicas = app.get("replicas", 0)
+        
+        # Color code status
+        if status == "running":
+            status_colored = click.style(status, fg="green")
+        elif status == "stopped":
+            status_colored = click.style(status, fg="red")
+        else:
+            status_colored = status
+        
+        click.echo(f"{name:<20} {domain:<35} {status_colored:<10} {replicas:<8}")
+
+
+@cli.command()
+@click.argument("app_name")
+def create(app_name):
+    """Create a new app."""
+    token = config.get_token()
+    if not token:
+        click.secho("✗ Please run 'drown login' first", fg="red", err=True)
+        sys.exit(1)
+    
+    click.echo(f"Creating app '{app_name}'...")
+    
+    success, result = api.create_app(token, app_name)
+    
+    if not success:
+        click.secho(f"✗ Error: {result.get('error')}", fg="red", err=True)
+        sys.exit(1)
+    
+    domain = result.get("domain", "N/A")
+    git_remote = result.get("git_remote")
+    push_instructions = result.get("push_instructions", "")
+    
+    click.secho(f"✓ App '{app_name}' created successfully!", fg="green")
+    click.echo(f"Domain: {domain}")
+    
+    # Check if we're in a git repo
+    git_dir = Path(".git")
+    if git_dir.exists() and git_remote:
+        click.echo("\nAdding git remote 'platform'...")
+        
+        try:
+            # Check if remote already exists
+            result = subprocess.run(
+                ["git", "remote", "get-url", "platform"],
+                capture_output=True,
+                text=True
+            )
+            
+            if result.returncode == 0:
+                click.secho("⚠ Remote 'platform' already exists. Skipping.", fg="yellow")
+            else:
+                # Add the remote
+                subprocess.run(
+                    ["git", "remote", "add", "platform", git_remote],
+                    check=True,
+                    capture_output=True
+                )
+                click.secho(f"✓ Git remote 'platform' added", fg="green")
+        except subprocess.CalledProcessError as e:
+            click.secho(f"⚠ Failed to add git remote: {e}", fg="yellow")
+        except FileNotFoundError:
+            click.secho("⚠ Git not found. Please install git to use auto-remote feature.", fg="yellow")
+    
+    # Print deployment instructions
+    if push_instructions:
+        click.echo(f"\n{push_instructions}")
+
+
+@cli.command()
+@click.argument("app_name")
+@click.argument("count", type=int)
+def scale(app_name, count):
+    """Scale an app to COUNT replicas."""
+    token = config.get_token()
+    if not token:
+        click.secho("✗ Please run 'drown login' first", fg="red", err=True)
+        sys.exit(1)
+    
+    if count < 0:
+        click.secho("✗ Replica count must be non-negative", fg="red", err=True)
+        sys.exit(1)
+    
+    click.echo(f"Scaling '{app_name}' to {count} replica(s)...")
+    
+    success, result = api.scale_app(token, app_name, count)
+    
+    if not success:
+        click.secho(f"✗ Error: {result.get('error')}", fg="red", err=True)
+        sys.exit(1)
+    
+    new_count = result.get("replicas", count)
+    click.secho(f"✓ Scaled '{app_name}' to {new_count} replica(s)", fg="green")
+
+
+@cli.command()
+@click.argument("app_name")
+def logs(app_name):
+    """View logs for an app."""
+    token = config.get_token()
+    if not token:
+        click.secho("✗ Please run 'drown login' first", fg="red", err=True)
+        sys.exit(1)
+    
+    success, result = api.get_logs(token, app_name)
+    
+    if not success:
+        click.secho(f"✗ Error: {result.get('error')}", fg="red", err=True)
+        sys.exit(1)
+    
+    logs_text = result.get("logs", "")
+    
+    if logs_text:
+        click.echo(logs_text)
+    else:
+        click.echo("No logs available")
+
+
+@cli.command()
+@click.argument("app_name")
+def metrics(app_name):
+    """View resource metrics for an app."""
+    token = config.get_token()
+    if not token:
+        click.secho("✗ Please run 'drown login' first", fg="red", err=True)
+        sys.exit(1)
+    
+    success, result = api.get_metrics(token, app_name)
+    
+    if not success:
+        click.secho(f"✗ Error: {result.get('error')}", fg="red", err=True)
+        sys.exit(1)
+    
+    replicas = result.get("replicas", [])
+    
+    if not replicas:
+        click.echo(f"No replicas found for '{app_name}'")
+        return
+    
+    # Print table header
+    click.echo(f"{'REPLICA':<10} {'PORT':<8} {'STATUS':<10} {'CPU':<10} {'MEMORY':<15}")
+    click.echo("-" * 55)
+    
+    # Print each replica
+    for replica in replicas:
+        replica_num = replica.get("replica_num", "?")
+        port = replica.get("port", "N/A")
+        status = replica.get("status", "unknown")
+        cpu = replica.get("cpu", "N/A")
+        memory = replica.get("memory", "N/A")
+        
+        # Color code status
+        if status == "running":
+            status_colored = click.style(status, fg="green")
+        elif status == "stopped":
+            status_colored = click.style(status, fg="red")
+        else:
+            status_colored = status
+        
+        click.echo(f"{replica_num:<10} {port:<8} {status_colored:<10} {cpu:<10} {memory:<15}")
+
+
+if __name__ == "__main__":
+    cli()

drown/config.py

@@ -0,0 +1,73 @@
+"""Configuration management for Drown CLI."""
+
+import json
+import os
+from pathlib import Path
+
+# Default API base URL
+DEFAULT_API_BASE = "https://dashboard.dr0wn.duckdns.org"
+
+# Config file location
+CONFIG_DIR = Path.home() / ".drown"
+CONFIG_FILE = CONFIG_DIR / "config.json"
+
+
+def get_api_base():
+    """Get API base URL from environment or default."""
+    return os.environ.get("DROWN_API_URL", DEFAULT_API_BASE)
+
+
+def save_config(token, username):
+    """Save authentication config to ~/.drown/config.json."""
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    
+    config = {
+        "token": token,
+        "username": username,
+        "api_base": get_api_base()
+    }
+    
+    with open(CONFIG_FILE, "w") as f:
+        json.dump(config, f, indent=2)
+    
+    # Set restrictive permissions (Unix-like systems)
+    if hasattr(os, 'chmod'):
+        os.chmod(CONFIG_FILE, 0o600)
+
+
+def load_config():
+    """Load authentication config from ~/.drown/config.json."""
+    if not CONFIG_FILE.exists():
+        return None
+    
+    try:
+        with open(CONFIG_FILE, "r") as f:
+            config = json.load(f)
+        
+        # Ensure api_base is set (for older config files)
+        if "api_base" not in config:
+            config["api_base"] = get_api_base()
+        
+        return config
+    except (json.JSONDecodeError, IOError):
+        return None
+
+
+def delete_config():
+    """Delete the config file (logout)."""
+    if CONFIG_FILE.exists():
+        CONFIG_FILE.unlink()
+        return True
+    return False
+
+
+def get_token():
+    """Get the saved auth token, or None if not logged in."""
+    config = load_config()
+    return config["token"] if config else None
+
+
+def get_username():
+    """Get the saved username, or None if not logged in."""
+    config = load_config()
+    return config["username"] if config else None

drown-0.1.0.dist-info/METADATA

@@ -0,0 +1,201 @@
+Metadata-Version: 2.4
+Name: drown
+Version: 0.1.0
+Summary: CLI tool for managing apps on Drown Platform - a self-hosted PaaS
+Home-page: https://github.com/drownplatform/drown-cli
+Author: Drown Platform
+Author-email: platform@dr0wn.duckdns.org
+Project-URL: Bug Tracker, https://github.com/drownplatform/drown-cli/issues
+Project-URL: Documentation, https://github.com/drownplatform/drown-cli#readme
+Project-URL: Source Code, https://github.com/drownplatform/drown-cli
+Keywords: drown platform paas cli deployment docker heroku
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0.0
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# drown-cli
+
+**CLI tool for managing apps on Drown Platform** - a self-hosted PaaS (Platform as a Service).
+
+Deploy and manage containerized applications with simple commands, similar to Heroku CLI but for your own infrastructure.
+
+## Installation
+
+```bash
+pip install drown-cli
+```
+
+## Quick Start
+
+```bash
+# Login to your Drown Platform instance
+drown login
+
+# List your apps
+drown apps
+
+# Create a new app
+drown create my-app
+
+# Scale your app
+drown scale my-app 3
+
+# View logs
+drown logs my-app
+
+# Check metrics
+drown metrics my-app
+
+# Logout
+drown logout
+```
+
+## Commands
+
+### `drown login`
+Authenticate with your Drown Platform instance. You'll be prompted for your username and password.
+
+```bash
+drown login
+```
+
+Credentials are saved to `~/.drown/config.json` for subsequent commands.
+
+### `drown logout`
+Remove saved credentials.
+
+```bash
+drown logout
+```
+
+### `drown apps`
+List all your deployed applications.
+
+```bash
+drown apps
+```
+
+Output:
+```
+NAME           DOMAIN                    STATUS    REPLICAS
+my-app         my-app.dr0wn.duckdns.org  running   3
+web-frontend   web.dr0wn.duckdns.org     running   1
+```
+
+### `drown create <app-name>`
+Create a new application.
+
+```bash
+drown create my-new-app
+```
+
+If run from a git repository, automatically adds a `platform` git remote. Then deploy with:
+```bash
+git push platform main
+```
+
+### `drown scale <app-name> <count>`
+Scale the number of replicas for an application.
+
+```bash
+drown scale my-app 5
+```
+
+### `drown logs <app-name>`
+View application logs.
+
+```bash
+drown logs my-app
+```
+
+### `drown metrics <app-name>`
+View resource usage metrics (CPU, memory) for all replicas.
+
+```bash
+drown metrics my-app
+```
+
+Output:
+```
+REPLICA    PORT    STATUS    CPU      MEMORY
+0          8001    running   2.1%     64MiB
+1          8002    running   1.8%     62MiB
+2          8003    running   2.4%     65MiB
+```
+
+## Configuration
+
+### API URL
+By default, the CLI connects to `https://dashboard.dr0wn.duckdns.org`.
+
+To use a custom instance, set the `DROWN_API_URL` environment variable:
+
+```bash
+export DROWN_API_URL=https://your-instance.com
+drown login
+```
+
+### Config File
+Authentication token is stored in `~/.drown/config.json`:
+
+```json
+{
+  "token": "your-jwt-token",
+  "username": "your-username",
+  "api_base": "https://dashboard.dr0wn.duckdns.org"
+}
+```
+
+## Requirements
+
+- Python 3.7+
+- Git (optional, for `drown create` auto-remote feature)
+
+## Development
+
+```bash
+git clone https://github.com/drownplatform/drown-cli.git
+cd drown-cli
+pip install -e .
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Links
+
+- **Platform**: [dashboard.dr0wn.duckdns.org](https://dashboard.dr0wn.duckdns.org)
+- **GitHub**: [github.com/drownplatform/drown-cli](https://github.com/drownplatform/drown-cli)
+- **PyPI**: [pypi.org/project/drown-cli](https://pypi.org/project/drown-cli)
+
+## Support
+
+For issues or questions, please open an issue on [GitHub](https://github.com/drownplatform/drown-cli/issues).

drown-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+drown/__init__.py,sha256=qBHx3QDcl9BpBpGctB7yS4K_99ACSpw6WvO7aUJAfAY,105
+drown/api.py,sha256=BP9UNDmL6rr0_DN3vs0mvP6NoX_iGeLK_WQ9aiIqwj0,4451
+drown/cli.py,sha256=NH70qq_gL2W_8Q2J1lsHw00jISCb9DST44hiIcdLsbU,7630
+drown/config.py,sha256=s9SyE5BhwEFgUH-f9O1hY9i0a0Uf8GXPCB7jaQ9pQqY,1908
+drown-0.1.0.dist-info/licenses/LICENSE,sha256=M-GqxSGf3Qks92eNPFeqLy18FhJse78A7UIAYJoFMpo,1092
+drown-0.1.0.dist-info/METADATA,sha256=i2SHYnkQgovrLvVresaOFG0w_Mkr1V_h18GDITpJVqo,4747
+drown-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+drown-0.1.0.dist-info/entry_points.txt,sha256=z62wKm7hcB1JdJu9HqyYa1PV5sfqi3LS-YiiIqLXsDU,40
+drown-0.1.0.dist-info/top_level.txt,sha256=y-SfXlwaR0r6aYiosjX1R7de68_d2IyQuTSlBl989cE,6
+drown-0.1.0.dist-info/RECORD,,

drown-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
+

drown-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+drown = drown.cli:cli

drown-0.1.0.dist-info/licenses/LICENSE

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

drown-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+drown