+
     Ii-  c                   s`    ^ RI Ht ^ RIHt  ! R R]4      t ! R R]4      t ! R R]4      tR	# )
i    )ShapeDocumenter)py_type_namec                   sv   a  ] tR t^t o RR ltR tRR ltRR ltRR ltRR lt	R t
R	 tR
 tR tR tRtV tR# )BaseParamsDocumenterNc           	     s8    . pV P                  VVVRVVR7       R# )a  Fills out the documentation for a section given a model shape.

:param section: The section to write the documentation to.

:param shape: The shape of the operation.

: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.
N)sectionshapehistorynameincludeexclude)traverse_and_document_shape)selfr   r   r   r   r   s   &&&&& 9/usr/lib/python3.14/site-packages/botocore/docs/params.pydocument_paramsZ$BaseParamsDocumenter.document_params   s.     (( 	) 	
    c                s,    V P                   ! W3/ VB  R # N_add_member_documentationr
   r   r   kwargs   &&&,r   document_recursive_shapeZ-BaseParamsDocumenter.document_recursive_shape+   s    &&w@@r   c                s,    V P                   ! W3/ VB  R # r   r   )r
   r   r   r   r   r   r   s   &&&&&&,r   document_shape_defaultZ+BaseParamsDocumenter.document_shape_default.   s     	&&w@@r   c                s:   V P                   ! W3/ VB  VP                  pVP                  VP                  R VP                  P                  /R7      pV P	                  V4       V P                  VVVRR7       VP                  R4      pV P                  V4       R# )r   ZcontextNr   r   r   r   zend-list)r   Zmemberadd_new_sectionr   _start_nested_paramr	   _end_nested_param)	r
   r   r   r   r   r   r   param_shapeparam_sections	   &&&&&&,  r   document_shape_type_listZ-BaseParamsDocumenter.document_shape_type_list3   s     	&&w@@ll//w0A0A&B 0 
 	  /((!	 	) 	
 ))*5w'r   c                sJ   V P                   ! W3/ VB  VP                  R RVP                  P                  /R7      pV P	                  V4       V P                  WrP                  4       VP                  VP
                  P                  RVP
                  P                  /R7      pVP                  P                  4        V P	                  V4       V P                  VVP
                  VRR7       VP                  R4      p	V P                  V	4       V P                  V	4       R# )keyr   r   Nr   zend-map)
r   r   r   r   r   Zvaluestyleindentr	   r   )
r
   r   r   r   r   r   r   Zkey_sectionr   Zend_sections
   &&&&&&,   r   document_shape_type_mapZ,BaseParamsDocumenter.document_shape_type_mapE   s    	&&w@@--GUYY^^4 . 
 	  -&&{II>//KKw0@0@&A 0 
 	""$  /((!++	 	) 	
 --i8{+{+r   c                st   V P                  VP                  V4      pV P                  WVR 7       V F`  p	V'       d	   W9   d   K  W,          p
