"""Tests for hermes_constants module.""" import os from pathlib import Path from unittest.mock import patch import pytest import hermes_constants from hermes_constants import ( VALID_REASONING_EFFORTS, get_default_hermes_root, is_container, parse_reasoning_effort, ) class TestGetDefaultHermesRoot: """Tests for get_default_hermes_root() — Docker/custom deployment awareness.""" def test_no_hermes_home_returns_native(self, tmp_path, monkeypatch): """When HERMES_HOME is not set, returns ~/.hermes.""" monkeypatch.delenv("HERMES_HOME", raising=False) monkeypatch.setattr(Path, "home", lambda: tmp_path) assert get_default_hermes_root() == tmp_path / ".hermes" def test_hermes_home_is_native(self, tmp_path, monkeypatch): """When HERMES_HOME = ~/.hermes, returns ~/.hermes.""" native = tmp_path / ".hermes" native.mkdir() monkeypatch.setattr(Path, "home", lambda: tmp_path) monkeypatch.setenv("HERMES_HOME", str(native)) assert get_default_hermes_root() == native def test_hermes_home_is_profile(self, tmp_path, monkeypatch): """When HERMES_HOME is a profile under ~/.hermes, returns ~/.hermes.""" native = tmp_path / ".hermes" profile = native / "profiles" / "coder" profile.mkdir(parents=True) monkeypatch.setattr(Path, "home", lambda: tmp_path) monkeypatch.setenv("HERMES_HOME", str(profile)) assert get_default_hermes_root() == native def test_hermes_home_is_docker(self, tmp_path, monkeypatch): """When HERMES_HOME points outside ~/.hermes (Docker), returns HERMES_HOME.""" docker_home = tmp_path / "opt" / "data" docker_home.mkdir(parents=True) monkeypatch.setattr(Path, "home", lambda: tmp_path) monkeypatch.setenv("HERMES_HOME", str(docker_home)) assert get_default_hermes_root() == docker_home def test_hermes_home_is_custom_path(self, tmp_path, monkeypatch): """Any HERMES_HOME outside ~/.hermes is treated as the root.""" custom = tmp_path / "my-hermes-data" custom.mkdir() monkeypatch.setattr(Path, "home", lambda: tmp_path) monkeypatch.setenv("HERMES_HOME", str(custom)) assert get_default_hermes_root() == custom def test_docker_profile_active(self, tmp_path, monkeypatch): """When a Docker profile is active (HERMES_HOME=/profiles/), returns the Docker root, not the profile dir.""" docker_root = tmp_path / "opt" / "data" profile = docker_root / "profiles" / "coder" profile.mkdir(parents=True) monkeypatch.setattr(Path, "home", lambda: tmp_path) monkeypatch.setenv("HERMES_HOME", str(profile)) assert get_default_hermes_root() == docker_root class TestIsContainer: """Tests for is_container() — Docker/Podman detection.""" def _reset_cache(self, monkeypatch): """Reset the cached detection result before each test.""" monkeypatch.setattr(hermes_constants, "_container_detected", None) def test_detects_dockerenv(self, monkeypatch, tmp_path): """/.dockerenv triggers container detection.""" self._reset_cache(monkeypatch) monkeypatch.setattr(os.path, "exists", lambda p: p == "/.dockerenv") assert is_container() is True def test_detects_containerenv(self, monkeypatch, tmp_path): """/run/.containerenv triggers container detection (Podman).""" self._reset_cache(monkeypatch) monkeypatch.setattr(os.path, "exists", lambda p: p == "/run/.containerenv") assert is_container() is True def test_detects_cgroup_docker(self, monkeypatch, tmp_path): """/proc/1/cgroup containing 'docker' triggers detection.""" import builtins self._reset_cache(monkeypatch) monkeypatch.setattr(os.path, "exists", lambda p: False) cgroup_file = tmp_path / "cgroup" cgroup_file.write_text("12:memory:/docker/abc123\n") _real_open = builtins.open monkeypatch.setattr("builtins.open", lambda p, *a, **kw: _real_open(str(cgroup_file), *a, **kw) if p == "/proc/1/cgroup" else _real_open(p, *a, **kw)) assert is_container() is True def test_negative_case(self, monkeypatch, tmp_path): """Returns False on a regular Linux host.""" import builtins self._reset_cache(monkeypatch) monkeypatch.setattr(os.path, "exists", lambda p: False) cgroup_file = tmp_path / "cgroup" cgroup_file.write_text("12:memory:/\n") _real_open = builtins.open monkeypatch.setattr("builtins.open", lambda p, *a, **kw: _real_open(str(cgroup_file), *a, **kw) if p == "/proc/1/cgroup" else _real_open(p, *a, **kw)) assert is_container() is False def test_caches_result(self, monkeypatch): """Second call uses cached value without re-probing.""" monkeypatch.setattr(hermes_constants, "_container_detected", True) assert is_container() is True # Even if we make os.path.exists return False, cached value wins monkeypatch.setattr(os.path, "exists", lambda p: False) assert is_container() is True class TestParseReasoningEffort: """Tests for parse_reasoning_effort() — string → reasoning config dict.""" @pytest.mark.parametrize("value", ["", " ", "\t", "\n"]) def test_empty_or_whitespace_returns_none(self, value): """Empty / whitespace-only input falls back to caller default (None).""" assert parse_reasoning_effort(value) is None def test_none_disables_reasoning(self): """The literal "none" disables reasoning explicitly.""" assert parse_reasoning_effort("none") == {"enabled": False} @pytest.mark.parametrize("level", list(VALID_REASONING_EFFORTS)) def test_each_valid_level(self, level): """Every level listed in VALID_REASONING_EFFORTS is accepted as-is.""" assert parse_reasoning_effort(level) == {"enabled": True, "effort": level} @pytest.mark.parametrize( "raw, expected_effort", [ ("MEDIUM", "medium"), ("High", "high"), (" low ", "low"), ("\tXHIGH\n", "xhigh"), ("None", False), ], ) def test_case_and_whitespace_normalized(self, raw, expected_effort): """Mixed case and surrounding whitespace are normalized before lookup.""" result = parse_reasoning_effort(raw) if expected_effort is False: assert result == {"enabled": False} else: assert result == {"enabled": True, "effort": expected_effort} @pytest.mark.parametrize( "value", ["bogus", "very-high", "max", "0", "off", "true", "default"], ) def test_unknown_levels_return_none(self, value): """Unrecognized strings fall back to the caller default (None).""" assert parse_reasoning_effort(value) is None def test_known_supported_levels_are_documented(self): """Guard against silently dropping a documented level. The docstring promises "minimal", "low", "medium", "high", "xhigh". If someone removes one from VALID_REASONING_EFFORTS without updating the docstring, this test will fail and force the call out. """ documented = {"minimal", "low", "medium", "high", "xhigh"} assert documented.issubset(set(VALID_REASONING_EFFORTS))