2iddlZddlZddlZddlZddlZddlmZddlmZddl 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 jRdj(Z*ejVe,Z-GddeZ.Gdde.Z/dZ0dZ1dLdZ2dZ3dZ4dZ5GddeZ6dZ7ejpejrejtfZ;ejxe;dejzfej|e;d ej~fejejd!ejzfejejd"ej~fejejejfd#ejzfejejejfd$ej~fgZEd%ZFd&ZGeje jdffeje je jffeje jdffeje je jffeje je jffejteGe jffeje jdffejre jdffejpe jdffeje je jffeje je jffeje je jffeje jdffeje jdffeje je jffeje jdffgZ`e je jd'Zaeje je jffeje je jffeje je jffeje jd(ffeje je jffeje jdffeje jdffeje jdffejpe jdffejre jdffejteGe jffeje jdffeje je jffeje je jffeje jdffgZheje*ejd)krRe`jeje jdffehjeje jdffehe`zZld*Zmd+Znd,Zod-Zpeqe jdffere jdffese jdffete jdffeue jdffe ene jffeje je jffeje je jffeje je jffg Zyezed.r ejZ|nd/Z|d0Z}eyjejejfe}fd1Zd2ZGd3d4eZGd5d6eZGd7d8eZGd9d:eZGd;deZGd?d@eZGdAdBeZ ddClmZddDlmZmZGdFdGeZ ddHlmZGdIdJeZy#e$r dxZZdEZY,wxYw#e$rGdKdJeZYywxYw)MN)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_namedjangorestframeworkcDeZdZdZdZdZdZdZdZdZ 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/html/acx/venv/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#r/r,keyvaluer)s r$get_request_parametersz0InlineSerializerInspector.get_request_parameters3sXr2||~  U5+u5  ' 'w(($*>*>,,S1s (   ))*jAA sAB c|Srr(r" field_names r$get_property_namez+InlineSerializerInspector.get_property_nameAr&c|Srr(r8s r$r3z,InlineSerializerInspector.get_parameter_nameDr;r&ct|Sr)rr!s r$rz1InlineSerializerInspector.get_serializer_ref_nameGs &z22r&c4t|dd}t|dS)NMetaref_name)r0hasattr)r"r#serializer_metas r$ _has_ref_namez'InlineSerializerInspector._has_ref_nameJs!*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) Ntyper1z(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_titlerF propertiesrequired_NP_serializer)rr,r1r:boolr-rrrJr0appendr TYPE_OBJECTsetattrr) r#rIrJ property_namechild prop_kwargs child_schemaresultChildSwaggerType SwaggerTyper"use_referencess r$make_schema_definitionzQInlineSerializerInspector.field_to_swagger_object..make_schema_definition_s(] ,6,=,=,C,C,E 7(M5$($:$:=$IM#T%//%:%Bd#K#.k":K#>4#>#>/$CN$L1=J}-~~glKQV.W  6 7%%* ,,)%-  02Fz2RS r&rKz 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 ListFieldrrQ find_limitsr TYPE_ARRAY Serializerrr__name__r components with_scopeSCHEMA_DEFINITIONS setdefault_remove_read_onlyr0rrC SchemaRefr)r"fieldswagger_object_typerWkwargsrSlimitsr@rX definitions actual_schemaactual_serializerthis_serializer explicit_refsrUrVs` ` @@r$field_to_swagger_objectz1InlineSerializerInspector.field_to_swagger_objectNs(?(?(?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) r` __module__ __qualname____doc__r r%r*r6r:r3rrCrpr(r&r$rrs7`O]  B34Br&rceZdZdZy)ReferencingSerializerInspectorTN)r`rqrrr r(r&r$rurusOr&ruc<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)r0get_model_field)querysetr9rw 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)rwr9s r$rxrxsD  ;;>> !;;((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_querysetryNrserializer_class)r rFr)viewr#rys 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)rZr r_parentrgs r$get_parent_serializerrs5   e[33 4L    r&ctt5 |jjcdddS#t$r,|jj j cYcdddSwxYw#1swYyxYwr)rrrel related_modelrg remote_fieldrw) 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_modelrr0)rwsourceattrs 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)rFr1 unique_itemsrypk_field)existing_object slug_fieldr}r?rwrrF)rFformatr()rYrZr ManyRelatedFieldrchild_relationrr^ RelatedFieldrr0PrimaryKeyRelatedFieldSlugRelatedFieldrr{rrrr9rrrxget_basic_type_info TYPE_STRINGHyperlinkedRelatedField FORMAT_URI)r"rgrhrWrirVrUrSfield_querysetrT target_fieldrwrzparent_serializerrB this_model view_querysetrattrss r$rpz-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&Nr`rqrrrsrpr(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$) rrZRegexValidator URLValidatorvalidate_ipv4_addressr0rloggerwarningstrendswith) 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_validatorsrZr DecimalFieldrrrArrfloatrgetrsortedr1) rgrjr field_classrimprovesapplicable_limitsrvalidator_classs r$r]r]Ys: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_typer~s "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 NrFrr) basic_type_inforZcallablerrrr]rupdater)rgr type_format swagger_typerrrjrTs 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__r0) 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)NrrFr1r()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_typesr s)!*-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-nullablerFr)rlenrZrhinting_type_inforrr)r union_typesrTrinforrs 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 r r-)r-rrr()rZr SerializerMethodFieldrr0r method_namer rsr rrr r-rinspect_signaturereturn_annotationrArr_emptyrrY)r"rgrhrWrimethodr# descriptionr serializer_kwargsr type_inforVrUs r$rpz6SerializerMethodFieldInspector.field_to_swagger_object>s%!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 9s 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()rrrY)r"rgrhrWrirrVrUs r$rpz,SimpleFieldInspector.field_to_swagger_object|sJ'.   (?(?(?GZ\j(unt(u% %'Y''r&Nrr(r&r$rrws (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?rw base_fieldrFr )rFenumrEinmulti)rYrZr ChoiceFieldrrchoiceskeysMultipleChoiceFieldrrMrModelSerializerr0rxrrrrrrFrrnextiterr^r2IN_FORMIN_QUERYcollection_formatr)r"rgrhrWrirVrU enum_type enum_valueschoicer#rwrz model_typevenum_value_types values_typerTs r$rpz,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)rFr-use_urlrFr)rYrZr FileFieldrrrrr0rUPLOADED_FILES_USE_URLrrr2 TYPE_FILEr(r) r"rgrhrWrirVrUerrrTparams r$rpz*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$r3r3s 5r&r3ceZdZdZdZy)DictFieldInspectorz&Provides conversion for ``DictField``.c |j|||fi|\}}t|tjrH|tj k(r5|j |j||}|tj|StS)N)rFadditional_properties) rYrZr DictFieldrrrrQrNr)r"rgrhrWrirVrUrSs r$rpz*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)rZr HiddenFieldr)r"rgrhrWris r$rpz,HiddenFieldInspector.field_to_swagger_objects e[44 5r&Nrr(r&r$rBrBs r&rBceZdZdZdZy)JSONFieldInspectorz&Provides conversion for ``JSONField``.c |j|||fi|\}}t|tjr*|tj k(r|tj StSNr6)rYrZr JSONFieldrrrNrr"rgrhrWrirVrUs r$rpz*JSONFieldInspector.field_to_swagger_objectsY(?(?(?GZ\j(unt(u% % e[22 38Kw~~8]G$7$78 8r&Nrr(r&r$rFrFs 0r&rFceZdZdZdZy)StringDefaultFieldInspectorzRFor otherwise unhandled fields, return them as plain :data:`.TYPE_STRING` objects.c `|j|||fi|\}}|tjSrH)rYrrrJs r$rpz3StringDefaultFieldInspector.field_to_swagger_objects7(?(?(?GZ\j(unt(u% % 3 344r&Nrr(r&r$rLrLs \5r&rL)CamelCaseJSONParser)CamelCaseJSONRenderercamelizec|Srr()datas r$rPrPs 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'rP)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 rIc3K|]K\}}j|jtj|jxs|fMywr)rWcamelize_schemar resolve_refra).0r4valr"s r$ z6CamelCaseJSONFilter.camelize_schema..%sS,C%%c*D,@,@ATATUXZ^ZiZiAj,k,rors,sAArJN)r0rrIr1rJrW)r"schemaps` r$rZz#CamelCaseJSONFilter.camelize_schemasy 6< , +, & 1 1 7 7 9,!F  vz2.DJOO"Tq4#7#7#:"T/ -#UsA>c t|tjjrA|j r1tj ||j }|j||Sr)rZrrOR_REF is_camel_caser[rarZ)r"rTrobjrir_s r$process_resultz"CamelCaseJSONFilter.process_result-sJ fgnn33 49K9K9M((AF   ( r&ctd|jDxs td|jDS)Nc3<K|]}t|tywr)rrN)r\parsers r$r^z4CamelCaseJSONFilter.is_camel_case..7sdJv':;dc3<K|]}t|tywr)rrO)r\renderers r$r^z4CamelCaseJSONFilter.is_camel_case..8slHJx)>?lri)anyget_parser_classesget_renderer_classesr"s r$rcz!CamelCaseJSONFilter.is_camel_case5s<d$JaJaJcddmlPTPiPiPkll r&cy)NFr(ros r$rcz!CamelCaseJSONFilter.is_camel_case;sr&N) r`rqrrrsrWrZrerNrOrcr(r&r$rTrTs']- U4   r&rT)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_unresolvedrE)rZrqrrproxiedr r[rQrrrFrarbrcrfrr^r) r"rgrhrWrirwr@rkrefs r$rpz/RecursiveFieldInspector.field_to_swagger_objectIs%05HGNN5Z%-v/vv---emm[-G-GH%mmG27;+r-]`cdhipdq`r-rr+"oo889S9ST '' XQUVemm[-G-GH!--W-?-?sKC  r&Nrr(r&r$rsrsFs p r&rsceZdZdZy)rsrtN)r`rqrrrsr(r&r$rsrsBsp r&r)datetimerloggingoperatoruuid contextlibr collectionsrdecimalrrr pkg_resourcesr django.corer django.dbr packagingr rest_frameworkr rest_framework.settingsr rbaser rrrrrerrorsrutilsrrrrrget_distribution drf_version getLoggerr`rrrur{rxrrrrrr 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_typeparserMNullBooleanFieldrrrrrrLintrrdictrNUUIDdaterrArrrSequence AbstractSetrrr rrr3r=rBrFrL%djangorestframework_camel_case.parserrN%djangorestframework_camel_case.renderrOrP ImportErrorrTrest_framework_recursive.fieldsrqrsr(r&r$rs #2 "&KSS+-m,,-BCKK   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> .w266/l  .  s$7^#^5# ^21^25__