/Jf/rddlZddlZddlmZmZddlmZmZdZdZ d dZ d dZ dZ d d Z dS) N)RequestExampleDocumenterResponseExampleDocumenter)RequestParamsDocumenterResponseParamsDocumenterz'https://docs.aws.amazon.com/goto/WebAPIctj|}i}|D]3\}}|dstj|r|||<4|S)aRetrieves an objects public methods :param instance: The instance of the class to inspect :rtype: dict :returns: A dictionary that represents an instance's methods where the keys are the name of the methods and the values are the handler to the method. _)inspect getmembers startswithismethod)instanceinstance_membersinstance_methodsnamemembers W/home/alex/cs2snipeproduction/venv/lib/python3.11/site-packages/botocore/docs/method.pyget_instance_public_methodsrsg)(33(00 fs## 0'' 0)/ & c6i}|jr |jj}t|}||D]}||j||D]}||vr||d}|rd}|j||dS)a;Documents the signature of a model-driven method :param section: The section to write the documentation to. :param name: The name of the method :param operation_model: The operation model for the method :type include: Dictionary where keys are parameter names and values are the shapes of the parameter names. :param include: The parameter shapes to include in the documentation. :type exclude: List of the names of the parameters to exclude. :param exclude: The names of the parameters to exclude from documentation. Nz**kwargs) input_shapememberslistkeysappendrremovestylestart_sphinx_py_method) sectionroperation_modelincludeexcludeparamsparameter_namesrsignature_paramss rdocument_model_driven_signaturer&.s&F"5 ,46;;==))O 0 0F  " "6; / / / / / /F((&&v...&% M((/?@@@@@rc"tj|}t|tjrt t |j}|j|j}|tj j ksJ|j }||=| | }t|d} | d} |j|| dS)a3Documents the signature of a custom method :param section: The section to write the documentation to. :param name: The name of the method :param method: The handle to the method being documented :type include: Dictionary where keys are parameter names and values are the shapes of the parameter names. :param include: The parameter shapes to include in the documentation. :type exclude: List of the names of the parameters to exclude. :param exclude: The names of the parameters to exclude from documentation. ) parameters()N)r signature isinstancetypes FunctionTypenextiterr(kind ParameterPOSITIONAL_OR_KEYWORDcopyreplacevaluesstrlstriprstriprr) rrmethodr!r"r+ self_param self_kind new_paramsr%s rdocument_custom_signaturer>Vs&!&))I&%,--F$y34455 (49 G-CCCCC)..00 z "%%1B1B1D1D%EE 9~~,,S11'..s33 M((/?@@@@@rc|jdd|}t||||d}|dt j|}||j|dSdS)zDocuments a non-data driven method :param section: The section to write the documentation to. :param method_name: The name of the method :param method: The handle to the method being documented qualifierr method-introN) contextgetr>add_new_sectionwritelnr getdocrwrite_py_doc_string)r method_namer:full_method_namemethod_intro_section doc_strings rdocument_custom_methodrLys"/--k2>>M MMg'7@@@"22>BB  $$$''J"66zBBBBBrTc  | rt||||||d} | ||jrG| j| d| j|jj d} | s| j | dtd| d|j}| jd| | d |d }|j |jd d |||di}|jr@t+|jj|j||||j|||nJ|j |j| |dz|d}|jr>t3|jj|j||||j|||d}|j|j*| r'| d|j| d|j|j|}|r\|d}|j | d|j|d}|j|jd|j t=|jj|j||||j|| |d}|j|jd|j t?|jj|j||||j|| dS| ddS)a.Documents an individual method :param section: The section to write to :param method_name: The name of the method :param operation_model: The model of the operation :param event_emitter: The event emitter to use to emit events :param example_prefix: The prefix to use in the method example. :type include_input: Dictionary where keys are parameter names and values are the shapes of the parameter names. :param include_input: The parameter shapes to include in the input documentation. :type include_output: Dictionary where keys are parameter names and values are the shapes of the parameter names. :param include_input: The parameter shapes to include in the output documentation. :type exclude_input: List of the names of the parameters to exclude. :param exclude_input: The names of the parameters to exclude from input documentation. :type exclude_output: List of the names of the parameters to exclude. :param exclude_input: The names of the parameters to exclude from output documentation. :param document_output: A boolean flag to indicate whether to document the output. :param include_signature: Whether or not to include the signature. It is useful for generating docstrings. )r!r"rAzThis operation is deprecated and may not function as expected. This operation should not be used going forward and is only kept for the purpose of backwards compatiblity.uidNz See also: /zAWS API Documentation)titlelinkrzrequest-examplezRequest Syntaxspecial_shape_types)streaming_input_shapestreaming_output_shapeeventstream_output_shape) service_nameoperation_name event_emitterrB)prefixr!r"z()zrequest-paramsreturnz :rtype: dictz :returns: z event-streamzThe response of this operation contains an :class:`.EventStream` member. When iterated the :class:`.EventStream` will yield events based on the structure below, where only one of the top level keys will be present for any given event.zresponse-examplezResponse Syntax descriptionzResponse Structurez:returns: None) r&rDinclude_doc_string deprecatedr start_dangerrE end_danger service_modelmetadatarC new_paragraphwrite AWS_DOC_BASEr external_linkboldget_streaming_inputget_streaming_outputget_event_stream_outputrrrVdocument_examplestart_codeblockrdocument_paramsnew_line output_shapeindentrr)rrHr rXmethod_descriptionexample_prefix include_inputinclude_output exclude_inputexclude_outputdocument_outputinclude_signaturerJ service_uidrQexample_sectionrBrequest_params_sectionreturn_sectionevent_stream_output event_sectionreturn_example_sectionreturn_description_sections rdocument_model_driven_methodrsf '   !!     #22>BB++,>???!0"//111$$ J   "--///!/8<JJM   - - / / /   7      ( ( * * *"0!?!? " "  $--///$))*;<<<$22444!(6C*/'      "  (""    &4%C%C & & " #(11333"(--.BCCC"(66888 (6C*/'    / &  (""       -.....r)NN)NNNNNNTT)r r-botocore.docs.examplerrbotocore.docs.paramsrrrdrr&r>rLrrrrs   9 &;?%A%A%A%AR26 A A A AFCCC.}/}/}/}/}/}/r