python-zendesk-sdk 0.3.1__tar.gz → 0.4.0__tar.gz

{python_zendesk_sdk-0.3.1 → python_zendesk_sdk-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-zendesk-sdk
-Version: 0.3.1
+Version: 0.4.0
 Summary: Modern Python SDK for Zendesk API
 Project-URL: Homepage, https://github.com/bormog/python-zendesk-sdk
 Project-URL: Repository, https://github.com/bormog/python-zendesk-sdk
@@ -40,7 +40,7 @@ Description-Content-Type: text/markdown
 
 [![PyPI](https://img.shields.io/pypi/v/python-zendesk-sdk)](https://pypi.org/project/python-zendesk-sdk/)
 [![Python](https://img.shields.io/pypi/pyversions/python-zendesk-sdk)](https://pypi.org/project/python-zendesk-sdk/)
-[![PyPI Downloads](https://static.pepy.tech/personalized-badge/python-zendesk-sdk?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/python-zendesk-sdk)
+[![PyPI Downloads](https://static.pepy.tech/personalized-badge/python-zendesk-sdk?period=total&units=INTERNATIONAL_SYSTEM&left_color=GREY&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/python-zendesk-sdk)
 [![License](https://img.shields.io/github/license/bormog/python-zendesk-sdk)](https://github.com/bormog/python-zendesk-sdk/blob/main/LICENSE)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
 [![Pydantic v2](https://img.shields.io/badge/Pydantic-v2-blue)](https://docs.pydantic.dev/)
@@ -122,18 +122,15 @@ async def main():
     )
 
     async with ZendeskClient(config) as client:
-        # Get users with pagination
-        paginator = await client.users.list(per_page=10)
-        users = await paginator.get_page()
-
-        for user in users:
-            print(f"User: {user['name']} ({user['email']})")
+        # Get a single user
+        user = await client.users.get(12345)
+        print(f"User: {user.name} ({user.email})")
 
         # Get specific ticket
         ticket = await client.tickets.get(12345)
         print(f"Ticket: {ticket.subject}")
 
-        # Search tickets (async iterator with auto-pagination)
+        # Search tickets with pagination
         async for ticket in client.search.tickets("status:open priority:high", limit=10):
             print(f"High priority: {ticket.subject}")
 
@@ -164,31 +161,48 @@ config = ZendeskConfig()  # Will load from environment
 
 ## API Methods
 
+### Pagination
+
+All list methods return **Paginator** objects. Three ways to work with them:
+
+```python
+# 1. Get specific page
+paginator = client.users.list(per_page=20)
+users = await paginator.get_page(2)  # Get page 2
+
+# 2. Iterate through all items
+async for user in client.users.list():
+    print(user.name)
+
+# 3. Collect to list
+users = await client.users.list(limit=50).collect()
+```
+
 ### Users
 ```python
 user = await client.users.get(user_id)           # Get user by ID
-paginator = await client.users.list()            # List users with pagination
 user = await client.users.by_email(email)        # Get user by email
 users = await client.users.get_many([id1, id2])  # Get multiple users
+paginator = client.users.list()                  # List users (paginator)
 ```
 
 ### Organizations
 ```python
 org = await client.organizations.get(org_id)     # Get organization by ID
-paginator = await client.organizations.list()    # List organizations
+paginator = client.organizations.list()          # List organizations (paginator)
 ```
 
 ### Tickets
 ```python
 ticket = await client.tickets.get(ticket_id)           # Get ticket by ID
-paginator = await client.tickets.list()                # List tickets
-tickets = await client.tickets.for_user(user_id)       # Get user's tickets
-tickets = await client.tickets.for_organization(org_id) # Get org's tickets
+paginator = client.tickets.list()                      # List tickets (paginator)
+paginator = client.tickets.for_user(user_id)           # User's tickets (paginator)
+paginator = client.tickets.for_organization(org_id)    # Org's tickets (paginator)
 ```
 
 ### Comments (nested under tickets)
 ```python
-comments = await client.tickets.comments.list(ticket_id)
+paginator = client.tickets.comments.list(ticket_id)    # List comments (paginator)
 ticket = await client.tickets.comments.add(ticket_id, body, public=False)
 await client.tickets.comments.make_private(ticket_id, comment_id)
 comment = await client.tickets.comments.redact(ticket_id, comment_id, text)
@@ -243,14 +257,14 @@ await client.tickets.comments.add(ticket_id, "See attached", uploads=[token])
 
 ### Search
 
-All search methods return **async iterators** with automatic pagination.
+All search methods return **Paginator** objects with the same interface as list methods.
 
 #### Raw Queries (Zendesk syntax)
 
 Use the same query syntax as in Zendesk UI — it just works:
 
 ```python
-# Tickets
+# Tickets - iterate through results
 async for ticket in client.search.tickets("status:open priority:high"):
     print(ticket.subject)
 
@@ -262,8 +276,8 @@ async for user in client.search.users("role:admin"):
 async for org in client.search.organizations("tags:enterprise"):
     print(org.name)
 
-# Collect to list
-all_tickets = [t async for t in client.search.tickets("status:pending", limit=100)]
+# Collect to list with limit
+tickets = await client.search.tickets("status:pending", limit=100).collect()
 
 # Search with enrichment (loads comments + users)
 async for item in client.tickets.search_enriched("status:open", limit=10):
@@ -363,7 +377,7 @@ Access Help Center (Guide) via `client.help_center` namespace:
 #### Categories
 ```python
 cat = await client.help_center.categories.get(category_id)
-paginator = await client.help_center.categories.list()
+paginator = client.help_center.categories.list()              # Paginator
 cat = await client.help_center.categories.create(name, description)
 cat = await client.help_center.categories.update(category_id, name=new_name)
 await client.help_center.categories.delete(category_id, force=True)
@@ -372,8 +386,8 @@ await client.help_center.categories.delete(category_id, force=True)
 #### Sections
 ```python
 sec = await client.help_center.sections.get(section_id)
-paginator = await client.help_center.sections.list()
-paginator = await client.help_center.sections.for_category(category_id)
+paginator = client.help_center.sections.list()                # Paginator
+paginator = client.help_center.sections.for_category(category_id)
 sec = await client.help_center.sections.create(category_id, name, description)
 sec = await client.help_center.sections.update(section_id, name=new_name)
 await client.help_center.sections.delete(section_id, force=True)
@@ -382,9 +396,9 @@ await client.help_center.sections.delete(section_id, force=True)
 #### Articles
 ```python
 art = await client.help_center.articles.get(article_id)
-paginator = await client.help_center.articles.list()
-paginator = await client.help_center.articles.for_section(section_id)
-paginator = await client.help_center.articles.for_category(category_id)
+paginator = client.help_center.articles.list()                # Paginator
+paginator = client.help_center.articles.for_section(section_id)
+paginator = client.help_center.articles.for_category(category_id)
 results = await client.help_center.articles.search(query)
 art = await client.help_center.articles.create(section_id, title, body=html)
 art = await client.help_center.articles.update(article_id, title=new_title)
@@ -397,8 +411,8 @@ async with ZendeskClient(config) as client:
     hc = client.help_center
 
     # Get permission_group_id from existing article (required for article creation)
-    existing = await (await hc.articles.list(per_page=1)).get_page()
-    article_details = await hc.articles.get(existing[0]["id"])
+    existing = await hc.articles.list(per_page=1).get_page()
+    article_details = await hc.articles.get(existing[0].id)
     permission_group_id = article_details.permission_group_id
 
     # Create category -> section -> article hierarchy

{python_zendesk_sdk-0.3.1 → python_zendesk_sdk-0.4.0}/README.md

@@ -2,7 +2,7 @@
 
 [![PyPI](https://img.shields.io/pypi/v/python-zendesk-sdk)](https://pypi.org/project/python-zendesk-sdk/)
 [![Python](https://img.shields.io/pypi/pyversions/python-zendesk-sdk)](https://pypi.org/project/python-zendesk-sdk/)
-[![PyPI Downloads](https://static.pepy.tech/personalized-badge/python-zendesk-sdk?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/python-zendesk-sdk)
+[![PyPI Downloads](https://static.pepy.tech/personalized-badge/python-zendesk-sdk?period=total&units=INTERNATIONAL_SYSTEM&left_color=GREY&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/python-zendesk-sdk)
 [![License](https://img.shields.io/github/license/bormog/python-zendesk-sdk)](https://github.com/bormog/python-zendesk-sdk/blob/main/LICENSE)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
 [![Pydantic v2](https://img.shields.io/badge/Pydantic-v2-blue)](https://docs.pydantic.dev/)
@@ -84,18 +84,15 @@ async def main():
     )
 
     async with ZendeskClient(config) as client:
-        # Get users with pagination
-        paginator = await client.users.list(per_page=10)
-        users = await paginator.get_page()
-
-        for user in users:
-            print(f"User: {user['name']} ({user['email']})")
+        # Get a single user
+        user = await client.users.get(12345)
+        print(f"User: {user.name} ({user.email})")
 
         # Get specific ticket
         ticket = await client.tickets.get(12345)
         print(f"Ticket: {ticket.subject}")
 
-        # Search tickets (async iterator with auto-pagination)
+        # Search tickets with pagination
         async for ticket in client.search.tickets("status:open priority:high", limit=10):
             print(f"High priority: {ticket.subject}")
 
@@ -126,31 +123,48 @@ config = ZendeskConfig()  # Will load from environment
 
 ## API Methods
 
+### Pagination
+
+All list methods return **Paginator** objects. Three ways to work with them:
+
+```python
+# 1. Get specific page
+paginator = client.users.list(per_page=20)
+users = await paginator.get_page(2)  # Get page 2
+
+# 2. Iterate through all items
+async for user in client.users.list():
+    print(user.name)
+
+# 3. Collect to list
+users = await client.users.list(limit=50).collect()
+```
+
 ### Users
 ```python
 user = await client.users.get(user_id)           # Get user by ID
-paginator = await client.users.list()            # List users with pagination
 user = await client.users.by_email(email)        # Get user by email
 users = await client.users.get_many([id1, id2])  # Get multiple users
+paginator = client.users.list()                  # List users (paginator)
 ```
 
 ### Organizations
 ```python
 org = await client.organizations.get(org_id)     # Get organization by ID
-paginator = await client.organizations.list()    # List organizations
+paginator = client.organizations.list()          # List organizations (paginator)
 ```
 
 ### Tickets
 ```python
 ticket = await client.tickets.get(ticket_id)           # Get ticket by ID
-paginator = await client.tickets.list()                # List tickets
-tickets = await client.tickets.for_user(user_id)       # Get user's tickets
-tickets = await client.tickets.for_organization(org_id) # Get org's tickets
+paginator = client.tickets.list()                      # List tickets (paginator)
+paginator = client.tickets.for_user(user_id)           # User's tickets (paginator)
+paginator = client.tickets.for_organization(org_id)    # Org's tickets (paginator)
 ```
 
 ### Comments (nested under tickets)
 ```python
-comments = await client.tickets.comments.list(ticket_id)
+paginator = client.tickets.comments.list(ticket_id)    # List comments (paginator)
 ticket = await client.tickets.comments.add(ticket_id, body, public=False)
 await client.tickets.comments.make_private(ticket_id, comment_id)
 comment = await client.tickets.comments.redact(ticket_id, comment_id, text)
@@ -205,14 +219,14 @@ await client.tickets.comments.add(ticket_id, "See attached", uploads=[token])
 
 ### Search
 
-All search methods return **async iterators** with automatic pagination.
+All search methods return **Paginator** objects with the same interface as list methods.
 
 #### Raw Queries (Zendesk syntax)
 
 Use the same query syntax as in Zendesk UI — it just works:
 
 ```python
-# Tickets
+# Tickets - iterate through results
 async for ticket in client.search.tickets("status:open priority:high"):
     print(ticket.subject)
 
@@ -224,8 +238,8 @@ async for user in client.search.users("role:admin"):
 async for org in client.search.organizations("tags:enterprise"):
     print(org.name)
 
-# Collect to list
-all_tickets = [t async for t in client.search.tickets("status:pending", limit=100)]
+# Collect to list with limit
+tickets = await client.search.tickets("status:pending", limit=100).collect()
 
 # Search with enrichment (loads comments + users)
 async for item in client.tickets.search_enriched("status:open", limit=10):
@@ -325,7 +339,7 @@ Access Help Center (Guide) via `client.help_center` namespace:
 #### Categories
 ```python
 cat = await client.help_center.categories.get(category_id)
-paginator = await client.help_center.categories.list()
+paginator = client.help_center.categories.list()              # Paginator
 cat = await client.help_center.categories.create(name, description)
 cat = await client.help_center.categories.update(category_id, name=new_name)
 await client.help_center.categories.delete(category_id, force=True)
@@ -334,8 +348,8 @@ await client.help_center.categories.delete(category_id, force=True)
 #### Sections
 ```python
 sec = await client.help_center.sections.get(section_id)
-paginator = await client.help_center.sections.list()
-paginator = await client.help_center.sections.for_category(category_id)
+paginator = client.help_center.sections.list()                # Paginator
+paginator = client.help_center.sections.for_category(category_id)
 sec = await client.help_center.sections.create(category_id, name, description)
 sec = await client.help_center.sections.update(section_id, name=new_name)
 await client.help_center.sections.delete(section_id, force=True)
@@ -344,9 +358,9 @@ await client.help_center.sections.delete(section_id, force=True)
 #### Articles
 ```python
 art = await client.help_center.articles.get(article_id)
-paginator = await client.help_center.articles.list()
-paginator = await client.help_center.articles.for_section(section_id)
-paginator = await client.help_center.articles.for_category(category_id)
+paginator = client.help_center.articles.list()                # Paginator
+paginator = client.help_center.articles.for_section(section_id)
+paginator = client.help_center.articles.for_category(category_id)
 results = await client.help_center.articles.search(query)
 art = await client.help_center.articles.create(section_id, title, body=html)
 art = await client.help_center.articles.update(article_id, title=new_title)
@@ -359,8 +373,8 @@ async with ZendeskClient(config) as client:
     hc = client.help_center
 
     # Get permission_group_id from existing article (required for article creation)
-    existing = await (await hc.articles.list(per_page=1)).get_page()
-    article_details = await hc.articles.get(existing[0]["id"])
+    existing = await hc.articles.list(per_page=1).get_page()
+    article_details = await hc.articles.get(existing[0].id)
     permission_group_id = article_details.permission_group_id
 
     # Create category -> section -> article hierarchy

{python_zendesk_sdk-0.3.1 → python_zendesk_sdk-0.4.0}/examples/basic_usage.py

@@ -3,6 +3,7 @@
 This example demonstrates:
 - Configuration setup
 - Basic API operations (get users, tickets, organizations)
+- Pagination basics
 - Search functionality
 """
 
@@ -41,23 +42,23 @@ async def main() -> None:
         ticket = await client.tickets.get(12345)
         print(f"Ticket: {ticket.subject} (status: {ticket.status})")
 
-        # Get ticket comments
-        comments = await client.tickets.comments.list(12345)
-        print(f"Ticket has {len(comments)} comments")
+        # Get ticket comments (returns paginator)
+        comments = await client.tickets.comments.list(12345, limit=10).collect()
+        print(f"Ticket has {len(comments)} comments (limited to 10)")
 
         # Get organization
         org = await client.organizations.get(123)
         print(f"Organization: {org.name}")
 
-        # Search for tickets (returns async iterator)
+        # Search for tickets (paginator with async iteration)
         count = 0
         async for ticket in client.search.tickets("status:open", limit=10):
             count += 1
             print(f"  Open ticket: {ticket.subject}")
         print(f"Found {count} open tickets (limited to 10)")
 
-        # Search for users (returns async iterator)
-        admins = [u async for u in client.search.users("role:admin", limit=5)]
+        # Collect search results to list
+        admins = await client.search.users("role:admin", limit=5).collect()
         print(f"Found {len(admins)} admin users (limited to 5)")
 
 

{python_zendesk_sdk-0.3.1 → python_zendesk_sdk-0.4.0}/examples/caching.py

@@ -85,9 +85,9 @@ async def demo_disabled_cache() -> None:
         print(f"Cache enabled: {config.cache.enabled}")
 
         # Both calls hit the API
-        user1 = await client.users.get(12345)
-        user2 = await client.users.get(12345)
-        print(f"Both calls hit API - no caching")
+        _ = await client.users.get(12345)
+        _ = await client.users.get(12345)
+        print("Both calls hit API - no caching")
 
         # cache_info not available when caching is disabled
         has_cache_info = hasattr(client.users.get, "cache_info")

{python_zendesk_sdk-0.3.1 → python_zendesk_sdk-0.4.0}/examples/enriched_tickets.py

@@ -19,6 +19,8 @@ async def main() -> None:
     )
 
     async with ZendeskClient(config) as client:
+        # ==================== Single enriched ticket ====================
+
         # Get a single ticket with all related data
         # This makes 2 API calls: ticket + comments (with sideloaded users)
         enriched = await client.tickets.get_enriched(12345)
@@ -48,6 +50,8 @@ async def main() -> None:
             else:
                 print(f"  - Unknown: {body_preview}")
 
+        # ==================== Search with enrichment ====================
+
         # Search for tickets and load all related data
         # This efficiently batch-loads users using show_many endpoint
         print("\n--- Searching tickets with enriched data ---")
@@ -57,25 +61,15 @@ async def main() -> None:
             print(f"  Assignee: {item.assignee.name if item.assignee else 'Unassigned'}")
             print(f"  Comments: {len(item.comments)}")
 
-        # Get organization tickets with all related data
-        print("\n--- Organization tickets ---")
-        org_tickets = await client.tickets.for_organization_enriched(
-            org_id=123,
-            per_page=10,
-        )
-
-        for item in org_tickets:
-            print(f"Ticket #{item.ticket.id}: {item.ticket.subject}")
-
-        # Get user's tickets with all related data
-        print("\n--- User tickets ---")
-        user_tickets = await client.tickets.for_user_enriched(
-            user_id=456,
-            per_page=10,
-        )
-
-        for item in user_tickets:
-            print(f"Ticket #{item.ticket.id}: {item.ticket.subject}")
+        # ==================== Collect enriched tickets ====================
+
+        # You can also collect enriched tickets to a list
+        print("\n--- Collecting enriched tickets ---")
+        enriched_tickets = [item async for item in client.tickets.search_enriched("status:pending", limit=5)]
+        print(f"Collected {len(enriched_tickets)} enriched tickets")
+
+        for item in enriched_tickets:
+            print(f"  #{item.ticket.id}: {item.ticket.subject}")
 
 
 if __name__ == "__main__":

{python_zendesk_sdk-0.3.1 → python_zendesk_sdk-0.4.0}/examples/error_handling.py

@@ -69,7 +69,7 @@ async def main() -> None:
 
         # Example: Handling specific HTTP status codes
         try:
-            ticket = await client.tickets.get(123)
+            _ = await client.tickets.get(123)
         except ZendeskHTTPException as e:
             if e.status_code == 404:
                 print("Ticket not found")
@@ -92,8 +92,9 @@ async def retry_with_backoff() -> None:
         max_attempts = 5
         for attempt in range(max_attempts):
             try:
-                result = await client.search.tickets("status:open")
-                print(f"Found {len(result)} tickets")
+                # Search returns paginator - iterate to get results
+                tickets = await client.search.tickets("status:open", limit=10).collect()
+                print(f"Found {len(tickets)} tickets")
                 break
             except ZendeskRateLimitException as e:
                 if attempt < max_attempts - 1:

{python_zendesk_sdk-0.3.1 → python_zendesk_sdk-0.4.0}/examples/help_center.py

@@ -26,34 +26,31 @@ async def main() -> None:
 
         # ==================== Reading Content ====================
 
-        # List categories with pagination
+        # List categories with pagination (no await for list())
         print("--- Categories ---")
-        categories_paginator = await hc.categories.list(per_page=10)
-        categories = await categories_paginator.get_page()
+        categories = await hc.categories.list(per_page=10).get_page()
         for cat in categories[:5]:
-            print(f"Category: {cat['name']} (ID: {cat['id']})")
+            print(f"Category: {cat.name} (ID: {cat.id})")
 
         # Get specific category
         if categories:
-            category = await hc.categories.get(categories[0]["id"])
+            category = await hc.categories.get(categories[0].id)
             print(f"\nCategory details: {category.name}")
             print(f"Description: {category.description}")
 
         # List sections (all or by category)
         print("\n--- Sections ---")
-        sections_paginator = await hc.sections.list(per_page=10)
-        sections = await sections_paginator.get_page()
+        sections = await hc.sections.list(per_page=10).get_page()
         for sec in sections[:5]:
-            print(f"Section: {sec['name']} (Category: {sec['category_id']})")
+            print(f"Section: {sec.name} (Category: {sec.category_id})")
 
         # List articles in a section
         if sections:
-            section_id = sections[0]["id"]
-            articles_paginator = await hc.articles.for_section(section_id, per_page=10)
-            articles = await articles_paginator.get_page()
+            section_id = sections[0].id
+            articles = await hc.articles.for_section(section_id, per_page=10).get_page()
             print(f"\nArticles in section {section_id}:")
             for art in articles[:5]:
-                print(f"  - {art['title']}")
+                print(f"  - {art.title}")
 
         # ==================== Search ====================
 
@@ -84,11 +81,11 @@ async def main() -> None:
         print(f"Created section: {new_section.name} (ID: {new_section.id})")
 
         # Get permission_group_id from an existing article (required for creation)
-        existing_articles = await (await hc.articles.list(per_page=1)).get_page()
+        existing_articles = await hc.articles.list(per_page=1).get_page()
         if not existing_articles:
             print("No existing articles to get permission_group_id from")
             return
-        existing = await hc.articles.get(existing_articles[0]["id"])
+        existing = await hc.articles.get(existing_articles[0].id)
         permission_group_id = existing.permission_group_id
 
         # Create an article in the section
@@ -129,20 +126,25 @@ async def main() -> None:
         await hc.categories.delete(new_category.id, force=True)
         print("Deleted category (cascade deleted section and article)")
 
-        # ==================== Pagination ====================
+        # ==================== Pagination Examples ====================
 
-        # Iterate through all articles with async for
-        print("\n--- Pagination Example ---")
-        all_articles_paginator = await hc.articles.list(per_page=10)
+        print("\n--- Pagination Examples ---")
+
+        # Iterate through all articles
         count = 0
-        async for article_data in all_articles_paginator:
+        async for article in hc.articles.list(per_page=10):
             count += 1
             if count <= 3:
-                print(f"Article {count}: {article_data['title'][:40]}...")
+                title = article.title[:40] if article.title else "Untitled"
+                print(f"Article {count}: {title}...")
             if count >= 10:
                 print(f"... and more (stopped at {count})")
                 break
 
+        # Collect articles to list
+        all_articles = await hc.articles.list(limit=50).collect()
+        print(f"Collected {len(all_articles)} articles")
+
 
 if __name__ == "__main__":
     asyncio.run(main())

python_zendesk_sdk-0.4.0/examples/pagination_example.py

@@ -0,0 +1,106 @@
+"""Pagination example for Zendesk SDK.
+
+This example demonstrates three ways to work with paginators:
+1. Get specific page
+2. Iterate through all items
+3. Collect to list
+
+All list() and search() methods return Paginator objects.
+"""
+
+import asyncio
+
+from zendesk_sdk import ZendeskClient, ZendeskConfig
+
+
+async def main() -> None:
+    config = ZendeskConfig(
+        subdomain="your-subdomain",
+        email="your-email@example.com",
+        token="your-api-token",
+    )
+
+    async with ZendeskClient(config) as client:
+        # ==================== Method 1: Get specific page ====================
+
+        print("=== Method 1: Get specific page ===")
+
+        # Create paginator (no await needed)
+        paginator = client.users.list(per_page=20)
+
+        # Get first page
+        first_page = await paginator.get_page()
+        print(f"First page: {len(first_page)} users")
+
+        # Get specific page by number
+        second_page = await paginator.get_page(page=2)
+        print(f"Second page: {len(second_page)} users")
+
+        # Check pagination info after fetching
+        if paginator.pagination_info:
+            print(f"Total count: {paginator.pagination_info.count}")
+            print(f"Has more: {paginator.pagination_info.has_more}")
+
+        # ==================== Method 2: Iterate through all ====================
+
+        print("\n=== Method 2: Iterate through all items ===")
+
+        # Iterate through all users (handles pagination automatically)
+        count = 0
+        async for user in client.users.list(per_page=100):
+            count += 1
+            if count <= 3:
+                print(f"  User: {user.name}")
+            if count >= 100:
+                print(f"  ... stopping at {count} users")
+                break
+
+        print(f"Iterated through {count} users")
+
+        # ==================== Method 3: Collect to list ====================
+
+        print("\n=== Method 3: Collect to list ===")
+
+        # Collect with limit
+        users = await client.users.list(limit=50).collect()
+        print(f"Collected {len(users)} users (limit=50)")
+
+        # Collect all (be careful with large datasets!)
+        # all_users = await client.users.list().collect()
+
+        # ==================== Pagination with search ====================
+
+        print("\n=== Pagination with search ===")
+
+        # Search also returns paginator
+        paginator = client.search.tickets("status:open", per_page=50)
+
+        # Get first page
+        open_tickets = await paginator.get_page()
+        print(f"Found {len(open_tickets)} open tickets on first page")
+
+        # Or iterate
+        async for ticket in client.search.tickets("priority:high", limit=10):
+            print(f"  High priority: {ticket.subject}")
+
+        # Or collect
+        urgent = await client.search.tickets("priority:urgent", limit=20).collect()
+        print(f"Collected {len(urgent)} urgent tickets")
+
+        # ==================== Pagination info ====================
+
+        print("\n=== Pagination info ===")
+
+        paginator = client.tickets.list(per_page=10)
+        await paginator.get_page()
+
+        info = paginator.pagination_info
+        if info:
+            print(f"Page: {info.page}")
+            print(f"Per page: {info.per_page}")
+            print(f"Total count: {info.count}")
+            print(f"Has more: {info.has_more}")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())