latitudesh-python-sdk 0.0.8__py3-none-any.whl → 1.1.0__py3-none-any.whl

latitudesh_python_sdk/roles.py

@@ -1,27 +1,32 @@
 """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
 
 from .basesdk import BaseSDK
+from jsonpath import JSONPath
 from latitudesh_python_sdk import models, utils
 from latitudesh_python_sdk._hooks import HookContext
 from latitudesh_python_sdk.types import OptionalNullable, UNSET
 from latitudesh_python_sdk.utils import get_security_from_env
-from typing import Any, Mapping, Optional
+from typing import Any, Dict, List, Mapping, Optional, Union
 
 
 class Roles(BaseSDK):
     def list(
         self,
         *,
+        page_size: Optional[int] = 20,
+        page_number: Optional[int] = 1,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
-    ) -> models.GetRolesResponseBody:
+    ) -> Optional[models.GetRolesResponse]:
         r"""List all Roles
 
         Returns a list of all roles that can be assigned to users
 
 
+        :param page_size: Number of items to return per page
+        :param page_number: Page number to return (starts at 1)
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -36,12 +41,18 @@ class Roles(BaseSDK):
             base_url = server_url
         else:
             base_url = self._get_url(base_url, url_variables)
+
+        request = models.GetRolesRequest(
+            page_size=page_size,
+            page_number=page_number,
+        )
+
         req = self._build_request(
             method="GET",
             path="/roles",
             base_url=base_url,
             url_variables=url_variables,
-            request=None,
+            request=request,
             request_body_required=False,
             request_has_path_params=False,
             request_has_query_params=True,
@@ -74,8 +85,31 @@ class Roles(BaseSDK):
             retry_config=retry_config,
         )
 
+        def next_func() -> Optional[models.GetRolesResponse]:
+            body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
+            page = request.page_number if not request.page_number is None else 1
+            next_page = page + 1
+
+            if not http_res.text:
+                return None
+            results = JSONPath("$.data").parse(body)
+            if len(results) == 0 or len(results[0]) == 0:
+                return None
+            limit = request.page_size if not request.page_size is None else 20
+            if len(results[0]) < limit:
+                return None
+
+            return self.list(
+                page_size=page_size,
+                page_number=next_page,
+                retries=retries,
+            )
+
         if utils.match_response(http_res, "200", "application/vnd.api+json"):
-            return utils.unmarshal_json(http_res.text, models.GetRolesResponseBody)
+            return models.GetRolesResponse(
+                result=utils.unmarshal_json(http_res.text, models.GetRolesResponseBody),
+                next=next_func,
+            )
         if utils.match_response(http_res, "4XX", "*"):
             http_res_text = utils.stream_to_text(http_res)
             raise models.APIError(
@@ -99,16 +133,20 @@ class Roles(BaseSDK):
     async def list_async(
         self,
         *,
+        page_size: Optional[int] = 20,
+        page_number: Optional[int] = 1,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
-    ) -> models.GetRolesResponseBody:
+    ) -> Optional[models.GetRolesResponse]:
         r"""List all Roles
 
         Returns a list of all roles that can be assigned to users
 
 
+        :param page_size: Number of items to return per page
+        :param page_number: Page number to return (starts at 1)
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -123,12 +161,18 @@ class Roles(BaseSDK):
             base_url = server_url
         else:
             base_url = self._get_url(base_url, url_variables)
+
+        request = models.GetRolesRequest(
+            page_size=page_size,
+            page_number=page_number,
+        )
+
         req = self._build_request_async(
             method="GET",
             path="/roles",
             base_url=base_url,
             url_variables=url_variables,
-            request=None,
+            request=request,
             request_body_required=False,
             request_has_path_params=False,
             request_has_query_params=True,
@@ -161,8 +205,31 @@ class Roles(BaseSDK):
             retry_config=retry_config,
         )
 
+        def next_func() -> Optional[models.GetRolesResponse]:
+            body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
+            page = request.page_number if not request.page_number is None else 1
+            next_page = page + 1
+
+            if not http_res.text:
+                return None
+            results = JSONPath("$.data").parse(body)
+            if len(results) == 0 or len(results[0]) == 0:
+                return None
+            limit = request.page_size if not request.page_size is None else 20
+            if len(results[0]) < limit:
+                return None
+
+            return self.list(
+                page_size=page_size,
+                page_number=next_page,
+                retries=retries,
+            )
+
         if utils.match_response(http_res, "200", "application/vnd.api+json"):
-            return utils.unmarshal_json(http_res.text, models.GetRolesResponseBody)
+            return models.GetRolesResponse(
+                result=utils.unmarshal_json(http_res.text, models.GetRolesResponseBody),
+                next=next_func,
+            )
         if utils.match_response(http_res, "4XX", "*"):
             http_res_text = await utils.stream_to_text_async(http_res)
             raise models.APIError(

latitudesh_python_sdk/servers_sdk.py

@@ -1,11 +1,12 @@
 """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
 
 from .basesdk import BaseSDK
