§
    9xÅjuC  ã                   óÎ   — d dl Z d dlmZ d dlmZ d dlmZ d dlmZ d dl	m
Z
mZmZ d dlmZ d dlmZ d d	lmZmZ d
„ Z G d„ d¦  «        Z G d„ d¦  «        Z G d„ d¦  «        ZdS )é    N)Ú
xform_name)ÚOrderedDict)ÚDocumentStructure)ÚResponseExampleDocumenter)Údocument_custom_methodÚdocument_model_driven_methodÚget_instance_public_methods)ÚResponseParamsDocumenter)Údocument_shared_examples)ÚDocumentedShapeÚget_official_service_namec                 ó   — | dk    rd S |dv S )NÚgenerate_presigned_url)Ús3© )Úmethod_nameÚservice_nameÚkwargss      úEC:\Projects\Historical\venv\Lib\site-packages\botocore/docs/client.pyÚ!_allowlist_generate_presigned_urlr      s   € ØÐ.Ò.Ð.ØˆtØ˜6Ð!Ð!ó    c                   óp   — e Zd ZegZdd„Zd„ Zd„ Zd„ Zd„ Z	d„ Z
d„ Zd	„ Zd
„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ ZdS )ÚClientDocumenterNc                 ó®   — || _         | j         j        j        | _        || _        || _        | j        €i | _        | j         j        j        j        | _	        d S ©N)
Ú_clientÚ	__class__Ú__name__Ú_client_class_nameÚ_root_docs_pathÚ_shared_examplesÚmetaÚservice_modelr   Ú_service_name)ÚselfÚclientÚroot_docs_pathÚshared_exampless       r   Ú__init__zClientDocumenter.__init__(   sS   € ØˆŒØ"&¤,Ô"8Ô"AˆÔØ-ˆÔØ /ˆÔØÔ Ð(Ø$&ˆDÔ!Ø!œ\Ô.Ô<ÔIˆÔÐÐr   c                 óØ   — |                       |¦  «         |                      |¦  «         |                      ¦   «         }|                      ||¦  «         |                      |¦  «         dS )z]Documents a client and its methods

        :param section: The section to write to.
        N)Ú
_add_titleÚ_add_class_signatureÚ_get_client_methodsÚ_add_client_introÚ_add_client_methods)r%   ÚsectionÚclient_methodss      r   Údocument_clientz ClientDocumenter.document_client1   sk   € ð
 	�Š˜Ñ Ô Ð Ø×!Ò! 'Ñ*Ô*Ð*Ø×1Ò1Ñ3Ô3ˆØ×Ò˜w¨Ñ7Ô7Ð7Ø× Ò  Ñ0Ô0Ð0Ð0Ð0r   c                 óT   — t          | j        ¦  «        }|                      |¦  «        S r   )r	   r   Ú_filter_client_methods)r%   r1   s     r   r-   z$ClientDocumenter._get_client_methods<   s%   € Ý4°T´\ÑBÔBˆØ×*Ò*¨>Ñ:Ô:Ð:r   c                 ó†   — i }|                      ¦   «         D ])\  }}|                      ||| j        ¬¦  «        }|r|||<   Œ*|S )N)Úmethodr   r   )ÚitemsÚ_filter_client_methodr$   )r%   r1   Úfiltered_methodsr   r6   Úincludes         r   r4   z'ClientDocumenter._filter_client_methods@   sj   € ØÐØ#1×#7Ò#7Ñ#9Ô#9ð 	7ð 	7ÑˆK˜Ø×0Ò0ØØ'Ø!Ô/ð 1ñ ô ˆGð
 ð 7Ø06Ð  Ñ-øØÐr   c                 ó6   — | j         D ]} |di |¤Ž}|�|c S ŒdS )NTr   )Ú_CLIENT_METHODS_FILTERS)r%   r   ÚfilterÚfilter_includes       r   r8   z&ClientDocumenter._filter_client_methodL   sG   € àÔ2ð 	&ð 	&ˆFØ#˜VÐ-Ð- fÐ-Ð-ˆNàÐ)Ø%Ð%Ð%Ð%ð *ð ˆtr   c                 ó:   — |j                              d¦  «         d S )NÚClient©ÚstyleÚh2©r%   r0   s     r   r+   zClientDocumenter._add_titleV   s   € ØŒ×Ò˜Ñ"Ô"Ð"Ð"Ð"r   c                 óv  — |                      d¦  «        }t          | j        j        j        ¦  «        }|                     d|› �¦  «         |j                             ¦   «          |                     | j        j        j        j	        ¦  «         |  
                    |¦  «         |j                             ¦   «          |j                             ¦   «          |                     d¦  «         |j                             ¦   «          t          |¦  «        D ]&}|j                             | j        › d|› �¦  «         Œ'd S )NÚintroz A low-level client representing z These are the available methods:z/client/)Úadd_new_sectionr   r   r"   r#   ÚwriterB   Únew_lineÚinclude_doc_stringÚdocumentationÚ_add_client_creation_exampleÚdedentÚnew_paragraphÚwritelnÚtoctreeÚsortedÚtocitemr$   )r%   r0   r1   Úofficial_service_namer   s        r   r.   z"ClientDocumenter._add_client_introY   sF  € Ø×)Ò)¨'Ñ2Ô2ˆå 9ØŒLÔÔ+ñ!
