trycua--cua/tests/integration/sandbox_cli/test_android_local_vm.py

"""Launch a persistent local Android VM via the CLI.

    cua sb launch android:14 --local --json
    # parse name from JSON output, connect with SDK, run assertions
    cua sb delete <name> --local

Mirrors tests/integration/sandbox_sdk/test_android_local_vm.py but exercises the CLI
launch path and persistent state tracking instead of Sandbox.ephemeral().
Requires Android SDK (emulator + adb) to be installed.
"""

from __future__ import annotations

import asyncio
import json
import subprocess

import pytest
from cua_sandbox import Sandbox

pytestmark = pytest.mark.asyncio


def _has_java() -> bool:
    """Only Java must be pre-installed — the Android SDK auto-installs on first run."""
    try:
        from cua_sandbox.runtime.android_emulator import _java_env

        _java_env()
        return True
    except Exception:
        return False


def _cua(*args: str) -> subprocess.CompletedProcess:
    return subprocess.run(["cua", *args], capture_output=True, text=True)


def _ls_names() -> list[str]:
    r = _cua("sb", "ls", "--all", "--json")
    if r.returncode != 0:
        return []
    return [s["name"] for s in json.loads(r.stdout)]


@pytest.mark.skipif(not _has_java(), reason="Java not found (required to auto-install Android SDK)")
async def test_android_local_vm():
    result = _cua("sb", "launch", "android:14", "--local", "--json")
    assert result.returncode == 0, f"launch failed:\n{result.stderr}"
    name = json.loads(result.stdout)["name"]

    assert name in _ls_names(), f"'{name}' not found in `cua sb ls --all` after launch"

    try:
        async with Sandbox.connect(name, local=True) as sb:
            screenshot = await sb.screenshot()
            assert screenshot[:4] == b"\x89PNG"
            assert len(screenshot) > 10000

            w, h = await sb.screen.size()
            assert w > 0 and h > 0

            await sb.mobile.home()
    finally:
        _cua("sb", "delete", name, "--local")
        assert name not in _ls_names(), f"'{name}' still in `cua sb ls --all` after delete"


async def main():
    r = _cua("sb", "launch", "android:14", "--local", "--json")
    print(f"launch exit={r.returncode}")
    name = json.loads(r.stdout)["name"]
    print(f"name: {name}")

    try:
        async with Sandbox.connect(name, local=True) as sb:
            screenshot = await sb.screenshot()
            print(f"Screenshot: {len(screenshot)} bytes")
            with open("/tmp/cli_android_local_vm.png", "wb") as f:
                f.write(screenshot)
            w, h = await sb.screen.size()
            print(f"Screen size: {w}x{h}")
            await sb.mobile.tap(w // 2, h // 2)
            await sb.mobile.home()
            print("Tap + home: OK")
    finally:
        _cua("sb", "delete", name, "--local")


if __name__ == "__main__":
    asyncio.run(main())