Ë
    £ªði;  ã                   óÄ   — 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 d d
lmZmZmZmZ d dlmZ  G d„ de«      Z G d„ de«      Zy)é    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                   óx   ‡ — e Zd Zˆ f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„ Zˆ xZS )ÚResourceDocumenterc                 óÀ   •— t         ‰| �  |«       || _        || _        | j                  j                  «       | _        | j                  | j                  k(  rd| _        y y )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       €új/var/www/acinvestment.org/public_html/aci/backend/venv/lib/python3.12/site-packages/boto3/docs/resource.pyr   zResourceDocumenter.__init__&   sX   ø€ Ü‰Ñ˜Ô"Ø!1ˆÔØ-ˆÔØ"&×"5Ñ"5×";Ñ";Ó"=ˆÔØ×Ñ $×"4Ñ"4Ò4Ø&8ˆDÕ#ð 5ó    c                 óX  — | j                  |«       | j                  |«       | j                  |«       | j                  |«       | j	                  |«       | j                  |«       | j                  |«       | j                  |«       | j                  |«       | j                  |«       y )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_resourcez$ResourceDocumenter.document_resource.   sŠ   € Ø�‰˜Ô Ø×Ñ Ô(Ø�‰˜Ô Ø×Ñ˜gÔ&Ø×Ñ˜WÔ%Ø×Ñ˜WÔ%Ø×Ñ˜'Ô"Ø×Ñ Ô(Ø×Ñ˜gÔ&Ø×Ñ˜'Õ"r#   c                 óp   — |j                  d«      }|j                  j                  | j                  «       y )NÚtitle)Úadd_new_sectionÚstyleÚh2r   ©r   r0   Útitle_sections      r"   r%   zResourceDocumenter._add_title:   s,   € Ø×/Ñ/°Ó8ˆØ×Ñ×Ñ˜t×2Ñ2Õ3r#   c                 óV  — g }| j                   j                  r6| j                   j                  D ]  }|j                  |j                  «       Œ t	        |«      }|j                  d«      }|j                  j                  | j                  › d|› d�¬«       |j                  d«      }| j                  |«       |j                  d«      }| j                  ||«       |j                  d«      }| j                  ||«       |j                  d«      }	|	j                  j                  «        y )	NÚstart_classú(ú))Ú
class_nameÚdescriptionÚexampleÚparamsÚ	end_class)Ú_resource_modelÚidentifiersÚappendÚnamer   r4   r5   Ústart_sphinx_py_classr=   Ú_add_descriptionÚ_add_exampleÚ_add_params_descriptionÚend_sphinx_py_class)
r   r0   Úidentifier_namesÚ
identifierÚ
class_argsr:   Údescription_sectionÚexample_sectionÚparam_sectionrA   s
             r"   r'   zResourceDocumenter._add_intro>   s  € ØÐØ×Ñ×+Ò+Ø"×2Ñ2×>Ñ>ò 9�
Ø ×'Ñ'¨
¯©Õ8ð9ô 7Ð7GÓHˆ
Ø×-Ñ-¨mÓ<ˆØ×Ñ×/Ñ/ØŸ/™/Ð*¨!¨J¨<°qÐ9ð 	0ô 	
ð
 *×9Ñ9¸-ÓHÐØ×ÑÐ1Ô2ð &×5Ñ5°iÓ@ˆØ×Ñ˜/Ð+;Ô<ð $×3Ñ3°HÓ=ˆØ×$Ñ$ ]Ð4DÔEà×+Ñ+¨KÓ8ˆ	Ø�‰×+Ñ+Õ-r#   c                 óp   — t        | j                  «      }|j                  d|› d| j                  › �«       y )NzA resource representing an ú )r   Ú_service_modelÚwriter   ©r   r0   Úofficial_service_names      r"   rG   z#ResourceDocumenter._add_description[   s8   € Ü 9¸$×:MÑ:MÓ NÐØ�‰Ø)Ð*?Ð)@ÀÀ$×BUÑBUÐAVÐWõ	
