"""Behavioral regression tests for Termux Python selection.""" from __future__ import annotations import os import shutil import stat import subprocess import sys from pathlib import Path REPO_ROOT = Path(__file__).resolve().parent.parent INSTALL_SH = REPO_ROOT / "scripts" / "install.sh" SETUP_HERMES_SH = REPO_ROOT / "setup-hermes.sh" def _write_executable(path: Path, content: str) -> Path: path.write_text(content) path.chmod(path.stat().st_mode | stat.S_IXUSR) return path def _write_fake_python(bin_dir: Path, name: str, version: str) -> Path: return _write_executable( bin_dir / name, f"""#!{sys.executable} import os import sys VERSION = {version!r} VERSION_INFO = tuple(int(part) for part in VERSION.split('.')[:3]) + ('final', 0) if len(sys.argv) >= 2 and sys.argv[1] == '--version': print(f'Python {{VERSION}}') raise SystemExit(0) if len(sys.argv) >= 3 and sys.argv[1] == '-c': sys.version = f'{{VERSION}} (fake)' sys.version_info = VERSION_INFO exec(sys.argv[2], {{'__name__': '__main__'}}) raise SystemExit(0) if len(sys.argv) >= 3 and sys.argv[1:3] == ['-m', 'venv']: target = sys.argv[3] if len(sys.argv) >= 4 else 'venv' bin_path = os.path.join(target, 'bin') os.makedirs(bin_path, exist_ok=True) python_path = os.path.join(bin_path, 'python') with open(python_path, 'w', encoding='utf-8') as handle: handle.write('''#!/bin/sh\nif [ "${{1:-}}" = '-m' ] && [ "${{2:-}}" = 'pip' ]; then\n exit 0\nfi\nexit 0\n''') os.chmod(python_path, 0o755) raise SystemExit(0) raise SystemExit(0) """, ) def _write_unsupported_explicit_pythons(bin_dir: Path, *except_names: str) -> None: for name in ("python3.11", "python3.12", "python3.13"): if name not in except_names and not (bin_dir / name).exists(): _write_fake_python(bin_dir, name, "3.14.6") def _write_termux_command_stubs(bin_dir: Path) -> None: _write_executable( bin_dir / "uname", "#!/bin/sh\n[ \"${1:-}\" = '-s' ] && echo Linux || echo Linux\n", ) if not (bin_dir / "pkg").exists(): _write_executable(bin_dir / "pkg", "#!/bin/sh\nexit 0\n") _write_executable(bin_dir / "git", "#!/bin/sh\necho 'git version 2.50.0'\n") _write_executable(bin_dir / "node", "#!/bin/sh\necho 'v22.12.0'\n") _write_executable(bin_dir / "npm", "#!/bin/sh\nexit 0\n") _write_executable(bin_dir / "curl", "#!/bin/sh\nexit 0\n") _write_executable(bin_dir / "rg", "#!/bin/sh\nexit 0\n") def _termux_env(tmp_path: Path, bin_dir: Path) -> dict[str, str]: prefix = tmp_path / "com.termux" / "files" / "usr" (prefix / "bin").mkdir(parents=True) env = os.environ.copy() env.update({ "ANDROID_API_LEVEL": "35", "HOME": str(tmp_path / "home"), "HERMES_HOME": str(tmp_path / "home" / ".hermes"), "PATH": f"{bin_dir}{os.pathsep}{env.get('PATH', os.defpath)}", "PREFIX": str(prefix), "TERMUX_VERSION": "0.118.0", }) return env def _run_install_prerequisites(tmp_path: Path) -> subprocess.CompletedProcess[str]: bin_dir = tmp_path / "bin" bin_dir.mkdir(exist_ok=True) _write_termux_command_stubs(bin_dir) env = _termux_env(tmp_path, bin_dir) bash = shutil.which("bash") or "/bin/bash" return subprocess.run( [bash, str(INSTALL_SH), "--stage", "prerequisites", "--non-interactive"], env=env, text=True, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, check=False, ) def _copy_setup_checkout(tmp_path: Path) -> Path: checkout = tmp_path / "checkout" checkout.mkdir() shutil.copy2(SETUP_HERMES_SH, checkout / "setup-hermes.sh") return checkout def _run_setup(tmp_path: Path) -> subprocess.CompletedProcess[str]: bin_dir = tmp_path / "bin" bin_dir.mkdir(exist_ok=True) _write_termux_command_stubs(bin_dir) env = _termux_env(tmp_path, bin_dir) checkout = _copy_setup_checkout(tmp_path) bash = shutil.which("bash") or "/bin/bash" return subprocess.run( [bash, str(checkout / "setup-hermes.sh")], env=env, input="n\n", text=True, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, check=False, ) def test_install_stage_prefers_compatible_minor_over_unsupported_default( tmp_path: Path, ) -> None: bin_dir = tmp_path / "bin" bin_dir.mkdir() _write_fake_python(bin_dir, "python3.11", "3.11.15") _write_fake_python(bin_dir, "python", "3.14.6") result = _run_install_prerequisites(tmp_path) assert result.returncode == 0, result.stdout assert "Python found: Python 3.11.15" in result.stdout def test_install_stage_rejects_post_install_unsupported_default(tmp_path: Path) -> None: bin_dir = tmp_path / "bin" bin_dir.mkdir() _write_fake_python(bin_dir, "python", "3.14.6") _write_unsupported_explicit_pythons(bin_dir) result = _run_install_prerequisites(tmp_path) assert result.returncode == 1 assert "Termux Python Python 3.14.6 is not supported" in result.stdout assert "Hermes requires Python >=3.11,<3.14" in result.stdout assert "pkg install tur-repo && pkg install python3.13" in result.stdout def test_install_stage_provisions_supported_python_from_tur(tmp_path: Path) -> None: """When the default Termux python is too new, the installer falls back to the Termux User Repository (TUR) and picks up a supported interpreter that `pkg install python3.13` provides.""" bin_dir = tmp_path / "bin" bin_dir.mkdir() _write_fake_python(bin_dir, "python", "3.14.6") # Shadow any host python3.11/3.12/3.13 so the candidate scan can't find a # supported interpreter before the TUR fallback runs. _write_unsupported_explicit_pythons(bin_dir) # Stateful pkg stub: `pkg install -y python3.13` drops a supported fake # interpreter into PATH, mimicking a successful TUR package install. staged = tmp_path / "staged" staged.mkdir() _write_fake_python(staged, "python3.13", "3.13.7") _write_executable( bin_dir / "pkg", "#!/bin/sh\n" "for arg in \"$@\"; do\n" f" if [ \"$arg\" = 'python3.13' ]; then cp {staged}/python3.13 {bin_dir}/python3.13; fi\n" "done\n" "exit 0\n", ) result = _run_install_prerequisites(tmp_path) assert result.returncode == 0, result.stdout assert "Python installed from TUR: Python 3.13.7" in result.stdout def test_setup_script_prefers_compatible_minor_over_unsupported_default( tmp_path: Path, ) -> None: bin_dir = tmp_path / "bin" bin_dir.mkdir() _write_fake_python(bin_dir, "python3.11", "3.14.6") _write_fake_python(bin_dir, "python3.12", "3.12.11") _write_fake_python(bin_dir, "python", "3.14.6") result = _run_setup(tmp_path) assert result.returncode == 0, result.stdout assert "Python 3.12.11 found" in result.stdout assert (tmp_path / "checkout" / "venv" / "bin" / "python").exists() def test_setup_script_rejects_unsupported_default(tmp_path: Path) -> None: bin_dir = tmp_path / "bin" bin_dir.mkdir() _write_fake_python(bin_dir, "python", "3.14.6") _write_unsupported_explicit_pythons(bin_dir) result = _run_setup(tmp_path) assert result.returncode == 1 assert "Termux Python Python 3.14.6 is not supported" in result.stdout assert "Hermes requires Python >=3.11,<3.14" in result.stdout