Files

260 lines
9.6 KiB
Python

# Copyright 2026 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
import io
import os
import subprocess
import sys
import pytest
from rich.console import Console
from artemis.interfaces.cli.commands import ui
from artemis.interfaces.cli.commands.ui import (
_npm_install_required,
_resolve_npm_executable,
_run_build_step,
_showcase_build_required,
ensure_showcase_built,
)
def test_resolve_npm_executable_prefers_windows_command_shim(monkeypatch):
paths = {
"npm.cmd": r"C:\Program Files\nodejs\npm.cmd",
"npm.exe": None,
"npm": r"C:\Program Files\nodejs\npm.cmd",
}
monkeypatch.setattr(ui.shutil, "which", paths.get)
assert _resolve_npm_executable("win32") == paths["npm.cmd"]
def test_resolve_npm_executable_uses_npm_on_posix(monkeypatch):
monkeypatch.setattr(
ui.shutil,
"which",
lambda command: "/usr/local/bin/npm" if command == "npm" else None,
)
assert _resolve_npm_executable("linux") == "/usr/local/bin/npm"
def test_showcase_build_required_when_source_is_newer(tmp_path):
showcase_dir = tmp_path / "showcase_ui"
source_file = showcase_dir / "src" / "app" / "agent.service.ts"
built_index = showcase_dir / "dist" / "frontend" / "browser" / "index.html"
source_file.parent.mkdir(parents=True)
built_index.parent.mkdir(parents=True)
source_file.write_text("source", encoding="utf-8")
built_index.write_text("build", encoding="utf-8")
os.utime(built_index, (100, 100))
os.utime(source_file, (200, 200))
assert _showcase_build_required(showcase_dir) is True
def test_showcase_build_not_required_when_build_is_current(tmp_path):
showcase_dir = tmp_path / "showcase_ui"
source_file = showcase_dir / "src" / "app" / "agent.service.ts"
built_index = showcase_dir / "dist" / "frontend" / "browser" / "index.html"
source_file.parent.mkdir(parents=True)
built_index.parent.mkdir(parents=True)
source_file.write_text("source", encoding="utf-8")
built_index.write_text("build", encoding="utf-8")
os.utime(source_file, (100, 100))
os.utime(built_index, (200, 200))
assert _showcase_build_required(showcase_dir) is False
def _showcase_with_manifests(tmp_path, *, stamp_mtime=None):
showcase_dir = tmp_path / "showcase_ui"
showcase_dir.mkdir()
for name in ("package.json", "package-lock.json"):
path = showcase_dir / name
path.write_text("{}", encoding="utf-8")
os.utime(path, (100, 100))
if stamp_mtime is not None:
stamp = showcase_dir / "node_modules" / ".package-lock.json"
stamp.parent.mkdir()
stamp.write_text("{}", encoding="utf-8")
os.utime(stamp, (stamp_mtime, stamp_mtime))
return showcase_dir
def test_npm_install_required_when_node_modules_missing(tmp_path):
assert _npm_install_required(_showcase_with_manifests(tmp_path)) is True
def test_npm_install_not_required_when_lock_stamp_is_current(tmp_path):
assert _npm_install_required(_showcase_with_manifests(tmp_path, stamp_mtime=200)) is False
def test_npm_install_required_when_package_lock_is_newer(tmp_path):
showcase_dir = _showcase_with_manifests(tmp_path, stamp_mtime=200)
os.utime(showcase_dir / "package-lock.json", (300, 300))
assert _npm_install_required(showcase_dir) is True
def _recording_console():
return Console(file=io.StringIO(), force_terminal=False, width=120)
@pytest.mark.parametrize("language", ["zh-CN", "en"])
@pytest.mark.parametrize("choice", ["", "2", "3"])
def test_existing_server_prompt_respects_launch_language(monkeypatch, language, choice):
from artemis.runtime import server_lifecycle
console = _recording_console()
monkeypatch.setenv("ARTEMIS_LAUNCH_LANG", language)
monkeypatch.setattr(ui, "Console", lambda: console)
monkeypatch.setattr(ui.sys.stdin, "isatty", lambda: True)
monkeypatch.setattr(server_lifecycle, "is_port_in_use", lambda port: True)
monkeypatch.setattr(server_lifecycle, "find_server_pids", lambda port: [1234])
prompts, opened, stopped = [], [], []
monkeypatch.setattr("builtins.input", lambda prompt: prompts.append(prompt) or choice)
monkeypatch.setattr(ui.webbrowser, "open", opened.append)
monkeypatch.setattr(ui, "load_session_reconciler", lambda: None)
class RestartSelected(Exception):
pass
def stop_server(**kwargs):
stopped.append(kwargs)
raise RestartSelected # Never launch or stop a real service.
monkeypatch.setattr(server_lifecycle, "stop_server", stop_server)
if choice == "2":
with pytest.raises(RestartSelected):
ui.ui_command(port=8123)
else:
ui.ui_command(port=8123)
output = console.file.getvalue()
assert "8123" in output and "PID: 1234" in output
if language == "zh-CN":
assert all(
text in output
for text in ("服务正在运行", "请选择操作", "打开浏览器(默认)", "重启服务", "取消")
)
assert "请输入选项" in prompts[0]
assert "Choose an action" not in output and "Restart server" not in output
if choice == "2":
assert "正在停止端口 8123" in output
else:
assert "Choose an action" in output and "Open browser (default)" in output
assert "Select [1-3, default 1]" in prompts[0]
assert opened == (["http://localhost:8123"] if not choice else [])
assert stopped == ([{"port": 8123, "timeout": 12.0}] if choice == "2" else [])
@pytest.mark.parametrize("language", ["zh-CN", None])
@pytest.mark.parametrize("open_browser", [True, False])
def test_existing_server_noninteractive_does_not_restart(monkeypatch, language, open_browser):
from artemis.runtime import server_lifecycle
console = _recording_console()
if language:
monkeypatch.setenv("ARTEMIS_LAUNCH_LANG", language)
else:
monkeypatch.delenv("ARTEMIS_LAUNCH_LANG", raising=False)
monkeypatch.setattr(ui, "Console", lambda: console)
monkeypatch.setattr(ui.sys.stdin, "isatty", lambda: False)
monkeypatch.setattr(server_lifecycle, "is_port_in_use", lambda port: True)
monkeypatch.setattr(server_lifecycle, "find_server_pids", lambda port: [])
monkeypatch.setattr(
server_lifecycle, "stop_server", lambda **kwargs: pytest.fail("Unexpected restart")
)
opened = []
monkeypatch.setattr(ui.webbrowser, "open", opened.append)
ui.ui_command(port=8123, open_browser=open_browser)
output = console.file.getvalue()
assert "artemis restart" in output
assert ("服务正在运行" if language else "already in use") in output
assert opened == (["http://localhost:8123"] if open_browser else [])
def test_ensure_showcase_built_skips_install_when_deps_current(monkeypatch):
steps = []
monkeypatch.setattr(ui, "_showcase_build_required", lambda showcase_dir: True)
monkeypatch.setattr(ui, "_npm_install_required", lambda showcase_dir: False)
monkeypatch.setattr(ui, "_resolve_npm_executable", lambda: "npm")
monkeypatch.setattr(
ui, "_run_build_step", lambda console, label, cmd, cwd: steps.append((label, cmd))
)
console = _recording_console()
ensure_showcase_built(console)
assert [label for label, _ in steps] == ["② ng build"]
assert steps[0][1] == ["npm", "run", "build"]
assert "Showcase UI built in" in console.file.getvalue()
def test_ensure_showcase_built_runs_install_first_when_deps_changed(monkeypatch):
steps = []
monkeypatch.setattr(ui, "_showcase_build_required", lambda showcase_dir: True)
monkeypatch.setattr(ui, "_npm_install_required", lambda showcase_dir: True)
monkeypatch.setattr(ui, "_resolve_npm_executable", lambda: "npm")
monkeypatch.setattr(
ui, "_run_build_step", lambda console, label, cmd, cwd: steps.append((label, cmd))
)
ensure_showcase_built(_recording_console())
assert [label for label, _ in steps] == ["① npm install (dependencies changed)", "② ng build"]
assert steps[0][1] == ["npm", "install", "--no-audit", "--no-fund", "--loglevel=warn"]
def test_ensure_showcase_built_reports_failure_with_manual_command(monkeypatch):
monkeypatch.setattr(ui, "_showcase_build_required", lambda showcase_dir: True)
monkeypatch.setattr(ui, "_npm_install_required", lambda showcase_dir: False)
monkeypatch.setattr(ui, "_resolve_npm_executable", lambda: "npm")
def failing_step(console, label, cmd, cwd):
raise subprocess.CalledProcessError(1, cmd)
monkeypatch.setattr(ui, "_run_build_step", failing_step)
console = _recording_console()
ensure_showcase_built(console) # must not raise: the server still starts
output = console.file.getvalue()
assert "Failed to auto-build Showcase UI" in output
assert "npm install && npm run build" in output
def test_run_build_step_streams_child_output_and_raises_on_failure(tmp_path):
console = _recording_console()
cmd = [sys.executable, "-c", "print('hello from child'); import sys; sys.exit(3)"]
with pytest.raises(subprocess.CalledProcessError) as excinfo:
_run_build_step(console, "② ng build", cmd, tmp_path)
assert excinfo.value.returncode == 3
output = console.file.getvalue()
assert "② ng build" in output
assert "hello from child" in output
def test_run_build_step_strips_ansi_and_succeeds(tmp_path):
console = _recording_console()
cmd = [sys.executable, "-c", "print('\\x1b[32mdone\\x1b[0m')"]
_run_build_step(console, "step", cmd, tmp_path)
output = console.file.getvalue()
assert "done" in output
assert "\x1b[32m" not in output