§
    @xÅjB!  ã                   ó~   — d dl Z d dlmZ d dlmZ d dlmZ d dlZd dl	m
Z
 d dlmZmZ d dlmZ  G d„ d	e¦  «        ZdS )
é    N)ÚDocumentStructure)ÚServiceDocumenter)ÚDataNotFoundError)ÚBoto3ClientDocumenter)ÚResourceDocumenterÚServiceResourceDocumenter)ÚServiceContextc                   ó¸   ‡ — e Zd Zej                             ej                             ej        ¦  «        d¦  «        Z	ˆ fd„Z
d„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd	„ Zˆ xZS )
r   Úexamplesc                 ó`  •— t          ¦   «                              ||j        |¬¦  «         || _        | j                             |¦  «        | _        d | _        | j        | j                             ¦   «         v r| j         	                    |¦  «        | _        g d¢| _
        || _        d| _        d S )N)Úservice_nameÚsessionÚroot_docs_path)ÚtitleÚclientÚ
paginatorsÚwaitersÚ	resourcesr   úcontext-paramsz=https://docs.aws.amazon.com/boto3/latest/guide/resources.html)ÚsuperÚ__init__Ú_sessionÚ_boto3_sessionr   Ú_clientÚ_service_resourceÚ_service_nameÚget_available_resourcesÚresourceÚsectionsÚ_root_docs_pathÚ_USER_GUIDE_LINK)Úselfr   r   r   Ú	__class__s       €úCC:\Projects\Historical\venv\Lib\site-packages\boto3/docs/service.pyr   zServiceDocumenter.__init__   sÀ   ø€ Ý‰Œ×ÒØ%ð Ô$Ø)ð 	ñ 	
ô 	
ð 	
ð &ˆÔØÔ*×1Ò1°,Ñ?Ô?ˆŒØ!%ˆÔØÔ Ô!4×!LÒ!LÑ!NÔ!NÐNÐNØ%)Ô%8×%AÒ%AÀ,Ñ%OÔ%OˆDÔ"ð
ð 
ð 
ˆŒð  .ˆÔàKð 	ÔÐÐó    c                 ó¤  — t          | j        | j        d¬¦  «        }|                      |                     d¦  «        ¦  «         |                      |                     d¦  «        ¦  «         |                      |                     d¦  «        ¦  «         |                      |                     d¦  «        ¦  «         | j        r(|  	                    |                     d¦  «        ¦  «         |  
                    |                     d¦  «        ¦  «         |                     d	¦  «        }|                      |¦  «         |                     ¦   «         S )
ziDocuments an entire service.

        :returns: The reStructured text of the documented service.
        Úhtml)Úsection_namesÚtargetr   r   r   r   r   r   r   )r   r   r   r   Úget_sectionÚ
client_apiÚpaginator_apiÚ
waiter_apir   Úresource_sectionÚ_document_examplesÚclient_context_paramsÚflush_structure)r"   Údoc_structureÚcontext_params_sections      r$   Údocument_servicez"ServiceDocumenter.document_service8   s4  € õ
 *ØÔ¨d¬mÀFð
ñ 
ô 
ˆð 	�
Š
�=×,Ò,¨WÑ5Ô5Ñ6Ô6Ð6à�Š˜×1Ò1°(Ñ;Ô;Ñ<Ô<Ð<Ø×Ò˜=×4Ò4°\ÑBÔBÑCÔCÐCØ�Š˜×1Ò1°)Ñ<Ô<Ñ=Ô=Ð=ØÔ!ð 	JØ×!Ò! -×";Ò";¸KÑ"HÔ"HÑIÔIÐIØ×Ò × 9Ò 9¸*Ñ EÔ EÑFÔFÐFØ!.×!:Ò!:Ð;KÑ!LÔ!LÐØ×"Ò"Ð#9Ñ:Ô:Ð:Ø×,Ò,Ñ.Ô.Ð.r%   c                 ó¾   — d }	 |                       | j        ¦  «        }n# t          $ r Y nw xY wt          | j        | j        |¦  «                             |¦  «         d S )N)Úget_examplesr   r   r   r   r    Údocument_client)r"   Úsectionr   s      r$   r+   zServiceDocumenter.client_apiL   su   € Øˆð	Ø×(Ò(¨Ô);Ñ<Ô<ˆHˆHøÝ ð 	ð 	ð 	ØˆDð	øøøõ 	ØŒL˜$Ô.°ñ	
ô 	
ç
Š/˜'Ñ
"Ô
"Ð
"Ð
"Ð
"s   „ Ÿ
,«,c                 óH  — |j                              d¦  «         |j                              ¦   «          |                     d¦  «         |j                              d| j        ¬¦  «         |                     d¦  «         |j                              ¦   «          |j                              ¦   «          |                     d¦  «         |j                              ¦   «          |j                              ¦   «          |                      |¦  «         |                      |¦  «         d S )NÚ	Resourcesz—Resources are available in boto3 via the ``resource`` method. For more detailed instructions and examples on the usage of resources, see the resources z
user guide)r   Úlinkú.zThe available resources are:)	ÚstyleÚh2Únew_lineÚwriteÚexternal_linkr!   ÚtoctreeÚ_document_service_resourceÚ_document_resources)r"   r8   s     r$   r.   z"ServiceDocumenter.resource_sectionW   s  € ØŒ×Ò˜Ñ%Ô%Ð%ØŒ×ÒÑ Ô Ð Ø�Šðñ	
ô 	
ð 	
ð 	Œ×#Ò#ØØÔ&ð 	$ñ 	
ô 	
ð 	
ð 	�Š�cÑÔÐØŒ×ÒÑ Ô Ð ØŒ×ÒÑ Ô Ð Ø�ŠÐ4Ñ5Ô5Ð5ØŒ×ÒÑ Ô Ð ØŒ×ÒÑÔÐØ×'Ò'¨Ñ0Ô0Ð0Ø× Ò  Ñ)Ô)Ð)Ð)Ð)r%   c                 ó€  — t          dd¬¦  «        }|                     d¦  «        }|j                             | j        j        j        d| j        › �¦  «         |                     d¦  «         t          | j
        | j        | j        ¦  «                             |¦  «         | j
        j        j        j        }|| j        k    rd}t"          j                             | j        | j        › |                     ¦   «         › ¦  «        }|                     |d¦  «         |j                             | j        › d|› d	�¦  «         d S )
Nzservice-resourcer'   ©r)   Ú
breadcrumbú../../z / Resource / ServiceResourceÚindexú/ú/index)r   Úadd_new_sectionr=   Úrefr   r#   Ú__name__r   r@   r   r   r   r    Údocument_resourceÚmetaÚresource_modelÚnameÚosÚpathÚjoinÚlowerÚwrite_to_fileÚtocitem)r"   r8   Úservice_resource_docÚbreadcrumb_sectionÚresource_nameÚservice_resource_dir_paths         r$   rC   z,ServiceDocumenter._document_service_resourcem   sQ  € å0Ø vð 
ñ  
ô  
Ðð 2×AÒAÀ,ÑOÔOÐØÔ ×$Ò$ØŒLÔ"Ô+Ð-J°dÔ6HÐ-JÐ-Jñ	
ô 	
ð 	
ð 	× Ò Ð!@ÑAÔAÐAÝ!ØÔ" D¤M°4Ô3Gñ	
ô 	
ç
Ò
Ð0Ñ
1Ô
1Ð
1ð Ô.Ô3ÔBÔGˆØ˜DÔ.Ò.Ð.Ø.ˆMÝ$&¤G§L¢LØÔ ØÔ!Ð#Ø×"Ò"Ñ$Ô$Ð&ñ%
ô %
Ð!ð
 	×*Ò*Ð+DÀgÑNÔNÐNØŒ×Ò Ô!3ÐKÐK°mÐKÐKÐKÑLÔLÐLÐLÐLr%   c                 ó„  — d}| j                              d¦  «        }|                     | j        d¦  «        }| j        j        j        j        j        }|d         D �]ã}|d         |         }| j        j	         
                    ||t          | j        |d         |d ¬¦  «        ¬¦  «        }|j        j        j        }	g }
|	D ]}|
                     |¦  «         Œ ||
d| j        iŽ}|j        j        j                             ¦   «         }t%          |d¬	¦  «        }|                     d
¦  «        }|j                             | j        j        j        d| j        › �¦  «         |                     d|j        j        j        › �¦  «         t3          || j         | j        ¦  «                             |                     |j        j        j        ¦  «        ¦  «         t8          j                             | j        | j        › |› ¦  «        }|                     |d¦  «         |j                              | j        › d|› d�¦  «         �Œåd S )NÚfooÚdata_loaderzresources-1r   )r   Úresource_json_definitionsÚservice_modelÚservice_waiter_model)r[   Úsingle_resource_json_definitionÚservice_contextr   r'   rF   rG   rH   z / Resource / rI   rJ   rK   )!r   Úget_componentÚload_service_modelr   r   rP   r   ra   r   Úresource_factoryÚload_from_definitionr	   rQ   ÚidentifiersÚappendr   rR   rV   r   rL   r=   rM   r#   rN   r@   r   r    rO   rS   rT   rU   rW   rX   )r"   r8   Útemp_identifier_valueÚloaderÚjson_resource_modelra   r[   rQ   Úresource_clsri   ÚargsÚ_r   Úresource_docrZ   r\   s                   r$   rD   z%ServiceDocumenter._document_resources‡   s‰  € Ø %ÐØ”×,Ò,¨]Ñ;Ô;ˆØ$×7Ò7ØÔ ñ
ô 
Ðð Ô.Ô3Ô:Ô?ÔMˆØ0°Ô=ð .	ñ .	ˆMØ0°Ô=¸mÔLˆNàÔ#Ô4×IÒIØ"/Ø4BÝ$2Ø%)Ô%7Ø2EØ'ô3ð '4Ø-1ð%ñ %ô %ð Jñ ô ð ð 'Ô+Ô:ÔFˆKØˆDØ ð 3ð 3�Ø—’Ð1Ñ2Ô2Ð2Ð2Ø#�| TÐ?°$´,Ð?Ð?ˆHà$œMÔ8Ô=×CÒCÑEÔEˆMÝ,¨]À6ÐJÑJÔJˆLØ!-×!=Ò!=¸lÑ!KÔ!KÐØÔ$×(Ò(Ø”Ô&Ô/Ð1N¸$Ô:LÐ1NÐ1Nñô ð ð ×$Ò$ØD ¤Ô!=Ô!BÐDÐDñô ð õ Ø˜$œ-¨Ô)=ñô çÒØ×,Ò,¨X¬]Ô-IÔ-NÑOÔOñô ð õ
 )+¬¯ªØÔ$ØÔ%Ð'Ø Ð"ñ)ô )Ð%ð
 ×&Ò&Ð'@À'ÑJÔJÐJØŒM×!Ò!ØÔ%Ð=Ð=¨Ð=Ð=Ð=ñô ð ñ ðY.	ð .	r%   c                 ó–   — t           j                             t           j                             | j        | j        › d�¦  «        ¦  «        S )Nz.rst)rS   rT   ÚrealpathrU   ÚEXAMPLE_PATHr   )r"   s    r$   Ú_get_example_filez#ServiceDocumenter._get_example_file¾   s>   € ÝŒw×ÒÝŒG�LŠL˜Ô*¨tÔ/AÐ,GÐ,GÐ,GÑHÔHñ
ô 
ð 	
r%   c                 ót  — |                       ¦   «         }t          j                             |¦  «        r„|j                             d¦  «         |j                             ¦   «          t          |¦  «        5 }|                     | 	                    ¦   «         ¦  «         d d d ¦  «         d S # 1 swxY w Y   d S d S )NÚExamples)
ru   rS   rT   Úisfiler=   r>   r?   Úopenr@   Úread)r"   r8   Úexamples_fileÚfs       r$   r/   z$ServiceDocumenter._document_examplesÃ   sæ   € Ø×.Ò.Ñ0Ô0ˆÝŒ7�>Š>˜-Ñ(Ô(ð 	(ØŒM×Ò˜ZÑ(Ô(Ð(ØŒM×"Ò"Ñ$Ô$Ð$Ý�mÑ$Ô$ð (¨Ø—’˜aŸfšf™hœhÑ'Ô'Ð'ð(ð (ð (ñ (ô (ð (ð (ð (ð (ð (ð (ð (øøøð (ð (ð (ð (ð (ð (ð	(ð 	(s   Á6(B+Â+B/Â2B/)rN   Ú
__module__Ú__qualname__rS   rT   rU   ÚdirnameÚboto3Ú__file__rt   r   r4   r+   r.   rC   rD   ru   r/   Ú__classcell__)r#   s   @r$   r   r      sÊ   ø€ € € € € à”7—<’< ¤§¢°´Ñ ?Ô ?ÀÑLÔL€Lð
ð 
ð 
ð 
ð 
ð6/ð /ð /ð(	#ð 	#ð 	#ð*ð *ð *ð,Mð Mð Mð45ð 5ð 5ðn
ð 
ð 
ð
(ð (ð (ð (ð (ð (ð (r%   r   )rS   Úbotocore.docs.bcdoc.restdocr   Úbotocore.docs.servicer   ÚBaseServiceDocumenterÚbotocore.exceptionsr   r€   Úboto3.docs.clientr   Úboto3.docs.resourcer   r   Úboto3.utilsr	   © r%   r$   ú<module>r‹      sÊ   ðð 
€	€	€	à 9Ð 9Ð 9Ð 9Ð 9Ð 9Ø LÐ LÐ LÐ LÐ LÐ LØ 1Ð 1Ð 1Ð 1Ð 1Ð 1à €€€Ø 3Ð 3Ð 3Ð 3Ð 3Ð 3Ø MÐ MÐ MÐ MÐ MÐ MÐ MÐ MØ &Ð &Ð &Ð &Ð &Ð &ðp(ð p(ð p(ð p(ð p(Ð-ñ p(ô p(ð p(ð p(ð p(r%   