+
     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
 ^ RIHt ^ RIHtHt  ! R	 R
]
4      tRR ltRR ltRR ltR# )i    N)
xform_name)DocumentStructure)get_instance_public_methods)DocumentedShape)NestedDocumenter)%document_model_driven_resource_method)add_resource_type_overviewget_resource_ignore_paramsc                   s,   a  ] tR t^t o R tR tRtV tR# )CollectionDocumenterc                s$   V P                   P                  P                  P                  p. p\	        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 P!                  Wt4       \"        P$                  P'                  V P(                  V P*                   V P,                   4      pVP/                  WP                  4       EKB  	  R# )ZCollectionszUCollections provide an interface to iterate over and manipulate groups of resources. Zguide_collections)sectionZresource_typeZdescriptionZ
intro_linkcollectionsZhtml)ZtargetZ
breadcrumbZindexz / Collection / 	qualifier.)contextN)	_resourcemetaZresource_modelr
   r   Z
member_mapZappendnamer   add_new_sectionstyleZrefZ_resource_class_nameZwriteZadd_title_sectionZ
class_name_document_collectionosZpathZjoinZ_root_docs_pathZ_service_nameZ_resource_sub_pathZwrite_to_file)	selfr	   r
   Zcollections_list
collectionZcollection_docZbreadcrumb_sectionZcollection_sectionZcollections_dir_paths	   &&       :/usr/lib/python3.14/site-packages/boto3/docs/collection.pydocument_collectionsZ)CollectionDocumenter.document_collections   s]   nn))88DD"'3 +	
 *:&%J##JOO4.zvNN!/!?!?!M$$(()B)BGL$$'7
