This repository has been archived on 2026-03-24. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
Timmy-time-dashboard/tests/timmy/test_grok_backend.py
Alexander Whitestone 9d78eb31d1 ruff (#169)
* polish: streamline nav, extract inline styles, improve tablet UX

- Restructure desktop nav from 8+ flat links + overflow dropdown into
  5 grouped dropdowns (Core, Agents, Intel, System, More) matching
  the mobile menu structure to reduce decision fatigue
- Extract all inline styles from mission_control.html and base.html
  notification elements into mission-control.css with semantic classes
- Replace JS-built innerHTML with secure DOM construction in
  notification loader and chat history
- Add CONNECTING state to connection indicator (amber) instead of
  showing OFFLINE before WebSocket connects
- Add tablet breakpoint (1024px) with larger touch targets for
  Apple Pencil / stylus use and safe-area padding for iPad toolbar
- Add active-link highlighting in desktop dropdown menus
- Rename "Mission Control" page title to "System Overview" to
  disambiguate from the chat home page
- Add "Home — Timmy Time" page title to index.html

https://claude.ai/code/session_015uPUoKyYa8M2UAcyk5Gt6h

* fix(security): move auth-gate credentials to environment variables

Hardcoded username, password, and HMAC secret in auth-gate.py replaced
with os.environ lookups. Startup now refuses to run if any variable is
unset. Added AUTH_GATE_SECRET/USER/PASS to .env.example.

https://claude.ai/code/session_015uPUoKyYa8M2UAcyk5Gt6h

* refactor(tooling): migrate from black+isort+bandit to ruff

Replace three separate linting/formatting tools with a single ruff
invocation. Updates tox.ini (lint, format, pre-push, pre-commit envs),
.pre-commit-config.yaml, and CI workflow. Fixes all ruff errors
including unused imports, missing raise-from, and undefined names.
Ruff config maps existing bandit skips to equivalent S-rules.

https://claude.ai/code/session_015uPUoKyYa8M2UAcyk5Gt6h

---------

Co-authored-by: Claude <noreply@anthropic.com>
2026-03-11 12:23:35 -04:00

303 lines
10 KiB
Python

"""Tests for GrokBackend in src/timmy/backends.py and Grok dashboard routes."""
from unittest.mock import MagicMock, patch
# ── grok_available ───────────────────────────────────────────────────────────
def test_grok_available_false_when_disabled():
"""Grok not available when GROK_ENABLED is false."""
with patch("config.settings") as mock_settings:
mock_settings.grok_enabled = False
mock_settings.xai_api_key = "xai-test-key"
from timmy.backends import grok_available
assert grok_available() is False
def test_grok_available_false_when_no_key():
"""Grok not available when XAI_API_KEY is empty."""
with patch("config.settings") as mock_settings:
mock_settings.grok_enabled = True
mock_settings.xai_api_key = ""
from timmy.backends import grok_available
assert grok_available() is False
def test_grok_available_true_when_enabled_and_key_set():
"""Grok available when both enabled and key are set."""
with patch("config.settings") as mock_settings:
mock_settings.grok_enabled = True
mock_settings.xai_api_key = "xai-test-key"
from timmy.backends import grok_available
assert grok_available() is True
# ── GrokBackend construction ────────────────────────────────────────────────
def test_grok_backend_init_with_explicit_params():
"""GrokBackend can be created with explicit api_key and model."""
from timmy.backends import GrokBackend
backend = GrokBackend(api_key="xai-test", model="grok-3-fast")
assert backend._api_key == "xai-test"
assert backend._model == "grok-3-fast"
assert backend.stats.total_requests == 0
def test_grok_backend_init_from_settings():
"""GrokBackend reads from config.settings when no params given."""
with patch("config.settings") as mock_settings:
mock_settings.xai_api_key = "xai-from-env"
mock_settings.grok_default_model = "grok-3"
from timmy.backends import GrokBackend
backend = GrokBackend()
assert backend._api_key == "xai-from-env"
assert backend._model == "grok-3"
def test_grok_backend_run_no_key_returns_error():
"""run() gracefully returns error message when no API key."""
from timmy.backends import GrokBackend
backend = GrokBackend(api_key="", model="grok-3-fast")
result = backend.run("hello")
assert "not configured" in result.content
def test_grok_backend_run_success():
"""run() returns content from the API on success."""
from timmy.backends import GrokBackend
backend = GrokBackend(api_key="xai-test", model="grok-3-fast")
mock_response = MagicMock()
mock_response.choices = [MagicMock()]
mock_response.choices[0].message.content = "Grok says hello"
mock_response.usage = MagicMock()
mock_response.usage.prompt_tokens = 10
mock_response.usage.completion_tokens = 5
mock_response.model = "grok-3-fast"
mock_client = MagicMock()
mock_client.chat.completions.create.return_value = mock_response
with patch.object(backend, "_get_client", return_value=mock_client):
result = backend.run("hello")
assert result.content == "Grok says hello"
assert backend.stats.total_requests == 1
assert backend.stats.total_prompt_tokens == 10
assert backend.stats.total_completion_tokens == 5
def test_grok_backend_run_api_error():
"""run() returns error message on API failure."""
from timmy.backends import GrokBackend
backend = GrokBackend(api_key="xai-test", model="grok-3-fast")
mock_client = MagicMock()
mock_client.chat.completions.create.side_effect = Exception("API timeout")
with patch.object(backend, "_get_client", return_value=mock_client):
result = backend.run("hello")
assert "unavailable" in result.content
assert backend.stats.errors == 1
def test_grok_backend_history_management():
"""GrokBackend maintains conversation history."""
from timmy.backends import GrokBackend
backend = GrokBackend(api_key="xai-test", model="grok-3-fast")
mock_response = MagicMock()
mock_response.choices = [MagicMock()]
mock_response.choices[0].message.content = "response"
mock_response.usage = MagicMock()
mock_response.usage.prompt_tokens = 10
mock_response.usage.completion_tokens = 5
mock_client = MagicMock()
mock_client.chat.completions.create.return_value = mock_response
with patch.object(backend, "_get_client", return_value=mock_client):
backend.run("first message")
backend.run("second message")
assert len(backend._history) == 4 # 2 user + 2 assistant
assert backend._history[0]["role"] == "user"
assert backend._history[1]["role"] == "assistant"
def test_grok_backend_health_check_no_key():
"""health_check() returns not-ok when no API key."""
from timmy.backends import GrokBackend
backend = GrokBackend(api_key="", model="grok-3-fast")
health = backend.health_check()
assert health["ok"] is False
assert "not configured" in health["error"]
def test_grok_backend_health_check_success():
"""health_check() returns ok when API key is set and models endpoint works."""
from timmy.backends import GrokBackend
backend = GrokBackend(api_key="xai-test", model="grok-3-fast")
mock_client = MagicMock()
mock_client.models.list.return_value = []
with patch.object(backend, "_get_client", return_value=mock_client):
health = backend.health_check()
assert health["ok"] is True
assert health["backend"] == "grok"
def test_grok_backend_estimated_cost():
"""estimated_cost property calculates sats from token usage."""
from timmy.backends import GrokUsageStats
stats = GrokUsageStats(
total_prompt_tokens=1_000_000,
total_completion_tokens=500_000,
)
# Input: 1M tokens * $5/1M = $5
# Output: 500K tokens * $15/1M = $7.50
# Total: $12.50 / $0.001 = 12,500 sats
assert stats.estimated_cost_sats == 12500
def test_grok_backend_build_messages():
"""_build_messages includes system prompt and history."""
from timmy.backends import GrokBackend
backend = GrokBackend(api_key="xai-test", model="grok-3-fast")
backend._history = [
{"role": "user", "content": "previous"},
{"role": "assistant", "content": "yes"},
]
messages = backend._build_messages("new question")
assert messages[0]["role"] == "system"
assert messages[1]["role"] == "user"
assert messages[1]["content"] == "previous"
assert messages[-1]["role"] == "user"
assert messages[-1]["content"] == "new question"
# ── get_grok_backend singleton ──────────────────────────────────────────────
def test_get_grok_backend_returns_singleton():
"""get_grok_backend returns the same instance on repeated calls."""
import timmy.backends as backends_mod
# Reset singleton
backends_mod._grok_backend = None
b1 = backends_mod.get_grok_backend()
b2 = backends_mod.get_grok_backend()
assert b1 is b2
# Cleanup
backends_mod._grok_backend = None
# ── GROK_MODELS constant ───────────────────────────────────────────────────
def test_grok_models_dict_has_expected_entries():
from timmy.backends import GROK_MODELS
assert "grok-3-fast" in GROK_MODELS
assert "grok-3" in GROK_MODELS
# ── consult_grok tool ──────────────────────────────────────────────────────
def test_consult_grok_returns_unavailable_when_disabled():
"""consult_grok tool returns error when Grok is not available."""
with patch("timmy.backends.grok_available", return_value=False):
from timmy.tools import consult_grok
result = consult_grok("test query")
assert "not available" in result
def test_consult_grok_calls_backend_when_available():
"""consult_grok tool calls the Grok backend when available."""
from timmy.backends import RunResult
mock_backend = MagicMock()
mock_backend.run.return_value = RunResult(content="Grok answer")
mock_backend.stats = MagicMock()
mock_backend.stats.total_latency_ms = 100
with (
patch("timmy.backends.grok_available", return_value=True),
patch("timmy.backends.get_grok_backend", return_value=mock_backend),
patch("config.settings") as mock_settings,
):
mock_settings.grok_free = True
mock_settings.grok_enabled = True
mock_settings.xai_api_key = "xai-test"
from timmy.tools import consult_grok
result = consult_grok("complex question")
assert "Grok answer" in result
mock_backend.run.assert_called_once_with("complex question")
# ── Grok dashboard route tests ─────────────────────────────────────────────
def test_grok_status_endpoint(client):
"""GET /grok/status returns HTML dashboard page."""
response = client.get("/grok/status")
assert response.status_code == 200
assert "text/html" in response.headers.get("content-type", "")
# Verify key status info is present in the rendered HTML
text = response.text
assert "Grok Status" in text
assert "Status" in text
def test_grok_toggle_returns_html(client):
"""POST /grok/toggle returns HTML response."""
response = client.post("/grok/toggle")
assert response.status_code == 200
def test_grok_stats_endpoint(client):
"""GET /grok/stats returns usage statistics."""
response = client.get("/grok/stats")
assert response.status_code == 200
data = response.json()
assert "total_requests" in data or "error" in data
def test_grok_chat_without_key(client):
"""POST /grok/chat returns error when Grok is not available."""
response = client.post(
"/grok/chat",
data={"message": "test query"},
)
assert response.status_code == 200
# Should contain error since GROK_ENABLED is false in test mode
assert (
"not available" in response.text.lower()
or "error" in response.text.lower()
or "grok" in response.text.lower()
)