a xd@sddlZddlZddlZddlZddlZddlZddlmZddlm Z ddlm Z ddl m Z ddlmZddlmZddlmZd d lmZd d lmZd d lmZmZmZmZmZd dlm Z m!Z!m"Z"m#Z#e$e%Z&Gddde"Z'Gddde'Z(ddZ)ddZ*dYddZ+ddZ,ddZ-Gddde Z.dd Z/ej0ej1ej2fZ3e j4e3d!ej5fe j6e3d"ej7fe j8ej9d#ej5fe j:ej9d$ej7fe j8ej;ejd)d*Z?ej@ejAdffejBejCejDffejEejFdffejGejFdffejHejCejIffejJejCejKffej2e?ejLffejMejAdffej1ejNdffej0ejAdffejOejCejPffejQejCejRffejSejCejTffejUejCdffejVejCdffejWejCejXffej9ejCdffgZYejPejRd+ZZej[ejCej\ffejSejCejTffej]ejCej^ffejOejCd,d-ffejWejCejXffej_ejCdffej9ejCdffejEejFdffejGejFdffej0ejAdffej1ejNdffej2e?ejLffejMejNdffejJejCejKffejHejCejIffej`ejCdffgZaeaeYZbd.d/Zcd0d1Zdd2d3Zed4d5ZfegejFdffehejAdffeiejCdffejejNdffekejldffe edejLffejmejCejXffejejCejIffejnejCejKffg Zoeped6rejqZrnd7d8Zrd9d:Zseotejuejvfesfd;d<Zwd=d>ZxGd?d@d@e ZyGdAdBdBe ZzGdCdDdDe Z{GdEdFdFe Z|GdGdHdHe Z}GdIdJdJe Z~GdKdLdLe ZGdMdNdNe Zz ddOlmZddPlmZmZWn$ey|dZZdQdRZYn0GdSdTdTe ZzddUlmZWn$eyGdVdWdWe ZYn0GdXdWdWe ZdS)ZN) 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_methodc@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 serializerrQ/var/www/html/Ranjet/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: genereated parameters :return: modified parameters :rtype: list[openapi.Parameter] r)rr parametersrrradd_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 0s    zDInlineSerializerInspector.get_request_parameters..)r'itemsr")rrr&r#r!rr-rget_request_parameters.s    z0InlineSerializerInspector.get_request_parameterscCs|Srrr field_namerrrget_property_name<sz+InlineSerializerInspector.get_property_namecCs|Srrr1rrrr)?sz,InlineSerializerInspector.get_parameter_namecCst|Sr)rrrrrrBsz1InlineSerializerInspector.get_serializer_ref_namecCst|dd}t|dS)NMetaref_name)r'hasattr)rrserializer_metarrr _has_ref_nameEs 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)Ntyper/z(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#r/r3boolr$rrr<r'appendr TYPE_OBJECTsetattrr)rr;r<Z property_namechildZ prop_kwargs child_schemaresultChildSwaggerType SwaggerTyperuse_referencesrrmake_schema_definitionZs.   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 ListFieldrrB find_limitsr TYPE_ARRAY Serializerrr __name__r components with_scopeSCHEMA_DEFINITIONS setdefaultZ_remove_read_onlyr'rr8 SchemaRefr)rfieldswagger_object_typerHkwargsrClimitsr5rI definitionsZ actual_schemaZactual_serializerZthis_serializerZ explicit_refsrrErfield_to_swagger_objectIs@      z1InlineSerializerInspector.field_to_swagger_objectN) rQ __module__ __qualname____doc__rr r"r0r3r)rr8r\rrrrrs rc@seZdZdZdS)ReferencingSerializerInspectorTN)rQr]r^rrrrrr`sr`cCst|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)querysetr2ra model_fieldrrrget_queryset_fields  recCs>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)Z_metarf get_field Exception)rar2rrrrbs   rbcCsTz: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 serialzier :return: queryset or ``None`` Z get_querysetrcNrZserializer_class)rr:rh)viewrrcrrrget_queryset_from_views  rjcCs$|dur t|tjr|S|j}qdS)zqGet the nearest parent ``Serializer`` instance for the given field. :return: ``Serializer`` or ``None`` N)rKrrPparentrWrrrget_parent_serializers  rmcCsTz: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_modelrhrWZ remote_fieldra)rasourceZ descriptorrrrget_related_models    rpc@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:r/Z unique_itemsrcpk_field)Zexisting_objectZ slug_fieldrfr4raror:)r:formatr:)rJrKrZManyRelatedFieldrZchild_relationr rOZ RelatedFieldrr'ZPrimaryKeyRelatedFieldZSlugRelatedFieldrrrermrjrir2rkrprbget_basic_type_info TYPE_STRINGZHyperlinkedRelatedField FORMAT_URI)rrWrXrHrYrGrFrCZfield_querysetrDZ target_fieldrardZparent_serializerr7Z this_modelZ view_querysetroattrsrrrr\sD            z-RelatedFieldInspector.field_to_swagger_objectNrQr]r^r_r\rrrrrqsrqcCsd}|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$) rrKZRegexValidatorZ URLValidatorZvalidate_ipv4_addressr'rhloggerwarningstrendswith)Z regex_fieldZregex_validator validatorr|rrr find_regexs"   rZminimummaximum 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)rK)r*r field_classattrimprovesrlrrr.Vs  zfind_limits.. limit_value allow_blankrrr)limit_validatorsrKr DecimalFieldr rr6rrfloatrgetrsortedr/)rWrZZapplicable_limitsrrZvalidator_classrrrrlrrNNs(     rNcCst|rtjStjSr)r r TYPE_NUMBERrwrlrrrdecimal_field_typessr)Zipv4Zipv6cCst|jdSr) ip_formatrprotocolrlrrrrcCs|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:rtr|) basic_type_inforKcallabler rwrrNrupdater)rWrZ type_format swagger_typertr|rZrDrrrrvs.    rvcCstjr tjStjSr)rest_framework_settingsZCOERCE_DECIMAL_TO_STRINGr rwrrrrrdecimal_return_typesrcCst|ddp|S)N __origin__r') hint_classrrrget_origin_typesrcCst|}t|ot||Sr)rinspectisclass issubclass)r check_class origin_typerrrhint_class_issubclasssrget_argscCs t|ddS)N__args__rr)tprrrtyping_get_argssrcCsLt|}|r|dnt}t|p(dtji}tdtjfdtjfi|fgS)Nrr:r/)rrget_basic_type_info_from_hintr rwrrOItems)rargsZ child_classZchild_type_inforrrinspect_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:rt)rlenrKrhinting_type_inforrr)rZ union_typesrDrinforrtrrrrs(      rc@seZdZdZddZdS)SerializerMethodFieldInspectorzProvides conversion for SerializerMethodField, optionally using information from the swagger_serializer_method decorator. cKsHt|tjstSt|j|j}|dur*tSt|dd}|r|j}|durTt|dd}|durb|j}|j }|dur|t|dd}t |r||dd} |j fi| }n||_||_ d|_ |j|||ddSt|j} t | st| dr| jd} t | rDt| t jsDt| } | durD|j|||fi|\} } | fi| StS) N_swagger_serializer help_textlabelT)rrr$)r$rr)rKrZSerializerMethodFieldrr'rk method_namerr_rrrrr$rinspect_signaturereturn_annotationr6rr_emptyrrJ)rrWrXrHrYmethodr descriptionrZserializer_kwargsr type_inforGrFrrrr\,sL         z6SerializerMethodFieldInspector.field_to_swagger_objectNrzrrrrr'src@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)rvrrJ)rrWrXrHrYrrGrFrrrr\js z,SimpleFieldInspector.field_to_swagger_objectNrzrrrrresrc@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) Nrr4ra base_fieldr:cSsh|] }t|qSrru)r*vrrr rz?ChoiceFieldInspector.field_to_swagger_object..r)r:enumr9inZmulti)rJrKrZ ChoiceFieldr rwchoiceskeysZMultipleChoiceFieldr r?rmZModelSerializerr'rbrorkrrvrrrnextiterrOr(IN_FORMZIN_QUERYZcollection_formatr)rrWrXrHrYrGrFZ enum_typeZ enum_valueschoicerrardZ model_typeZenum_value_typesZ values_typerDrrrr\vsL        z,ChoiceFieldInspector.field_to_swagger_objectNrzrrrrrssrc@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_urlrur)rJrKrZ FileFieldr r rrwr'rZUPLOADED_FILES_USE_URLrxrtr(Z TYPE_FILErr) rrWrXrHrYrGrFerrrDparamrrrr\s    z*FileFieldInspector.field_to_swagger_objectNrzrrrrrsrc@seZdZdZddZdS)DictFieldInspectorz&Provides conversion for ``DictField``.cKsR|j|||fi|\}}t|tjrN|tjkrN||j||}|tj|dSt S)N)r:Zadditional_properties) rJrKrZ DictFieldr rrrBr@r)rrWrXrHrYrGrFrCrrrr\sz*DictFieldInspector.field_to_swagger_objectNrzrrrrrsrc@seZdZdZddZdS)HiddenFieldInspectorzHide ``HiddenField``.cKst|tjrdStSr)rKrZ HiddenFieldr)rrWrXrHrYrrrr\s z,HiddenFieldInspector.field_to_swagger_objectNrzrrrrrsrc@seZdZdZddZdS)JSONFieldInspectorz&Provides conversion for ``JSONField``.cKs@|j|||fi|\}}t|tjr<|tjkr<|tjdStSNru)rJrKrZ JSONFieldr rr@rrrWrXrHrYrGrFrrrr\s z*JSONFieldInspector.field_to_swagger_objectNrzrrrrrsrc@seZdZdZddZdS)StringDefaultFieldInspectorzRFor otherwise unhandled fields, return them as plain :data:`.TYPE_STRING` objects.cKs&|j|||fi|\}}|tjdSr)rJr rwrrrrr\sz3StringDefaultFieldInspector.field_to_swagger_objectNrzrrrrrsr)CamelCaseJSONParser)CamelCaseJSONRenderercamelizecCs|Srr)datarrrrsrc@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 rs)rrr)rsrrrcamelize_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_refrR)r*r+valrrr sz6CamelCaseJSONFilter.camelize_schema..r<csg|]}|qSr)r)r*prrrr.rz7CamelCaseJSONFilter.camelize_schema..N)r'rr;r/r<)rschemarrrr s     z#CamelCaseJSONFilter.camelize_schemacKs2t|tjjr.|r.t||j}|||Sr)rKr rZOR_REF is_camel_caserrRr)rrDrobjrYrrrrprocess_results z"CamelCaseJSONFilter.process_resultcCs,tdd|Dp*tdd|DS)Ncss|]}t|tVqdSr)rr)r*parserrrrr%rz4CamelCaseJSONFilter.is_camel_case..css|]}t|tVqdSr)rr)r*Zrendererrrrr&r)anyZget_parser_classesZget_renderer_classesrrrrr#sz!CamelCaseJSONFilter.is_camel_casecCsdS)NFrrrrrr)sN) rQr]r^r_rrrrrrrrrrrs  r)RecursiveFieldc@seZdZdZdS)RecursiveFieldInspectorbProvides conversion for RecursiveField (https://github.com/heywbj/django-rest-framework-recursive)N)rQr]r^r_rrrrr0src@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_unresolvedr9)rKrr rproxiedrrLrBrrr:rRrSrTrVrrOr) rrWrXrHrYrr5r[refrrrr\7sz/RecursiveFieldInspector.field_to_swagger_objectNrzrrrrr4s)N)datetimerloggingoperatorruuid collectionsrdecimalrrrZ django.corerZ django.dbrZrest_frameworkrZrest_framework.settingsrrrsr errorsr utilsr r rrrbaserrrr getLoggerrQrrr`rerbrjrmrprqrZ IntegerFieldZ FloatFieldrZnumeric_fieldsZMinValueValidator__gt__ZMaxValueValidator__lt__ZMinLengthValidatorZ CharFieldZMaxLengthValidatorrMrLrrNrZ AutoFieldZ TYPE_INTEGERZ BinaryFieldrwZ FORMAT_BINARYZ BooleanFieldZ TYPE_BOOLEANZNullBooleanFieldZ 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_EMAILZURLFieldrxZ RegexFieldZ ModelFieldZserializer_field_to_basic_typerrvrrrr>intrrdictr@UUIDdaterr6rrrr?Sequence AbstractSetrrrrrrrrrrZ%djangorestframework_camel_case.parserrZ%djangorestframework_camel_case.renderrr ImportErrorrZrest_framework_recursive.fieldsrrrrrrs          t  :#%&        '>9    -