@|hHdZddlmZddlZddlmZddlmZGddZy) zBase class for Plugin classes.) annotationsN)APISpecPluginMethodNotImplementedErrorceZdZdZd dZ d dZd dZd dZddZ d ddZ d dd Z y) BasePluginz&Base class for APISpec plugin classes.cy)zInitialize plugin with APISpec object :param APISpec spec: APISpec object this plugin instance is attached to N)selfspecs M/var/www/html/test/engine/venv/lib/python3.12/site-packages/apispec/plugin.py init_speczBasePlugin.init_specsc t)zMay 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()` r)r name definitionkwargss r schema_helperzBasePlugin.schema_helpers .-rc t)zMay return response component description as a dict. :param dict response: Response fields :param kwargs: All additional keywords arguments sent to `APISpec.response()` r)r responsers rresponse_helperzBasePlugin.response_helper .-rc t)zMay return parameter component description as a dict. :param dict parameter: Parameter fields :param kwargs: All additional keywords arguments sent to `APISpec.parameter()` r)r parameterrs rparameter_helperzBasePlugin.parameter_helper'rrc t)zMay return header component description as a dict. :param dict header: Header fields :param kwargs: All additional keywords arguments sent to `APISpec.header()` r)r headerrs r header_helperzBasePlugin.header_helper/rrNc t)aMay 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. r)r path operations parametersrs r path_helperzBasePlugin.path_helper7s 0.-rc t)a^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()` r)r r!r"rs roperation_helperzBasePlugin.operation_helperQs .-r)r rreturnNone)rstrrdictr typing.Anyr' dict | None)rr*rr+r'r,)rr*rr+r'r,)rr*rr+r'r,)NNN) r! str | Noner"r,r#zlist[dict] | Nonerr+r'r-)NN)r!r-r"r,rr+r'r() __name__ __module__ __qualname____doc__rrrrrr$r&r rrr r s0 . .%) .5? .  .... "&(, .. .& .  .  .8 "& . .  . .  .rr ) r1 __future__rtypingcorer exceptionsrr r rrr6s $" 7S.S.r