VwgIddlZddlZddlZddlZddlZddlmZddlmZddl m Z ddlm Z ddl Z ddlmZddlmZddlmZdd lmZdd lmZd d lmZmZmZmZd dlmZd dl m!Z!d dl"m#Z#m$Z$m%Z%m&Z&m'Z' ddl(m)Z)e)j&dZ*ej\e/Z0GddeZ1Gdde1Z2dZ3dZ4dMdZ5dZ6dZ7dZ8GddeZ9dZ:ejvejxejzfZ>ej~e>d ejfeje>d!ejfejejd"ejfejejd#ejfejejejfd$ejfejejejfd%ejfgZHd&ZId'ZJejejdffejejejffejejdffejejejffejejejffejzeJejffejejdffejxejdffejvejdffejejejffejejejffejejejffejejdffejejdffejejejffejejdffgZcejejd(Zdejejejffejejejffejejejffejejd)ffejejejffejejdffejejdffejejdffejvejdffejxejdffejzeJejffejejdffejejejffejejejffejejdffgZkeje*ejd*krRecjejejdffekjejejdffekeczZod+Zpd,Zqd-Zrd.Zsetejdffeuejdffevejdffewejdffexejdffe eqejffejejejffejejejffejejejffg Z|e}e d/r e jZnd0Zd1Ze|je je jfefd2Zd3ZGd4d5eZGd6d7eZGd8d9eZGd:d;eZGd<d=eZGd>d?eZGd@dAeZGdBdCeZ ddDlmZddElmZmZGdGdHeZ ddIlmZGdJdKeZy#e+$r$ddl,Z,e,jZdj&Z*Y8wxYw#e+$r dxZZdFZYXwxYw#e+$rGdLdKeZYywxYw)NN)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_name)metadatadjangorestframeworkcDeZdZdZdZdZdZdZdZdZ dZ d Z d Z y ) InlineSerializerInspectorzVProvides serializer conversions using :meth:`.FieldInspector.field_to_swagger_object`.FcX|j|tj|jSN)probe_field_inspectorsrSchemause_definitionsself serializers P/var/www/horilla/myenv/lib/python3.12/site-packages/drf_yasg/inspectors/field.py get_schemaz$InlineSerializerInspector.get_schema)s!**:w~~tG[G[\\c|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$ parameterss r%add_manual_parametersz/InlineSerializerInspector.add_manual_parameters,s r'c  t|di}|jDcgc]O\}}t|dds=|j|tj|j |j ||Q}}}|j||Scc}}w)Nfields read_onlyF)namein_)getattritemsrr Parameterr!get_parameter_namer+)r#r$r0r-keyvaluer*s r%get_request_parametersz0InlineSerializerInspector.get_request_parameters7sXr2||~  U5+u5  ' 'w(($*>*>,,S1s (   ))*jAA sAB c|Srr)r# field_names r%get_property_namez+InlineSerializerInspector.get_property_nameEr'c|Srr)r9s r%r4z,InlineSerializerInspector.get_parameter_nameHr<r'ct|Sr)rr"s r%rz1InlineSerializerInspector.get_serializer_ref_nameKs &z22r'c4t|dd}t|dS)NMetaref_name)r1hasattr)r#r$serializer_metas r% _has_ref_namez'InlineSerializerInspector._has_ref_nameNs!*fd; 33r'c lj||fi|\t|tjtjfrEj |j }t|xsi}dtj|d|St|tjr |tjk7rtd|jzj|}|ffd }|rs|Sjj!tj"} | j%||} | j't)| dd} t+|} | r=| | k7r8j-| xrj-| } | std| d| dtj.| |St0S) Ntyper2z(cannot instantiate nested serializer as ct}g}|jjD]\}} j|}dt |j xsdi}t |} j| fi|}|||<|jsdt|ddrr|j| dtj||xsd}t|dt||S)Nr.F)use_field_titlerG propertiesrequired_NP_serializer)rr-r2r;boolr.rrrKr1appendr TYPE_OBJECTsetattrr) r$rJrK property_namechild prop_kwargs child_schemaresultChildSwaggerType SwaggerTyper#use_referencess r%make_schema_definitionzQInlineSerializerInspector.field_to_swagger_object..make_schema_definitioncs(] ,6,=,=,C,C,E 7(M5$($:$:=$IM#T%//%:%Bd#K#.k":K#>4#>#>/$CN$L1=J}-~~glKQV.W  6 7%%* ,,)%-  02Fz2RS r'rLz Schema for z$ would override distinct serializer zy because they implicitly share the same ref_name; explicitly set the ref_name attribute on both serializers' Meta classesr))_get_partial_types isinstancer ListSerializer ListFieldrrR find_limitsr TYPE_ARRAY Serializerr r__name__r components with_scopeSCHEMA_DEFINITIONS setdefault_remove_read_onlyr1rrD SchemaRefr)r#fieldswagger_object_typerXkwargsrTlimitsrArY definitions actual_schemaactual_serializerthis_serializer explicit_refsrVrWs` ` @@r%field_to_swagger_objectz1InlineSerializerInspector.field_to_swagger_objectRs(?(?(?GZ\j(unt(u% % ek88+:O:OP Q66u{{DTVdeL '-2F''"  {55 6"gnn4,-WZmZvZv-vww33E:H27  <>-////44W5O5OPK'228=STM  + + - ' 7G N 259O %6/%I $ 2 23D E m$J\J\]lJm $0-o?@@ $$[(; ;r'N) ra __module__ __qualname____doc__r!r&r+r7r;r4rrDrqr)r'r%rr#s7`O]  B34Br'rceZdZdZy)ReferencingSerializerInspectorTN)rarrrsr!r)r'r%rvrvsOr'rvc<t|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)r1get_model_field)querysetr:rx model_fields r%get_queryset_fieldr|s) Hgt ,E!%4K + r'c |dk(r|jjS|jj|S#t$rYywxYw)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)_metar~ get_field Exception)rxr:s r%ryrysD  ;;>> !;;((4 4 s88 AAc~ t|dd}||t|t|ddk(sJ|S#t$rYywxYw)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_querysetrzNrserializer_class)r rGr)viewr$rzs r%get_queryset_from_viewrsV #D.*E  J$: #'7>TVh'ii ii s -0 <<c^|+t|tjr|S|j}|+y)zqGet the nearest parent ``Serializer`` instance for the given field. :return: ``Serializer`` or ``None`` N)r[r r`parentrhs r%get_parent_serializerrs5   e[33 4L    r'ctt5 |jjcdddS#t$r,|jj j cYcdddSwxYw#1swYyxYwr)rrrel related_modelrh remote_fieldrx) descriptors r%get_model_from_descriptorrsi ) 7 7>>//77 7##0066 6 77 777s&A)1)A&A)%A&&A))A2c tt5d|vrO|jdr>|jdd\}}t t t |||cdddSt t ||cdddS#1swYyxYw)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)rrindexsplitget_related_modelrr1)rxsourceattrs r%rrs ) A &=V\\#.!<<a<8LD&$%>wud?S%TV\]AA))?@ AAAsA B$BB ceZdZdZdZy)RelatedFieldInspectorz-Provides conversions for ``RelatedField``\ s.c v|j|||fi|\}}t|tjr6|j |j ||}|t j|dSt|tjstSt|dd}t|tjtjfr4t|ddr(|j|j||fi|} || St|dd} |t|| \} } nt|} t| d d}t|d d}|s#t!|j"| }t|d d}t|d dxs |j$}|s:t|j&tjr|j&j$}t)||} t+| | } t-| xsd t j.i}|di|St|tj0r&|t j.t j2 StS)NT)rGr2 unique_itemsrzpk_field)existing_object slug_fieldr~r@rxrrG)rGformatr))rZr[r ManyRelatedFieldrchild_relationrr_ RelatedFieldrr1PrimaryKeyRelatedFieldSlugRelatedFieldrr|rrrr:rrryget_basic_type_info TYPE_STRINGHyperlinkedRelatedField FORMAT_URI)r#rhrirXrjrWrVrTfield_querysetrU target_fieldrxr{parent_serializerrC this_model view_querysetrattrss r%rqz-RelatedFieldInspector.field_to_swagger_objects (?(?(?GZ\j(unt(u% % e[99 :66u7K7KM]_mnL''"!  %!9!9:   D9 ek@@+B^B^_ `uj"-544U^^EXZhslrs#6::"5,=L)%7 %U"{%:%$@!")*;VT"J$_gtD !$:499FW$XM!(!FJ "5I9I9I*U\\;;W;W"X"\\44F)*f=-e\B ' 4UATAT8UE'' ' {BB CG$7$7@R@RS Sr'Nrarrrsrtrqr)r'r%rrs 84r'rcd}|jD]Q}t|tjst|tjs|tjk(rL|y|}S t t |dddd}|r*|jds|jdr|dd d z}|S#t $r&tjdt|zdYywxYw) 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$) rr[RegexValidator URLValidatorvalidate_ipv4_addressr1rloggerwarningstrendswith) regex_fieldregex_validator validatorrs r% find_regexr*sO ++ ( i!:!: ;)Z%<%<=jNnNnAn*'O ('/7DA9dS    E "g&6&6u&=crlS(G N >[AQQ\`as$B**,CCminimummaximum min_length max_length min_items max_itemsc bi}tDcgc]\}}}}t||r|||f}}}}}t|tjr t |s|S|j D]o}t |ds|j}t|trt |r t|}|D])\}}}t||s||vs ||||s%|||<+qt |dr&|js|jdddkrd|d<tt|jScc}}}}w)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 limit_value allow_blankrrr )limit_validatorsr[r DecimalFieldrrrBrrfloatrgetrsortedr2) rhrkr field_classrimprovesapplicable_limitsrvalidator_classs r%r^r^]s:F7G 2I{D( e[ ) D(# %112;KE;R %% / y-0 ++ k7 +0@0G ,K/@ / +OT8)_5v%+vd|)L#.F4L / /um$U->-> ::lA & *#$F< vflln- ..5sD) cXt|rtjStjSr)rr TYPE_NUMBERrrs r%decimal_field_typers "25"97  Rw?R?RRr')ipv4ipv6cBtj|jdSr) ip_formatrprotocolrs r%rsY]]SXSaSacgEhr'z3.14.0cR|ytD]>\}}t||s|\}}t|r||}t|r||}nyd}|tjk(r t |}t |}td|fd|fd|fg}|j|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 NrGrr) basic_type_infor[callablerrrr^rupdater)rhr type_format swagger_typerrrkrUs r%rrs }$3  [ e[ )#. L& %+E2   Gw***U#  F   6 GF  MM&  F Mr'cbtjrtjStjSr)rest_framework_settingsCOERCE_DECIMAL_TO_STRINGrrrr)r'r%decimal_return_typers""9"R"R7  kX_XkXkkr'c$t|ddxs|S)N __origin__r1) hint_classs r%get_origin_typers :|T 2 @j@r'c^t|}tj|xr t||Sr)rinspectisclass issubclass)r check_class origin_types r%hint_class_issubclassrs'!*-K ??; ' PJ{K,PPr'get_argsct|ddS)N__args__r)r)tps r%typing_get_argsrsr:r**r'c t|}|r|dnt}t|xsdtji}t dtj fdtjdi|fgS)NrrGr2r))rrget_basic_type_info_from_hintrrrr_Items)rargs child_classchild_type_infos r%inspect_collection_hint_classrsg : &D!$q'sK3K@aVWM`M`DaO  ##$ '--2/23 r'cVt|}|tjur |jSyr)rtypingUnionr)rrs r%_get_union_typesrs)!*-Kfll""""#r'c:t|}|r5t|dk(r&td|drt|d}|rd|d<|SytD]P\}}t ||st |r ||cS|\}}t |r|}td|fd|fgcSy) 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-nullablerGr)rlenr[rhinting_type_inforrr)r union_typesrUrinforrs r%rrs#:.K { q Zk!n%E2;q>BF'+|$M.  T [ 9~J''#' L& %+~ &6"    r'ceZdZdZdZy)SerializerMethodFieldInspectorzProvides conversion for SerializerMethodField, optionally using information from the swagger_serializer_method decorator. c 8t|tjstSt |j |j d}|tSt |dd}|r|j}| t |dd}| |j}|j}| t |dd}tj|r||dd} |jd i| }n||_||_ d|_ |j|||dSt|j } tj| st#| dr| j$d} tj| rGt'| tj(s-t+| } | |j,|||fi|\} } | d i| StS) N_swagger_serializer help_textlabelT)r rr.)r.rrr))r[r SerializerMethodFieldrr1r method_namer rtrrrr r.rinspect_signaturereturn_annotationrBrr_emptyrrZ)r#rhrirXrjmethodr$ descriptionrserializer_kwargsr type_inforWrVs r%rqz6SerializerMethodFieldInspector.field_to_swagger_objectBs%!B!BC u'8'8$? > V%:DA   //K"%j+tD "$nn KKE} GT:z*!,"!%%! 8V77L:KL '2 $#(  '+ $..z;NP^jn.o o+62DDJ??:.7:z3R'003 z*:j'..3Y9*E (4KD4K4KESfLZ5f^d5f1K!1&333r'Nrr)r'r%r r =s 6r'r ceZdZdZdZy)SimpleFieldInspectorzProvides conversions for fields which can be described using just ``type``, ``format``, ``pattern`` and min/max validators. c ht|}|tS|j|||fi|\}}|di|S)Nr))rrrZ)r#rhrirXrjrrWrVs r%rqz,SimpleFieldInspector.field_to_swagger_objectsJ'.   (?(?(?GZ\j(unt(u% %'Y''r'Nrr)r'r%rr{s (r'rceZdZdZdZy)ChoiceFieldInspectorzEProvides conversions for ``ChoiceField`` and ``MultipleChoiceField``.c t|j|||fi|\}}t|tjrtj }g}|j jD]J} t|tjrt|| gd} n t|| } |j| Lt|} t| tjrtt| dd} t| |jxs|j j} t| ddr | j"} | rwt%| } | rj| j'd|}nW|Dchc] }t)|}}t+|dk(r1t-t/t1|}|r|j'd|}t|tjra|tj2|||}|tj4k(r,|d tj6tj8fvrd |_|S|||}|St<Scc}w) Nrr@rx base_fieldrGr )rGenumrFinmulti)rZr[r ChoiceFieldrrchoiceskeysMultipleChoiceFieldrrNrModelSerializerr1ryrrrrrrGrrnextiterr_r3IN_FORMIN_QUERYcollection_formatr)r#rhrirXrjrWrV enum_type enum_valueschoicer$rxr{ model_typevenum_value_types values_typerUs r%rqz,ChoiceFieldInspector.field_to_swagger_objects(?(?(?GZ\j(unt(u% % e[44 5++IK--,,. +e[%D%DE:56(KANF:5&IF""6*  +/u5J*k&A&AB F ;WE-eU\\5XU\\EXEXY ; d;"-"8"8K!4[!AJ!$.NN69$E 6A#ADG#A #A'(A-"?TJZE[@\"]K"$/OOFI$F %!@!@A$ ++*&(''*;*;;d|9I9I'JJ3:0M%)+FM-$BsH5Nrr)r'r%rrs O3r'rceZdZdZdZy)FileFieldInspectorz*Provides conversions for ``FileField``\ s.c |j|||fi|\}}t|tjrt d}|t j k(rJ|t jd}t|dtjrt j|_ |S|t jk(r1|t j} | dt jk7r|| S|t S)NzFFileField is supported only in a formData Parameter or response SchemaT)rGr.use_urlrGr )rZr[r FileFieldrrr rr1rUPLOADED_FILES_USE_URLrrr3 TYPE_FILEr)r) r#rhrirXrjrWrVerrrUparams r%rqz*FileFieldInspector.field_to_swagger_objects(?(?(?GZ\j(unt(u% % e[22 3))qrC"gnn4$'*=*=N5)-D-[-[\$+$6$6FM $(9(99#):):;;'//1I  r'Nrr)r'r%r4r4s 5r'r4ceZdZdZdZy)DictFieldInspectorz&Provides conversion for ``DictField``.c |j|||fi|\}}t|tjrH|tj k(r5|j |j||}|tj|StS)N)rGadditional_properties) rZr[r DictFieldrr rrRrOr)r#rhrirXrjrWrVrTs r%rqz*DictFieldInspector.field_to_swagger_objects}(?(?(?GZ\j(unt(u% % e[22 38Kw~~8]66u{{DTVdeL((&2  r'Nrr)r'r%r>r>s 0 r'r>ceZdZdZdZy)HiddenFieldInspectorzHide ``HiddenField``.c Dt|tjrytSr)r[r HiddenFieldr)r#rhrirXrjs r%rqz,HiddenFieldInspector.field_to_swagger_objects e[44 5r'Nrr)r'r%rCrCs r'rCceZdZdZdZy)JSONFieldInspectorz&Provides conversion for ``JSONField``.c |j|||fi|\}}t|tjr*|tj k(r|tj StSNr7)rZr[r JSONFieldrr rOrr#rhrirXrjrWrVs r%rqz*JSONFieldInspector.field_to_swagger_objectsY(?(?(?GZ\j(unt(u% % e[22 38Kw~~8]G$7$78 8r'Nrr)r'r%rGrGs 0r'rGceZdZdZdZy)StringDefaultFieldInspectorzRFor otherwise unhandled fields, return them as plain :data:`.TYPE_STRING` objects.c `|j|||fi|\}}|tjSrI)rZrrrKs r%rqz3StringDefaultFieldInspector.field_to_swagger_objects7(?(?(?GZ\j(unt(u% % 3 344r'Nrr)r'r%rMrMs \5r'rM)CamelCaseJSONParser)CamelCaseJSONRenderercamelizec|Srr))datas r%rQrQs r'c8eZdZdZdZdZdZererdZ ydZ y)CamelCaseJSONFilterzSConverts property names to camelCase if ``djangorestframework_camel_case`` is used.c@ttt|diS)zHack to force ``djangorestframework_camel_case`` to camelize a plain string. :param str s: the string :return: camelized string :rtype: str r)r'r(rQ)r#ss r%camelize_stringz#CamelCaseJSONFilter.camelize_stringsD1b'*+,,r'ct|dirntfd|jjD|_t|dgr/|jDcgc]}j |c}|_yyycc}w)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 rJc3K|]K\}}j|jtj|jxs|fMywr)rXcamelize_schemar resolve_refrb).0r5valr#s r% z6CamelCaseJSONFilter.camelize_schema..)sS,C%%c*D,@,@ATATUXZ^ZiZiAj,k,rors,sAArKN)r1rrJr2rKrX)r#schemaps` r%r[z#CamelCaseJSONFilter.camelize_schema"sy 6< , +, & 1 1 7 7 9,!F  vz2.DJOO"Tq4#7#7#:"T/ -#UsA>c t|tjjrA|j r1tj ||j }|j||Sr)r[rr OR_REF is_camel_caser\rbr[)r#rUrobjrjr`s r%process_resultz"CamelCaseJSONFilter.process_result1sJ fgnn33 49K9K9M((AF   ( r'ctd|jDxs td|jDS)Nc3<K|]}t|tywr)rrO)r]parsers r%r_z4CamelCaseJSONFilter.is_camel_case..;sdJv':;dc3<K|]}t|tywr)rrP)r]renderers r%r_z4CamelCaseJSONFilter.is_camel_case..<slHJx)>?lrj)anyget_parser_classesget_renderer_classesr#s r%rdz!CamelCaseJSONFilter.is_camel_case9s<d$JaJaJcddmlPTPiPiPkll r'cy)NFr)rps r%rdz!CamelCaseJSONFilter.is_camel_case?sr'N) rarrrsrtrXr[rfrOrPrdr)r'r%rUrUs']- U4   r'rU)RecursiveFieldceZdZdZdZy)RecursiveFieldInspectorbProvides conversion for RecursiveField (https://github.com/heywbj/django-rest-framework-recursive)c Nt|tr|tjk(r|dusJd|j}t|jt j r |j}t|}|Jdtt|z|jjtj}tj||d}t|jt j r%tjtj |}|St"S)NTzECan not create schema for RecursiveField when use_references is Falsez.Can't create RecursiveField schema for inline )ignore_unresolvedrF)r[rrrr proxiedr r\rRrrrGrbrcrdrgrr_r) r#rhrirXrjrxrArlrefs r%rqz/RecursiveFieldInspector.field_to_swagger_objectMs%05HGNN5Z%-v/vv---emm[-G-GH%mmG27;+r-]`cdhipdq`r-rr+"oo889S9ST '' XQUVemm[-G-GH!--W-?-?sKC  r'Nrr)r'r%rtrtJs p r'rtceZdZdZy)rtruN)rarrrsrtr)r'r%rtrtFsp r'r)datetimerloggingoperatoruuid contextlibr collectionsrdecimalrrrr django.corer django.dbr packagingr rest_frameworkr rest_framework.settingsr rbaser rrrrrerrorsrutilsrrrrr importlibr drf_version ImportError pkg_resourcesget_distribution getLoggerrarrrvr|ryrrrrrr IntegerField FloatFieldrnumeric_fieldsMinValueValidator__gt__MaxValueValidator__lt__MinLengthValidator CharFieldMaxLengthValidatorr]r\rr^r 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_typeparserNNullBooleanFieldrrrrrrMintrrdictrOUUIDdaterrBrrrSequence AbstractSetrrr rrr4r>rCrGrM%djangorestframework_camel_case.parserrO%djangorestframework_camel_case.renderrPrQrUrest_framework_recursive.fieldsrrrtr)r'r%rs #2 "&KSS+P""(""#89K   8 $q 3qh%>   & 7 A7N7t F**K,B,BKD\D\]!!>9hooN!!>9hooN""K$9$9<Y""K$9$9<Y""[%:%:K?#))  % %(<(?  6:ooO+6??F,>,>?A^_`# $N;^;| (> (6>6r6   >  5.5IU*.*Z> .]P0-001FGOOKPf266/l  .  s66^2_ _%__ ___/._/