ô !
Ðð 	�ŠØFÐ/DÐFÐFñ	
ô 	
ð 	
ð 	Œ×ÒÑ Ô Ð Ø×"Ò"ØŒLÔÔ+Ô9ñ	
ô 	
ð 	
ð
 	×)Ò)¨'Ñ2Ô2Ð2ð 	Œ×ÒÑÔÐØŒ×#Ò#Ñ%Ô%Ð%Ø�ŠÐ:Ñ;Ô;Ð;ØŒ×ÒÑÔÐÝ! .Ñ1Ô1ð 	Pð 	PˆKØŒM×!Ò! TÔ%7Ð"NÐ"NÀÐ"NÐ"NÑOÔOÐOÐOð	Pð 	Pr   c                 óL   — |j                              | j        › d�¬¦  «         d S )Nz.Client©Ú
class_name)rB   Ústart_sphinx_py_classr   rD   s     r   r,   z%ClientDocumenter._add_class_signaturer   s:   € ØŒ×+Ò+ØÔ1Ð:Ð:Ð:ð 	,ñ 	
ô 	
ð 	
ð 	
ð 	
r   c                 óØ   — |j                              ¦   «          |j                              ¦   «          |                     d| j        › d�¦  «         |j                              ¦   «          d S )Nz client = session.create_client('z'))rB   Ústart_codeblockrI   rH   r$   Úend_codeblockrD   s     r   rL   z-ClientDocumenter._add_client_creation_examplew   sm   € ØŒ×%Ò%Ñ'Ô'Ð'ØŒ×ÒÑ Ô Ð Ø�ŠØG°Ô0BÐGÐGÐGñ	
ô 	
ð 	
ð 	Œ×#Ò#Ñ%Ô%Ð%Ð%Ð%r   c                 ó  — t          |¦  «        D ]q}t          |d¬¦  «        }|                      ||||         ¦  «         t          j                             | j        | j        d¦  «        }|                     ||¦  «         Œrd S )NÚhtml©Útargetr&   )	rQ   r   Ú_add_client_methodÚosÚpathÚjoinr    r$   Úwrite_to_file)r%   r1   r   Úmethod_doc_structureÚclient_dir_paths        r   r/   z$ClientDocumenter._add_client_methods   s¦   € Ý! .Ñ1Ô1ð 	Mð 	MˆKå#4Ø Fð$ñ $ô $Ð ð ×#Ò#Ø$ k°>À+Ô3Nñô ð õ
 !œgŸlšlØÔ$ dÔ&8¸(ñô ˆOð !×.Ò.¨ÀÑLÔLÐLÐLð	Mð 	Mr   c                 ó¤  — |                      d¦  «        }|j                             | j        d| j        › �¦  «         |                     d|› �¦  «         |                     |¦  «         |                      |d| j        › d�i¬¦  «        }|                      |¦  «        r|                      |||¦  «         d S |  	                    ||¦  «         d S )NÚ
