remo-cli 0.8.0rc1__py3-none-any.whl

remo_cli/__init__.py

@@ -0,0 +1,8 @@
+"""remo - Remote development environment CLI."""
+
+from importlib.metadata import version, PackageNotFoundError
+
+try:
+    __version__ = version("remo-cli")
+except PackageNotFoundError:
+    __version__ = "0.0.0-dev"

remo_cli/__main__.py

@@ -0,0 +1,5 @@
+"""Enable `python -m remo`."""
+
+from remo_cli.cli.main import cli
+
+cli()

remo_cli/cli/cp.py

@@ -0,0 +1,161 @@
+"""remo cp command - Copy files to/from a remote environment."""
+
+from __future__ import annotations
+
+import os
+import re
+import sys
+
+import click
+
+from remo_cli.core.known_hosts import resolve_remo_host_by_name
+from remo_cli.core.output import print_error, print_info
+from remo_cli.core.rsync import transfer
+from remo_cli.core.ssh import build_ssh_opts, resolve_remo_host
+
+# Pattern for named remote specs: name must be 2+ chars starting with
+# alphanumeric, followed by colon and a non-empty path.  Single-letter
+# prefixes are excluded to avoid matching Windows drive letters like C:.
+_NAMED_REMOTE_RE = re.compile(r"^([a-zA-Z0-9][a-zA-Z0-9._-]+):(.+)$")
+
+
+def parse_remote_spec(arg: str) -> tuple[str, str, str]:
+    """Parse a single path argument for colon notation.
+
+    Returns
+    -------
+    tuple[str, str, str]
+        ``(spec_type, env_name, path)`` where *spec_type* is ``"local"`` or
+        ``"remote"``, *env_name* is the environment name (empty string for
+        bare-colon specs), and *path* is the file path component.
+    """
+    # :path -> remote with bare colon (auto-select env)
+    if arg.startswith(":"):
+        return ("remote", "", arg[1:])
+
+    # name:path -> remote with named env
+    m = _NAMED_REMOTE_RE.match(arg)
+    if m:
+        return ("remote", m.group(1), m.group(2))
+
+    # Everything else -> local
+    return ("local", "", arg)
+
+
+@click.command()
+@click.option("-r", "--recursive", is_flag=True, default=False, help="Copy directories recursively")
+@click.option("--progress", is_flag=True, default=False, help="Show transfer progress")
+@click.argument("args", nargs=-1, required=True)
+def cp(recursive: bool, progress: bool, args: tuple[str, ...]) -> None:
+    """Copy files to/from a remo environment.
+
+    \b
+    Use colon notation for remote paths:
+      :path           Remote path (auto-select environment)
+      name:path       Remote path on named environment
+
+    \b
+    Upload:   remo cp ./file.txt :/tmp/
+    Download: remo cp :/var/log/app.log ./
+    """
+    # --- Phase 1: Validate positional args (need at least 2) ---
+    if len(args) < 2:
+        print_error("Expected at least 2 arguments: source(s) and destination.")
+        click.echo()
+        click.echo("Usage: remo cp [options] <source>... <destination>")
+        click.echo("Run 'remo cp --help' for examples.")
+        sys.exit(1)
+
+    # --- Phase 2: Last arg = destination, rest = sources ---
+    dest_arg = args[-1]
+    source_args = args[:-1]
+
+    # --- Phase 3: Parse all specs ---
+    src_specs = [parse_remote_spec(s) for s in source_args]
+    dest_type, dest_env_name, dest_path = parse_remote_spec(dest_arg)
+
+    # --- Phase 4: Determine direction and validate consistency ---
+    has_remote_src = any(spec[0] == "remote" for spec in src_specs)
+    has_local_src = any(spec[0] == "local" for spec in src_specs)
+
+    if has_remote_src and has_local_src:
+        print_error("Cannot mix local and remote sources.")
+        click.echo("All sources must be either local or remote.")
+        sys.exit(1)
+
+    if has_remote_src and dest_type == "remote":
+        print_error("Cannot copy from remote to remote.")
+        click.echo("One side must be local.")
+        sys.exit(1)
+
+    if not has_remote_src and dest_type == "local":
+        print_error("No remote side specified.")
+        click.echo()
+        click.echo("Use colon notation for remote paths:")
+        click.echo("  remo cp ./file.txt :/tmp/        # upload")
+        click.echo("  remo cp :/var/log/app.log ./     # download")
+        click.echo()
+        click.echo("Run 'remo cp --help' for more examples.")
+        sys.exit(1)
+
+    if has_remote_src:
+        direction = "download"
+        # Validate all remote sources reference the same environment.
+        remote_env_name = ""
+        for spec_type, env_name, _path in src_specs:
+            if spec_type == "remote":
+                if not remote_env_name:
+                    remote_env_name = env_name
+                elif env_name != remote_env_name:
+                    print_error("All remote sources must reference the same environment.")
+                    sys.exit(1)
+        src_paths = [spec[2] for spec in src_specs]
+    else:
+        direction = "upload"
+        remote_env_name = dest_env_name
+        src_paths = [spec[2] for spec in src_specs]
+
+    # --- Phase 5: Resolve environment ---
+    if remote_env_name:
+        host = resolve_remo_host_by_name(remote_env_name)
+    else:
+        host = resolve_remo_host()
+
+    # --- Phase 6: Build SSH opts ---
+    ssh_opts, ssh_target = build_ssh_opts(host)
+
+    # --- Phase 7: Validate local sources (upload only) ---
+    if direction == "upload":
+        for src in src_paths:
+            if not os.path.exists(src):
+                print_error(f"Source not found: {src}")
+                sys.exit(1)
+            if os.path.isdir(src) and not recursive:
+                print_error(f"'{src}' is a directory. Use -r to copy directories.")
+                sys.exit(1)
+
+    # --- Phase 8: Build and execute rsync ---
+    if direction == "upload":
+        print_info(f"Uploading to {host.type}: {host.name}...")
+        rc = transfer(
+            ssh_opts=ssh_opts,
+            ssh_target=ssh_target,
+            sources=src_paths,
+            dest=f"{ssh_target}:{dest_path}",
+            recursive=recursive,
+            progress=progress,
+        )
+    else:
+        print_info(f"Downloading from {host.type}: {host.name}...")
+        remote_sources = [f"{ssh_target}:{p}" for p in src_paths]
+        rc = transfer(
+            ssh_opts=ssh_opts,
+            ssh_target=ssh_target,
+            sources=remote_sources,
+            dest=dest_path,
+            recursive=recursive,
+            progress=progress,
+        )
+
+    if rc != 0:
+        sys.exit(rc)