VP                  V	RV
P                  /R7      pV P                  V4       V P                  VV
VV	R7       Kb  	  VP                  R4      pV P                  V4       R# ))r   r   r   r   end-structureN)_add_members_to_shapemembersr   r   r   r   r	   r   )r
   r   r   r   r   r   r   r   r$   paramr   r   s   &&&&&&&,    r   document_shape_type_structureZ2BaseParamsDocumenter.document_shape_type_structure`   s     ,,U]]GD&&wD&AE5+!.K#33)9)9: 4 M $$]3,,%!	 -   ))/:w'r   c                s    R # r    r   r   r   r   Z.BaseParamsDocumenter._add_member_documentation}   s    r   c                sd    V'       d(   VP                  4       pV F  pW1VP                  &   K  	  V# r   )Zcopyr   )r
   r$   r   r%   s   &&& r   r#   Z*BaseParamsDocumenter._add_members_to_shape   s+    llnG &+

# !r   c                s    V P                  V4      p\        VP                  4      pR pVe   VP                  WS,          4       M!VP                  P                  WT,          4       VP                  R4       R# )z(%s) --N )_get_special_py_type_namer   	type_namewriter   Zitalics)r
   type_sectionr   Zspecial_py_typepy_typeZtype_formats   &&&   r   "_document_non_top_level_param_typeZ7BaseParamsDocumenter._document_non_top_level_param_type   sc    88?u/& {<=&&{'<=3r   c                n    VP                   P                  4        VP                   P                  4        R # r   )r   r    new_liner
   r      &&r   r   Z(BaseParamsDocumenter._start_nested_param   "     r   c                r/   r   )r   dedentr0   r1   r2   r   r   Z&BaseParamsDocumenter._end_nested_param   r3   r   r'   NN)NNN)__name__
__module____qualname____firstlineno__r   r   r   r   r!   r&   r   r#   r.   r   r   __static_attributes____classdictcell__Z__classdict__   @r   r   r      sC     
2AA
($,6(: !! !r   r   c                   s8   a  ] tR t^t o RtRtRR ltR tRtV t	R# )ResponseParamsDocumenterz5Generates the description for the response parameterszresponse-paramsNc                s.   VP                  R 4      pVP                  R4       Ve.   VP                  P                  V 4       VP                  R4       VP                  R4      pV P	                  Wb4       VP                  R4      pVP
                  '       d   VP                  P                  4        \        VRR4      '       d   VP                  R4      pR	p	R
P                  VP                  P                  4        U
u. uF	  p
RV
 R2NK  	  up
4      pRpVP                  W,          4       VP                  R4      pVP                  P                  V4       VP                  VP
                  4       VP                  P                  4        R# u up
i )
param-name- Nr(   
param-typeparam-documentationis_tagged_unionFparam-tagged-union-docsaK  .. note::    This is a Tagged Union structure. Only one of the     following top level keys will be set: %s.     If a client receives an unknown member it will     set ``SDK_UNKNOWN_MEMBER`` as the top level key,     which maps to the name or tag of the unknown     member. The structure of ``SDK_UNKNOWN_MEMBER`` is     as follows, ``z3'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}zparam-unknown-example)r   r+   r   boldr.   documentationr    getattrjoinr$   keysZ	codeblockinclude_doc_stringnew_paragraph)r
   r   r   r   r   name_sectionr,   documentation_sectiontagged_union_docsnoter   tagged_union_members_strZunknown_code_exampleZexamples   &&&&,         r   r   Z2ResponseParamsDocumenter._add_member_documentation   sl   ..|<4 ##tf.s#..|<//D ' 7 78M N!''..0u/77$+$;$;-%!%  ,099-2]]-?-?-AB-Acr#b\-AB,( P % "''(IJ!112IJ''(<=!44U5H5HI##% Cs    Fc                s.    V P                   ! WV3/ VB  R # r   )r&   )r
   r   r   r   r   s   &&&&,r    document_shape_type_event_streamZ9ResponseParamsDocumenter.document_shape_type_event_stream   s     	**77MfMr   r'   r   )
r6   r7   r8   r9   __doc__
EVENT_NAMEr   rS   r:   r;   r<   r=   r   r>   r>      s     ?"J$&LN Nr   r>   c                   sH   a  ] tR t^t o RtRtR	R ltR
R ltR tR t	Rt
V tR# )RequestParamsDocumenterz4Generates the description for the request parameterszrequest-paramsNc           	     st   \        V4      ^8  d.   V P                  ! W3/ VB  VP                  P                  4        V P	                  VP
                  V4      p\        V4       Fz  w  rV'       d	   W9   d   K  Wy,          p
VP                  V	RV
P                  /R7      pVP                  P                  4        WP                  9   pV P                  VV
VV	VR7       K|  	  VP                  R4      p\        V4      ^8  d   VP                  P                  4        VP                  P                  4        R# )i   r   r   )r   r   r   r   is_requiredr"   N)Zlenr   r   r    r#   r$   Z	enumerater   r   r0   Zrequired_membersr	   r4   )r
   r   r   r   r   r   r   r$   Zir%   r   r   rW   s   &&&&&&,      r   r&   Z5RequestParamsDocumenter.document_shape_type_structure   s    w<!**7DVDMM  ",,U]]GD!'*HA5+!.K#33)9)9: 4 M ((*#9#99K,,%!' -  +  ))/:w<!MM  " r   c                s.   V P                  V4      pVf   \        VP                  4      pV'       d{   VP                  R4      pVP	                  RV RV 24       VP                  R4      p	V	P
                  P                  4        VP                  R4      p
V
P	                  RV R24       MuVP                  R4      p
V
P	                  R4       Ve.   V
P
                  P                  V 4       V
P	                  R4       VP                  R4      pV P                  W4       V'       dX   VP                  R	4      pVP
                  P                  4        VP
                  P                  R
4       VP	                  R4       VP                  '       d   VP                  R4      pVP
                  P                  4        \        VRR4      '       di   VP                  R4      pRpRP                  VP                  P                  4        Uu. uF	  pRV R2NK  	  up4      pVP	                  VV,          4       VP                  VP                  4       V P!                  W4       VP                  R4      pVP
                  P#                  4        R # u upi )NrA   z:type z: zend-param-typer?   z:param r@   r(   zis-requiredz
[REQUIRED]rB   rC   FrD   zl.. note::    This is a Tagged Union structure. Only one of the     following top level keys can be set: %s. rE   rF   z	end-param)r)   r   r*   r   r+   r   r0   rG   r.   r    rH   rI   rJ   r$   rK   rL    _add_special_trait_documentationrM   )r
   r   r   r   Zis_top_level_paramrW   r   r-   r,   Zend_type_sectionrN   Zis_required_sectionrO   rP   rQ   r   rR   Zend_param_sections   &&&&&&,           r   r   Z1RequestParamsDocumenter._add_member_documentation   sO    007?"5??3G"22<@LvRy9:+;;<LM""++-"22<@Lb12 #22<@Lt$""''4&2""3'"22<@L33LH")"9"9-"H%%,,.%%**<8%%c*$+$;$;%%! "''..0u/77$+$;$;-%!D 
 ,099-2]]-?-?-AB-Acr#b\-AB,( "''0H(IJ!44U5H5HI112GO#33K@--/ Cs   Jc                sN    R VP                   9   d   V P                  V4       R# R# )ZidempotencyTokenN)Zmetadata!_append_idempotency_documentation)r
   r   r   s   &&&r   rX   Z8RequestParamsDocumenter._add_special_trait_documentation(  s!    /227; 0r   c                s,    R pVP                  V4       R# )z,This field is autopopulated if not provided.N)r+   )r
   r   Z	docstrings   && r   rY   Z9RequestParamsDocumenter._append_idempotency_documentation,  s    B	i r   r'   r5   )NFF)r6   r7   r8   r9   rT   rU   r&   r   rX   rY   r:   r;   r<   r=   r   rV   rV      s'     >!J!870r<! !r   rV   N)Zbotocore.docs.shaper    Zbotocore.docs.utilsr   r   r>   rV   r'   r   r   <module>rZ      s;    0 ,I!? I!X.N3 .Nb`!2 `!r   