mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-05-29 06:31:32 +00:00
66827f8947
Remove unused imports (F401) and duplicate/shadowed import redefinitions (F811) across the codebase using ruff's safe autofixes. No behavioral changes -- imports only. - ~1400 safe autofixes applied across 644 files (net -1072 lines) - __init__.py re-exports preserved (excluded from F401 removal so public re-export surfaces stay intact) - Re-exports that are imported or monkeypatched by tests but look unused in their defining module are kept with explicit # noqa: F401 (gateway/run.py load_dotenv; run_agent re-exports from agent.message_sanitization, agent.context_compressor, agent.retry_utils, agent.prompt_builder, agent.process_bootstrap, agent.codex_responses_adapter) - Unsafe F841 (unused-variable) fixes deliberately skipped -- those can change behavior when the RHS has side effects - ruff lints remain disabled in pyproject.toml (only PLW1514 is selected); this is a one-time cleanup, not a config change Verification: - python -m compileall: clean - pytest --collect-only: all 27161 tests collect (zero import errors) - core entry points import clean (run_agent, model_tools, cli, toolsets, hermes_state, batch_runner, gateway) - static scan: every name any test imports directly from an edited module still resolves
244 lines
9.5 KiB
Python
244 lines
9.5 KiB
Python
"""Tests for IRC gateway configuration via `hermes setup gateway` UI.
|
|
|
|
Covers the full plugin-platform discovery → status → configure flow so that
|
|
a fresh Hermes install (no state, no env vars) can set up IRC through the
|
|
interactive setup menus.
|
|
"""
|
|
|
|
import os
|
|
|
|
from gateway.platform_registry import PlatformEntry, platform_registry
|
|
|
|
|
|
def _register_irc_platform(**overrides):
|
|
"""Manually register the IRC platform entry as if discover_plugins() found it.
|
|
|
|
Tests run outside the normal plugin-discovery path, so we inject the entry
|
|
directly into the singleton registry and yield its dict shape.
|
|
"""
|
|
defaults = dict(
|
|
name="irc",
|
|
label="IRC",
|
|
adapter_factory=lambda cfg: None,
|
|
check_fn=lambda: bool(os.getenv("IRC_SERVER", "") and os.getenv("IRC_CHANNEL", "")),
|
|
validate_config=None,
|
|
required_env=["IRC_SERVER", "IRC_CHANNEL", "IRC_NICKNAME"],
|
|
install_hint="No extra packages needed (stdlib only)",
|
|
setup_fn=lambda: None,
|
|
source="plugin",
|
|
plugin_name="irc_platform",
|
|
allowed_users_env="IRC_ALLOWED_USERS",
|
|
allow_all_env="IRC_ALLOW_ALL_USERS",
|
|
max_message_length=450,
|
|
pii_safe=False,
|
|
emoji="💬",
|
|
allow_update_command=True,
|
|
platform_hint="You are chatting via IRC.",
|
|
)
|
|
defaults.update(overrides)
|
|
entry = PlatformEntry(**defaults)
|
|
platform_registry.register(entry)
|
|
return {
|
|
"key": entry.name,
|
|
"label": entry.label,
|
|
"emoji": entry.emoji,
|
|
"token_var": entry.required_env[0] if entry.required_env else "",
|
|
"install_hint": entry.install_hint,
|
|
"_registry_entry": entry,
|
|
}
|
|
|
|
|
|
def _unregister_irc_platform():
|
|
platform_registry.unregister("irc")
|
|
|
|
|
|
# ── Fresh-install discovery ─────────────────────────────────────────────────
|
|
|
|
|
|
class TestIRCFreshInstallDiscovery:
|
|
"""IRC appears in the setup menu on a brand-new Hermes install."""
|
|
|
|
def test_irc_appears_in_all_platforms(self, monkeypatch):
|
|
"""When the IRC plugin is registered, _all_platforms() surfaces it."""
|
|
import hermes_cli.gateway as gateway_mod
|
|
|
|
_register_irc_platform()
|
|
try:
|
|
# Ensure no stale env vars leak in
|
|
for key in ("IRC_SERVER", "IRC_CHANNEL", "IRC_NICKNAME"):
|
|
monkeypatch.delenv(key, raising=False)
|
|
|
|
platforms = gateway_mod._all_platforms()
|
|
keys = {p["key"] for p in platforms}
|
|
assert "irc" in keys
|
|
|
|
irc_plat = next(p for p in platforms if p["key"] == "irc")
|
|
assert irc_plat["label"] == "IRC"
|
|
assert irc_plat["emoji"] == "💬"
|
|
finally:
|
|
_unregister_irc_platform()
|
|
|
|
def test_irc_status_not_configured_when_fresh(self, monkeypatch):
|
|
"""On a fresh install with no env vars, IRC shows 'not configured'."""
|
|
import hermes_cli.gateway as gateway_mod
|
|
|
|
plat = _register_irc_platform()
|
|
try:
|
|
for key in ("IRC_SERVER", "IRC_CHANNEL", "IRC_NICKNAME"):
|
|
monkeypatch.delenv(key, raising=False)
|
|
|
|
status = gateway_mod._platform_status(plat)
|
|
assert status == "not configured"
|
|
finally:
|
|
_unregister_irc_platform()
|
|
|
|
def test_irc_status_configured_when_env_set(self, monkeypatch):
|
|
"""After the user sets IRC_SERVER and IRC_CHANNEL, status is 'configured'."""
|
|
import hermes_cli.gateway as gateway_mod
|
|
|
|
plat = _register_irc_platform()
|
|
try:
|
|
monkeypatch.setenv("IRC_SERVER", "irc.libera.chat")
|
|
monkeypatch.setenv("IRC_CHANNEL", "#hermes")
|
|
monkeypatch.setenv("IRC_NICKNAME", "hermes-bot")
|
|
|
|
status = gateway_mod._platform_status(plat)
|
|
assert status == "configured"
|
|
finally:
|
|
_unregister_irc_platform()
|
|
|
|
def test_irc_status_partial_when_only_server_set(self, monkeypatch):
|
|
"""If only IRC_SERVER is set, the platform is still not configured."""
|
|
import hermes_cli.gateway as gateway_mod
|
|
|
|
plat = _register_irc_platform()
|
|
try:
|
|
monkeypatch.delenv("IRC_CHANNEL", raising=False)
|
|
monkeypatch.delenv("IRC_NICKNAME", raising=False)
|
|
monkeypatch.setenv("IRC_SERVER", "irc.libera.chat")
|
|
|
|
status = gateway_mod._platform_status(plat)
|
|
assert status == "not configured"
|
|
finally:
|
|
_unregister_irc_platform()
|
|
|
|
|
|
# ── Interactive setup dispatch ──────────────────────────────────────────────
|
|
|
|
|
|
class TestIRCInteractiveSetup:
|
|
"""The setup UI dispatches to IRC's interactive_setup() correctly."""
|
|
|
|
def test_configure_platform_dispatches_to_irc_setup_fn(self, monkeypatch, capsys):
|
|
"""_configure_platform() calls the IRC plugin's setup_fn when selected."""
|
|
import hermes_cli.gateway as gateway_mod
|
|
|
|
calls = []
|
|
|
|
def fake_setup():
|
|
calls.append("setup_called")
|
|
print("IRC setup complete!")
|
|
|
|
plat = _register_irc_platform(setup_fn=fake_setup)
|
|
try:
|
|
gateway_mod._configure_platform(plat)
|
|
finally:
|
|
_unregister_irc_platform()
|
|
|
|
assert "setup_called" in calls
|
|
out = capsys.readouterr().out
|
|
assert "IRC setup complete!" in out
|
|
|
|
|
|
def test_configure_platform_fallback_when_no_setup_fn(self, monkeypatch, capsys):
|
|
"""A plugin with no setup_fn falls back to env-var instructions."""
|
|
import hermes_cli.gateway as gateway_mod
|
|
|
|
plat = _register_irc_platform(setup_fn=None)
|
|
try:
|
|
gateway_mod._configure_platform(plat)
|
|
finally:
|
|
_unregister_irc_platform()
|
|
|
|
out = capsys.readouterr().out
|
|
assert "IRC" in out
|
|
assert "IRC_SERVER" in out
|
|
|
|
|
|
# ── End-to-end fresh-install gateway setup ──────────────────────────────────
|
|
|
|
|
|
class TestIRCGatewaySetupFreshInstall:
|
|
"""Simulate the full `hermes setup gateway` experience with IRC present."""
|
|
|
|
def test_setup_gateway_shows_irc_in_platform_menu(self, monkeypatch, capsys, tmp_path):
|
|
"""The gateway setup menu lists IRC among the available platforms."""
|
|
import hermes_cli.gateway as gateway_mod
|
|
from hermes_cli import setup as setup_mod
|
|
|
|
monkeypatch.setenv("HERMES_HOME", str(tmp_path))
|
|
_register_irc_platform()
|
|
try:
|
|
for key in ("IRC_SERVER", "IRC_CHANNEL", "IRC_NICKNAME"):
|
|
monkeypatch.delenv(key, raising=False)
|
|
|
|
# Sanity-check: IRC must be visible to _all_platforms()
|
|
platforms = gateway_mod._all_platforms()
|
|
assert any(p["key"] == "irc" for p in platforms), \
|
|
f"IRC not in platforms: {[p['key'] for p in platforms]}"
|
|
|
|
# Capture what prompt_checklist is asked to display
|
|
checklist_calls = []
|
|
|
|
def capture_prompt_checklist(question, choices, pre_selected=None):
|
|
checklist_calls.append({"question": question, "choices": choices})
|
|
return [] # nothing selected → clean exit
|
|
|
|
monkeypatch.setattr(setup_mod, "prompt_yes_no", lambda *a, **kw: False)
|
|
monkeypatch.setattr(setup_mod, "prompt_checklist", capture_prompt_checklist)
|
|
monkeypatch.setattr(gateway_mod, "supports_systemd_services", lambda: False)
|
|
monkeypatch.setattr(gateway_mod, "is_macos", lambda: False)
|
|
monkeypatch.setattr(gateway_mod, "_is_service_installed", lambda: False)
|
|
monkeypatch.setattr(gateway_mod, "_is_service_running", lambda: False)
|
|
|
|
setup_mod.setup_gateway({})
|
|
|
|
# Find the platform-selection prompt
|
|
platform_prompt = next(
|
|
(c for c in checklist_calls if "platform" in c["question"].lower()),
|
|
None,
|
|
)
|
|
assert platform_prompt is not None, \
|
|
f"No platform prompt found in {checklist_calls}"
|
|
choices_text = "\n".join(platform_prompt["choices"])
|
|
assert "IRC" in choices_text
|
|
assert "💬" in choices_text
|
|
assert "not configured" in choices_text.lower()
|
|
finally:
|
|
_unregister_irc_platform()
|
|
|
|
def test_setup_gateway_irc_counts_as_messaging_platform(self, monkeypatch, capsys, tmp_path):
|
|
"""When IRC is configured, setup_gateway counts it as a messaging platform."""
|
|
import hermes_cli.gateway as gateway_mod
|
|
from hermes_cli import setup as setup_mod
|
|
|
|
monkeypatch.setenv("HERMES_HOME", str(tmp_path))
|
|
_register_irc_platform()
|
|
try:
|
|
monkeypatch.setenv("IRC_SERVER", "irc.libera.chat")
|
|
monkeypatch.setenv("IRC_CHANNEL", "#hermes")
|
|
monkeypatch.setenv("IRC_NICKNAME", "hermes-bot")
|
|
|
|
monkeypatch.setattr(setup_mod, "prompt_yes_no", lambda *a, **kw: False)
|
|
monkeypatch.setattr(setup_mod, "prompt_choice", lambda *a, **kw: 0)
|
|
monkeypatch.setattr(gateway_mod, "supports_systemd_services", lambda: False)
|
|
monkeypatch.setattr(gateway_mod, "is_macos", lambda: False)
|
|
monkeypatch.setattr(gateway_mod, "_is_service_installed", lambda: False)
|
|
monkeypatch.setattr(gateway_mod, "_is_service_running", lambda: False)
|
|
|
|
setup_mod.setup_gateway({})
|
|
|
|
out = capsys.readouterr().out
|
|
assert "Messaging platforms configured!" in out
|
|
finally:
|
|
_unregister_irc_platform()
|