VwgDddlZddlmZddlmZddlmZddlmZddl m Z ddl m Z dd l mZmZmZmZmZmZmZmZmZd d lmZmZej4eZGd d eZy)N) OrderedDictis_form_media_type) AutoSchema) is_success)openapi)SwaggerGenerationError) filter_noneforce_real_strforce_serializer_instance get_consumes get_producesguess_response_status merge_paramsno_bodyparam_list_to_odict) ViewInspectorcall_view_methodceZdZdfd ZddZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZddZdZdZdZdZddZdZdZxZS)SwaggerAutoSchemactt| ||||||t|_||j_||_yN)superr__init__r_schviewoperation_keys) selfrpathmethod componentsrequest overridesr __class__s O/var/www/horilla/myenv/lib/python3.12/site-packages/drf_yasg/inspectors/view.pyrzSwaggerAutoSchema.__init__s; /dFJPWYbcL  ,c D|xs |j}|j}|j}|j|}|j }||z}t |}|j |}|j|}|j\}} |j} | t| tsJd|j} |j|} |j} tj |t#| t#|| |||| | |  S)Nz7security must be a list of security requirement objects) operation_id descriptionsummary responses parametersconsumesproducestagssecurity deprecated)rrrget_request_body_parametersget_query_parametersr add_manual_parametersget_operation_idget_summary_and_description get_security isinstancelist is_deprecatedget_tags get_responsesr Operationr )r rr/r0bodyqueryr.r*r,r+r2r3r1r-s r' get_operationzSwaggerAutoSchema.get_operations '>4+>+>$$&$$&//9))+E\  , // ; ,,^< #??A$$&:h#=x?xx='') }}^,&&(   %&{3"7+!!  r(c,|j}d}|gSt|tjjr|}t d|Dr| t d|j|S||j|}||j|gSgS)aReturn the request body parameters for this view. |br| This is either: - a list with a single object Parameter with a :class:`.Schema` derived from the request serializer - a list of primitive Parameters parsed as form data :param list[str] consumes: a list of accepted MIME types as returned by :meth:`.get_consumes` :return: a (potentially empty) list of :class:`.Parameter`\ s either ``in: body`` or ``in: formData`` :rtype: list[openapi.Parameter] Nc32K|]}t|ywrr.0encodings r' z@SwaggerAutoSchema.get_request_body_parameters..OsE!(+Ez$form request body cannot be a Schema) get_request_serializerr:r SchemaOR_REFanyr get_request_form_parametersget_request_body_schemamake_body_parameter)r r/ serializerschemas r'r4z-SwaggerAutoSchema.get_request_body_parameters<s002   I j'.."7"7 8F EHE E!,-STT33J? ?~55jA9?9KD,,V45 SQS Sr(c.t|jdS)zReturn the serializer as defined by the view's ``get_serializer()`` method. :return: the view's ``Serializer`` :rtype: rest_framework.serializers.Serializer get_serializer)rrr s r'get_view_serializerz%SwaggerAutoSchema.get_view_serializerXs   +;<4@  $'{{$"3"33,-TWZW_W_`d`q`qWr-r-l.mnn-)>)>?$$,]; ;r(c|j}|(|j|jvr|jS|tury|S)zReturn the request serializer (used for parsing the request payload) for this endpoint. :return: the request serializer, or one of :class:`.Schema`, :class:`.SchemaRef`, ``None`` :rtype: rest_framework.serializers.Serializer N)r_r"implicit_body_methodsrVrr]s r'rJz(SwaggerAutoSchema.get_request_serializerpsI 779  T[[D4N4N%N++- - G #r(cD|j|tjS)zGiven a Serializer, return a list of ``in: formData`` :class:`.Parameter`\ s. :param serializer: the view's request serializer as returned by :meth:`.get_request_serializer` :rtype: list[openapi.Parameter] in_)serializer_to_parametersr IN_FORMr rQs r'rNz-SwaggerAutoSchema.get_request_form_parameterss ,,ZW__,MMr(c$|j|S)zReturn the :class:`.Schema` for a given request's body data. Only applies to PUT, PATCH and POST requests. :param serializer: the view's request serializer as returned by :meth:`.get_request_serializer` :rtype: openapi.Schema )serializer_to_schemargs r'rOz)SwaggerAutoSchema.get_request_body_schemas ((44r(cPtjdtjd|S)zGiven a :class:`.Schema` object, create an ``in: body`` :class:`.Parameter`. :param openapi.Schema schema: the request body schema :rtype: openapi.Parameter dataT)namerdrequiredrR)r ParameterIN_BODY)r rRs r'rPz%SwaggerAutoSchema.make_body_parameters   f'//DY_``r(c|jjddxsg}td|Dr tdtd|Drtd|D}|s td|j Ds td|j |j vr*td d j|j zd zt||S) zAdd/replace parameters from the given list of automatically generated request parameters. :param list[openapi.Parameter] parameters: generated parameters :return: modified parameters :rtype: list[openapi.Parameter] manual_parametersNc3VK|]!}|jtjk(#ywrrdr rorFparams r'rHz:SwaggerAutoSchema.add_manual_parameters..KuyyGOO+K')zDspecify the body parameter as a Schema or Serializer in request_bodyc3VK|]!}|jtjk(#ywr)rdr rfrts r'rHz:SwaggerAutoSchema.add_manual_parameters..rvrwc3VK|]!}|jtjk(#ywrrsrts r'rHz:SwaggerAutoSchema.add_manual_parameters..s$ZeUYY'//%A$Zrwc32K|]}t|ywrrrEs r'rHz:SwaggerAutoSchema.add_manual_parameters..s,nh-?-I,nrIz~cannot add form parameters when the request has a request body; did you forget to set an appropriate parser class on the view?z(form parameters can only be applied to (rYz) HTTP methods) r%rZrMr rr"r[r\r)r r.rqhas_body_parameters r'r6z'SwaggerAutoSchema.add_manual_parameterss!NN../BDIOR K9JK K()op p K9JK K!$$Zz$Z!Z !,nZ^ZkZkZm,n)n,.noo{{$"3"33,.13688DzSwaggerAutoSchema.get_responsess5 $<<>  //0DE  r(cZ|j}|r |tur|S|jS)aReturn the default response serializer for this endpoint. This is derived from either the ``request_body`` override or the request serializer (:meth:`.get_view_serializer`). :return: response serializer, :class:`.Schema`, :class:`.SchemaRef`, ``None`` )r_rrVr]s r'get_default_response_serializerz1SwaggerAutoSchema.get_default_response_serializers1 779 ]'9 ''))r(c|jj}t|}d}|dvr|j}|xsd}|r/t |t j s|j|xsd}|rZ|jr%t j t j|}|jr|j|xs|}tt||iS)zGet the default responses determined for this view from the request serializer and request method. :type: dict[str, openapi.Schema] )rZpostputpatch)typeitems)r"lowerrrr:r rKrihas_list_response TYPE_ARRAY should_pageget_paginated_responserstr)r r"default_statusdefault_schemas r'get_default_responsesz'SwaggerAutoSchema.get_default_responsess ""$.v6 4 4!AACN'-2 *^W^^"L!66~FL"N %%'!(W5G5G~!^!!%!` for more details. :return: the response serializers :rtype: dict r-Nc3<K|]\}}t||fywrrrFscresps r'rHz=SwaggerAutoSchema.get_response_serializers..s&`82tB&`c3PK|]}|dk7s tt| yw)defaultN)rint)rFrs r'rHz=SwaggerAutoSchema.get_response_serializers..sU2R9_:c"g&Us &&c3<K|]\}}t||fywrrrs r'rHz=SwaggerAutoSchema.get_response_serializers..sRXR#b'4Rr)r%rZrrrMrupdate)r manual_responsesr-s r'r}z*SwaggerAutoSchema.get_response_serializerss >>--k4@FB&&`GWG]G]G_&``M U1AUU224IR9I9O9O9QRRr(ct}|jD]T\}}t|tr!t j t |}n|s;t|tj rh|}t|drt|jtjjst|j}|j||_nt|tjjrt j d|}nNt|tjr|}n1t|}t j d|j|}||t|<W|S)a7Return the :class:`.openapi.Response` objects calculated for this view. :param dict response_serializers: response serializers as returned by :meth:`.get_response_serializers` :return: a dictionary of status code to :class:`.Response` object :rtype: dict[str, openapi.Response] )r+rRr)r+rR)rrr:rr Responser hasattrrRrKrLr ri_Ref)r rr-rrQresponses r'rz&SwaggerAutoSchema.get_response_schemass, M 288: *NB *c*"++ .z : J(8(89%8X.z(//SZSaSaShSh7i!:8??!KJ&*&?&? &KHOJ(=(=>"++ "%J 5%6zB "++ "44Z@ "*Ic"g 5 *8r(cX|jjdd}| t|}|S)zReturn the query serializer (used for parsing query parameters) for this endpoint. :return: the query serializer, or ``None`` query_serializerN)r%rZr )r rs r'get_query_serializerz&SwaggerAutoSchema.get_query_serializers4  >>--.@$G  '89IJ r(cl|j|jz}|j}g}|{|j|tj }t tt|tt|zdk7r%td|jd|j||zS)zdReturn the query parameters accepted by this view. :rtype: list[openapi.Parameter] rcrzmyour query_serializer contains fields that conflict with the filter_backend or paginator_class on the view -  ) get_filter_parametersget_pagination_parametersrrer IN_QUERYlensetrr r"r!)r natural_parametersrserializer_parameterss r'r5z&SwaggerAutoSchema.get_query_parameters s "779D?#FYZoFpBqqrvww,OS{{\`\e\eg "$999r(c|xs |j}|jjdd}|sdj|}|S)aqReturn an unique ID for this operation. The ID must be unique across all :class:`.Operation` objects in the API. :param tuple[str] operation_keys: an array of keys derived from the path describing the hierarchical layout of this view in the API; e.g. ``('snippets', 'list')``, ``('snippets', 'retrieve')``, etc. :rtype: str r*r_)rr%rZr\)r rr*s r'r7z"SwaggerAutoSchema.get_operation_id4sA(>4+>+>~~))."= 88N3Lr(cd}d}|jdd}t|dk(r<|dj|d<t|d|kr|\}}|j}||fS)aSDecide if and how to split a summary out of the given description. The default implementation uses the first paragraph of the description as a summary if it is less than 120 characters long. :param description: the full description to be analyzed :return: summary and description :rtype: (str,str) Nxz rrr)splitrstrip)r r+r,summary_max_lensectionss r'split_summary_from_descriptionz0SwaggerAutoSchema.split_summary_from_descriptionCsv$$VQ/ x=A "1+++-HQK8A;/1'/$)//1  ##r(cV|jjdd}|jjdd}|l|jj|j|j xsd}|j jdd}|r||j|\}}||fS)zReturn an operation summary and description determined from the view's docstring. :return: summary and description :rtype: (str,str) operation_descriptionNoperation_summaryr ) r%rZrget_descriptionr!r"rreplacer)r r+r,s r'r8z-SwaggerAutoSchema.get_summary_and_descriptionWs nn(()@$G ..$$%8$?  ))33DIIt{{KQrK%++-55dB?K'+'J'J;'W$ ##r(c:|jjddS)aTReturn a list of security requirements for this operation. Returning an empty list marks the endpoint as unauthenticated (i.e. removes all accepted authentication schemes). Returning ``None`` will inherit the top-level security requirements. :return: security requirements :rtype: list[dict[str,list[str]]]r2Nr%rZrUs r'r9zSwaggerAutoSchema.get_securityis~~!!*d33r(c:|jjddS)zReturn ``True`` if this operation is to be marked as deprecated. :return: deprecation status :rtype: bool r3NrrUs r'r<zSwaggerAutoSchema.is_deprecatedss ~~!!,55r(cl|xs |j}|jjd}|s|dg}|S)a Get a list of tags for this operation. Tags determine how operations relate with each other, and in the UI each tag will show as a group containing the operations that use it. If not provided in overrides, tags will be inferred from the operation url. :param tuple[str] operation_keys: an array of keys derived from the path describing the hierarchical layout of this view in the API; e.g. ``('snippets', 'list')``, ``('snippets', 'retrieve')``, etc. :rtype: list[str] r1r)rr%rZ)r rr1s r'r=zSwaggerAutoSchema.get_tags{s=(>4+>+>~~!!&)"1%&D r(c4t|jS)zTReturn the MIME types this endpoint can consume. :rtype: list[str] )rget_parser_classesrUs r'rzSwaggerAutoSchema.get_consumess D33566r(c4t|jS)zTReturn the MIME types this endpoint can produce. :rtype: list[str] )rget_renderer_classesrUs r'rzSwaggerAutoSchema.get_producess D55788r(r)__name__ __module__ __qualname__rrBr4rVr_rJrNrOrPr6r>rrr}rrr5r7rr8r9r<r=rr __classcell__)r&s@r'rrs-  DT8=  N5a;,   *B0&$L :( $($$46"79r(r)logging collectionsrrest_framework.requestrrest_framework.schemasrrest_framework.statusrrr errorsr utilsr r r rrrrrrbaserr getLoggerrloggerrr(r'rsN#5-,+2   8 $E9 E9r(