openapi-python-client 0.26.1__py3-none-any.whl → 0.27.0__py3-none-any.whl

openapi_python_client/parser/properties/property.py

@@ -1,8 +1,7 @@
 __all__ = ["Property"]
 
-from typing import Union
 
-from typing_extensions import TypeAlias
+from typing import TypeAlias
 
 from .any import AnyProperty
 from .boolean import BooleanProperty
@@ -21,21 +20,21 @@ from .string import StringProperty
 from .union import UnionProperty
 from .uuid import UuidProperty
 
-Property: TypeAlias = Union[
-    AnyProperty,
-    BooleanProperty,
-    ConstProperty,
-    DateProperty,
-    DateTimeProperty,
-    EnumProperty,
-    LiteralEnumProperty,
-    FileProperty,
-    FloatProperty,
-    IntProperty,
-    ListProperty,
-    ModelProperty,
-    NoneProperty,
-    StringProperty,
-    UnionProperty,
-    UuidProperty,
-]
+Property: TypeAlias = (
+    AnyProperty
+    | BooleanProperty
+    | ConstProperty
+    | DateProperty
+    | DateTimeProperty
+    | EnumProperty
+    | LiteralEnumProperty
+    | FileProperty
+    | FloatProperty
+    | IntProperty
+    | ListProperty
+    | ModelProperty
+    | NoneProperty
+    | StringProperty
+    | UnionProperty
+    | UuidProperty
+)

openapi_python_client/parser/properties/protocol.py

@@ -88,20 +88,18 @@ class PropertyProtocol(Protocol):
             PythonIdentifier(value=new_name, prefix=config.field_prefix, skip_snake_case=skip_snake_case),
         )
 
-    def get_base_type_string(self, *, quoted: bool = False) -> str:
+    def get_base_type_string(self) -> str:
         """Get the string describing the Python type of this property. Base types no require quoting."""
-        return f'"{self._type_string}"' if not self.is_base_type and quoted else self._type_string
+        return self._type_string
 
-    def get_base_json_type_string(self, *, quoted: bool = False) -> str:
+    def get_base_json_type_string(self) -> str:
         """Get the string describing the JSON type of this property. Base types no require quoting."""
-        return f'"{self._json_type_string}"' if not self.is_base_type and quoted else self._json_type_string
+        return self._json_type_string
 
     def get_type_string(
         self,
         no_optional: bool = False,
         json: bool = False,
-        *,
-        quoted: bool = False,
     ) -> str:
         """
         Get a string representation of type that should be used when declaring this property
@@ -109,20 +107,19 @@ class PropertyProtocol(Protocol):
         Args:
             no_optional: Do not include Optional or Unset even if the value is optional (needed for isinstance checks)
             json: True if the type refers to the property after JSON serialization
-            quoted: True if the type should be wrapped in quotes (if not a base type)
         """
         if json:
-            type_string = self.get_base_json_type_string(quoted=quoted)
+            type_string = self.get_base_json_type_string()
         else:
-            type_string = self.get_base_type_string(quoted=quoted)
+            type_string = self.get_base_type_string()
 
         if no_optional or self.required:
             return type_string
-        return f"Union[Unset, {type_string}]"
+        return f"{type_string} | Unset"
 
     def get_instance_type_string(self) -> str:
         """Get a string representation of runtime type that should be used for `isinstance` checks"""
-        return self.get_type_string(no_optional=True, quoted=False)
+        return self.get_type_string(no_optional=True)
 
     # noinspection PyUnusedLocal
     def get_imports(self, *, prefix: str) -> set[str]:
