a ΝGd@sddlZddlZddlZddlZddlZddlZddlZddlmZddl m Z ddl m Z ddlm ZddlmZddlmZddlmZdd lmZd d lmZd d lmZd d lmZmZmZm Z m!Z!ddl"m#Z#m$Z$m%Z%m&Z&e'djZ(e)e*Z+Gddde%Z,Gddde,Z-ddZ.ddZ/d\ddZ0ddZ1ddZ2Gdd d e#Z3d!d"Z4ej5ej6ej7fZ8ej9e8d#ej:fej;e8d$ejd%ej:fej?ej>d&ejejHdffgZ]ejTejVd-Z^ej_ejHej`ffejWejHejXffejaejHejbffejSejHd.d/ffej[ejHej\ffejcejHdffej>ejHdffejJejKdffej5ejFdffej6ejRdffej7eDejPffejQejHdffejNejHejOffejLejHejMffejdejHdffgZeefe(efd0kre]gejhejKdffeegejhejKdffeee]Zid1d2Zjd3d4Zkd5d6Zld7d8ZmenejKdffeoejFdffepejHdffeqejRdfferejsdffe ekejPffejtejHej\ffejejHejMffejuejHejOffg Zvewed9rejxZynd:d;Zydd?Z}d@dAZ~GdBdCdCe#ZGdDdEdEe#ZGdFdGdGe#ZGdHdIdIe#ZGdJdKdKe#ZGdLdMdMe#ZGdNdOdOe#ZGdPdQdQe#Zz ddRlmZddSlmZmZWn$eydZZdTdUZYn0GdVdWdWe#ZzddXlmZWn$eyGdYdZdZe#ZYn0Gd[dZdZe#ZdS)]N)version) OrderedDict)Decimal) signature) validators)models) serializers) api_settings)openapi)SwaggerGenerationError)decimal_as_floatfield_value_to_representation filter_noneget_serializer_classget_serializer_ref_name)FieldInspector NotHandledSerializerInspectorcall_view_methodZdjangorestframeworkc@sTeZdZdZdZddZddZddZd d Zd d Z d dZ ddZ ddZ dS)InlineSerializerInspectorzVProvides serializer conversions using :meth:`.FieldInspector.field_to_swagger_object`.FcCs||tj|jSN)probe_field_inspectorsr Schemause_definitionsself serializerrU/var/www/html/django/DPS/env/lib/python3.9/site-packages/drf_yasg/inspectors/field.py get_schema%sz$InlineSerializerInspector.get_schemacCs|S)aAdd/replace parameters from the given list of automatically generated request parameters. This method is called only when the serializer is converted into a list of parameters for use in a form data request. :param serializer: serializer instance :param list[openapi.Parameter] parameters: generated parameters :return: modified parameters :rtype: list[openapi.Parameter] r)rr parametersrrr add_manual_parameters(s z/InlineSerializerInspector.add_manual_parameterscs0t|di}fdd|D}||S)Nfieldsc s:g|]2\}}t|ddsj|tjj|dqS) read_onlyF)namein_)getattrrr Parameterrget_parameter_name).0keyvaluer'rrr 5s    zDInlineSerializerInspector.get_request_parameters..)r(itemsr#)rrr'r$r"rr.r get_request_parameters3s    z0InlineSerializerInspector.get_request_parameterscCs|Srrr field_namerrr get_property_nameAsz+InlineSerializerInspector.get_property_namecCs|Srrr2rrr r*Dsz,InlineSerializerInspector.get_parameter_namecCst|Sr)rrrrr rGsz1InlineSerializerInspector.get_serializer_ref_namecCst|dd}t|dS)NMetaref_name)r(hasattr)rrserializer_metarrr _has_ref_nameJs z'InlineSerializerInspector._has_ref_namec s4j||fi|\t|tjtjfr^|j}t|pFi}ftj |d|St|tj r0|tj krt d|j |}|ffdd }|rs|Sjtj} | ||} | t| dd} t|} | r$| | kr$| o | } | s$t d| | ft| |StS)Ntyper0z(cannot instantiate nested serializer as cst}g}|jD]f\}}|}dt|jp4di}t|}j|fi|}|||<|jrt |dds| |qdt j ||pdd}t |dt||S)Nr%F)Zuse_field_titler; propertiesrequired_NP_serializer)rr$r0r4boolr%rrr=r(appendr TYPE_OBJECTsetattrr)rr<r=Z property_namechildZ prop_kwargs child_schemaresultChildSwaggerType SwaggerTyperuse_referencesrr make_schema_definition_s.   zQInlineSerializerInspector.field_to_swagger_object..make_schema_definitionr>zSchema for %s would override distinct serializer %s because they implicitly share the same ref_name; explicitly set the ref_name attribute on both serializers' Meta classes)_get_partial_types isinstancerListSerializer ListFieldrrC find_limitsr TYPE_ARRAY Serializerrr __name__r components with_scopeSCHEMA_DEFINITIONS setdefaultZ_remove_read_onlyr(rr9 SchemaRefr)rfieldswagger_object_typerIkwargsrDlimitsr6rJ definitionsZ actual_schemaZactual_serializerZthis_serializerZ explicit_refsrrFr field_to_swagger_objectNs@      z1InlineSerializerInspector.field_to_swagger_objectN) rR __module__ __qualname____doc__rr!r#r1r4r*rr9r]rrrr rs rc@seZdZdZdS)ReferencingSerializerInspectorTN)rRr^r_rrrrr rasracCst|dd}t||}||fS)aTry to get information about a model and model field from a queryset. :param queryset: the queryset :param field_name: target field name :returns: the model and target field from the queryset as a 2-tuple; both elements can be ``None`` :rtype: tuple modelN)r(get_model_field)querysetr3rb model_fieldrrr get_queryset_fields  rfcCs>z$|dkr|jjWS|j|WSWnty8YdS0dS)zTry to get the given field from a django db model. :param model: the model :param field_name: target field name :return: model field or ``None`` pkN)_metarg get_field Exception)rbr3rrr rcs   rccCsTz:t|dd}|dur6|dur6t|t|ddks6J|WStyNYdS0dS)zTry to get the queryset of the given view :param view: the view instance or class :param serializer: if given, will check that the view's get_serializer_class return matches this serializer :return: queryset or ``None`` Z get_querysetrdNrZserializer_class)rr;rj)viewrrdrrr get_queryset_from_views  rlcCs$|dur t|tjr|S|j}qdS)zqGet the nearest parent ``Serializer`` instance for the given field. :return: ``Serializer`` or ``None`` N)rLrrQparentrXrrr get_parent_serializers  rocCsTz:t||}z |jjWWSty6|jjjYWS0WntyNYdS0dS)zTry to find the other side of a model relationship given the name of a related field. :param model: one side of the relationship :param str source: related field name :return: related model or ``None`` N)r(relZ related_modelrjrXZ remote_fieldrb)rbsourceZ descriptorrrr get_related_models    rrc@seZdZdZddZdS)RelatedFieldInspectorz-Provides conversions for ``RelatedField``\ s.cKs|j|||fi|\}}t|tjrF||j||}|tj|ddSt|tjsVt St |dd}t|tj tj frnt |ddr|j|j ||fi|} || dSt |dd} |durt|| \} } nt|} t | d d}t |d d}|st|j| }t |d d}t |d dp|j}|s8t|jtjr8|jj}t||} t| | } t| p^d tji}|fi|St|tjr|tjtjd S|tjdS)NT)r;r0Z unique_itemsrdpk_field)Zexisting_objectZ slug_fieldrgr5rbrqr;)r;formatr;)rKrLrZManyRelatedFieldrZchild_relationr rPZ RelatedFieldrr(ZPrimaryKeyRelatedFieldZSlugRelatedFieldrtrfrorlrkr3rmrrrcget_basic_type_info TYPE_STRINGZHyperlinkedRelatedField FORMAT_URI)rrXrYrIrZrHrGrDZfield_querysetrEZ target_fieldrbreZparent_serializerr8Z this_modelZ view_querysetrqattrsrrr r]sD            z-RelatedFieldInspector.field_to_swagger_objectNrRr^r_r`r]rrrr rssrscCsd}|jD]:}t|tjr t|tjs |tjkr2q |dur@dS|}q ztt|dddd}Wn*tytjdt |ddYdS0|r| ds| dr|dd d }|S) zGiven a ``Field``, look for a ``RegexValidator`` and try to extract its pattern and return it as a string. :param serializers.Field regex_field: the field instance :return: the extracted pattern, or ``None`` :rtype: str Nregexpatternz%failed to compile regex validator of T)exc_infoz\Zz\z$) rrLZRegexValidatorZ URLValidatorZvalidate_ipv4_addressr(rjloggerwarningstrendswith)Z regex_fieldZregex_validator validatorr~rrr find_regex s"   rminimummaximum min_length max_lengthZ min_itemsZ max_itemscsi}fddtD}ttjr.ts.|SjD]h}t|dsDq4|j}t|trdtrdt |}|D]2\}}}t||rh||vs||||rh|||<qhq4tdrƈj s| dddkrd|d<t t |S)zGiven a ``Field``, look for min/max value/length validators and return appropriate limit validation attributes. :param serializers.Field field: the field instance :return: the extracted limits :rtype: OrderedDict cs(g|] \}}}}t|r|||fqSr)rL)r+r field_classattrimprovesrnrr r/[s  zfind_limits.. limit_value allow_blankrrr)limit_validatorsrLr DecimalFieldr rr7rrfloatrgetrsortedr0)rXr[Zapplicable_limitsrrZvalidator_classrrrrnr rOSs(     rOcCst|rtjStjSr)r r TYPE_NUMBERryrnrrr decimal_field_typexsr)Zipv4Zipv6cCst|jdSr) ip_formatrprotocolrnrrr rz3.14.0cCs|dur dStD]>\}}t||r|\}}t|r:||}t|rJ||}qTqdSd}|tjkrjt|}t|}td|fd|fd|fg}||t |}|S)a?Given a serializer or model ``Field``, return its basic type information - ``type``, ``format``, ``pattern``, and any applicable min/max limit values. :param field: the field instance :return: the extracted attributes as a dictionary, or ``None`` if the field type is not known :rtype: OrderedDict Nr;rvr~) basic_type_inforLcallabler ryrrOrupdater)rXrZ type_format swagger_typervr~r[rErrr rxs.    rxcCstjr tjStjSr)rest_framework_settingsZCOERCE_DECIMAL_TO_STRINGr ryrrrrr decimal_return_typesrcCst|ddp|S)N __origin__r() hint_classrrr get_origin_typesrcCst|}t|ot||Sr)rinspectisclass issubclass)r check_class origin_typerrr hint_class_issubclasssrget_argscCs t|ddS)N__args__rr)tprrr typing_get_argssrcCsLt|}|r|dnt}t|p(dtji}tdtjfdtjfi|fgS)Nrr;r0)rrget_basic_type_info_from_hintr ryrrPItems)rargsZ child_classZchild_type_inforrr inspect_collection_hint_classsrcCst|}|tjur|jSdSr)rtypingUnionr)rrrrr _get_union_typess rcCst|}|rFt|dkrBtd|drBt|d}|r>d|d<|SdStD]T\}}t||rJt|rp||S|\}}t|r|}td|fd|fgSqJdS) a[Given a class (eg from a SerializerMethodField's return type hint, return its basic type information - ``type``, ``format``, ``pattern``, and any applicable min/max limit values. :param hint_class: the class :return: the extracted attributes as a dictionary, or ``None`` if the field type is not known :rtype: OrderedDict r NrrTz x-nullabler;rv)rlenrLrhinting_type_inforrr)rZ union_typesrErinforrvrrr r s(      rc@seZdZdZddZdS)SerializerMethodFieldInspectorzProvides conversion for SerializerMethodField, optionally using information from the swagger_serializer_method decorator. cKsJt|tjstSt|j|jd}|dur,tSt|dd}|r|j}|durVt|dd}|durd|j}|j }|dur~t|dd}t |r||dd} |j fi| }n||_||_ d|_ |j|||ddSt|j} t | st| dr| jd} t | rFt| t jsFt| } | durF|j|||fi|\} } | fi| StS) N_swagger_serializer help_textlabelT)rrr%)r%rr)rLrZSerializerMethodFieldrr(rm method_namerr`rrrrr%rinspect_signaturereturn_annotationr7rr_emptyrrK)rrXrYrIrZmethodr descriptionrZserializer_kwargsr type_inforHrGrrr r]8sL         z6SerializerMethodFieldInspector.field_to_swagger_objectNr|rrrr r3src@seZdZdZddZdS)SimpleFieldInspectorzProvides conversions for fields which can be described using just ``type``, ``format``, ``pattern`` and min/max validators. cKs<t|}|durtS|j|||fi|\}}|fi|Sr)rxrrK)rrXrYrIrZrrHrGrrr r]vs z,SimpleFieldInspector.field_to_swagger_objectNr|rrrr rqsrc@seZdZdZddZdS)ChoiceFieldInspectorzEProvides conversions for ``ChoiceField`` and ``MultipleChoiceField``.cKs||j|||fi|\}}t|tjrxtj}g}|jD]6} t|tjr^t || gd} n t || } | | qdd|D}t|dkrttt|}|r|d|}t|tjrh|tj|||d d }|tjkrt|d tjtjfvrtd |_n |||d }|StS) Nrr5rb base_fieldr;cSsh|] }t|qSrrw)r+vrrr rz?ChoiceFieldInspector.field_to_swagger_object..r)r;enumr:inmulti)rKrLrZ ChoiceFieldr rychoiceskeysZMultipleChoiceFieldrr@roZModelSerializerr(rcrqrmrrxrrrnextiterrPr)IN_FORMZIN_QUERYZcollection_formatr)rrXrYrIrZrHrGZ enum_typeZ enum_valueschoicerrbreZ model_typeZenum_value_typesZ values_typerErrr r]sL        z,ChoiceFieldInspector.field_to_swagger_objectNr|rrrr rsrc@seZdZdZddZdS)FileFieldInspectorz*Provides conversions for ``FileField``\ s.c Ks|j|||fi|\}}t|tjrtd}|tjkr`|tjdd}t|dt j r\tj |_ |S|tj kr|tjd} | dtjkr|| S|tS)NzFFileField is supported only in a formData Parameter or response SchemaT)r;r%Zuse_urlrwr)rKrLrZ FileFieldr r rryr(rZUPLOADED_FILES_USE_URLrzrvr)Z TYPE_FILErr) rrXrYrIrZrHrGerrrEparamrrr r]s    z*FileFieldInspector.field_to_swagger_objectNr|rrrr rsrc@seZdZdZddZdS)DictFieldInspectorz&Provides conversion for ``DictField``.cKsR|j|||fi|\}}t|tjrN|tjkrN||j||}|tj|dSt S)N)r;Zadditional_properties) rKrLrZ DictFieldr rrrCrAr)rrXrYrIrZrHrGrDrrr r]sz*DictFieldInspector.field_to_swagger_objectNr|rrrr rsrc@seZdZdZddZdS)HiddenFieldInspectorzHide ``HiddenField``.cKst|tjrdStSr)rLrZ HiddenFieldr)rrXrYrIrZrrr r]s z,HiddenFieldInspector.field_to_swagger_objectNr|rrrr rsrc@seZdZdZddZdS)JSONFieldInspectorz&Provides conversion for ``JSONField``.cKs@|j|||fi|\}}t|tjr<|tjkr<|tjdStSNrw)rKrLrZ JSONFieldr rrArrrXrYrIrZrHrGrrr r]s z*JSONFieldInspector.field_to_swagger_objectNr|rrrr rsrc@seZdZdZddZdS)StringDefaultFieldInspectorzRFor otherwise unhandled fields, return them as plain :data:`.TYPE_STRING` objects.cKs&|j|||fi|\}}|tjdSr)rKr ryrrrr r]sz3StringDefaultFieldInspector.field_to_swagger_objectNr|rrrr rsr)CamelCaseJSONParser)CamelCaseJSONRenderercamelizecCs|Srr)datarrr rsrc@sBeZdZdZddZddZddZer6er6dd Z nd d Z d S) CamelCaseJSONFilterzSConverts property names to camelCase if ``djangorestframework_camel_case`` is used.cCsttt|diS)zHack to force ``djangorestframework_camel_case`` to camelize a plain string. :param str s: the string :return: camelized string :rtype: str ru)rrr)rsrrr camelize_stringsz#CamelCaseJSONFilter.camelize_stringcsPt|dirLtfdd|jD|_t|dgrLfdd|jD|_dS)zRecursively camelize property names for the given schema using ``djangorestframework_camel_case``. The target schema object must be modified in-place. :param openapi.Schema schema: the :class:`.Schema` object r<c3s4|],\}}|t|jp(|fVqdSr)rcamelize_schemar resolve_refrS)r+r,valrrr sz6CamelCaseJSONFilter.camelize_schema..r=csg|]}|qSr)r)r+prrr r/%rz7CamelCaseJSONFilter.camelize_schema..N)r(rr<r0r=)rschemarrr rs     z#CamelCaseJSONFilter.camelize_schemacKs2t|tjjr.|r.t||j}|||Sr)rLr rZOR_REF is_camel_caserrSr)rrErobjrZrrrr process_result's z"CamelCaseJSONFilter.process_resultcCs,tdd|Dp*tdd|DS)Ncss|]}t|tVqdSr)rr)r+parserrrr r1rz4CamelCaseJSONFilter.is_camel_case..css|]}t|tVqdSr)rr)r+rendererrrr r2r)anyZget_parser_classesZget_renderer_classesrrrr r/sz!CamelCaseJSONFilter.is_camel_casecCsdS)NFrrrrr r5sN) rRr^r_r`rrrrrrrrrr r s  r)RecursiveFieldc@seZdZdZdS)RecursiveFieldInspectorbProvides conversion for RecursiveField (https://github.com/heywbj/django-rest-framework-recursive)N)rRr^r_r`rrrr r<src@seZdZdZddZdS)rrc Kst|tr|tjkr|dus$Jd|j}t|jtjr>|j}t|}|dusbJdt t ||j tj }tj||dd}t|jtjrtjtj|d}|StS)NTzECan not create schema for RecursiveField when use_references is Falsez.Can't create RecursiveField schema for inline )Zignore_unresolvedr:)rLrr rproxiedrrMrCrrr;rSrTrUrWrrPr) rrXrYrIrZrr6r\refrrr r]Csz/RecursiveFieldInspector.field_to_swagger_objectNr|rrrr r@s)N)datetimerloggingoperatorruuid pkg_resources packagingr collectionsrdecimalrrrZ django.corerZ django.dbrZrest_frameworkrZrest_framework.settingsr rrur errorsr utilsr rrrrbaserrrrget_distributionZ drf_version getLoggerrRrrrarfrcrlrorrrsrZ IntegerFieldZ FloatFieldrZnumeric_fieldsZMinValueValidator__gt__ZMaxValueValidator__lt__ZMinLengthValidatorZ CharFieldZMaxLengthValidatorrNrMrrOrZ AutoFieldZ TYPE_INTEGERZ BinaryFieldryZ FORMAT_BINARYZ BooleanFieldZ TYPE_BOOLEANZ DateTimeFieldZFORMAT_DATETIMEZ DateFieldZ FORMAT_DATEZFORMAT_DECIMALZ DurationFieldrZIPAddressFieldZ FORMAT_IPV4ZGenericIPAddressFieldZ FORMAT_IPV6Z SlugFieldZ FORMAT_SLUGZ TextFieldZ TimeFieldZ UUIDFieldZ FORMAT_UUIDZmodel_field_to_basic_typerZ EmailFieldZ FORMAT_EMAILZURLFieldrzZ RegexFieldZ ModelFieldZserializer_field_to_basic_typeparser@ZNullBooleanFieldrrxrrrr?intrrdictrAUUIDdaterr7rrrSequence AbstractSetrrrrrrrrrrZ%djangorestframework_camel_case.parserrZ%djangorestframework_camel_case.renderrr ImportErrorrZrest_framework_recursive.fieldsrrrrrr s            t  :#%&        '>9    -