ó
    Ú°›jB!  ã                   óv   • S SK r S SKJr  S SKJr  S SKJr  S SKrS SK	J
r
  S SKJrJr  S SKJr   " S S	\5      rg)
é    N)ÚDocumentStructure)ÚServiceDocumenter)ÚDataNotFoundError)ÚBoto3ClientDocumenter)ÚResourceDocumenterÚServiceResourceDocumenter)ÚServiceContextc                   óÐ   ^ • \ rS rSr\R
                  R                  \R
                  R                  \R                  5      S5      r
U 4S jrS rS rS rS rS rS	 rS
 rSrU =r$ )r   é   Úexamplesc                 óN  >• [         TU ]  UUR                  US9  X l        U R                  R	                  U5      U l        S U l        U R                  U R                  R                  5       ;   a   U R                  R                  U5      U l        / SQU l
        X0l        SU l        g )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       €ÚO/home/mande/repo/quber/.venv/lib/python3.13/site-packages/boto3/docs/service.pyr   ÚServiceDocumenter.__init__   s    ø€ Ü‰ÑØ%ð ×$Ñ$Ø)ð 	ñ 	
ð &ÔØ×*Ñ*×1Ñ1°,Ó?ˆŒØ!%ˆÔØ×Ñ ×!4Ñ!4×!LÑ!LÓ!NÓNØ%)×%8Ñ%8×%AÑ%AÀ,Ó%OˆDÔ"ò
ˆŒð  .ÔàKð 	Õó    c                 óF  • [        U R                  U R                  SS9nU R                  UR	                  S5      5        U R                  UR	                  S5      5        U R                  UR	                  S5      5        U R                  UR	                  S5      5        U R                  (       a   U R                  UR	                  S5      5        U R                  UR	                  S5      5        UR	                  S	5      nU R                  U5        UR                  5       $ )
zYDocuments 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_serviceÚ"ServiceDocumenter.document_service8   sê   € ô
 *Ø×Ñ¨d¯m©mÀFñ
ˆð 	�
‰
�=×,Ñ,¨WÓ5Ô6à�‰˜×1Ñ1°(Ó;Ô<Ø×Ñ˜=×4Ñ4°\ÓBÔCØ�‰˜×1Ñ1°)Ó<Ô=Ø×!×!Ø×!Ñ! -×";Ñ";¸KÓ"HÔIØ×Ñ × 9Ñ 9¸*Ó EÔFØ!.×!:Ñ!:Ð;KÓ!LÐØ×"Ñ"Ð#9Ô:Ø×,Ñ,Ó.Ð.r'   c                 óÀ   • S n U R                  U R                  5      n[        U R                  U R
                  U5      R                  U5        g ! [         a     N=f = f)N)Úget_examplesr   r   r   r   r!   Údocument_client)r#   Úsectionr   s      r%   r-   ÚServiceDocumenter.client_apiL   s[   € Øˆð	Ø×(Ñ(¨×);Ñ);Ó<ˆHô 	Ø�L‰L˜$×.Ñ.°ó	
ç
‰/˜'Õ
"øô !ó 	Ùð	ús   „A Á
AÁAc                 ó0  • UR                   R                  S5        UR                   R                  5         UR                  S5        UR                   R	                  SU R
                  S9  UR                  S5        UR                   R                  5         UR                   R                  5         UR                  S5        UR                   R                  5         UR                   R                  5         U R                  U5        U R                  U5        g )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#   r;   s     r%   r0   Ú"ServiceDocumenter.resource_sectionW   sÑ   € Ø�‰×Ñ˜Ô%Ø�‰×ÑÔ Ø�‰ðô	
