o
?c @ sZ d dl mZ d dlmZ d dlmZ d dlmZ d dlm Z G dd dZ
d d d
Z d S )
)
xform_name) OrderedDict) document_model_driven_method)DocumentedShape)get_service_module_namec @ s$ e Zd Zdd Zdd Zdd ZdS )PaginatorDocumenterc C s || _ | j jjj| _|| _d S )N)_clientmeta
service_modelZ service_nameZ
_service_name_service_paginator_model)selfclientZservice_paginator_model r r/private/var/folders/cw/wlscbxl13mj6wd668h7l9g9sllkg5j/T/pip-target-b31awkwq/lib/python/botocore/docs/paginator.py__init__ s
z PaginatorDocumenter.__init__c C sf |j d |j |d t| jj}|D ]}|j d| jj j
d| d | || qdS )zhDocuments the various paginators for a service
param section: The section to write to.
Z
Paginatorsz The available paginators are:z :py:class:` .Paginator.`N) styleZh2new_linewritelnsortedr Z_paginator_configZlir __class____name___add_paginator)r sectionZpaginator_namespaginator_namer r r document_paginators s
z'PaginatorDocumenter.document_paginatorsc C s | |}|jj| jjj d| d |j |j |dt | d |j
|j | j |}t
||| jjj| jjj|d d S )Nr )
class_namez"paginator = client.get_paginator('z'))r r
event_emitterr
paginator_config)Zadd_new_sectionr Zstart_sphinx_py_classr r r Zstart_codeblockr writer Z
end_codeblockr Z
get_paginatordocument_paginate_methodr eventsr
)r r r r r r r r . s*
z"PaginatorDocumenter._add_paginatorN)r
__module__ __qualname__r r r r r r r r s r Tc
C s | |}t }tdddd|d< |ddr tdddd|d< td d
d d|d < td d
d|dg}tdd
ddg} g }
t|d trJ|
|d 7 }
n|
|d |ddr^|
|d g } t|d trn| |d 7 } n| |d dt|t |} t
| d||| 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.
ZMaxItemsintegerzThe 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
documentationZ limit_keyNZPageSizez The size of each page.
Z
StartingTokenstringzq
A token to specify where to start paginating. This is the NextToken from a previous response.
ZPaginationConfigZ structurezCA dictionary that provides parameters to control pagination.
)r& r' r( membersZ NextTokenz$A token to resume pagination.
Z input_tokenZ output_tokenzVCreates an iterator that will paginate through responses from :py:meth:`{}.Client.{}`.Zpaginatez&response_iterator = paginator.paginate)r Zmethod_descriptionZexample_prefixZ
include_inputZinclude_outputZ
exclude_inputZexclude_outputinclude_signature) operation_modelr r get
isinstancelistappendformatr r r )
r r r r
r r+ r, Zpagination_config_membersZbotocore_pagination_paramsZ#botocore_pagination_response_paramsZservice_pagination_paramsZ"service_pagination_response_paramsZpaginate_descriptionr r r r! M sz
r! N)T) Zbotocorer Zbotocore.compatr Zbotocore.docs.methodr Zbotocore.docs.utilsr Zbotocore.utilsr r r! r r r r s ?