r#   c           
      óR  — |j                   j                  «        |j                   j                  «        |j                  d«       |j                   j                  «        |j                   j                  «        |j                  | j                  › d| j                  › d�«       |j                   j                  «        t        |«      }|j                  t        | j                  «      › d| j                  › d| j                  › d|› d�«       |j                   j                  «        y )Núimport boto3ú = boto3.resource('ú')z = ú.r;   r<   )	r5   Ústart_codeblockÚnew_linerT   r   r   r   r   Úend_codeblock)r   r0   rK   Úexample_valuess       r"   rH   z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                 óþ   — |D ]x  }t        | j                  |«      }|j                  d|› d�«       |j                  j	                  «        |j                  d|› d|› �«       |j                  j	                  «        Œz y )Nz:type z: stringz:param z: )r   r   rT   r5   r]   )r   r0   rK   Úidentifier_namer>   s        r"   rI   z*ResourceDocumenter._add_params_descriptionq   sx   € Ø/ò 	%ˆOÜ4Ø×#Ñ# _óˆKð �M‰M˜F ?Ð"3°8Ð<Ô=Ø�M‰M×"Ñ"Ô$Ø�M‰M˜G OÐ#4°B°{°mÐDÔEØ�M‰M×"Ñ"Õ$ñ	%r#   c                 ó*  — |j                   j                  «        |j                  d|› d�«       |j                   j                  «        |j                   j                  «        | j                  |   D ]  }|j                   j                  |› «       Œ  y )Nz#These are the resource's available ú:)r5   r]   rT   ÚtoctreeÚ
member_mapÚtocitem)r   r0   Úresource_member_typeÚmembers       r"   Ú_add_overview_of_member_typez/ResourceDocumenter._add_overview_of_member_type{   s{   € Ø�‰×ÑÔ Ø�‰Ø2Ð3GÐ2HÈÐJô	
ð 	�‰×ÑÔ Ø�‰×ÑÔØ—o‘oÐ&:Ñ;ò 	/ˆFØ�M‰M×!Ñ! V HÕ.ñ	/r#   c                 ó€  — | j                   j                  j                  j                  }|j	                  d«      }g }|r|| j
                  d<   t        |ddd¬«       |D �]F  }|j                  |j                  «       t        |j                  d¬«      }|j	                  d«      }|j                  j                  | j                  d	«       |j                  d
|j                  › �«       |j                  |j                  «       |j	                  |j                  d| j                  › d�i¬«      }t!        || j"                  |¬«       t$        j&                  j)                  | j*                  | j,                  › | j.                  › «      }|j1                  ||j                  «       �ŒI |r| j3                  |d«       y y )NrC   ÚIdentifierszYIdentifiers are properties of a resource that are set upon instantiation of the resource.Úidentifiers_attributes_intro©r0   Úresource_typer>   Ú
intro_linkÚhtml©ÚtargetÚ
breadcrumbÚindexz / Identifier / Ú	qualifierr[   ©Úcontext)r0   Úresource_nameÚidentifier_model)Ú	_resourceÚmetaÚresource_modelrC   r4   re   r   rD   rE   r   r5   ÚrefÚ_resource_class_namerT   Úadd_title_sectionr=   r   r   ÚosÚpathÚjoinr   r   r   Úwrite_to_fileri   )	r   r0   rC   Úmember_listrL   Úidentifier_docÚbreadcrumb_sectionÚidentifier_sectionÚidentifiers_dir_paths	            r"   r(   z#ResourceDocumenter._add_identifiers…   sœ  € Ø—n‘n×)Ñ)×8Ñ8×DÑDˆØ×)Ñ)¨-Ó8ˆØˆÙØ-8ˆD�O‰O˜MÑ*Ü&ØØ+ð>ð :õð &ó 	PˆJØ×Ñ˜zŸ™Ô/ä.¨z¯©ÀvÔNˆNØ!/×!?Ñ!?ÀÓ!MÐØ×$Ñ$×(Ñ(¨×)BÑ)BÀGÔLØ×$Ñ$Ð'7¸
¿¹Ð7HÐ%IÔJØ×,Ñ,¨Z¯_©_Ô=Ø!/×!?Ñ!?Ø—‘Ø$¨¯©Ð(9¸Ð&;Ð<ð "@ó "Ðô  Ø*Ø"×1Ñ1Ø!+õô $&§7¡7§<¡<Ø×$Ñ$Ø×%Ñ%Ð&Ø×*Ñ*Ð+ó$Ð ð
 ×(Ñ(Ð)=¸z¿¹ÖOð1	Pñ4 Ø×-Ñ-¨g°}ÕEð r#   c           	      óä  — | j                   j                  j                  j                  j                  }i }| j                   j                  j                  j
                  rh|j                  | j                   j                  j                  j
                  «      }| j                   j                  j                  j                  |«      }|j                  d«      }g }|rt        |ddd¬«       || j                  d<   t        |«      D �]Q  }||   \  }}|j                  |«       t        |d¬«      }	|	j                  d«      }
