/Jf z d dl Z d dlmZ d dlmZ d dlmZ d dlmZ d dl m
Z
d dl m Z G d d Z
d d ZdS )
N)
xform_name) OrderedDict)DocumentStructure) document_model_driven_method)DocumentedShape)get_service_module_namec & e Zd Zd Zd Zd Zd ZdS )WaiterDocumenterc || _ | j j j | _ | j j j j | _ || _ || _ d| _
d S )NzRhttps://boto3.amazonaws.com/v1/documentation/api/latest/guide/clients.html#waiters) _client __class____name___client_class_namemeta
service_model service_name
_service_name_service_waiter_model_root_docs_path_USER_GUIDE_LINK)selfclientservice_waiter_modelroot_docs_paths W/home/alex/cs2snipeproduction/venv/lib/python3.11/site-packages/botocore/docs/waiter.py__init__zWaiterDocumenter.__init__ sP "&,"8"A !\ . < I%9" -
E
c ( |j d | | |j | d |j | j j D ]}|j | j d| t |d }| || t j
| j | j d }| || dS )zgDocuments the various waiters for a service.
:param section: The section to write to.
WaiterszThe available waiters are:z/waiter/html)targetwaiterN)styleh2
_add_overviewnew_linewritelntoctreer waiter_namestocitemr r _add_single_waiterospathjoinr
write_to_file)r section waiter_namewaiter_doc_structurewaiter_dir_paths r document_waitersz!WaiterDocumenter.document_waiters# s%
### 7###
4555
5B M MK M ! !T%7"N"N"N"N O O O#4F$ $ $
# #$8+ F F F !gll$d&8( O
! . . L L L L M Mr c | d }|j | j d| j | d| | | | | }|j | j d| |j |j | dt | z |j |j t ||| j
j j | j
j j | j d S )N
breadcrumbz../../z / Waiter / z.Waiter.)
class_namez waiter = client.get_waiter('%s'))r0 r1
event_emitterr r )add_new_sectionr# refr r writeadd_title_sectionstart_sphinx_py_classstart_codeblockr& r
end_codeblockdocument_wait_methodr r eventsr r )r r0 r1 breadcrumb_sectionwaiter_sections r r+ z#WaiterDocumenter._add_single_waiter; s $ 4 4\ B B $$ #%Bd.@%B%B
!= !=!=>>>!!+... 00== 22 1HH;HH 3
,,... %%''' 0:k3J3J J
**,,, %%''' "# ,+2 ,+9!%!;
r c |j | d |j d| j | d |j d S )NzWaiters are available on a client instance via the ``get_waiter`` method. For more detailed instructions and examples on the usage or waiters, see the waiters z
user guide)titlelink.)r# r& r;
external_linkr )r r0 s r r% z WaiterDocumenter._add_overviewY s
## & $
c
r N)r
__module__ __qualname__r r4 r+ r% r r r
r
sS
M M M0
<
!
!
!
!
!r r
Tc | | }| |j }t }t ddd |j |d< t ddd |j |d< t ddd |
g} d t | t |j |j |j }
t | d |||
d
| d| dS )a Documents a the wait method of a waiter
:param section: The section to write to
:param waiter_name: The name of the waiter
:param event_emitter: The event emitter to use to emit events
:param service_model: The service model
:param service_waiter_model: The waiter model associated to the service
:param include_signature: Whether or not to include the signature.
It is useful for generating docstrings.
DelayintegerzJThe amount of time in seconds to wait between attempts. Default: {}
)name type_name
documentation MaxAttemptsz=The maximum number of attempts to be made. Default: {}
WaiterConfig structurezIA dictionary that provides parameters to control waiting behavior.
)rO rP rQ memberszPolls :py:meth:`{}.Client.{}` every {} seconds until a successful state is reached. An error is returned after {} failed checks.waitz waiter.waitF)r8 method_descriptionexample_prefix
include_inputdocument_outputinclude_signatureN)
get_waiteroperation_model operationr r formatdelay max_attemptsr r r ) r0 r1 r8 r r r[ waiter_modelr] waiter_config_membersbotocore_waiter_paramswait_descriptions r r@ r@ i sK . (22;??L#33L4JKKO 'MM%4
((.|/A(B(B & & &'" ,;
$f\%> ? ? , , ,-( !( *
++16 #M 2 2 |- . . % ,
,
!#+$, +
r )T)r, botocorer botocore.compatr botocore.docs.bcdoc.restdocr botocore.docs.methodr botocore.docs.utilsr botocore.utilsr r
r@ rK r r rl s
' ' ' ' ' ' 9 9 9 9 9 9 = = = = = = / / / / / / 2 2 2 2 2 2O! O! O! O! O! O! O! O!p
O O O O O Or