§
    9xÅjÏ-  ã                   ór   — d dl mZ d dlmZ  G d„ de¦  «        Z G d„ de¦  «        Z G d„ de¦  «        Zd	S )
é    )ÚShapeDocumenter)Úpy_type_namec                   óf   — e Zd Zdd„Zd„ Z	 dd„Z	 dd„Z	 dd„Z	 	 	 dd„Zd„ Z	d	„ Z
d
„ Zd„ Zd„ ZdS )ÚBaseParamsDocumenterNc                 ó@   — g }|                       |||d||¬¦  «         dS )a3  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         úEC:\Projects\Historical\venv\Lib\site-packages\botocore/docs/params.pyÚdocument_paramsz$BaseParamsDocumenter.document_params   sB   € ð ˆØ×(Ò(ØØØØØØð 	)ñ 	
ô 	
ð 	
ð 	
ð 	
ó    c                 ó$   —  | j         ||fi |¤Ž d S ©N©Ú_add_member_documentation©r   r   r	   Úkwargss       r   Údocument_recursive_shapez-BaseParamsDocumenter.document_recursive_shape+   s%   € Ø&ˆÔ& w°Ð@Ð@¸Ð@Ð@Ð@Ð@Ð@r   c                 ó$   —  | j         ||fi |¤Ž d S r   r   )r   r   r	   r
   r   r   r   s          r   Údocument_shape_defaultz+BaseParamsDocumenter.document_shape_default.   s'   € ð 	'ˆÔ& w°Ð@Ð@¸Ð@Ð@Ð@Ð@Ð@r   c                 ó2  —  | j         ||fi |¤Ž |j        }|                     |j        d|j        j        i¬¦  «        }|                      |¦  «         |                      |||d ¬¦  «         |                     d¦  «        }|                      |¦  «         d S )Nr	   ©Úcontext©r   r	   r
   r   zend-list)r   Ú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°Ð@Ð@¸Ð@Ð@Ð@Ø”lˆØ×/Ò/ØÔ w°´Ô0AÐ&Bð 0ñ 