remo_cli/cli/main.py

@@ -0,0 +1,50 @@
+"""Root CLI group for remo."""
+
+from __future__ import annotations
+
+import click
+
+import remo_cli
+
+
+@click.group(context_settings={"help_option_names": ["-h", "--help"]})
+@click.version_option(
+    version=remo_cli.__version__, prog_name="remo", message="%(prog)s %(version)s"
+)
+def cli() -> None:
+    """Remote development environment CLI."""
+
+
+@cli.result_callback()
+def _post_command_hook(result: object, **kwargs: object) -> None:
+    """Run passive update check after every command."""
+    try:
+        from remo_cli.core.version import check_for_updates_passive
+        from remo_cli.core.output import print_info
+
+        hint = check_for_updates_passive()
+        if hint:
+            print()
+            print_info(hint)
+    except Exception:
+        pass
+
+
+def _register_commands() -> None:
+    """Register all subcommands and groups. Called at import time."""
+    # Import lazily to avoid circular imports and to keep startup fast
+    # when only --version or --help is requested.
+    from remo_cli.cli.shell import shell  # noqa: F811
+    from remo_cli.cli.cp import cp  # noqa: F811
+    from remo_cli.cli.providers.incus import incus  # noqa: F811
+    from remo_cli.cli.providers.hetzner import hetzner  # noqa: F811
+    from remo_cli.cli.providers.aws import aws  # noqa: F811
+
+    cli.add_command(shell)
+    cli.add_command(cp)
+    cli.add_command(incus)
+    cli.add_command(hetzner)
+    cli.add_command(aws)
+
+
+_register_commands()

remo_cli/cli/providers/aws.py