+from jsonpath import JSONPath
 from latitudesh_python_sdk import models, utils
 from latitudesh_python_sdk._hooks import HookContext
 from latitudesh_python_sdk.types import BaseModel, OptionalNullable, UNSET
 from latitudesh_python_sdk.utils import get_security_from_env
-from typing import Any, Mapping, Optional, Union, cast
+from typing import Any, Dict, List, Mapping, Optional, Union, cast
 
 
 class ServersSDK(BaseSDK):
@@ -27,11 +28,13 @@ class ServersSDK(BaseSDK):
         filter_disk: Optional[int] = None,
         filter_tags: Optional[str] = None,
         extra_fields_servers: Optional[str] = None,
+        page_size: Optional[int] = 20,
+        page_number: Optional[int] = 1,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
-    ) -> models.Servers:
+    ) -> Optional[models.GetServersResponse]:
         r"""List all Servers
 
         Returns a list of all servers belonging to the team.
@@ -52,6 +55,8 @@ class ServersSDK(BaseSDK):
         :param filter_disk: The disk size in Gigabytes to filter by, should be used with the following options:                               [eql] to filter for values equal to the provided value.                               [gte] to filter for values greater or equal to the provided value.                               [lte] to filter by values lower or equal to the provided value.
         :param filter_tags: The tags ids to filter by, separated by comma, e.g. `filter[tags]=tag_1,tag_2`will return servers with `tag_1` AND `tag_2`
         :param extra_fields_servers: The `credentials` are provided as extra attributes that is lazy loaded. To request it, just set `extra_fields[servers]=credentials` in the query string.
+        :param page_size: Number of items to return per page
+        :param page_number: Page number to return (starts at 1)
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -83,6 +88,8 @@ class ServersSDK(BaseSDK):
             filter_disk=filter_disk,
             filter_tags=filter_tags,
             extra_fields_servers=extra_fields_servers,
+            page_size=page_size,
+            page_number=page_number,
         )
 
         req = self._build_request(
@@ -123,8 +130,46 @@ class ServersSDK(BaseSDK):
             retry_config=retry_config,
         )
 
+        def next_func() -> Optional[models.GetServersResponse]:
+            body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
+            page = request.page_number if not request.page_number is None else 1
+            next_page = page + 1
+
+            if not http_res.text:
+                return None
+            results = JSONPath("$.data").parse(body)
+            if len(results) == 0 or len(results[0]) == 0:
+                return None
+            limit = request.page_size if not request.page_size is None else 20
+            if len(results[0]) < limit:
+                return None
+
+            return self.list(
+                filter_project=filter_project,
+                filter_region=filter_region,
+                filter_hostname=filter_hostname,
+                filter_created_at_gte=filter_created_at_gte,
+                filter_created_at_lte=filter_created_at_lte,
+                filter_label=filter_label,
+                filter_status=filter_status,
+                filter_plan=filter_plan,
+                filter_gpu=filter_gpu,
+                filter_ram_eql=filter_ram_eql,
+                filter_ram_gte=filter_ram_gte,
+                filter_ram_lte=filter_ram_lte,
+                filter_disk=filter_disk,
+                filter_tags=filter_tags,
+                extra_fields_servers=extra_fields_servers,
+                page_size=page_size,
+                page_number=next_page,
+                retries=retries,
+            )
+
         if utils.match_response(http_res, "200", "application/vnd.api+json"):
-            return utils.unmarshal_json(http_res.text, models.Servers)
+            return models.GetServersResponse(
+                result=utils.unmarshal_json(http_res.text, models.Servers),
+                next=next_func,
+            )
         if utils.match_response(http_res, "4XX", "*"):
             http_res_text = utils.stream_to_text(http_res)
             raise models.APIError(
@@ -163,11 +208,13 @@ class ServersSDK(BaseSDK):
         filter_disk: Optional[int] = None,
         filter_tags: Optional[str] = None,
         extra_fields_servers: Optional[str] = None,
+        page_size: Optional[int] = 20,
+        page_number: Optional[int] = 1,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
-    ) -> models.Servers:
+    ) -> Optional[models.GetServersResponse]:
         r"""List all Servers
 
         Returns a list of all servers belonging to the team.
