Source code for apispec.plugin

"""Base class for Plugin classes."""

from __future__ import annotations

import typing

from .core import APISpec
from .exceptions import PluginMethodNotImplementedError


[docs] class BasePlugin: """Base class for APISpec plugin classes."""
[docs] def init_spec(self, spec: APISpec) -> None: """Initialize plugin with APISpec object :param APISpec spec: APISpec object this plugin instance is attached to """
[docs] def schema_helper( self, name: str, definition: dict, **kwargs: typing.Any ) -> dict | None: """May return definition as a dict. :param str name: Identifier by which schema may be referenced :param dict definition: Schema definition :param kwargs: All additional keywords arguments sent to `APISpec.schema()` """ raise PluginMethodNotImplementedError
[docs] def response_helper(self, response: dict, **kwargs: typing.Any) -> dict | None: """May return response component description as a dict. :param dict response: Response fields :param kwargs: All additional keywords arguments sent to `APISpec.response()` """ raise PluginMethodNotImplementedError
[docs] def parameter_helper(self, parameter: dict, **kwargs: typing.Any) -> dict | None: """May return parameter component description as a dict. :param dict parameter: Parameter fields :param kwargs: All additional keywords arguments sent to `APISpec.parameter()` """ raise PluginMethodNotImplementedError
[docs] def header_helper(self, header: dict, **kwargs: typing.Any) -> dict | None: """May return header component description as a dict. :param dict header: Header fields :param kwargs: All additional keywords arguments sent to `APISpec.header()` """ raise PluginMethodNotImplementedError
[docs] def path_helper( self, path: str | None = None, operations: dict | None = None, parameters: list[dict] | None = None, **kwargs: typing.Any, ) -> str | None: """May return a path as string and mutate operations dict and parameters list. :param str path: Path to the resource :param dict operations: A `dict` mapping HTTP methods to operation object. See https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#operationObject :param list parameters: A `list` of parameters objects or references for the path. See https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#parameterObject and https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#referenceObject :param kwargs: All additional keywords arguments sent to `APISpec.path()` Return value should be a string or None. If a string is returned, it is set as the path. The last path helper returning a string sets the path value. Therefore, the order of plugin registration matters. However, generally, registering several plugins that return a path does not make sense. """ raise PluginMethodNotImplementedError
[docs] def operation_helper( self, path: str | None = None, operations: dict | None = None, **kwargs: typing.Any, ) -> None: """May mutate operations. :param str path: Path to the resource :param dict operations: A `dict` mapping HTTP methods to operation object. See https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#operationObject :param kwargs: All additional keywords arguments sent to `APISpec.path()` """ raise PluginMethodNotImplementedError