python-zendesk-sdk 0.8.0__tar.gz → 0.11.0__tar.gz

{python_zendesk_sdk-0.8.0 → python_zendesk_sdk-0.11.0}/.gitignore

@@ -186,6 +186,7 @@ Thumbs.db
 
 # Debug files
 debug.py
+debug_*.py
 
 # Local directories
 .claude/

{python_zendesk_sdk-0.8.0 → python_zendesk_sdk-0.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-zendesk-sdk
-Version: 0.8.0
+Version: 0.11.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
@@ -230,8 +230,32 @@ user = await client.users.merge(source_id, target_id)  # Merge into target
 
 ### Organizations
 ```python
-org = await client.organizations.get(org_id)     # Get organization by ID
+# Read
+org = await client.organizations.get(org_id)     # Get organization by ID (cached)
 paginator = client.organizations.list()          # List organizations (paginator)
+
+# Create
+org = await client.organizations.create(
+    name="Acme Corp",
+    domain_names=["acme.com"],
+    tags=["enterprise"],
+    organization_fields={"plan": "premium"},
+)
+org = await client.organizations.create_or_update(  # Upsert by external_id
+    name="Acme Corp",
+    external_id="acme-123",
+)
+
+# Update
+org = await client.organizations.update(
+    org_id,
+    name="Acme Corporation",
+    tags=["enterprise", "vip"],
+    organization_fields={"plan": "enterprise"},
+)
+
+# Delete
+await client.organizations.delete(org_id)
 ```
 
 ### Groups
@@ -265,6 +289,7 @@ await client.groups.delete(group_id)
 ```python
 # Read
 ticket = await client.tickets.get(ticket_id)           # Get ticket by ID
+tickets = await client.tickets.get_many([id1, id2])    # Get multiple tickets (batch)
 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)
@@ -294,9 +319,16 @@ await client.tickets.delete(ticket_id)
 ### Comments (nested under tickets)
 ```python
 paginator = client.tickets.comments.list(ticket_id)    # List comments (paginator)
+result = await client.tickets.comments.get_last(ticket_id)  # Last comment + author
 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)
+
+# Get last comment with author (single API call)
+result = await client.tickets.comments.get_last(ticket_id)
+if result:
+    comment, author = result
+    print(f"{author.name}: {comment.body}")
 ```
 
 ### Tags (nested under tickets)
@@ -327,9 +359,12 @@ Load tickets with all related data (comments, users, field definitions) in minim
 ```python
 from zendesk_sdk import SearchQueryConfig
 
-# Get ticket with all related data
+# Get single ticket with all related data
 enriched = await client.tickets.get_enriched(12345)
 
+# Batch: get multiple enriched tickets (much faster than calling get_enriched in a loop)
+enriched_list = await client.tickets.get_many_enriched([12345, 12346, 12347])
+
 print(f"Ticket: {enriched.ticket.subject}")
 print(f"Requester: {enriched.requester.name}")
 print(f"Assignee: {enriched.assignee.name if enriched.assignee else 'Unassigned'}")
@@ -489,7 +524,7 @@ Access Help Center (Guide) via `client.help_center` namespace:
 ```python
 cat = await client.help_center.categories.get(category_id)
 paginator = client.help_center.categories.list()              # Paginator
-cat = await client.help_center.categories.create(name, description)
+cat = await client.help_center.categories.create(name, description=description)
 cat = await client.help_center.categories.update(category_id, name=new_name)
 await client.help_center.categories.delete(category_id, force=True)
 ```
@@ -499,7 +534,7 @@ await client.help_center.categories.delete(category_id, force=True)
 sec = await client.help_center.sections.get(section_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.create(category_id, name, description=description)
 sec = await client.help_center.sections.update(section_id, name=new_name)
 await client.help_center.sections.delete(section_id, force=True)
 ```
@@ -675,6 +710,7 @@ client.users.get.cache_invalidate(user_id)
 See the `examples/` directory for complete usage examples:
 - `basic_usage.py` - Basic configuration and API operations
 - `users.py` - Users CRUD (create, update, delete, suspend, passwords)
+- `organizations.py` - Organizations CRUD (create, update, delete, upsert)
 - `groups.py` - Groups CRUD (create, update, delete, list)
 - `search.py` - Type-safe search with SearchQueryConfig
 - `pagination_example.py` - Working with paginated results

{python_zendesk_sdk-0.8.0 → python_zendesk_sdk-0.11.0}/README.md

@@ -192,8 +192,32 @@ user = await client.users.merge(source_id, target_id)  # Merge into target
 
 ### Organizations
 ```python
-org = await client.organizations.get(org_id)     # Get organization by ID
+# Read
+org = await client.organizations.get(org_id)     # Get organization by ID (cached)
 paginator = client.organizations.list()          # List organizations (paginator)
+
+# Create
+org = await client.organizations.create(
+    name="Acme Corp",
+    domain_names=["acme.com"],
+    tags=["enterprise"],
+    organization_fields={"plan": "premium"},
+)
+org = await client.organizations.create_or_update(  # Upsert by external_id
+    name="Acme Corp",
+    external_id="acme-123",
+)
+
+# Update
+org = await client.organizations.update(
+    org_id,
+    name="Acme Corporation",
+    tags=["enterprise", "vip"],
+    organization_fields={"plan": "enterprise"},
+)
+
+# Delete
+await client.organizations.delete(org_id)
 ```
 
 ### Groups
@@ -227,6 +251,7 @@ await client.groups.delete(group_id)
 ```python
 # Read
 ticket = await client.tickets.get(ticket_id)           # Get ticket by ID
+tickets = await client.tickets.get_many([id1, id2])    # Get multiple tickets (batch)
 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)
