j" 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 )PaginatorDocumenterc || _ | j j j | _ | j j j j | _ || _ || _ d| _
d S )Nz>https://docs.aws.amazon.com/boto3/latest/guide/paginators.html) _client __class____name___client_class_namemeta
service_model service_name
_service_name_service_paginator_model_root_docs_path_USER_GUIDE_LINK)selfclientservice_paginator_modelroot_docs_paths X/usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages/botocore/docs/paginator.py__init__z PaginatorDocumenter.__init__ sM "&,"8"A !\ . < I(?% - L
c F |j d | | |j | d |j t
| j j }|D ]}|j | j
d| t |d }| || t j | j | j
d }| || dS )zhDocuments the various paginators for a service
param section: The section to write to.
Paginatorsz The available paginators are:z /paginator/html)target paginatorN)styleh2
_add_overviewnew_linewritelntoctreesortedr _paginator_configtocitemr r _add_paginatorospathjoinr
write_to_file)r sectionpaginator_namespaginator_namepaginator_doc_structurepaginator_dir_paths r document_paginatorsz'PaginatorDocumenter.document_paginators" sH
&&& 7###
7888
) ;
. N M ! !%BB.BB
'8 v' ' ' #
7 H H H "$ $d&8+" "
$ 1 1"N
r c | d }|j | j d| j | d| | | | | }|j | j d| |j |j | dt | d |j |j | j
| }t ||| j j j | j j j | d S ) N
breadcrumbz../../z / Paginator / z .Paginator.)
class_namez"paginator = client.get_paginator('z'))r1 r3
event_emitterr paginator_config)add_new_sectionr# refr r writeadd_title_sectionstart_sphinx_py_classstart_codeblockr& r
end_codeblockr
get_paginatordocument_paginate_methodr r eventsr )r r1 r3 breadcrumb_sectionpaginator_sectionr; s r r, z"PaginatorDocumenter._add_paginatorD s $ 4 4\ B B $$ #%Bd.@%B%B
!C>!C!CDDD!!.111 $ 3 3N C C 55*GG~GG 6
//111 ((*** ON1K1K O O O
--/// ((*** 8FF
!%) ,+2 ,+9 -
r c |j | d |j d| j | d |j d S )NzPaginators are available on a client instance via the ``get_paginator`` method. For more detailed instructions and examples on the usage of paginators, see the paginators z
user guide)titlelink.)r# r& r>
external_linkr )r r1 s r r% z!PaginatorDocumenter._add_overviewh s
## & $
c
r N)r
__module__ __qualname__r r6 r, r% r r r
r
sR
D"
"
"
H
!
!
!
!
!r r
Tc
0 | | }t }t ddd |d< | dd rt ddd |d< t d d
d |d < t d d
d| g}t dd
d g} g }
t |d t
r |
|d z
}
n|
|d | dd r|
|d g } t |d t
r | |d z
} n| |d dt | dt | d} t | d||| d|| |
| | dS )a Documents the paginate method of a paginator
:param section: The section to write to
:param paginator_name: The name of the paginator. It is snake cased.
:param event_emitter: The event emitter to use to emit events
:param service_model: The service model
:param paginator_config: The paginator config associated to a particular
paginator.
:param include_signature: Whether or not to include the signature.
It is useful for generating docstrings.
MaxItemsintegerzThe total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
)name type_name
documentation limit_keyNPageSizez The size of each page.
StartingTokenstringzq
A token to specify where to start paginating. This is the NextToken from a previous response.
PaginationConfig structurezCA dictionary that provides parameters to control pagination.
)rS rT rU members NextTokenz$A token to resume pagination.
input_token output_tokenzHCreates an iterator that will paginate through responses from :py:meth:`z.Client.z`.paginatez&response_iterator = paginator.paginate)r: method_descriptionexample_prefix
include_inputinclude_output
exclude_inputexclude_outputinclude_signature)
operation_modelr r get
isinstancelistappendr r r )
r1 r3 r: r r; rg rh pagination_config_membersbotocore_pagination_params#botocore_pagination_response_paramsservice_pagination_params"service_pagination_response_paramspaginate_descriptions
r rD rD x s\ 2 $33NCCO
!,
,;
%
-
-
- j) K..
0? 81
1
1
!*- 2A
2 2 2 o. #!" .
" A
+' !# "=1488 J!%5m%DD!!!(()9-)HIII K.. H!(()9+)FGGG *,&">2D99
*.>~.NN***11 ^ ,
i1-@@ i iJTUcJdJd i i i
!#/?0:/9+ r )T)r- botocorer botocore.compatr botocore.docs.bcdoc.restdocr botocore.docs.methodr botocore.docs.utilsr botocore.utilsr r
rD rO r r ry s
' ' ' ' ' ' 9 9 9 9 9 9 = = = = = = / / / / / / 2 2 2 2 2 2^! ^! ^! ^! ^! ^! ^! ^!N
x x x x x xr