ð 	�‰×#Ñ#ØØ×&Ñ&ð 	$ñ 	
ð 	�‰�cÔØ�‰×ÑÔ Ø�‰×ÑÔ Ø�‰Ð4Ô5Ø�‰×ÑÔ Ø�‰×ÑÔØ×'Ñ'¨Ô0Ø× Ñ  Õ)r'   c                 óØ  • [        SSS9nUR                  S5      nUR                  R                  U R                  R
                  R                  SU R                   35        UR                  S5        [        U R                  U R                  U R                  5      R                  U5        U R                  R                  R                  R                   nX@R                  :X  a  Sn["        R$                  R'                  U R                  U R                   UR)                  5        5      nUR+                  US5        UR                  R-                  U R                   SU S	35        g )
Nzservice-resourcer)   ©r+   Ú
breadcrumbú../../z / Resource / ServiceResourceÚindexÚ/ú/index)r   Úadd_new_sectionrA   Úrefr   r$   Ú__name__r   rD   r   r   r   r!   Údocument_resourceÚmetaÚresource_modelÚnameÚosÚpathÚjoinÚlowerÚwrite_to_fileÚtocitem)r#   r;   Úservice_resource_docÚbreadcrumb_sectionÚresource_nameÚservice_resource_dir_paths         r%   rG   Ú,ServiceDocumenter._document_service_resourcem   s8  € ä0Ø vñ 
Ðð 2×AÑAÀ,ÓOÐØ× Ñ ×$Ñ$Ø�L‰L×"Ñ"×+Ñ+¨v°d×6HÑ6HÐ5IÐ-Jô	
ð 	× Ñ Ð!@ÔAÜ!Ø×"Ñ" D§M¡M°4×3GÑ3Gó	
ç
Ñ
Ð0Ô
1ð ×.Ñ.×3Ñ3×BÑB×GÑGˆØ×.Ñ.Ó.Ø.ˆMÜ$&§G¡G§L¡LØ× Ñ Ø×!Ñ!Ð"Ø×"Ñ"Ó$Ð%ó%
Ð!ð
 	×*Ñ*Ð+DÀgÔNØ�‰×Ñ ×!3Ñ!3Ð 4°A°m°_ÀFÐKÕLr'   c                 óB  • SnU R                   R                  S5      nUR                  U R                  S5      nU R                  R
                  R                  R
                  R                  nUS    GH(  nUS   U   nU R                  R                  R                  UU[        U R                  US   US S9S9nUR
                  R                  R                  n	/ n
U	 H  nU
R                  U5        M     U" U
SU R                  06nUR
                  R                  R                   R#                  5       n[%        USS	9nUR'                  S
5      nUR(                  R+                  U R                  R,                  R.                  SU R                   35        UR1                  SUR
                  R                  R                    35        [3        XÀR                   U R4                  5      R7                  UR'                  UR
                  R                  R                   5      5        [8        R:                  R=                  U R4                  U R                   U 5      nUR?                  US5        UR(                  RA                  U R                   SU S35        GM+     g )NÚfooÚdata_loaderzresources-1r   )r   Úresource_json_definitionsÚservice_modelÚservice_waiter_model)r`   Úsingle_resource_json_definitionÚservice_contextr   r)   rK   rL   rM   z / Resource / rN   rO   rP   )!r   Úget_componentÚload_service_modelr   r   rU   r   rg   r   Úresource_factoryÚload_from_definitionr	   rV   ÚidentifiersÚappendr   rW   r[   r   rQ   rA   rR   r$   rS   rD   r   r!   rT   rX   rY   rZ   r\   r]   )r#   r;   Útemp_identifier_valueÚloaderÚjson_resource_modelrg   r`   rV   Úresource_clsro   ÚargsÚ_r   Úresource_docr_   ra   s                   r%   rH   Ú%ServiceDocumenter._document_resources‡   s]  € Ø %ÐØ—‘×,Ñ,¨]Ó;ˆØ$×7Ñ7Ø×Ñ ó
Ðð ×.Ñ.×3Ñ3×:Ñ:×?Ñ?×MÑMˆØ0°Õ=ˆMØ0°Ñ=¸mÑLˆNà×#Ñ#×4Ñ4×IÑIØ"/Ø4BÜ$2Ø%)×%7Ñ%7Ø2EØ'ñ3ð '4Ø-1ñ%ð Jð ð ð '×+Ñ+×:Ñ:×FÑFˆKØˆDÛ �Ø—‘Ð1Ö2ñ !á# TÐ?°$·,±,Ñ?ˆHà$ŸM™M×8Ñ8×=Ñ=×CÑCÓEˆMÜ,¨]À6ÑJˆLØ!-×!=Ñ!=¸lÓ!KÐØ×$Ñ$×(Ñ(Ø—‘×&Ñ&×/Ñ/°6¸$×:LÑ:LÐ9MÐ1Nôð ×$Ñ$Ø  §¡×!=Ñ!=×!BÑ!BÐ CÐDôô ØŸ-™-¨×)=Ñ)=óçÑØ×,Ñ,¨X¯]©]×-IÑ-I×-NÑ-NÓOôô
 )+¯©¯©Ø×$Ñ$Ø×%Ñ%Ð&Ø �/ó)Ð%ð
 ×&Ñ&Ð'@À'ÔJØ�M‰M×!Ñ!Ø×%Ñ%Ð& a¨ °fÐ=÷òY >r'   c                 óª   • [         R                  R                  [         R                  R                  U R                  U R
                   S35      5      $ )Nz.rst)rX   rY   ÚrealpathrZ   ÚEXAMPLE_PATHr   )r#   s    r%   Ú_get_example_fileÚ#ServiceDocumenter._get_example_file¾   s?   € Ü�w‰w×ÑÜ�G‰G�L‰L˜×*Ñ*¨t×/AÑ/AÐ.BÀ$Ð,GÓHó
ð 	
r'   c                 ó`  • U R                  5       n[        R                  R                  U5      (       ai  UR                  R                  S5        UR                  R                  5         [        U5       nUR                  UR                  5       5        S S S 5        g g ! , (       d  f       g = f)NÚExamples)
r|   rX   rY   ÚisfilerA   rB   rC   ÚopenrD   Úread)r#   r;   Úexamples_fileÚfs       r%   r1   Ú$ServiceDocumenter._document_examplesÃ   sw   € Ø×.Ñ.Ó0ˆÜ�7‰7�>‰>˜-×(Ñ(Ø�M‰M×Ñ˜ZÔ(Ø�M‰M×"Ñ"Ô$Ü�mÔ$¨Ø—‘˜aŸf™f›hÔ'÷ %Ð$ð )÷ %Õ$ús   Á5 BÂ
B-)r"   r   r   r!   r   r    )rS   Ú
__module__Ú__qualname__Ú__firstlineno__rX   rY   rZ   ÚdirnameÚboto3Ú__file__r{   r   r6   r-   r0   rG   rH   r|   r1   Ú__static_attributes__Ú__classcell__)r$   s   @r%   r   r      sW   ø† à—7‘7—<‘< §¡§¡°·±Ó ?ÀÓL€Lõ
ò6/ò(	#ò*ò,Mò45òn
÷
(ð (r'   r   )rX   Ú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Ý LÝ 1ã Ý 3ß MÝ &ôp(Ð-õ p(r'   