§
    @xÅj ,  ã                   ó    — 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dS )é    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dS )ÚCollectionDocumenterc                 óÈ  — | j         j        j        j        }g }t	          |ddd¬¦  «         || j        d<   |D �](}|                     |j        ¦  «         t          |j        d¬¦  «        }| 	                    d¦  «        }|j
                             | j        d	¦  «         |                     d
|j        › �¦  «         |                     |j        ¦  «         | 	                    |j        d| j        › d�i¬¦  «        }|                      ||¦  «         t"          j                             | j        | j        › | j        › ¦  «        }|                     ||j        ¦  «         �Œ*d S )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	            úFC:\Projects\Historical\venv\Lib\site-packages\boto3/docs/collection.pyÚdocument_collectionsz)CollectionDocumenter.document_collections   s”  € Ø”nÔ)Ô8ÔDˆØÐÝ"ØØ'ð3ð +ð	
ñ 	
ô 	
ð 	
ð *:ˆŒ˜Ñ&Ø%ð 	Pñ 	PˆJØ×#Ò# J¤OÑ4Ô4Ð4å.¨z¬ÀvÐNÑNÔNˆNØ!/×!?Ò!?ÀÑ!MÔ!MÐØÔ$×(Ò(¨Ô)BÀGÑLÔLÐLØ×$Ò$Ð%I¸
¼Ð%IÐ%IÑJÔJÐJØ×,Ò,¨Z¬_Ñ=Ô=Ð=Ø!/×!?Ò!?Ø”Ø$¨¬Ð&;Ð&;Ð&;Ð<ð "@ñ "ô "Ðð ×%Ò%Ð&8¸*ÑEÔEÐEõ $&¤7§<¢<ØÔ$ØÔ%Ð'ØÔ*Ð,ñ$ô $Ð ð
 ×(Ò(Ð)=¸z¼ÑOÔOÐOÑOð+	Pð 	Pó    c           	      ó4  — t          t          | j        |j        ¦  «        ¦  «        }t	          ||¦  «         i }|j        D ]}|||j        <   Œt          |¦  «        D ]º}|                     |¦  «        }||v rSt          || j	        | j        j
        j        j
        j        ||         || j        j
        j        j
        j        ¬¦  «         Œnt          || j	        || j        j
        j        j
        j        || j        j
        j        j
        j        ¬¦  «         Œ»d S )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   s9  € Ý-Ý�D”N J¤OÑ4Ô4ñ
ô 
ˆõ 	# 7¨JÑ7Ô7Ð7ØˆØ&Ô4ð 	<ð 	<ˆLØ/;ˆM˜,Ô+Ñ,Ð,å˜W‘o”oð 	ð 	ˆFØ$×4Ò4°VÑ<Ô<ˆNØ˜Ð&Ð&Ý%Ø*Ø"&Ô"5Ø"&¤.Ô"5Ô"<Ô"AÔ"HØ'4°VÔ'<Ø%/Ø"&¤.Ô"5Ô"<Ô"AÔ"Oðñ ô ð ð õ +Ø*Ø"&Ô"5Ø &Ø"&¤.Ô"5Ô"<Ô"AÔ"HØ%/Ø"&¤.Ô"5Ô"<Ô"AÔ"Oðñ ô ð ð ð	ð 	r:   N)Ú__name__Ú
__module__Ú__qualname__r9   r)   © r:   r8   r   r      s6   € € € € € ð"Pð "Pð "PðHð ð ð ð r:   r   Tc                 ó  — |r>| j                              dd¦  «        › |j        › �}| j                             |¦  «         |                      d|j        j        › d�¦  «         |                      d|j        j        › d�¦  «         dS )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½   € ð ð AàŒ×"Ò" ;°Ñ3Ô3ÐLÐ5EÔ5JÐLÐLð 	ð 	Œ×*Ò*Ð+?Ñ@Ô@Ð@Ø×ÒØFÐ+Ô4Ô9ÐFÐFÐFñô ð ð ×Òð	0ÐÔ&Ô+ð 	0ð 	0ð 	0ñô ð ð ð r:   c                 ód  — |                      |j        j        ¦  «        }t          |j        j        ¦  «        }d}	|j        rt          |j        j        ¦  «        }	t          |¦  «        }
|j        |k    r|}
|	› d|
› d|j	        › d|j	        › �}t          | |j	        |||j        ||||¬¦	  «	         dS )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   )	r   Úmethod_nameÚoperation_modelr=   Úmethod_descriptionÚexample_prefixÚexclude_inputÚresource_action_modelrZ   N)r_   ÚrequestÚ	operationr
   ÚparamsrX   r   rY   Úservice_namer!   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ð &ÐØÔ"ð LÝ)Ð*<Ô*EÔ*JÑKÔKÐå& }Ñ5Ô5ÐØÔ! ]Ò2Ð2Ø -ÐØ,ÐzÐzÐ1FÐzÐzÐIYÔI^ÐzÐzÐasÔaxÐzÐz€NÝ)ØØ&Ô+Ø'Ø#Ø*Ô8Ø%Ø#Ø0Ø+ð
