lookout-cli 5.1.0__tar.gz → 5.2.0__tar.gz

{lookout_cli-5.1.0 → lookout_cli-5.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lookout_cli
-Version: 5.1.0
+Version: 5.2.0
 Summary: A CLI for interacting with Lookout+
 Author-email: Greenroom Robotics <team@greenroomrobotics.com>
 Maintainer-email: David Revay <david.revay@greenroomrobotics.com>

{lookout_cli-5.1.0 → lookout_cli-5.2.0}/lookout_cli/cli.py

@@ -38,6 +38,7 @@ def cli():
     if dev_mode:
         lookout_cli.add_command(base.build)
         lookout_cli.add_command(base.lint)
+        lookout_cli.add_command(base.test)
         lookout_cli.add_command(base.bake)
         lookout_cli.add_command(base.manifest)
         lookout_cli.add_command(base.sbom)

lookout_cli-5.2.0/lookout_cli/docker/docker-compose.cpu.yaml

@@ -0,0 +1,11 @@
+name: lookout
+
+# Drops the NVIDIA device reservations so the stack can start on machines
+# without a GPU (e.g. CI runners). Selected automatically by the CLI when
+# nvidia-smi is absent.
+services:
+  lookout_core:
+    deploy: !reset null
+
+  lookout_greenstream:
+    deploy: !reset null

{lookout_cli-5.1.0 → lookout_cli-5.2.0}/lookout_cli/docker/docker-compose.yaml

@@ -23,6 +23,7 @@ services:
       - ZENOH_CONFIG_OVERRIDE
       - LOOKOUT_CONFIG
       - LOOKOUT_CONFIG_DIR
+      - LOOKOUT_TEST_MODE
       - NVIDIA_VISIBLE_DEVICES=all
       - NVIDIA_DRIVER_CAPABILITIES=compute,utility,video,graphics
       - DISPLAY

{lookout_cli-5.1.0 → lookout_cli-5.2.0}/lookout_cli/groups/base.py

@@ -1,6 +1,9 @@
 import os
 import platform
+import shutil
+import socket
 import subprocess
+import time
 from pathlib import Path
 from typing import List, Optional, cast
 
@@ -56,6 +59,7 @@ DOCKER_NETWORK_HOST = docker_compose_path("./docker-compose.network-host.yaml")
 DOCKER_NETWORK_PROXY = docker_compose_path("./docker-compose.network-proxy.yaml")
 DOCKER_JETSON = docker_compose_path("./docker-compose.jetson.yaml")
 DOCKER_X86 = docker_compose_path("./docker-compose.x86.yaml")
+DOCKER_CPU = docker_compose_path("./docker-compose.cpu.yaml")
 
 SERVICES = [
     "lookout_core",
@@ -95,6 +99,9 @@ def _get_compose_files(
         compose_files.append(DOCKER_JETSON)
     else:
         compose_files.append(DOCKER_X86)
+        if shutil.which("nvidia-smi") is None:
+            # no NVIDIA driver (e.g. CI runners): drop the GPU device reservations
+            compose_files.append(DOCKER_CPU)
 
     if proxy:
         compose_files.append(DOCKER_NETWORK_PROXY)
@@ -153,6 +160,18 @@ def log_config(config: LookoutConfig):
         )
 
 
+def _prepare_mounted_dirs(config: LookoutConfig) -> None:
+    """Create the host directories the containers bind-mount; docker would
+    otherwise create missing mount sources root-owned (e.g. on CI runners)."""
+    get_config_io().get_path().chmod(0o777)
+    greenroom_tmp_directory = Path("/tmp/greenroom")
+    make_dir_set_permission(Path(config.log_directory).expanduser())
+    make_dir_set_permission(Path(config.recording_directory).expanduser())
+    make_dir_set_permission(Path(config.models_directory).expanduser())
+    make_dir_set_permission(greenroom_tmp_directory)
+    make_dir_set_permission(greenroom_tmp_directory / "sockets")
+
+
 def set_initial_env(config_dir: str):
     version = get_version()
     os.environ["LOOKOUT_CONFIG_DIR"] = config_dir
@@ -239,18 +258,7 @@ def up(
     if config.prod and build:
         raise click.UsageError("Cannot build in production mode. Run `lookout build` instead")
 
-    # Make the log and recordings directories
-    log_directory = Path(config.log_directory).expanduser()
-    recording_directory = Path(config.recording_directory).expanduser()
-    models_directory = Path(config.models_directory).expanduser()
-    greenroom_tmp_directory = Path("/tmp/greenroom")
-    sockets_directory = greenroom_tmp_directory / "sockets"
-    get_config_io().get_path().chmod(0o777)
-    make_dir_set_permission(log_directory)
-    make_dir_set_permission(recording_directory)
-    make_dir_set_permission(models_directory)
-    make_dir_set_permission(greenroom_tmp_directory)
-    make_dir_set_permission(sockets_directory)
+    _prepare_mounted_dirs(config)
     set_env_from_config(config)
 
     services_list = list(services) if services else None
@@ -452,6 +460,102 @@ def lint():
     call("pre-commit run --all")
 
 
+def _wait_for_port(port: int, timeout: float) -> bool:
+    deadline = time.time() + timeout
+    while time.time() < deadline:
+        try:
+            with socket.create_connection(("localhost", port), timeout=0.5):
+                return True
+        except OSError:
+            time.sleep(0.5)
+    return False
+
+
+def _dump_container_logs(container: str, tail: int = 150) -> None:
+    """Print a container's recent logs so a failure is diagnosable (e.g. in CI)."""
+    click.echo(click.style(f"--- last {tail} log lines from {container} ---", fg="yellow"))
+    try:
+        subprocess.run(["docker", "logs", "--tail", str(tail), container], check=False, timeout=15)
+    except (OSError, subprocess.TimeoutExpired) as error:
+        click.echo(f"could not fetch logs: {error}")
+
+
+def _container_env(container: str) -> str | None:
+    """The container's environment, or None when it can't be inspected."""
+    try:
+        result = subprocess.run(
+            ["docker", "inspect", container, "--format", "{{json .Config.Env}}"],
+            capture_output=True,
+            text=True,
+            check=False,
+            timeout=15,
+        )
+    except (OSError, subprocess.TimeoutExpired):
+        return None
+    return result.stdout if result.returncode == 0 else None
+
+
+@click.command(name="test")
+@click.option(
+    "--up",
+    type=bool,
+    default=False,
+    is_flag=True,
+    help="Bring up lookout_core first instead of requiring a running stack",
+)
+@config_dir_option
+@click.argument("args", nargs=-1)
+def test(up: bool, config_dir: str, args: tuple[str, ...]) -> None:
+    """Runs the platform bridge smoke tests against a running Lookout.
+
+    Bring the stack up first (`lookout up`), or pass --up. Extra ARGS are
+    forwarded to pytest (e.g. `-- -k tracks`).
+    """
+    set_initial_env(config_dir)
+    dev_mode = is_dev_version()
+
+    config = get_config_io().read()
+    config.prod = maybe_ignore_prod(dev_mode, config.prod)
+    set_env_from_config(config)
+
+    # the bridge trusts the committed test keypair so the tests can mint tokens (keys/README.md)
+    os.environ["LOOKOUT_TEST_MODE"] = "true"
+
+    if up:
+        _prepare_mounted_dirs(config)
+        docker = _get_docker_client(prod=config.prod, proxy=config.proxy.enabled)
+        services = ["lookout_core"] + (["lookout_proxy"] if config.proxy.enabled else [])
+        docker.compose.up(services, detach=True)
+
+    click.echo("Waiting for the platform bridge on localhost:50051...")
+    if not _wait_for_port(50051, timeout=180):
+        _dump_container_logs("lookout_core")
+        raise click.UsageError(
+            "The platform bridge is not reachable on localhost:50051 — run "
+            "`LOOKOUT_TEST_MODE=true lookout up` first (or pass --up)"
+        )
+    if not up:
+        env = _container_env("lookout_core")
+        if env is not None and "LOOKOUT_TEST_MODE=true" not in env:
+            raise click.UsageError(
+                "lookout_core is running without LOOKOUT_TEST_MODE=true, so the bridge "
+                "will reject test tokens — restart with `LOOKOUT_TEST_MODE=true lookout up` "
+                "or pass --up"
+            )
+    if config.proxy.enabled and not _wait_for_port(config.proxy.https_port, timeout=60):
+        _dump_container_logs("lookout_proxy")
+        raise click.UsageError(
+            f"The proxy is not reachable on localhost:{config.proxy.https_port}"
+        )
+
+    # missing client deps fail instead of skipping; see tests/integration/README.md
+    os.environ["LOOKOUT_INTEGRATION_REQUIRE"] = "1"
+    tests_dir = Path(get_project_root()) / "tests" / "integration"
+    result = subprocess.run(["python3", "-m", "pytest", "-v", str(tests_dir), *args], check=False)
+    if result.returncode != 0:
+        raise SystemExit(result.returncode)
+
+
 @click.command(name="generate")
 @config_dir_option
 @click.option(

{lookout_cli-5.1.0 → lookout_cli-5.2.0}/lookout_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lookout_cli
-Version: 5.1.0
+Version: 5.2.0
 Summary: A CLI for interacting with Lookout+
 Author-email: Greenroom Robotics <team@greenroomrobotics.com>
 Maintainer-email: David Revay <david.revay@greenroomrobotics.com>

{lookout_cli-5.1.0 → lookout_cli-5.2.0}/lookout_cli.egg-info/SOURCES.txt

@@ -15,6 +15,7 @@ lookout_cli.egg-info/requires.txt
 lookout_cli.egg-info/top_level.txt
 lookout_cli.egg-info/zip-safe
 lookout_cli/docker/docker-compose.cache.yaml
+lookout_cli/docker/docker-compose.cpu.yaml
 lookout_cli/docker/docker-compose.dev.yaml
 lookout_cli/docker/docker-compose.jetson.yaml
 lookout_cli/docker/docker-compose.network-host.yaml

{lookout_cli-5.1.0 → lookout_cli-5.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "lookout_cli"
-version = "5.1.0"
+version = "5.2.0"
 description = "A CLI for interacting with Lookout+"
 readme = "README.md"
 license = {text = "Copyright (C) 2025, Greenroom Robotics"}