ó
    Ú°›j;  ã                   óÄ   • S SK r S SKJr  S SKJr  S SKJr  S SKJr  S SK	J
r
JrJr  S SKJr  S SKJr  S S	KJr  S S
KJrJrJrJr  S SKJr   " S S\5      r " S S\5      rg)é    N)Ú
xform_name)ÚDocumentStructure)Úget_official_service_name)ÚActionDocumenter)Údocument_attributeÚdocument_identifierÚdocument_reference)ÚBaseDocumenter)ÚCollectionDocumenter)ÚSubResourceDocumenter)Úadd_resource_type_overviewÚ!get_identifier_args_for_signatureÚget_identifier_descriptionÚ!get_identifier_values_for_example)ÚWaiterResourceDocumenterc                   ó‚   ^ • \ rS rSrU 4S jrS rS rS rS rS r	S r
S	 rS
 rS rS rS rS rS rS rS rSrU =r$ )ÚResourceDocumenteré%   c                 ó¾   >• [         TU ]  U5        X l        X0l        U R                  R                  5       U l        U R                  U R                  :X  a  SU l        g g )Nzservice-resource)ÚsuperÚ__init__Ú_botocore_sessionÚ_root_docs_pathÚ_resource_nameÚlowerÚ_resource_sub_pathÚ_service_name)ÚselfÚresourceÚbotocore_sessionÚroot_docs_pathÚ	__class__s       €ÚP/home/mande/repo/quber/.venv/lib/python3.13/site-packages/boto3/docs/resource.pyr   ÚResourceDocumenter.__init__&   sT   ø€ Ü‰Ñ˜Ô"Ø!1ÔØ-ÔØ"&×"5Ñ"5×";Ñ";Ó"=ˆÔØ×Ñ $×"4Ñ"4Ó4Ø&8ˆDÕ#ð 5ó    c                 óX  • U R                  U5        U R                  U5        U R                  U5        U R                  U5        U R	                  U5        U R                  U5        U R                  U5        U R                  U5        U R                  U5        U R                  U5        g )N)
Ú
_add_titleÚ_add_resource_noteÚ
_add_introÚ_add_identifiersÚ_add_attributesÚ_add_referencesÚ_add_actionsÚ_add_sub_resourcesÚ_add_collectionsÚ_add_waiters©r   Úsections     r#   Údocument_resourceÚ$ResourceDocumenter.document_resource.   sŠ   € Ø�‰˜Ô Ø×Ñ Ô(Ø�‰˜Ô Ø×Ñ˜gÔ&Ø×Ñ˜WÔ%Ø×Ñ˜WÔ%Ø×Ñ˜'Ô"Ø×Ñ Ô(Ø×Ñ˜gÔ&Ø×Ñ˜'Õ"r%   c                 óp   • UR                  S5      nUR                  R                  U R                  5        g )NÚtitle)Úadd_new_sectionÚstyleÚh2r   ©r   r2   Útitle_sections      r#   r'   ÚResourceDocumenter._add_title:   s,   € Ø×/Ñ/°Ó8ˆØ×Ñ×Ñ˜t×2Ñ2Õ3r%   c                 óZ  • / nU R                   R                  (       a8  U R                   R                   H  nUR                  UR                  5        M      [	        U5      nUR                  S5      nUR                  R                  U R                   SU S3S9  UR                  S5      nU R                  U5        UR                  S5      nU R                  Xr5        UR                  S5      nU R                  X‚5        UR                  S5      n	U	R                  R                  5         g )	NÚstart_classÚ(Ú))Ú
class_nameÚdescriptionÚexampleÚparamsÚ	end_class)Ú_resource_modelÚidentifiersÚappendÚnamer   r7   r8   Ústart_sphinx_py_classrA   Ú_add_descriptionÚ_add_exampleÚ_add_params_descriptionÚend_sphinx_py_class)
r   r2   Úidentifier_namesÚ
identifierÚ
class_argsr>   Údescription_sectionÚexample_sectionÚparam_sectionrE   s
             r#   r)   ÚResourceDocumenter._add_intro>   s  € ØÐØ×Ñ×+×+Ø"×2Ñ2×>Ô>�
Ø ×'Ñ'¨
¯©Ö8ñ ?ô 7Ð7GÓHˆ
Ø×-Ñ-¨mÓ<ˆØ×Ñ×/Ñ/ØŸ/™/Ð*¨!¨J¨<°qÐ9ð 	0ñ 	
ð
 *×9Ñ9¸-ÓHÐØ×ÑÐ1Ô2ð &×5Ñ5°iÓ@ˆØ×Ñ˜/Ô<ð $×3Ñ3°HÓ=ˆØ×$Ñ$ ]ÔEà×+Ñ+¨KÓ8ˆ	Ø�‰×+Ñ+Õ-r%   c                 óp   • [        U R                  5      nUR                  SU SU R                   35        g )NzA resource representing an Ú )r   Ú_service_modelÚwriter   ©r   r2   Úofficial_service_names      r#   rK   Ú#ResourceDocumenter._add_description[   s8   € Ü 9¸$×:MÑ:MÓ NÐØ�‰Ø)Ð*?Ð)@ÀÀ$×BUÑBUÐAVÐWõ	
r%   c           
      óR  • UR                   R                  5         UR                   R                  5         UR                  S5        UR                   R                  5         UR                   R                  5         UR                  U R                   SU R                   S35        UR                   R                  5         [        U5      nUR                  [        U R                  5       SU R                   SU R                   SU S35        UR                   R                  5         g )Núimport boto3ú = boto3.resource('ú')z = Ú.r?   r@   )	r8   Ústart_codeblockÚnew_linerY   r   r   r   r   Úend_codeblock)r   r2   rO   Úexample_valuess       r#   rL   ÚResourceDocumenter._add_examplea   sî   € Ø�‰×%Ñ%Ô'Ø�‰×ÑÔ Ø�‰�nÔ%Ø�‰×ÑÔ Ø�‰×ÑÔ Ø�‰Ø×!Ñ!Ð"Ð"6°t×7IÑ7IÐ6JÈ#ÐNô	