@@ -0,0 +1,153 @@
+"""remo aws commands - Manage AWS EC2 instances."""
+
+from __future__ import annotations
+
+import sys
+
+import click
+
+
+@click.group()
+def aws() -> None:
+    """Manage AWS EC2 instances with EBS storage."""
+
+
+@aws.command()
+@click.option("--name", default="", help="Instance name (defaults to $USER).")
+@click.option("--type", "instance_type", default="", help="EC2 instance type.")
+@click.option("--region", default="", help="AWS region.")
+@click.option("--volume-size", default="", help="EBS volume size in GB.")
+@click.option("--spot", is_flag=True, default=False, help="Use spot instance.")
+@click.option("--iam-profile", default="", help="IAM instance profile name.")
+@click.option("--only", multiple=True, help="Only configure these tools.")
+@click.option("--skip", multiple=True, help="Skip configuring these tools.")
+@click.option("--yes", "-y", "auto_confirm", is_flag=True, default=False, help="Skip confirmation prompts.")
+@click.option("-v", "--verbose", is_flag=True, default=False, help="Verbose output.")
+def create(
+    name: str,
+    instance_type: str,
+    region: str,
+    volume_size: str,
+    spot: bool,
+    iam_profile: str,
+    only: tuple[str, ...],
+    skip: tuple[str, ...],
+    auto_confirm: bool,
+    verbose: bool,
+) -> None:
+    """Create a new AWS EC2 instance."""
+    from remo_cli.providers.aws import create as aws_create
+
+    rc = aws_create(
+        name=name,
+        instance_type=instance_type,
+        region=region,
+        volume_size=volume_size,
+        use_spot=spot,
+        iam_profile=iam_profile,
+        tools_only=only,
+        tools_skip=skip,
+        verbose=verbose,
+    )
+    sys.exit(rc)
+
+
+@aws.command()
+@click.option("--name", default="", help="Instance name (defaults to $USER).")
+@click.option("--remove-storage", is_flag=True, default=False, help="Also remove EBS storage volume.")
+@click.option("--yes", "-y", "auto_confirm", is_flag=True, default=False, help="Skip confirmation prompts.")
+@click.option("-v", "--verbose", is_flag=True, default=False, help="Verbose output.")
+def destroy(
+    name: str,
+    remove_storage: bool,
+    auto_confirm: bool,
+    verbose: bool,
+) -> None:
+    """Destroy an AWS EC2 instance."""
+    from remo_cli.providers.aws import destroy as aws_destroy
+
+    rc = aws_destroy(
+        name=name,
+        auto_confirm=auto_confirm,
+        remove_storage=remove_storage,
+        verbose=verbose,
+    )
+    sys.exit(rc)
+
+
+@aws.command()
+@click.option("--name", default="", help="Instance name (defaults to $USER).")
+@click.option("--only", multiple=True, help="Only configure these tools.")
+@click.option("--skip", multiple=True, help="Skip configuring these tools.")
+@click.option("-v", "--verbose", is_flag=True, default=False, help="Verbose output.")
+def update(
+    name: str,
+    only: tuple[str, ...],
+    skip: tuple[str, ...],
+    verbose: bool,
+) -> None:
+    """Re-configure dev tools on an existing AWS instance."""
+    from remo_cli.providers.aws import update as aws_update
+
+    rc = aws_update(
+        name=name,
+        tools_only=only,
+        tools_skip=skip,
+        verbose=verbose,
+    )
+    sys.exit(rc)
+
+
+@aws.command("list")
+def list_cmd() -> None:
+    """List registered AWS instances."""
+    from remo_cli.providers.aws import list_hosts
+
+    list_hosts()
+
+
+@aws.command()
+@click.option("--region", default="", help="AWS region to sync.")
+def sync(region: str) -> None:
+    """Sync local registry with running AWS instances."""
+    from remo_cli.providers.aws import sync as aws_sync
+
+    aws_sync(region=region)
+
+
+@aws.command()
+@click.option("--name", default="", help="Instance name (defaults to $USER).")
+@click.option("--yes", "-y", "auto_confirm", is_flag=True, default=False, help="Skip confirmation prompts.")
+def stop(name: str, auto_confirm: bool) -> None:
+    """Stop an AWS EC2 instance."""
+    from remo_cli.providers.aws import stop as aws_stop
+
+    aws_stop(name=name, auto_confirm=auto_confirm)
+
+
+@aws.command()
+@click.option("--name", default="", help="Instance name (defaults to $USER).")
+def start(name: str) -> None:
+    """Start a stopped AWS EC2 instance."""
+    from remo_cli.providers.aws import start as aws_start
+
+    aws_start(name=name)
+
+
+@aws.command()
+@click.option("--name", default="", help="Instance name (defaults to $USER).")
+@click.option("--yes", "-y", "auto_confirm", is_flag=True, default=False, help="Skip confirmation prompts.")
+def reboot(name: str, auto_confirm: bool) -> None:
+    """Reboot an AWS EC2 instance."""
+    from remo_cli.providers.aws import reboot as aws_reboot
+
+    aws_reboot(name=name, auto_confirm=auto_confirm)
+
+
+@aws.command()
+@click.option("--name", default="", help="Instance name (defaults to $USER).")
+def info(name: str) -> None:
+    """Show detailed info about an AWS EC2 instance."""
+    from remo_cli.providers.aws import info as aws_info
+
+    aws_info(name=name)