breadcrumbz../../z / Client / Ú	qualifierz.Client.)Úcontext)
rG   rB   Úrefr   r$   rH   Úadd_title_sectionÚ_is_custom_methodÚ_add_custom_methodÚ_add_model_driven_method)r%   r0   r   r6   Úbreadcrumb_sectionÚmethod_sections         r   r_   z#ClientDocumenter._add_client_method�   s  € Ø$×4Ò4°\ÑBÔBÐØÔ ×$Ò$ØÔ#Ð%B¨dÔ.@Ð%BÐ%Bñ	
ô 	
ð 	
ð 	× Ò Ð!=°Ð!=Ð!=Ñ>Ô>Ð>Ø×!Ò! +Ñ.Ô.Ð.Ø ×0Ò0ØØ  TÔ%<Ð"FÐ"FÐ"FÐGð 1ñ 
ô 
ˆð ×!Ò! +Ñ.Ô.ð 	GØ×#Ò#ØØØñô ð ð ð ð ×)Ò)¨.¸+ÑFÔFÐFÐFÐFr   c                 ó(   — || j         j        j        vS r   )r   r"   Úmethod_to_api_mapping)r%   r   s     r   rl   z"ClientDocumenter._is_custom_method£   s   € Ø $¤,Ô"3Ô"IÐIÐIr   c                 ó(   — t          |||¦  «         d S r   )r   )r%   r0   r   r6   s       r   rm   z#ClientDocumenter._add_custom_method¦   s   € Ý˜w¨°VÑ<Ô<Ð<Ð<Ð<r   c                 ó:  — |                      d¦  «        }|j                             ¦   «          |j                             d¦  «         |j                             ¦   «          |j        D ]1}| j        › d|j        › �}|j                             d|› d�¦  «         Œ2d S )NÚ
exceptionsÚ
Exceptionsú.Client.exceptions.z:py:class:`ú`)rG   rB   rI   ÚboldÚerror_shapesr   ÚnameÚli)r%   r0   Úoperation_modelÚerror_sectionÚerrorrV   s         r   Ú_add_method_exceptions_listz,ClientDocumenter._add_method_exceptions_list©   s¹   € Ø×/Ò/°Ñ=Ô=ˆØÔ×$Ò$Ñ&Ô&Ð&ØÔ× Ò  Ñ.Ô.Ð.ØÔ×$Ò$Ñ&Ô&Ð&Ø$Ô1ð 	@ð 	@ˆEàÔ*ÐKÐK¸u¼zÐKÐKð ð Ô×"Ò"Ð#>°Ð#>Ð#>Ð#>Ñ?Ô?Ð?Ð?ð		@ð 	@r   c                 ó´  — | j         j        j        }| j         j        j        |         }|                     |¦  «        }d|› �}|j                             dd¦  «        › |› �}t          |||| j         j        j        |j	        |¬¦  «         |j
        r|                      ||¦  «         | j                             |¦  «        }|rt          ||||¦  «         d S d S )Nzresponse = client.rh   Ú )Úevent_emitterÚmethod_descriptionÚexample_prefix)r   r"   r#   rr   r}   ri   Úgetr   ÚeventsrK   rz   r€   r!   r   )	r%   r0   r   r#   Úoperation_namer}   r…   Úfull_method_namer(   s	            r   rn   z)ClientDocumenter._add_model_driven_method´   s  € ØœÔ)Ô7ˆØœÔ*Ô@ÀÔMˆØ'×7Ò7¸ÑGÔGˆà;¨kÐ;Ð;ˆàŒ×"Ò" ;°Ñ3Ô3ÐB°[ÐBÐBð 	õ 	%ØØØØœ,Ô+Ô2Ø.Ô<Ø)ð	
ñ 	
ô 	
ð 	
ð Ô'ð 	GØ×,Ò,¨W°oÑFÔFÐFð Ô/×3Ò3°NÑCÔCˆØð 	Ý$Ø˜¨.¸/ñô ð ð ð ð	ð 	r   r   )r   Ú
__module__Ú__qualname__r   r<   r)   r2   r-   r4   r8   r+   r.   r,   rL   r/   r_   rl   rm   r€   rn   r   r   r   r   r   #   s  € € € € € à)ðÐðJð Jð Jð Jð	1ð 	1ð 	1ð;ð ;ð ;ð
 ð 
 ð 
 ðð ð ð#ð #ð #ðPð Pð Pð2