|
j                  j                  | j                   d	«       |
j#                  d
|› �«       |	j%                  |«       |	j                  |d| j&                  › d�i¬«      }t)        || j*                  | j,                  || j                   j                  j                  j                  j.                  |¬«       t0        j2                  j5                  | j6                  | j*                  › | j8                  › «      }|	j;                  ||«       �ŒT |r| j=                  |d«       y y )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.rl   rm   rp   rq   rs   rt   z / Attribute / ru   r[   rv   )r0   Úservice_namerx   Ú	attr_nameÚevent_emitterÚ
attr_model)rz   r{   ÚclientÚservice_modelr|   ÚshapeÚ	shape_forÚget_attributesr4   r   re   ÚsortedrD   r   r5   r}   r~   rT   r   r=   r   r   r   Úeventsr€   r�   r‚   r   r   rƒ   ri   )r   r0   r‘   rŠ   r’   Úattribute_listr�   Ú_Ú
attr_shapeÚattribute_docr†   Úattribute_sectionÚattributes_dir_paths                r"   r)   z"ResourceDocumenter._add_attributes±   s3  € ØŸ™×+Ñ+×2Ñ2×7Ñ7×EÑEˆØˆ
Ø�>‰>×Ñ×-Ñ-×3Ò3Ø!×+Ñ+Ø—‘×#Ñ#×2Ñ2×8Ñ8óˆEð Ÿ™×,Ñ,×;Ñ;×JÑJØóˆJð ×)Ñ)¨,Ó7ˆØˆÙÜ&ØØ*ð/ð
 :õ
ð -;ˆD�O‰O˜LÑ)Ü 
Ó+ó 	HˆIØ& yÑ1‰MˆAˆzØ×!Ñ! )Ô,ä-¨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Ø%õô #%§'¡'§,¡,Ø×$Ñ$Ø×%Ñ%Ð&Ø×*Ñ*Ð+ó#Ðð
 ×'Ñ'Ð(;¸YÖGð9	Hñ: Ø×-Ñ-¨g°|ÕDð r#   c                 ój  — |j                  d«      }| j                  j                  j                  j                  }g }|rt        |ddd¬«       || j                  d<   |D �];  }|j                  |j                  «       t        |j                  d¬«      }|j                  d«      }|j                  j                  | j                  d	«       |j                  d
|j                  › �«       |j                  |j                  «       |j                  |j                  d| j                  › d�i¬«      }t!        ||¬«       t"        j$                  j'                  | j(                  | j*                  › | j,                  › «      }|j/                  ||j                  «       �Œ> |r| j1                  |d«       y y )NÚ
referencesÚ
ReferenceszNReferences are related resource instances that have a belongs-to relationship.Úreferences_introrm   rp   rq   rs   rt   z / Reference / ru   r[   rv   )r0   Úreference_model)r4   rz   r{   r|   rž   r   re   rD   rE   r   r5   r}   r~   rT   r   r=   r	   r€   r�   r‚   r   r   r   rƒ   ri   )	r   r0   rž   Úreference_listÚ	referenceÚreference_docr†   Úreference_sectionÚreferences_dir_paths	            r"   r*   z"ResourceDocumenter._add_referencesê   s‘  € Ø×)Ñ)¨,Ó7ˆØ—^‘^×(Ñ(×7Ñ7×BÑBˆ
ØˆÙÜ&ØØ*ð1ð .õð -;ˆD�O‰O˜LÑ)Ø#ó 	MˆIØ×!Ñ! )§.¡.Ô1ä-¨i¯n©nÀVÔLˆMØ!.×!>Ñ!>¸|Ó!LÐØ×$Ñ$×(Ñ(¨×)BÑ)BÀGÔLØ×$Ñ$ °y·~±~Ð6FÐ%GÔHØ×+Ñ+¨I¯N©NÔ;Ø -× =Ñ =Ø—‘Ø$¨¯©Ð(9¸Ð&;Ð<ð !>ó !Ðô Ø)Ø )õô #%§'¡'§,¡,Ø×$Ñ$Ø×%Ñ%Ð&Ø×*Ñ*Ð+ó#Ðð
 ×'Ñ'Ð(;¸Y¿^¹^ÖLð/	Mñ0 Ø×-Ñ-¨g°|ÕDð r#   c                 ó(  — |j                  d«      }| j                  j                  j                  j                  }|rUt        | j                  | j                  «      }| j                  |_        |j                  |«       | j                  |d«       y y )NÚactions)
r4   rz   r{   r|   r¨   r   r   re   Údocument_actionsri   )r   r0   r¨   Ú
documenters       r"   r+   zResourceDocumenter._add_actions  su   € Ø×)Ñ)¨)Ó4ˆØ—.‘.×%Ñ%×4Ñ4×<Ñ<ˆÙÜ)¨$¯.©.¸$×:NÑ:NÓOˆJØ$(§O¡OˆJÔ!Ø×'Ñ'¨Ô0Ø×-Ñ-¨g°yÕAð	 r#   c                 ó(  — |j                  d«      }| j                  j                  j                  j                  }|rUt        | j                  | j                  «      }| j                  |_        |j                  |«       | j                  |d«       y y )Nzsub-resources)
r4   rz   r{   r|   Úsubresourcesr   r   re   Údocument_sub_resourcesri   )r   r0   Úsub_resourcesrª   s       r"   r,   z%ResourceDocumenter._add_sub_resources  sz   € Ø×)Ñ)¨/Ó:ˆØŸ™×+Ñ+×:Ñ:×GÑGˆÙÜ.Ø—‘ × 4Ñ 4óˆJð %)§O¡OˆJÔ!Ø×-Ñ-¨gÔ6Ø×-Ñ-¨g°ÕGð r#   c                 ó(  — |j                  d«      }| j                  j                  j                  j                  }|rUt        | j                  | j                  «      }| j                  |_        |j                  |«       | j                  |d«       y y )NÚcollections)
r4   rz   r{   r|   r°   r   r   re   Údocument_collectionsri   )r   r0   r°   rª   s       r"   r-   z#ResourceDocumenter._add_collections(  sz   € Ø×)Ñ)¨-Ó8ˆØ—n‘n×)Ñ)×8Ñ8×DÑDˆÙÜ-Ø—‘ × 4Ñ 4óˆJð %)§O¡OˆJÔ!Ø×+Ñ+¨GÔ4Ø×-Ñ-¨g°}ÕEð r#   c                 ót  — |j                  d«      }| j                  j                  j                  j                  }|r{| j
                  j                  | j                  «      }t        | j                  || j                  «      }| j                  |_
        |j                  |«       | j                  |d«       y y )NÚwaiters)r4   rz   r{   r|   r³   r   Úget_waiter_modelr   r   r   re   Údocument_resource_waitersri   )r   r0   r³   Úservice_waiter_modelrª   s        r"   r.   zResourceDocumenter._add_waiters3  sŸ   € Ø×)Ñ)¨)Ó4ˆØ—.‘.×%Ñ%×4Ñ4×<Ñ<ˆÙØ#'×#9Ñ#9×#JÑ#JØ×"Ñ"ó$Ð ô 2Ø—‘Ð 4°d×6JÑ6JóˆJð %)§O¡OˆJÔ!Ø×0Ñ0°Ô9Ø×-Ñ-¨g°yÕAð r#   c                 ó°   — |j                  d«      }|j                  j                  «        |j                  d«       |j                  j	                  «        y )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.)r4   r5   Ú
