+
     Ii;  c                   s    ^ RI t ^ RIHt ^ RIHt ^ RIHt ^ RIHt ^ RI	H
t
HtHt ^ RIHt ^ RIHt ^ R	IHt ^ R
IHtHtHtHt ^ RIHt  ! R R]4      t ! R R]4      tR# )i    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                   s   a a ] tR t^%t oV 3R ltR tR tR tR tR t	R t
R tR	 tR
 tR tR tR tR tR tR tRtVtV ;t# )ResourceDocumenterc                s   < \         SV `  V4       W n        W0n        V P                  P                  4       V n        V P                  V P                  8X  d
   R V n        R# R# )zservice-resourceN)Zsuper__init___botocore_session_root_docs_path_resource_nameZlower_resource_sub_path_service_name)selfZresourceZbotocore_sessionZroot_docs_path	__class__s   &&&&8/usr/lib/python3.14/site-packages/boto3/docs/resource.pyr   ZResourceDocumenter.__init__&   sT    "!1-"&"5"5";";"=$"4"44&8D# 5    c                sZ   V P                  V4       V P                  V4       V P                  V4       V P                  V4       V P	                  V4       V P                  V4       V P                  V4       V P                  V4       V P                  V4       V P                  V4       R # )N)

_add_title_add_resource_note
_add_intro_add_identifiers_add_attributes_add_references_add_actions_add_sub_resources_add_collections_add_waitersr   section   &&r   document_resourceZ$ResourceDocumenter.document_resource.   s     ( g&W%W%'"(g&'"r   c                sr    VP                  R 4      pVP                  P                  V P                  4       R# )titleN)add_new_sectionstyleh2r   r   r%   Ztitle_section   && r   r   ZResourceDocumenter._add_title:   s,    //8t223r   c                sd   . pV P                   P                  '       d9   V P                   P                   F  pVP                  VP                  4       K   	  \	        V4      pVP                  R 4      pVP                  P                  V P                   RV R2R7       VP                  R4      pV P                  V4       VP                  R4      pV P                  Wr4       VP                  R4      pV P                  W4       VP                  R4      p	V	P                  P                  4        R# )	start_class())
class_namedescriptionZexampleZparams	end_classN)Z_resource_modelidentifiersappendnamer   r)   r*   Zstart_sphinx_py_classr1   _add_description_add_example_add_params_descriptionZend_sphinx_py_class)
r   r%   identifier_names
identifierZ
class_argsr.   Zdescription_sectionZexample_sectionZparam_sectionr3   s
   &&        r   r   ZResourceDocumenter._add_intro>   s   +++"22>>
 ''
8 ? 77GH
--m<////*!J<q9 	0 	

 *99-H12 &55i@/< $33H=$$]E++K8	++-r   c                sr    \        V P                  4      pVP                  R V RV P                   24       R# )zA resource representing an Z N)r   _service_modelwriter   r   r%   Zofficial_service_namer-   r   r7   Z#ResourceDocumenter._add_description[   s8     9$:M:M N)*?)@$BUBUAVW	
r   c           
     sT   VP                   P                  4        VP                   P                  4        VP                  R 4       VP                   P                  4        VP                   P                  4        VP                  V P                   RV P                   R24       VP                   P                  4        \        V4      pVP                  \        V P                  4       RV P                   RV P                   RV R24       VP                   P                  4        R# )import boto3 = boto3.resource('')z = .r/   r0   N)	r*   start_codeblocknew_liner=   r   r   r    r   end_codeblock)r   r%   r:   Zexample_values   &&& r   r8   ZResourceDocumenter._add_examplea   s    %%' n%  !!""6t7I7I6J#N	
 	 :;KL$--./s43E3E2FaH[H[G\\]^l]mmno	
 	##%r   c                s   V Fy  p\        V P                  V4      pVP                  R V R24       VP                  P	                  4        VP                  RV RV 24       VP                  P	                  4        K{  	  R# )z:type z: stringz:param z: N)r   r   r=   r*   rD   )r   r%   r:   Zidentifier_namer2   s   &&&  r   r9   Z*ResourceDocumenter._add_params_descriptionq   ss    /O4##_K MMF?"38<=MM""$MMGO#4B{mDEMM""$  0r   c                s8   VP                   P                  4        VP                  R V R24       VP                   P                  4        VP                   P                  4        V P                  V,           F  pVP                   P                  V 4       K!  	  R# )z#These are the resource's available Z:N)r*   rD   r=   Ztoctree
