Ë
    æ÷ÔeŸ-  ã                   ó˜   — 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
 d dlmZ d dlmZmZ  G d	„ d
e
«      Z	 dd„Z	 dd„Z	 dd„Zy)é    N)Ú
xform_name)ÚDocumentStructure)Úget_instance_public_methods)ÚDocumentedShape)ÚNestedDocumenter)Ú%document_model_driven_resource_method)Úadd_resource_type_overviewÚget_resource_ignore_paramsc                   ó   — e Zd Zd„ Zd„ Zy)ÚCollectionDocumenterc                 ó$  — | j                   j                  j                  j                  }g }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¬«      }| j!                  ||«       t"        j$                  j'                  | j(                  | j*                  › | j,                  › «      }|j/                  ||j                  «       �ŒC y )NÚCollectionszUCollections provide an interface to iterate over and manipulate groups of resources. Úguide_collections)ÚsectionÚresource_typeÚdescriptionÚ
intro_linkÚcollectionsÚhtml)ÚtargetÚ
breadcrumbÚindexz / Collection / Ú	qualifierú.)Úcontext)Ú	_resourceÚmetaÚresource_modelr   r	   Ú
member_mapÚappendÚnamer   Úadd_new_sectionÚstyleÚrefÚ_resource_class_nameÚwriteÚadd_title_sectionÚ
class_nameÚ_document_collectionÚosÚpathÚjoinÚ_root_docs_pathÚ_service_nameÚ_resource_sub_pathÚwrite_to_file)	Úselfr   r   Úcollections_listÚ
collectionÚcollection_docÚbreadcrumb_sectionÚcollection_sectionÚcollections_dir_paths	            ú7/usr/lib/python3/dist-packages/boto3/docs/collection.pyÚdocument_collectionsz)CollectionDocumenter.document_collections   sj  € Ø—n‘n×)Ñ)×8Ñ8×DÑDˆØÐÜ"ØØ'ð3ð +õ	
ð *:ˆ�‰˜Ñ&Ø%ó 	PˆJØ×#Ñ# J§O¡OÔ4ä.¨z¯©ÀvÔNˆNØ!/×!?Ñ!?ÀÓ!MÐØ×$Ñ$×(Ñ(¨×)BÑ)BÀGÔLØ×$Ñ$Ð'7¸
¿¹Ð7HÐ%IÔJØ×,Ñ,¨Z¯_©_Ô=Ø!/×!?Ñ!?Ø—‘Ø$¨¯©Ð(9¸Ð&;Ð<ð "@ó "Ðð ×%Ñ%Ð&8¸*ÔEô $&§7¡7§<¡<Ø×$Ñ$Ø×%Ñ%Ð&Ø×*Ñ*Ð+ó$Ð ð
 ×(Ñ(Ð)=¸z¿¹ÖOñ+	Pó    c           	      ó  — t        t        | j                  |j                  «      «      }t	        ||«       i }|j
                  D ]  }|||j                  <   Œ t        |«      D �]  }|j                  |«      }||v rƒt        || j                  | j                  j                  j                  j                  j                  ||   || j                  j                  j                  j                  j                  ¬«       Œœt        || j                  || j                  j                  j                  j                  j                  || j                  j                  j                  j                  j                  ¬«       �Œ y )N)r   Úresource_nameÚevent_emitterÚbatch_action_modelÚcollection_modelÚservice_model)r   r<   Úaction_namer=   r?   r@   )r   Úgetattrr   r!   Údocument_collection_objectÚbatch_actionsÚsortedr"   Údocument_batch_actionÚ_resource_namer   ÚclientÚeventsr@   Údocument_collection_method)r1   r   r3   ÚmethodsrD   Úbatch_actionÚmethodÚmethod_sections           r8   r)   z)CollectionDocumenter._document_collectionA   s8  € Ü-Ü�D—N‘N J§O¡OÓ4ó
ˆô 	# 7¨JÔ7ØˆØ&×4Ñ4ò 	<ˆLØ/;ˆM˜,×+Ñ+Ò,ð	<ô ˜W“oó 	ˆFØ$×4Ñ4°VÓ<ˆNØ˜Ñ&Ü%Ø*Ø"&×"5Ñ"5Ø"&§.¡.×"5Ñ"5×"<Ñ"<×"AÑ"A×"HÑ"HØ'4°VÑ'<Ø%/Ø"&§.¡.×"5Ñ"5×"<Ñ"<×"AÑ"A×"OÑ"Oöô +Ø*Ø"&×"5Ñ"5Ø &Ø"&§.¡.×"5Ñ"5×"<Ñ"<×"AÑ"A×"HÑ"HØ%/Ø"&§.¡.×"5Ñ"5×"<Ñ"<×"AÑ"A×"OÑ"O÷ñ	r:   N)Ú__name__Ú
__module__Ú__qualname__r9   r)   © r:   r8   r   r      s   „ ò"PóHr:   r   c                 ó6  — |rE| j                   j                  dd«      › |j                  › �}| j                  j	                  |«       | j                  d|j                  j                  › d�«       | j                  d|j                  j                  › d�«       y)a
  Documents 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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   Úgetr!   r#   Ústart_sphinx_py_attrÚinclude_doc_stringÚresourceÚtype)r   r?   Úinclude_signatureÚfull_collection_names       r8   rC   rC   `   sž   € ñ à�‰×"Ñ" ;°Ó3Ð4Ð5E×5JÑ5JÐ4KÐLð 	ð 	�‰×*Ñ*Ð+?Ô@Ø×ÑØ