@@ -135,7 +132,6 @@ class PropertyProtocol(Protocol):
         """
         imports = set()
         if not self.required:
-            imports.add("from typing import Union")
             imports.add(f"from {prefix}types import UNSET, Unset")
         return imports
 
@@ -159,8 +155,8 @@ class PropertyProtocol(Protocol):
             default = None
 
         if default is not None:
-            return f"{self.python_name}: {self.get_type_string(quoted=True)} = {default}"
-        return f"{self.python_name}: {self.get_type_string(quoted=True)}"
+            return f"{self.python_name}: {self.get_type_string()} = {default}"
+        return f"{self.python_name}: {self.get_type_string()}"
 
     def to_docstring(self) -> str:
         """Returns property docstring"""
@@ -170,14 +166,3 @@ class PropertyProtocol(Protocol):
         if self.example:
             doc += f" Example: {self.example}."
         return doc
-
-    @property
-    def is_base_type(self) -> bool:
-        """Base types, represented by any other of `Property` than `ModelProperty` should not be quoted."""
-        from . import ListProperty, ModelProperty, UnionProperty  # noqa: PLC0415
-
-        return self.__class__.__name__ not in {
-            ModelProperty.__name__,
-            ListProperty.__name__,
-            UnionProperty.__name__,
-        }

openapi_python_client/parser/properties/schemas.py

@@ -10,7 +10,7 @@ __all__ = [
     "update_schemas_with_data",
 ]
 
-from typing import TYPE_CHECKING, NewType, Union, cast
+from typing import TYPE_CHECKING, NewType, cast
 from urllib.parse import urlparse
 
 from attrs import define, evolve, field
@@ -32,7 +32,7 @@ else:
 ReferencePath = NewType("ReferencePath", str)
 
 
-def parse_reference_path(ref_path_raw: str) -> Union[ReferencePath, ParseError]:
+def parse_reference_path(ref_path_raw: str) -> ReferencePath | ParseError:
     """
     Takes a raw string provided in a `$ref` and turns it into a validated `_ReferencePath` or a `ParseError` if
     validation fails.
@@ -84,12 +84,12 @@ class Schemas:
     """Structure for containing all defined, shareable, and reusable schemas (attr classes and Enums)"""
 
     classes_by_reference: dict[ReferencePath, Property] = field(factory=dict)
-    dependencies: dict[ReferencePath, set[Union[ReferencePath, ClassName]]] = field(factory=dict)
+    dependencies: dict[ReferencePath, set[ReferencePath | ClassName]] = field(factory=dict)
     classes_by_name: dict[ClassName, Property] = field(factory=dict)
     models_to_process: list[ModelProperty] = field(factory=list)
     errors: list[ParseError] = field(factory=list)
 
-    def add_dependencies(self, ref_path: ReferencePath, roots: set[Union[ReferencePath, ClassName]]) -> None:
+    def add_dependencies(self, ref_path: ReferencePath, roots: set[ReferencePath | ClassName]) -> None:
         """Record new dependencies on the given ReferencePath
 
         Args:
@@ -102,7 +102,7 @@ class Schemas:
 
 def update_schemas_with_data(
     *, ref_path: ReferencePath, data: oai.Schema, schemas: Schemas, config: Config
-) -> Union[Schemas, PropertyError]:
+) -> Schemas | PropertyError:
     """
     Update a `Schemas` using some new reference.
 