ð 
ð 
ð
&ð &ð &ðMð Mð Mð Gð Gð Gð(Jð Jð Jð=ð =ð =ð	@ð 	@ð 	@ðð ð ð ð r   r   c                   óÒ   — e Zd ZdZ eddd ed eddd¬¦  «        fd	 ed	dd
¬¦  «        fg¦  «        ¬¦  «        Zd„ Zd„ Zd„ Z	d„ Z
d„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ ZdS )ÚClientExceptionsDocumenterzBhttps://docs.aws.amazon.com/boto3/latest/guide/error-handling.htmlÚErrorÚ	structurez1Normalized access to common exception attributes.ÚCodeÚstringz,An identifier specifying the exception type.)r{   Ú	type_namerK   ÚMessagez;A descriptive message explaining why the exception occured.)r{   r’   rK   Úmembersc                 ó„   — || _         | j         j        j        | _        | j         j        j        j        | _        || _        d S r   )	r   r   r   r   r"   r#   r   r$   r    )r%   r&   r'   s      r   r)   z#ClientExceptionsDocumenter.__init__õ   s:   € ØˆŒØ"&¤,Ô"8Ô"AˆÔØ!œ\Ô.Ô<ÔIˆÔØ-ˆÔÐÐr   c                 ó¬   — |                       |¦  «         |                      |¦  «         |                      |¦  «         |                      ¦   «          d S r   )r+   Ú_add_overviewÚ_add_exceptions_listÚ_add_exception_classesrD   s     r   Údocument_exceptionsz.ClientExceptionsDocumenter.document_exceptionsû   sT   € Ø�Š˜Ñ Ô Ð Ø×Ò˜7Ñ#Ô#Ð#Ø×!Ò! 'Ñ*Ô*Ð*Ø×#Ò#Ñ%Ô%Ð%Ð%Ð%r   c                 ó:   — |j                              d¦  «         d S )NzClient ExceptionsrA   rD   s     r   r+   z%ClientExceptionsDocumenter._add_title  s   € ØŒ×ÒÐ,Ñ-Ô-Ð-Ð-Ð-r   c                 ó   — |j                              ¦   «          |                     d¦  «         |j                              d| j        ¬¦  «         |                     d¦  «         |j                              ¦   «          d S )NzÂClient exceptions are available on a client instance via the ``exceptions`` property. For more detailed instructions and examples on the exact usage of client exceptions, see the error handling z
user guide©ÚtitleÚlinkú.)rB   rI   rH   Úexternal_linkÚ_USER_GUIDE_LINKrD   s     r   r—   z(ClientExceptionsDocumenter._add_overview  s‰   € ØŒ×ÒÑ Ô Ð Ø�Šðñ	
ô 	
ð 	
ð 	Œ×#Ò#ØØÔ&ð 	$ñ 	
ô 	
ð 	
ð 	�Š�cÑÔÐØŒ×ÒÑ Ô Ð Ð Ð r   c                 ó$   — | j         › d|j        › �S )Nrw   )r   r{   )r%   Úshapes     r   Ú_exception_class_namez0ClientExceptionsDocumenter._exception_class_name  s   € ØÔ)ÐJÐJ¸e¼jÐJÐJÐJr   c                 ó²  — | j         j        j        j        }|sI|j                             ¦   «          |                     d¦  «         |j                             ¦   «          d S |j                             ¦   «          |                     d¦  «         |j                             ¦   «          |D ]+}|j         	                    | j
        › d|j        › �¦  «         Œ,d S )Nz-This client has no modeled exception classes.z$The available client exceptions are:z/client/exceptions/)r   r"   r#   rz   rB   rI   rH   rO   rP   rR   r$   r{   )r%   r0   rz   r¤   s       r   r˜   z/ClientExceptionsDocumenter._add_exceptions_list  sã   € Ø”|Ô(Ô6ÔCˆØð 	ØŒM×"Ò"Ñ$Ô$Ð$Ø�MŠMÐIÑJÔJÐJØŒM×"Ò"Ñ$Ô$Ð$ØˆFØŒ×ÒÑ Ô Ð Ø�ŠÐ>Ñ?Ô?Ð?ØŒ×ÒÑÔÐØ!ð 	ð 	ˆEØŒM×!Ò!ØÔ%ÐFÐF¸%¼*ÐFÐFñô ð ð ð	ð 	r   c                 ó  — | j         j        j        j        D ]u}t	          |j        d¬¦  «        }|                      ||¦  «         t          j         	                    | j
        | j        dd¦  «        }|                     ||j        ¦  «         Œvd S )Nr\   r]   r&   ru   )r   r"   r#   rz   r   r{   Ú_add_exception_classr`   ra   rb   r    r$   rc   )r%   r¤   Úexception_doc_structureÚexception_dir_paths       r   r™   z1ClientExceptionsDocumenter._add_exception_classes%  s«   € Ø”\Ô&Ô4ÔAð 	ð 	ˆEå&7Ø”
 6ð'ñ 'ô 'Ð#ð ×%Ò%Ð&=¸uÑEÔEÐEõ "$¤§¢ØÔ$ØÔ"ØØñ	"ô "Ðð $×1Ò1Ø" E¤Jñô ð ð ð	ð 	r   c                 ó8  — |                      d¦  «        }|j                             | j        d| j        › �¦  «         |                     d|j        › �¦  «         |                     |j        ¦  «         |                      |j        ¦  «        }|                      |¦  «        }|j         	                    |¬¦  «         |  
                    ||¦  «         |                      ||¦  «         |                      ||¦  «         |j                             ¦   «          d S )Nrg   z	../../../z / Client / exceptions / rU   )rG   rB   rj   r   r$   rH   r{   rk   r¥   rW   Ú_add_top_level_documentationÚ_add_exception_catch_exampleÚ_add_response_attrÚend_sphinx_py_class)r%   r0   r¤   ro   Úclass_sectionrV   s         r   r¨   z/ClientExceptionsDocumenter._add_exception_class8  s  € Ø$×4Ò4°\ÑBÔBÐØÔ ×$Ò$ØÔ#Ð%E°Ô1CÐ%EÐ%Eñ	