ñ 
ô 
ð 
ð 
ð 
r:   c           
      ó>  — |                      |j        j        ¦  «        }g }|j        r|j        j        }t          |¦  «        }	|j        |k    r|}	d|j        j        › d�t          |j        j        ¦  «        › d|	› d|j	        › d�|dœd|j        j        › d|j        j        › d�t          |j        j        ¦  «        › d|	› d|j	        › d	�t          |j        j        ¦  «        dœd
|j        j        › d�t          |j        j        ¦  «        › d|	› d|j	        › d�t          ddd¬¦  «        g|dœd|j        j        › d�t          |j        j        ¦  «        › d|	› d|j	        › d�t          ddd¬¦  «        g|dœdœ}
||
v r|
|         }t          d| |||||dœ|¤Ž dS dS )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 = r   z.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.filterz0Creates an iterable up to a specified amount of z.limitÚcountÚintegerz5The limit to the number of resources in the iterable.)r!   Ú	type_namerh   )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
.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   r!   r
   rf   r   r   )r   r<   rA   r=   r?   r@   rZ   r_   Úunderlying_operation_membersrk   Úcustom_action_info_dictÚaction_infos               r8   rJ   rJ   ¶   s+  € ð6 $×3Ò3ØÔ Ô*ñô €Oð $&Ð ØÔ"ð KØ'6Ô'BÔ'JÐ$å& }Ñ5Ô5ÐØÔ! ]Ò2Ð2Ø -Ðð
0Ð.>Ô.GÔ.Lð 0ð 0ð 0õ ",Ð,<Ô,EÔ,JÑ!KÔ!Kð  Mð  MÐYnð  Mð  Mð  rBô  rGð  Mð  Mð  MØ9ð
ð 
ð%Ð.>Ô.GÔ.Lð %ð %à-Ô6Ô;ð%ð %ð %õ ",Ð,<Ô,EÔ,JÑ!KÔ!Kð  Pð  PÐYnð  Pð  Pð  rBô  rGð  Pð  Pð  PÝ7Ø Ô(Ô/ñô ð
ð 
ð QØ#Ô,Ô1ðQð Qð Qõ ",Ð,<Ô,EÔ,JÑ!KÔ!Kð  Oð  OÐYnð  Oð  Oð  rBô  rGð  Oð  Oð  OåØ Ø'àOð	ñ ô ðð :ð
ð 
ð&PÐ.>Ô.GÔ.Lð Pð Pð Põ ",Ð,<Ô,EÔ,JÑ!KÔ!Kð  Sð  SÐYnð  Sð  Sð  rBô  rGð  Sð  Sð  SåØ Ø'àKð	ñ ô ðð :ð!
ð 
ðQ:ð :Ððv Ð-Ð-Ð-Ø-¨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�      s5  ðð 
€	€	€	à Ð Ð Ð Ð Ð Ø 9Ð 9Ð 9Ð 9Ð 9Ð 9Ø <Ð <Ð <Ð <Ð <Ð <Ø /Ð /Ð /Ð /Ð /Ð /à ,Ð ,Ð ,Ð ,Ð ,Ð ,Ø CÐ CÐ CÐ CÐ CÐ Cðð ð ð ð ð ð ð ðAð Að Að Að AÐ+ñ Aô Að AðN ðð ð ð ðH ð6ð 6ð 6ð 6ð@ ðl
ð l
ð l
ð l
ð l
ð l
r:   