start_noterT   Úend_noter/   s     r"   r&   z%ResourceDocumenter._add_resource_noteA  sF   € Ø×)Ñ)Ð*:Ó;ˆØ�‰× Ñ Ô"Ø�‰ð+ô	
ð
 	�‰×ÑÕ r#   )Ú__name__Ú
__module__Ú__qualname__r   r1   r%   r'   rG   rH   rI   ri   r(   r)   r*   r+   r,   r-   r.   r&   Ú__classcell__)r!   s   @r"   r   r   %   s]   ø„ ô9ò
#ò4ò.ò:
ò&ò %ò/ò*FòX7Eòr(EòTBò	Hò	FòBö!r#   r   c                   ó.   — e Zd Zed„ «       Zd„ Zd„ Zd„ Zy)ÚServiceResourceDocumenterc                 ó    — | j                   › d�S )Nz.ServiceResource)Ú_service_docs_name)r   s    r"   r=   z$ServiceResourceDocumenter.class_nameM  s   € à×)Ñ)Ð*Ð*:Ð;Ð;r#   c                 ó\   — |j                  d«      }|j                  j                  d«       y )Nr3   zService Resource)r4   r5   r6   r7   s      r"   r%   z$ServiceResourceDocumenter._add_titleQ  s'   € Ø×/Ñ/°Ó8ˆØ×Ñ×ÑÐ1Õ2r#   c                 óV   — t        | j                  «      }|j                  d|› �«       y )NzA resource representing )r   rS   rT   rU   s      r"   rG   z*ServiceResourceDocumenter._add_descriptionU  s)   € Ü 9¸$×:MÑ:MÓ NÐØ�‰Ð0Ð1FÐ0GÐHÕIr#   c                 ó€  — |j                   j                  «        |j                   j                  «        |j                  d«       |j                   j                  «        |j                   j                  «        |j                  | j                  › d| j                  › d�«       |j                   j                  «        y )NrX   rY   rZ   )r5   r\   r]   rT   r   r^   )r   r0   rK   s      r"   rH   z&ServiceResourceDocumenter._add_exampleY  s‹   € Ø�‰×%Ñ%Ô'Ø�‰×ÑÔ Ø�‰�nÔ%Ø�‰×ÑÔ Ø�‰×ÑÔ Ø�‰Ø×!Ñ!Ð"Ð"6°t×7IÑ7IÐ6JÈ#ÐNô	
ð 	�‰×#Ñ#Õ%r#   N)rº   r»   r¼   Úpropertyr=   r%   rG   rH   © 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#   