eggfetch-python 0.1.4

Python sync and asyncio bindings for the eggfetch HTTP engine (Rust core via PyO3; Python users install from PyPI)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

from __future__ import annotations

from dataclasses import dataclass

from eggfetch import __version__ as _IMPL_VERSION


UNSUPPORTED_SURFACES: tuple[str, ...] = (
    "Trio/AnyIO backend (asyncio only, tokio-based)",
    "Unix Domain Socket (UDS) transport",
    "local_address / socket_options transport parameters",
    "ssl_context transport parameter (TLS handled by Rust engine)",
    "Python 3.8 / 3.9 (requires 3.10+)",
)


@dataclass(frozen=True, slots=True)
class CompatibilityInfo:
    provider: str
    implementation_version: str
    emulated_version: str
    compatibility_stage: str
    backend: str
    supported_python_versions: tuple[str, ...]
    profile_schema_version: str
    unsupported_surfaces: tuple[str, ...]


COMPATIBILITY_INFO = CompatibilityInfo(
    provider="eggfetch",
    implementation_version=_IMPL_VERSION,
    emulated_version="0.28.1",
    compatibility_stage="stage-c-candidate",
    backend="rust-tokio",
    supported_python_versions=("3.10", "3.11", "3.12", "3.13"),
    profile_schema_version="1",
    unsupported_surfaces=UNSUPPORTED_SURFACES,
)


def get_compatibility_info() -> CompatibilityInfo:
    return COMPATIBILITY_INFO


def diagnostics_summary() -> str:
    info = COMPATIBILITY_INFO
    py_versions = ", ".join(info.supported_python_versions)
    unsupported = "\n".join(f"    - {s}" for s in info.unsupported_surfaces)
    return (
        f"eggfetch HTTPX compatibility layer\n"
        f"  Provider:          {info.provider}\n"
        f"  Implementation:    v{info.implementation_version}\n"
        f"  Emulated version:  HTTPX {info.emulated_version}\n"
        f"  Stage:             {info.compatibility_stage}\n"
        f"  Backend:           {info.backend}\n"
        f"  Supported Python:  {py_versions}\n"
        f"  Profile schema:    v{info.profile_schema_version}\n"
        f"  Unsupported:\n{unsupported}"
    )