forked from openapi-generators/openapi-python-client
-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy path__init__.py
561 lines (476 loc) · 20.5 KB
/
__init__.py
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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
from itertools import chain
from typing import Any, ClassVar, Dict, Generic, Iterable, Iterator, List, Optional, Set, Tuple, TypeVar, Union
import attr
from ... import schema as oai
from ... import utils
from ..errors import PropertyError, ValidationError
from ..reference import Reference
from .converter import convert, convert_chain
from .enum_property import EnumProperty
from .model_property import ModelProperty
from .property import Property
from .schemas import Schemas
@attr.s(auto_attribs=True, frozen=True)
class NoneProperty(Property):
""" A property that is always None (used for empty schemas) """
_type_string: ClassVar[str] = "None"
template: ClassVar[Optional[str]] = "none_property.py.jinja"
@attr.s(auto_attribs=True, frozen=True)
class StringProperty(Property):
""" A property of type str """
max_length: Optional[int] = None
pattern: Optional[str] = None
_type_string: ClassVar[str] = "str"
@attr.s(auto_attribs=True, frozen=True)
class DateTimeProperty(Property):
"""
A property of type datetime.datetime
"""
_type_string: ClassVar[str] = "datetime.datetime"
template: ClassVar[str] = "datetime_property.py.jinja"
def get_imports(self, *, prefix: str) -> Set[str]:
"""
Get a set of import strings that should be included when this property is used somewhere
Args:
prefix: A prefix to put before any relative (local) module names. This should be the number of . to get
back to the root of the generated client.
"""
imports = super().get_imports(prefix=prefix)
imports.update({"import datetime", "from typing import cast", "from dateutil.parser import isoparse"})
return imports
@attr.s(auto_attribs=True, frozen=True)
class DateProperty(Property):
""" A property of type datetime.date """
_type_string: ClassVar[str] = "datetime.date"
template: ClassVar[str] = "date_property.py.jinja"
def get_imports(self, *, prefix: str) -> Set[str]:
"""
Get a set of import strings that should be included when this property is used somewhere
Args:
prefix: A prefix to put before any relative (local) module names. This should be the number of . to get
back to the root of the generated client.
"""
imports = super().get_imports(prefix=prefix)
imports.update({"import datetime", "from typing import cast", "from dateutil.parser import isoparse"})
return imports
@attr.s(auto_attribs=True, frozen=True)
class FileProperty(Property):
""" A property used for uploading files """
_type_string: ClassVar[str] = "File"
template: ClassVar[str] = "file_property.py.jinja"
def get_imports(self, *, prefix: str) -> Set[str]:
"""
Get a set of import strings that should be included when this property is used somewhere
Args:
prefix: A prefix to put before any relative (local) module names. This should be the number of . to get
back to the root of the generated client.
"""
imports = super().get_imports(prefix=prefix)
imports.update({f"from {prefix}types import File", "from io import BytesIO"})
return imports
@attr.s(auto_attribs=True, frozen=True)
class FloatProperty(Property):
""" A property of type float """
_type_string: ClassVar[str] = "float"
@attr.s(auto_attribs=True, frozen=True)
class IntProperty(Property):
""" A property of type int """
_type_string: ClassVar[str] = "int"
@attr.s(auto_attribs=True, frozen=True)
class BooleanProperty(Property):
""" Property for bool """
_type_string: ClassVar[str] = "bool"
InnerProp = TypeVar("InnerProp", bound=Property)
@attr.s(auto_attribs=True, frozen=True)
class ListProperty(Property, Generic[InnerProp]):
""" A property representing a list (array) of other properties """
inner_property: InnerProp
template: ClassVar[str] = "list_property.py.jinja"
def get_type_string(self, no_optional: bool = False) -> str:
""" Get a string representation of type that should be used when declaring this property """
type_string = f"List[{self.inner_property.get_type_string()}]"
if no_optional:
return type_string
if self.nullable:
type_string = f"Optional[{type_string}]"
if not self.required:
type_string = f"Union[Unset, {type_string}]"
return type_string
def get_instance_type_string(self) -> str:
"""Get a string representation of runtime type that should be used for `isinstance` checks"""
return "list"
def get_imports(self, *, prefix: str) -> Set[str]:
"""
Get a set of import strings that should be included when this property is used somewhere
Args:
prefix: A prefix to put before any relative (local) module names. This should be the number of . to get
back to the root of the generated client.
"""
imports = super().get_imports(prefix=prefix)
imports.update(self.inner_property.get_imports(prefix=prefix))
imports.add("from typing import cast, List")
return imports
@attr.s(auto_attribs=True, frozen=True)
class UnionProperty(Property):
""" A property representing a Union (anyOf) of other properties """
inner_properties: List[Property]
template: ClassVar[str] = "union_property.py.jinja"
has_properties_without_templates: bool = attr.ib(init=False)
def __attrs_post_init__(self) -> None:
super().__attrs_post_init__()
object.__setattr__(
self, "has_properties_without_templates", any(prop.template is None for prop in self.inner_properties)
)
def get_type_string(self, no_optional: bool = False) -> str:
""" Get a string representation of type that should be used when declaring this property """
inner_types = [p.get_type_string(no_optional=True) for p in self.inner_properties]
inner_prop_string = ", ".join(inner_types)
type_string = f"Union[{inner_prop_string}]"
if no_optional:
return type_string
if not self.required:
type_string = f"Union[Unset, {inner_prop_string}]"
if self.nullable:
type_string = f"Optional[{type_string}]"
return type_string
def get_imports(self, *, prefix: str) -> Set[str]:
"""
Get a set of import strings that should be included when this property is used somewhere
Args:
prefix: A prefix to put before any relative (local) module names. This should be the number of . to get
back to the root of the generated client.
"""
imports = super().get_imports(prefix=prefix)
for inner_prop in self.inner_properties:
imports.update(inner_prop.get_imports(prefix=prefix))
imports.add("from typing import cast, Union")
return imports
def inner_properties_with_template(self) -> Iterator[Property]:
return (prop for prop in self.inner_properties if prop.template)
def _string_based_property(
name: str, required: bool, data: oai.Schema
) -> Union[StringProperty, DateProperty, DateTimeProperty, FileProperty]:
""" Construct a Property from the type "string" """
string_format = data.schema_format
if string_format == "date-time":
return DateTimeProperty(
name=name,
required=required,
default=convert("datetime.datetime", data.default),
nullable=data.nullable,
)
elif string_format == "date":
return DateProperty(
name=name,
required=required,
default=convert("datetime.date", data.default),
nullable=data.nullable,
)
elif string_format == "binary":
return FileProperty(
name=name,
required=required,
default=None,
nullable=data.nullable,
)
else:
return StringProperty(
name=name,
default=convert("str", data.default),
required=required,
pattern=data.pattern,
nullable=data.nullable,
)
def build_model_property(
*, data: oai.Schema, name: str, schemas: Schemas, required: bool, parent_name: Optional[str]
) -> Tuple[Union[ModelProperty, PropertyError], Schemas]:
"""
A single ModelProperty from its OAI data
Args:
data: Data of a single Schema
name: Name by which the schema is referenced, such as a model name.
Used to infer the type name if a `title` property is not available.
schemas: Existing Schemas which have already been processed (to check name conflicts)
"""
required_set = set(data.required or [])
required_properties: List[Property] = []
optional_properties: List[Property] = []
relative_imports: Set[str] = set()
class_name = data.title or name
if parent_name:
class_name = f"{utils.pascal_case(parent_name)}{utils.pascal_case(class_name)}"
ref = Reference.from_ref(class_name)
for key, value in (data.properties or {}).items():
prop_required = key in required_set
prop, schemas = property_from_data(
name=key, required=prop_required, data=value, schemas=schemas, parent_name=class_name
)
if isinstance(prop, PropertyError):
return prop, schemas
if prop_required and not prop.nullable:
required_properties.append(prop)
else:
optional_properties.append(prop)
relative_imports.update(prop.get_imports(prefix=".."))
additional_properties: Union[bool, Property, PropertyError]
if data.additionalProperties is None:
additional_properties = True
elif isinstance(data.additionalProperties, bool):
additional_properties = data.additionalProperties
elif isinstance(data.additionalProperties, oai.Schema) and not any(data.additionalProperties.dict().values()):
# An empty schema
additional_properties = True
else:
assert isinstance(data.additionalProperties, (oai.Schema, oai.Reference))
additional_properties, schemas = property_from_data(
name="AdditionalProperty",
required=True, # in the sense that if present in the dict will not be None
data=data.additionalProperties,
schemas=schemas,
parent_name=class_name,
)
if isinstance(additional_properties, PropertyError):
return additional_properties, schemas
relative_imports.update(additional_properties.get_imports(prefix=".."))
prop = ModelProperty(
reference=ref,
required_properties=required_properties,
optional_properties=optional_properties,
relative_imports=relative_imports,
description=data.description or "",
default=None,
nullable=data.nullable,
required=required,
name=name,
additional_properties=additional_properties,
)
if prop.reference.class_name in schemas.models:
error = PropertyError(
data=data, detail=f'Attempted to generate duplicate models with name "{prop.reference.class_name}"'
)
return error, schemas
schemas = attr.evolve(schemas, models={**schemas.models, prop.reference.class_name: prop})
return prop, schemas
def build_enum_property(
*,
data: oai.Schema,
name: str,
required: bool,
schemas: Schemas,
enum: List[Union[str, int]],
parent_name: Optional[str],
) -> Tuple[Union[EnumProperty, PropertyError], Schemas]:
"""
Create an EnumProperty from schema data.
Args:
data: The OpenAPI Schema which defines this enum.
name: The name to use for variables which receive this Enum's value (e.g. model property name)
required: Whether or not this Property is required in the calling context
schemas: The Schemas which have been defined so far (used to prevent naming collisions)
enum: The enum from the provided data. Required separately here to prevent extra type checking.
parent_name: The context in which this EnumProperty is defined, used to create more specific class names.
Returns:
A tuple containing either the created property or a PropertyError describing what went wrong AND update schemas.
"""
class_name = data.title or name
if parent_name:
class_name = f"{utils.pascal_case(parent_name)}{utils.pascal_case(class_name)}"
reference = Reference.from_ref(class_name)
values = EnumProperty.values_from_list(enum)
if reference.class_name in schemas.enums:
existing = schemas.enums[reference.class_name]
if values != existing.values:
return (
PropertyError(
detail=f"Found conflicting enums named {reference.class_name} with incompatible values.", data=data
),
schemas,
)
for value in values.values():
value_type = type(value)
break
else:
return PropertyError(data=data, detail="No values provided for Enum"), schemas
default = None
if data.default is not None:
inverse_values = {v: k for k, v in values.items()}
try:
default = f"{reference.class_name}.{inverse_values[data.default]}"
except KeyError:
return (
PropertyError(
detail=f"{data.default} is an invalid default for enum {reference.class_name}", data=data
),
schemas,
)
prop = EnumProperty(
name=name,
required=required,
default=default,
nullable=data.nullable,
reference=reference,
values=values,
value_type=value_type,
)
if prop.reference.class_name in schemas.enums:
error = PropertyError(
data=data, detail=f'Attempted to generate duplicate enums with name "{prop.reference.class_name}"'
)
return error, schemas
schemas = attr.evolve(schemas, enums={**schemas.enums, prop.reference.class_name: prop})
return prop, schemas
def build_union_property(
*, data: oai.Schema, name: str, required: bool, schemas: Schemas, parent_name: str
) -> Tuple[Union[UnionProperty, PropertyError], Schemas]:
sub_properties: List[Property] = []
for sub_prop_data in chain(data.anyOf, data.oneOf):
sub_prop, schemas = property_from_data(
name=name, required=required, data=sub_prop_data, schemas=schemas, parent_name=parent_name
)
if isinstance(sub_prop, PropertyError):
return PropertyError(detail=f"Invalid property in union {name}", data=sub_prop_data), schemas
sub_properties.append(sub_prop)
default = convert_chain((prop._type_string for prop in sub_properties), data.default)
return (
UnionProperty(
name=name,
required=required,
default=default,
inner_properties=sub_properties,
nullable=data.nullable,
),
schemas,
)
def build_list_property(
*, data: oai.Schema, name: str, required: bool, schemas: Schemas, parent_name: str
) -> Tuple[Union[ListProperty[Any], PropertyError], Schemas]:
if data.items is None:
return PropertyError(data=data, detail="type array must have items defined"), schemas
inner_prop, schemas = property_from_data(
name=f"{name}_item", required=True, data=data.items, schemas=schemas, parent_name=parent_name
)
if isinstance(inner_prop, PropertyError):
return PropertyError(data=inner_prop.data, detail=f"invalid data in items of array {name}"), schemas
return (
ListProperty(
name=name,
required=required,
default=None,
inner_property=inner_prop,
nullable=data.nullable,
),
schemas,
)
def _property_from_data(
name: str,
required: bool,
data: Union[oai.Reference, oai.Schema],
schemas: Schemas,
parent_name: str,
) -> Tuple[Union[Property, PropertyError], Schemas]:
""" Generate a Property from the OpenAPI dictionary representation of it """
name = utils.remove_string_escapes(name)
if isinstance(data, oai.Reference):
reference = Reference.from_ref(data.ref)
existing = schemas.enums.get(reference.class_name) or schemas.models.get(reference.class_name)
if existing:
return (
attr.evolve(existing, required=required, name=name),
schemas,
)
return PropertyError(data=data, detail="Could not find reference in parsed models or enums"), schemas
if data.enum:
return build_enum_property(
data=data, name=name, required=required, schemas=schemas, enum=data.enum, parent_name=parent_name
)
if data.anyOf or data.oneOf:
return build_union_property(data=data, name=name, required=required, schemas=schemas, parent_name=parent_name)
if not data.type:
return NoneProperty(name=name, required=required, nullable=False, default=None), schemas
if data.type == "string":
return _string_based_property(name=name, required=required, data=data), schemas
elif data.type == "number":
return (
FloatProperty(
name=name,
default=convert("float", data.default),
required=required,
nullable=data.nullable,
),
schemas,
)
elif data.type == "integer":
return (
IntProperty(
name=name,
default=convert("int", data.default),
required=required,
nullable=data.nullable,
),
schemas,
)
elif data.type == "boolean":
return (
BooleanProperty(
name=name,
required=required,
default=convert("bool", data.default),
nullable=data.nullable,
),
schemas,
)
elif data.type == "array":
return build_list_property(data=data, name=name, required=required, schemas=schemas, parent_name=parent_name)
elif data.type == "object":
return build_model_property(data=data, name=name, schemas=schemas, required=required, parent_name=parent_name)
return PropertyError(data=data, detail=f"unknown type {data.type}"), schemas
def property_from_data(
*,
name: str,
required: bool,
data: Union[oai.Reference, oai.Schema],
schemas: Schemas,
parent_name: str,
) -> Tuple[Union[Property, PropertyError], Schemas]:
try:
return _property_from_data(name=name, required=required, data=data, schemas=schemas, parent_name=parent_name)
except ValidationError:
return PropertyError(detail="Failed to validate default value", data=data), schemas
def update_schemas_with_data(name: str, data: oai.Schema, schemas: Schemas) -> Union[Schemas, PropertyError]:
prop: Union[PropertyError, ModelProperty, EnumProperty]
if data.enum is not None:
prop, schemas = build_enum_property(
data=data, name=name, required=True, schemas=schemas, enum=data.enum, parent_name=None
)
else:
prop, schemas = build_model_property(data=data, name=name, schemas=schemas, required=True, parent_name=None)
if isinstance(prop, PropertyError):
return prop
else:
return schemas
def build_schemas(*, components: Dict[str, Union[oai.Reference, oai.Schema]]) -> Schemas:
""" Get a list of Schemas from an OpenAPI dict """
schemas = Schemas()
to_process: Iterable[Tuple[str, Union[oai.Reference, oai.Schema]]] = components.items()
processing = True
errors: List[PropertyError] = []
# References could have forward References so keep going as long as we are making progress
while processing:
processing = False
errors = []
next_round = []
# Only accumulate errors from the last round, since we might fix some along the way
for name, data in to_process:
if isinstance(data, oai.Reference):
schemas.errors.append(PropertyError(data=data, detail="Reference schemas are not supported."))
continue
schemas_or_err = update_schemas_with_data(name, data, schemas)
if isinstance(schemas_or_err, PropertyError):
next_round.append((name, data))
errors.append(schemas_or_err)
else:
schemas = schemas_or_err
processing = True # We made some progress this round, do another after it's done
to_process = next_round
schemas.errors.extend(errors)
return schemas