API 端点通常分页，这意味着您必须链式请求以获取完整内容。 Unpaginate 提供一个装饰器以简化此任务

>>> from unpaginate import unpaginate

>>> @unpaginate
... def get_cities(pagination, country):
...     return requests.post(
...         "https://api.example.org/cities",
...         json={"country": country, "page": pagination.page},
...     ).json()["items"]

调用装饰函数允许迭代所有页面的所有项目

>>> iterator = get_cities("France")  # the 'pagination' parameter is added by the decorator
>>> iterator
<generator object get_cities ...>

>>> next(iterator)
'Paris'
>>> next(iterator)
'Lyon'
>>> next(iterator)
'Marseille'

支持所有分页方案

• 按页面索引
• 按偏移量
• 使用游标
• 通过 高级模式 支持其他方案