ô 	
ð 	
ð 	× Ò Ð!I¸U¼ZÐ!IÐ!IÑJÔJÐJØ×!Ò! %¤*Ñ-Ô-Ð-Ø×/Ò/°´
Ñ;Ô;ˆØ×/Ò/°Ñ6Ô6ˆ
ØÔ×1Ò1¸ZÐ1ÑHÔHÐHØ×)Ò)¨-¸Ñ?Ô?Ð?Ø×)Ò)¨-¸Ñ?Ô?Ð?Ø×Ò ¨uÑ5Ô5Ð5ØÔ×/Ò/Ñ1Ô1Ð1Ð1Ð1r   c                 ó°   — |j         rN|j                             ¦   «          |                     |j         ¦  «         |j                             ¦   «          d S d S r   )rK   rB   rI   rJ   ©r%   r0   r¤   s      r   r¬   z7ClientExceptionsDocumenter._add_top_level_documentationG  s\   € ØÔð 	%ØŒM×"Ò"Ñ$Ô$Ð$Ø×&Ò& uÔ':Ñ;Ô;Ð;ØŒM×"Ò"Ñ$Ô$Ð$Ð$Ð$ð	%ð 	%r   c                 ó  — |j                              ¦   «          |j                              d¦  «         |j                              ¦   «          |j                              ¦   «          |                     d¦  «         |j                              ¦   «          |j                              ¦   «          |                     d¦  «         |j                              ¦   «          |j                              ¦   «          |                     d|j        › d�¦  «         |j                              ¦   «          |j                              ¦   «          |                     d¦  «         |j                              ¦   «          |j          	                    ¦   «          d S )NÚExampleztry:z...zexcept client.exceptions.z as e:zprint(e.response))
rB   rI   ry   rN   rY   rH   ÚindentrM   r{   rZ   r²   s      r   r­   z7ClientExceptionsDocumenter._add_exception_catch_exampleM  sQ  € ØŒ×ÒÑ Ô Ð ØŒ×Ò˜9Ñ%Ô%Ð%ØŒ×#Ò#Ñ%Ô%Ð%ØŒ×%Ò%Ñ'Ô'Ð'Ø�Š�fÑÔÐØŒ×ÒÑÔÐØŒ×ÒÑ Ô Ð Ø�Š�eÑÔÐØŒ×ÒÑÔÐØŒ×ÒÑ Ô Ð Ø�ŠÐD°%´*ÐDÐDÐDÑEÔEÐEØŒ×ÒÑÔÐØŒ×ÒÑ Ô Ð Ø�ŠÐ)Ñ*Ô*Ð*ØŒ×ÒÑÔÐØŒ×#Ò#Ñ%Ô%Ð%Ð%Ð%r   c                 ó  — |                      d¦  «        }|j                             d¦  «         |                      |¦  «         |                      ||¦  «         |                      ||¦  «         |j                             ¦   «          d S )NÚresponse)rG   rB   Ústart_sphinx_py_attrÚ_add_response_attr_descriptionÚ_add_response_exampleÚ_add_response_paramsÚend_sphinx_py_attr)r%   r0   r¤   Úresponse_sections       r   r®   z-ClientExceptionsDocumenter._add_response_attr_  s‹   € Ø"×2Ò2°:Ñ>Ô>ÐØÔ×3Ò3°JÑ?Ô?Ð?Ø×+Ò+Ð,<Ñ=Ô=Ð=Ø×"Ò"Ð#3°UÑ;Ô;Ð;Ø×!Ò!Ð"2°EÑ:Ô:Ð:ØÔ×1Ò1Ñ3Ô3Ð3Ð3Ð3r   c                 ó”   — |j                              ¦   «          |                     d¦  «         |j                              ¦   «          d S )NzÈThe parsed error response. All exceptions have a top level ``Error`` key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.)rB   rI   rJ   rD   s     r   r¹   z9ClientExceptionsDocumenter._add_response_attr_descriptiong  sO   € ØŒ×ÒÑ Ô Ð Ø×"Ò"ð*ñ	
ô 	
ð 	
ð 	Œ×ÒÑ Ô Ð Ð Ð r   c                 óP  — |                      d¦  «        }|j                             ¦   «          |j                             d¦  «         |j                             ¦   «          t          | j        d | j        j        j	        ¬¦  «        }| 
                    ||| j        g¬¦  «         d S )NÚsyntaxÚSyntax©r   rˆ   rƒ   ©r:   )rG   rB   rI   ry   rN   r   r$   r   r"   r‡   Údocument_exampleÚ_GENERIC_ERROR_SHAPE)r%   r0   r¤   Úexample_sectionÚ