ð 	�‰×ÑÔ Ü:Ð;KÓLˆØ�‰Ü˜$×-Ñ-Ó.Ð/¨s°4×3EÑ3EÐ2FÀaÈ×H[ÑH[ÐG\Ð\]Ð^lÐ]mÐmnÐoô	
ð 	�‰×#Ñ#Õ%r%   c                 ó  • U Hy  n[        U R                  U5      nUR                  SU S35        UR                  R	                  5         UR                  SU SU 35        UR                  R	                  5         M{     g )Nz:type z: stringz:param z: )r   r   rY   r8   rc   )r   r2   rO   Úidentifier_namerB   s        r#   rM   Ú*ResourceDocumenter._add_params_descriptionq   ss   € Û/ˆOÜ4Ø×#Ñ# _óˆKð �M‰M˜F ?Ð"3°8Ð<Ô=Ø�M‰M×"Ñ"Ô$Ø�M‰M˜G OÐ#4°B°{°mÐDÔEØ�M‰M×"Ñ"Ö$ò  0r%   c                 ó.  • UR                   R                  5         UR                  SU S35        UR                   R                  5         UR                   R                  5         U R                  U    H  nUR                   R                  U 5        M!     g )Nz#These are the resource's available Ú:)r8   rc   rY   ÚtoctreeÚ
member_mapÚtocitem)r   r2   Úresource_member_typeÚmembers       r#   Ú_add_overview_of_member_typeÚ/ResourceDocumenter._add_overview_of_member_type{   sv   € Ø�‰×ÑÔ Ø�‰Ø2Ð3GÐ2HÈÐJô	
ð 	�‰×ÑÔ Ø�‰×ÑÔØ—o‘oÐ&:Ô;ˆFØ�M‰M×!Ñ! V HÖ.ò <r%   c                 ó|  • U R                   R                  R                  R                  nUR	                  S5      n/ nU(       a  X0R
                  S'   [        USSSS9  U GH=  nUR                  UR                  5        [        UR                  SS9nUR	                  S5      nUR                  R                  U R                  S	5        UR                  S
UR                   35        UR                  UR                  5        UR	                  UR                  SU R                   S30S9n[!        UU R"                  US9  [$        R&                  R)                  U R*                  U R,                   U R.                   5      nUR1                  X„R                  5        GM@     U(       a  U R3                  US5        g g )NrG   ÚIdentifierszYIdentifiers are properties of a resource that are set upon instantiation of the resource.Úidentifiers_attributes_intro©r2   Úresource_typerB   Ú
intro_linkÚhtml©ÚtargetÚ
breadcrumbÚindexz / Identifier / Ú	qualifierra   ©Úcontext)r2   Úresource_nameÚidentifier_model)Ú	_resourceÚmetaÚresource_modelrG   r7   rm   r   rH   rI   r   r8   ÚrefÚ_resource_class_namerY   Úadd_title_sectionrA   r   r   ÚosÚpathÚjoinr   r   r   Úwrite_to_filerq   )	r   r2   rG   Úmember_listrP   Úidentifier_docÚbreadcrumb_sectionÚidentifier_sectionÚidentifiers_dir_paths	            r#   r*   Ú#ResourceDocumenter._add_identifiers…   s‘  € Ø—n‘n×)Ñ)×8Ñ8×DÑDˆØ×)Ñ)¨-Ó8ˆØˆÞØ-8�O‰O˜MÑ*Ü&ØØ+ð>ð :òô &ˆJØ×Ñ˜zŸ™Ô/ä.¨z¯©ÀvÑNˆNØ!/×!?Ñ!?ÀÓ!MÐØ×$Ñ$×(Ñ(¨×)BÑ)BÀGÔLØ×$Ñ$Ð'7¸
¿¹Ð7HÐ%IÔJØ×,Ñ,¨Z¯_©_Ô=Ø!/×!?Ñ!?Ø—‘Ø$¨¯©Ð(9¸Ð&;Ð<ð "@ð "Ðô  Ø*Ø"×1Ñ1Ø!+òô $&§7¡7§<¡<Ø×$Ñ$Ø×%Ñ%Ð&Ø×*Ñ*Ð+ó$Ð ð
 ×(Ñ(Ð)=¿¹×Oñ1 &ö4 Ø×-Ñ-¨g°}ÕEð r%   c           
      óæ  • U R                   R                  R                  R                  R                  n0 nU R                   R                  R                  R
                  (       ah  UR                  U R                   R                  R                  R
                  5      nU R                   R                  R                  R                  U5      nUR                  S5      n/ nU(       a  [        USSSS9  XPR                  S'   [        U5       GHF  nX6   u  pxUR                  U5        [        USS9n	U	R                  S5      n
U
R                  R                  U R                   S	5        U
R#                  S
U 35        U	R%                  U5        U	R                  USU R&                   S30S9n[)        UU R*                  U R,                  UU R                   R                  R                  R                  R.                  US9  [0        R2                  R5                  U R6                  U R*                   U R8                   5      nU	R;                  XÆ5        GMI     U(       a  U R=                  US5        g g )NÚ
attributesÚ
Attributesz”Attributes provide access to the properties of a resource. Attributes are lazy-loaded the first time one is accessed via the :py:meth:`load` method.ru   rv   ry   rz   r|   r}   z / Attribute / r~   ra   r   )r2   Úservice_namer�   Ú	attr_nameÚevent_emitterÚ
attr_model)rƒ   r„   ÚclientÚservice_modelr…   ÚshapeÚ	shape_forÚget_attributesr7   r   rm   ÚsortedrH   r   r8   r†   r‡   rY   rˆ   rA   r   r   r   Úeventsr‰   rŠ   r‹   r   r   rŒ   rq   )r   r2   r›   r”   rœ   Úattribute_listr—   Ú_Ú
attr_shapeÚattribute_docr�   Úattribute_sectionÚattributes_dir_paths                r#   r+   Ú"ResourceDocumenter._add_attributes±   s$  € ØŸ™×+Ñ+×2Ñ2×7Ñ7×EÑEˆØˆ
Ø�>‰>×Ñ×-Ñ-×3×3Ø!×+Ñ+Ø—‘×#Ñ#×2Ñ2×8Ñ8óˆEð Ÿ™×,Ñ,×;Ñ;×JÑJØóˆJð ×)Ñ)¨,Ó7ˆØˆÞÜ&ØØ*ð/ð
 :ò
ð -;�O‰O˜LÑ)Ü 
×+ˆIØ&Ñ1‰MˆAØ×!Ñ! )Ô,ä-¨iÀÑGˆMØ!.×!>Ñ!>¸|Ó!LÐØ×$Ñ$×(Ñ(¨×)BÑ)BÀGÔLØ×$Ñ$ °y°kÐ%BÔCØ×+Ñ+¨IÔ6Ø -× =Ñ =ØØ$¨¯©Ð(9¸Ð&;Ð<ð !>ð !Ðô Ø)Ø!×/Ñ/Ø"×1Ñ1Ø#Ø"Ÿn™n×1Ñ1×8Ñ8×=Ñ=×DÑDØ%òô #%§'¡'§,¡,Ø×$Ñ$Ø×%Ñ%Ð&Ø×*Ñ*Ð+ó#Ðð
 ×'Ñ'Ð(;×Gñ9 ,ö: Ø×-Ñ-¨g°|ÕDð r%   c                 óf  • UR                  S5      nU R                  R                  R                  R                  n/ nU(       a  [        USSSS9  X0R                  S'   U GH2  nUR                  UR                  5        [        UR                  SS9nUR                  S5      nUR                  R                  U R                  S	5        UR                  S
UR                   35        UR                  UR                  5        UR                  UR                  SU R                   S30S9n[!        UUS9  ["        R$                  R'                  U R(                  U R*                   U R,                   5      nUR/                  X„R                  5        GM5     U(       a  U R1                  US5        g g )NÚ
referencesÚ
ReferenceszNReferences are related resource instances that have a belongs-to relationship.Úreferences_introrv   ry   rz   r|   r}   z / Reference / r~   ra   r   )r2   Úreference_model)r7   rƒ   r„   r…   r©   r   rm   rH   rI   r   r8   r†   r‡   rY   rˆ   rA   r	   r‰   rŠ   r‹   r   r   r   rŒ   rq   )	r   r2   r©   Úreference_listÚ	referenceÚreference_docr�   Úreference_sectionÚreferences_dir_paths	            r#   r,   Ú"ResourceDocumenter._add_referencesê   s†  € Ø×)Ñ)¨,Ó7ˆØ—^‘^×(Ñ(×7Ñ7×BÑBˆ
ØˆÞÜ&ØØ*ð1ð .òð -;�O‰O˜LÑ)Ü#ˆIØ×!Ñ! )§.¡.Ô1ä-¨i¯n©nÀVÑLˆMØ!.×!>Ñ!>¸|Ó!LÐØ×$Ñ$×(Ñ(¨×)BÑ)BÀGÔLØ×$Ñ$ °y·~±~Ð6FÐ%GÔHØ×+Ñ+¨I¯N©NÔ;Ø -× =Ñ =Ø—‘Ø$¨¯©Ð(9¸Ð&;Ð<ð !>ð !Ðô Ø)Ø )òô #%§'¡'§,¡,Ø×$Ñ$Ø×%Ñ%Ð&Ø×*Ñ*Ð+ó#Ðð
 ×'Ñ'Ð(;¿^¹^×Lñ/ $ö0 Ø×-Ñ-¨g°|ÕDð r%   c                 ó2  • UR                  S5      nU R                  R                  R                  R                  nU(       aU  [        U R                  U R                  5      nU R                  Ul        UR                  U5        U R                  US5        g g )NÚactions)
r7   rƒ   r„   r…   r´   r   r   rm   Údocument_actionsrq   )r   r2   r´   Ú
documenters       r#   r-   ÚResourceDocumenter._add_actions  su   € Ø×)Ñ)¨)Ó4ˆØ—.‘.×%Ñ%×4Ñ4×<Ñ<ˆÞÜ)¨$¯.©.¸$×:NÑ:NÓOˆJØ$(§O¡OˆJÔ!Ø×'Ñ'¨Ô0Ø×-Ñ-¨g°yÕAð	 r%   c                 ó2  • UR                  S5      nU R                  R                  R                  R                  nU(       aU  [        U R                  U R                  5      nU R                  Ul        UR                  U5        U R                  US5        g g )Nzsub-resources)
r7   rƒ   r„   r…   Úsubresourcesr   r   rm   Údocument_sub_resourcesrq   )r   r2   Úsub_resourcesr¶   s       r#   r.   Ú%ResourceDocumenter._add_sub_resources  sz   € Ø×)Ñ)¨/Ó:ˆØŸ™×+Ñ+×:Ñ:×GÑGˆÞÜ.Ø—‘ × 4Ñ 4óˆJð %)§O¡OˆJÔ!Ø×-Ñ-¨gÔ6Ø×-Ñ-¨g°ÕGð r%   c                 ó2  • UR                  S5      nU R                  R                  R                  R                  nU(       aU  [        U R                  U R                  5      nU R                  Ul        UR                  U5        U R                  US5        g g )NÚcollections)
r7   rƒ   r„   r…   r¾   r   r   rm   Údocument_collectionsrq   )r   r2   r¾   r¶   s       r#   r/   Ú#ResourceDocumenter._add_collections(  sz   € Ø×)Ñ)¨-Ó8ˆØ—n‘n×)Ñ)×8Ñ8×DÑDˆÞÜ-Ø—‘ × 4Ñ 4óˆJð %)§O¡OˆJÔ!Ø×+Ñ+¨GÔ4Ø×-Ñ-¨g°}ÕEð r%   c                 ó|  • UR                  S5      nU R                  R                  R                  R                  nU(       az  U R
                  R                  U R                  5      n[        U R                  X0R                  5      nU R                  Ul
        UR                  U5        U R                  US5        g g )NÚwaiters)r7   rƒ   r„   r…   rÂ   r   Úget_waiter_modelr   r   r   rm   Údocument_resource_waitersrq   )r   r2   rÂ   Úservice_waiter_modelr¶   s        r#   r0   ÚResourceDocumenter._add_waiters3  s�   € Ø×)Ñ)¨)Ó4ˆØ—.‘.×%Ñ%×4Ñ4×<Ñ<ˆÞØ#'×#9Ñ#9×#JÑ#JØ×"Ñ"ó$Ð ô 2Ø—‘Ð 4×6JÑ6JóˆJð %)§O¡OˆJÔ!Ø×0Ñ0°Ô9Ø×-Ñ-¨g°yÕAð r%   c                 ó°   • UR                  S5      nUR                  R                  5         UR                  S5        UR                  R	                  5         g )Nzfeature-freezez¢Before using anything on this page, please refer to the resources :doc:`user guide <../../../../guide/resources>` for the most recent guidance on using resources.)r7   r8   Ú
