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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-zendesk-sdk
-Version: 0.4.0
+Version: 0.6.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
@@ -36,15 +36,15 @@ Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
 Requires-Dist: pytest>=7.0.0; extra == 'dev'
 Description-Content-Type: text/markdown
 
-# Python Zendesk SDK
+![header](https://capsule-render.vercel.app/api?type=waving&color=0:ff4400,100:ff00ff&height=200&section=header&text=python-zendesk-sdk&fontSize=50&fontColor=ffffff&fontAlignY=35&desc=Modern%20async%20SDK%20for%20Zendesk%20API&descSize=18&descAlignY=55&animation=fadeIn)
 
-[![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=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/)
-[![Async](https://img.shields.io/badge/async-first-blueviolet)](https://docs.python.org/3/library/asyncio.html)
+[![PyPI](https://img.shields.io/pypi/v/python-zendesk-sdk?color=ff00ff&logo=pypi&logoColor=white)](https://pypi.org/project/python-zendesk-sdk/)
+[![Python](https://img.shields.io/pypi/pyversions/python-zendesk-sdk?color=ff4400&logo=python&logoColor=white)](https://pypi.org/project/python-zendesk-sdk/)
+[![Downloads](https://img.shields.io/pepy/dt/python-zendesk-sdk?color=ff00ff&logo=downloads&logoColor=white)](https://pepy.tech/projects/python-zendesk-sdk)
+[![License](https://img.shields.io/github/license/bormog/python-zendesk-sdk?color=ff4400&logo=opensourceinitiative&logoColor=white)](https://github.com/bormog/python-zendesk-sdk/blob/main/LICENSE)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000?logo=python&logoColor=white)](https://github.com/psf/black)
+[![Pydantic v2](https://img.shields.io/badge/Pydantic-v2-ff00ff?logo=pydantic&logoColor=white)](https://docs.pydantic.dev/)
+[![Async](https://img.shields.io/badge/async-first-ff4400?logo=python&logoColor=white)](https://docs.python.org/3/library/asyncio.html)
 
 Modern Python SDK for Zendesk API, designed for automation and AI agents.
 
@@ -61,6 +61,7 @@ Modern Python SDK for Zendesk API, designed for automation and AI agents.
   - [Tickets](#tickets)
   - [Comments](#comments-nested-under-tickets)
   - [Tags](#tags-nested-under-tickets)
+  - [Ticket Fields](#ticket-fields)
   - [Enriched Tickets](#enriched-tickets)
   - [Attachments](#attachments)
   - [Search](#search)
@@ -194,10 +195,32 @@ paginator = client.organizations.list()          # List organizations (paginator
 
 ### Tickets
 ```python
+# Read
 ticket = await client.tickets.get(ticket_id)           # Get ticket by ID
 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)
+
+# Create
+ticket = await client.tickets.create(
+    comment_body="Customer needs help with login",
+    subject="Login Issue",
+    priority="high",                                   # low, normal, high, urgent
+    status="open",                                     # new, open, pending, hold, solved
+    ticket_type="problem",                             # question, incident, problem, task
+    tags=["login", "urgent"],
+)
+
+# Update
+ticket = await client.tickets.update(
+    ticket_id,
+    status="solved",
+    priority="normal",
+    comment={"body": "Issue resolved!", "public": True},
+)
+
+# Delete (moves to trash, recoverable for 30 days)
+await client.tickets.delete(ticket_id)
 ```
 
 ### Comments (nested under tickets)
@@ -216,9 +239,22 @@ tags = await client.tickets.tags.set(ticket_id, ["new"])  # Replace all tags
 tags = await client.tickets.tags.remove(ticket_id, ["old"]) # Remove tags
 ```
 
+### Ticket Fields
+```python
+# Get all ticket fields (system + custom)
+async for field in client.ticket_fields.list():
+    print(f"{field.title}: {field.type}")
+
+# Get specific field by ID (cached)
+field = await client.ticket_fields.get(field_id)
+
+# Find field by title (case-insensitive)
+field = await client.ticket_fields.get_by_title("Subscription")
+```
+
 ### Enriched Tickets
 
-Load tickets with all related data (comments + users) in minimum API requests:
+Load tickets with all related data (comments, users, field definitions) in minimum API requests:
 
 ```python
 from zendesk_sdk import SearchQueryConfig
@@ -234,6 +270,13 @@ for comment in enriched.comments:
     author = enriched.get_comment_author(comment)
     print(f"Comment by {author.name}: {comment.body[:50]}...")
 
+# Access custom field values with human-readable names
+field_values = enriched.get_field_values()
+print(f"Subscription: {field_values.get('Subscription')}")
+
+# Or get specific field value by ID
+value = enriched.get_field_value(360001234)
+
 # Search with all data loaded (using SearchQueryConfig)
 config = SearchQueryConfig.tickets(
     status=["open"],
@@ -455,6 +498,7 @@ The SDK provides specific exception classes for different error types:
 from zendesk_sdk.exceptions import (
     ZendeskAuthException,
     ZendeskHTTPException,
+    ZendeskPaginationException,
     ZendeskRateLimitException,
     ZendeskTimeoutException,
     ZendeskValidationException,
@@ -475,6 +519,9 @@ async with ZendeskClient(config) as client:
     except ZendeskTimeoutException as e:
         # Request timeout
         print(f"Timeout: {e.message}")
+    except ZendeskPaginationException as e:
+        # Pagination errors (e.g., Zendesk 1000 result limit)
+        print(f"Pagination error: {e.message}")
 ```
 
 ### Automatic Retry
@@ -505,6 +552,7 @@ The SDK includes built-in caching for frequently accessed resources. Caching is
 |----------|-----|----------|
 | Users | 5 min | 1000 |
 | Organizations | 10 min | 500 |
+| Ticket Fields | 30 min | 200 |
 | Articles | 15 min | 500 |
 | Categories | 30 min | 200 |
 | Sections | 30 min | 200 |

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

@@ -1,12 +1,12 @@
-# Python Zendesk SDK
+![header](https://capsule-render.vercel.app/api?type=waving&color=0:ff4400,100:ff00ff&height=200&section=header&text=python-zendesk-sdk&fontSize=50&fontColor=ffffff&fontAlignY=35&desc=Modern%20async%20SDK%20for%20Zendesk%20API&descSize=18&descAlignY=55&animation=fadeIn)
 
-[![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=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/)
-[![Async](https://img.shields.io/badge/async-first-blueviolet)](https://docs.python.org/3/library/asyncio.html)
+[![PyPI](https://img.shields.io/pypi/v/python-zendesk-sdk?color=ff00ff&logo=pypi&logoColor=white)](https://pypi.org/project/python-zendesk-sdk/)
+[![Python](https://img.shields.io/pypi/pyversions/python-zendesk-sdk?color=ff4400&logo=python&logoColor=white)](https://pypi.org/project/python-zendesk-sdk/)
+[![Downloads](https://img.shields.io/pepy/dt/python-zendesk-sdk?color=ff00ff&logo=downloads&logoColor=white)](https://pepy.tech/projects/python-zendesk-sdk)
+[![License](https://img.shields.io/github/license/bormog/python-zendesk-sdk?color=ff4400&logo=opensourceinitiative&logoColor=white)](https://github.com/bormog/python-zendesk-sdk/blob/main/LICENSE)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000?logo=python&logoColor=white)](https://github.com/psf/black)
+[![Pydantic v2](https://img.shields.io/badge/Pydantic-v2-ff00ff?logo=pydantic&logoColor=white)](https://docs.pydantic.dev/)
+[![Async](https://img.shields.io/badge/async-first-ff4400?logo=python&logoColor=white)](https://docs.python.org/3/library/asyncio.html)
 
 Modern Python SDK for Zendesk API, designed for automation and AI agents.
 
@@ -23,6 +23,7 @@ Modern Python SDK for Zendesk API, designed for automation and AI agents.
   - [Tickets](#tickets)
   - [Comments](#comments-nested-under-tickets)
   - [Tags](#tags-nested-under-tickets)
+  - [Ticket Fields](#ticket-fields)
   - [Enriched Tickets](#enriched-tickets)
   - [Attachments](#attachments)
   - [Search](#search)
@@ -156,10 +157,32 @@ paginator = client.organizations.list()          # List organizations (paginator
 
 ### Tickets
 ```python
+# Read
 ticket = await client.tickets.get(ticket_id)           # Get ticket by ID
 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)
+
+# Create
+ticket = await client.tickets.create(
+    comment_body="Customer needs help with login",
+    subject="Login Issue",
+    priority="high",                                   # low, normal, high, urgent
+    status="open",                                     # new, open, pending, hold, solved
+    ticket_type="problem",                             # question, incident, problem, task
+    tags=["login", "urgent"],
+)
+
+# Update
+ticket = await client.tickets.update(
+    ticket_id,
+    status="solved",
+    priority="normal",
+    comment={"body": "Issue resolved!", "public": True},
+)
+
+# Delete (moves to trash, recoverable for 30 days)
+await client.tickets.delete(ticket_id)
 ```
 
 ### Comments (nested under tickets)
@@ -178,9 +201,22 @@ tags = await client.tickets.tags.set(ticket_id, ["new"])  # Replace all tags
 tags = await client.tickets.tags.remove(ticket_id, ["old"]) # Remove tags
 ```
 
+### Ticket Fields
+```python
+# Get all ticket fields (system + custom)
+async for field in client.ticket_fields.list():
+    print(f"{field.title}: {field.type}")
+
+# Get specific field by ID (cached)
+field = await client.ticket_fields.get(field_id)
+
+# Find field by title (case-insensitive)
+field = await client.ticket_fields.get_by_title("Subscription")
+```
+
 ### Enriched Tickets
 
-Load tickets with all related data (comments + users) in minimum API requests:
+Load tickets with all related data (comments, users, field definitions) in minimum API requests:
 
 ```python
 from zendesk_sdk import SearchQueryConfig
@@ -196,6 +232,13 @@ for comment in enriched.comments:
     author = enriched.get_comment_author(comment)
     print(f"Comment by {author.name}: {comment.body[:50]}...")
 
+# Access custom field values with human-readable names
+field_values = enriched.get_field_values()
+print(f"Subscription: {field_values.get('Subscription')}")
+
+# Or get specific field value by ID
+value = enriched.get_field_value(360001234)
+
 # Search with all data loaded (using SearchQueryConfig)
 config = SearchQueryConfig.tickets(
     status=["open"],
@@ -417,6 +460,7 @@ The SDK provides specific exception classes for different error types:
 from zendesk_sdk.exceptions import (
     ZendeskAuthException,
     ZendeskHTTPException,
+    ZendeskPaginationException,
     ZendeskRateLimitException,
     ZendeskTimeoutException,
     ZendeskValidationException,
@@ -437,6 +481,9 @@ async with ZendeskClient(config) as client:
     except ZendeskTimeoutException as e:
         # Request timeout
         print(f"Timeout: {e.message}")
+    except ZendeskPaginationException as e:
+        # Pagination errors (e.g., Zendesk 1000 result limit)
+        print(f"Pagination error: {e.message}")
 ```
 
 ### Automatic Retry
@@ -467,6 +514,7 @@ The SDK includes built-in caching for frequently accessed resources. Caching is
 |----------|-----|----------|
 | Users | 5 min | 1000 |
 | Organizations | 10 min | 500 |
+| Ticket Fields | 30 min | 200 |
 | Articles | 15 min | 500 |
 | Categories | 30 min | 200 |
 | Sections | 30 min | 200 |

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

@@ -3,6 +3,7 @@
 This example demonstrates:
 - Configuration setup
 - Basic API operations (get users, tickets, organizations)
+- Ticket CRUD (create, update, delete)
 - Pagination basics
 - Search functionality
 """
@@ -42,6 +43,29 @@ async def main() -> None:
         ticket = await client.tickets.get(12345)
         print(f"Ticket: {ticket.subject} (status: {ticket.status})")
 
+        # Create a new ticket
+        new_ticket = await client.tickets.create(
+            comment_body="Customer cannot access their account",
+            subject="Account Access Issue",
+            priority="high",
+            ticket_type="incident",
+            tags=["account", "access"],
+        )
+        print(f"Created ticket: #{new_ticket.id} - {new_ticket.subject}")
+
+        # Update the ticket
+        updated_ticket = await client.tickets.update(
+            new_ticket.id,
+            status="open",
+            priority="normal",
+            comment={"body": "Working on this issue", "public": False},
+        )
+        print(f"Updated ticket status: {updated_ticket.status}")
+
+        # Delete the ticket (moves to trash)
+        await client.tickets.delete(new_ticket.id)
+        print(f"Deleted ticket: #{new_ticket.id}")
+
         # 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)")

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

@@ -1,8 +1,9 @@
 """Enriched tickets example for Zendesk SDK.
 
 This example demonstrates:
-- Loading tickets with all related data (comments + users)
+- Loading tickets with all related data (comments, users, field definitions)
 - Using EnrichedTicket for efficient data access
+- Accessing custom field values with human-readable names
 - Minimizing API requests with batch loading
 """
 
@@ -22,7 +23,8 @@ async def main() -> None:
         # ==================== Single enriched ticket ====================
 
         # Get a single ticket with all related data
-        # This makes 2 API calls: ticket + comments (with sideloaded users)
+        # This makes 2 parallel API calls: ticket (with users) + fields
+        # Then fetches comments
         enriched = await client.tickets.get_enriched(12345)
 
         print(f"Ticket: {enriched.ticket.subject}")
@@ -40,6 +42,26 @@ async def main() -> None:
         else:
             print("Ticket is unassigned")
 
+        # ==================== Custom field values ====================
+
+        # Get all custom field values as dict with human-readable names
+        field_values = enriched.get_field_values()
+        print(f"\nCustom fields ({len(field_values)}):")
+        for name, value in field_values.items():
+            print(f"  {name}: {value}")
+
+        # Or get specific field value by ID
+        subscription = enriched.get_field_value(360001234)  # Replace with your field ID
+        if subscription:
+            print(f"\nSubscription level: {subscription}")
+
+        # Get field definition for more details
+        field = enriched.get_field(360001234)
+        if field:
+            print(f"Field type: {field.type}, Required: {field.required}")
+
+        # ==================== Comments with authors ====================
+
         # Process comments with author information
         print(f"\nComments ({len(enriched.comments)}):")
         for comment in enriched.comments:

{python_zendesk_sdk-0.4.0 → python_zendesk_sdk-0.6.0}/pyproject.toml

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

{python_zendesk_sdk-0.4.0 → python_zendesk_sdk-0.6.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.4.0"
+__version__ = "0.6.0"
 
 from .client import ZendeskClient
 from .clients import (
@@ -18,6 +18,7 @@ from .clients import (
     SearchClient,
     SectionsClient,
     TagsClient,
+    TicketFieldsClient,
     TicketsClient,
     UsersClient,
 )
@@ -38,9 +39,13 @@ from .models import (
     Section,
     SortOrder,
     TicketChannel,
+    TicketField,
     TicketPriority,
+    TicketPriorityInput,
     TicketStatus,
+    TicketStatusInput,
     TicketType,
+    TicketTypeInput,
     UserRole,
 )
 
@@ -53,6 +58,7 @@ __all__ = [
     "UsersClient",
     "OrganizationsClient",
     "TicketsClient",
+    "TicketFieldsClient",
     "CommentsClient",
     "TagsClient",
     "AttachmentsClient",
@@ -64,6 +70,7 @@ __all__ = [
     "ArticlesClient",
     # Models
     "EnrichedTicket",
+    "TicketField",
     "Category",
     "Section",
     "Article",
@@ -71,8 +78,11 @@ __all__ = [
     "SearchQueryConfig",
     "SearchType",
     "TicketStatus",
+    "TicketStatusInput",
     "TicketPriority",
+    "TicketPriorityInput",
     "TicketType",
+    "TicketTypeInput",
     "TicketChannel",
     "UserRole",
     "SortOrder",

{python_zendesk_sdk-0.4.0 → python_zendesk_sdk-0.6.0}/src/zendesk_sdk/client.py

@@ -12,6 +12,7 @@ if TYPE_CHECKING:
         HelpCenterClient,
         OrganizationsClient,
         SearchClient,
+        TicketFieldsClient,
         TicketsClient,
         UsersClient,
     )
@@ -131,6 +132,31 @@ class ZendeskClient:
 
         return TicketsClient(self.http_client)
 
+    @cached_property
+    def ticket_fields(self) -> "TicketFieldsClient":
+        """Access Ticket Fields API.
+
+        Provides access to ticket field definitions, including system
+        and custom fields. Essential for understanding ticket schema.
+
+        Example:
+            # List all ticket fields
+            async for field in client.ticket_fields.list():
+                print(f"{field.title}: {field.type}")
+
+            # Get specific field
+            field = await client.ticket_fields.get(12345)
+
+            # Get only custom fields
+            custom = await client.ticket_fields.list_custom()
+
+            # Get only active fields
+            active = await client.ticket_fields.list_active()
+        """
+        from .clients import TicketFieldsClient
+
+        return TicketFieldsClient(self.http_client, self.config.cache)
+
     @cached_property
     def attachments(self) -> "AttachmentsClient":
         """Access Attachments API.

{python_zendesk_sdk-0.4.0 → python_zendesk_sdk-0.6.0}/src/zendesk_sdk/clients/__init__.py

@@ -4,6 +4,7 @@ from .attachments import AttachmentsClient
 from .help_center import ArticlesClient, CategoriesClient, HelpCenterClient, SectionsClient
 from .organizations import OrganizationsClient
 from .search import SearchClient
+from .ticket_fields import TicketFieldsClient
 from .tickets import CommentsClient, TagsClient, TicketsClient
 from .users import UsersClient
 
@@ -12,6 +13,7 @@ __all__ = [
     "UsersClient",
     "OrganizationsClient",
     "TicketsClient",
+    "TicketFieldsClient",
     "AttachmentsClient",
     "SearchClient",
     # Ticket sub-clients

python_zendesk_sdk-0.6.0/src/zendesk_sdk/clients/ticket_fields.py

@@ -0,0 +1,101 @@
+"""Ticket Fields API client."""
+
+from typing import TYPE_CHECKING, Callable, Optional
+
+from ..models.ticket import TicketField
+from ..pagination import ZendeskPaginator
+from .base import BaseClient
+
+if TYPE_CHECKING:
+    from ..config import CacheConfig
+    from ..http_client import HTTPClient
+    from ..pagination import Paginator
+
+
+class TicketFieldsClient(BaseClient):
+    """Client for Zendesk Ticket Fields API.
+
+    Provides access to ticket field definitions, including both system
+    fields and custom fields. Essential for understanding ticket schema.
+
+    Example:
+        async with ZendeskClient(config) as client:
+            # Get all ticket fields
+            async for field in client.ticket_fields.list():
+                print(f"{field.title}: {field.type}")
+
+            # Get a specific field by ID
+            field = await client.ticket_fields.get(12345)
+
+            # Find field by title
+            field = await client.ticket_fields.get_by_title("Subscription")
+    """
+
+    def __init__(
+        self,
+        http_client: "HTTPClient",
+        cache_config: Optional["CacheConfig"] = None,
+    ) -> None:
+        """Initialize TicketFieldsClient with optional caching."""
+        super().__init__(http_client, cache_config)
+        # Ticket fields change infrequently, use longer TTL (30 minutes)
+        if cache_config:
+            maxsize = getattr(cache_config, "ticket_field_maxsize", 200)
+            ttl = getattr(cache_config, "ticket_field_ttl", 1800)
+        else:
+            maxsize = 200
+            ttl = 1800
+        self.get: Callable[[int], TicketField] = self._create_cached_method(
+            self._get_impl, maxsize=maxsize, ttl=ttl
+        )
+
+    async def _get_impl(self, field_id: int) -> TicketField:
+        """Get a specific ticket field by ID.
+
+        Results are cached for 30 minutes by default.
+
+        Args:
+            field_id: The ticket field's ID
+
+        Returns:
+            TicketField object
+        """
+        response = await self._get(f"ticket_fields/{field_id}.json")
+        return TicketField(**response["ticket_field"])
+
+    def list(self, per_page: int = 100, limit: Optional[int] = None) -> "Paginator[TicketField]":
+        """Get paginated list of all ticket fields.
+
+        Returns both system fields and custom fields.
+
+        Args:
+            per_page: Number of fields per page (max 100)
+            limit: Maximum number of items to return when iterating (None = no limit)
+
+        Returns:
+            Paginator for iterating through all ticket fields
+
+        Example:
+            # Iterate through all fields
+            async for field in client.ticket_fields.list():
+                print(f"{field.title} ({field.type})")
+
+            # Collect to list
+            fields = await client.ticket_fields.list().collect()
+        """
+        return ZendeskPaginator.create_ticket_fields_paginator(self._http, per_page=per_page, limit=limit)
+
+    async def get_by_title(self, title: str) -> Optional[TicketField]:
+        """Find a ticket field by its title.
+
+        Args:
+            title: The title of the ticket field (case-insensitive)
+
+        Returns:
+            TicketField if found, None otherwise
+        """
+        title_lower = title.lower()
+        async for field in self.list():
+            if field.title.lower() == title_lower:
+                return field
+        return None