member_mapZtocitem)r   r%   Zresource_member_typeZmemberrF   r   _add_overview_of_member_typeZ/ResourceDocumenter._add_overview_of_member_type{   sy     23G2HJ	
 	 oo&:;;FMM!!VH. <r   c                s   V P                   P                  P                  P                  pVP	                  R 4      p. pV'       d   W0P
                  R &   \        VRRRR7       V EFF  pVP                  VP                  4       \        VP                  RR7      pVP	                  R4      pVP                  P                  V P                  R4       VP                  R	VP                   24       VP                  VP                  4       VP	                  VP                  R
V P                   R2/R7      p\!        VV P"                  VR7       \$        P&                  P)                  V P*                  V P,                   V P.                   4      pVP1                  WP                  4       EKI  	  V'       d   V P3                  VR 4       R# R# )r4   ZIdentifierszYIdentifiers are properties of a resource that are set upon instantiation of the resource.identifiers_attributes_intror%   Zresource_typer2   Z
intro_linkhtmlZtarget
breadcrumbindexz / Identifier / 	qualifierrB   Zcontext)r%   resource_nameZidentifier_modelN)	_resourcemetaresource_modelr4   r)   rG   r
   r5   r6   r   r*   ref_resource_class_namer=   add_title_sectionr1   r   r   ospathjoinr   r   r   write_to_filerH   )	r   r%   r4   Zmember_listr;   Zidentifier_docbreadcrumb_sectionZidentifier_sectionZidentifiers_dir_path	   &&       r   r   Z#ResourceDocumenter._add_identifiers   s   nn))88DD))-8-8OOM*&+> : &Jz/.zvNN!/!?!?!M$$(()B)BGL$$'7
