@redocly/client-generator 0.3.7 → 0.4.0

package/lib/runtime-sources/python.js

@@ -0,0 +1,12 @@
+// GENERATED by scripts/generate-runtime-sources.mjs — do not edit. Regenerated on install (`prepare`); manually: `npm run prepare -w @redocly/client-generator`.
+export const PYTHON_RUNTIME_SOURCES = {
+    '_errors.py': '# Runtime errors and the result-mode envelope for generated Python clients.\n# Hand-authored once, embedded into every generated client (see\n# scripts/generate-runtime-sources.mjs) — mirror of the TypeScript runtime\'s\n# errors.ts, kept semantically in lockstep.\nfrom __future__ import annotations\n\nfrom dataclasses import dataclass\nfrom typing import Any, Generic, Optional, TypeVar\n\nT = TypeVar("T")\nE = TypeVar("E")\n\n\nclass ApiError(Exception):\n    """Raised (throw mode) for a non-2xx response, carrying the decoded error body."""\n\n    def __init__(self, url: str, status: int, status_text: str, body: Any) -> None:\n        super().__init__(f"Request failed with status {status}")\n        self.url = url\n        self.status = status\n        self.status_text = status_text\n        self.body = body\n\n\nclass ApiTimeoutError(Exception):\n    """Raised when a request attempt exceeds the configured timeout — carries the\n    context a log line needs (which operation, what budget, which attempt)."""\n\n    def __init__(self, operation_id: str, timeout: float, attempt: int) -> None:\n        super().__init__(\n            f\'Request "{operation_id}" timed out after {timeout} s (attempt {attempt})\'\n        )\n        self.operation_id = operation_id\n        self.timeout = timeout\n        self.attempt = attempt\n\n\n@dataclass\nclass Result(Generic[T, E]):\n    """Result-mode return shape: exactly one of `data`/`error` is set."""\n\n    data: Optional[T]\n    error: Optional[E]\n    response: Any  # httpx.Response\n\n    @property\n    def ok(self) -> bool:\n        return self.error is None\n',
+    '_auth.py': '# Auth resolution for generated Python clients — mirror of the TypeScript\n# runtime\'s auth.ts: the first OR-alternative whose schemes are all configured\n# is applied, so "bearer OR apiKey" works with either credential and never\n# sends both. Cookie-borne api keys fold into a single Cookie header.\nfrom __future__ import annotations\n\nimport base64\nfrom typing import Any, Callable, Dict, List, Tuple, Union\nfrom urllib.parse import quote\n\nTokenProvider = Union[str, Callable[[], str]]\n\n\ndef _api_keys(auth: Dict[str, Any]) -> Dict[str, Any]:\n    """The apiKey credentials. `apiKey` is the documented key (it matches the scheme\n    kind and the other language SDKs); `api_key` is accepted too, so a snake_case\n    config keeps working."""\n    return {**(auth.get("api_key") or {}), **(auth.get("apiKey") or {})}\n\ndef _resolve_token(provider: TokenProvider) -> str:\n    return provider() if callable(provider) else provider\n\n\ndef _is_configured(scheme: Dict[str, Any], auth: Dict[str, Any]) -> bool:\n    kind = scheme["kind"]\n    if kind == "apiKey":\n        return scheme["scheme"] in _api_keys(auth)\n    if kind == "bearer":\n        return auth.get("bearer") is not None\n    return auth.get("basic") is not None\n\n\ndef resolve_auth(\n    security: List[List[Dict[str, Any]]], auth: Dict[str, Any]\n) -> Tuple[Dict[str, str], Dict[str, str]]:\n    """Build (headers, query) for one operation\'s security OR-alternatives from\n    the client credentials. When no alternative is fully configured, the first\n    alternative\'s configured schemes are still sent (the server rejects the\n    request — same behavior as the TypeScript runtime)."""\n    alternative = next(\n        (schemes for schemes in security if all(_is_configured(s, auth) for s in schemes)),\n        security[0] if security else [],\n    )\n    headers: Dict[str, str] = {}\n    query: Dict[str, str] = {}\n    cookies: List[str] = []\n    for scheme in alternative:\n        kind = scheme["kind"]\n        if kind == "apiKey":\n            provider = _api_keys(auth).get(scheme["scheme"])\n            if provider is None:\n                continue\n            value = _resolve_token(provider)\n            location = scheme.get("in", "header")\n            if location == "header":\n                headers[scheme["name"]] = value\n            elif location == "query":\n                query[scheme["name"]] = value\n            else:\n                # Reserved characters (`;`, `=`, space) must not break Cookie syntax.\n                cookies.append(f"{scheme[\'name\']}={quote(value, safe=\'\')}")\n        elif kind == "bearer":\n            provider = auth.get("bearer")\n            if provider is not None:\n                headers["Authorization"] = f"Bearer {_resolve_token(provider)}"\n        else:\n            basic = auth.get("basic")\n            if basic is not None:\n                username, password = basic["username"], basic["password"]\n                token = base64.b64encode(f"{username}:{password}".encode("utf-8")).decode("ascii")\n                headers["Authorization"] = f"Basic {token}"\n    if cookies:\n        headers["Cookie"] = "; ".join(cookies)\n    return headers, query\n',
+    '_url.py': '# URL assembly for generated Python clients — path-parameter substitution with\n# percent-encoding, mirroring the TypeScript runtime\'s url.ts semantics.\nfrom __future__ import annotations\n\nfrom typing import Any, Dict\nfrom urllib.parse import quote\n\n\ndef build_url(server_url: str, path: str, path_params: Dict[str, Any]) -> str:\n    filled = path\n    for name, value in path_params.items():\n        filled = filled.replace("{" + name + "}", quote(str(value), safe=""))\n    return server_url.rstrip("/") + filled\n',
+    '_decode.py': '# Reflective JSON <-> model conversion for generated Python clients. Models are\n# plain dataclasses by default, or pydantic BaseModels under `models: pydantic`;\n# one decoder serves both. For a dataclass it hydrates parsed JSON reflectively,\n# honoring each class\'s `_field_map` (python name -> wire name) and the typing\n# constructs the generator emits: Optional/Union, List, Dict, Enum, Literal, Any.\n# For a pydantic model it defers to pydantic, which already knows the aliases.\n# encode() mirrors whichever it was given back to wire shape.\nfrom __future__ import annotations\n\nimport dataclasses\nimport typing\nfrom datetime import date, datetime\nfrom enum import Enum\nfrom typing import Any, Dict, Tuple, get_args, get_origin, get_type_hints\n\n# Discriminated unions: resolved Union annotation -> (wire property, {value: class}).\n# The generated module registers its unions here; decode() dispatches through it\n# before falling back to trying members in order.\nDISCRIMINATORS: Dict[Any, Tuple[str, Dict[str, Any]]] = {}\n\n\ndef decode(type_: Any, data: Any):\n    """Best-effort hydration: wire data -> the annotated Python shape. Unknown or\n    mismatched shapes pass through unchanged (the server is the source of truth)."""\n    if data is None or type_ is Any or type_ is None:\n        return data\n    # `Annotated[Union[...], Field(discriminator=...)]`: pydantic reads that annotation on a\n    # model\'s own field, so here only the union underneath matters.\n    if hasattr(type_, "__metadata__"):\n        type_ = get_args(type_)[0]\n    origin = get_origin(type_)\n    if origin is typing.Union:\n        discriminator = DISCRIMINATORS.get(type_)\n        if discriminator is not None and isinstance(data, dict):\n            wire_property, mapping = discriminator\n            target = mapping.get(data.get(wire_property))\n            if target is not None:\n                try:\n                    return decode(target, data)\n                except (TypeError, ValueError, KeyError):\n                    pass\n        for member in get_args(type_):\n            if member is type(None):\n                continue\n            try:\n                return decode(member, data)\n            except (TypeError, ValueError, KeyError):\n                continue\n        return data\n    if origin is list:\n        (item_type,) = get_args(type_) or (Any,)\n        return [decode(item_type, item) for item in data]\n    if origin is dict:\n        args = get_args(type_)\n        value_type = args[1] if len(args) == 2 else Any\n        return {key: decode(value_type, value) for key, value in data.items()}\n    if origin is typing.Literal:\n        return data\n    if isinstance(type_, type) and issubclass(type_, Enum):\n        return type_(data)\n    # `dateType: Date` annotates date/date-time fields as datetime objects; a value that\n    # doesn\'t parse passes through unchanged (the server is the source of truth).\n    if type_ is datetime or type_ is date:\n        if not isinstance(data, str):\n            return data\n        try:\n            # `datetime` accepts a bare date too; `date` rejects a timestamp, so trim it.\n            return (\n                datetime.fromisoformat(data)\n                if type_ is datetime\n                else date.fromisoformat(data[:10])\n            )\n        except ValueError:\n            return data\n    # A pydantic model validates itself, aliases included. `ValidationError`\n    # subclasses `ValueError`, so union member probing above still works.\n    if isinstance(type_, type) and hasattr(type_, "model_validate"):\n        return type_.model_validate(data)\n    if dataclasses.is_dataclass(type_):\n        hints = get_type_hints(type_)\n        field_map = getattr(type_, "_field_map", {})\n        kwargs = {}\n        for field in dataclasses.fields(type_):\n            wire = field_map.get(field.name, field.name)\n            if isinstance(data, dict) and wire in data:\n                kwargs[field.name] = decode(hints.get(field.name, Any), data[wire])\n        return type_(**kwargs)\n    return data\n\n\ndef encode(value: Any):\n    """Python shape -> wire (JSON) shape; inverse of decode for request bodies."""\n    # `mode="json"` resolves datetimes and enums the same way the branches below do,\n    # and `exclude_none` matches the dataclass path: an unset optional is not sent.\n    if hasattr(value, "model_dump") and not isinstance(value, type):\n        return value.model_dump(by_alias=True, exclude_none=True, mode="json")\n    if dataclasses.is_dataclass(value) and not isinstance(value, type):\n        field_map = getattr(type(value), "_field_map", {})\n        out = {}\n        for field in dataclasses.fields(value):\n            item = getattr(value, field.name)\n            if item is None:\n                continue\n            out[field_map.get(field.name, field.name)] = encode(item)\n        return out\n    if isinstance(value, Enum):\n        return value.value\n    # A date-only value must not gain a time component on the way out.\n    if isinstance(value, datetime):\n        return value.isoformat()\n    if isinstance(value, date):\n        return value.isoformat()\n    if isinstance(value, list):\n        return [encode(item) for item in value]\n    if isinstance(value, dict):\n        return {key: encode(item) for key, item in value.items()}\n    return value\n',
+    '_send.py': '# The request core for generated Python clients — mirror of the TypeScript\n# runtime\'s send.ts: default + config + per-call headers, on_request middleware\n# BEFORE serialization (mutations are sent), the retry loop (idempotent-methods\n# default, Idempotency-Key opt-in makes POST/PATCH safe, Retry-After honored,\n# exponential backoff with full jitter, a fresh timeout budget per attempt), and\n# the reverse on_response onion.\nfrom __future__ import annotations\n\nimport asyncio\nimport random\nimport time\nimport uuid\nfrom dataclasses import dataclass\nfrom typing import Any, Dict, Generic, List, Optional, Tuple, TypeVar\n\nimport httpx\n\nfrom ._errors import ApiTimeoutError\n\nT = TypeVar("T")\n\n\n@dataclass\nclass Envelope(Generic[T]):\n    """A *_with_headers() result: decoded body + coerced declared headers + raw response."""\n\n    data: T\n    headers: Dict[str, Any]\n    response: httpx.Response\n\n\ndef read_envelope_headers(\n    response: httpx.Response, specs: List[Tuple[str, str, str]]\n) -> Dict[str, Any]:\n    """Coerce declared response headers per (name, key, type) specs; absent/unparsable omitted."""\n    headers: Dict[str, Any] = {}\n    for name, key, type_ in specs:\n        raw = response.headers.get(name)\n        if raw is None:\n            continue\n        if type_ in ("integer", "number"):\n            try:\n                headers[key] = int(raw) if type_ == "integer" else float(raw)\n            except ValueError:\n                pass\n        elif type_ == "boolean":\n            lower = raw.strip().lower()\n            if lower in ("true", "false"):\n                headers[key] = lower == "true"\n        else:\n            headers[key] = raw\n    return headers\n\n\n_IDEMPOTENT_METHODS = {"GET", "HEAD", "PUT", "DELETE", "OPTIONS"}\n_TRANSIENT_STATUS = {408, 429, 500, 502, 503, 504}\n\n\ndef _default_retry_on(method: str, headers: Dict[str, str], response: Optional[httpx.Response]) -> bool:\n    safe = method.upper() in _IDEMPOTENT_METHODS or "Idempotency-Key" in headers\n    if not safe:\n        return False\n    return response is None or response.status_code in _TRANSIENT_STATUS\n\n\ndef _retry_delay(retry: Dict[str, Any], attempt: int, retry_after: Optional[str]) -> float:\n    if retry_after:\n        try:\n            return float(retry_after)\n        except ValueError:\n            pass  # HTTP-date form: fall through to backoff\n    base = float(retry.get("retry_delay", 1.0))\n    raw = base if retry.get("retry_strategy") == "fixed" else base * (2 ** (attempt - 1))\n    return random.uniform(0, raw) if retry.get("jitter", True) is not False else raw\n\n\ndef send(\n    client: httpx.Client,\n    config: Dict[str, Any],\n    op: Dict[str, Any],\n    url: str,\n    *,\n    method: str,\n    headers: Optional[Dict[str, str]] = None,\n    params: Optional[Dict[str, Any]] = None,\n    json_body: Any = None,\n    content: Any = None,\n    data: Any = None,\n    files: Any = None,\n    timeout: Optional[float] = None,\n    idempotency_key: Any = None,\n    retry: Optional[Dict[str, Any]] = None,\n) -> httpx.Response:\n    merged_retry: Dict[str, Any] = {**(config.get("retry") or {}), **(retry or {})}\n    effective_timeout = timeout if timeout is not None else config.get("timeout")\n    merged_headers: Dict[str, str] = {**(config.get("headers") or {}), **(headers or {})}\n\n    # One stable key per LOGICAL call — set before the retry loop so every\n    # attempt re-sends the same key; a caller-provided header always wins.\n    key = idempotency_key if idempotency_key is not None else config.get("idempotency_key")\n    if (\n        key not in (None, False)\n        and method.upper() in ("POST", "PATCH")\n        and "Idempotency-Key" not in merged_headers\n    ):\n        merged_headers["Idempotency-Key"] = (\n            key if isinstance(key, str) else key() if callable(key) else str(uuid.uuid4())\n        )\n\n    context = {\n        "url": url,\n        "method": method.upper(),\n        "headers": merged_headers,\n        "body": json_body,\n        "operation": op,\n    }\n    middleware: List[Any] = config.get("middleware") or []\n    for mw in middleware:\n        on_request = getattr(mw, "on_request", None) or (mw.get("on_request") if isinstance(mw, dict) else None)\n        if on_request:\n            on_request(context)\n\n    max_attempts = 1 + int(merged_retry.get("retries", 0))\n    retry_on = merged_retry.get("retry_on") or (\n        lambda ctx: _default_retry_on(context["method"], context["headers"], ctx.get("response"))\n    )\n\n    attempt = 0\n    while True:\n        attempt += 1\n        try:\n            response = client.request(\n                context["method"],\n                context["url"],\n                headers=context["headers"],\n                params=params,\n                json=context["body"] if content is None and files is None and data is None else None,\n                content=content,\n                data=data,\n                files=files,\n                timeout=effective_timeout if effective_timeout is not None else httpx.USE_CLIENT_DEFAULT,\n            )\n        except httpx.TimeoutException:\n            if attempt < max_attempts and retry_on({"attempt": attempt, "response": None}):\n                time.sleep(_retry_delay(merged_retry, attempt, None))\n                continue\n            raise ApiTimeoutError(op.get("id", "?"), float(effective_timeout or 0), attempt) from None\n        except httpx.TransportError:\n            if attempt < max_attempts and retry_on({"attempt": attempt, "response": None}):\n                time.sleep(_retry_delay(merged_retry, attempt, None))\n                continue\n            raise\n\n        for mw in reversed(middleware):\n            on_response = getattr(mw, "on_response", None) or (mw.get("on_response") if isinstance(mw, dict) else None)\n            if on_response:\n                replaced = on_response(response, context)\n                if replaced is not None:\n                    response = replaced\n\n        if (\n            not response.is_success\n            and attempt < max_attempts\n            and retry_on({"attempt": attempt, "response": response})\n        ):\n            time.sleep(_retry_delay(merged_retry, attempt, response.headers.get("retry-after")))\n            continue\n        return response\n\n\nasync def send_async(\n    client: httpx.AsyncClient,\n    config: Dict[str, Any],\n    op: Dict[str, Any],\n    url: str,\n    *,\n    method: str,\n    headers: Optional[Dict[str, str]] = None,\n    params: Optional[Dict[str, Any]] = None,\n    json_body: Any = None,\n    content: Any = None,\n    data: Any = None,\n    files: Any = None,\n    timeout: Optional[float] = None,\n    idempotency_key: Any = None,\n    retry: Optional[Dict[str, Any]] = None,\n) -> httpx.Response:\n    """The async mirror of send() — same retry/timeout/idempotency semantics."""\n    merged_retry: Dict[str, Any] = {**(config.get("retry") or {}), **(retry or {})}\n    effective_timeout = timeout if timeout is not None else config.get("timeout")\n    merged_headers: Dict[str, str] = {**(config.get("headers") or {}), **(headers or {})}\n    key = idempotency_key if idempotency_key is not None else config.get("idempotency_key")\n    if (\n        key not in (None, False)\n        and method.upper() in ("POST", "PATCH")\n        and "Idempotency-Key" not in merged_headers\n    ):\n        merged_headers["Idempotency-Key"] = (\n            key if isinstance(key, str) else key() if callable(key) else str(uuid.uuid4())\n        )\n    context = {\n        "url": url,\n        "method": method.upper(),\n        "headers": merged_headers,\n        "body": json_body,\n        "operation": op,\n    }\n    middleware: List[Any] = config.get("middleware") or []\n    for mw in middleware:\n        on_request = getattr(mw, "on_request", None) or (mw.get("on_request") if isinstance(mw, dict) else None)\n        if on_request:\n            on_request(context)\n    max_attempts = 1 + int(merged_retry.get("retries", 0))\n    retry_on = merged_retry.get("retry_on") or (\n        lambda ctx: _default_retry_on(context["method"], context["headers"], ctx.get("response"))\n    )\n    attempt = 0\n    while True:\n        attempt += 1\n        try:\n            response = await client.request(\n                context["method"],\n                context["url"],\n                headers=context["headers"],\n                params=params,\n                json=context["body"] if content is None and files is None and data is None else None,\n                content=content,\n                data=data,\n                files=files,\n                timeout=effective_timeout if effective_timeout is not None else httpx.USE_CLIENT_DEFAULT,\n            )\n        except httpx.TimeoutException:\n            if attempt < max_attempts and retry_on({"attempt": attempt, "response": None}):\n                await asyncio.sleep(_retry_delay(merged_retry, attempt, None))\n                continue\n            raise ApiTimeoutError(op.get("id", "?"), float(effective_timeout or 0), attempt) from None\n        except httpx.TransportError:\n            if attempt < max_attempts and retry_on({"attempt": attempt, "response": None}):\n                await asyncio.sleep(_retry_delay(merged_retry, attempt, None))\n                continue\n            raise\n        for mw in reversed(middleware):\n            on_response = getattr(mw, "on_response", None) or (mw.get("on_response") if isinstance(mw, dict) else None)\n            if on_response:\n                replaced = on_response(response, context)\n                if replaced is not None:\n                    response = replaced\n        if (\n            not response.is_success\n            and attempt < max_attempts\n            and retry_on({"attempt": attempt, "response": response})\n        ):\n            await asyncio.sleep(_retry_delay(merged_retry, attempt, response.headers.get("retry-after")))\n            continue\n        return response\n',
+    '_paginate.py': '# Auto-pagination iterators for generated Python clients — the TypeScript\n# runtime\'s paginate.ts semantics ported: cursor (next-cursor pointer, optional\n# has-more flag, repeated-cursor guard), offset/page (advance by count/one,\n# repeated-page guard, null start treated as absent), and link (RFC 8288\n# `Link: rel="next"` following with relative resolution and a loop guard).\nfrom __future__ import annotations\n\nimport re\nfrom typing import Any, AsyncIterator, Awaitable, Callable, Dict, Iterator, Optional, Tuple\nfrom urllib.parse import parse_qsl, urljoin, urlparse\n\n# call(params) -> (parsed_json, httpx.Response)\nPageCall = Callable[[Dict[str, Any]], Tuple[Any, Any]]\n\n\ndef resolve_pointer(data: Any, pointer: str) -> Any:\n    """RFC 6901 JSON pointer over parsed JSON; None on any miss."""\n    if pointer == "":\n        return data\n    if not pointer.startswith("/"):\n        return None\n    current = data\n    for token in pointer[1:].split("/"):\n        key = token.replace("~1", "/").replace("~0", "~")\n        if isinstance(current, dict):\n            current = current.get(key)\n        elif isinstance(current, list) and key.isdigit():\n            index = int(key)\n            current = current[index] if index < len(current) else None\n        else:\n            return None\n        if current is None:\n            return None\n    return current\n\n\ndef iter_pages(call: PageCall, spec: Dict[str, Any], params: Optional[Dict[str, Any]] = None) -> Iterator[Any]:\n    """Yield raw page JSON per the pagination spec; every page is yielded before\n    the stop condition is evaluated, so the last page always arrives."""\n    style = spec["style"]\n    base = dict(params or {})\n    if style == "cursor":\n        cursor = base.get(spec["param"])\n        while True:\n            page_params = dict(base)\n            if cursor is not None:\n                page_params[spec["param"]] = cursor\n            page, _response = call(page_params)\n            yield page\n            if spec.get("has_more") is not None and resolve_pointer(page, spec["has_more"]) is False:\n                return\n            nxt = resolve_pointer(page, spec.get("next_cursor", ""))\n            if nxt is None or nxt == "":\n                return\n            if not isinstance(nxt, (str, int, float)):\n                raise ValueError(f"Pagination cursor at {spec[\'next_cursor\']} is not a string or number")\n            if nxt == cursor:\n                raise ValueError("Pagination did not advance: the operation returned the same cursor twice")\n            cursor = nxt\n    elif style == "link":\n        yield from _iter_pages_by_link(call, base)\n    else:  # offset / page\n        start = base.get(spec["param"])\n        fallback = 1 if style == "page" else 0\n        try:\n            position = fallback if start in (None, "") else int(start)\n        except (TypeError, ValueError):\n            position = fallback\n        previous_items = None\n        while True:\n            page, _response = call({**base, spec["param"]: position})\n            items = resolve_pointer(page, spec.get("items", ""))\n            serialized = repr(items) if isinstance(items, list) else None\n            if serialized is not None and serialized == previous_items:\n                raise ValueError("Pagination did not advance: the operation returned the same page twice")\n            yield page\n            if not isinstance(items, list) or len(items) == 0:\n                return\n            previous_items = serialized\n            position += 1 if style == "page" else len(items)\n\n\ndef _link_next(header: Optional[str]) -> Optional[str]:\n    if not header:\n        return None\n    for entry in re.split(r",\\s*(?=<)", header):\n        match = re.match(r"^\\s*<([^>]*)>(.*)$", entry)\n        if not match:\n            continue\n        rel = re.search(r\';\\s*rel\\s*=\\s*"?([^";]+)"?\', match.group(2), re.IGNORECASE)\n        if rel and "next" in rel.group(1).split():\n            return match.group(1)\n    return None\n\n\ndef _iter_pages_by_link(call: PageCall, base: Dict[str, Any]) -> Iterator[Any]:\n    params = dict(base)\n    previous = None\n    while True:\n        page, response = call(params)\n        yield page\n        target = _link_next(response.headers.get("link"))\n        if target is None:\n            return\n        page_url = str(response.request.url) if response.request is not None else ""\n        nxt = urljoin(page_url or "http://relative.invalid", target)\n        if nxt in (previous, page_url):\n            raise ValueError(\'Pagination did not advance: the Link rel="next" target repeats\')\n        previous = nxt\n        link_params: Dict[str, Any] = {}\n        for key, value in parse_qsl(urlparse(nxt).query):\n            if key in link_params:\n                existing = link_params[key]\n                link_params[key] = [*existing, value] if isinstance(existing, list) else [existing, value]\n            else:\n                link_params[key] = value\n        params = {**base, **link_params}\n\n\ndef iter_items(call: PageCall, spec: Dict[str, Any], params: Optional[Dict[str, Any]] = None) -> Iterator[Any]:\n    """Each page\'s `items` pointer, flattened."""\n    for page in iter_pages(call, spec, params):\n        items = resolve_pointer(page, spec.get("items", ""))\n        if isinstance(items, list):\n            yield from items\n\n\n# call(params) -> awaitable of (parsed_json, httpx.Response)\nAsyncPageCall = Callable[[Dict[str, Any]], Awaitable[Tuple[Any, Any]]]\n\n\nasync def aiter_pages(\n    call: AsyncPageCall, spec: Dict[str, Any], params: Optional[Dict[str, Any]] = None\n) -> AsyncIterator[Any]:\n    """Async mirror of iter_pages — same stop conditions and guards."""\n    style = spec["style"]\n    base = dict(params or {})\n    if style == "cursor":\n        cursor = base.get(spec["param"])\n        while True:\n            page_params = dict(base)\n            if cursor is not None:\n                page_params[spec["param"]] = cursor\n            page, _response = await call(page_params)\n            yield page\n            if spec.get("has_more") is not None and resolve_pointer(page, spec["has_more"]) is False:\n                return\n            nxt = resolve_pointer(page, spec.get("next_cursor", ""))\n            if nxt is None or nxt == "":\n                return\n            if not isinstance(nxt, (str, int, float)):\n                raise ValueError(f"Pagination cursor at {spec[\'next_cursor\']} is not a string or number")\n            if nxt == cursor:\n                raise ValueError("Pagination did not advance: the operation returned the same cursor twice")\n            cursor = nxt\n    elif style == "link":\n        previous = None\n        link_params: Dict[str, Any] = dict(base)\n        while True:\n            page, response = await call(link_params)\n            yield page\n            target = _link_next(response.headers.get("link"))\n            if target is None:\n                return\n            page_url = str(response.request.url) if response.request is not None else ""\n            nxt = urljoin(page_url or "http://relative.invalid", target)\n            if nxt in (previous, page_url):\n                raise ValueError(\'Pagination did not advance: the Link rel="next" target repeats\')\n            previous = nxt\n            merged: Dict[str, Any] = {}\n            for key, value in parse_qsl(urlparse(nxt).query):\n                if key in merged:\n                    existing = merged[key]\n                    merged[key] = [*existing, value] if isinstance(existing, list) else [existing, value]\n                else:\n                    merged[key] = value\n            link_params = {**base, **merged}\n    else:\n        start = base.get(spec["param"])\n        fallback = 1 if style == "page" else 0\n        try:\n            position = fallback if start in (None, "") else int(start)\n        except (TypeError, ValueError):\n            position = fallback\n        previous_items = None\n        while True:\n            page, _response = await call({**base, spec["param"]: position})\n            items = resolve_pointer(page, spec.get("items", ""))\n            serialized = repr(items) if isinstance(items, list) else None\n            if serialized is not None and serialized == previous_items:\n                raise ValueError("Pagination did not advance: the operation returned the same page twice")\n            yield page\n            if not isinstance(items, list) or len(items) == 0:\n                return\n            previous_items = serialized\n            position += 1 if style == "page" else len(items)\n\n\nasync def aiter_items(\n    call: AsyncPageCall, spec: Dict[str, Any], params: Optional[Dict[str, Any]] = None\n) -> AsyncIterator[Any]:\n    async for page in aiter_pages(call, spec, params):\n        items = resolve_pointer(page, spec.get("items", ""))\n        if isinstance(items, list):\n            for item in items:\n                yield item\n',
+    '_sse.py': '# Server-Sent Events for generated Python clients — the TypeScript runtime\'s\n# sse.ts semantics ported: frame parsing per the EventSource spec (retry must be\n# ASCII digits; comment-only frames skipped; multi-line data joined with \\n) and\n# auto-reconnect resuming from the last event id via Last-Event-ID, with\n# exponential backoff capped at 30s. JSON payloads are parsed when the operation\n# declares a JSON event stream.\nfrom __future__ import annotations\n\nimport asyncio\nimport json\nimport random\nimport time\nfrom dataclasses import dataclass\nfrom typing import Any, AsyncIterator, Callable, Dict, Iterator, Optional\n\nimport httpx\n\n_FRAME_DELIMITER = "\\n\\n"\n\n\n@dataclass\nclass ServerSentEvent:\n    data: Any\n    event: Optional[str] = None\n    id: Optional[str] = None\n    retry: Optional[int] = None\n\n\ndef parse_sse_frame(raw: str, data_kind: str = "text") -> Optional[ServerSentEvent]:\n    event = None\n    data_lines = []\n    event_id = None\n    retry = None\n    saw_field = False\n    for line in raw.replace("\\r\\n", "\\n").replace("\\r", "\\n").split("\\n"):\n        if line == "" or line.startswith(":"):\n            continue\n        field, _, value = line.partition(":")\n        if value.startswith(" "):\n            value = value[1:]\n        saw_field = True\n        if field == "event":\n            event = value\n        elif field == "data":\n            data_lines.append(value)\n        elif field == "id":\n            event_id = value\n        elif field == "retry" and value.isdigit():\n            retry = int(value)\n    if not saw_field:\n        return None\n    text = "\\n".join(data_lines)\n    data: Any = text\n    if data_kind == "json" and text != "":\n        data = json.loads(text)\n    return ServerSentEvent(data=data, event=event, id=event_id, retry=retry)\n\n\ndef iter_sse(\n    open_stream: Callable[[Dict[str, str]], Any],\n    data_kind: str = "text",\n    reconnect: bool = True,\n    reconnect_delay: float = 1.0,\n) -> Iterator[ServerSentEvent]:\n    """Iterate an event stream. `open_stream(extra_headers)` must return an\n    httpx streaming-response context manager; it is reopened on dropped\n    connections with Last-Event-ID set (fresh call = fresh auth)."""\n    last_event_id: Optional[str] = None\n    server_retry: Optional[float] = None\n    failures = 0\n    while True:\n        headers = {"Accept": "text/event-stream"}\n        if last_event_id is not None:\n            headers["Last-Event-ID"] = last_event_id\n        try:\n            with open_stream(headers) as response:\n                if response.status_code >= 400:\n                    response.read()\n                    raise httpx.HTTPStatusError(\n                        f"SSE request failed with status {response.status_code}",\n                        request=response.request,\n                        response=response,\n                    )\n                failures = 0\n                buffer = ""\n                for chunk in response.iter_text():\n                    buffer += chunk\n                    while _FRAME_DELIMITER in buffer:\n                        raw, buffer = buffer.split(_FRAME_DELIMITER, 1)\n                        parsed = parse_sse_frame(raw, data_kind)\n                        if parsed is not None:\n                            if parsed.id is not None:\n                                last_event_id = parsed.id\n                            if parsed.retry is not None:\n                                server_retry = parsed.retry / 1000\n                            yield parsed\n                # Clean end: flush a trailing frame, then finish (no reconnect).\n                if buffer.strip():\n                    parsed = parse_sse_frame(buffer, data_kind)\n                    if parsed is not None:\n                        yield parsed\n                return\n        except httpx.HTTPStatusError:\n            raise  # a 4xx/5xx is definitive, not a dropped connection\n        except (httpx.TransportError, httpx.TimeoutException):\n            if not reconnect:\n                raise\n        failures += 1\n        base = server_retry if server_retry is not None else reconnect_delay\n        time.sleep(random.uniform(0, min(base * (2 ** (failures - 1)), 30.0)))\n\n\nasync def aiter_sse(\n    open_stream: Callable[[Dict[str, str]], Any],\n    data_kind: str = "text",\n    reconnect: bool = True,\n    reconnect_delay: float = 1.0,\n) -> AsyncIterator[ServerSentEvent]:\n    """Async mirror of iter_sse; `open_stream` returns an async context manager."""\n    last_event_id: Optional[str] = None\n    server_retry: Optional[float] = None\n    failures = 0\n    while True:\n        headers = {"Accept": "text/event-stream"}\n        if last_event_id is not None:\n            headers["Last-Event-ID"] = last_event_id\n        try:\n            async with open_stream(headers) as response:\n                if response.status_code >= 400:\n                    await response.aread()\n                    raise httpx.HTTPStatusError(\n                        f"SSE request failed with status {response.status_code}",\n                        request=response.request,\n                        response=response,\n                    )\n                failures = 0\n                buffer = ""\n                async for chunk in response.aiter_text():\n                    buffer += chunk\n                    while _FRAME_DELIMITER in buffer:\n                        raw, buffer = buffer.split(_FRAME_DELIMITER, 1)\n                        parsed = parse_sse_frame(raw, data_kind)\n                        if parsed is not None:\n                            if parsed.id is not None:\n                                last_event_id = parsed.id\n                            if parsed.retry is not None:\n                                server_retry = parsed.retry / 1000\n                            yield parsed\n                if buffer.strip():\n                    parsed = parse_sse_frame(buffer, data_kind)\n                    if parsed is not None:\n                        yield parsed\n                return\n        except httpx.HTTPStatusError:\n            raise\n        except (httpx.TransportError, httpx.TimeoutException):\n            if not reconnect:\n                raise\n        failures += 1\n        base = server_retry if server_retry is not None else reconnect_delay\n        await asyncio.sleep(random.uniform(0, min(base * (2 ** (failures - 1)), 30.0)))\n',
+    '_multipart.py': '# Multipart bodies for generated Python clients — a typed dict/dataclass body is\n# split into httpx\'s (data, files): bytes and file-like values upload as parts,\n# everything else is form data (nested values JSON-encoded, mirroring the\n# TypeScript runtime\'s FormData serialization).\nfrom __future__ import annotations\n\nimport json\nfrom typing import Any, Dict, Tuple\n\nfrom ._decode import encode\n\n\ndef to_multipart(body: Any) -> Tuple[Dict[str, Any], Dict[str, Any]]:\n    wire = encode(body)\n    data: Dict[str, Any] = {}\n    files: Dict[str, Any] = {}\n    for key, value in (wire or {}).items():\n        if isinstance(value, (bytes, bytearray)) or hasattr(value, "read"):\n            files[key] = value\n        elif isinstance(value, (dict, list)):\n            data[key] = json.dumps(value)\n        else:\n            data[key] = value\n    return data, files\n',
+};
+//# sourceMappingURL=python.js.map

package/lib/runtime-sources/python.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python.js","sourceRoot":"","sources":["../../src/runtime-sources/python.ts"],"names":[],"mappings":"AAAA,iKAAiK;AACjK,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,YAAY,EACV,+lDAA+lD;IACjmD,UAAU,EACR,spGAAspG;IACxpG,SAAS,EACP,ghBAAghB;IAClhB,YAAY,EACV,+yKAA+yK;IACjzK,UAAU,EACR,82TAA82T;IACh3T,cAAc,EACZ,s4RAAs4R;IACx4R,SAAS,EACP,03MAA03M;IAC53M,eAAe,EACb,u3BAAu3B;CACj3B,CAAC"}