7H%IJ,,Z__=!/!?!?$(9&;< "@ " %%&8E $&77<<$$%%&**+$ 
 (()=O+ &    c           
     s   \        \        V P                  VP                  4      4      p\	        W4       / pVP
                   F  pWTVP                  &   K  	  \        V4       EF!  pVP                  V4      pWd9   d   \        VV P                  V P                  P                  P                  P                  P                  WF,          VV P                  P                  P                  P                  P                  R 7       K  \        VV P                  VV P                  P                  P                  P                  P                  VV P                  P                  P                  P                  P                  R7       EK$  	  R# ))r	   resource_nameevent_emitterbatch_action_modelcollection_modelservice_model)r	   r   action_namer   r   r   N)r   Zgetattrr   r   document_collection_objectbatch_actionsZsortedr   document_batch_actionZ_resource_namer   ZclientZeventsr   document_collection_method)r   r	   r   Zmethodsr!   Zbatch_actionZmethodZmethod_sections   &&&     r   r   Z)CollectionDocumenter._document_collectionA   s+   -DNNJOO4
 	#77&44L/;,++, 5 WoF$44V<N&%*"&"5"5"&.."5"5"<"<"A"A"H"H'4'<%/"&.."5"5"<"<"A"A"O"O +*"&"5"5 &"&.."5"5"<"<"A"A"H"H%/"&.."5"5"<"<"A"A"O"O  &r    N)Z__name__Z
__module__Z__qualname__Z__firstlineno__r   r   Z__static_attributes__Z__classdictcell__)Z__classdict__s   @r   r   r      s     "PH r   r   c                sD   V'       dF   V P                   P                  RR4       VP                   2pV P                  P	                  V4       V P                  RVP                  P                   R24       V P                  RVP                  P                   R24       R# )zDocuments a collection resource object

:param section: The section to write to

:param collection_model: The model of the collection

:param include_signature: Whether or not to include the signature.
    It is useful for generating docstrings.
r   Z zA collection of z resources.zA z Collection will include all resources by default, and extreme caution should be taken when performing actions on all resources.N)r   Zgetr   r   Zstart_sphinx_py_attrZinclude_doc_stringresourcetype)r	   r   include_signatureZfull_collection_names   &&& r   r    r    `   s     "";345E5J5J4KL 	 	**+?@
+4499:+F 
&&++, -/ 	0r   c                s   VP                  VP                  P                  4      p\        VP                  P                  4      pRp	VP
                  '       d    \        VP
                  P                  4      p	\        V4      p
VP                  V8X  d   Tp
V	 RV
 RVP                   RVP                   2p\        V VP                  VVVP                  VVVVR7	       R# )a=  Documents a collection's batch action

:param section: The section to write to

:param resource_name: The name of the resource

:param action_name: The name of collection action. Currently only
    can be all, filter, limit, or page_size

:param event_emitter: The event emitter to use to emit events

:param batch_action_model: The model of the batch action

:param collection_model: The model of the collection

:param service_model: The model of the service

:param include_signature: Whether or not to include the signature.
    It is useful for generating docstrings.
Zresponsez = r   )	r	   method_nameoperation_modelr   method_descriptionexample_prefixexclude_inputresource_action_modelr'   N)r)   request	operationr   paramsr%   r    r&   service_namer   r   documentation)r	   r   r   r   r   r   r'   r)   Zignore_paramsZexample_return_valueexample_resource_namer+      &&&&&&&     r   r"   r"   }   s    : $33"",,O /""))M &""")*<*E*E*J*JK&}5!!]2 -,-S1F0GqIYI^I^H__`asaxax`yzN)&++'#*88%#0+
r   c                sV   VP                  VP                  P                  4      p. pVP                  '       d   VP                  P                  p\        V4      p	VP                  V8X  d   Tp	RRRVP                  P                   R2R\        VP                  P                  4       RV	 RVP                   R2R	V/R
RRVP                  P                   RVP                  P                   R2R\        VP                  P                  4       RV	 RVP                   R2R	\        VP                  P                  4      /RRRVP                  P                   R2R\        VP                  P                  4       RV	 RVP                   R2R\        RRRR7      .R	V/RRRVP                  P                   R2R\        VP                  P                  4       RV	 RVP                   R2R\        RRRR7      .R	V//p
W*9   d"   W,          p\        R!RV RVRVRVRVRV/VB  R # R # )"a  Documents a collection method

:param section: The section to write to

:param resource_name: The name of the resource

:param action_name: The name of collection action. Currently only
    can be all, filter, limit, or page_size

:param event_emitter: The event emitter to use to emit events

:param collection_model: The model of the collection

:param service_model: The model of the service

:param include_signature: Whether or not to include the signature.
    It is useful for generating docstrings.
Zallr*   zCreates an iterable of all z resources in the collection.r+   z_iterator = r   z.allr,   ZfilterzD resources in the collection filtered by kwargs passed to method. A z collection will include all resources by default if no filters are provided, and extreme caution should be taken when performing actions on all resources.z.filterZlimitz0Creates an iterable up to a specified amount of z.limitZinclude_inputZcountZintegerz5The limit to the number of resources in the iterable.)r   Z	type_namer2   Z	page_sizezs resources in the collection, but limits the number of items returned by each service call by the specified amount.z
.page_sizez1The number of items returned by each service callr	   r(   r)   r   r-   r'   Nr$   )r)   r.   r/   Zinput_shapeZmembersr    r1   r%   r&   r   r   r0   r   r   )r	   r   r   r   r   r   r'   r)   Zunderlying_operation_membersr3   Zcustom_action_info_dictZaction_infor4   r   r#   r#      s>   6 $33  **O $& """'6'B'B'J'J$&}5!!]2 - 	 -.>.G.G.L.L-M N/ 0 ,<,E,E,J,J!K LLYnXoop  rB  rG  rG  qH  HL  M9
 	 -.>.G.G.L.L-M N-66;;< =$% ,<,E,E,J,J!K LLYnXoop  rB  rG  rG  qH  HO  P7 ((//
 	 B#,,1122OQ ,<,E,E,J,J!K LLYnXoop  rB  rG  rG  qH  HN  O 'O	 9
" 	 -.>.G.G.L.L-M NO P ,<,E,E,J,J!K LLYnXoop  rB  rG  rG  qH  HR  S 'K	 9!
Q:v --:- 	
	
#	
 ,	
 (		

 #3	
 0	
 	
 .r   )T)r   Zbotocorer    Zbotocore.docs.bcdoc.restdocr   Zbotocore.docs.methodr   Zbotocore.docs.utilsr   Zboto3.docs.baser   Zboto3.docs.methodr   Zboto3.docs.utilsr   r   r   r    r"   r#   r$   r   r   <module>r5      sB    
  9 < / , CA+ AH:6rl
r   