o `oi@s4ddlZddlZddlZddlZddlZddlmZddlmZddl m Z ddlm Z ddl Z ddlZddlmZddlmZddlmZdd lmZdd lmZd d lmZmZmZmZd dlm Z d dl!m"Z"d dl#m$Z$m%Z%m&Z&m'Z'm(Z(e )djZ*e+e,Z-GdddeZ.Gddde.Z/ddZ0ddZ1d_ddZ2ddZ3ddZ4d d!Z5Gd"d#d#eZ6d$d%Z7ej8ej9ej:fZ;eje;d'ej?fej@ejAd(ej=fejBejAd)ej?fej@ejCejDfd*ej=fejBejCejDfd+ej?fgZEd,d-ZFd.d/ZGejHe jIdffejJe jKe jLffejMe jNdffejOe jKe jPffejQe jKe jRffej:eGe jSffejTe jKdffej9e jUdffej8e jIdffejVe jKe jWffejXe jKe jYffejZe jKe j[ffej\e jKdffej]e jKdffej^e jKe j_ffejAe jKdffgZ`e jWe jYd0Zaejbe jKe jcffejZe jKe j[ffejde jKe jeffejVe jKd1d2ffej^e jKe j_ffejfe jKdffejAe jKdffejMe jNdffej8e jIdffej9e jUdffej:eGe jSffejTe jKdffejQe jKe jRffejOe jKe jPffejge jKdffgZheie*eid3kre`jejke jNdffehjejke jNdffehe`Zld4d5Zmd6d7Znd8d9Zod:d;Zpeqe jNdffere jIdffese jKdffete jUdffeue jvdffe ene jSffejwe jKe j_ffeje jKe jPffejxe jKe jRffg Zyezed<rnej{Z|nd=d>Z|d?d@Z}eyjej~ejfe}fdAdBZdCdDZGdEdFdFeZGdGdHdHeZGdIdJdJeZGdKdLdLeZGdMdNdNeZGdOdPdPeZGdQdRdReZGdSdTdTeZzddUlmZddVlmZmZWneydZZdWdXZYnwGdYdZdZeZzdd[lmZWneyGd\d]d]eZYdSwGd^d]d]eZdS)`N)suppress) OrderedDict)Decimal) signature) validators)models)version) serializers) api_settings)call_view_methodFieldInspector NotHandledSerializerInspector)openapi)SwaggerGenerationError)decimal_as_floatfield_value_to_representation filter_noneget_serializer_classget_serializer_ref_nameZdjangorestframeworkc@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 a/var/www/html/kuke-dev/django-kuke/venv/lib/python3.10/site-packages/drf_yasg/inspectors/field.py get_schema%z$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 parametersr r r!add_manual_parameters(s z/InlineSerializerInspector.add_manual_parameterscs0t|di}fdd|D}||S)Nfieldsc s:g|]\}}t|ddsj|tjj|dqS) read_onlyF)namein_)getattrrr Parameterrget_parameter_name).0keyvaluer)rr r! 5s   zDInlineSerializerInspector.get_request_parameters..)r*itemsr%)rrr)r&r$r r0r!get_request_parameters3s   z0InlineSerializerInspector.get_request_parameterscC|Srr r field_namer r r!get_property_nameAz+InlineSerializerInspector.get_property_namecCr4rr r5r r r!r,Dr8z,InlineSerializerInspector.get_parameter_namecCst|Sr)rrr r r!rGsz1InlineSerializerInspector.get_serializer_ref_namecCst|dd}t|dS)NMetaref_name)r*hasattr)rrserializer_metar r r! _has_ref_nameJs  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)Ntyper2z(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)Zuse_field_titler? propertiesrequired_NP_serializer)rr&r2r7boolr'rrrAr*appendr TYPE_OBJECTsetattrr)rr@rAZ property_namechildZ prop_kwargs child_schemaresultChildSwaggerType SwaggerTyperuse_referencesr r!make_schema_definition_s0   zQInlineSerializerInspector.field_to_swagger_object..make_schema_definitionrBzSchema 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 isinstancer ListSerializer ListFieldrrG find_limitsr TYPE_ARRAY Serializerrr__name__r components with_scopeSCHEMA_DEFINITIONS setdefaultZ_remove_read_onlyr*rr= SchemaRefr)rfieldswagger_object_typerMkwargsrHlimitsr:rN definitionsZ actual_schemaZactual_serializerZthis_serializerZ explicit_refsr rJr!field_to_swagger_objectNs@        z1InlineSerializerInspector.field_to_swagger_objectN) rV __module__ __qualname____doc__rr"r%r3r7r,rr=rar r r r!rs  rc@eZdZdZdS)ReferencingSerializerInspectorTN)rVrbrcrr r r r!rfsrfcCst|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)querysetr6rg model_fieldr r r!get_queryset_fields  rkcCs6z|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)_metarl get_field Exception)rgr6r r r!rhs  rhcCsPzt|dd}|dur|durt|t|ddksJ|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`` Z get_querysetriNrZserializer_class)r r?ro)viewrrir r r!get_queryset_from_views  rqcCs*|durt|tjr |S|j}|dusdS)zqGet the nearest parent ``Serializer`` instance for the given field. :return: ``Serializer`` or ``None`` N)rPr rUparentr\r r r!get_parent_serializers  rtc Csbtt#z |jjWWdSty&|jjjYWdSw1s*wYdSr)rrorelZ related_modelr\Z remote_fieldrg)Z descriptorr r r!get_model_from_descriptors   rvcCstt2d|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)rroindexsplitget_related_modelrvr*)rgsourceattrr r r!r{s  $r{c@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)r?r2Z unique_itemsripk_field)Zexisting_objectZ slug_fieldrlr9rgr|r?)r?formatr )rOrPr ZManyRelatedFieldrZchild_relationrrTZ RelatedFieldrr*ZPrimaryKeyRelatedFieldZSlugRelatedFieldrrkrtrqrpr6rrr{rhget_basic_type_info TYPE_STRINGZHyperlinkedRelatedField FORMAT_URI)rr\r]rMr^rLrKrHZfield_querysetrIZ target_fieldrgrjZparent_serializerr<Z this_modelZ view_querysetr|attrsr r r!rasD             z-RelatedFieldInspector.field_to_swagger_objectNrVrbrcrdrar 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$) rrPZRegexValidatorZ URLValidatorZvalidate_ipv4_addressr*rologgerwarningstrendswith)Z regex_fieldZregex_validator validatorrr r r! find_regex&s&   rminimummaximum min_length max_lengthZ min_itemsZ 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 )rP)r-r field_classr}improvesrsr r!r1as  zfind_limits.. limit_value allow_blankrrr )limit_validatorsrPr DecimalFieldrrr;rrfloatrgetrsortedr2)r\r_Zapplicable_limitsrrZvalidator_classr}rr rsr!rSYs,    rScCst|rtjStjSr)rr TYPE_NUMBERrrsr r r!decimal_field_type~sr)Zipv4Zipv6cCst|jdSr) ip_formatrprotocolrsr 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 Nr?rr) basic_type_inforPcallablerrrrSrupdater)r\rZ type_format swagger_typerrr_rIr r r!rs0    rcCstjrtjStjSr)rest_framework_settingsZCOERCE_DECIMAL_TO_STRINGrrrr r r r!decimal_return_typer#rcCst|ddp|S)N __origin__r*) hint_classr r r!get_origin_typesrcCst|}t|o t||Sr)rinspectisclass issubclass)r check_class origin_typer r r!hint_class_issubclasssrget_argscCs t|ddS)N__args__r r)tpr r r!typing_get_argss rcCsLt|}|r |dnt}t|pdtji}tdtjfdtjdi|fgS)Nrr?r2r )rrget_basic_type_info_from_hintrrrrTItems)rargsZ child_classZchild_type_infor r r!inspect_collection_hint_classsrcCst|}|tjur |jSdSr)rtypingUnionr)rrr r r!_get_union_types s rcCst|}|r#t|dkr!td|dr!t|d}|rd|d<|SdStD]*\}}t||rOt|r8||S|\}}t|rC|}td|fd|fgSq%dS) 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 rNr rTz x-nullabler?r)rlenrPrhinting_type_inforrr)rZ union_typesrIrinforrr r r!rs*       rc@r~)SerializerMethodFieldInspectorzProvides conversion for SerializerMethodField, optionally using information from the swagger_serializer_method decorator. cKsDt|tjstSt|j|jd}|durtSt|dd}|re|j}|dur+t|dd}|dur2|j}|j }|dur?t|dd}t |rS||dd} |j d i| }n ||_||_ d|_ |j|||ddSt|j} t | syt| dry| jd} t | rt| t jst| } | dur|j|||fi|\} } | d i| StS) N_swagger_serializer help_textlabelT)rrr')r'rrr )rPr ZSerializerMethodFieldrr*rr method_namerrdrrrrr'rinspect_signaturereturn_annotationr;rr_emptyrrO)rr\r]rMr^methodr descriptionrZserializer_kwargsr type_inforLrKr r r!ra>sL        z6SerializerMethodFieldInspector.field_to_swagger_objectNrr r r r!r9 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 )rrrO)rr\r]rMr^rrLrKr r r!ra|s z,SimpleFieldInspector.field_to_swagger_objectNrr r r r!rwrrc@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) Nrr9rg base_fieldr?cSsh|]}t|qSr r?)r-vr r r! sz?ChoiceFieldInspector.field_to_swagger_object..r )r?enumr>inmulti)rOrPr Z ChoiceFieldrrchoiceskeysZMultipleChoiceFieldrrDrtZModelSerializerr*rhr|rrrrrrrnextiterrTr+IN_FORMZIN_QUERYZcollection_formatr)rr\r]rMr^rLrKZ enum_typeZ enum_valueschoicerrgrjZ model_typeZenum_value_typesZ values_typerIr r r!rasP            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)r?r'Zuse_urlrr)rOrPr Z FileFieldrrrrr*rZUPLOADED_FILES_USE_URLrrr+Z TYPE_FILErr) rr\r]rMr^rLrKerrrIparamr r r!ras    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)r?Zadditional_properties) rOrPr Z DictFieldrrrrGrEr)rr\r]rMr^rLrKrHr r r!rasz*DictFieldInspector.field_to_swagger_objectNrr r r r!rrrc@r~)HiddenFieldInspectorzHide ``HiddenField``.cKst|tjrdStSr)rPr Z HiddenFieldr)rr\r]rMr^r r r!ras z,HiddenFieldInspector.field_to_swagger_objectNrr r r r!rrrc@r~)JSONFieldInspectorz&Provides conversion for ``JSONField``.cKs@|j|||fi|\}}t|tjr|tjkr|tjdStSNr)rOrPr Z JSONFieldrrrErrr\r]rMr^rLrKr r r!ras z*JSONFieldInspector.field_to_swagger_objectNrr r r r!rrrc@r~)StringDefaultFieldInspectorzRFor otherwise unhandled fields, return them as plain :data:`.TYPE_STRING` objects.cKs&|j|||fi|\}}|tjdSr)rOrrrr r r!ras z3StringDefaultFieldInspector.field_to_swagger_objectNrr r r r!rrr)CamelCaseJSONParser)CamelCaseJSONRenderercamelizecCs|Srr )datar r r!rr8rc@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)rsr 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 r@c3s6|]\}}|t|jp|fVqdSr)rcamelize_schemar resolve_refrW)r-r.valrr r! %s  z6CamelCaseJSONFilter.camelize_schema..rAcsg|]}|qSr )r)r-prr r!r1+sz7CamelCaseJSONFilter.camelize_schema..N)r*rr@r2rA)rschemar rr!rs   z#CamelCaseJSONFilter.camelize_schemacKs2t|tjjr|rt||j}|||Sr)rPrrZOR_REF is_camel_caserrWr)rrIrobjr^rr r r!process_result-s z"CamelCaseJSONFilter.process_resultcCs,tdd|Dptdd|DS)Ncs|]}t|tVqdSr)rr)r-parserr r r!r7z4CamelCaseJSONFilter.is_camel_case..csrr)rr)r-rendererr r r!r8r)anyZget_parser_classesZget_renderer_classesrr r r!r5sz!CamelCaseJSONFilter.is_camel_casecCsdS)NFr rr r r!r;r8N) rVrbrcrdrrrrrrr r r r!rs   r)RecursiveFieldc@re)RecursiveFieldInspectorbProvides conversion for RecursiveField (https://github.com/heywbj/django-rest-framework-recursive)N)rVrbrcrdr r r r!rBsrc@r~)rrc 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 )Zignore_unresolvedr>)rPrrrproxiedr rQrGrrr?rWrXrYr[rrTr) rr\r]rMr^rr:r`refr r r!raIsz/RecursiveFieldInspector.field_to_swagger_objectNrr r r r!rFrr)datetimerloggingoperatoruuid contextlibr collectionsrdecimalrrr pkg_resourcesrZ django.corerZ django.dbr packagingrZrest_frameworkr Zrest_framework.settingsr rbaser r rrrrerrorsrutilsrrrrrget_distributionZ drf_version getLoggerrVrrrfrkrhrqrtrvr{rrZ IntegerFieldZ FloatFieldrZnumeric_fieldsZMinValueValidator__gt__ZMaxValueValidator__lt__ZMinLengthValidatorZ CharFieldZMaxLengthValidatorrRrQrrSrZ AutoFieldZ TYPE_INTEGERZ BinaryFieldrZ 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_EMAILZURLFieldrZ RegexFieldZ ModelFieldZserializer_field_to_basic_typeparserDZNullBooleanFieldrrrrrrCintrrdictrEUUIDdaterr;rrrSequence AbstractSetrrrrrrrrrrZ%djangorestframework_camel_case.parserrZ%djangorestframework_camel_case.renderrr ImportErrorrZrest_framework_recursive.fieldsrrr r r r!s             t :#%&        '>9    -