@@ -188,6 +235,8 @@ class ServersSDK(BaseSDK):
         :param filter_disk: The disk size in Gigabytes to filter by, should be used with the following options:                               [eql] to filter for values equal to the provided value.                               [gte] to filter for values greater or equal to the provided value.                               [lte] to filter by values lower or equal to the provided value.
         :param filter_tags: The tags ids to filter by, separated by comma, e.g. `filter[tags]=tag_1,tag_2`will return servers with `tag_1` AND `tag_2`
         :param extra_fields_servers: The `credentials` are provided as extra attributes that is lazy loaded. To request it, just set `extra_fields[servers]=credentials` in the query string.
+        :param page_size: Number of items to return per page
+        :param page_number: Page number to return (starts at 1)
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -219,6 +268,8 @@ class ServersSDK(BaseSDK):
             filter_disk=filter_disk,
             filter_tags=filter_tags,
             extra_fields_servers=extra_fields_servers,
+            page_size=page_size,
+            page_number=page_number,
         )
 
         req = self._build_request_async(
@@ -259,8 +310,46 @@ class ServersSDK(BaseSDK):
             retry_config=retry_config,
         )
 
+        def next_func() -> Optional[models.GetServersResponse]:
+            body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
+            page = request.page_number if not request.page_number is None else 1
+            next_page = page + 1
+
+            if not http_res.text:
+                return None
+            results = JSONPath("$.data").parse(body)
+            if len(results) == 0 or len(results[0]) == 0:
+                return None
+            limit = request.page_size if not request.page_size is None else 20
+            if len(results[0]) < limit:
+                return None
+
+            return self.list(
+                filter_project=filter_project,
+                filter_region=filter_region,
+                filter_hostname=filter_hostname,
+                filter_created_at_gte=filter_created_at_gte,
+                filter_created_at_lte=filter_created_at_lte,
+                filter_label=filter_label,
+                filter_status=filter_status,
+                filter_plan=filter_plan,
+                filter_gpu=filter_gpu,
+                filter_ram_eql=filter_ram_eql,
+                filter_ram_gte=filter_ram_gte,
+                filter_ram_lte=filter_ram_lte,
+                filter_disk=filter_disk,
+                filter_tags=filter_tags,
+                extra_fields_servers=extra_fields_servers,
+                page_size=page_size,
+                page_number=next_page,
+                retries=retries,
+            )
+
         if utils.match_response(http_res, "200", "application/vnd.api+json"):