start_noterY   Úend_noter1   s     r#   r(   Ú%ResourceDocumenter._add_resource_noteA  sF   € Ø×)Ñ)Ð*:Ó;ˆØ�‰× Ñ Ô"Ø�‰ð+ô	
ð
 	�‰×ÑÕ r%   )r   r   r   )Ú__name__Ú
__module__Ú__qualname__Ú__firstlineno__r   r3   r'   r)   rK   rL   rM   rq   r*   r+   r,   r-   r.   r/   r0   r(   Ú__static_attributes__Ú__classcell__)r"   s   @r#   r   r   %   sb   ø† õ9ò
#ò4ò.ò:
ò&ò %ò/ò*FòX7Eòr(EòTBò	Hò	FòB÷!ð !r%   r   c                   ó6   • \ rS rSr\S 5       rS rS rS rSr	g)ÚServiceResourceDocumenteriL  c                 ó    • U R                    S3$ )Nz.ServiceResource)Ú_service_docs_name)r   s    r#   rA   Ú$ServiceResourceDocumenter.class_nameM  s   € à×)Ñ)Ð*Ð*:Ð;Ð;r%   c                 ó\   • UR                  S5      nUR                  R                  S5        g )Nr6   zService Resource)r7   r8   r9   r:   s      r#   r'   Ú$ServiceResourceDocumenter._add_titleQ  s'   € Ø×/Ñ/°Ó8ˆØ×Ñ×ÑÐ1Õ2r%   c                 óV   • [        U R                  5      nUR                  SU 35        g )NzA resource representing )r   rX   rY   rZ   s      r#   rK   Ú*ServiceResourceDocumenter._add_descriptionU  s)   € Ü 9¸$×:MÑ:MÓ NÐØ�‰Ð0Ð1FÐ0GÐHÕIr%   c                 ó€  • UR                   R                  5         UR                   R                  5         UR                  S5        UR                   R                  5         UR                   R                  5         UR                  U R                   SU R                   S35        UR                   R                  5         g )Nr^   r_   r`   )r8   rb   rc   rY   r   rd   )r   r2   rO   s      r#   rL   Ú&ServiceResourceDocumenter._add_exampleY  s‹   € Ø�‰×%Ñ%Ô'Ø�‰×ÑÔ Ø�‰�nÔ%Ø�‰×ÑÔ Ø�‰×ÑÔ Ø�‰Ø×!Ñ!Ð"Ð"6°t×7IÑ7IÐ6JÈ#ÐNô	
ð 	�‰×#Ñ#Õ%r%   © N)
rË   rÌ   rÍ   rÎ   ÚpropertyrA   r'   rK   rL   rÏ   rÜ   r%   r#   rÒ   rÒ   L  s$   † Øñ<ó ð<ò3òJõ	&r%   rÒ   )r‰   Úbotocorer   Úbotocore.docs.bcdoc.restdocr   Úbotocore.docs.utilsr   Úboto3.docs.actionr   Úboto3.docs.attrr   r   r	   Úboto3.docs.baser
   Úboto3.docs.collectionr   Úboto3.docs.subresourcer   Úboto3.docs.utilsr   r   r   r   Úboto3.docs.waiterr   r   rÒ   rÜ   r%   r#   Ú<module>rè      sV   ðó 
å Ý 9Ý 9å .÷ñ õ
 +Ý 6Ý 8÷ó õ 7ôd!˜ô d!ôN	&Ð 2õ &r%   