o h@sddlZddlZddlZddlZddlZddlmZddlmZddl m Z ddl Z ddl m Z ddlmZddlmZddlmZdd lmZd d lmZmZmZmZd d lmZd dlmZd dl m!Z!m"Z"m#Z#m$Z$m%Z%z ddl&m'Z'e'dZ(Wne)yddl*Z*e*+djZ(Ynwzddl,m-Z-m.Z.e j/e.fZ0Wne)ye1dZ-e j/fZ0Ynwe2e3Z4GdddeZ5Gddde5Z6ddZ7ddZ8d\ddZ9ddZ:dd Z;d!d"Zej?ej@ejAfZBe jCeBd'ejDfe jEeBd(ejFfe jGejHd)ejDfe jIejHd*ejFfe jGejJejKfd+ejDfe jIejJejKfd,ejFfgZLd-d.ZMd/d0ZNejOejPdffejQejRejSffejTejUdffejVejRejWffejXejRejYffejAeNejZffej[ejRdffej@ej\dffej?ejPdffej]ejRej^ffej_ejRej`ffejaejRejbffejcejRdffejdejRdffejeejRejfffejHejRdffgZgej^ej`d1ZhejiejRejjffejaejRejbffejkejRejlffej]ejRd2d3ffejeejRejfffejmejRdffejHejRdffejTejUdffej?ejPdffej@ej\dffejAeNejZffej[ejRdffejXejRejYffejVejRejWffejnejRdffgZoepe(epd4krDegqejrejUdffeoqejrejUdffeoegZsd5d6Ztd7d8ZuevejUdffewejPdffexejRdffeyej\dffezej{dffe euejZffej|ejRejfffejejRejWffej}ejRejYffg Z~ee d9re jZe jZnd:d;Zdd?Ze~qe je jfefd@dAZGdBdCdCeZGdDdEdEeZGdFdGdGeZGdHdIdIeZGdJdKdKeZGdLdMdMeZGdNdOdOeZGdPdQdQeZzddRlmZddSlmZmZWne)ydZZdTdUZYnwGdVdWdWeZzddXlmZWne)y<GdYdZdZeZYdSwGd[dZdZeZdS)]N)suppress) OrderedDict)Decimal) validators)models)version) serializers) api_settings)call_view_methodFieldInspector NotHandledSerializerInspector)openapi)SwaggerGenerationError)decimal_as_floatfield_value_to_representation filter_noneget_serializer_classget_serializer_ref_name)metadatadjangorestframework)NoneType UnionTypec@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_inspectorsrSchemause_definitionsself serializerr#Y/var/www/html/premium_crap/venv/lib/python3.10/site-packages/drf_yasg/inspectors/field.py get_schema0z$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#)r!r" parametersr#r#r$add_manual_parameters3s z/InlineSerializerInspector.add_manual_parameterscs0t|di}fdd|D}||S)Nfieldsc s:g|]\}}t|ddsj|tjj|dqS) read_onlyF)namein_)getattrrr Parameterrget_parameter_name).0keyvaluer,r!r#r$ @s   zDInlineSerializerInspector.get_request_parameters..)r-itemsr()r!r"r,r)r'r#r3r$get_request_parameters>s   z0InlineSerializerInspector.get_request_parameterscC|Srr#r! field_namer#r#r$get_property_nameLz+InlineSerializerInspector.get_property_namecCr7rr#r8r#r#r$r/Or;z,InlineSerializerInspector.get_parameter_namecCst|Sr)rr r#r#r$rRsz1InlineSerializerInspector.get_serializer_ref_namecCst|dd}t|dS)NMetaref_name)r-hasattr)r!r"serializer_metar#r#r$ _has_ref_nameUs  z'InlineSerializerInspector._has_ref_namec s*j||fi|\t|tjtjfr/|j}t|p#i}dtj |d|St|tj r|tj krAt d|j |}|ffdd }|rUsX|Sjtj} | ||} | t| dd} t|} | r| | kr| o| } | st d| | ft| |StS)Ntyper5z(cannot instantiate nested serializer as cst}g}|jD]3\}}|}dt|jpdi}t|}j|fi|}|||<|jr=t |dds=| |q dt j ||pFdd}t |dt||S)Nr*F)use_field_titlerB propertiesrequired_NP_serializer)rr)r5r:boolr*rrrEr-appendr TYPE_OBJECTsetattrr)r"rDrE property_namechild prop_kwargs child_schemaresultChildSwaggerType SwaggerTyper!use_referencesr#r$make_schema_definitionjs0   zQInlineSerializerInspector.field_to_swagger_object..make_schema_definitionrFzSchema 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 classesr#)_get_partial_types isinstancerListSerializer ListFieldrrL find_limitsr TYPE_ARRAY Serializerrr__name__r components with_scopeSCHEMA_DEFINITIONS setdefault_remove_read_onlyr-rr@ SchemaRefr )r!fieldswagger_object_typerSkwargsrNlimitsr=rT definitions actual_schemaactual_serializerthis_serializer explicit_refsr#rPr$field_to_swagger_objectYs@        z1InlineSerializerInspector.field_to_swagger_objectN) r\ __module__ __qualname____doc__rr%r(r6r:r/rr@rlr#r#r#r$r*s  rc@eZdZdZdS)ReferencingSerializerInspectorTN)r\rmrnrr#r#r#r$rqsrqcCst|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)querysetr9rr model_fieldr#r#r$get_queryset_fields  rvcCs6z|dkr |jjWS|j|WStyYdSw)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)_metarw get_field Exception)rrr9r#r#r$rss  rscCsPzt|dd}|dur|durt|t|ddusJ|WSty'YdSw)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`` get_querysetrtNrserializer_class)r rBrz)viewr"rtr#r#r$get_queryset_from_views  r~cCs*|durt|tjr |S|j}|dusdS)zqGet the nearest parent ``Serializer`` instance for the given field. :return: ``Serializer`` or ``None`` N)rVrr[parentrcr#r#r$get_parent_serializers  rc Csbtt#z |jjWWdSty&|jjjYWdSw1s*wYdSr)rrzrel related_modelrc remote_fieldrr) descriptorr#r#r$get_model_from_descriptors   rcCstt2d|vr(|dr(|jddd\}}ttt|||WdStt||WdS1s9wYdS)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`` .r )maxsplitN)rrzindexsplitget_related_modelrr-)rrsourceattrr#r#r$rs  $rc@eZdZdZddZdS)RelatedFieldInspectorz-Provides conversions for ``RelatedField``\ s.cKs|j|||fi|\}}t|tjr#||j||}|tj|ddSt|tjs+t St |dd}t|tj tj frt |ddrQ|j|j ||fi|} || dSt |dd} |durct|| \} } n>t|} t | d d}t |d d}|st|j| }t |d d}t |d dp|j}|st|jtjr|jj}t||} t| | } t| pd tji}|di|St|tjr|tjtjd St S)NT)rBr5 unique_itemsrtpk_field)existing_object slug_fieldrwr<rrrrB)rBformatr#)rUrVrManyRelatedFieldrchild_relationrrZ RelatedFieldr r-PrimaryKeyRelatedFieldSlugRelatedFieldrrvrr~r}r9rrrsget_basic_type_info TYPE_STRINGHyperlinkedRelatedField FORMAT_URI)r!rcrdrSrerRrQrNfield_querysetrO target_fieldrrruparent_serializerr? this_model view_querysetrattrsr#r#r$rlsD             z-RelatedFieldInspector.field_to_swagger_objectNr\rmrnrorlr#r#r#r$r rcCsd}|jD]}t|tjr"t|tjs|tjkrq|dur dS|}qz tt|dddd}WntyDtjdt |ddYdSw|rY| dsQ| drY|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$) rrVRegexValidator URLValidatorvalidate_ipv4_addressr-rzloggerwarningstrendswith) regex_fieldregex_validator validatorrr#r#r$ find_regex1s&   rminimummaximum min_length max_length min_items max_itemscsi}fddtD}ttjrts|SjD]4}t|ds"q|j}t|tr2tr2t |}|D]\}}}t||rM||vsI||||rM|||<q4qtdrcj sc| dddkrcd|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#)rV)r0r field_classrimprovesrr#r$r4ls  zfind_limits.. limit_value allow_blankrrr )limit_validatorsrVr DecimalFieldrrr>rrfloatrgetrsortedr5)rcrfapplicable_limitsrrvalidator_classrrr#rr$rYds,    rYcCst|rtjStjSr)rr TYPE_NUMBERrrr#r#r$decimal_field_typesr)ipv4ipv6cCst|jdSr) ip_formatrprotocolrr#r#r$srz3.14.0cCs|durdStD]\}}t||r'|\}}t|r||}t|r%||}nqdSd}|tjkr5t|}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 NrBrr) basic_type_inforVcallablerrrrYrupdater)rcr type_format swagger_typerrrfrOr#r#r$rs0    rcCstjrtjStjSr)rest_framework_settingsCOERCE_DECIMAL_TO_STRINGrrrr#r#r#r$decimal_return_typer&rget_argscCs t|ddS)N__args__r#r-tpr#r#r$typing_get_args rcCs t|ddS)N __origin__rrr#r#r$typing_get_originrrcCsLt|}|r |dnt}t|pdtji}tdtjfdtjdi|fgS)NrrBr5r#)rrget_basic_type_info_from_hintrrrrZItems) hint_classargs child_classchild_type_infor#r#r$inspect_collection_hint_classsrcCst|tvr%ddt|D}t|dkr#t|d}|r!d|d<|SdSt|p*|}t|s2dStD]*\}}t||r^t |rG||S|\}}t |rR|}t d|fd |fgSq4dS) 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 cSsg|]}|tur|qSr#)r)r0tr#r#r$r4sz1get_basic_type_info_from_hint..r rTz x-nullableNrBr) r UNION_TYPESrlenrinspectisclasshinting_type_info issubclassrr)rfiltered_typesrOresolved_class check_classinforrr#r#r$rs0          rc@r)SerializerMethodFieldInspectorzProvides conversion for SerializerMethodField, optionally using information from the swagger_serializer_method decorator. cKs0t|tjstSt|j|jd}|durtSt|dd}|re|j}|dur+t|dd}|dur2|j}|j }|dur?t|dd}t |rS||dd} |j di| }n ||_||_ d|_ |j|||ddSt|d} t | rzt| t jrztSt| } | dur|j|||fi|\} } | di| StS) N_swagger_serializer help_textlabelT)rrr*)r*returnr#)rVrSerializerMethodFieldr r-r method_namerrorrrrr*rtypingget_type_hintsrr_emptyrrU)r!rcrdrSremethodr" descriptionrserializer_kwargsr type_inforRrQr#r#r$rlEsJ      z6SerializerMethodFieldInspector.field_to_swagger_objectNrr#r#r#r$r@ rc@r)SimpleFieldInspectorzProvides conversions for fields which can be described using just ``type``, ``format``, ``pattern`` and min/max validators. cKs<t|}|dur tS|j|||fi|\}}|di|S)Nr#)rr rU)r!rcrdrSrerrRrQr#r#r$rls z,SimpleFieldInspector.field_to_swagger_objectNrr#r#r#r$rrrc@r)ChoiceFieldInspectorzEProvides conversions for ``ChoiceField`` and ``MultipleChoiceField``.cKsr|j|||fi|\}}t|tjrtj}g}|jD]} t|tjr.t || gd} nt || } | | qt |} t| tj rmt t | dd} t| |jpS|jj} t | ddr^| j} | rlt| } | rl| d|}ndd|D}t|dkrttt|}|r|d|}t|tjr|tj|||d d }|tjkr|d tjtjfvrd |_|S|||d }|StS) Nrr<rr base_fieldrBcSsh|]}t|qSr#rB)r0vr#r#r$ sz?ChoiceFieldInspector.field_to_swagger_object..r )rBenumrAinmulti)rUrVr ChoiceFieldrrchoiceskeysMultipleChoiceFieldrrHrModelSerializerr-rsrrrrrrrnextiterrZr.IN_FORMIN_QUERYcollection_formatr )r!rcrdrSrerRrQ enum_type enum_valueschoicer"rrru model_typeenum_value_types values_typerOr#r#r$rlsP            z,ChoiceFieldInspector.field_to_swagger_objectNrr#r#r#r$rrrc@r)FileFieldInspectorz*Provides conversions for ``FileField``\ s.c Ks|j|||fi|\}}t|tjrHtd}|tjkr0|tjdd}t|dt j r.tj |_ |S|tj krF|tjd} | dtjkrD|| S|tS)NzFFileField is supported only in a formData Parameter or response SchemaT)rBr*use_urlrr)rUrVr FileFieldrrrrr-rUPLOADED_FILES_USE_URLrrr. TYPE_FILErr ) r!rcrdrSrerRrQerrrOparamr#r#r$rls    z*FileFieldInspector.field_to_swagger_objectNrr#r#r#r$rrrc@r)DictFieldInspectorz&Provides conversion for ``DictField``.cKsR|j|||fi|\}}t|tjr'|tjkr'||j||}|tj|dSt S)N)rBadditional_properties) rUrVr DictFieldrrrrLrIr )r!rcrdrSrerRrQrNr#r#r$rlsz*DictFieldInspector.field_to_swagger_objectNrr#r#r#r$r!rr!c@r)HiddenFieldInspectorzHide ``HiddenField``.cKst|tjrdStSr)rVr HiddenFieldr )r!rcrdrSrer#r#r$rls z,HiddenFieldInspector.field_to_swagger_objectNrr#r#r#r$r$rr$c@r)JSONFieldInspectorz&Provides conversion for ``JSONField``.cKs@|j|||fi|\}}t|tjr|tjkr|tjdStSNr)rUrVr JSONFieldrrrIr r!rcrdrSrerRrQr#r#r$rls z*JSONFieldInspector.field_to_swagger_objectNrr#r#r#r$r&rr&c@r)StringDefaultFieldInspectorzRFor otherwise unhandled fields, return them as plain :data:`.TYPE_STRING` objects.cKs&|j|||fi|\}}|tjdSr')rUrrr)r#r#r$rl s z3StringDefaultFieldInspector.field_to_swagger_objectNrr#r#r#r$r*rr*)CamelCaseJSONParser)CamelCaseJSONRenderercamelizecCs|Srr#)datar#r#r$r-r;r-c@sDeZdZdZddZddZddZererdd Z d Sd 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 r)rrr-)r!sr#r#r$camelize_stringsz#CamelCaseJSONFilter.camelize_stringcsXt|dir(tfdd|jD|_t|dgr*fdd|jD|_dSdSdS)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 rDc3s6|]\}}|t|jp|fVqdSr)r1camelize_schemar resolve_refr])r0r1valr!r#r$ .s  z6CamelCaseJSONFilter.camelize_schema..rEcsg|]}|qSr#)r1)r0pr5r#r$r44sz7CamelCaseJSONFilter.camelize_schema..N)r-rrDr5rE)r!schemar#r5r$r2's   z#CamelCaseJSONFilter.camelize_schemacKs2t|tjjr|rt||j}|||Sr)rVrrOR_REF is_camel_caser3r]r2)r!rOrobjrer8r#r#r$process_result6s z"CamelCaseJSONFilter.process_resultcCs,tdd|Dptdd|DS)Ncs|]}t|tVqdSr)rr+)r0parserr#r#r$r6@z4CamelCaseJSONFilter.is_camel_case..csr=r)rr,)r0rendererr#r#r$r6Ar?)anyget_parser_classesget_renderer_classesr5r#r#r$r:>sz!CamelCaseJSONFilter.is_camel_casecCsdS)NFr#r5r#r#r$r:Dr;N) r\rmrnror1r2r<r+r,r:r#r#r#r$r/s   r/)RecursiveFieldc@rp)RecursiveFieldInspectorbProvides conversion for RecursiveField (https://github.com/heywbj/django-rest-framework-recursive)N)r\rmrnror#r#r#r$rEKsrEc@r)rErFc Kst|trQ|tjkrQ|dusJd|j}t|jtjr|j}t|}|dus1Jdt t ||j tj }tj||dd}t|jtjrOtjtj|d}|StS)NTzECan not create schema for RecursiveField when use_references is Falsez.Can't create RecursiveField schema for inline )ignore_unresolvedrA)rVrDrrproxiedrrWrLrrrBr]r^r_rbrrZr ) r!rcrdrSrerHr=rgrefr#r#r$rlRsz/RecursiveFieldInspector.field_to_swagger_objectNrr#r#r#r$rEOrr)datetimerloggingoperatoruuid contextlibr collectionsrdecimalrr django.corer django.dbr packagingrrest_frameworkrrest_framework.settingsr rbaser r r rrrerrorsrutilsrrrrr importlibr drf_version ImportError pkg_resourcesget_distributiontypesrrUnionrrB getLoggerr\rrrqrvrsr~rrrrr IntegerField FloatFieldrnumeric_fieldsMinValueValidator__gt__MaxValueValidator__lt__MinLengthValidator CharFieldMaxLengthValidatorrXrWrrYr AutoField TYPE_INTEGER BinaryFieldr FORMAT_BINARY BooleanField TYPE_BOOLEAN DateTimeFieldFORMAT_DATETIME DateField FORMAT_DATEFORMAT_DECIMAL DurationFieldrIPAddressField FORMAT_IPV4GenericIPAddressField FORMAT_IPV6 SlugField FORMAT_SLUG TextField TimeField UUIDField FORMAT_UUIDmodel_field_to_basic_typer EmailField FORMAT_EMAILURLFieldr RegexField ModelFieldserializer_field_to_basic_typeparserHNullBooleanFieldrrrrGintrrdictrIUUIDdaterr>rr get_originrrSequence AbstractSetrrrrrr!r$r&r*%djangorestframework_camel_case.parserr+%djangorestframework_camel_case.renderr,r-r/rest_framework_recursive.fieldsrDrEr#r#r#r$s               t :#%&        .@9    -