7H%IJ,,Z__=!/!?!?$(9&;< "@ "  *"11!+ $&77<<$$%%&**+$ 
 (()=O1 &4 --g}E r   c           
     s   V P                   P                  P                  P                  P                  p/ pV P                   P                  P                  P
                  '       di   VP                  V P                   P                  P                  P
                  4      pV P                   P                  P                  P                  V4      pVP                  R 4      p. pV'       d   \        VRRRR7       WPP                  R &   \        V4       EFS  pW6,          w  rxVP                  V4       \        VRR7      p	V	P                  R4      p
V
P                  P                  V P                   R4       V
P#                  R	V 24       V	P%                  V4       V	P                  VR
V P&                   R2/R7      p\)        VV P*                  V P,                  VV P                   P                  P                  P                  P.                  VR7       \0        P2                  P5                  V P6                  V P*                   V P8                   4      pV	P;                  W4       EKV  	  V'       d   V P=                  VR 4       R# R# )
attributesZ
AttributeszAttributes provide access to the properties of a resource. Attributes are lazy-loaded the first time one is accessed via the :py:meth:`load` method.rI   rJ   rK   rL   rM   rN   z / Attribute / rO   rB   rP   )r%   Zservice_namerQ   	attr_nameZevent_emitterZ
attr_modelN)rR   rS   Zclientservice_modelrT   shapeZ	shape_forZget_attributesr)   r
   rG   Zsortedr5   r   r*   rU   rV   r=   rW   r1   r   r   r   ZeventsrX   rY   rZ   r   r   r[   rH   )r   r%   r`   r^   ra   Zattribute_listr_   Z_Z
attr_shapeZattribute_docr\   Zattribute_sectionZattributes_dir_paths   &&           r   r   Z"ResourceDocumenter._add_attributes   s'   ++2277EE
>>--333!++##2288E ,,;;JJJ )),7&*/
 :
 -;OOL)
+I&1MA!!),-iGM!.!>!>|!L$$(()B)BGL$$yk%BC++I6 - = =$(9&;< !> ! )!//"11#"nn1188==DD% #%'',,$$%%&**+#
 ''(;G9 ,: --g|D r   c                s   VP                  R 4      pV P                  P                  P                  P                  p. pV'       d   \        VRRRR7       W0P                  R &   V EF;  pVP                  VP                  4       \        VP                  RR7      pVP                  R4      pVP                  P                  V P                  R4       VP                  R	VP                   24       VP                  VP                  4       VP                  VP                  R
V P                   R2/R7      p\!        VVR7       \"        P$                  P'                  V P(                  V P*                   V P,                   4      pVP/                  WP                  4       EK>  	  V'       d   V P1                  VR 4       R# R# )
referencesZ
ReferenceszNReferences are related resource instances that have a belongs-to relationship.Zreferences_introrJ   rK   rL   rM   rN   z / Reference / rO   rB   rP   )r%   Zreference_modelN)r)   rR   rS   rT   rb   r
   rG   r5   r6   r   r*   rU   rV   r=   rW   r1   r   rX   rY   rZ   r   r   r   r[   rH   )	r   r%   rb   Zreference_listZ	referenceZreference_docr\   Zreference_sectionZreferences_dir_pathr]   r   r   Z"ResourceDocumenter._add_references   s   )),7^^((77BB
&*1 . -;OOL)#I!!)..1-innVLM!.!>!>|!L$$(()B)BGL$$y~~6F%GH++INN; - = =$(9&;< !> ! ) ) #%'',,$$%%&**+#
 ''(;^^L/ $0 --g|D r   c                8   VP                  R 4      pV P                  P                  P                  P                  pV'       dW   \        V P                  V P                  4      pV P                  Vn        VP                  V4       V P                  VR 4       R# R# )actionsN)
r)   rR   rS   rT   rd   r   r   rG   Zdocument_actionsrH   )r   r%   rd   
documenter   &&  r   r    ZResourceDocumenter._add_actions  su    )))4..%%44<<)$..$:N:NOJ$(OOJ!''0--gyA	 r   c                rc   )zsub-resourcesN)
r)   rR   rS   rT   Zsubresourcesr	   r   rG   Zdocument_sub_resourcesrH   )r   r%   Zsub_resourcesre   rf   r   r!   Z%ResourceDocumenter._add_sub_resources  sz    ))/:++::GG. 4 4J %)OOJ!--g6--gG r   c                rc   )collectionsN)
r)   rR   rS   rT   rg   r   r   rG   Zdocument_collectionsrH   )r   r%   rg   re   rf   r   r"   Z#ResourceDocumenter._add_collections(  sz    ))-8nn))88DD- 4 4J %)OOJ!++G4--g}E r   c                s   VP                  R 4      pV P                  P                  P                  P                  pV'       d|   V P
                  P                  V P                  4      p\        V P                  W0P                  4      pV P                  Vn
        VP                  V4       V P                  VR 4       R# R# )waitersN)r)   rR   rS   rT   rh   r   Zget_waiter_modelr   r   r   rG   Zdocument_resource_waitersrH   )r   r%   rh   Zservice_waiter_modelre   s   &&   r   r#   ZResourceDocumenter._add_waiters3  s    )))4..%%44<<#'#9#9#J#J""$  2 46J6JJ %)OOJ!009--gyA r   c                s    VP                  R 4      pVP                  P                  4        VP                  R4       VP                  P	                  4        R# )zfeature-freezezBefore using anything on this page, please refer to the resources :doc:`user guide <../../../../guide/resources>` for the most recent guidance on using resources.N)r)   r*   Z
start_noter=   Zend_noter$   r&   r   r   Z%ResourceDocumenter._add_resource_noteA  sF    ))*:;  "+	

 	 r   )r   r   r   )__name__
__module____qualname____firstlineno__r   r'   r   r   r7   r8   r9   rH   r   r   r   r    r!   r"   r#   r   __static_attributes____classdictcell__Z__classcell__)r   __classdict__s   @@r   r   r   %   sd     9
#4.:
& %/*FX7Er(ETB	H	FB! !r   r   c                   sB   a  ] tR tRt o ]R 4       tR tR tR tRt	V t
R# )ServiceResourceDocumenteriL  c                s     V P                    R 2# )z.ServiceResource)Z_service_docs_name)r   s   &r   r1   Z$ServiceResourceDocumenter.class_nameM  s    ))**:;;r   c                s^    VP                  R 4      pVP                  P                  R4       R# )r(   zService ResourceN)r)   r*   r+   r,   r-   r   r   Z$ServiceResourceDocumenter._add_titleQ  s'    //812r   c                sX    \        V P                  4      pVP                  R V 24       R# )zA resource representing N)r   r<   r=   r>   r-   r   r7   Z*ServiceResourceDocumenter._add_descriptionU  s)     9$:M:M N01F0GHIr   c                s   VP                   P                  4        VP                   P                  4        VP                  R 4       VP                   P                  4        VP                   P                  4        VP                  V P                   RV P                   R24       VP                   P                  4        R# )r?   r@   rA   N)r*   rC   rD   r=   r   rE   )r   r%   r:   s   &&&r   r8   Z&ServiceResourceDocumenter._add_exampleY  s    %%' n%  !!""6t7I7I6J#N	
 	##%r    N)ri   rj   rk   rl   Zpropertyr1   r   r7   r8   rm   rn   )ro   s   @r   rp   rp   L  s,     < <3J	& 	&r   rp   )rX   Zbotocorer    Zbotocore.docs.bcdoc.restdocr   Zbotocore.docs.utilsr   Zboto3.docs.actionr   Zboto3.docs.attrr   r   r   Zboto3.docs.baser   Zboto3.docs.collectionr   Zboto3.docs.subresourcer	   Zboto3.docs.utilsr
   r   r   r   Zboto3.docs.waiterr   r   rp   rq   r   r   <module>rr      sV    
  9 9 . 
 + 6 8  7d! d!N	& 2 &r   