# 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