Function _cmd_doctor

uncommon_route/cli.py:642–795

(args: list[str])

def _cmd_doctor(args: list[str]) -> None:
    import asyncio
    from uncommon_route.providers import load_providers

    checks: list[tuple[str, str, str]] = []

    # Python version
    vi = sys.version_info
    python_ok = vi >= (3, 11)
    checks.append(("Python version", "ok" if python_ok else "fail", f"{vi.major}.{vi.minor}.{vi.micro}"))

    connection = resolve_primary_connection(store=ConnectionsStore())
    upstream = connection.upstream

    def _upstream_is_local(url: str) -> bool:
        host = (urlparse(url).hostname or "").lower()
        return host in {"localhost", "127.0.0.1", "0.0.0.0", "::1"}

    def _local_proxy_no_proxy_warning() -> str | None:
        local_targets = [
            os.environ.get("ANTHROPIC_BASE_URL", ""),
            os.environ.get("OPENAI_BASE_URL", ""),
        ]
        if upstream:
            local_targets.append(upstream)
        if not any(target and _upstream_is_local(target) for target in local_targets):
            return None

        proxy_values = [
            os.environ.get("http_proxy", ""),
            os.environ.get("HTTP_PROXY", ""),
            os.environ.get("https_proxy", ""),
            os.environ.get("HTTPS_PROXY", ""),
        ]
        if not any(proxy_values):
            return None

        no_proxy = os.environ.get("NO_PROXY") or os.environ.get("no_proxy") or ""
        tokens = {item.strip().lower() for item in no_proxy.split(",") if item.strip()}
        required = {"localhost", "127.0.0.1", "::1"}
        missing = sorted(required - tokens)
        if not missing:
            return None

        missing_text = ", ".join(missing)
        return f"proxy env is set; add NO_PROXY for local proxy access ({missing_text})"

    api_key = connection.api_key
    providers = load_providers()
    has_byok = bool(providers.providers)
    local_upstream = bool(upstream) and _upstream_is_local(upstream)
    primary_ready = bool(upstream) and (bool(api_key) or local_upstream)

    if primary_ready:
        detail = upstream
        if local_upstream:
            detail = f"{upstream} (local upstream)"
        checks.append(("Primary connection", "ok", detail))