ô 
ˆð 	× Ò  Ñ/Ô/Ð/Ø×(Ò(Ø!ØØØð	 	)ñ 	
ô 	
ð 	
ð ×)Ò)¨*Ñ5Ô5ˆØ×Ò˜wÑ'Ô'Ð'Ð'Ð'r   c                 ó:  —  | j         ||fi |¤Ž |                     dd|j        j        i¬¦  «        }|                      |¦  «         |                       ||j        ¦  «         |                     |j        j        d|j        j        i¬¦  «        }|j                             ¦   «          |                      |¦  «         |                      ||j        |d ¬¦  «         |                     d¦  «        }	|  	                    |	¦  «         |  	                    |	¦  «         d S )NÚkeyr	   r   r   zend-map)
r   r!   r(   r   r"   ÚvalueÚstyleÚindentr   r#   )
r   r   r	   r
   r   r   r   Úkey_sectionr%   Úend_sections
             r   Údocument_shape_type_mapz,BaseParamsDocumenter.document_shape_type_mapE   s>  € ð 	'ˆÔ& w°Ð@Ð@¸Ð@Ð@Ð@à×-Ò-Ø˜G U¤Y¤^Ð4ð .ñ 
ô 
ˆð 	× Ò  Ñ-Ô-Ð-Ø×&Ò& {°E´IÑ>Ô>Ð>à×/Ò/ØŒKÔ w°´Ô0@Ð&Að 0ñ 
ô 
ˆð 	Ô×"Ò"Ñ$Ô$Ð$Ø× Ò  Ñ/Ô/Ð/Ø×(Ò(Ø!Ø”+ØØð	 	)ñ 	
ô 	
ð 	
ð ×-Ò-¨iÑ8Ô8ˆØ×Ò˜{Ñ+Ô+Ð+Ø×Ò˜{Ñ+Ô+Ð+Ð+Ð+r   c                 ó€  — |                       |j        |¦  «        }|                      |||¬¦  «         |D ]]}	|r|	|v rŒ	||	         }
|                     |	d|
j        i¬¦  «        }|                      |¦  «         |                      ||
||	¬¦  «         Œ^|                     d¦  «        }|                      |¦  «         d S )N)r   r	   r   r   úend-structure)Ú_add_members_to_shapeÚmembersr   r!   r   r"   r   r#   )r   r   r	   r
   r   r   r   r   r2   Úparamr$   r%   s               r   Údocument_shape_type_structurez2BaseParamsDocumenter.document_shape_type_structure`   sý   € ð ×,Ò,¨U¬]¸GÑDÔDˆØ×&Ò& w°¸DÐ&ÑAÔAÐAØð 	ð 	ˆEØð ˜5 GÐ+Ð+ØØ! %œ.ˆKØ#×3Ò3Ø ¨Ô)9Ð:ð 4ñ ô ˆMð ×$Ò$ ]Ñ3Ô3Ð3Ø×,Ò,Ø%Ø!ØØð	 -ñ ô ð ð ð ×)Ò)¨/Ñ:Ô:ˆØ×Ò˜wÑ'Ô'Ð'Ð'Ð'r   c                 ó   — d S r   © r   s       r   r   z.BaseParamsDocumenter._add_member_documentation}   s   € Øˆr   c                 óP   — |r#|                      ¦   «         }|D ]}|||j        <   Œ|S r   )Úcopyr   )r   r2   r   r3   s       r   r1   z*BaseParamsDocumenter._add_members_to_shape€   s:   € Øð 	,Ø—l’l‘n”nˆGØ ð ,ð ,�Ø&+�˜œ
Ñ#Ð#Øˆr   c                 óö   — |                       |¦  «        }t          |j        ¦  «        }d}|�|                     ||z  ¦  «         n|j                             ||z  ¦  «         |                     d¦  «         d S )Nz(%s) --ú )Ú_get_special_py_type_namer   Ú	type_nameÚwriter*   Úitalics)r   Útype_sectionr	   Úspecial_py_typeÚpy_typeÚtype_formats         r   Ú"_document_non_top_level_param_typez7BaseParamsDocumenter._document_non_top_level_param_type‡   sƒ   € Ø×8Ò8¸Ñ?Ô?ˆÝ˜uœÑ/Ô/ˆàˆØÐ&ð ×Ò˜{¨_Ñ<Ñ=Ô=Ð=Ð=àÔ×&Ò& {°WÑ'<Ñ=Ô=Ð=Ø×Ò˜3ÑÔÐÐÐr   c                 ój   — |j                              ¦   «          |j                              ¦   «          d S r   )r*   r+   Únew_line©r   r   s     r   r"   z(BaseParamsDocumenter._start_nested_param”   ó0   € ØŒ×ÒÑÔÐØŒ×ÒÑ Ô Ð Ð Ð r   c                 ój   — |j                              ¦   «          |j                              ¦   «          d S r   )r*   ÚdedentrE   rF   s     r   r#   z&BaseParamsDocumenter._end_nested_param˜   rG   r   ©NN)NNN)Ú__name__Ú
__module__Ú__qualname__r   r   r   r&   r.   r4   r   r1   rC   r"   r#   r6   r   r   r   r      s÷   € € € € € ð
ð 
ð 
ð 
ð2Að Að Að >BðAð Að Að Að >Bð(ð (ð (ð (ð& >Bð,ð ,ð ,ð ,ð@ ØØð(ð (ð (ð (ð:ð ð ðð ð ð ð  ð  ð!ð !ð !ð!ð !ð !ð !ð !r   r   c                   ó$   — e Zd ZdZdZdd„Zd„ ZdS )ÚResponseParamsDocumenterz5Generates the description for the response parameterszresponse-paramsNc                 ó2  — |                      d¦  «        }|                     d¦  «         |�0|j                             |› ¦  «         |                     d¦  «         |                      d¦  «        }|                      ||¦  «         |                      d¦  «        }|j        rÚ|j                             ¦   «          t          |dd¦  «        r–|                      d¦  «        }d	}	d
                     d„ |j	         
                    ¦   «         D ¦   «         ¦  «        }
d}|                     |	|
z  ¦  «         |                      d¦  «        }|j                             |¦  «         |                     |j        ¦  «         |j                             ¦   «          d S )Nú
param-nameú- r:   ú
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ú, c                 ó   — g | ]}d |› d �‘Œ	S ©z``r6   ©Ú.0r(   s     r   ú
<listcomp>zFResponseParamsDocumenter._add_member_documentation.<locals>.<listcomp>½   ó    € ÐBÐBÐB c�\˜#�\�\�\ÐBÐBÐBr   z3'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}zparam-unknown-example)r!   r=   r*   ÚboldrC   Údocumentationr+   ÚgetattrÚjoinr2   ÚkeysÚ	codeblockÚinclude_doc_stringÚnew_paragraph)r   r   r	   r   r   Úname_sectionr?   Údocumentation_sectionÚtagged_union_docsÚnoteÚtagged_union_members_strÚunknown_code_exampleÚexamples                r   r   z2ResponseParamsDocumenter._add_member_documentation¢   s«  € Ø×.Ò.¨|Ñ<Ô<ˆØ×Ò˜4Ñ Ô Ð ØÐØÔ×#Ò# t IÑ.Ô.Ð.Ø×Ò˜sÑ#Ô#Ð#Ø×.Ò.¨|Ñ<Ô<ˆØ×/Ò/°¸eÑDÔDÐDà '× 7Ò 7Ð8MÑ NÔ NÐØÔð 	JØ!Ô'×.Ò.Ñ0Ô0Ð0Ý�uÐ/°Ñ7Ô7ð >Ø$+×$;Ò$;Ø-ñ%ô %Ð!ð%ð ð ,0¯9ª9ØBÐB¨U¬]×-?Ò-?Ñ-AÔ-AÐBÑBÔBñ,ô ,Ð(ð Pð %ð "×'Ò'¨Ð0HÑ(IÑJÔJÐJØ!×1Ò1Ð2IÑJÔJ�Ø”×'Ò'Ð(<Ñ=Ô=Ð=Ø!×4Ò4°UÔ5HÑIÔIÐIØŒ×#Ò#Ñ%Ô%Ð%Ð%Ð%r   c                 ó&   —  | j         |||fi |¤Ž d S r   )r4   )r   r   r	   r
   r   s        r   Ú document_shape_type_event_streamz9ResponseParamsDocumenter.document_shape_type_event_streamÈ   s)   € ð 	+ˆÔ*¨7°E¸7ÐMÐMÀfÐMÐMÐMÐMÐMr   r   )rK   rL   rM   Ú__doc__Ú
EVENT_NAMEr   rn   r6   r   r   rO   rO   �   sH   € € € € € Ø?Ð?à"€Jð$&ð $&ð $&ð $&ðLNð Nð Nð Nð Nr   rO   c                   ó:   — e Zd ZdZdZ	 d	d„Z	 	 	 d
d„Zd„ Zd„ ZdS )ÚRequestParamsDocumenterz4Generates the description for the request parameterszrequest-paramsNc                 ób  — t          |¦  «        dk    r( | j        ||fi |¤Ž |j                             ¦   «          |                      |j        |¦  «        }t          |¦  «        D ]n\  }}	|r|	|v rŒ||	         }
|                     |	d|
j        i¬¦  «        }|j         	                    ¦   «          |	|j
        v }|                      ||
||	|¬¦  «         Œo|                     d¦  «        }t          |¦  «        dk    r|j                             ¦   «          |j         	                    ¦   «          d S )Né   r	   r   )r   r	   r
   r   Úis_requiredr0   )Úlenr   r*   r+   r1   r2   Ú	enumerater!   r   rE   Úrequired_membersr   rI   )r   r   r	   r
   r   r   r   r2   Úir3   r$   r%   ru   s                r   r4   z5RequestParamsDocumenter.document_shape_type_structureÓ   sf  € õ ˆw‰<Œ<˜!ÒÐØ*ˆDÔ*¨7°EÐDÐD¸VÐDÐDÐDØŒM× Ò Ñ"Ô"Ð"Ø×,Ò,¨U¬]¸GÑDÔDˆÝ! 'Ñ*Ô*ð 	ð 	‰HˆAˆuØð ˜5 GÐ+Ð+ØØ! %œ.ˆKØ#×3Ò3Ø ¨Ô)9Ð:ð 4ñ ô ˆMð Ô×(Ò(Ñ*Ô*Ð*Ø 5Ô#9Ð9ˆKØ×,Ò,Ø%Ø!ØØØ'ð -ñ ô ð ð ð ×)Ò)¨/Ñ:Ô:ˆÝˆw‰<Œ<˜!ÒÐØŒM× Ò Ñ"Ô"Ð"ØŒ×ÒÑ Ô Ð Ð Ð r   Fc                 óX  — |                       |¦  «        }|€t          |j        ¦  «        }|r�|                     d¦  «        }|                     d|› d|› �¦  «         |                     d¦  «        }	|	j                             ¦   «          |                     d¦  «        }
|
                     d|› d�¦  «         n‡|                     d¦  «        }
|
                     d¦  «         |�0|
j                             |› ¦  «         |
                     d¦  «         |                     d¦  «        }|                      ||¦  «         |r]|                     d	¦  «        }|j         	                    ¦   «          |j                             d
¦  «         |                     d¦  «         |j
        rÔ|                     d¦  «        }|j         	                    ¦   «          t          |dd¦  «        re|                     d¦  «        }d}d                     d„ |j                             ¦   «         D ¦   «         ¦  «        }|                     ||z  ¦  «         |                     |j
        ¦  «         |                      ||¦  «         |                     d¦  «        }|j                             ¦   «          d S )NrS   z:type z: zend-param-typerQ   z:param rR   r:   zis-requiredz
[REQUIRED]rT   rU   FrV   zl.. note::    This is a Tagged Union structure. Only one of the     following top level keys can be set: %s. rW   c                 ó   — g | ]}d |› d �‘Œ	S rY   r6   rZ   s     r   r\   zERequestParamsDocumenter._add_member_documentation.<locals>.<listcomp>   r]   r   z	end-param)r;   r   r<   r!   r=   r*   rE   r^   rC   r+   r_   r`   ra   r2   rb   rd   Ú _add_special_trait_documentationre   )r   r   r	   r   Úis_top_level_paramru   r   rA   r?   Úend_type_sectionrf   Úis_required_sectionrg   rh   ri   rj   Úend_param_sections                    r   r   z1RequestParamsDocumenter._add_member_documentationï   sÑ  € ð ×0Ò0°Ñ7Ô7ˆØˆ?Ý" 5¤?Ñ3Ô3ˆGØð 	IØ"×2Ò2°<Ñ@Ô@ˆLØ×ÒÐ9¨Ð9Ð9°Ð9Ð9Ñ:Ô:Ð:Ø+×;Ò;Ð<LÑMÔMÐØÔ"×+Ò+Ñ-Ô-Ð-Ø"×2Ò2°<Ñ@Ô@ˆLØ×ÒÐ1¨Ð1Ð1Ð1Ñ2Ô2Ð2Ð2ð #×2Ò2°<Ñ@Ô@ˆLØ×Ò˜tÑ$Ô$Ð$ØÐØÔ"×'Ò'¨4¨	Ñ2Ô2Ð2Ø×"Ò" 3Ñ'Ô'Ð'Ø"×2Ò2°<Ñ@Ô@ˆLØ×3Ò3°LÀ%ÑHÔHÐHàð 	+Ø")×"9Ò"9¸-Ñ"HÔ"HÐØÔ%×,Ò,Ñ.Ô.Ð.ØÔ%×*Ò*¨<Ñ8Ô8Ð8Ø×%Ò% cÑ*Ô*Ð*ØÔð 	PØ$+×$;Ò$;Ø%ñ%ô %Ð!ð "Ô'×.Ò.Ñ0Ô0Ð0Ý�uÐ/°Ñ7Ô7ð KØ$+×$;Ò$;Ø-ñ%ô %Ð!ðDð ð
 ,0¯9ª9ØBÐB¨U¬]×-?Ò-?Ñ-AÔ-AÐBÑBÔBñ,ô ,Ð(ð "×'Ò'¨Ð0HÑ(IÑJÔJÐJØ!×4Ò4°UÔ5HÑIÔIÐIØ×1Ò1Ð2GÈÑOÔOÐOØ#×3Ò3°KÑ@Ô@ÐØÔ×-Ò-Ñ/Ô/Ð/Ð/Ð/r   c                 óF   — d|j         v r|                      |¦  «         d S d S )NÚidempotencyToken)ÚmetadataÚ!_append_idempotency_documentation)r   r   r	   s      r   r|   z8RequestParamsDocumenter._add_special_trait_documentation(  s1   € Ø ¤Ð/Ð/Ø×2Ò2°7Ñ;Ô;Ð;Ð;Ð;ð 0Ð/r   c                 ó4   — d}|                      |¦  «         d S )Nz,This field is autopopulated if not provided.)r=   )r   r   Ú	docstrings      r   r„   z9RequestParamsDocumenter._append_idempotency_documentation,  s   € ØBˆ	Ø�Š�iÑ Ô Ð Ð Ð r   rJ   )NFF)	rK   rL   rM   ro   rp   r4   r   r|   r„   r6   r   r   rr   rr   Î   sx   € € € € € Ø>Ð>à!€Jð >Bð!ð !ð !ð !ð@ Ø Øð70ð 70ð 70ð 70ðr<ð <ð <ð!ð !ð !ð !ð !r   rr   N)Úbotocore.docs.shaper   Úbotocore.docs.utilsr   r   rO   rr   r6   r   r   ú<module>r‰      sÑ   ðð 0Ð /Ð /Ð /Ð /Ð /Ø ,Ð ,Ð ,Ð ,Ð ,Ð ,ðI!ð I!ð I!ð I!ð I!˜?ñ I!ô I!ð I!ðX.Nð .Nð .Nð .Nð .NÐ3ñ .Nô .Nð .Nðb`!ð `!ð `!ð `!ð `!Ð2ñ `!ô `!ð `!ð `!ð `!r   