Skip to content

Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)

Python
3.3 KB
Raw Blame
from dataclasses import FrozenInstanceError

import pytest

from free_claude_code.config.provider_catalog import (
    PROVIDER_CATALOG,
    ProviderAuthKind,
    ProviderDescriptor,
)


def test_provider_descriptors_are_immutable_values() -> None:
    descriptor = ProviderDescriptor(
        provider_id="local",
        display_name="Local",
        website_url="https://example.test/",
        logo_filename="local.svg",
        local=True,
    )

    assert descriptor.local is True
    assert not hasattr(descriptor, "__dict__")
    with pytest.raises(FrozenInstanceError):
        descriptor.__setattr__("local", False)


def test_catalog_has_no_transport_metadata() -> None:
    assert "transport_type" not in ProviderDescriptor.__slots__
    assert "capabilities" not in ProviderDescriptor.__slots__


def test_catalog_local_assignments_are_exact() -> None:
    assert {
        provider_id
        for provider_id, descriptor in PROVIDER_CATALOG.items()
        if descriptor.local
    } == {"lmstudio", "llamacpp", "ollama"}


def test_ollama_cloud_is_remote_and_distinct_from_local_ollama() -> None:
    cloud = PROVIDER_CATALOG["ollama_cloud"]
    local = PROVIDER_CATALOG["ollama"]

    assert cloud.local is False
    assert cloud.credential_env == "OLLAMA_API_KEY"
    assert local.local is True
    assert local.credential_env is None


def test_provider_configuration_attrs_cover_multi_field_and_adc_providers() -> None:
    assert PROVIDER_CATALOG["azure_openai"].configuration_attrs() == (
        "azure_openai_api_keys",
        "azure_openai_base_url",
    )
    assert PROVIDER_CATALOG["cloudflare"].configuration_attrs() == (
        "cloudflare_api_tokens",
        "cloudflare_account_id",
    )
    assert PROVIDER_CATALOG["vertex"].configuration_attrs() == ("vertex_project_id",)


def test_every_provider_declares_its_configuration_boundary() -> None:
    assert all(
        descriptor.configuration_attrs()
        or descriptor.static_credential is not None
        or descriptor.auth_kind is ProviderAuthKind.CONNECTED_ACCOUNT
        for descriptor in PROVIDER_CATALOG.values()
    )


def test_openai_is_a_connected_account_without_api_key_configuration() -> None:
    descriptor = PROVIDER_CATALOG["openai"]

    assert descriptor.auth_kind is ProviderAuthKind.CONNECTED_ACCOUNT
    assert descriptor.credential_env is None
    assert descriptor.configuration_attrs() == ()
    assert descriptor.default_base_url == "https://chatgpt.com/backend-api/codex"


def test_openai_api_is_a_separate_key_configured_provider() -> None:
    api = PROVIDER_CATALOG["openai_api"]
    subscription = PROVIDER_CATALOG["openai"]

    assert api.auth_kind is ProviderAuthKind.CONFIGURATION
    assert api.credential_env == "OPENAI_API_KEY"
    assert api.configuration_attrs() == ("openai_api_keys",)
    assert api.proxy_attr == "openai_api_proxy"
    assert api.default_base_url == "https://api.openai.com/v1"
    assert subscription.auth_kind is ProviderAuthKind.CONNECTED_ACCOUNT
    assert subscription.credential_env is None


def test_copilot_is_connected_without_credential_configuration() -> None:
    descriptor = PROVIDER_CATALOG["github_copilot"]
    assert descriptor.auth_kind is ProviderAuthKind.CONNECTED_ACCOUNT
    assert descriptor.credential_env is None
    assert descriptor.configuration_attrs() == ()
    assert descriptor.default_base_url == "https://api.githubcopilot.com"