Ð+×4Ñ4×9Ñ9Ð:¸+ÐFôð ×ÑØ
Ð×&Ñ&×+Ñ+Ð,ð -/ð 	0õr:   c                 ó¾  — |j                  |j                  j                  «      }t        |j                  j                  «      }d}	|j
                  rt        |j
                  j                  «      }	t        |«      }
|j                  |k(  r|}
dj                  |	|
|j                  |j                  «      }t        | |j                  |||j                  ||||¬«	       y)ai  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.
    Úresponsez{} = {}.{}.{})	r   Úmethod_nameÚoperation_modelr=   Úmethod_descriptionÚexample_prefixÚexclude_inputÚresource_action_modelrZ   N)r_   ÚrequestÚ	operationr
   ÚparamsrX   r   rY   Úservice_nameÚformatr!   r   Údocumentation)r   r<   r=   r>   r@   r?   rZ   r_   Úignore_paramsÚexample_return_valueÚexample_resource_namera   s               r8   rF   rF   }   sß   € ð: $×3Ñ3Ø×"Ñ"×,Ñ,ó€Oô /Ø×"Ñ"×)Ñ)ó€Mð &ÐØ×"Ò"Ü)Ð*<×*EÑ*E×*JÑ*JÓKÐä& }Ó5ÐØ×!Ñ! ]Ò2Ø -ÐØ$×+Ñ+ØØØ×ÑØ×Ñó	€Nô *ØØ&×+Ñ+Ø'Ø#Ø*×8Ñ8Ø%Ø#Ø0Ø+ö
r:   c           
      óT  — |j                  |j                  j                  «      }g }|j                  r|j                  j                  }t        |«      }	|j                  |k(  r|}	d|j                  j                  › d�dj                  t        |j                  j                  «      |	|j                  «      |dœd|j                  j                  › d|j                  j                  › d�dj                  t        |j                  j                  «      |	|j                  «      t        |j                  j                  «      dœd|j                  j                  › d�d	j                  t        |j                  j                  «      |	|j                  «      t        d
dd¬«      g|dœd|j                  j                  › d�dj                  t        |j                  j                  «      |	|j                  «      t        d
dd¬«      g|dœdœ}
||
v r|
|   }t        d| |||||dœ|¤Ž yy)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Creates an iterable of all z resources in the collection.z{}_iterator = {}.{}.all)r`   ra   rb   zD 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{}_iterator = {}.{}.filterz0Creates an iterable up to a specified amount of z{}_iterator = {}.{}.limitÚcountÚintegerz5The limit to the number of resources in the iterable.)r!   Ú	type_nameri   )r`   ra   Úinclude_inputrb   zs resources in the collection, but limits the number of items returned by each service call by the specified amount.z{}_iterator = {}.{}.page_sizez1The number of items returned by each service call)ÚallÚfilterÚlimitÚ	page_size)r   r^   r_   r=   rc   rZ   NrR   )r_   rd   re   Úinput_shapeÚmembersr   rg   rX   rY   rh   r!   r
   rf   r   r   )r   r<   rA   r=   r?   r@   rZ   r_   Úunderlying_operation_membersrl   Úcustom_action_info_dictÚaction_infos               r8   rJ   rJ   »   s…  € ð6 $×3Ñ3Ø× Ñ ×*Ñ*ó€Oð $&Ð Ø×"Ò"Ø'6×'BÑ'B×'JÑ'JÐ$ä& }Ó5ÐØ×!Ñ! ]Ò2Ø -Ðð
 .Ð.>×.GÑ.G×.LÑ.LÐ-Mð N/ð 0ð 8×>Ñ>ÜÐ+×4Ñ4×9Ñ9Ó:Ø%Ø ×%Ñ%óð
 :ñ
ð .Ð.>×.GÑ.G×.LÑ.LÐ-Mð Nà-×6Ñ6×;Ñ;Ð<ð =$ð%ð ;×AÑAÜÐ+×4Ñ4×9Ñ9Ó:Ø%Ø ×%Ñ%óô
 8Ø ×(Ñ(×/Ñ/óñ
ð( CØ#×,Ñ,×1Ñ1Ð2Ð2OðQð :×@Ñ@ÜÐ+×4Ñ4×9Ñ9Ó:Ø%Ø ×%Ñ%óô  Ø Ø'ð+ô	ð	ð :ñ)
ð0 .Ð.>×.GÑ.G×.LÑ.LÐ-Mð NOð Pð >×DÑDÜÐ+×4Ñ4×9Ñ9Ó:Ø%Ø ×%Ñ%óô  Ø Ø'àNô	ðð :ñ)
ñkKÐðX Ð-Ñ-Ø-¨kÑ:ˆÜ-ð 	
ØØ#Ø+Ø'Ø"2Ø/ñ	
ð ó	
ð .r:   )T)r*   Úbotocorer   Úbotocore.docs.bcdoc.restdocr   Úbotocore.docs.methodr   Úbotocore.docs.utilsr   Úboto3.docs.baser   Úboto3.docs.methodr   Úboto3.docs.utilsr	   r
   r   rC   rF   rJ   rR   r:   r8   ú<module>r‚      sR   ðó 
å Ý 9Ý <Ý /å ,Ý C÷ôAÐ+ô AðN óðH ó;ðJ ô}
r:   