remo_cli/cli/providers/hetzner.py

@@ -0,0 +1,108 @@
+"""remo hetzner commands - Manage Hetzner Cloud VMs."""
+
+from __future__ import annotations
+
+import sys
+
+import click
+
+
+@click.group()
+def hetzner() -> None:
+    """Manage Hetzner Cloud VMs."""
+
+
+@hetzner.command()
+@click.option("--name", default="", help="Server name (default: remote-coding-server).")
+@click.option("--type", "server_type", default="", help="Server type (default: cx22).")
+@click.option("--location", default="", help="Location (default: hel1).")
+@click.option("--volume-size", default="", help="Volume size in GB (default: 10).")
+@click.option("--only", multiple=True, help="Only install these tools.")
+@click.option("--skip", multiple=True, help="Skip these tools.")
+@click.option("--yes", "-y", is_flag=True, help="Skip confirmation prompts.")
+@click.option("-v", "--verbose", is_flag=True, help="Enable verbose output.")
+def create(
+    name: str,
+    server_type: str,
+    location: str,
+    volume_size: str,
+    only: tuple[str, ...],
+    skip: tuple[str, ...],
+    yes: bool,
+    verbose: bool,
+) -> None:
+    """Provision a new Hetzner Cloud VM."""
+    from remo_cli.providers.hetzner import create as do_create
+
+    rc = do_create(
+        name=name,
+        server_type=server_type,
+        location=location,
+        volume_size=volume_size,
+        tools_only=only,
+        tools_skip=skip,
+        verbose=verbose,
+    )
+    sys.exit(rc)
+
+
+@hetzner.command()
+@click.option("--name", default="", help="Server name (default: remote-coding-server).")
+@click.option("--remove-volume", is_flag=True, help="Also remove persistent volume.")
+@click.option("--yes", "-y", is_flag=True, help="Skip confirmation prompts.")
+@click.option("-v", "--verbose", is_flag=True, help="Enable verbose output.")
+def destroy(
+    name: str,
+    remove_volume: bool,
+    yes: bool,
+    verbose: bool,
+) -> None:
+    """Tear down a Hetzner Cloud VM."""
+    from remo_cli.providers.hetzner import destroy as do_destroy
+
+    rc = do_destroy(
+        name=name,
+        auto_confirm=yes,
+        remove_volume=remove_volume,
+        verbose=verbose,
+    )
+    sys.exit(rc)
+
+
+@hetzner.command()
+@click.option("--name", default="", help="Server name (default: remote-coding-server).")
+@click.option("--only", multiple=True, help="Only install these tools.")
+@click.option("--skip", multiple=True, help="Skip these tools.")
+@click.option("-v", "--verbose", is_flag=True, help="Enable verbose output.")
+def update(
+    name: str,
+    only: tuple[str, ...],
+    skip: tuple[str, ...],
+    verbose: bool,
+) -> None:
+    """Update dev tools on an existing VM."""
+    from remo_cli.providers.hetzner import update as do_update
+
+    rc = do_update(
+        name=name,
+        tools_only=only,
+        tools_skip=skip,
+        verbose=verbose,
+    )
+    sys.exit(rc)
+
+
+@hetzner.command("list")
+def list_cmd() -> None:
+    """List registered Hetzner VMs."""
+    from remo_cli.providers.hetzner import list_hosts
+
+    list_hosts()
+
+
+@hetzner.command()
+def sync() -> None:
+    """Discover VMs and update registry."""
+    from remo_cli.providers.hetzner import sync as do_sync
+
+    do_sync()

remo_cli/cli/providers/incus.py

