diff options
Diffstat (limited to 'venv/lib/python3.11/site-packages/litestar/openapi')
74 files changed, 0 insertions, 3093 deletions
diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/__init__.py b/venv/lib/python3.11/site-packages/litestar/openapi/__init__.py deleted file mode 100644 index 8cc83d3..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/__init__.py +++ /dev/null @@ -1,5 +0,0 @@ -from .config import OpenAPIConfig -from .controller import OpenAPIController -from .datastructures import ResponseSpec - -__all__ = ("OpenAPIController", "OpenAPIConfig", "ResponseSpec") diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/__pycache__/__init__.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/__pycache__/__init__.cpython-311.pyc Binary files differdeleted file mode 100644 index 510eb6f..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/__pycache__/__init__.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/__pycache__/config.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/__pycache__/config.cpython-311.pyc Binary files differdeleted file mode 100644 index 16411a1..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/__pycache__/config.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/__pycache__/controller.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/__pycache__/controller.cpython-311.pyc Binary files differdeleted file mode 100644 index f153bae..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/__pycache__/controller.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/__pycache__/datastructures.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/__pycache__/datastructures.cpython-311.pyc Binary files differdeleted file mode 100644 index 042a57f..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/__pycache__/datastructures.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/config.py b/venv/lib/python3.11/site-packages/litestar/openapi/config.py deleted file mode 100644 index c935693..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/config.py +++ /dev/null @@ -1,153 +0,0 @@ -from __future__ import annotations - -from copy import deepcopy -from dataclasses import dataclass, field, fields -from typing import TYPE_CHECKING, Literal - -from litestar._openapi.utils import default_operation_id_creator -from litestar.openapi.controller import OpenAPIController -from litestar.openapi.spec import ( - Components, - Contact, - ExternalDocumentation, - Info, - License, - OpenAPI, - PathItem, - Reference, - SecurityRequirement, - Server, - Tag, -) -from litestar.utils.path import normalize_path - -__all__ = ("OpenAPIConfig",) - - -if TYPE_CHECKING: - from litestar.types.callable_types import OperationIDCreator - - -@dataclass -class OpenAPIConfig: - """Configuration for OpenAPI. - - To enable OpenAPI schema generation and serving, pass an instance of this class to the - :class:`Litestar <.app.Litestar>` constructor using the ``openapi_config`` kwargs. - """ - - title: str - """Title of API documentation.""" - version: str - """API version, e.g. '1.0.0'.""" - - create_examples: bool = field(default=False) - """Generate examples using the polyfactory library.""" - random_seed: int = 10 - """The random seed used when creating the examples to ensure deterministic generation of examples.""" - openapi_controller: type[OpenAPIController] = field(default_factory=lambda: OpenAPIController) - """Controller for generating OpenAPI routes. - - Must be subclass of :class:`OpenAPIController <litestar.openapi.controller.OpenAPIController>`. - """ - contact: Contact | None = field(default=None) - """API contact information, should be an :class:`Contact <litestar.openapi.spec.contact.Contact>` instance.""" - description: str | None = field(default=None) - """API description.""" - external_docs: ExternalDocumentation | None = field(default=None) - """Links to external documentation. - - Should be an instance of :class:`ExternalDocumentation <litestar.openapi.spec.external_documentation.ExternalDocumentation>`. - """ - license: License | None = field(default=None) - """API Licensing information. - - Should be an instance of :class:`License <litestar.openapi.spec.license.License>`. - """ - security: list[SecurityRequirement] | None = field(default=None) - """API Security requirements information. - - Should be an instance of - :data:`SecurityRequirement <.openapi.spec.SecurityRequirement>`. - """ - components: Components | list[Components] = field(default_factory=Components) - """API Components information. - - Should be an instance of :class:`Components <litestar.openapi.spec.components.Components>` or a list thereof. - """ - servers: list[Server] = field(default_factory=lambda: [Server(url="/")]) - """A list of :class:`Server <litestar.openapi.spec.server.Server>` instances.""" - summary: str | None = field(default=None) - """A summary text.""" - tags: list[Tag] | None = field(default=None) - """A list of :class:`Tag <litestar.openapi.spec.tag.Tag>` instances.""" - terms_of_service: str | None = field(default=None) - """URL to page that contains terms of service.""" - use_handler_docstrings: bool = field(default=False) - """Draw operation description from route handler docstring if not otherwise provided.""" - webhooks: dict[str, PathItem | Reference] | None = field(default=None) - """A mapping of key to either :class:`PathItem <litestar.openapi.spec.path_item.PathItem>` or. - - :class:`Reference <litestar.openapi.spec.reference.Reference>` objects. - """ - root_schema_site: Literal["redoc", "swagger", "elements", "rapidoc"] = "redoc" - """The static schema generator to use for the "root" path of `/schema/`.""" - enabled_endpoints: set[str] = field( - default_factory=lambda: { - "redoc", - "swagger", - "elements", - "rapidoc", - "openapi.json", - "openapi.yaml", - "openapi.yml", - "oauth2-redirect.html", - } - ) - """A set of the enabled documentation sites and schema download endpoints.""" - operation_id_creator: OperationIDCreator = default_operation_id_creator - """A callable that generates unique operation ids""" - path: str | None = field(default=None) - """Base path for the OpenAPI documentation endpoints.""" - - def __post_init__(self) -> None: - if self.path: - self.path = normalize_path(self.path) - self.openapi_controller = type("OpenAPIController", (self.openapi_controller,), {"path": self.path}) - - def to_openapi_schema(self) -> OpenAPI: - """Return an ``OpenAPI`` instance from the values stored in ``self``. - - Returns: - An instance of :class:`OpenAPI <litestar.openapi.spec.open_api.OpenAPI>`. - """ - - if isinstance(self.components, list): - merged_components = Components() - for components in self.components: - for key in (f.name for f in fields(components)): - if value := getattr(components, key, None): - merged_value_dict = getattr(merged_components, key, {}) or {} - merged_value_dict.update(value) - setattr(merged_components, key, merged_value_dict) - - self.components = merged_components - - return OpenAPI( - external_docs=self.external_docs, - security=self.security, - components=deepcopy(self.components), # deepcopy prevents mutation of the config's components - servers=self.servers, - tags=self.tags, - webhooks=self.webhooks, - info=Info( - title=self.title, - version=self.version, - description=self.description, - contact=self.contact, - license=self.license, - summary=self.summary, - terms_of_service=self.terms_of_service, - ), - paths={}, - ) diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/controller.py b/venv/lib/python3.11/site-packages/litestar/openapi/controller.py deleted file mode 100644 index ac03d4c..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/controller.py +++ /dev/null @@ -1,604 +0,0 @@ -from __future__ import annotations - -from functools import cached_property -from typing import TYPE_CHECKING, Any, Callable, Final, Literal - -from yaml import dump as dump_yaml - -from litestar.constants import OPENAPI_NOT_INITIALIZED -from litestar.controller import Controller -from litestar.enums import MediaType, OpenAPIMediaType -from litestar.exceptions import ImproperlyConfiguredException -from litestar.handlers import get -from litestar.response.base import ASGIResponse -from litestar.serialization import encode_json -from litestar.serialization.msgspec_hooks import decode_json -from litestar.status_codes import HTTP_404_NOT_FOUND - -__all__ = ("OpenAPIController",) - - -if TYPE_CHECKING: - from litestar.connection.request import Request - from litestar.openapi.spec.open_api import OpenAPI - -_OPENAPI_JSON_ROUTER_NAME: Final = "__litestar_openapi_json" - - -class OpenAPIController(Controller): - """Controller for OpenAPI endpoints.""" - - path: str = "/schema" - """Base path for the OpenAPI documentation endpoints.""" - style: str = "body { margin: 0; padding: 0 }" - """Base styling of the html body.""" - redoc_version: str = "next" - """Redoc version to download from the CDN.""" - swagger_ui_version: str = "5.1.3" - """SwaggerUI version to download from the CDN.""" - stoplight_elements_version: str = "7.7.18" - """StopLight Elements version to download from the CDN.""" - rapidoc_version: str = "9.3.4" - """RapiDoc version to download from the CDN.""" - favicon_url: str = "" - """URL to download a favicon from.""" - redoc_google_fonts: bool = True - """Download google fonts via CDN. - - Should be set to ``False`` when not using a CDN. - """ - redoc_js_url: str = f"https://cdn.jsdelivr.net/npm/redoc@{redoc_version}/bundles/redoc.standalone.js" - """Download url for the Redoc JS bundle.""" - swagger_css_url: str = f"https://cdn.jsdelivr.net/npm/swagger-ui-dist@{swagger_ui_version}/swagger-ui.css" - """Download url for the Swagger UI CSS bundle.""" - swagger_ui_bundle_js_url: str = ( - f"https://cdn.jsdelivr.net/npm/swagger-ui-dist@{swagger_ui_version}/swagger-ui-bundle.js" - ) - """Download url for the Swagger UI JS bundle.""" - swagger_ui_standalone_preset_js_url: str = ( - f"https://cdn.jsdelivr.net/npm/swagger-ui-dist@{swagger_ui_version}/swagger-ui-standalone-preset.js" - ) - """Download url for the Swagger Standalone Preset JS bundle.""" - swagger_ui_init_oauth: dict[Any, Any] | bytes = {} - """ - JSON to initialize Swagger UI OAuth2 by calling the `initOAuth` method. - - Refer to the following URL for details: - `Swagger-UI <https://swagger.io/docs/open-source-tools/swagger-ui/usage/oauth2/>`_. - """ - stoplight_elements_css_url: str = ( - f"https://unpkg.com/@stoplight/elements@{stoplight_elements_version}/styles.min.css" - ) - """Download url for the Stoplight Elements CSS bundle.""" - stoplight_elements_js_url: str = ( - f"https://unpkg.com/@stoplight/elements@{stoplight_elements_version}/web-components.min.js" - ) - """Download url for the Stoplight Elements JS bundle.""" - rapidoc_js_url: str = f"https://unpkg.com/rapidoc@{rapidoc_version}/dist/rapidoc-min.js" - """Download url for the RapiDoc JS bundle.""" - - # internal - _dumped_json_schema: str = "" - _dumped_yaml_schema: bytes = b"" - # until swagger-ui supports v3.1.* of OpenAPI officially, we need to modify the schema for it and keep it - # separate from the redoc version of the schema, which is unmodified. - dto = None - return_dto = None - - @staticmethod - def get_schema_from_request(request: Request[Any, Any, Any]) -> OpenAPI: - """Return the OpenAPI pydantic model from the request instance. - - Args: - request: A :class:`Litestar <.connection.Request>` instance. - - Returns: - An :class:`OpenAPI <litestar.openapi.spec.open_api.OpenAPI>` instance. - """ - return request.app.openapi_schema - - def should_serve_endpoint(self, request: Request[Any, Any, Any]) -> bool: - """Verify that the requested path is within the enabled endpoints in the openapi_config. - - Args: - request: To be tested if endpoint enabled. - - Returns: - A boolean. - - Raises: - ImproperlyConfiguredException: If the application ``openapi_config`` attribute is ``None``. - """ - if not request.app.openapi_config: # pragma: no cover - raise ImproperlyConfiguredException("Litestar has not been instantiated with an OpenAPIConfig") - - asgi_root_path = set(filter(None, request.scope.get("root_path", "").split("/"))) - full_request_path = set(filter(None, request.url.path.split("/"))) - request_path = full_request_path.difference(asgi_root_path) - root_path = set(filter(None, self.path.split("/"))) - - config = request.app.openapi_config - - if request_path == root_path and config.root_schema_site in config.enabled_endpoints: - return True - - return bool(request_path & config.enabled_endpoints) - - @property - def favicon(self) -> str: - """Return favicon ``<link>`` tag, if applicable. - - Returns: - A ``<link>`` tag if ``self.favicon_url`` is not empty, otherwise returns a placeholder meta tag. - """ - return f"<link rel='icon' type='image/x-icon' href='{self.favicon_url}'>" if self.favicon_url else "<meta/>" - - @cached_property - def render_methods_map( - self, - ) -> dict[Literal["redoc", "swagger", "elements", "rapidoc"], Callable[[Request], bytes]]: - """Map render method names to render methods. - - Returns: - A mapping of string keys to render methods. - """ - return { - "redoc": self.render_redoc, - "swagger": self.render_swagger_ui, - "elements": self.render_stoplight_elements, - "rapidoc": self.render_rapidoc, - } - - @get( - path=["/openapi.yaml", "openapi.yml"], - media_type=OpenAPIMediaType.OPENAPI_YAML, - include_in_schema=False, - sync_to_thread=False, - ) - def retrieve_schema_yaml(self, request: Request[Any, Any, Any]) -> ASGIResponse: - """Return the OpenAPI schema as YAML with an ``application/vnd.oai.openapi`` Content-Type header. - - Args: - request: - A :class:`Request <.connection.Request>` instance. - - Returns: - A Response instance with the YAML object rendered into a string. - """ - if self.should_serve_endpoint(request): - if not self._dumped_json_schema: - schema_json = decode_json(self._get_schema_as_json(request)) - schema_yaml = dump_yaml(schema_json, default_flow_style=False) - self._dumped_yaml_schema = schema_yaml.encode("utf-8") - return ASGIResponse(body=self._dumped_yaml_schema, media_type=OpenAPIMediaType.OPENAPI_YAML) - return ASGIResponse(body=b"", status_code=HTTP_404_NOT_FOUND, media_type=MediaType.HTML) - - @get( - path="/openapi.json", - media_type=OpenAPIMediaType.OPENAPI_JSON, - include_in_schema=False, - sync_to_thread=False, - name=_OPENAPI_JSON_ROUTER_NAME, - ) - def retrieve_schema_json(self, request: Request[Any, Any, Any]) -> ASGIResponse: - """Return the OpenAPI schema as JSON with an ``application/vnd.oai.openapi+json`` Content-Type header. - - Args: - request: - A :class:`Request <.connection.Request>` instance. - - Returns: - A Response instance with the JSON object rendered into a string. - """ - if self.should_serve_endpoint(request): - return ASGIResponse( - body=self._get_schema_as_json(request), - media_type=OpenAPIMediaType.OPENAPI_JSON, - ) - return ASGIResponse(body=b"", status_code=HTTP_404_NOT_FOUND, media_type=MediaType.HTML) - - @get(path="/", include_in_schema=False, sync_to_thread=False) - def root(self, request: Request[Any, Any, Any]) -> ASGIResponse: - """Render a static documentation site. - - The site to be rendered is based on the ``root_schema_site`` value set in the application's - :class:`OpenAPIConfig <.openapi.OpenAPIConfig>`. Defaults to ``redoc``. - - Args: - request: - A :class:`Request <.connection.Request>` instance. - - Returns: - A response with the rendered site defined in root_schema_site. - - Raises: - ImproperlyConfiguredException: If the application ``openapi_config`` attribute is ``None``. - """ - config = request.app.openapi_config - if not config: # pragma: no cover - raise ImproperlyConfiguredException(OPENAPI_NOT_INITIALIZED) - - render_method = self.render_methods_map[config.root_schema_site] - - if self.should_serve_endpoint(request): - return ASGIResponse(body=render_method(request), media_type=MediaType.HTML) - return ASGIResponse(body=self.render_404_page(), status_code=HTTP_404_NOT_FOUND, media_type=MediaType.HTML) - - @get(path="/swagger", include_in_schema=False, sync_to_thread=False) - def swagger_ui(self, request: Request[Any, Any, Any]) -> ASGIResponse: - """Route handler responsible for rendering Swagger-UI. - - Args: - request: - A :class:`Request <.connection.Request>` instance. - - Returns: - A response with a rendered swagger documentation site - """ - if self.should_serve_endpoint(request): - return ASGIResponse(body=self.render_swagger_ui(request), media_type=MediaType.HTML) - return ASGIResponse(body=self.render_404_page(), status_code=HTTP_404_NOT_FOUND, media_type=MediaType.HTML) - - @get(path="/elements", media_type=MediaType.HTML, include_in_schema=False, sync_to_thread=False) - def stoplight_elements(self, request: Request[Any, Any, Any]) -> ASGIResponse: - """Route handler responsible for rendering StopLight Elements. - - Args: - request: - A :class:`Request <.connection.Request>` instance. - - Returns: - A response with a rendered stoplight elements documentation site - """ - if self.should_serve_endpoint(request): - return ASGIResponse(body=self.render_stoplight_elements(request), media_type=MediaType.HTML) - return ASGIResponse(body=self.render_404_page(), status_code=HTTP_404_NOT_FOUND, media_type=MediaType.HTML) - - @get(path="/redoc", media_type=MediaType.HTML, include_in_schema=False, sync_to_thread=False) - def redoc(self, request: Request[Any, Any, Any]) -> ASGIResponse: # pragma: no cover - """Route handler responsible for rendering Redoc. - - Args: - request: - A :class:`Request <.connection.Request>` instance. - - Returns: - A response with a rendered redoc documentation site - """ - if self.should_serve_endpoint(request): - return ASGIResponse(body=self.render_redoc(request), media_type=MediaType.HTML) - return ASGIResponse(body=self.render_404_page(), status_code=HTTP_404_NOT_FOUND, media_type=MediaType.HTML) - - @get(path="/rapidoc", media_type=MediaType.HTML, include_in_schema=False, sync_to_thread=False) - def rapidoc(self, request: Request[Any, Any, Any]) -> ASGIResponse: - if self.should_serve_endpoint(request): - return ASGIResponse(body=self.render_rapidoc(request), media_type=MediaType.HTML) - return ASGIResponse(body=self.render_404_page(), status_code=HTTP_404_NOT_FOUND, media_type=MediaType.HTML) - - @get(path="/oauth2-redirect.html", media_type=MediaType.HTML, include_in_schema=False, sync_to_thread=False) - def swagger_ui_oauth2_redirect(self, request: Request[Any, Any, Any]) -> ASGIResponse: # pragma: no cover - """Route handler responsible for rendering oauth2-redirect.html page for Swagger-UI. - - Args: - request: - A :class:`Request <.connection.Request>` instance. - - Returns: - A response with a rendered oauth2-redirect.html page for Swagger-UI. - """ - if self.should_serve_endpoint(request): - return ASGIResponse(body=self.render_swagger_ui_oauth2_redirect(request), media_type=MediaType.HTML) - return ASGIResponse(body=self.render_404_page(), status_code=HTTP_404_NOT_FOUND, media_type=MediaType.HTML) - - def render_swagger_ui_oauth2_redirect(self, request: Request[Any, Any, Any]) -> bytes: - """Render an HTML oauth2-redirect.html page for Swagger-UI. - - Notes: - - override this method to customize the template. - - Args: - request: - A :class:`Request <.connection.Request>` instance. - - Returns: - A rendered html string. - """ - return rb"""<!doctype html> - <html lang="en-US"> - <head> - <title>Swagger UI: OAuth2 Redirect</title> - </head> - <body> - <script> - 'use strict'; - function run () { - var oauth2 = window.opener.swaggerUIRedirectOauth2; - var sentState = oauth2.state; - var redirectUrl = oauth2.redirectUrl; - var isValid, qp, arr; - - if (/code|token|error/.test(window.location.hash)) { - qp = window.location.hash.substring(1).replace('?', '&'); - } else { - qp = location.search.substring(1); - } - - arr = qp.split("&"); - arr.forEach(function (v,i,_arr) { _arr[i] = '"' + v.replace('=', '":"') + '"';}); - qp = qp ? JSON.parse('{' + arr.join() + '}', - function (key, value) { - return key === "" ? value : decodeURIComponent(value); - } - ) : {}; - - isValid = qp.state === sentState; - - if (( - oauth2.auth.schema.get("flow") === "accessCode" || - oauth2.auth.schema.get("flow") === "authorizationCode" || - oauth2.auth.schema.get("flow") === "authorization_code" - ) && !oauth2.auth.code) { - if (!isValid) { - oauth2.errCb({ - authId: oauth2.auth.name, - source: "auth", - level: "warning", - message: "Authorization may be unsafe, passed state was changed in server. The passed state wasn't returned from auth server." - }); - } - - if (qp.code) { - delete oauth2.state; - oauth2.auth.code = qp.code; - oauth2.callback({auth: oauth2.auth, redirectUrl: redirectUrl}); - } else { - let oauthErrorMsg; - if (qp.error) { - oauthErrorMsg = "["+qp.error+"]: " + - (qp.error_description ? qp.error_description+ ". " : "no accessCode received from the server. ") + - (qp.error_uri ? "More info: "+qp.error_uri : ""); - } - - oauth2.errCb({ - authId: oauth2.auth.name, - source: "auth", - level: "error", - message: oauthErrorMsg || "[Authorization failed]: no accessCode received from the server." - }); - } - } else { - oauth2.callback({auth: oauth2.auth, token: qp, isValid: isValid, redirectUrl: redirectUrl}); - } - window.close(); - } - - if (document.readyState !== 'loading') { - run(); - } else { - document.addEventListener('DOMContentLoaded', function () { - run(); - }); - } - </script> - </body> - </html>""" - - def render_swagger_ui(self, request: Request[Any, Any, Any]) -> bytes: - """Render an HTML page for Swagger-UI. - - Notes: - - override this method to customize the template. - - Args: - request: - A :class:`Request <.connection.Request>` instance. - - Returns: - A rendered html string. - """ - schema = self.get_schema_from_request(request) - - head = f""" - <head> - <title>{schema.info.title}</title> - {self.favicon} - <meta charset="utf-8"/> - <meta name="viewport" content="width=device-width, initial-scale=1"> - <link href="{self.swagger_css_url}" rel="stylesheet"> - <script src="{self.swagger_ui_bundle_js_url}" crossorigin></script> - <script src="{self.swagger_ui_standalone_preset_js_url}" crossorigin></script> - <style>{self.style}</style> - </head> - """ - - body = f""" - <body> - <div id='swagger-container'/> - <script type="text/javascript"> - const ui = SwaggerUIBundle({{ - spec: {self._get_schema_as_json(request)}, - dom_id: '#swagger-container', - deepLinking: true, - showExtensions: true, - showCommonExtensions: true, - presets: [ - SwaggerUIBundle.presets.apis, - SwaggerUIBundle.SwaggerUIStandalonePreset - ], - }}) - ui.initOAuth({encode_json(self.swagger_ui_init_oauth).decode('utf-8')}) - </script> - </body> - """ - - return f""" - <!DOCTYPE html> - <html> - {head} - {body} - </html> - """.encode() - - def render_stoplight_elements(self, request: Request[Any, Any, Any]) -> bytes: - """Render an HTML page for StopLight Elements. - - Notes: - - override this method to customize the template. - - Args: - request: - A :class:`Request <.connection.Request>` instance. - - Returns: - A rendered html string. - """ - schema = self.get_schema_from_request(request) - head = f""" - <head> - <title>{schema.info.title}</title> - {self.favicon} - <meta charset="utf-8"/> - <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> - <link rel="stylesheet" href="{self.stoplight_elements_css_url}"> - <script src="{self.stoplight_elements_js_url}" crossorigin></script> - <style>{self.style}</style> - </head> - """ - - body = f""" - <body> - <elements-api - apiDescriptionUrl="{request.app.route_reverse(_OPENAPI_JSON_ROUTER_NAME)}" - router="hash" - layout="sidebar" - /> - </body> - """ - - return f""" - <!DOCTYPE html> - <html> - {head} - {body} - </html> - """.encode() - - def render_rapidoc(self, request: Request[Any, Any, Any]) -> bytes: # pragma: no cover - schema = self.get_schema_from_request(request) - - head = f""" - <head> - <title>{schema.info.title}</title> - {self.favicon} - <meta charset="utf-8"/> - <meta name="viewport" content="width=device-width, initial-scale=1"> - <script src="{self.rapidoc_js_url}" crossorigin></script> - <style>{self.style}</style> - </head> - """ - - body = f""" - <body> - <rapi-doc spec-url="{request.app.route_reverse(_OPENAPI_JSON_ROUTER_NAME)}" /> - </body> - """ - - return f""" - <!DOCTYPE html> - <html> - {head} - {body} - </html> - """.encode() - - def render_redoc(self, request: Request[Any, Any, Any]) -> bytes: # pragma: no cover - """Render an HTML page for Redoc. - - Notes: - - override this method to customize the template. - - Args: - request: - A :class:`Request <.connection.Request>` instance. - - Returns: - A rendered html string. - """ - schema = self.get_schema_from_request(request) - - head = f""" - <head> - <title>{schema.info.title}</title> - {self.favicon} - <meta charset="utf-8"/> - <meta name="viewport" content="width=device-width, initial-scale=1"> - """ - - if self.redoc_google_fonts: - head += """ - <link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet"> - """ - - head += f""" - <script src="{self.redoc_js_url}" crossorigin></script> - <style> - {self.style} - </style> - </head> - """ - - body = f""" - <body> - <div id='redoc-container'/> - <script type="text/javascript"> - Redoc.init( - {self._get_schema_as_json(request)}, - undefined, - document.getElementById('redoc-container') - ) - </script> - </body> - """ - - return f""" - <!DOCTYPE html> - <html> - {head} - {body} - </html> - """.encode() - - def render_404_page(self) -> bytes: - """Render an HTML 404 page. - - Returns: - A rendered html string. - """ - - return f""" - <!DOCTYPE html> - <html> - <head> - <title>404 Not found</title> - {self.favicon} - <meta charset="utf-8"/> - <meta name="viewport" content="width=device-width, initial-scale=1"> - <style> - {self.style} - </style> - </head> - <body> - <h1>Error 404</h1> - </body> - </html> - """.encode() - - def _get_schema_as_json(self, request: Request) -> str: - """Get the schema encoded as a JSON string.""" - - if not self._dumped_json_schema: - schema = self.get_schema_from_request(request).to_schema() - json_encoded_schema = encode_json(schema, request.route_handler.default_serializer) - self._dumped_json_schema = json_encoded_schema.decode("utf-8") - - return self._dumped_json_schema diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/datastructures.py b/venv/lib/python3.11/site-packages/litestar/openapi/datastructures.py deleted file mode 100644 index 5796a48..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/datastructures.py +++ /dev/null @@ -1,29 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass, field -from typing import TYPE_CHECKING - -from litestar.enums import MediaType - -if TYPE_CHECKING: - from litestar.openapi.spec import Example - from litestar.types import DataContainerType - - -__all__ = ("ResponseSpec",) - - -@dataclass -class ResponseSpec: - """Container type of additional responses.""" - - data_container: DataContainerType | None - """A model that describes the content of the response.""" - generate_examples: bool = field(default=True) - """Generate examples for the response content.""" - description: str = field(default="Additional response") - """A description of the response.""" - media_type: MediaType = field(default=MediaType.JSON) - """Response media type.""" - examples: list[Example] | None = field(default=None) - """A list of Example models.""" diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__init__.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__init__.py deleted file mode 100644 index 438c351..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__init__.py +++ /dev/null @@ -1,68 +0,0 @@ -from .base import BaseSchemaObject -from .callback import Callback -from .components import Components -from .contact import Contact -from .discriminator import Discriminator -from .encoding import Encoding -from .enums import OpenAPIFormat, OpenAPIType -from .example import Example -from .external_documentation import ExternalDocumentation -from .header import OpenAPIHeader -from .info import Info -from .license import License -from .link import Link -from .media_type import OpenAPIMediaType -from .oauth_flow import OAuthFlow -from .oauth_flows import OAuthFlows -from .open_api import OpenAPI -from .operation import Operation -from .parameter import Parameter -from .path_item import PathItem -from .paths import Paths -from .reference import Reference -from .request_body import RequestBody -from .response import OpenAPIResponse -from .responses import Responses -from .schema import Schema -from .security_requirement import SecurityRequirement -from .security_scheme import SecurityScheme -from .server import Server -from .server_variable import ServerVariable -from .tag import Tag -from .xml import XML - -__all__ = ( - "BaseSchemaObject", - "Callback", - "Components", - "Contact", - "Discriminator", - "Encoding", - "Example", - "ExternalDocumentation", - "Info", - "License", - "Link", - "OAuthFlow", - "OAuthFlows", - "OpenAPI", - "OpenAPIFormat", - "OpenAPIHeader", - "OpenAPIMediaType", - "OpenAPIResponse", - "OpenAPIType", - "Operation", - "Parameter", - "PathItem", - "Paths", - "Reference", - "RequestBody", - "Responses", - "Schema", - "SecurityRequirement", - "SecurityScheme", - "Server", - "ServerVariable", - "Tag", - "XML", -) diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/__init__.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/__init__.cpython-311.pyc Binary files differdeleted file mode 100644 index 682acac..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/__init__.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/base.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/base.cpython-311.pyc Binary files differdeleted file mode 100644 index 7f9658f..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/base.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/callback.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/callback.cpython-311.pyc Binary files differdeleted file mode 100644 index 8fb170e..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/callback.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/components.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/components.cpython-311.pyc Binary files differdeleted file mode 100644 index 98c83be..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/components.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/contact.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/contact.cpython-311.pyc Binary files differdeleted file mode 100644 index 53b94c2..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/contact.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/discriminator.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/discriminator.cpython-311.pyc Binary files differdeleted file mode 100644 index 5a4b1bc..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/discriminator.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/encoding.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/encoding.cpython-311.pyc Binary files differdeleted file mode 100644 index 58ab620..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/encoding.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/enums.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/enums.cpython-311.pyc Binary files differdeleted file mode 100644 index 9e328e3..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/enums.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/example.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/example.cpython-311.pyc Binary files differdeleted file mode 100644 index 4f031b1..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/example.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/external_documentation.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/external_documentation.cpython-311.pyc Binary files differdeleted file mode 100644 index a0f445b..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/external_documentation.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/header.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/header.cpython-311.pyc Binary files differdeleted file mode 100644 index 1596fd8..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/header.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/info.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/info.cpython-311.pyc Binary files differdeleted file mode 100644 index 45c4fdd..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/info.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/license.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/license.cpython-311.pyc Binary files differdeleted file mode 100644 index 98c60d4..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/license.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/link.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/link.cpython-311.pyc Binary files differdeleted file mode 100644 index b30775a..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/link.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/media_type.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/media_type.cpython-311.pyc Binary files differdeleted file mode 100644 index 47c85af..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/media_type.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/oauth_flow.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/oauth_flow.cpython-311.pyc Binary files differdeleted file mode 100644 index a6a8564..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/oauth_flow.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/oauth_flows.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/oauth_flows.cpython-311.pyc Binary files differdeleted file mode 100644 index 04555f8..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/oauth_flows.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/open_api.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/open_api.cpython-311.pyc Binary files differdeleted file mode 100644 index 1926726..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/open_api.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/operation.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/operation.cpython-311.pyc Binary files differdeleted file mode 100644 index 1c3ddc2..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/operation.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/parameter.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/parameter.cpython-311.pyc Binary files differdeleted file mode 100644 index e860dc9..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/parameter.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/path_item.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/path_item.cpython-311.pyc Binary files differdeleted file mode 100644 index cf33d1c..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/path_item.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/paths.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/paths.cpython-311.pyc Binary files differdeleted file mode 100644 index 4dc2e6e..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/paths.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/reference.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/reference.cpython-311.pyc Binary files differdeleted file mode 100644 index 66b4e2c..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/reference.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/request_body.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/request_body.cpython-311.pyc Binary files differdeleted file mode 100644 index 5788ebc..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/request_body.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/response.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/response.cpython-311.pyc Binary files differdeleted file mode 100644 index 364f342..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/response.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/responses.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/responses.cpython-311.pyc Binary files differdeleted file mode 100644 index db08130..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/responses.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/schema.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/schema.cpython-311.pyc Binary files differdeleted file mode 100644 index 6af9ca3..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/schema.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/security_requirement.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/security_requirement.cpython-311.pyc Binary files differdeleted file mode 100644 index 5aa7c2f..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/security_requirement.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/security_scheme.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/security_scheme.cpython-311.pyc Binary files differdeleted file mode 100644 index a2b1045..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/security_scheme.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/server.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/server.cpython-311.pyc Binary files differdeleted file mode 100644 index 26b70b3..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/server.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/server_variable.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/server_variable.cpython-311.pyc Binary files differdeleted file mode 100644 index 46ab0cd..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/server_variable.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/tag.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/tag.cpython-311.pyc Binary files differdeleted file mode 100644 index 7597e16..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/tag.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/xml.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/xml.cpython-311.pyc Binary files differdeleted file mode 100644 index 97cacd9..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/__pycache__/xml.cpython-311.pyc +++ /dev/null diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/base.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/base.py deleted file mode 100644 index 69cd3f3..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/base.py +++ /dev/null @@ -1,56 +0,0 @@ -from __future__ import annotations - -from dataclasses import asdict, dataclass, fields, is_dataclass -from enum import Enum -from typing import Any - -__all__ = ("BaseSchemaObject",) - - -def _normalize_key(key: str) -> str: - if key.endswith("_in"): - return "in" - if key.startswith("schema_"): - return key.split("_")[1] - if "_" in key: - components = key.split("_") - return components[0] + "".join(component.title() for component in components[1:]) - return "$ref" if key == "ref" else key - - -def _normalize_value(value: Any) -> Any: - if isinstance(value, BaseSchemaObject): - return value.to_schema() - if is_dataclass(value): - return {_normalize_value(k): _normalize_value(v) for k, v in asdict(value).items() if v is not None} - if isinstance(value, dict): - return {_normalize_value(k): _normalize_value(v) for k, v in value.items() if v is not None} - if isinstance(value, list): - return [_normalize_value(v) for v in value] - return value.value if isinstance(value, Enum) else value - - -@dataclass -class BaseSchemaObject: - """Base class for schema spec objects""" - - def to_schema(self) -> dict[str, Any]: - """Transform the spec dataclass object into a string keyed dictionary. This method traverses all nested values - recursively. - """ - result: dict[str, Any] = {} - - for field in fields(self): - value = _normalize_value(getattr(self, field.name, None)) - - if value is not None: - if "alias" in field.metadata: - if not isinstance(field.metadata["alias"], str): - raise TypeError('metadata["alias"] must be a str') - key = field.metadata["alias"] - else: - key = _normalize_key(field.name) - - result[key] = value - - return result diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/callback.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/callback.py deleted file mode 100644 index c4bb129..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/callback.py +++ /dev/null @@ -1,24 +0,0 @@ -from __future__ import annotations - -from typing import TYPE_CHECKING, Dict, Union - -if TYPE_CHECKING: - from litestar.openapi.spec.path_item import PathItem - from litestar.openapi.spec.reference import Reference - - -Callback = Dict[str, Union["PathItem", "Reference"]] -"""A map of possible out-of band callbacks related to the parent operation. Each value in the map is a -`Path Item Object <https://spec.openapis.org/oas/v3.1.0#pathItemObject>`_ that describes a set of requests that may be -initiated by the API provider and the expected responses. The key value used to identify the path item object is an -expression, evaluated at runtime, that identifies a URL to use for the callback operation. - -Patterned Fields - -{expression}: 'PathItem' = ... - -A Path Item Object used to define a callback request and expected responses. - -A `complete example <https://github.com/OAI/OpenAPI-Specification/blob/main/examples/v3.1/webhook-example.yaml>`_ is -available. -""" diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/components.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/components.py deleted file mode 100644 index b11da78..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/components.py +++ /dev/null @@ -1,72 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass, field -from typing import TYPE_CHECKING - -from litestar.openapi.spec.base import BaseSchemaObject - -__all__ = ("Components",) - - -if TYPE_CHECKING: - from litestar.openapi.spec.callback import Callback - from litestar.openapi.spec.example import Example - from litestar.openapi.spec.header import OpenAPIHeader - from litestar.openapi.spec.link import Link - from litestar.openapi.spec.parameter import Parameter - from litestar.openapi.spec.path_item import PathItem - from litestar.openapi.spec.reference import Reference - from litestar.openapi.spec.request_body import RequestBody - from litestar.openapi.spec.response import OpenAPIResponse - from litestar.openapi.spec.schema import Schema - from litestar.openapi.spec.security_scheme import SecurityScheme - - -@dataclass -class Components(BaseSchemaObject): - """Holds a set of reusable objects for different aspects of the OAS. - - All objects defined within the components object will have no effect - on the API unless they are explicitly referenced from properties - outside the components object. - """ - - schemas: dict[str, Schema] = field(default_factory=dict) - """An object to hold reusable - `Schema Objects <https://spec.openapis.org/oas/v3.1.0#schemaObject>`_""" - - responses: dict[str, OpenAPIResponse | Reference] | None = None - """An object to hold reusable - `Response Objects <https://spec.openapis.org/oas/v3.1.0#responseObject>`_""" - - parameters: dict[str, Parameter | Reference] | None = None - """An object to hold reusable - `Parameter Objects <https://spec.openapis.org/oas/v3.1.0#parameterObject>`_""" - - examples: dict[str, Example | Reference] | None = None - """An object to hold reusable - `Example Objects <https://spec.openapis.org/oas/v3.1.0#exampleObject>`_""" - - request_bodies: dict[str, RequestBody | Reference] | None = None - """An object to hold reusable - `Request Body Objects <https://spec.openapis.org/oas/v3.1.0#requestBodyObject>`_""" - - headers: dict[str, OpenAPIHeader | Reference] | None = None - """An object to hold reusable - `Header Objects <https://spec.openapis.org/oas/v3.1.0#headerObject>`_""" - - security_schemes: dict[str, SecurityScheme | Reference] | None = None - """An object to hold reusable - `Security Scheme Objects <https://spec.openapis.org/oas/v3.1.0#securitySchemeObject>`_""" - - links: dict[str, Link | Reference] | None = None - """An object to hold reusable - `Link Objects <https://spec.openapis.org/oas/v3.1.0#linkObject>`_""" - - callbacks: dict[str, Callback | Reference] | None = None - """An object to hold reusable - `Callback Objects <https://spec.openapis.org/oas/v3.1.0#callbackObject>`_""" - - path_items: dict[str, PathItem | Reference] | None = None - """An object to hold reusable - `Path Item Object <https://spec.openapis.org/oas/v3.1.0#pathItemObject>`_""" diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/contact.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/contact.py deleted file mode 100644 index b816288..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/contact.py +++ /dev/null @@ -1,21 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass - -from litestar.openapi.spec.base import BaseSchemaObject - -__all__ = ("Contact",) - - -@dataclass -class Contact(BaseSchemaObject): - """Contact information for the exposed API.""" - - name: str | None = None - """The identifying name of the contact person/organization.""" - - url: str | None = None - """The URL pointing to the contact information. MUST be in the form of a URL.""" - - email: str | None = None - """The email address of the contact person/organization. MUST be in the form of an email address.""" diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/discriminator.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/discriminator.py deleted file mode 100644 index 3c292ce..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/discriminator.py +++ /dev/null @@ -1,25 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass - -from litestar.openapi.spec.base import BaseSchemaObject - -__all__ = ("Discriminator",) - - -@dataclass(unsafe_hash=True) -class Discriminator(BaseSchemaObject): - """When request bodies or response payloads may be one of a number of different schemas, a ``discriminator`` - object can be used to aid in serialization, deserialization, and validation. - - The discriminator is a specific object in a schema which is used to inform the consumer of the specification of an - alternative schema based on the value associated with it. - - When using the discriminator, _inline_ schemas will not be considered. - """ - - property_name: str - """**REQUIRED**. The name of the property in the payload that will hold the discriminator value.""" - - mapping: dict[str, str] | None = None - """An object to hold mappings between payload values and schema names or references.""" diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/encoding.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/encoding.py deleted file mode 100644 index 2a469c8..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/encoding.py +++ /dev/null @@ -1,67 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass -from typing import TYPE_CHECKING - -from litestar.openapi.spec.base import BaseSchemaObject - -if TYPE_CHECKING: - from litestar.openapi.spec.header import OpenAPIHeader - from litestar.openapi.spec.reference import Reference - -__all__ = ("Encoding",) - - -@dataclass -class Encoding(BaseSchemaObject): - """A single encoding definition applied to a single schema property.""" - - content_type: str | None = None - """The Content-Type for encoding a specific property. Default value depends n the property type: - - - for ``object``: ``application/json`` - - for ``array``: the default is defined based on the inner type - - for all other cases the default is ``application/octet-stream``. - - The value can be a specific media type (e.g. ``application/json``), a wildcard media type (e.g. ``image/*``), or a - comma-separated list of the two types. - """ - - headers: dict[str, OpenAPIHeader | Reference] | None = None - """A map allowing additional information to be provided as headers, for example ``Content-Disposition``. - - ``Content-Type`` is described separately and SHALL be ignored in this section. This property SHALL be ignored if the - request body media type is not a ``multipart``. - """ - - style: str | None = None - """Describes how a specific property value will be serialized depending on its type. - - See `Parameter Object <https://spec.openapis.org/oas/v3.1.0#parameterObject>`_ for details on the - `style <https://spec.openapis.org/oas/v3.1.0#parameterStyle>`__ property. The behavior follows the same values as - ``query`` parameters, including default values. This property SHALL be ignored if the request body media type is not - ``application/x-www-form-urlencoded`` or ``multipart/form-data``. If a value is explicitly defined, then the value - of `contentType <https://spec.openapis.org/oas/v3.1.0#encodingContentType>`_ (implicit or explicit) SHALL be - ignored. - """ - - explode: bool = False - """When this is true, property values of type ``array`` or ``object`` generate separate parameters for each value of - the array, or key-value-pair of the map. - - For other types of properties this property has no effect. When - `style <https://spec.openapis.org/oas/v3.1.0#encodingStyle>`_ is ``form``, the default value is ``True``. For all - other styles, the default value is ``False``. This property SHALL be ignored if the request body media type is not - ``application/x-www-form-urlencoded`` or ``multipart/form-data``. If a value is explicitly defined, then the value - of `contentType <https://spec.openapis.org/oas/v3.1.0#encodingContentType>`_ (implicit or explicit) SHALL be - ignored. - """ - - allow_reserved: bool = False - """Determines whether the parameter value SHOULD allow reserved characters, as defined by :rfc:`3986` - (``:/?#[]@!$&'()*+,;=``) to be included without percent-encoding. - - This property SHALL be ignored if the request body media type s not ``application/x-www-form-urlencoded`` or - ``multipart/form-data``. If a value is explicitly defined, then the value of - `contentType <https://spec.openapis.org/oas/v3.1.0#encodingContentType>`_ (implicit or explicit) SHALL be ignored. - """ diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/enums.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/enums.py deleted file mode 100644 index da9adea..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/enums.py +++ /dev/null @@ -1,41 +0,0 @@ -from enum import Enum - -__all__ = ("OpenAPIFormat", "OpenAPIType") - - -class OpenAPIFormat(str, Enum): - """Formats extracted from: https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-validation-00#page-13""" - - DATE = "date" - DATE_TIME = "date-time" - TIME = "time" - DURATION = "duration" - URL = "url" - EMAIL = "email" - IDN_EMAIL = "idn-email" - HOST_NAME = "hostname" - IDN_HOST_NAME = "idn-hostname" - IPV4 = "ipv4" - IPV6 = "ipv6" - URI = "uri" - URI_REFERENCE = "uri-reference" - URI_TEMPLATE = "uri-template" - JSON_POINTER = "json-pointer" - RELATIVE_JSON_POINTER = "relative-json-pointer" - IRI = "iri-reference" - IRI_REFERENCE = "iri-reference" # noqa: PIE796 - UUID = "uuid" - REGEX = "regex" - BINARY = "binary" - - -class OpenAPIType(str, Enum): - """An OopenAPI type.""" - - ARRAY = "array" - BOOLEAN = "boolean" - INTEGER = "integer" - NULL = "null" - NUMBER = "number" - OBJECT = "object" - STRING = "string" diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/example.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/example.py deleted file mode 100644 index 414452e..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/example.py +++ /dev/null @@ -1,33 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass -from typing import Any - -from litestar.openapi.spec.base import BaseSchemaObject - - -@dataclass -class Example(BaseSchemaObject): - summary: str | None = None - """Short description for the example.""" - - description: str | None = None - """Long description for the example. - - `CommonMark syntax <https://spec.commonmark.org/>`_ MAY be used for rich text representation. - """ - - value: Any | None = None - """Embedded literal example. - - The ``value`` field and ``externalValue`` field are mutually exclusive. To represent examples of media types that - cannot naturally represented in JSON or YAML, use a string value to contain the example, escaping where necessary. - """ - - external_value: str | None = None - """A URL that points to the literal example. This provides the capability to reference examples that cannot easily - be included in JSON or YAML documents. - - The ``value`` field and ``externalValue`` field are mutually exclusive. See the rules for resolving - `Relative References <https://spec.openapis.org/oas/v3.1.0#relativeReferencesURI>`_. - """ diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/external_documentation.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/external_documentation.py deleted file mode 100644 index f11b90d..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/external_documentation.py +++ /dev/null @@ -1,21 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass - -from litestar.openapi.spec.base import BaseSchemaObject - -__all__ = ("ExternalDocumentation",) - - -@dataclass -class ExternalDocumentation(BaseSchemaObject): - """Allows referencing an external resource for extended documentation.""" - - url: str - """**REQUIRED**. The URL for the target documentation. Value MUST be in the form of a URL.""" - - description: str | None = None - """A short description of the target documentation. - - `CommonMark syntax <https://spec.commonmark.org/>`_ MAY be used for rich text representation. - """ diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/header.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/header.py deleted file mode 100644 index 006ff22..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/header.py +++ /dev/null @@ -1,121 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass -from typing import TYPE_CHECKING, Any, Literal - -from litestar.openapi.spec.base import BaseSchemaObject - -if TYPE_CHECKING: - from litestar.openapi.spec.example import Example - from litestar.openapi.spec.media_type import OpenAPIMediaType - from litestar.openapi.spec.reference import Reference - from litestar.openapi.spec.schema import Schema - -__all__ = ("OpenAPIHeader",) - - -@dataclass -class OpenAPIHeader(BaseSchemaObject): - """The Header Object follows the structure of the [Parameter - Object](https://spec.openapis.org/oas/v3.1.0#parameterObject) with the - following changes: - - 1. ``name`` MUST NOT be specified, it is given in the corresponding ``headers`` map. - 2. ``in`` MUST NOT be specified, it is implicitly in ``header``. - 3. All traits that are affected by the location MUST be applicable to a location of ``header`` - (for example, `style <https://spec.openapis.org/oas/v3.1.0#parameterStyle>`__). - """ - - schema: Schema | Reference | None = None - """The schema defining the type used for the parameter.""" - - name: Literal[""] = "" - """MUST NOT be specified, it is given in the corresponding ``headers`` map.""" - - param_in: Literal["header"] = "header" - """MUST NOT be specified, it is implicitly in ``header``.""" - - description: str | None = None - """A brief description of the parameter. This could contain examples of - use. - - `CommonMark syntax <https://spec.commonmark.org/>`_ MAY be used for rich text representation. - """ - - required: bool = False - """Determines whether this parameter is mandatory. - - If the `parameter location <https://spec.openapis.org/oas/v3.1.0#parameterIn>`_ is ``"path"``, this property is - **REQUIRED** and its value MUST be ``True``. Otherwise, the property MAY be included and its default value is - ``False``. - """ - - deprecated: bool = False - """Specifies that a parameter is deprecated and SHOULD be transitioned out of usage. Default value is ``False``.""" - - allow_empty_value: bool = False - """Sets the ability to pass empty-valued parameters. This is valid only for ``query`` parameters and allows sending - a parameter with an empty value. Default value is ``False``. If - `style <https://spec.openapis.org/oas/v3.1.0#parameterStyle>`__ is used, and if behavior is ``n/a`` (cannot be - serialized), the value of ``allowEmptyValue`` SHALL be ignored. Use of this property is NOT RECOMMENDED, as it is - likely to be removed in a later revision. - - The rules for serialization of the parameter are specified in one of two ways.For simpler scenarios, a - `schema <https://spec.openapis.org/oas/v3.1.0#parameterSchema>`_ and - `style <https://spec.openapis.org/oas/v3.1.0#parameterStyle>`__ can describe the structure and syntax of the - parameter. - """ - - style: str | None = None - """Describes how the parameter value will be serialized depending on the - type of the parameter value. Default values (based on value of ``in``): - - - for ``query`` - ``form``; - - for ``path`` - ``simple``; - - for ``header`` - ``simple``; - - for ``cookie`` - ``form``. - """ - - explode: bool | None = None - """When this is true, parameter values of type ``array`` or ``object`` generate separate parameters for each value - of the array or key-value pair of the map. - - For other types of parameters this property has no effect.When - `style <https://spec.openapis.org/oas/v3.1.0#parameterStyle>`__ is ``form``, the default value is ``True``. For all - other styles, the default value is ``False``. - """ - - allow_reserved: bool = False - """Determines whether the parameter value SHOULD allow reserved characters, as defined by. :rfc:`3986` - (``:/?#[]@!$&'()*+,;=``) to be included without percent-encoding. - - This property only applies to parameters with an ``in`` value of ``query``. The default value is ``False``. - """ - - example: Any | None = None - """Example of the parameter's potential value. - - The example SHOULD match the specified schema and encoding properties if present. The ``example`` field is mutually - exclusive of the ``examples`` field. Furthermore, if referencing a ``schema`` that contains an example, the - ``example`` value SHALL _override_ the example provided by the schema. To represent examples of media types that - cannot naturally be represented in JSON or YAML, a string value can contain the example with escaping where - necessary. - """ - - examples: dict[str, Example | Reference] | None = None - """Examples of the parameter's potential value. Each example SHOULD contain a value in the correct format as - specified in the parameter encoding. The ``examples`` field is mutually exclusive of the ``example`` field. - Furthermore, if referencing a ``schema`` that contains an example, the ``examples`` value SHALL _override_ the - example provided by the schema. - - For more complex scenarios, the `content <https://spec.openapis.org/oas/v3.1.0#parameterContent>`_ property can - define the media type and schema of the parameter. A parameter MUST contain either a ``schema`` property, or a - ``content`` property, but not both. When ``example`` or ``examples`` are provided in conjunction with the ``schema`` - object, the example MUST follow the prescribed serialization strategy for the parameter. - """ - - content: dict[str, OpenAPIMediaType] | None = None - """A map containing the representations for the parameter. - - The key is the media type and the value describes it. The map MUST only contain one entry. - """ diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/info.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/info.py deleted file mode 100644 index 1d858db..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/info.py +++ /dev/null @@ -1,50 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass -from typing import TYPE_CHECKING - -from litestar.openapi.spec.base import BaseSchemaObject - -if TYPE_CHECKING: - from litestar.openapi.spec.contact import Contact - from litestar.openapi.spec.license import License - -__all__ = ("Info",) - - -@dataclass -class Info(BaseSchemaObject): - """The object provides metadata about the API. - - The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools - for convenience. - """ - - title: str - """ - **REQUIRED**. The title of the API. - """ - - version: str - """ - **REQUIRED**. The version of the OpenAPI document which is distinct from the - `OpenAPI Specification version <https://spec.openapis.org/oas/v3.1.0#oasVersion>`_ or the API implementation version - """ - - summary: str | None = None - """A short summary of the API.""" - - description: str | None = None - """A description of the API. - - `CommonMark syntax <https://spec.commonmark.org/>`_ MAY be used for rich text representation. - """ - - terms_of_service: str | None = None - """A URL to the Terms of Service for the API. MUST be in the form of a URL.""" - - contact: Contact | None = None - """The contact information for the exposed API.""" - - license: License | None = None - """The license information for the exposed API.""" diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/license.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/license.py deleted file mode 100644 index b779bb4..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/license.py +++ /dev/null @@ -1,28 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass - -from litestar.openapi.spec.base import BaseSchemaObject - -__all__ = ("License",) - - -@dataclass -class License(BaseSchemaObject): - """License information for the exposed API.""" - - name: str - """**REQUIRED**. The license name used for the API.""" - - identifier: str | None = None - """An - `SPDX <https://spdx.github.io/spdx-spec/v2.3/SPDX-license-list/#a1-licenses-with-short-identifiers>`_ license expression for the API. - - The ``identifier`` field is mutually exclusive of the ``url`` field. - """ - - url: str | None = None - """A URL to the license used for the API. - - This MUST be in the form of a URL. The ``url`` field is mutually exclusive of the ``identifier`` field. - """ diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/link.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/link.py deleted file mode 100644 index 78c4f85..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/link.py +++ /dev/null @@ -1,66 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass -from typing import TYPE_CHECKING, Any - -from litestar.openapi.spec.base import BaseSchemaObject - -if TYPE_CHECKING: - from litestar.openapi.spec.server import Server - -__all__ = ("Link",) - - -@dataclass -class Link(BaseSchemaObject): - """The ``Link object`` represents a possible design-time link for a response. The presence of a link does not - guarantee the caller's ability to successfully invoke it, rather it provides a known relationship and traversal - mechanism between responses and other operations. - - Unlike _dynamic_ links (i.e. links provided **in** the response payload), the OAS linking mechanism does not require - link information in the runtime response. - - For computing links, and providing instructions to execute them, a - `runtime expression <https://spec.openapis.org/oas/v3.1.0#runtimeExpression>`_ is used for accessing values in an - operation and using them as parameters while invoking the linked operation. - """ - - operation_ref: str | None = None - """A relative or absolute URI reference to an OAS operation. - - This field is mutually exclusive of the ``operationId`` field, and MUST point to an - `Operation Object <https://spec.openapis.org/oas/v3.1.0#operationObject>`_. Relative ``operationRef`` values MAY be - used to locate an existing `Operation Object <https://spec.openapis.org/oas/v3.1.0#operationObject>`_ in the OpenAPI - definition. See the rules for resolving - `Relative References <https://spec.openapis.org/oas/v3.1.0#relativeReferencesURI>`_ - """ - - operation_id: str | None = None - """The name of an _existing_, resolvable OAS operation, as defined with a unique ``operationId``. - - This field is mutually exclusive of the ``operationRef`` field. - """ - - parameters: dict[str, Any] | None = None - """A map representing parameters to pass to an operation as specified with ``operationId`` or identified via - ``operationRef``. The key is the parameter name to be used, whereas the value can be a constant or an expression to - be evaluated and passed to the linked operation. - - The parameter name can be qualified using the - `parameter location <https://spec.openapis.org/oas/v3.1.0#parameterIn>`_ ``[{in}.]{name}`` for operations that use - the same parameter name in different locations (e.g. path.id). - """ - - request_body: Any | None = None - """A literal value or - `{expression} <https://spec.openapis.org/oas/v3.1.0#runtimeExpression>`_ to use as a request body when calling the - target operation.""" - - description: str | None = None - """A description of the link. - - `CommonMark syntax <https://spec.commonmark.org/>`_ MAY be used for rich text representation. - """ - - server: Server | None = None - """A server object to be used by the target operation.""" diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/media_type.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/media_type.py deleted file mode 100644 index 3e83fb5..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/media_type.py +++ /dev/null @@ -1,51 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass -from typing import TYPE_CHECKING, Any - -from litestar.openapi.spec.base import BaseSchemaObject - -if TYPE_CHECKING: - from litestar.openapi.spec.encoding import Encoding - from litestar.openapi.spec.example import Example - from litestar.openapi.spec.reference import Reference - from litestar.openapi.spec.schema import Schema - -__all__ = ("OpenAPIMediaType",) - - -@dataclass -class OpenAPIMediaType(BaseSchemaObject): - """Each Media Type Object provides schema and examples for the media type identified by its key.""" - - schema: Reference | Schema | None = None - """The schema defining the content of the request, response, or parameter.""" - - example: Any | None = None - """Example of the media type. - - The example object SHOULD be in the correct format as specified by the media type. - - The ``example`` field is mutually exclusive of the ``examples`` field. - - Furthermore, if referencing a ``schema`` which contains an example, the ``example`` value SHALL _override_ the - example provided by the schema. - """ - - examples: dict[str, Example | Reference] | None = None - """Examples of the media type. - - Each example object SHOULD match the media type and specified schema if present. - - The ``examples`` field is mutually exclusive of the ``example`` field. - - Furthermore, if referencing a ``schema`` which contains an example, the ``examples`` value SHALL _override_ the - example provided by the schema. - """ - - encoding: dict[str, Encoding] | None = None - """A map between a property name and its encoding information. - - The key, being the property name, MUST exist in the schema as a property. The encoding object SHALL only apply to - ``requestBody`` objects when the media type is ``multipart`` or ``application/x-www-form-urlencoded``. - """ diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/oauth_flow.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/oauth_flow.py deleted file mode 100644 index c322efc..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/oauth_flow.py +++ /dev/null @@ -1,36 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass - -from litestar.openapi.spec.base import BaseSchemaObject - -__all__ = ("OAuthFlow",) - - -@dataclass -class OAuthFlow(BaseSchemaObject): - """Configuration details for a supported OAuth Flow.""" - - authorization_url: str | None = None - """ - **REQUIRED** for ``oauth2`` ("implicit", "authorizationCode"). The authorization URL to be used for this flow. This - MUST be in the form of a URL. The OAuth2 standard requires the use of TLS. - """ - - token_url: str | None = None - """ - **REQUIRED** for ``oauth2`` ("password", "clientCredentials", "authorizationCode"). The token URL to be used for - this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS. - """ - - refresh_url: str | None = None - """The URL to be used for obtaining refresh tokens. - - This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS. - """ - - scopes: dict[str, str] | None = None - """ - **REQUIRED** for ``oauth2``. The available scopes for the OAuth2 security scheme. A map between the scope name and a - short description for it the map MAY be empty. - """ diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/oauth_flows.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/oauth_flows.py deleted file mode 100644 index 920d095..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/oauth_flows.py +++ /dev/null @@ -1,28 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass -from typing import TYPE_CHECKING - -from litestar.openapi.spec.base import BaseSchemaObject - -if TYPE_CHECKING: - from litestar.openapi.spec.oauth_flow import OAuthFlow - -__all__ = ("OAuthFlows",) - - -@dataclass -class OAuthFlows(BaseSchemaObject): - """Allows configuration of the supported OAuth Flows.""" - - implicit: OAuthFlow | None = None - """Configuration for the OAuth Implicit flow.""" - - password: OAuthFlow | None = None - """Configuration for the OAuth Resource Owner Password flow.""" - - client_credentials: OAuthFlow | None = None - """Configuration for the OAuth Client Credentials flow. Previously called ``application`` in OpenAPI 2.0.""" - - authorization_code: OAuthFlow | None = None - """Configuration for the OAuth Authorization Code flow. Previously called ``accessCode`` in OpenAPI 2.0.""" diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/open_api.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/open_api.py deleted file mode 100644 index 55465fa..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/open_api.py +++ /dev/null @@ -1,87 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass, field -from typing import TYPE_CHECKING - -from litestar.openapi.spec.base import BaseSchemaObject -from litestar.openapi.spec.components import Components -from litestar.openapi.spec.server import Server - -if TYPE_CHECKING: - from litestar.openapi.spec.external_documentation import ExternalDocumentation - from litestar.openapi.spec.info import Info - from litestar.openapi.spec.path_item import PathItem - from litestar.openapi.spec.paths import Paths - from litestar.openapi.spec.reference import Reference - from litestar.openapi.spec.security_requirement import SecurityRequirement - from litestar.openapi.spec.tag import Tag - -__all__ = ("OpenAPI",) - - -@dataclass -class OpenAPI(BaseSchemaObject): - """Root OpenAPI document.""" - - info: Info - """ - **REQUIRED**. Provides metadata about the API. The metadata MAY be used by tooling as required. - """ - - openapi: str = "3.1.0" - """ - **REQUIRED**. This string MUST be the - `version number <https://spec.openapis.org/oas/v3.1.0#versions>`_ of the OpenAPI Specification that the OpenAPI - document uses. The ``openapi`` field SHOULD be used by tooling to interpret the OpenAPI document. This is *not* - related to the API `info.version <https://spec.openapis.org/oas/v3.1.0#infoVersion>`_ string. - """ - - json_schema_dialect: str | None = None - """The default value for the ``$schema`` keyword within - `Schema Objects <https://spec.openapis.org/oas/v3.1.0#schemaObject>`_ contained within this OAS document. - - This MUST be in the form of a URI. - """ - - servers: list[Server] = field(default_factory=lambda x: [Server(url="/")]) # type: ignore[misc, arg-type] - """An array of Server Objects, which provide connectivity information to a target server. - - If the ``servers`` property is not provided, or is an empty array, the default value would be a - `Server Object <https://spec.openapis.org/oas/v3.1.0#serverObject>`_ with a - `url <https://spec.openapis.org/oas/v3.1.0#serverUrl>`_ value of ``/``. - """ - - paths: Paths | None = None - """The available paths and operations for the API.""" - - webhooks: dict[str, PathItem | Reference] | None = None - """The incoming webhooks that MAY be received as part of this API and that the API consumer MAY choose to implement. - - Closely related to the ``callbacks`` feature, this section describes requests initiated other than by an API call, - for example by an out of band registration. The key name is a unique string to refer to each webhook, while the - (optionally referenced) Path Item Object describes a request that may be initiated by the API provider and the - expected responses. An - `example <https://github.com/OAI/OpenAPI-Specification/blob/main/examples/v3.1/webhook-example.yaml>`_ is available. - """ - - components: Components = field(default_factory=Components) - """An element to hold various schemas for the document.""" - - security: list[SecurityRequirement] | None = None - """A declaration of which security mechanisms can be used across the API. - - The list of values includes alternative security requirement objects that can be used. Only one of the security - requirement objects need to be satisfied to authorize a request. Individual operations can override this definition. - To make security optional, an empty security requirement ( ``{}`` ) can be included in the array. - """ - - tags: list[Tag] | None = None - """A list of tags used by the document with additional metadata. - - The order of the tags can be used to reflect on their order by the parsing tools. Not all tags that are used by the - `Operation Object <https://spec.openapis.org/oas/v3.1.0#operationObject>`_ must be declared. The tags that are not - declared MAY be organized randomly or based on the tools' logic. Each tag name in the list MUST be unique. - """ - - external_docs: ExternalDocumentation | None = None - """Additional external documentation.""" diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/operation.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/operation.py deleted file mode 100644 index ab80181..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/operation.py +++ /dev/null @@ -1,105 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass -from typing import TYPE_CHECKING - -from litestar.openapi.spec.base import BaseSchemaObject - -if TYPE_CHECKING: - from litestar.openapi.spec.callback import Callback - from litestar.openapi.spec.external_documentation import ExternalDocumentation - from litestar.openapi.spec.parameter import Parameter - from litestar.openapi.spec.reference import Reference - from litestar.openapi.spec.request_body import RequestBody - from litestar.openapi.spec.responses import Responses - from litestar.openapi.spec.security_requirement import SecurityRequirement - from litestar.openapi.spec.server import Server - -__all__ = ("Operation",) - - -@dataclass -class Operation(BaseSchemaObject): - """Describes a single API operation on a path.""" - - tags: list[str] | None = None - """A list of tags for API documentation control. - - Tags can be used for logical grouping of operations by resources or any other qualifier. - """ - - summary: str | None = None - """A short summary of what the operation does.""" - - description: str | None = None - """A verbose explanation of the operation behavior. - - `CommonMark syntax <https://spec.commonmark.org/>`_ MAY be used for rich text representation. - """ - - external_docs: ExternalDocumentation | None = None - """Additional external documentation for this operation.""" - - operation_id: str | None = None - """Unique string used to identify the operation. - - The id MUST be unique among all operations described in the API. The operationId value is **case-sensitive**. Tools - and libraries MAY use the operationId to uniquely identify an operation, therefore, it is RECOMMENDED to follow - common programming naming conventions. - """ - - parameters: list[Parameter | Reference] | None = None - """A list of parameters that are applicable for this operation. - - If a parameter is already defined at the `Path Item <https://spec.openapis.org/oas/v3.1.0#pathItemParameters>`_, - the new definition will override it but can never remove it. The list MUST NOT include duplicated parameters. A - unique parameter is defined by a combination of a `name <https://spec.openapis.org/oas/v3.1.0#parameterName>`_ and - `location <https://spec.openapis.org/oas/v3.1.0#parameterIn>`_. The list can use the - `Reference Object <https://spec.openapis.org/oas/v3.1.0#referenceObject>`_ to link to parameters that are defined at - the `OpenAPI Object's components/parameters <https://spec.openapis.org/oas/v3.1.0#componentsParameters>`_. - """ - - request_body: RequestBody | Reference | None = None - """The request body applicable for this operation. - - The ``requestBody`` is fully supported in HTTP methods where the HTTP 1.1 specification - :rfc:`7231` has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague (such - as `GET <https://tools.ietf.org/html/rfc7231#section-4.3.1>`_, - `HEAD <https://tools.ietf.org/html/rfc7231#section-4.3.2>`_ and - `DELETE <https://tools.ietf.org/html/rfc7231#section-4.3.5>`_, ``requestBody`` is permitted but does not have - well-defined semantics and SHOULD be avoided if possible. - """ - - responses: Responses | None = None - """The list of possible responses as they are returned from executing this operation.""" - - callbacks: dict[str, Callback | Reference] | None = None - """A map of possible out-of band callbacks related to the parent operation. - - The key is a unique identifier for the Callback Object. Each value in the map is a - `Callback Object <https://spec.openapis.org/oas/v3.1.0#callbackObject>`_ that describes a request that may be - initiated by the API provider and the expected responses. - """ - - deprecated: bool = False - """Declares this operation to be deprecated. - - Consumers SHOULD refrain from usage of the declared operation. Default value is ``False``. - """ - - security: list[SecurityRequirement] | None = None - """A declaration of which security mechanisms can be used for this operation. - - The list of values includes alternative security requirement objects that can be used. Only one of the security - requirement objects need to be satisfied to authorize a request. To make security optional, an empty security - requirement (``{}``) can be included in the array. This definition overrides any declared top-level - `security <https://spec.openapis.org/oas/v3.1.0#oasSecurity>`_. To remove a top-level security declaration, an empty - array can be used. - """ - - servers: list[Server] | None = None - """An alternative ``server`` array to service this operation. - - If an alternative ``server`` object is specified at the Path Item Object or Root level, it will be overridden by - this value. - """ diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/parameter.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/parameter.py deleted file mode 100644 index 74a100f..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/parameter.py +++ /dev/null @@ -1,136 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass -from typing import TYPE_CHECKING, Any, Mapping - -from litestar.openapi.spec.base import BaseSchemaObject - -if TYPE_CHECKING: - from litestar.openapi.spec.example import Example - from litestar.openapi.spec.media_type import OpenAPIMediaType - from litestar.openapi.spec.reference import Reference - from litestar.openapi.spec.schema import Schema - -__all__ = ("Parameter",) - - -@dataclass -class Parameter(BaseSchemaObject): - """Describes a single operation parameter. - - A unique parameter is defined by a combination of a `name <https://spec.openapis.org/oas/v3.1.0#parameterName>`_ and - `location <https://spec.openapis.org/oas/v3.1.0#parameterIn>`_. - """ - - name: str - """ - **REQUIRED**. The name of the parameter. - Parameter names are *case sensitive*. - - - If `in <https://spec.openapis.org/oas/v3.1.0#parameterIn>`_ is ``"path"``, the ``name`` field MUST correspond to a - template expression occurring within the `path <https://spec.openapis.org/oas/v3.1.0#pathsPath>`_ field in the - `Paths Object <https://spec.openapis.org/oas/v3.1.0#pathsObject>`_. See - `Path Templating <https://spec.openapis.org/oas/v3.1.0#pathTemplating>`_ for further information. - - If `in <https://spec.openapis.org/oas/v3.1.0#parameterIn>`_ is ``"header"`` and the ``name`` field is - ``"Accept"``, ``"Content-Type"`` or ``"Authorization"``, the parameter definition SHALL be ignored. - - For all other cases, the ``name`` corresponds to the parameter name used by the - `in <https://spec.openapis.org/oas/v3.1.0#parameterIn>`_ property. - """ - - param_in: str - """ - **REQUIRED**. The location of the parameter. Possible values are - ``"query"``, ``"header"``, ``"path"`` or ``"cookie"``. - """ - - schema: Schema | Reference | None = None - """The schema defining the type used for the parameter.""" - - description: str | None = None - """A brief description of the parameter. This could contain examples of - use. - - `CommonMark syntax <https://spec.commonmark.org/>`_ MAY be used for rich text representation. - """ - - required: bool = False - """Determines whether this parameter is mandatory. - - If the `parameter location <https://spec.openapis.org/oas/v3.1.0#parameterIn>`_ is ``"path"``, this property is - **REQUIRED** and its value MUST be ``True``. Otherwise, the property MAY be included and its default value is - ``False``. - """ - - deprecated: bool = False - """Specifies that a parameter is deprecated and SHOULD be transitioned out of usage. - - Default value is ``False``. - """ - - allow_empty_value: bool = False - """Sets the ability to pass empty-valued parameters. This is valid only for ``query`` parameters and allows sending - a parameter with an empty value. Default value is ``False``. If - `style <https://spec.openapis.org/oas/v3.1.0#parameterStyle>`__ is used, and if behavior is ``n/a`` (cannot be - serialized), the value of ``allowEmptyValue`` SHALL be ignored. Use of this property is NOT RECOMMENDED, as it is - likely to be removed in a later revision. - - The rules for serialization of the parameter are specified in one of two ways. For simpler scenarios, a - `schema <https://spec.openapis.org/oas/v3.1.0#parameterSchema>`_ and - `style <https://spec.openapis.org/oas/v3.1.0#parameterStyle>`__ can describe the structure and syntax of the - parameter. - """ - - style: str | None = None - """Describes how the parameter value will be serialized depending on the ype of the parameter value. Default values - (based on value of ``in``): - - - for ``query`` - ``form`` - - for ``path`` - ``simple`` - - for ``header`` - ``simple`` - - for ``cookie`` - ``form`` - """ - - explode: bool | None = None - """When this is true, parameter values of type ``array`` or ``object`` generate separate parameters for each value - of the array or key-value pair of the map. - - For other types of parameters this property has no effect. When - `style <https://spec.openapis.org/oas/v3.1.0#parameterStyle>`__ is ``form``, the default value is ``True``. For all - other styles, the default value is ``False``. - """ - - allow_reserved: bool = False - """Determines whether the parameter value SHOULD allow reserved characters, as defined by. - - :rfc:`3986` ``:/?#[]@!$&'()*+,;=`` to be included without percent-encoding. - - This property only applies to parameters with an ``in`` value of ``query``. The default value is ``False``. - """ - - example: Any | None = None - """Example of the parameter's potential value. - - The example SHOULD match the specified schema and encoding properties if present. The ``example`` field is mutually - exclusive of the ``examples`` field. Furthermore, if referencing a ``schema`` that contains an example, the - ``example`` value SHALL _override_ the example provided by the schema. To represent examples of media types that - cannot naturally be represented in JSON or YAML, a string value can contain the example with escaping where - necessary. - """ - - examples: Mapping[str, Example | Reference] | None = None - """Examples of the parameter's potential value. Each example SHOULD contain a value in the correct format as - specified in the parameter encoding. The ``examples`` field is mutually exclusive of the ``example`` field. - Furthermore, if referencing a ``schema`` that contains an example, the ``examples`` value SHALL _override_ the - example provided by the schema. - - For more complex scenarios, the `content <https://spec.openapis.org/oas/v3.1.0#parameterContent>`_ property can - define the media type and schema of the parameter. A parameter MUST contain either a ``schema`` property, or a - ``content`` property, but not both. When ``example`` or ``examples`` are provided in conjunction with the - ``schema`` object, the example MUST follow the prescribed serialization strategy for the parameter. - """ - - content: dict[str, OpenAPIMediaType] | None = None - """A map containing the representations for the parameter. - - The key is the media type and the value describes it. The map MUST only contain one entry. - """ diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/path_item.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/path_item.py deleted file mode 100644 index 17005c5..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/path_item.py +++ /dev/null @@ -1,78 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass -from typing import TYPE_CHECKING - -from litestar.openapi.spec.base import BaseSchemaObject - -if TYPE_CHECKING: - from litestar.openapi.spec.operation import Operation - from litestar.openapi.spec.parameter import Parameter - from litestar.openapi.spec.reference import Reference - from litestar.openapi.spec.server import Server - -__all__ = ("PathItem",) - - -@dataclass -class PathItem(BaseSchemaObject): - """Describes the operations available on a single path. - - A Path Item MAY be empty, due to `ACL constraints <https://spec.openapis.org/oas/v3.1.0#securityFiltering>`_. The - path itself is still exposed to the documentation viewer, but they will not know which operations and parameters are - available. - """ - - ref: str | None = None - """Allows for an external definition of this path item. The referenced structure MUST be in the format of a - `Path Item Object <https://spec.openapis.org/oas/v3.1.0#pathItemObject>`. - - In case a Path Item Object field appears both in the defined object and the referenced object, the behavior is - undefined. See the rules for resolving - `Relative References <https://spec.openapis.org/oas/v3.1.0#relativeReferencesURI>`_. - """ - - summary: str | None = None - """An optional, string summary, intended to apply to all operations in this path.""" - - description: str | None = None - """An optional, string description, intended to apply to all operations in this path. - - `CommonMark syntax <https://spec.commonmark.org/>`_ MAY be used for rich text representation. - """ - - get: Operation | None = None - """A definition of a GET operation on this path.""" - - put: Operation | None = None - """A definition of a PUT operation on this path.""" - - post: Operation | None = None - """A definition of a POST operation on this path.""" - - delete: Operation | None = None - """A definition of a DELETE operation on this path.""" - - options: Operation | None = None - """A definition of a OPTIONS operation on this path.""" - - head: Operation | None = None - """A definition of a HEAD operation on this path.""" - - patch: Operation | None = None - """A definition of a PATCH operation on this path.""" - - trace: Operation | None = None - """A definition of a TRACE operation on this path.""" - - servers: list[Server] | None = None - """An alternative ``server`` array to service all operations in this path.""" - - parameters: list[Parameter | Reference] | None = None - """A list of parameters that are applicable for all the operations described under this path. These parameters can - be overridden at the operation level, but cannot be removed there. The list MUST NOT include duplicated parameters. - A unique parameter is defined by a combination of a `name <https://spec.openapis.org/oas/v3.1.0#parameterName>`_ and - `location <https://spec.openapis.org/oas/v3.1.0#parameterIn>`_. The list can use the - `Reference Object <https://spec.openapis.org/oas/v3.1.0#referenceObject>`_ to link to parameters that are defined at - the `OpenAPI Object's components/parameters <https://spec.openapis.org/oas/v3.1.0#componentsParameters>`_. - """ diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/paths.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/paths.py deleted file mode 100644 index 682664e..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/paths.py +++ /dev/null @@ -1,27 +0,0 @@ -from __future__ import annotations - -from typing import TYPE_CHECKING, Dict - -if TYPE_CHECKING: - from litestar.openapi.spec import PathItem - -Paths = Dict[str, "PathItem"] -"""Holds the relative paths to the individual endpoints and their operations. The path is appended to the URL from the. - -`Server Object <https://spec.openapis.org/oas/v3.1.0#serverObject>`_ in order to construct the full URL. - -The Paths MAY be empty, due to -`Access Control List (ACL) constraints <https://spec.openapis.org/oas/v3.1.0#securityFiltering>`_. - -Patterned Fields - -/{path}: PathItem - -A relative path to an individual endpoint. The field name MUST begin with a forward slash (``/``). The path is -**appended** (no relative URL resolution) to the expanded URL from the -`Server Object <https://spec.openapis.org/oas/v3.1.0#serverObject>`_ 's ``url`` field in order to construct the full -URL. `Path templating <https://spec.openapis.org/oas/v3.1.0#pathTemplating>`_ is allowed. When matching URLs, concrete -(non-templated) paths would be matched before their templated counterparts. Templated paths with the same hierarchy but -different templated names MUST NOT exist as they are identical. In case of ambiguous matching, it's up to the tooling to -decide which one to use. -""" diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/reference.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/reference.py deleted file mode 100644 index 5ee2a95..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/reference.py +++ /dev/null @@ -1,38 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass - -from litestar.openapi.spec.base import BaseSchemaObject - -__all__ = ("Reference",) - - -@dataclass -class Reference(BaseSchemaObject): - """A simple object to allow referencing other components in the OpenAPI document, internally and externally. - - The ``$ref`` string value contains a URI `RFC3986 <https://tools.ietf.org/html/rfc3986>`_ , which identifies the - location of the value being referenced. - - See the rules for resolving `Relative References <https://spec.openapis.org/oas/v3.1.0#relativeReferencesURI>`_. - """ - - ref: str - """**REQUIRED**. The reference identifier. This MUST be in the form of a URI.""" - - summary: str | None = None - """A short summary which by default SHOULD override that of the referenced component. - - If the referenced object-type does not allow a ``summary`` field, then this field has no effect. - """ - - description: str | None = None - """A description which by default SHOULD override that of the referenced component. - - `CommonMark syntax <https://spec.commonmark.org/>`_ MAY be used for rich text representation. If the referenced - object-type does not allow a ``description`` field, then this field has no effect. - """ - - @property - def value(self) -> str: - return self.ref.split("/")[-1] diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/request_body.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/request_body.py deleted file mode 100644 index 5e4e195..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/request_body.py +++ /dev/null @@ -1,38 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass -from typing import TYPE_CHECKING - -from litestar.openapi.spec.base import BaseSchemaObject - -if TYPE_CHECKING: - from litestar.openapi.spec.media_type import OpenAPIMediaType - -__all__ = ("RequestBody",) - - -@dataclass -class RequestBody(BaseSchemaObject): - """Describes a single request body.""" - - content: dict[str, OpenAPIMediaType] - """ - **REQUIRED**. The content of the request body. - The key is a media type or `media type range <https://tools.ietf.org/html/rfc7231#appendix-D>`_ and the value - describes it. - - For requests that match multiple keys, only the most specific key is applicable. e.g. ``text/plain`` overrides - ``text/*`` - """ - - description: str | None = None - """A brief description of the request body. This could contain examples of use. - - `CommonMark syntax <https://spec.commonmark.org/>`_ MAY be used for rich text representation. - """ - - required: bool = False - """Determines if the request body is required in the request. - - Defaults to ``False``. - """ diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/response.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/response.py deleted file mode 100644 index 236bc40..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/response.py +++ /dev/null @@ -1,48 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass -from typing import TYPE_CHECKING - -from litestar.openapi.spec.base import BaseSchemaObject - -if TYPE_CHECKING: - from litestar.openapi.spec.header import OpenAPIHeader - from litestar.openapi.spec.link import Link - from litestar.openapi.spec.media_type import OpenAPIMediaType - from litestar.openapi.spec.reference import Reference - - -__all__ = ("OpenAPIResponse",) - - -@dataclass -class OpenAPIResponse(BaseSchemaObject): - """Describes a single response from an API Operation, including design-time, static ``links`` to operations based on - the response. - """ - - description: str - """**REQUIRED**. A short description of the response. - `CommonMark syntax <https://spec.commonmark.org/>`_ MAY be used for rich text representation. - """ - - headers: dict[str, OpenAPIHeader | Reference] | None = None - """Maps a header name to its definition. - `RFC7230 <https://tools.ietf.org/html/rfc7230#page-22>`_ states header names are case insensitive. - If a response header is defined with the name ``Content-Type``, it SHALL be ignored. - """ - - content: dict[str, OpenAPIMediaType] | None = None - """A map containing descriptions of potential response payloads. The key is a media type or - `media type range <https://tools.ietf.org/html/rfc7231#appendix-D>`_ and the value describes it. - - For responses that match multiple keys, only the most specific key is applicable. e.g. ``text/plain`` overrides - ``text/*`` - """ - - links: dict[str, Link | Reference] | None = None - """A map of operations links that can be followed from the response. - - The key of the map is a short name for the link, following the naming constraints of the names for - `Component Objects <https://spec.openapis.org/oas/v3.1.0#componentsObject>`_. - """ diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/responses.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/responses.py deleted file mode 100644 index 0cff680..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/responses.py +++ /dev/null @@ -1,44 +0,0 @@ -from __future__ import annotations - -from typing import TYPE_CHECKING, Dict, Union - -if TYPE_CHECKING: - from litestar.openapi.spec.reference import Reference - from litestar.openapi.spec.response import OpenAPIResponse - -Responses = Dict[str, Union["OpenAPIResponse", "Reference"]] -"""A container for the expected responses of an operation. The container maps a -HTTP response code to the expected response. - -The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in -advance. However, documentation is expected to cover a successful operation response and any known errors. - -The ``default`` MAY be used as a default response object for all HTTP codes hat are not covered individually by the -specification. - -The ``Responses Object`` MUST contain at least one response code, and it SHOULD be the response for a successful -operation call. - -Fixed Fields - -default: ``Optional[Union[Response, Reference]]`` - -The documentation of responses other than the ones declared for specific HTTP response codes. Use this field to cover -undeclared responses. A `Reference Object <https://spec.openapis.org/oas/v3.1.0#referenceObject>`_ can link to a -response that the `OpenAPI Object's components/responses <https://spec.openapis.org/oas/v3.1.0#componentsResponses>`_ -section defines. - -Patterned Fields -{httpStatusCode}: ``Optional[Union[Response, Reference]]`` - -Any `HTTP status code <https://spec.openapis.org/oas/v3.1.0#httpCodes>`_ can be used as the property name, but only one -property per code, to describe the expected response for that HTTP status code. - -A `Reference Object <https://spec.openapis.org/oas/v3.1.0#referenceObject>`_ can link to a response that is defined in -the `OpenAPI Object's components/responses <https://spec.openapis.org/oas/v3.1.0#componentsResponses>`_ section. This -field MUST be enclosed in quotation marks (for example, ``200``) for compatibility between JSON and YAML. To define a -range of response codes, this field MAY contain the uppercase wildcard character ``X``. For example, ``2XX`` represents -all response codes between ``[200-299]``. Only the following range definitions are allowed: ``1XX``, ``2XX``, ``3XX``, -``4XX``, and ``5XX``. If a response is defined using an explicit code, the explicit code definition takes precedence -over the range definition for that code. -""" diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/schema.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/schema.py deleted file mode 100644 index 4be2b7c..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/schema.py +++ /dev/null @@ -1,652 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass, fields, is_dataclass -from typing import TYPE_CHECKING, Any, Hashable, Mapping, Sequence - -from litestar.openapi.spec.base import BaseSchemaObject -from litestar.utils.predicates import is_non_string_sequence - -if TYPE_CHECKING: - from litestar.openapi.spec.discriminator import Discriminator - from litestar.openapi.spec.enums import OpenAPIFormat, OpenAPIType - from litestar.openapi.spec.external_documentation import ExternalDocumentation - from litestar.openapi.spec.reference import Reference - from litestar.openapi.spec.xml import XML - from litestar.types import DataclassProtocol - -__all__ = ("Schema", "SchemaDataContainer") - - -def _recursive_hash(value: Hashable | Sequence | Mapping | DataclassProtocol | type[DataclassProtocol]) -> int: - if isinstance(value, Mapping): - hash_value = 0 - for k, v in value.items(): - if k != "examples": - hash_value += hash(k) - hash_value += _recursive_hash(v) - return hash_value - if is_dataclass(value): - hash_value = hash(type(value).__name__) - for field in fields(value): - if field.name != "examples": - hash_value += hash(field.name) - hash_value += _recursive_hash(getattr(value, field.name, None)) - return hash_value - if is_non_string_sequence(value): - return sum(_recursive_hash(v) for v in value) - return hash(value) if isinstance(value, Hashable) else 0 - - -@dataclass -class Schema(BaseSchemaObject): - """The Schema Object allows the definition of input and output data types. These types can be objects, but also - primitives and arrays. This object is a superset of the - `JSON Schema Specification Draft 2020-12 <https://tools.ietf.org/html/draft-bhutton-json-schema-00>`_. - - For more information about the properties, see - `JSON Schema Core <https://tools.ietf.org/html/draft-wright-json-schema-00>`_ and - `JSON Schema Validation <https://tools.ietf.org/html/draft-wright-json-schema-validation-00>`_. - - Unless stated otherwise, the property definitions follow those of JSON Schema and do not add any additional - semantics. Where JSON Schema indicates that behavior is defined by the application (e.g. for annotations), OAS also - defers the definition of semantics to the application consuming the OpenAPI document. - - The following properties are taken directly from the - `JSON Schema Core <https://tools.ietf.org/html/draft-wright-json-schema-00>`_ and follow the same specifications. - """ - - all_of: Sequence[Reference | Schema] | None = None - """This keyword's value MUST be a non-empty array. Each item of the array MUST be a valid JSON Schema. - - An instance validates successfully against this keyword if it validates successfully against all schemas defined by - this keyword's value. - """ - - any_of: Sequence[Reference | Schema] | None = None - """This keyword's value MUST be a non-empty array. Each item of the array MUST be a valid JSON Schema. - - An instance validates successfully against this keyword if it validates successfully against at least one schema - defined by this keyword's value. Note that when annotations are being collected, all subschemas MUST be examined so - that annotations are collected from each subschema that validates successfully. - """ - - one_of: Sequence[Reference | Schema] | None = None - """This keyword's value MUST be a non-empty array. Each item of the array MUST be a valid JSON Schema. - - An instance validates successfully against this keyword if it validates successfully against exactly one schema - defined by this keyword's value. - """ - - schema_not: Reference | Schema | None = None - """This keyword's value MUST be a valid JSON Schema. - - An instance is valid against this keyword if it fails to validate successfully against the schema defined by this - keyword. - """ - - schema_if: Reference | Schema | None = None - """This keyword's value MUST be a valid JSON Schema. - - This validation outcome of this keyword's subschema has no direct effect on the overall validation result. Rather, - it controls which of the "then" or "else" keywords are evaluated. - - Instances that successfully validate against this keyword's subschema MUST also be valid against the subschema - value of the "then" keyword, if present. - - Instances that fail to validate against this keyword's subschema MUST also be valid against the subschema value of - the "else" keyword, if present. - - If annotations (Section 7.7) are being collected, they are collected rom this keyword's subschema in the usual way, - including when the keyword is present without either "then" or "else". - """ - - then: Reference | Schema | None = None - """This keyword's value MUST be a valid JSON Schema. - - When "if" is present, and the instance successfully validates against its subschema, then validation succeeds - against this keyword if the instance also successfully validates against this keyword's subschema. - - This keyword has no effect when "if" is absent, or when the instance fails to validate against its subschema. - Implementations MUST NOT evaluate the instance against this keyword, for either validation or annotation collection - purposes, in such cases. - """ - - schema_else: Reference | Schema | None = None - """This keyword's value MUST be a valid JSON Schema. - - When "if" is present, and the instance fails to validate against its subschema, then validation succeeds against - this keyword if the instance successfully validates against this keyword's subschema. - - This keyword has no effect when "if" is absent, or when the instance successfully validates against its subschema. - Implementations MUST NOT evaluate the instance against this keyword, for either validation or annotation collection - purposes, in such cases. - """ - - dependent_schemas: dict[str, Reference | Schema] | None = None - """This keyword specifies subschemas that are evaluated if the instance is - an object and contains a certain property. - - This keyword's value MUST be an object. Each value in the object MUST be a valid JSON Schema. - - If the object key is a property in the instance, the entire instance must validate against the subschema. Its use is - dependent on the presence of the property. - - Omitting this keyword has the same behavior as an empty object. - """ - - prefix_items: Sequence[Reference | Schema] | None = None - """The value of "prefixItems" MUST be a non-empty array of valid JSON Schemas. - - Validation succeeds if each element of the instance validates against the schema at the same position, if any. - This keyword does not constrain the length of the array. If the array is longer than this keyword's value, this - keyword validates only the prefix of matching length. - - This keyword produces an annotation value which is the largest index to which this keyword applied a subschema. - he value MAY be a boolean true if a subschema was applied to every index of the instance, such as is produced by the - "items" keyword. This annotation affects the behavior of "items" and "unevaluatedItems". - - Omitting this keyword has the same assertion behavior as an empty array. - """ - - items: Reference | Schema | None = None - """The value of "items" MUST be a valid JSON Schema. - - This keyword applies its subschema to all instance elements at indexes greater than the length of the "prefixItems" - array in the same schema object, as reported by the annotation result of that "prefixItems" keyword. If no such - annotation result exists, "items" applies its subschema to all instance array elements. [[CREF11: Note that the - behavior of "items" without "prefixItems" is identical to that of the schema form of "items" in prior drafts. When - "prefixItems" is present, the behavior of "items" is identical to the former "additionalItems" keyword. ]] - - If the "items" subschema is applied to any positions within the instance array, it produces an annotation result of - boolean true, indicating that all remaining array elements have been evaluated against this keyword's subschema. - - Omitting this keyword has the same assertion behavior as an empty schema. - - Implementations MAY choose to implement or optimize this keyword in another way that produces the same effect, such - as by directly checking for the presence and size of a "prefixItems" array. Implementations that do not support - annotation collection MUST do so. - """ - - contains: Reference | Schema | None = None - """The value of this keyword MUST be a valid JSON Schema. - - An array instance is valid against "contains" if at least one of its elements is valid against the given schema. - The subschema MUST be applied to every array element even after the first match has been found, in order to collect - annotations for use by other keywords. This is to ensure that all possible annotations are collected. - - Logically, the validation result of applying the value subschema to each item in the array MUST be ORed with - "false", resulting in an overall validation result. - - This keyword produces an annotation value which is an array of the indexes to which this keyword validates - successfully when applying its subschema, in ascending order. The value MAY be a boolean "true" if the subschema - validates successfully when applied to every index of the instance. The annotation MUST be present if the instance - array to which this keyword's schema applies is empty. - """ - - properties: dict[str, Reference | Schema] | None = None - """The value of "properties" MUST be an object. Each value of this object MUST be a valid JSON Schema. - - Validation succeeds if, for each name that appears in both the instance and as a name within this keyword's value, - the child instance for that name successfully validates against the corresponding schema. - - The annotation result of this keyword is the set of instance property names matched by this keyword. - - Omitting this keyword has the same assertion behavior as an empty object. - """ - - pattern_properties: dict[str, Reference | Schema] | None = None - """The value of "patternProperties" MUST be an object. Each property name of this object SHOULD be a valid - regular expression, according to the ECMA-262 regular expression dialect. Each property value of this object - MUST be a valid JSON Schema. - - Validation succeeds if, for each instance name that matches any regular expressions that appear as a property name - in this keyword's value, the child instance for that name successfully validates against each schema that - corresponds to a matching regular expression. - - The annotation result of this keyword is the set of instance property names matched by this keyword. - - Omitting this keyword has the same assertion behavior as an empty object. - """ - - additional_properties: Reference | Schema | bool | None = None - """The value of "additionalProperties" MUST be a valid JSON Schema. - - The behavior of this keyword depends on the presence and annotation results of "properties" and "patternProperties" - within the same schema object. Validation with "additionalProperties" applies only to the child values of instance - names that do not appear in the annotation results of either "properties" or "patternProperties". - - For all such properties, validation succeeds if the child instance validates against the "additionalProperties" - schema. - - The annotation result of this keyword is the set of instance property names validated by this keyword's subschema. - - Omitting this keyword has the same assertion behavior as an empty schema. - - Implementations MAY choose to implement or optimize this keyword in another way that produces the same effect, such - as by directly checking the names in "properties" and the patterns in "patternProperties" against the instance - property set. Implementations that do not support annotation collection MUST do so. - """ - - property_names: Reference | Schema | None = None - """The value of "propertyNames" MUST be a valid JSON Schema. - - If the instance is an object, this keyword validates if every property name in the instance validates against the - provided schema. Note the property name that the schema is testing will always be a string. - - Omitting this keyword has the same behavior as an empty schema. - """ - - unevaluated_items: Reference | Schema | None = None - """The value of "unevaluatedItems" MUST be a valid JSON Schema. - - The behavior of this keyword depends on the annotation results of adjacent keywords that apply to the instance - location being validated. Specifically, the annotations from "prefixItems" items", and "contains", which can come - from those keywords when they are adjacent to the "unevaluatedItems" keyword. Those three annotations, as well as - "unevaluatedItems", can also result from any and all adjacent in-place applicator (Section 10.2) keywords. This - includes but is not limited to the in-place applicators defined in this document. - - If no relevant annotations are present, the "unevaluatedItems" subschema MUST be applied to all locations in the - array. If a boolean true value is present from any of the relevant annotations, unevaluatedItems" MUST be ignored. - Otherwise, the subschema MUST be applied to any index greater than the largest annotation value for "prefixItems", - which does not appear in any annotation value for - "contains". - - This means that "prefixItems", "items", "contains", and all in-place applicators MUST be evaluated before this - keyword can be evaluated. Authors of extension keywords MUST NOT define an in-place applicator that would need to be - evaluated after this keyword. - - If the "unevaluatedItems" subschema is applied to any positions within the instance array, it produces an annotation - result of boolean true, analogous to the behavior of "items". - - Omitting this keyword has the same assertion behavior as an empty schema. - """ - - unevaluated_properties: Reference | Schema | None = None - """The value of "unevaluatedProperties" MUST be a valid JSON Schema. - - The behavior of this keyword depends on the annotation results of adjacent keywords that apply to the instance - location being validated. Specifically, the annotations from "properties", "patternProperties", and - "additionalProperties", which can come from those keywords when they are adjacent to the "unevaluatedProperties" - keyword. Those three annotations, as well as "unevaluatedProperties", can also result from any and all adjacent - in-place applicator (Section 10.2) keywords. This includes but is not limited to the in-place applicators defined - in this document. - - Validation with "unevaluatedProperties" applies only to the child values of instance names that do not appear in - the "properties", "patternProperties", "additionalProperties", or "unevaluatedProperties" annotation results that - apply to the instance location being validated. - - For all such properties, validation succeeds if the child instance validates against the "unevaluatedProperties" - schema. - - This means that "properties", "patternProperties", "additionalProperties", and all in-place applicators MUST be - evaluated before this keyword can be evaluated. Authors of extension keywords MUST NOT define an in-place - applicator that would need to be evaluated after this keyword. - - The annotation result of this keyword is the set of instance property names validated by this keyword's subschema. - - Omitting this keyword has the same assertion behavior as an empty schema. - - The following properties are taken directly from the - `JSON Schema Validation <https://tools.ietf.org/html/draft-wright-json-schema-validation-00>`_ and follow the same - specifications: - """ - - type: OpenAPIType | Sequence[OpenAPIType] | None = None - """The value of this keyword MUST be either a string or an array. If it is an array, elements of the array MUST be - strings and MUST be unique. - - String values MUST be one of the six primitive types (``"null"``, ``"boolean"``, ``"object"``, ``"array"``, - ``"number"``, and ``"string"``), or ``"integer"`` which matches any number with a zero fractional part. - - An instance validates if and only if the instance is in any of the sets listed for this keyword. - """ - - enum: Sequence[Any] | None = None - """The value of this keyword MUST be an array. This array SHOULD have at least one element. Elements in the array - SHOULD be unique. - - An instance validates successfully against this keyword if its value is equal to one of the elements in this - keyword's array value. - - Elements in the array might be of any type, including null. - """ - - const: Any | None = None - """The value of this keyword MAY be of any type, including null. - - Use of this keyword is functionally equivalent to an "enum" (Section 6.1.2) with a single value. - - An instance validates successfully against this keyword if its value is equal to the value of the keyword. - """ - - multiple_of: float | None = None - """The value of "multipleOf" MUST be a number, strictly greater than 0. - - A numeric instance is only valid if division by this keyword's value results in an integer. - """ - - maximum: float | None = None - """The value of "maximum" MUST be a number, representing an inclusive upper limit for a numeric instance. - - If the instance is a number, then this keyword validates only if the instance is less than or exactly equal to - "maximum". - """ - - exclusive_maximum: float | None = None - """The value of "exclusiveMaximum" MUST be a number, representing an exclusive upper limit for a numeric instance. - - If the instance is a number, then the instance is valid only if it has a value strictly less than (not equal to) - "exclusiveMaximum". - """ - - minimum: float | None = None - """The value of "minimum" MUST be a number, representing an inclusive lower limit for a numeric instance. - - If the instance is a number, then this keyword validates only if the instance is greater than or exactly equal to - "minimum". - """ - - exclusive_minimum: float | None = None - """The value of "exclusiveMinimum" MUST be a number, representing an exclusive lower limit for a numeric instance. - - If the instance is a number, then the instance is valid only if it has a value strictly greater than (not equal to) - "exclusiveMinimum". - """ - - max_length: int | None = None - """The value of this keyword MUST be a non-negative integer. - - A string instance is valid against this keyword if its length is less than, or equal to, the value of this keyword. - - The length of a string instance is defined as the number of its characters as defined by :rfc:`8259`. - """ - - min_length: int | None = None - """The value of this keyword MUST be a non-negative integer. - - A string instance is valid against this keyword if its length is greater than, or equal to, the value of this - keyword. - - The length of a string instance is defined as the number of its characters as defined by :rfc:`8259`. - - Omitting this keyword has the same behavior as a value of 0. - """ - - pattern: str | None = None - """The value of this keyword MUST be a string. This string SHOULD be a valid regular expression, according to the - ECMA-262 regular expression dialect. - - A string instance is considered valid if the regular expression matches the instance successfully. Recall: regular - expressions are not implicitly anchored. - """ - - max_items: int | None = None - """The value of this keyword MUST be a non-negative integer. - - An array instance is valid against "maxItems" if its size is less than, or equal to, the value of this keyword. - """ - - min_items: int | None = None - """The value of this keyword MUST be a non-negative integer. - - An array instance is valid against "minItems" if its size is greater than, or equal to, the value of this keyword. - - Omitting this keyword has the same behavior as a value of 0. - """ - - unique_items: bool | None = None - """The value of this keyword MUST be a boolean. - - If this keyword has boolean value false, the instance validates successfully. If it has boolean value true, the - instance validates successfully if all of its elements are unique. - - Omitting this keyword has the same behavior as a value of false. - """ - - max_contains: int | None = None - """The value of this keyword MUST be a non-negative integer. - - If "contains" is not present within the same schema object, then this keyword has no effect. - - An instance array is valid against "maxContains" in two ways, depending on the form of the annotation result of an - adjacent "contains" [json-schema] keyword. The first way is if the annotation result is an array and the length of - that array is less than or equal to the "maxContains" value. The second way is if the annotation result is a - boolean "true" and the instance array length is less than r equal to the "maxContains" value. - """ - - min_contains: int | None = None - """The value of this keyword MUST be a non-negative integer. - - If "contains" is not present within the same schema object, then this keyword has no effect. - - An instance array is valid against "minContains" in two ways, depending on the form of the annotation result of an - adjacent "contains" [json-schema] keyword. The first way is if the annotation result is an array and the length of - that array is greater than or equal to the "minContains" value. The second way is if the annotation result is a - boolean "true" and the instance array length is greater than or equal to the "minContains" value. - - A value of 0 is allowed, but is only useful for setting a range of occurrences from 0 to the value of "maxContains". - A value of 0 with no "maxContains" causes "contains" to always pass validation. - - Omitting this keyword has the same behavior as a value of 1. - """ - - max_properties: int | None = None - """The value of this keyword MUST be a non-negative integer. - - An object instance is valid against "maxProperties" if its number of properties is less than, or equal to, the value - of this keyword. - """ - - min_properties: int | None = None - """The value of this keyword MUST be a non-negative integer. - - An object instance is valid against "minProperties" if its number of properties is greater than, or equal to, the - value of this keyword. - - Omitting this keyword has the same behavior as a value of 0. - """ - - required: Sequence[str] | None = None - """The value of this keyword MUST be an array. Elements of this array, if any, MUST be strings, and MUST be unique. - - An object instance is valid against this keyword if every item in the rray is the name of a property in the instance. - - Omitting this keyword has the same behavior as an empty array. - """ - - dependent_required: dict[str, Sequence[str]] | None = None - """The value of this keyword MUST be an object. Properties in this object, f any, MUST be arrays. Elements in each - array, if any, MUST be strings, and MUST be unique. - - This keyword specifies properties that are required if a specific other property is present. Their requirement is - dependent on the presence of the other property. - - Validation succeeds if, for each name that appears in both the instance and as a name within this keyword's value, - every item in the corresponding array is also the name of a property in the instance. - - Omitting this keyword has the same behavior as an empty object. - """ - - format: OpenAPIFormat | None = None - """From OpenAPI: - - See `Data Type Formats <https://spec.openapis.org/oas/v3.1.0#dataTypeFormat>`_ for further details. While relying on - JSON Schema's defined formats, the OAS offers a few additional predefined formats. - - From JSON Schema: - - Structural validation alone may be insufficient to allow an application to correctly utilize certain values. - The "format" annotation keyword is defined to allow schema authors to convey semantic information for a fixed subset - of values which are accurately described by authoritative resources, be they RFCs or other external specifications. - - The value of this keyword is called a format attribute. It MUST be a string. A format attribute can generally only - validate a given set of instance types. If the type of the instance to validate is not in this set, validation for - this format attribute and instance SHOULD succeed. All format attributes defined in this section apply to strings, - but a format attribute can be specified to apply to any instance types defined in the data model defined in the core - JSON Schema. [json-schema] [[CREF1: Note that the "type" keyword in this specification defines an "integer" type - which is not part of the data model. Therefore a format attribute can be limited to numbers, but not specifically to - integers. However, a numeric format can be used alongside the "type" keyword with a value of "integer", or could be - explicitly defined to always pass if the number is not an integer, which produces essentially the same behavior as - only applying to integers. ]] - """ - - content_encoding: str | None = None - """If the instance value is a string, this property defines that the string SHOULD be interpreted as binary data and - decoded using the encoding named by this property. - - Possible values indicating base 16, 32, and 64 encodings with several variations are listed in :rfc:`4648`. - Additionally, sections 6.7 and 6.8 of :rfc:`2045` provide encodings used in MIME. As "base64" is defined in both - RFCs, the definition from :rfc:`4648` SHOULD be assumed unless the string is specifically intended for use in a - MIME context. Note that all of these encodings result in strings consisting only of 7-bit ASCII characters. - therefore, this keyword has no meaning for strings containing characters outside of that range. - - If this keyword is absent, but "contentMediaType" is present, this indicates that the encoding is the identity - encoding, meaning that no transformation was needed in order to represent the content in a UTF-8 string. - """ - - content_media_type: str | None = None - """If the instance is a string, this property indicates the media type of the contents of the string. If - "contentEncoding" is present, this property describes the decoded string. - - The value of this property MUST be a string, which MUST be a media type, as defined by :rfc:`2046` - """ - - content_schema: Reference | Schema | None = None - """If the instance is a string, and if "contentMediaType" is present, this property contains a schema which - describes the structure of the string. - - This keyword MAY be used with any media type that can be mapped into JSON Schema's data model. - - The value of this property MUST be a valid JSON schema. It SHOULD be ignored if "contentMediaType" is not present. - """ - - title: str | None = None - """The value of "title" MUST be a string. - - The title can be used to decorate a user interface with information about the data produced by this user interface. - A title will preferably be short. - """ - - description: str | None = None - """From OpenAPI: - - `CommonMark syntax <https://spec.commonmark.org/>`_ MAY be used for rich text representation. - - From JSON Schema: - The value "description" MUST be a string. - - The description can be used to decorate a user interface with information about the data produced by this user - interface. A description will provide explanation about the purpose of the instance described by this schema. - """ - - default: Any | None = None - """There are no restrictions placed on the value of this keyword. When multiple occurrences of this keyword are - applicable to a single sub-instance, implementations SHOULD remove duplicates. - - This keyword can be used to supply a default JSON value associated with a particular schema. It is RECOMMENDED that - a default value be valid against the associated schema. - """ - - deprecated: bool | None = None - """The value of this keyword MUST be a boolean. When multiple occurrences of this keyword are applicable to a - single sub-instance, applications SHOULD consider the instance location to be deprecated if any occurrence specifies - a true value. - - If "deprecated" has a value of boolean true, it indicates that applications SHOULD refrain from usage of the - declared property. It MAY mean the property is going to be removed in the future. - - A root schema containing "deprecated" with a value of true indicates that the entire resource being described MAY be - removed in the future. - - The "deprecated" keyword applies to each instance location to which the schema object containing the keyword - successfully applies. This can result in scenarios where every array item or object property is deprecated even - though the containing array or object is not. - - Omitting this keyword has the same behavior as a value of false. - """ - - read_only: bool | None = None - """The value of "readOnly" MUST be a boolean. When multiple occurrences of this keyword are applicable to a single - sub-instance, the resulting behavior SHOULD be as for a true value if any occurrence specifies a true value, and - SHOULD be as for a false value otherwise. - - If "readOnly" has a value of boolean true, it indicates that the value of the instance is managed exclusively by - the owning authority, and attempts by an application to modify the value of this property are expected to be ignored - or rejected by that owning authority. - - An instance document that is marked as "readOnly" for the entire document MAY be ignored if sent to the owning - authority, or MAY result in an error, at the authority's discretion. - - For example, "readOnly" would be used to mark a database-generated serial number as read-only, while "writeOnly" - would be used to mark a password input field. - - This keyword can be used to assist in user interface instance generation. In particular, an application MAY choose - to use a widget that hides input values as they are typed for write-only fields. - - Omitting these keywords has the same behavior as values of false. - """ - - write_only: bool | None = None - """The value of "writeOnly" MUST be a boolean. When multiple occurrences of this keyword are applicable to a - single sub-instance, the resulting behavior SHOULD be as for a true value if any occurrence specifies a true value, - and SHOULD be as for a false value otherwise. - - If "writeOnly" has a value of boolean true, it indicates that the value is never present when the instance is - retrieved from the owning authority. It can be present when sent to the owning authority to update or create the - document (or the resource it represents), but it will not be included in any updated or newly created version of the - instance. - - An instance document that is marked as "writeOnly" for the entire document MAY be returned as a blank document of - some sort, or MAY produce an error upon retrieval, or have the retrieval request ignored, at the authority's - discretion. - - For example, "readOnly" would be used to mark a database-generated serial number as read-only, while "writeOnly" - would be used to mark a password input field. - - This keyword can be used to assist in user interface instance generation. In particular, an application MAY choose - to use a widget that hides input values as they are typed for write-only fields. - - Omitting these keywords has the same behavior as values of false. - """ - - examples: list[Any] | None = None - """The value of this must be an array containing the example values.""" - - discriminator: Discriminator | None = None - """Adds support for polymorphism. - - The discriminator is an object name that is used to differentiate between other schemas which may satisfy the - payload description. See `Composition and Inheritance <https://spec.openapis.org/oas/v3.1.0#schemaComposition>`_ - for more details. - """ - - xml: XML | None = None - """This MAY be used only on properties schemas. - - It has no effect on root schemas. Adds additional metadata to describe the XML representation of this property. - """ - - external_docs: ExternalDocumentation | None = None - """Additional external documentation for this schema.""" - - example: Any | None = None - """A free-form property to include an example of an instance for this schema. To represent examples that cannot be - naturally represented in JSON or YAML, a string value can be used to contain the example with escaping where - necessary. - - Deprecated: The example property has been deprecated in favor of the JSON Schema examples keyword. Use of example is - discouraged, and later versions of this specification may remove it. - """ - - def __hash__(self) -> int: - return _recursive_hash(self) - - -@dataclass -class SchemaDataContainer(Schema): - """Special class that allows using python data containers, e.g. dataclasses or pydantic models, to represent a - schema - """ - - data_container: Any = None - """A data container instance that will be used to generate the schema.""" diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/security_requirement.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/security_requirement.py deleted file mode 100644 index e3d1394..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/security_requirement.py +++ /dev/null @@ -1,30 +0,0 @@ -from __future__ import annotations - -from typing import Dict, List - -SecurityRequirement = Dict[str, List[str]] -"""Lists the required security schemes to execute this operation. The name used for each property MUST correspond to a -security scheme declared in the. - -`Security Schemes <https://spec.openapis.org/oas/v3.1.0#componentsSecuritySchemes>`_ under the -`Components Object <https://spec.openapis.org/oas/v3.1.0#componentsObject>`_. - -Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to -be authorized. This enables support for scenarios where multiple query parameters or HTTP headers are required to convey -security information. - -When a list of Security Requirement Objects is defined on the -`OpenAPI Object <https://spec.openapis.org/oas/v3.1.0#oasObject>`_ or -`Operation Object <https://spec.openapis.org/oas/v3.1.0#operationObject>`_, only one of the Security Requirement -Objects in the list needs to be satisfied to authorize the request. - -Patterned Fields - -{name}: ``List[str]`` -Each name MUST correspond to a security scheme which is declared -in the `Security Schemes <https://spec.openapis.org/oas/v3.1.0#componentsSecuritySchemes>`_ under the -`Components Object <https://spec.openapis.org/oas/v3.1.0#componentsObject>`_. if the security scheme is of type -``"oauth2"`` or ``"openIdConnect"``, then the value is a list of scope names required for the execution, and the list -MAY be empty if authorization does not require a specified scope. For other security scheme types, the array MAY contain -a list of role names which are required for the execution,but are not otherwise defined or exchanged in-band. -""" diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/security_scheme.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/security_scheme.py deleted file mode 100644 index badc77e..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/security_scheme.py +++ /dev/null @@ -1,69 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass -from typing import TYPE_CHECKING, Literal - -from litestar.openapi.spec.base import BaseSchemaObject - -if TYPE_CHECKING: - from litestar.openapi.spec.oauth_flows import OAuthFlows - -__all__ = ("SecurityScheme",) - - -@dataclass -class SecurityScheme(BaseSchemaObject): - """Defines a security scheme that can be used by the operations. - - Supported schemes are HTTP authentication, an API key (either as a header, a cookie parameter or as a query - parameter), mutual TLS (use of a client certificate), OAuth2's common flows (implicit, password, client credentials - and authorization code) as defined in :rfc`6749`, and - `OpenID Connect Discovery <https://tools.ietf.org/html/draft-ietf-oauth-discovery-06>`_. - - Please note that as of 2020, the implicit flow is about to be deprecated by - `OAuth 2.0 Security Best Current Practice <https://tools.ietf.org/html/draft-ietf-oauth-security-topics>`_. - Recommended for most use case is Authorization Code Grant flow with PKCE. - """ - - type: Literal["apiKey", "http", "mutualTLS", "oauth2", "openIdConnect"] - """**REQUIRED**. The type of the security scheme.""" - - description: str | None = None - """A description for security scheme. - - `CommonMark syntax <https://spec.commonmark.org/>`_ MAY be used for rich text representation. - """ - - name: str | None = None - """ - **REQUIRED** for ``apiKey``. The name of the header, query or cookie parameter to be used. - """ - - security_scheme_in: Literal["query", "header", "cookie"] | None = None - """ - **REQUIRED** for ``apiKey``. The location of the API key. - """ - - scheme: str | None = None - """ - **REQUIRED** for ``http``. The name of the HTTP Authorization scheme to be used in the - authorization header as defined in :rfc:`7235`. - - The values used SHOULD be registered in the - `IANA Authentication Scheme registry <https://www.iana.org/assignments/http-authschemes/http-authschemes.xhtml>`_ - """ - - bearer_format: str | None = None - """A hint to the client to identify how the bearer token is formatted. - - Bearer tokens are usually generated by an authorization server, so this information is primarily for documentation - purposes. - """ - - flows: OAuthFlows | None = None - """**REQUIRED** for ``oauth2``. An object containing configuration information for the flow types supported.""" - - open_id_connect_url: str | None = None - """**REQUIRED** for ``openIdConnect``. OpenId Connect URL to discover OAuth2 configuration values. This MUST be in - the form of a URL. The OpenID Connect standard requires the use of TLS. - """ diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/server.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/server.py deleted file mode 100644 index 2c12fcf..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/server.py +++ /dev/null @@ -1,34 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass -from typing import TYPE_CHECKING - -from litestar.openapi.spec.base import BaseSchemaObject - -if TYPE_CHECKING: - from litestar.openapi.spec.server_variable import ServerVariable - -__all__ = ("Server",) - - -@dataclass -class Server(BaseSchemaObject): - """An object representing a Server.""" - - url: str - """ - **REQUIRED**. A URL to the target host. - - This URL supports Server Variables and MAY be relative, to indicate that the host location is relative to the - location where the OpenAPI document is being served. Variable substitutions will be made when a variable is named in - ``{brackets}``. - """ - - description: str | None = None - """An optional string describing the host designated by the URL. - - `CommonMark syntax <https://spec.commonmark.org/>`_ MAY be used for rich text representation. - """ - - variables: dict[str, ServerVariable] | None = None - """A map between a variable name and its value. The value is used for substitution in the server's URL template.""" diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/server_variable.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/server_variable.py deleted file mode 100644 index c59c542..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/server_variable.py +++ /dev/null @@ -1,32 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass - -from litestar.openapi.spec.base import BaseSchemaObject - -__all__ = ("ServerVariable",) - - -@dataclass -class ServerVariable(BaseSchemaObject): - """An object representing a Server Variable for server URL template substitution.""" - - default: str - """**REQUIRED**. The default value to use for substitution, which SHALL be sent if an alternate value is _not_ - supplied. Note this behavior is different than the - `Schema Object's <https://spec.openapis.org/oas/v3.1.0#schemaObject>`_ treatment of default values, because in those - cases parameter values are optional. If the `enum <https://spec.openapis.org/oas/v3.1.0#serverVariableEnum>`_ is - defined, the value MUST exist in the enum's values. - """ - - enum: list[str] | None = None - """An enumeration of string values to be used if the substitution options are from a limited set. - - The array SHOULD NOT be empty. - """ - - description: str | None = None - """An optional description for the server variable. - - `CommonMark syntax <https://spec.commonmark.org/>`_ MAY be used for rich text representation. - """ diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/tag.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/tag.py deleted file mode 100644 index c3e6374..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/tag.py +++ /dev/null @@ -1,32 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass -from typing import TYPE_CHECKING - -from litestar.openapi.spec.base import BaseSchemaObject - -if TYPE_CHECKING: - from litestar.openapi.spec.external_documentation import ExternalDocumentation - -__all__ = ("Tag",) - - -@dataclass -class Tag(BaseSchemaObject): - """Adds metadata to a single tag that is used by the - `Operation Object <https://spec.openapis.org/oas/v3.1.0#operationObject>`_. - - It is not mandatory to have a Tag Object per tag defined in the Operation Object instances. - """ - - name: str - """**REQUIRED**. The name of the tag.""" - - description: str | None = None - """A short description for the tag. - - `CommonMark syntax <https://spec.commonmark.org/>`_ MAY be used for rich text representation. - """ - - external_docs: ExternalDocumentation | None = None - """Additional external documentation for this tag.""" diff --git a/venv/lib/python3.11/site-packages/litestar/openapi/spec/xml.py b/venv/lib/python3.11/site-packages/litestar/openapi/spec/xml.py deleted file mode 100644 index 6030998..0000000 --- a/venv/lib/python3.11/site-packages/litestar/openapi/spec/xml.py +++ /dev/null @@ -1,44 +0,0 @@ -from __future__ import annotations - -from dataclasses import dataclass - -from litestar.openapi.spec.base import BaseSchemaObject - -__all__ = ("XML",) - - -@dataclass() -class XML(BaseSchemaObject): - """A metadata object that allows for more fine-tuned XML model definitions. - - When using arrays, XML element names are *not* inferred (for singular/plural forms) and the ``name`` property SHOULD - be used to add that information. See examples for expected behavior. - """ - - name: str | None = None - """ - Replaces the name of the element/attribute used for the described schema property. When defined within ``items``, it - will affect the name of the individual XML elements within the list. When defined alongside ``type`` being ``array`` - (outside the ``items``), it will affect the wrapping element and only if ``wrapped`` is ``True``. If ``wrapped`` is - ``False``, it will be ignored. - """ - - namespace: str | None = None - """The URI of the namespace definition. Value MUST be in the form of an absolute URI.""" - - prefix: str | None = None - """The prefix to be used for the - `xmlName <https://spec.openapis.org/oas/v3.1.0#xmlName>`_ - """ - - attribute: bool = False - """Declares whether the property definition translates to an attribute instead of an element. Default value is - ``False``. - """ - - wrapped: bool = False - """ - MAY be used only for an array definition. Signifies whether the array is wrapped (for example, - ``<books><book/><book/></books>``) or unwrapped (``<book/><book/>``). Default value is ``False``. The definition - takes effect only when defined alongside ``type`` being ``array`` (outside the ``items``). - """ |