Add support for indicating the pagination direction in the ListPage objects (#61)

Author: fnesveda

CHANGELOG.md

@@ -7,6 +7,7 @@ Changelog
 ### Added
 
 - added the `test()` method to the webhook client
+- added support for indicating the pagination direction in the `ListPage` objects
 
 [0.2.0](../../releases/tag/v0.2.0) - 2021-08-09
 -----------------------------------------------

docs/docs.md

@@ -2838,6 +2838,7 @@ Name | Type | Description
 `limit` | `int` | The offset of the first object specified in the API call
 `count` | `int` | Count of the returned objects on this page
 `total` | `int` | Total number of objects matching the API call criteria
+`desc` | `bool` | Whether the listing is descending or not
 
 ***
 

src/apify_client/_utils.py

@@ -216,6 +216,8 @@ class ListPage:
     limit: int
     #: int: Total number of objects matching the API call criteria
     total: int
+    #: bool: Whether the listing is descending or not
+    desc: bool
 
     def __init__(self, data: Dict) -> None:
         """Initialize a ListPage instance from the API response data."""
@@ -224,3 +226,4 @@ def __init__(self, data: Dict) -> None:
         self.limit = data['limit'] if 'limit' in data else 0
         self.count = data['count'] if 'count' in data else len(self.items)
         self.total = data['total'] if 'total' in data else self.offset + self.count
+        self.desc = data['desc'] if 'desc' in data else False

src/apify_client/clients/resource_clients/dataset.py

@@ -116,6 +116,7 @@ def list_items(
             'offset': int(response.headers['x-apify-pagination-offset']),
             'count': len(data),  # because x-apify-pagination-count returns invalid values when hidden/empty items are skipped
             'limit': int(response.headers['x-apify-pagination-limit']),  # API returns 999999999999 when no limit is used
+            'desc': bool(response.headers['x-apify-pagination-desc']),
         })
 
     def iterate_items(