@@ -0,0 +1,132 @@
+"""remo incus commands - Manage Incus containers."""
+
+from __future__ import annotations
+
+import sys
+
+import click
+
+from remo_cli.providers import incus as providers_incus
+
+
+@click.group()
+def incus() -> None:
+    """Manage Incus containers (local or remote host)."""
+
+
+@incus.command()
+@click.option("--name", default="dev1", help="Container name (default: dev1).")
+@click.option("--host", default="localhost", help="Incus host (default: localhost).")
+@click.option("--user", default="", help="SSH user for remote Incus host.")
+@click.option("--domain", default="", help="Domain name for the container.")
+@click.option("--image", default="", help="Container image to use.")
+@click.option("--only", multiple=True, help="Only install these tools.")
+@click.option("--skip", multiple=True, help="Skip these tools.")
+@click.option("--yes", "-y", is_flag=True, help="Auto-confirm prompts.")
+@click.option("-v", "--verbose", is_flag=True, help="Verbose output.")
+def create(
+    name: str,
+    host: str,
+    user: str,
+    domain: str,
+    image: str,
+    only: tuple[str, ...],
+    skip: tuple[str, ...],
+    yes: bool,
+    verbose: bool,
+) -> None:
+    """Create an Incus container."""
+    rc = providers_incus.create(
+        name=name,
+        host=host,
+        user=user,
+        domain=domain,
+        image=image,
+        tools_only=only,
+        tools_skip=skip,
+        verbose=verbose,
+    )
+    sys.exit(rc)
+
+
+@incus.command()
+@click.option("--name", default="dev1", help="Container name (default: dev1).")
+@click.option("--host", default="", help="Incus host (default: auto-detect).")
+@click.option("--user", default="", help="SSH user for remote Incus host.")
+@click.option("--remove-storage", is_flag=True, help="Also remove storage volume.")
+@click.option("--yes", "-y", is_flag=True, help="Auto-confirm prompts.")
+@click.option("-v", "--verbose", is_flag=True, help="Verbose output.")
+def destroy(
+    name: str,
+    host: str,
+    user: str,
+    remove_storage: bool,
+    yes: bool,
+    verbose: bool,
+) -> None:
+    """Destroy an Incus container."""
+    rc = providers_incus.destroy(
+        name=name,
+        host=host,
+        user=user,
+        auto_confirm=yes,
+        verbose=verbose,
+    )
+    sys.exit(rc)
+
+
+@incus.command()
+@click.option("--name", default="dev1", help="Container name (default: dev1).")
+@click.option("--host", default="", help="Incus host (default: auto-detect).")
+@click.option("--user", default="", help="SSH user for remote Incus host.")
+@click.option("--only", multiple=True, help="Only install these tools.")
+@click.option("--skip", multiple=True, help="Skip these tools.")
+@click.option("-v", "--verbose", is_flag=True, help="Verbose output.")
+def update(
+    name: str,
+    host: str,
+    user: str,
+    only: tuple[str, ...],
+    skip: tuple[str, ...],
+    verbose: bool,
+) -> None:
+    """Update tools on an Incus container."""
+    rc = providers_incus.update(
+        name=name,
+        host=host,
+        user=user,
+        tools_only=only,
+        tools_skip=skip,
+        verbose=verbose,
+    )
+    sys.exit(rc)
+
+
+@incus.command("list")
+def list_cmd() -> None:
+    """List registered Incus containers."""
+    providers_incus.list_hosts()
+
+
+@incus.command()
+@click.option("--host", default="localhost", help="Incus host (default: localhost).")
+@click.option("--user", default="", help="SSH user for remote Incus host.")
+def sync(host: str, user: str) -> None:
+    """Discover containers from an Incus host."""
+    providers_incus.sync(host=host, user=user)
+
+
+@incus.command()
+@click.option("--host", default="localhost", help="Incus host (default: localhost).")
+@click.option("--user", default="", help="SSH user for remote Incus host.")
+@click.option("--network-type", default="", help="Network type for Incus host.")
+@click.option("-v", "--verbose", is_flag=True, help="Verbose output.")
+def bootstrap(host: str, user: str, network_type: str, verbose: bool) -> None:
+    """Initialize an Incus host."""
+    rc = providers_incus.bootstrap(
+        host=host,
+        user=user,
+        network_type=network_type,
+        verbose=verbose,
+    )
+    sys.exit(rc)

remo_cli/cli/shell.py

@@ -0,0 +1,32 @@
+"""remo shell command - Connect to a remote environment."""
+
+from __future__ import annotations
+
+import click
+
+
+@click.command()
+@click.argument("name", required=False, default=None)
+@click.option(
+    "-L",
+    "tunnels",
+    multiple=True,
+    help="Forward port: PORT or LOCAL:REMOTE",
+)
+@click.option(
+    "--no-open",
+    is_flag=True,
+    default=False,
+    help="Skip auto-opening browser for tunneled ports",
+)
+def shell(name: str | None, tunnels: tuple[str, ...], no_open: bool) -> None:
+    """Connect to a remo environment (auto-detects or picker)."""
+    from remo_cli.core.ssh import resolve_remo_host, shell_connect  # noqa: PLC0415
+    from remo_cli.providers.aws import auto_start_aws_if_stopped  # noqa: PLC0415
+
+    host = resolve_remo_host(name)
+
+    # Auto-start stopped AWS instances before connecting
+    host = auto_start_aws_if_stopped(host)
+
+    shell_connect(host, list(tunnels), no_open)