-            return utils.unmarshal_json(http_res.text, models.Servers)
+            return models.GetServersResponse(
+                result=utils.unmarshal_json(http_res.text, models.Servers),
+                next=next_func,
+            )
         if utils.match_response(http_res, "4XX", "*"):
             http_res_text = await utils.stream_to_text_async(http_res)
             raise models.APIError(

latitudesh_python_sdk/teamsmembers.py

@@ -1,24 +1,29 @@
 """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
 
 from .basesdk import BaseSDK
+from jsonpath import JSONPath
 from latitudesh_python_sdk import models, utils
 from latitudesh_python_sdk._hooks import HookContext
 from latitudesh_python_sdk.types import OptionalNullable, UNSET
 from latitudesh_python_sdk.utils import get_security_from_env
-from typing import Any, Mapping, Optional, Union
+from typing import Any, Dict, List, Mapping, Optional, Union
 
 
 class TeamsMembers(BaseSDK):
     def list(
         self,
         *,
+        page_size: Optional[int] = 20,
+        page_number: Optional[int] = 1,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
-    ) -> models.TeamMembers:
+    ) -> Optional[models.GetTeamMembersResponse]:
         r"""List all Team Members
 
+        :param page_size: Number of items to return per page
+        :param page_number: Page number to return (starts at 1)
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -33,12 +38,18 @@ class TeamsMembers(BaseSDK):
             base_url = server_url
         else:
             base_url = self._get_url(base_url, url_variables)
+
+        request = models.GetTeamMembersRequest(
+            page_size=page_size,
+            page_number=page_number,
+        )
+
         req = self._build_request(
             method="GET",
             path="/team/members",
             base_url=base_url,
             url_variables=url_variables,
-            request=None,
+            request=request,
             request_body_required=False,
             request_has_path_params=False,
             request_has_query_params=True,
@@ -71,8 +82,31 @@ class TeamsMembers(BaseSDK):
             retry_config=retry_config,
         )
 
+        def next_func() -> Optional[models.GetTeamMembersResponse]:
+            body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
+            page = request.page_number if not request.page_number is None else 1
+            next_page = page + 1
+
+            if not http_res.text:
+                return None
+            results = JSONPath("$.data").parse(body)
+            if len(results) == 0 or len(results[0]) == 0:
+                return None
+            limit = request.page_size if not request.page_size is None else 20
+            if len(results[0]) < limit:
+                return None
+
+            return self.list(
+                page_size=page_size,
+                page_number=next_page,
+                retries=retries,
+            )
+
         if utils.match_response(http_res, "200", "application/vnd.api+json"):
-            return utils.unmarshal_json(http_res.text, models.TeamMembers)
+            return models.GetTeamMembersResponse(
+                result=utils.unmarshal_json(http_res.text, models.TeamMembers),
+                next=next_func,
+            )
         if utils.match_response(http_res, "4XX", "*"):
             http_res_text = utils.stream_to_text(http_res)
             raise models.APIError(
@@ -96,13 +130,17 @@ class TeamsMembers(BaseSDK):
     async def list_async(
         self,
         *,
+        page_size: Optional[int] = 20,
+        page_number: Optional[int] = 1,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
-    ) -> models.TeamMembers:
+    ) -> Optional[models.GetTeamMembersResponse]:
         r"""List all Team Members
 
+        :param page_size: Number of items to return per page
+        :param page_number: Page number to return (starts at 1)
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -117,12 +155,18 @@ class TeamsMembers(BaseSDK):
             base_url = server_url
         else:
             base_url = self._get_url(base_url, url_variables)
+
+        request = models.GetTeamMembersRequest(
+            page_size=page_size,
+            page_number=page_number,
+        )
+
         req = self._build_request_async(
             method="GET",
             path="/team/members",
             base_url=base_url,
             url_variables=url_variables,
-            request=None,
+            request=request,
             request_body_required=False,
             request_has_path_params=False,
             request_has_query_params=True,
@@ -155,8 +199,31 @@ class TeamsMembers(BaseSDK):
             retry_config=retry_config,
         )
 
+        def next_func() -> Optional[models.GetTeamMembersResponse]:
+            body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
+            page = request.page_number if not request.page_number is None else 1
+            next_page = page + 1
+
+            if not http_res.text:
+                return None
+            results = JSONPath("$.data").parse(body)
+            if len(results) == 0 or len(results[0]) == 0:
+                return None
+            limit = request.page_size if not request.page_size is None else 20
+            if len(results[0]) < limit:
+                return None
+
+            return self.list(
+                page_size=page_size,
+                page_number=next_page,
+                retries=retries,
+            )
+
         if utils.match_response(http_res, "200", "application/vnd.api+json"):
-            return utils.unmarshal_json(http_res.text, models.TeamMembers)
+            return models.GetTeamMembersResponse(
+                result=utils.unmarshal_json(http_res.text, models.TeamMembers),
+                next=next_func,
+            )
         if utils.match_response(http_res, "4XX", "*"):
             http_res_text = await utils.stream_to_text_async(http_res)
             raise models.APIError(

latitudesh_python_sdk/utils/__init__.py

@@ -1,6 +1,7 @@
 """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
 
 from .annotations import get_discriminator
+from .datetimes import parse_datetime
 from .enums import OpenEnumMeta
 from .headers import get_headers, get_response_headers
 from .metadata import (

latitudesh_python_sdk/utils/datetimes.py

@@ -0,0 +1,23 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from datetime import datetime
+import sys
+
+
+def parse_datetime(datetime_string: str) -> datetime:
+    """
+    Convert a RFC 3339 / ISO 8601 formatted string into a datetime object.
+    Python versions 3.11 and later support parsing RFC 3339 directly with
+    datetime.fromisoformat(), but for earlier versions, this function
+    encapsulates the necessary extra logic.
+    """
+    # Python 3.11 and later can parse RFC 3339 directly
+    if sys.version_info >= (3, 11):
+        return datetime.fromisoformat(datetime_string)
+    
+    # For Python 3.10 and earlier, a common ValueError is trailing 'Z' suffix,
+    # so fix that upfront.
+    if datetime_string.endswith("Z"):
+        datetime_string = datetime_string[:-1] + "+00:00"
+
+    return datetime.fromisoformat(datetime_string)

latitudesh_python_sdk/utils/serializers.py

@@ -1,13 +1,16 @@
 """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
 
 from decimal import Decimal
+import functools
 import json
-from typing import Any, Dict, List, Union, get_args
-import httpx
+import typing
+from typing import Any, Dict, List, Tuple, Union, get_args
+import typing_extensions
 from typing_extensions import get_origin
+
+import httpx
 from pydantic import ConfigDict, create_model
 from pydantic_core import from_json
-from typing_inspection.typing_objects import is_union
 
 from ..types.basemodel import BaseModel, Nullable, OptionalNullable, Unset
 
@@ -185,6 +188,13 @@ def is_nullable(field):
     return False
 
 
+def is_union(obj: object) -> bool:
+    """
+    Returns True if the given object is a typing.Union or typing_extensions.Union.
+    """
+    return any(obj is typing_obj for typing_obj in _get_typing_objects_by_name_of("Union"))
+
+
 def stream_to_text(stream: httpx.Response) -> str:
     return "".join(stream.iter_text())
 
@@ -217,3 +227,22 @@ def _contains_pydantic_model(data: Any) -> bool:
         return any(_contains_pydantic_model(value) for value in data.values())
 
     return False
+
+
+@functools.cache
+def _get_typing_objects_by_name_of(name: str) -> Tuple[Any, ...]:
+    """
+    Get typing objects by name from typing and typing_extensions.
+    Reference: https://typing-extensions.readthedocs.io/en/latest/#runtime-use-of-types
+    """
+    result = tuple(
+        getattr(module, name)
+        for module in (typing, typing_extensions)
+        if hasattr(module, name)
+    )
+    if not result:
+        raise ValueError(
+            f"Neither typing nor typing_extensions has an object called {name!r}"
+        )
+    return result
+

{latitudesh_python_sdk-0.0.8.dist-info → latitudesh_python_sdk-1.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: latitudesh-python-sdk
-Version: 0.0.8
+Version: 1.1.0
 Summary: Python Client SDK Generated by Speakeasy.
 Author: Speakeasy
 Requires-Python: >=3.9
@@ -10,11 +10,9 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: eval-type-backport (>=0.2.0)
 Requires-Dist: httpx (>=0.28.1)
-Requires-Dist: pydantic (>=2.10.3)
-Requires-Dist: python-dateutil (>=2.8.2)
-Requires-Dist: typing-inspection (>=0.4.0)
+Requires-Dist: jsonpath-python (>=1.0.6)
+Requires-Dist: pydantic (>=2.11.2)
 Project-URL: Repository, https://github.com/latitudesh/latitudesh-python-sdk.git
 Description-Content-Type: text/markdown
 
@@ -45,6 +43,7 @@ Latitude.sh API: The Latitude.sh API is a RESTful API to manage your Latitude.sh
   * [SDK Example Usage](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/#sdk-example-usage)
   * [Authentication](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/#authentication)
   * [Available Resources and Operations](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/#available-resources-and-operations)
+  * [Pagination](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/#pagination)
   * [Retries](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/#retries)
   * [Error Handling](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/#error-handling)
   * [Server Selection](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/#server-selection)
@@ -424,6 +423,33 @@ with Latitudesh(
 </details>
 <!-- End Available Resources and Operations [operations] -->
 
+<!-- Start Pagination [pagination] -->
+## Pagination
+
+Some of the endpoints in this SDK support pagination. To use pagination, you make your SDK calls as usual, but the
+returned response object will have a `Next` method that can be called to pull down the next group of results. If the
+return value of `Next` is `None`, then there are no more pages to be fetched.
+
+Here's an example of one such pagination call:
+```python
+from latitudesh_python_sdk import Latitudesh
+import os
+
+
+with Latitudesh(
+    bearer=os.getenv("LATITUDESH_BEARER", ""),
+) as latitudesh:
+
+    res = latitudesh.events.list()
+
+    while res is not None:
+        # Handle items
+
+        res = res.next()
+
+```
+<!-- End Pagination [pagination] -->
+
 <!-- Start Retries [retries] -->
 ## Retries