o 6׾g>,@sddlZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZmZGd d d e Z dd d Z dddZ dddZdS)N) xform_name)DocumentStructure)get_instance_public_methods)DocumentedShape)NestedDocumenter)%document_model_driven_resource_method)add_resource_type_overviewget_resource_ignore_paramsc@seZdZddZddZdS)CollectionDocumenterc Cs|jjjj}g}t|dddd||jd<|D]S}||jt|jdd}| d}|j |j d | d |j||j|j |jd |jd id }|||tj|j|j|j}|||jqdS)N CollectionszUCollections provide an interface to iterate over and manipulate groups of resources. guide_collections)section resource_type description intro_link collectionshtml)target breadcrumbindexz / Collection / qualifier.)context) _resourcemetaresource_modelrr member_mapappendnameradd_new_sectionstyleref_resource_class_namewriteadd_title_section class_name_document_collectionospathjoin_root_docs_path _service_name_resource_sub_path write_to_file) selfr rcollections_list collectioncollection_docbreadcrumb_sectioncollection_sectioncollections_dir_pathr5_/var/www/html/backend_erp/backend_erp_env/lib/python3.10/site-packages/boto3/docs/collection.pydocument_collectionss8      z)CollectionDocumenter.document_collectionsc Cstt|j|j}t||i}|jD]}|||j<qt|D]8}||}||vrBt||j |jj j j j ||||jj j j j dqt||j ||jj j j j ||jj j j j dqdS)N)r resource_name event_emitterbatch_action_modelcollection_model service_model)r r8 action_namer9r;r<)rgetattrrrdocument_collection_object batch_actionssortedrdocument_batch_action_resource_namerclienteventsr<document_collection_method)r.r r0methodsr@ batch_actionmethodmethod_sectionr5r5r6r&As6           z)CollectionDocumenter._document_collectionN)__name__ __module__ __qualname__r7r&r5r5r5r6r s $r TcCsX|r|jdd|j}|j||d|jjd|d|jjddS)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. rzA collection of z resources.zA z Collection will include all resources by default, and extreme caution should be taken when performing actions on all resources.N)rgetrr start_sphinx_py_attrinclude_doc_stringresourcetype)r r;include_signaturefull_collection_namer5r5r6r?`s r?c Cs||jj}t|jj}d} |jrt|jj} t|} |j|kr#|} | d| d|j d|j } t ||j |||j | |||d dS)aiDocuments 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_nameoperation_modelr9method_descriptionexample_prefix exclude_inputresource_action_modelrTN) rXrequest operationr paramsrRrrS service_namerr documentation) r r8r9r:r<r;rTrX ignore_paramsexample_return_valueexample_resource_namerZr5r5r6rB}s0   rBc Csf||jj}g}|jr|jj}t|} |j|kr|} d|jjdt|jjd| d|j d|dd|jjd|jjdt|jjd| d|j d t |jj dd |jjdt|jjd| d|j d t d d ddg|dd|jjdt|jjd| d|j dt d d ddg|dd} || vr| |} t d||||||d| dSdS)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. zCreates an iterable of all z resources in the collection.z _iterator = rz.all)rYrZr[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.limitcountintegerz5The limit to the number of resources in the iterable.)r type_namera)rYrZ include_inputr[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)allfilterlimit page_size)r rWrXr9r\rTNr5)rXr]r^ input_shapemembersrr`rRrSrr r_rr) r r8r=r9r;r<rTrXunderlying_operation_membersrdcustom_action_info_dict action_infor5r5r6rFsr    < rF)T)r'botocorerbotocore.docs.bcdoc.restdocrbotocore.docs.methodrbotocore.docs.utilsrboto3.docs.baserboto3.docs.methodrboto3.docs.utilsrr r r?rBrFr5r5r5r6s      G $ @