Import AITURK IDE 1.0.0-beta.1 from Hermes 63279301; preserve MIT license

tests/tools/test_tip_tool.py

@@ -0,0 +1,88 @@
+"""Tests for the GUI-surface ``tip`` tool."""
+
+import json
+
+import pytest
+
+from tools import tip_tool as tt
+from tools.registry import registry
+
+
+@pytest.fixture
+def emitted(monkeypatch):
+    """Capture what the desktop bridge is asked to send, and say it landed."""
+    sent = []
+
+    def _emit(event, payload):
+        sent.append((event, payload))
+        return True
+
+    monkeypatch.setattr(tt.desktop_ui, "emit", _emit)
+    return sent
+
+
+def test_lives_in_the_gui_surface_toolset(monkeypatch):
+    """Scoped by toolset, not by the backend's env — see AGENTS.md."""
+    monkeypatch.delenv("HERMES_DESKTOP", raising=False)
+    entry = registry.get_entry("show_tip")
+
+    assert entry is not None
+    assert entry.toolset == "desktop_ui"
+
+
+def test_answers_to_the_appearance_switch():
+    """Tips off has to mean the model never sees the tool. See
+    tests/tools/test_display_toggles.py for the config end of it."""
+    entry = registry.get_entry("show_tip")
+
+    assert entry is not None
+    assert entry.check_fn is tt.check_tips_enabled
+
+
+def test_requires_the_desktop_bridge(monkeypatch):
+    """Outside the desktop GUI there is no emitter — a clear error, no crash."""
+    monkeypatch.setattr(tt.desktop_ui, "emit", lambda _event, _payload: False)
+
+    result = json.loads(tt.tip_tool(text="Over here", selector="#composer"))
+
+    assert "desktop" in result["error"]
+
+
+def test_needs_both_something_to_say_and_somewhere_to_point(emitted):
+    assert "tip needs text" in json.loads(tt.tip_tool(text="", selector="#a"))["error"]
+    assert "tip needs a selector" in json.loads(tt.tip_tool(text="Hi", selector=" "))["error"]
+    assert not emitted
+
+
+def test_rejects_an_unknown_side(emitted):
+    result = json.loads(tt.tip_tool(text="Hi", selector="#a", side="diagonal"))
+
+    assert "side must be one of" in result["error"]
+    assert not emitted
+
+
+def test_emits_the_renderer_event_omitting_unset_fields(emitted):
+    result = json.loads(tt.tip_tool(text="  The model name is a button  ", selector="  #model  "))
+
+    assert result == {"success": True, "selector": "#model"}
+    assert emitted == [("tip.show", {"selector": "#model", "text": "The model name is a button"})]
+
+
+def test_carries_title_and_side_when_given(emitted):
+    tt.tip_tool(text="Type here", selector="#composer", title="Composer", side="top")
+
+    assert emitted[0][1] == {
+        "selector": "#composer",
+        "text": "Type here",
+        "title": "Composer",
+        "side": "top",
+    }
+
+
+def test_bridge_failure_is_reported(monkeypatch):
+    def _boom(_event, _payload):
+        raise RuntimeError("renderer went away")
+
+    monkeypatch.setattr(tt.desktop_ui, "emit", _boom)
+
+    assert "renderer went away" in json.loads(tt.tip_tool(text="Hi", selector="#a"))["error"]