documenters        r   rº   z0ClientExceptionsDocumenter._add_response_exampleq  s¶   € Ø!×1Ò1°(Ñ;Ô;ˆØÔ×&Ò&Ñ(Ô(Ð(ØÔ×"Ò" 8Ñ,Ô,Ð,ØÔ×+Ò+Ñ-Ô-Ð-Ý.ØÔ+ØØœ,Ô+Ô2ð
ñ 
ô 
ˆ
ð
 	×#Ò#ØØØÔ.Ð/ð 	$ñ 	
ô 	
ð 	
ð 	
ð 	
r   c                 óP  — |                      d¦  «        }|j                             ¦   «          |j                             d¦  «         |j                             ¦   «          t          | j        d | j        j        j	        ¬¦  «        }| 
                    ||| j        g¬¦  «         d S )NÚ	StructurerÂ   rÃ   )rG   rB   rI   ry   rN   r
   r$   r   r"   r‡   Údocument_paramsrÅ   )r%   r0   r¤   Úparams_sectionrÇ   s        r   r»   z/ClientExceptionsDocumenter._add_response_params�  s¶   € Ø ×0Ò0°Ñ=Ô=ˆØÔ×%Ò%Ñ'Ô'Ð'ØÔ×!Ò! +Ñ.Ô.Ð.ØÔ×*Ò*Ñ,Ô,Ð,Ý-ØÔ+ØØœ,Ô+Ô2ð
ñ 
ô 
ˆ
ð
 	×"Ò"ØØØÔ.Ð/ð 	#ñ 	