@@ -256,9 +281,16 @@ await client.tickets.delete(ticket_id)
 ### Comments (nested under tickets)
 ```python
 paginator = client.tickets.comments.list(ticket_id)    # List comments (paginator)
+result = await client.tickets.comments.get_last(ticket_id)  # Last comment + author
 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)
+
+# Get last comment with author (single API call)
+result = await client.tickets.comments.get_last(ticket_id)
+if result:
+    comment, author = result
+    print(f"{author.name}: {comment.body}")
 ```
 
 ### Tags (nested under tickets)
@@ -289,9 +321,12 @@ Load tickets with all related data (comments, users, field definitions) in minim
 ```python
 from zendesk_sdk import SearchQueryConfig
 
-# Get ticket with all related data
+# Get single ticket with all related data
 enriched = await client.tickets.get_enriched(12345)
 
+# Batch: get multiple enriched tickets (much faster than calling get_enriched in a loop)
+enriched_list = await client.tickets.get_many_enriched([12345, 12346, 12347])
+
 print(f"Ticket: {enriched.ticket.subject}")
 print(f"Requester: {enriched.requester.name}")
 print(f"Assignee: {enriched.assignee.name if enriched.assignee else 'Unassigned'}")
@@ -451,7 +486,7 @@ Access Help Center (Guide) via `client.help_center` namespace:
 ```python
 cat = await client.help_center.categories.get(category_id)
 paginator = client.help_center.categories.list()              # Paginator
-cat = await client.help_center.categories.create(name, description)
+cat = await client.help_center.categories.create(name, description=description)
 cat = await client.help_center.categories.update(category_id, name=new_name)
 await client.help_center.categories.delete(category_id, force=True)
 ```
@@ -461,7 +496,7 @@ await client.help_center.categories.delete(category_id, force=True)
 sec = await client.help_center.sections.get(section_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.create(category_id, name, description=description)
 sec = await client.help_center.sections.update(section_id, name=new_name)
 await client.help_center.sections.delete(section_id, force=True)
 ```
@@ -637,6 +672,7 @@ client.users.get.cache_invalidate(user_id)
 See the `examples/` directory for complete usage examples:
 - `basic_usage.py` - Basic configuration and API operations
 - `users.py` - Users CRUD (create, update, delete, suspend, passwords)
+- `organizations.py` - Organizations CRUD (create, update, delete, upsert)
 - `groups.py` - Groups CRUD (create, update, delete, list)
 - `search.py` - Type-safe search with SearchQueryConfig
 - `pagination_example.py` - Working with paginated results

{python_zendesk_sdk-0.8.0 → python_zendesk_sdk-0.11.0}/examples/enriched_tickets.py

@@ -2,6 +2,7 @@
 
 This example demonstrates:
 - Loading tickets with all related data (comments, users, field definitions)
+- Batch loading multiple enriched tickets with get_many_enriched()
 - Using EnrichedTicket for efficient data access
 - Accessing custom field values with human-readable names
 - Minimizing API requests with batch loading
@@ -60,6 +61,15 @@ async def main() -> None:
         if field:
             print(f"Field type: {field.type}, Required: {field.required}")
 
+        # ==================== Last comment shortcut ====================
+
+        # Get just the last comment with its author (single API call)
+        result = await client.tickets.comments.get_last(12345)
+        if result:
+            comment, author = result
+            author_name = author.name if author else "Unknown"
+            print(f"\nLast comment by {author_name}: {comment.body[:80]}")
+
         # ==================== Comments with authors ====================
 
         # Process comments with author information
@@ -72,6 +82,23 @@ async def main() -> None:
             else:
                 print(f"  - Unknown: {body_preview}")
 
+        # ==================== Batch enriched tickets ====================
+
+        # Load multiple tickets with all related data at once
+        # Much more efficient than calling get_enriched() in a loop:
+        # - 1 API call for all tickets (show_many)
+        # - 1 API call for all users (show_many)
+        # - 1 API call for field definitions
+        # - N parallel API calls for comments (one per ticket)
+        ticket_ids = [12345, 12346, 12347]
+        enriched_list = await client.tickets.get_many_enriched(ticket_ids)
+
+        print(f"\n--- Batch loaded {len(enriched_list)} enriched tickets ---")
+        for item in enriched_list:
+            print(f"  #{item.ticket.id}: {item.ticket.subject}")
+            print(f"    Requester: {item.requester.name if item.requester else 'N/A'}")
+            print(f"    Comments: {len(item.comments)}")
+
         # ==================== Search with enrichment ====================
 
         # Search for tickets and load all related data

