o
    i-                     @   st   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mZ G dd	 d	e
Z	
dddZdS )    N)
xform_name)DocumentStructure)document_model_driven_method)get_service_module_name)NestedDocumenter)add_resource_type_overviewget_resource_ignore_paramsc                       s$   e Zd Z fddZdd Z  ZS )WaiterResourceDocumenterc                    s   t  || || _d S )N)super__init___service_waiter_model)selfresourceservice_waiter_modelZroot_docs_path	__class__ H/home/app/Keep/.python/lib/python3.10/site-packages/boto3/docs/waiter.pyr      s   
z!WaiterResourceDocumenter.__init__c           	   	   C   s   | j jjj}t|dddd g }|| jd< |D ]_}||j t|jdd}|	d}|j
| jd	 |d
|j  ||j |j	|jd| j did}t|| j| j jjjj| j|| jd tj| j| j | j }|||j qd S )NZWaiterszNWaiters provide an interface to wait for a resource to reach a specific state.Zwaiters_intro)sectionZresource_typedescriptionZ
intro_linkwaitershtml)targetZ
breadcrumbindexz / Waiter / 	qualifier.)context)r   resource_nameevent_emitterservice_modelresource_waiter_modelr   )Z	_resourcemetaZresource_modelr   r   
member_mapappendnamer   Zadd_new_sectionstylerefZ_resource_class_namewriteZadd_title_section
class_namedocument_resource_waiterZ_resource_nameclienteventsZ_service_modelr   ospathjoinZ_root_docs_pathZ_service_nameZ_resource_sub_pathZwrite_to_file)	r   r   r   Zwaiter_listwaiterZ
waiter_docZbreadcrumb_sectionZwaiter_sectionZwaiters_dir_pathr   r   r   document_resource_waiters    sF   	


z2WaiterResourceDocumenter.document_resource_waiters)__name__
__module____qualname__r   r0   __classcell__r   r   r   r   r	      s    r	   Tc              
   C   s   | |j}||j}t|j}	t|}
d|d|j	
ddd  |
t|j|
t|j|j|j}t| d|j	 }| jdd |j	 }t| ||||||	|d d	| jv ro| d	}|  |  |d
 d S d S )NzWaits until this {} is {}. This method calls :py:meth:`{}.Waiter.{}.wait` which polls :py:meth:`{}.Client.{}` every {} seconds until a successful state is reached. An error is raised after {} failed checks. _   r   r    )r   method_nameoperation_modelr   example_prefixZmethod_descriptionZexclude_inputinclude_signaturereturnz:returns: None)Z
get_waiterZwaiter_namer:   Z	operationr   paramsr   formatr.   r$   splitr   delayZmax_attemptsr   getr   Zavailable_sectionsZget_sectionZ
clear_textZremove_all_sectionsr'   )r   r   r   r   r    r   r<   Zwaiter_modelr:   Zignore_paramsZservice_module_namer   r;   Zfull_waiter_nameZreturn_sectionr   r   r   r)   K   sL   	



r)   )T)r,   Zbotocorer   Zbotocore.docs.bcdoc.restdocr   Zbotocore.docs.methodr   Zbotocore.utilsr   Zboto3.docs.baser   Zboto3.docs.utilsr   r   r	   r)   r   r   r   r   <module>   s   7