ô 	
ð 	
ð 	
ð 	
r   N)r   rŠ   r‹   r¢   r   r   rÅ   r)   rš   r+   r—   r¥   r˜   r™   r¨   r¬   r­   r®   r¹   rº   r»   r   r   r   r�   r�   Ò   sw  € € € € € àLð ð +˜?ØØØJØ�ð Ø#�OØ#Ø"*àJð	ñ ô ð	ð Ø#�OØ&Ø"*ð'ð	ñ ô ð
ðñ
ô 
ð	ñ ô Ðð>.ð .ð .ð&ð &ð &ð.ð .ð .ð!ð !ð !ðKð Kð Kðð ð ðð ð ð&2ð 2ð 2ð%ð %ð %ð&ð &ð &ð$4ð 4ð 4ð!ð !ð !ð
ð 
ð 
ð 
ð 
ð 
ð 
ð 
r   r�   c                   ó:   — e Zd ZdZdddœZd„ Zd„ Zd„ Zd„ Zd	„ Z	d
S )ÚClientContextParamsDocumenterzAhttps://docs.aws.amazon.com/boto3/latest/guide/configuration.html)Ú
AccelerateÚDisableMultiRegionAccessPointsÚForcePathStyleÚUseArnRegion)rÑ   )r   Ú	s3controlc                 ó"   — || _         || _        d S r   )r$   Ú_context_params)r%   r   Úcontext_paramss      r   r)   z&ClientContextParamsDocumenter.__init__¡  s   € Ø)ˆÔØ-ˆÔÐÐr   c                 ó„   — |                       |¦  «         |                      |¦  «         |                      |¦  «         d S r   )r+   r—   Ú_add_context_params_listrD   s     r   Údocument_context_paramsz5ClientContextParamsDocumenter.document_context_params¥  sB   € Ø�Š˜Ñ Ô Ð Ø×Ò˜7Ñ#Ô#Ð#Ø×%Ò% gÑ.Ô.Ð.Ð.Ð.r   c                 ó:   — |j                              d¦  «         d S )NzClient Context ParametersrA   rD   s     r   r+   z(ClientContextParamsDocumenter._add_titleª  s   € ØŒ×ÒÐ4Ñ5Ô5Ð5Ð5Ð5r   c                 ó   — |j                              ¦   «          |                     d¦  «         |j                              d| j        ¬¦  «         |                     d¦  «         |j                              ¦   «          d S )NzßClient context parameters are configurable on a client instance via the ``client_context_params`` parameter in the ``Config`` object. For more detailed instructions and examples on the exact usage of context params see the zconfiguration guider�   r    )rB   rI   rH   r¡   Ú_CONFIG_GUIDE_LINKrD   s     r   r—   z+ClientContextParamsDocumenter._add_overview­  s‰   € ØŒ×ÒÑ Ô Ð Ø�Šð<ñ	
ô 	
ð 	
ð 	Œ×#Ò#Ø'ØÔ(ð 	$ñ 	
ô 	
ð 	
ð 	�Š�cÑÔÐØŒ×ÒÑ Ô Ð Ð Ð r   c           	      óF  — |j                              ¦   «          d| j        › d�}|                     d|› d�¦  «         | j        D ][}|j                              ¦   «          dt          |j        ¦  «        › d�}|                     d|› d|j        › d|j	        › �¦  «         Œ\d S )Nz``zThe available z client context params are:z* z (z) - )
rB   rI   r$   rO   rÔ   r   r{   rH   ÚtyperK   )r%   r0   ÚsnÚparamr{   s        r   r×   z6ClientContextParamsDocumenter._add_context_params_list¼  sÈ   € ØŒ×ÒÑ Ô Ð Ø(�$Ô$Ð(Ð(Ð(ˆØ�ŠÐH¨ÐHÐHÐHÑIÔIÐIØÔ)ð 	Nð 	NˆEØŒM×"Ò"Ñ$Ô$Ð$Ø2�
 5¤:Ñ.Ô.Ð2Ð2Ð2ˆDØ�MŠMÐL˜tÐLÐL u¤zÐLÐL°uÔ7JÐLÐLÑMÔMÐMÐMð	Nð 	Nr   N)
r   rŠ   r‹   rÛ   ÚOMITTED_CONTEXT_PARAMSr)   rØ   r+   r—   r×   r   r   r   rÍ   rÍ   ’  sƒ   € € € € € àKð ð

ð 'ðð Ðð.ð .ð .ð/ð /ð /ð
6ð 6ð 6ð!ð !ð !ðNð Nð Nð Nð Nr   rÍ   )r`   Úbotocorer   Úbotocore.compatr   Úbotocore.docs.bcdoc.restdocr   Úbotocore.docs.exampler   Úbotocore.docs.methodr   r   r	   Úbotocore.docs.paramsr
   Úbotocore.docs.sharedexampler   Úbotocore.docs.utilsr   r   r   r   r�   rÍ   r   r   r   ú<module>ré      su  ðð 
€	€	€	à Ð Ð Ð Ð Ð Ø 'Ð 'Ð 'Ð 'Ð 'Ð 'Ø 9Ð 9Ð 9Ð 9Ð 9Ð 9Ø ;Ð ;Ð ;Ð ;Ð ;Ð ;ðð ð ð ð ð ð ð ð ð ð
 :Ð 9Ð 9Ð 9Ð 9Ð 9Ø @Ð @Ð @Ð @Ð @Ð @Ø JÐ JÐ JÐ JÐ JÐ JÐ JÐ Jð"ð "ð "ðlð lð lð lð lñ lô lð lð^}
ð }
ð }
ð }
ð }
ñ }
ô }
ð }
ð@1Nð 1Nð 1Nð 1Nð 1Nñ 1Nô 1Nð 1Nð 1Nð 1Nr   