python_zendesk_sdk-0.11.0/examples/organizations.py

@@ -0,0 +1,110 @@
+"""Organizations API example for Zendesk SDK.
+
+This example demonstrates:
+- Reading organizations (get, list)
+- Creating organizations
+- Updating organizations
+- Upserting organizations (create_or_update)
+- Deleting organizations
+"""
+
+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:
+        # ==================== Read Operations ====================
+
+        print("=== Read Operations ===")
+
+        # Get organization by ID (cached)
+        org = await client.organizations.get(12345)
+        print(f"Organization: {org.name}")
+        print(f"  Domains: {org.domain_names}")
+        print(f"  Tags: {org.tags}")
+
+        # List all organizations with pagination
+        print("\nAll organizations:")
+        async for org in client.organizations.list(limit=10):
+            print(f"  {org.id}: {org.name}")
+
+        # Collect organizations to list
+        orgs = await client.organizations.list(limit=50).collect()
+        print(f"\nCollected {len(orgs)} organizations")
+
+        # ==================== Create Operations ====================
+
+        print("\n=== Create Operations ===")
+
+        # Create minimal organization
+        new_org = await client.organizations.create(name="Acme Corp")
+        print(f"Created organization: {new_org.id} - {new_org.name}")
+
+        # Create organization with all options
+        detailed_org = await client.organizations.create(
+            name="Enterprise Client",
+            domain_names=["enterprise.com", "enterprise.io"],
+            details="123 Business Ave, Suite 100",
+            notes="VIP customer, priority support",
+            tags=["enterprise", "vip"],
+            group_id=12345,
+            shared_tickets=True,
+            shared_comments=True,
+            organization_fields={"plan": "premium", "industry": "tech"},
+        )
+        print(f"Created detailed org: {detailed_org.id} - {detailed_org.name}")
+
+        # ==================== Update Operations ====================
+
+        print("\n=== Update Operations ===")
+
+        # Update tags only
+        updated = await client.organizations.update(
+            new_org.id,
+            tags=["enterprise", "partner"],
+        )
+        print(f"Updated tags: {updated.tags}")
+
+        # Update multiple fields
+        updated = await client.organizations.update(
+            new_org.id,
+            name="Acme Corporation",
+            domain_names=["acme.com", "acme.io"],
+            organization_fields={"plan": "enterprise"},
+        )
+        print(f"Updated org: {updated.name} (domains={updated.domain_names})")
+
+        # ==================== Upsert Operations ====================
+
+        print("\n=== Upsert Operations ===")
+
+        # Create or update by external_id
+        upserted = await client.organizations.create_or_update(
+            name="Synced Organization",
+            external_id="CRM-12345",
+            tags=["synced"],
+            organization_fields={"source": "crm"},
+        )
+        print(f"Upserted org: {upserted.id} - {upserted.name}")
+
+        # ==================== Delete Operations ====================
+
+        print("\n=== Delete Operations ===")
+
+        await client.organizations.delete(new_org.id)
+        print(f"Deleted organization: {new_org.id}")
+
+        await client.organizations.delete(detailed_org.id)
+        print(f"Deleted organization: {detailed_org.id}")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

{python_zendesk_sdk-0.8.0 → python_zendesk_sdk-0.11.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-zendesk-sdk"
-version = "0.8.0"
+version = "0.11.0"
 description = "Modern Python SDK for Zendesk API"
 authors = [
     {name = "bormog"}

{python_zendesk_sdk-0.8.0 → python_zendesk_sdk-0.11.0}/src/zendesk_sdk/__init__.py

@@ -5,7 +5,7 @@ This package provides a clean, async-first interface to the Zendesk API
 with full type safety and comprehensive error handling.
 """
 
-__version__ = "0.8.0"
+__version__ = "0.11.0"
 
 from .client import ZendeskClient
 from .clients import (

{python_zendesk_sdk-0.8.0 → python_zendesk_sdk-0.11.0}/src/zendesk_sdk/client.py

@@ -95,6 +95,23 @@ class ZendeskClient:
         Example:
             org = await client.organizations.get(12345)
             paginator = await client.organizations.list()
+
+            # Create an organization
+            org = await client.organizations.create(
+                name="Acme Corp", domain_names=["acme.com"]
+            )
+
+            # Update an organization
+            org = await client.organizations.update(12345, tags=["vip"])
+
+            # Upsert by external_id
+            org = await client.organizations.create_or_update(
+                name="Acme Corp", external_id="acme-123"
+            )
+
+            # Delete an organization
+            await client.organizations.delete(12345)
+
             # For search use client.search.organizations()
         """
         from .clients import OrganizationsClient