> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# paginator

Utilidades de paginación basada en cursores para el SDK de X API.

Este módulo proporciona una clase Cursor para ofrecer paginación de forma elegante en
todos los clientes de la API. Cursor permite iterar fácilmente sobre resultados paginados
utilizando tanto los métodos .pages() como .items(), con la seguridad de tipos adecuada.

<div id="class-xdkpaginatorcursor">
  ### `class xdk.paginator.Cursor`
</div>

\[`ResponseType`]

<div id="parameters">
  #### Parámetros
</div>

<ParamField path="path.method" type="PaginatableMethod" />

<div id="__init__">
  ### `__init__`
</div>

Inicializa el cursor.

<div id="parameters">
  #### Parámetros
</div>

<ParamField path="path.method" type="PaginatableMethod">
  El método de la API que se llamará para cada página (debe admitir paginación)
</ParamField>

<div id="items">
  ### `items`
</div>

Itera sobre elementos individuales de las respuestas paginadas.

<div id="parameters">
  #### Parámetros
</div>

<ParamField path="path.limit" type="int or None" default="None">
  Número máximo de elementos que se devolverán (None para sin límite)
</ParamField>

<div id="returns">
  #### Devuelve
</div>

`IteratorAny`

<div id="pages">
  ### `pages`
</div>

Itera sobre páginas de respuestas.

<div id="parameters">
  #### Parámetros
</div>

<ParamField path="path.limit" type="int or None" default="None">
  Número máximo de páginas que se devolverán (None para sin límite)
</ParamField>

<div id="returns">
  #### Devuelve
</div>

`IteratorResponseType`

<div id="class-xdkpaginatorpaginatablemethod">
  ### `class xdk.paginator.PaginatableMethod`
</div>

\[`ResponseType`]

<div id="__init__">
  ### `__init__`
</div>

<div id="xdkpaginatorcursor">
  ### `xdk.paginator.cursor`
</div>

Crea un cursor con la inferencia y validación de tipos adecuadas.
Esta función de fábrica ayuda con la inferencia de tipos para que obtengas
sugerencias de tipo correctas para la respuesta y valida que el método
admita paginación tanto en el análisis estático como en tiempo de ejecución.

<div id="parameters">
  #### Parámetros
</div>

<ParamField path="path.method" type="PaginatableMethod">
  El método de la API que se va a encapsular (debe admitir paginación)
</ParamField>