o "i@sddlmZddlmZmZmZmZmZmZm Z ddl m Z ddl m Z er2ddlmZddlmZeeefZGddde dZGd d d e d ZGd d d e d ZGd dde dZGddde dZdS))abstractmethod) TYPE_CHECKINGAnyDictListOptionalTypeUnion)OpenApiGeneratorExtension) Direction)APIView) AutoSchemac @seZdZUdZgZeeded<ee ee fed<dddee e ee fee e ee fffddZ e dddeeeeffd d Zd S) OpenApiAuthenticationExtensionaC Extension for specifying authentication schemes. The common use-case usually consists of setting a ``name`` string and returning a dict from ``get_security_definition``. To model a group of headers that go together, set a list of names and return a corresponding list of definitions from ``get_security_definition``. The view class is available via ``auto_schema.view``, while the original authentication class can be accessed via ``self.target``. If you want to override an included extension, be sure to set a higher matching priority by setting the class attribute ``priority = 1`` or higher. get_security_requirement is expected to return a dict with security object names as keys and a scope list as value (usually just []). More than one key in the dict means that each entry is required (AND). If you need alternate variations (OR), return a list of those dicts instead. ``get_security_definition()`` is expected to return a valid `OpenAPI security scheme object `_ _registryname auto_schemar returncCs4|jsJdt|jtr|jgiSdd|jDS)Nzname(s) must be specifiedcSsi|]}|gqSr).0rrr_/var/www/html/crm_dreinet/venv_linux/lib/python3.10/site-packages/drf_spectacular/extensions.py .szKOpenApiAuthenticationExtension.get_security_requirement..)r isinstancestrselfrrrrget_security_requirement's  z7OpenApiAuthenticationExtension.get_security_requirementcCdSNrrrrrget_security_definition0z6OpenApiAuthenticationExtension.get_security_definitionN)__name__ __module__ __qualname____doc__rrr__annotations__r rrrrr _SchemaTyperrrrrrs &  $rc@sleZdZUdZgZeeded<dddede e fddZ dddede fd d Z dddedefd d Zd S)OpenApiSerializerExtensiona Extension for replacing an insufficient or specifying an unknown Serializer schema. The existing implementation of ``map_serializer()`` will generate the same result as *drf-spectacular* would. Either augment or replace the generated schema. The view instance is available via ``auto_schema.view``, while the original serializer can be accessed via ``self.target``. ``map_serializer()`` is expected to return a valid `OpenAPI schema object `_. rrr directionrcCdS)z3 return str for overriding default name extraction Nrrrr'rrrget_nameCrz#OpenApiSerializerExtension.get_namecCr()zQ return anything to compare instances of target. Target will be used by default. Nrr)rrr get_identityGrz'OpenApiSerializerExtension.get_identitycCs|j|j|ddS)z, override for customized serializer mapping T)bypass_extensions)_map_serializer target_classr)rrrmap_serializerKsz)OpenApiSerializerExtension.map_serializerN)r r!r"r#rrrr$r rrr*rr+r%r/rrrrr&5s  r&c@sReZdZUdZgZeeded<dee fddZ e ddde de fd d Zd S) OpenApiSerializerFieldExtensiona< Extension for replacing an insufficient or specifying an unknown SerializerField schema. To augment the default schema, you can get what *drf-spectacular* would generate with ``auto_schema._map_serializer_field(self.target, direction, bypass_extensions=True)``. and edit the returned schema at your discretion. Beware that this may still emit warnings, in which case manual construction is advisable. ``map_serializer_field()`` is expected to return a valid `OpenAPI schema object `_. rrcCr()zH return str for breaking out field schema into separate named component Nrrrrrr*^rz(OpenApiSerializerFieldExtension.get_namerr r'cCr()z2 override for customized serializer field mapping Nrr)rrrmap_serializer_fieldbsz4OpenApiSerializerFieldExtension.map_serializer_fieldN)r r!r"r#rrrr$rrr*rr r%r2rrrrr0Ps  r0csHeZdZUdZgZeeded<efddZ e d ddZ Z S) OpenApiViewExtensionaF Extension for replacing discovered views with a more schema-appropriate/annotated version. ``view_replacement()`` is expected to return a subclass of ``APIView`` (which includes ``ViewSet`` et al.). The discovered original view instance can be accessed with ``self.target`` and be subclassed if desired. rcs(tt|jdr|jj|_dSdS)Ncls)super _load_classhasattrr.r4)r4 __class__rrr6rs  z OpenApiViewExtension._load_classr Type[APIView]cCrrrr1rrrview_replacementyrz%OpenApiViewExtension.view_replacement)rr:) r r!r"r#rrrr$ classmethodr6rr; __classcell__rrr8rr3hs r3c@s@eZdZUdZgZeeded<edddee fddZ dS) OpenApiFilterExtensiona. Extension for specifying a list of filter parameters for a given ``FilterBackend``. The original filter class object can be accessed via ``self.target``. The attached view is accessible via ``auto_schema.view``. ``get_schema_operation_parameters()`` is expected to return either an empty list or a list of valid raw `OpenAPI parameter objects `_. Using ``drf_spectacular.plumbing.build_parameter_type`` is recommended to generate the appropriate raw dict objects. rrr rcOrrr)rrargskwargsrrrget_schema_operation_parametersrz6OpenApiFilterExtension.get_schema_operation_parametersN) r r!r"r#rrrr$rr%rArrrrr>~s  r>N)abcrtypingrrrrrrr drf_spectacular.plumbingr drf_spectacular.utilsr rest_framework.viewsr drf_spectacular.openapir rr%rr&r0r3r>rrrrs $     %