@@ -120,7 +120,7 @@ def update_schemas_with_data(
     """
     from . import property_from_data  # noqa: PLC0415
 
-    prop: Union[PropertyError, Property]
+    prop: PropertyError | Property
     prop, schemas = property_from_data(
         data=data,
         name=ref_path,
@@ -158,10 +158,10 @@ class Parameters:
 def parameter_from_data(
     *,
     name: str,
-    data: Union[oai.Reference, oai.Parameter],
+    data: oai.Reference | oai.Parameter,
     parameters: Parameters,
     config: Config,
-) -> tuple[Union[Parameter, ParameterError], Parameters]:
+) -> tuple[Parameter | ParameterError, Parameters]:
     """Generates parameters from an OpenAPI Parameter spec."""
 
     if isinstance(data, oai.Reference):
@@ -186,7 +186,7 @@ def parameter_from_data(
 
 def update_parameters_with_data(
     *, ref_path: ReferencePath, data: oai.Parameter, parameters: Parameters, config: Config
-) -> Union[Parameters, ParameterError]:
+) -> Parameters | ParameterError:
     """
     Update a `Parameters` using some new reference.
 
@@ -219,9 +219,9 @@ def update_parameters_with_data(
 
 def parameter_from_reference(
     *,
-    param: Union[oai.Reference, Parameter],
+    param: oai.Reference | Parameter,
     parameters: Parameters,
-) -> Union[Parameter, ParameterError]:
+) -> Parameter | ParameterError:
     """
     Returns a Parameter from a Reference or the Parameter itself if one was provided.
 

openapi_python_client/parser/properties/union.py

@@ -132,7 +132,6 @@ class UnionProperty(PropertyProtocol):
             p.get_type_string(
                 no_optional=True,
                 json=json,
-                quoted=not p.is_base_type,
             )
             for p in self.inner_properties
         }
@@ -141,12 +140,12 @@ class UnionProperty(PropertyProtocol):
     def _get_type_string_from_inner_type_strings(inner_types: set[str]) -> str:
         if len(inner_types) == 1:
             return inner_types.pop()
-        return f"Union[{', '.join(sorted(inner_types))}]"
+        return " | ".join(sorted(inner_types, key=lambda x: x.lower()))
 
-    def get_base_type_string(self, *, quoted: bool = False) -> str:
+    def get_base_type_string(self) -> str:
         return self._get_type_string_from_inner_type_strings(self._get_inner_type_strings(json=False))
 
-    def get_base_json_type_string(self, *, quoted: bool = False) -> str:
+    def get_base_json_type_string(self) -> str:
         return self._get_type_string_from_inner_type_strings(self._get_inner_type_strings(json=True))
 
     def get_type_strings_in_union(self, *, no_optional: bool = False, json: bool) -> set[str]:
@@ -173,8 +172,6 @@ class UnionProperty(PropertyProtocol):
         self,
         no_optional: bool = False,
         json: bool = False,
-        *,
-        quoted: bool = False,
     ) -> str:
         """
         Get a string representation of type that should be used when declaring this property.
@@ -195,7 +192,7 @@ class UnionProperty(PropertyProtocol):
         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")
+        imports.add("from typing import cast")
         return imports
 
     def get_lazy_imports(self, *, prefix: str) -> set[str]:

openapi_python_client/parser/responses.py

@@ -1,7 +1,7 @@
 __all__ = ["HTTPStatusPattern", "Response", "Responses", "response_from_data"]
 
 from collections.abc import Iterator
-from typing import Optional, TypedDict, Union
+from typing import TypedDict
 
 from attrs import define
 
@@ -18,7 +18,7 @@ from .properties import AnyProperty, Property, Schemas, property_from_data
 @define
 class Responses:
     patterns: list["Response"]
-    default: Optional["Response"]
+    default: "Response | None"
 
     def __iter__(self) -> Iterator["Response"]:
         yield from self.patterns
@@ -52,15 +52,15 @@ class HTTPStatusPattern:
     """
 
     pattern: str
-    range: Optional[tuple[int, int]]
+    range: tuple[int, int] | None
 
-    def __init__(self, *, pattern: str, code_range: Optional[tuple[int, int]]):
+    def __init__(self, *, pattern: str, code_range: tuple[int, int] | None):
         """Initialize with a range of status codes or None for the default case."""
         self.pattern = pattern
         self.range = code_range
 
     @staticmethod
-    def parse(pattern: str) -> Union["HTTPStatusPattern", ParseError]:
+    def parse(pattern: str) -> "HTTPStatusPattern | ParseError":
         """Parse a status code pattern such as 2XX or 404"""
         if pattern == "default":
             return HTTPStatusPattern(pattern=pattern, code_range=None)
@@ -118,7 +118,7 @@ class Response:
     status_code: HTTPStatusPattern
     prop: Property
     source: _ResponseSource
-    data: Union[oai.Response, oai.Reference]  # Original data which created this response, useful for custom templates
+    data: oai.Response | oai.Reference  # Original data which created this response, useful for custom templates
 
     def is_default(self) -> bool:
         return self.status_code.range is None
@@ -128,7 +128,7 @@ class Response:
         return self.status_code < other.status_code
 
 
-def _source_by_content_type(content_type: str, config: Config) -> Optional[_ResponseSource]:
+def _source_by_content_type(content_type: str, config: Config) -> _ResponseSource | None:
     parsed_content_type = utils.get_content_type(content_type, config)
     if parsed_content_type is None:
         return None
@@ -152,7 +152,7 @@ def empty_response(
     status_code: HTTPStatusPattern,
     response_name: str,
     config: Config,
-    data: Union[oai.Response, oai.Reference],
+    data: oai.Response | oai.Reference,
 ) -> Response:
     """Return an untyped response, for when no response type is defined"""
     return Response(
@@ -173,12 +173,12 @@ def empty_response(
 def response_from_data(  # noqa: PLR0911
     *,
     status_code: HTTPStatusPattern,
-    data: Union[oai.Response, oai.Reference],
+    data: oai.Response | oai.Reference,
     schemas: Schemas,
-    responses: dict[str, Union[oai.Response, oai.Reference]],
+    responses: dict[str, oai.Response | oai.Reference],
     parent_name: str,
     config: Config,
-) -> tuple[Union[Response, ParseError], Schemas]:
+) -> tuple[Response | ParseError, Schemas]:
     """Generate a Response from the OpenAPI dictionary representation of it"""
 
     response_name = f"response_{status_code.pattern}"

openapi_python_client/schema/openapi_schema_pydantic/components.py

@@ -1,5 +1,3 @@
-from typing import Optional
-
 from pydantic import BaseModel, ConfigDict
 
 from .callback import Callback
@@ -25,15 +23,15 @@ class Components(BaseModel):
         - https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#componentsObject
     """
 
-    schemas: Optional[dict[str, ReferenceOr[Schema]]] = None
-    responses: Optional[dict[str, ReferenceOr[Response]]] = None
-    parameters: Optional[dict[str, ReferenceOr[Parameter]]] = None
-    examples: Optional[dict[str, ReferenceOr[Example]]] = None
-    requestBodies: Optional[dict[str, ReferenceOr[RequestBody]]] = None
-    headers: Optional[dict[str, ReferenceOr[Header]]] = None
-    securitySchemes: Optional[dict[str, ReferenceOr[SecurityScheme]]] = None
-    links: Optional[dict[str, ReferenceOr[Link]]] = None
-    callbacks: Optional[dict[str, ReferenceOr[Callback]]] = None
+    schemas: dict[str, ReferenceOr[Schema]] | None = None
+    responses: dict[str, ReferenceOr[Response]] | None = None
+    parameters: dict[str, ReferenceOr[Parameter]] | None = None
+    examples: dict[str, ReferenceOr[Example]] | None = None
+    requestBodies: dict[str, ReferenceOr[RequestBody]] | None = None
+    headers: dict[str, ReferenceOr[Header]] | None = None
+    securitySchemes: dict[str, ReferenceOr[SecurityScheme]] | None = None
+    links: dict[str, ReferenceOr[Link]] | None = None
+    callbacks: dict[str, ReferenceOr[Callback]] | None = None
     model_config = ConfigDict(
         # `Callback` contains an unresolvable forward reference, will rebuild in `__init__.py`:
         defer_build=True,

openapi_python_client/schema/openapi_schema_pydantic/contact.py

@@ -1,5 +1,3 @@
-from typing import Optional
-
 from pydantic import BaseModel, ConfigDict
 
 
@@ -11,9 +9,9 @@ class Contact(BaseModel):
         - https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#contactObject
     """
 
-    name: Optional[str] = None
-    url: Optional[str] = None
-    email: Optional[str] = None
+    name: str | None = None
+    url: str | None = None
+    email: str | None = None
     model_config = ConfigDict(
         extra="allow",
         json_schema_extra={

openapi_python_client/schema/openapi_schema_pydantic/discriminator.py

@@ -1,5 +1,3 @@
-from typing import Optional
-
 from pydantic import BaseModel, ConfigDict
 
 
@@ -19,7 +17,7 @@ class Discriminator(BaseModel):
     """
 
     propertyName: str
-    mapping: Optional[dict[str, str]] = None
+    mapping: dict[str, str] | None = None
     model_config = ConfigDict(
         extra="allow",
         json_schema_extra={

openapi_python_client/schema/openapi_schema_pydantic/encoding.py

@@ -1,4 +1,4 @@
-from typing import TYPE_CHECKING, Optional
+from typing import TYPE_CHECKING
 
 from pydantic import BaseModel, ConfigDict
 
@@ -16,9 +16,9 @@ class Encoding(BaseModel):
         - https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#encodingObject
     """
 
-    contentType: Optional[str] = None
-    headers: Optional[dict[str, ReferenceOr["Header"]]] = None
-    style: Optional[str] = None
+    contentType: str | None = None
+    headers: dict[str, ReferenceOr["Header"]] | None = None
+    style: str | None = None
     explode: bool = False
     allowReserved: bool = False
     model_config = ConfigDict(

openapi_python_client/schema/openapi_schema_pydantic/example.py

@@ -1,4 +1,4 @@
-from typing import Any, Optional
+from typing import Any
 
 from pydantic import BaseModel, ConfigDict
 
@@ -11,10 +11,10 @@ class Example(BaseModel):
         - https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#exampleObject
     """
 
-    summary: Optional[str] = None
-    description: Optional[str] = None
-    value: Optional[Any] = None
-    externalValue: Optional[str] = None
+    summary: str | None = None
+    description: str | None = None
+    value: Any | None = None
+    externalValue: str | None = None
     model_config = ConfigDict(
         extra="allow",
         json_schema_extra={

openapi_python_client/schema/openapi_schema_pydantic/external_documentation.py

@@ -1,5 +1,3 @@
-from typing import Optional
-
 from pydantic import BaseModel, ConfigDict
 
 
@@ -10,7 +8,7 @@ class ExternalDocumentation(BaseModel):
         - https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#externalDocumentationObject
     """
 
-    description: Optional[str] = None
+    description: str | None = None
     url: str
     model_config = ConfigDict(
         extra="allow",

openapi_python_client/schema/openapi_schema_pydantic/info.py

@@ -1,5 +1,3 @@
-from typing import Optional
-
 from pydantic import BaseModel, ConfigDict
 
 from .contact import Contact
@@ -18,10 +16,10 @@ class Info(BaseModel):
     """
 
     title: str
-    description: Optional[str] = None
-    termsOfService: Optional[str] = None
-    contact: Optional[Contact] = None
-    license: Optional[License] = None
+    description: str | None = None
+    termsOfService: str | None = None
+    contact: Contact | None = None
+    license: License | None = None
     version: str
     model_config = ConfigDict(
         extra="allow",

openapi_python_client/schema/openapi_schema_pydantic/license.py

@@ -1,5 +1,3 @@
-from typing import Optional
-
 from pydantic import BaseModel, ConfigDict
 
 
@@ -12,7 +10,7 @@ class License(BaseModel):
     """
 
     name: str
-    url: Optional[str] = None
+    url: str | None = None
     model_config = ConfigDict(
         extra="allow",
         json_schema_extra={

openapi_python_client/schema/openapi_schema_pydantic/link.py

@@ -1,4 +1,4 @@
-from typing import Any, Optional
+from typing import Any
 
 from pydantic import BaseModel, ConfigDict
 
@@ -23,12 +23,12 @@ class Link(BaseModel):
         - https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.3.md#linkObject
     """
 
-    operationRef: Optional[str] = None
-    operationId: Optional[str] = None
-    parameters: Optional[dict[str, Any]] = None
-    requestBody: Optional[Any] = None
-    description: Optional[str] = None
-    server: Optional[Server] = None
+    operationRef: str | None = None
+    operationId: str | None = None
+    parameters: dict[str, Any] | None = None
+    requestBody: Any | None = None
+    description: str | None = None
+    server: Server | None = None
     model_config = ConfigDict(
         extra="allow",
         json_schema_extra={

openapi_python_client/schema/openapi_schema_pydantic/media_type.py

@@ -1,4 +1,4 @@
-from typing import Any, Optional
+from typing import Any
 
 from pydantic import BaseModel, ConfigDict, Field
 
@@ -16,10 +16,10 @@ class MediaType(BaseModel):
         - https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#mediaTypeObject
     """
 
-    media_type_schema: Optional[ReferenceOr[Schema]] = Field(default=None, alias="schema")
-    example: Optional[Any] = None
-    examples: Optional[dict[str, ReferenceOr[Example]]] = None
-    encoding: Optional[dict[str, Encoding]] = None
+    media_type_schema: ReferenceOr[Schema] | None = Field(default=None, alias="schema")
+    example: Any | None = None
+    examples: dict[str, ReferenceOr[Example]] | None = None
+    encoding: dict[str, Encoding] | None = None
     model_config = ConfigDict(
         # `Encoding` is not build yet, will rebuild in `__init__.py`:
         defer_build=True,

openapi_python_client/schema/openapi_schema_pydantic/oauth_flow.py

@@ -1,5 +1,3 @@
-from typing import Optional
-
 from pydantic import BaseModel, ConfigDict
 
 
@@ -12,9 +10,9 @@ class OAuthFlow(BaseModel):
         - https://swagger.io/docs/specification/authentication/oauth2/
     """
 
-    authorizationUrl: Optional[str] = None
-    tokenUrl: Optional[str] = None
-    refreshUrl: Optional[str] = None
+    authorizationUrl: str | None = None
+    tokenUrl: str | None = None
+    refreshUrl: str | None = None
     scopes: dict[str, str]
     model_config = ConfigDict(
         extra="allow",

openapi_python_client/schema/openapi_schema_pydantic/oauth_flows.py

@@ -1,5 +1,3 @@
-from typing import Optional
-
 from pydantic import BaseModel, ConfigDict
 
 from .oauth_flow import OAuthFlow
@@ -14,8 +12,8 @@ class OAuthFlows(BaseModel):
         - https://swagger.io/docs/specification/authentication/oauth2/
     """
 
-    implicit: Optional[OAuthFlow] = None
-    password: Optional[OAuthFlow] = None
-    clientCredentials: Optional[OAuthFlow] = None
-    authorizationCode: Optional[OAuthFlow] = None
+    implicit: OAuthFlow | None = None
+    password: OAuthFlow | None = None
+    clientCredentials: OAuthFlow | None = None
+    authorizationCode: OAuthFlow | None = None
     model_config = ConfigDict(extra="allow")

openapi_python_client/schema/openapi_schema_pydantic/open_api.py

@@ -1,5 +1,3 @@
-from typing import Optional
-
 from pydantic import BaseModel, ConfigDict, field_validator
 
 from .components import Components
@@ -24,10 +22,10 @@ class OpenAPI(BaseModel):
     info: Info
     servers: list[Server] = [Server(url="/")]
     paths: Paths
-    components: Optional[Components] = None
-    security: Optional[list[SecurityRequirement]] = None
-    tags: Optional[list[Tag]] = None
-    externalDocs: Optional[ExternalDocumentation] = None
+    components: Components | None = None
+    security: list[SecurityRequirement] | None = None
+    tags: list[Tag] | None = None
+    externalDocs: ExternalDocumentation | None = None
     openapi: str
     model_config = ConfigDict(
         # `Components` is not build yet, will rebuild in `__init__.py`:

openapi_python_client/schema/openapi_schema_pydantic/operation.py

@@ -1,5 +1,3 @@
-from typing import Optional
-
 from pydantic import BaseModel, ConfigDict, Field
 
 from .callback import Callback
@@ -20,19 +18,19 @@ class Operation(BaseModel):
         - https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#operationObject
     """
 
-    tags: Optional[list[str]] = None
-    summary: Optional[str] = None
-    description: Optional[str] = None
-    externalDocs: Optional[ExternalDocumentation] = None
-    operationId: Optional[str] = None
-    parameters: Optional[list[ReferenceOr[Parameter]]] = None
-    request_body: Optional[ReferenceOr[RequestBody]] = Field(None, alias="requestBody")
+    tags: list[str] | None = None
+    summary: str | None = None
+    description: str | None = None
+    externalDocs: ExternalDocumentation | None = None
+    operationId: str | None = None
+    parameters: list[ReferenceOr[Parameter]] | None = None
+    request_body: ReferenceOr[RequestBody] | None = Field(None, alias="requestBody")
     responses: Responses
-    callbacks: Optional[dict[str, Callback]] = None
+    callbacks: dict[str, Callback] | None = None
 
     deprecated: bool = False
-    security: Optional[list[SecurityRequirement]] = None
-    servers: Optional[list[Server]] = None
+    security: list[SecurityRequirement] | None = None
+    servers: list[Server] | None = None
     model_config = ConfigDict(
         # `Callback` contains an unresolvable forward reference, will rebuild in `__init__.py`:
         defer_build=True,