Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.
Python aicode-complexitycode-healthcode-intelligencecode-qualitydead-codedeveloper-toolsdocumentationgit-analyticsmcpopen-sourcepythonrefactoringstatic-analysistechnical-debt
"""Provider failures map to a hint a person can act on, without the raw text."""
from __future__ import annotations
from types import SimpleNamespace
import pytest
from repowise.core.providers.llm.base import ProviderError, RateLimitError
from repowise.core.providers.llm.error_hints import describe_provider_error
def _raised_from(outer: BaseException, cause: BaseException) -> BaseException:
outer.__cause__ = cause
return outer
@pytest.mark.parametrize("status", [401, 403])
def test_rejected_key_names_the_provider_and_the_fix(status):
exc = ProviderError("anthropic", "Error code: 401 - invalid x-api-key sk-ant-secret", status)
hint = describe_provider_error(exc)
assert hint is not None and hint.kind == "auth"
assert hint.message == "API key rejected by anthropic. Update it in Settings."
assert "sk-ant" not in hint.message
def test_rate_limit():
hint = describe_provider_error(RateLimitError("openai", "slow down"))
assert hint is not None and hint.kind == "rate_limit"
assert "openai" in hint.message
def test_missing_model_names_the_model_when_known():
exc = ProviderError("ollama", "model 'llama9' not found", 404)
hint = describe_provider_error(exc, model="llama9")
assert hint.kind == "model_not_found"
assert hint.message.startswith("Model llama9 was not found at ollama.")
assert hint.as_dict()["model"] == "llama9"
def test_a_bare_404_also_points_at_the_base_url_path():
exc = ProviderError("litellm", "Error code: 404 - Not Found", 404)
hint = describe_provider_error(exc, model="gpt-x")
assert hint.kind == "not_found"
assert hint.message.startswith("Model gpt-x or the base URL path was not found at litellm.")
def test_ipv6_origin_keeps_its_brackets():
class ConnectError(Exception):
request = SimpleNamespace(url="http://[::1]:8000/v1/chat")
hint = describe_provider_error(_raised_from(ProviderError("vllm", "x"), ConnectError()))
assert hint.as_dict()["target"] == "http://[::1]:8000"
def test_unreachable_local_server_names_its_origin_without_path_or_credentials():
class APIConnectionError(Exception):
request = SimpleNamespace(url="http://user:pw@localhost:11434/v1/chat/completions?k=1")
exc = _raised_from(ProviderError("ollama", "Connection error."), APIConnectionError())
hint = describe_provider_error(exc)
assert hint is not None and hint.kind == "unreachable"
assert "Could not reach http://localhost:11434." in hint.message
assert "pw" not in hint.message and "chat" not in hint.message
def test_connection_refused_without_a_request_falls_back_to_the_provider():
exc = _raised_from(ProviderError("litellm", "boom"), ConnectionRefusedError())
assert describe_provider_error(exc).message.startswith("Could not reach litellm.")
@pytest.mark.parametrize(
"exc",
[
ValueError("artifact check rejected the page"),
ProviderError("openai", "server error", 500),
# The server was reached; a dropped connection is not "unreachable".
_raised_from(ProviderError("openai", "x"), ConnectionResetError()),
_raised_from(ProviderError("openai", "x"), BrokenPipeError()),
],
)
def test_unrecognised_errors_get_no_hint(exc):
assert describe_provider_error(exc) is None