-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathir.py
More file actions
72 lines (52 loc) · 1.69 KB
/
Copy pathir.py
File metadata and controls
72 lines (52 loc) · 1.69 KB
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
60
61
62
63
64
65
66
67
68
69
70
71
72
"""Language-agnostic intermediate representation for client SDK codegen."""
from __future__ import annotations
from dataclasses import dataclass
from typing import Any, Literal
_SENTINEL = object()
@dataclass(frozen=True, slots=True)
class FieldIR:
"""A single field on a struct schema."""
name: str
type_str: str
required: bool
default: Any = _SENTINEL # _SENTINEL → no default
description: str | None = None
@dataclass(frozen=True, slots=True)
class SchemaIR:
"""One entry from components.schemas."""
name: str
kind: Literal["struct", "alias", "enum"]
fields: tuple[FieldIR, ...] = ()
alias_of: str | None = None
enum_values: tuple[str, ...] = ()
@dataclass(frozen=True, slots=True)
class ParamIR:
"""A path, query, or header parameter."""
name: str
type_str: str
required: bool
default: Any = _SENTINEL
description: str | None = None
@dataclass(frozen=True, slots=True)
class OperationIR:
"""One HTTP operation from paths."""
operation_id: str
method: Literal["get", "post", "put", "patch", "delete"]
path: str
path_params: tuple[ParamIR, ...] = ()
query_params: tuple[ParamIR, ...] = ()
header_params: tuple[ParamIR, ...] = ()
body_type: str | None = None
response_type: str | None = None
summary: str | None = None
description: str | None = None
@dataclass(frozen=True, slots=True)
class ClientIR:
"""Top-level IR for a complete client SDK."""
title: str
version: str
base_url: str | None = None
schemas: tuple[SchemaIR, ...] = ()
operations: tuple[OperationIR, ...] = ()
# Exported sentinel so renderers can check ``field.default is SENTINEL``
SENTINEL = _SENTINEL