teable-client 1.0.0__tar.gz

teable_client-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Volkan Tasci
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

teable_client-1.0.0/PKG-INFO

@@ -0,0 +1,245 @@
+Metadata-Version: 2.2
+Name: teable-client
+Version: 1.0.0
+Summary: A professional Python client library for the Teable API
+Home-page: https://github.com/volkantasci/teable-client
+Author: Volkan Tasci
+Author-email: volkantasci@gmail.com
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Requires-Dist: python-dateutil>=2.8.0
+Requires-Dist: typing-extensions>=4.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=2.0.0; extra == "dev"
+Requires-Dist: black>=21.0.0; extra == "dev"
+Requires-Dist: isort>=5.0.0; extra == "dev"
+Requires-Dist: mypy>=0.900; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Teable Client Library
+
+A professional Python client library for interacting with the Teable API. This library provides an object-oriented interface for managing tables, records, fields, and views in Teable.
+
+## Features
+
+- Full Teable API coverage with an intuitive object-oriented interface
+- Comprehensive field type support with validation
+- Efficient batch operations for creating, updating, and deleting records
+- Advanced querying capabilities with a fluent query builder
+- Automatic rate limiting and retry handling
+- Resource caching for improved performance
+- Type hints for better IDE support
+- Detailed documentation and examples
+
+## Installation
+
+You can install the package using pip:
+
+```bash
+pip install teable-client
+```
+
+## Quick Start
+
+```python
+from teable import TeableClient, TeableConfig
+
+# Initialize the client
+config = TeableConfig(
+    api_url="https://your-teable-instance.com/api",
+    api_key="your-api-key"
+)
+client = TeableClient(config)
+
+# Get a table
+table = client.get_table("table_id")
+
+# Create a record
+record = table.create_record({
+    "name": "John Doe",
+    "email": "john@example.com",
+    "age": 30
+})
+
+# Query records
+query = table.query()\
+    .filter("age", ">", 25)\
+    .sort("name")\
+    .paginate(take=10)
+    
+records = table.get_records(query)
+
+# Batch create records
+records_data = [
+    {"name": "Alice", "age": 28},
+    {"name": "Bob", "age": 32}
+]
+batch_result = table.batch_create_records(records_data)
+print(f"Created {batch_result.success_count} records")
+```
+
+## Advanced Usage
+
+### Working with Fields
+
+```python
+from teable import FieldType, Field
+
+# Get table fields
+fields = table.fields
+
+# Access field properties
+for field in fields:
+    print(f"{field.name} ({field.field_type})")
+    if field.is_required:
+        print("  Required field")
+    if field.is_primary:
+        print("  Primary field")
+
+# Validate field values
+field = table.get_field("field_id")
+try:
+    field.validate_value(some_value)
+except ValidationError as e:
+    print(f"Invalid value: {e}")
+```
+
+### Using Views
+
+```python
+# Get table views
+views = table.views
+
+# Get records from a specific view
+view = table.get_view("view_id")
+query = view.create_query().paginate(take=20)
+records = table.get_records(query)
+```
+
+### Advanced Querying
+
+```python
+from teable import FilterOperator, SortDirection
+
+# Complex query with multiple conditions
+query = table.query()\
+    .filter("status", FilterOperator.EQUALS, "active")\
+    .filter("age", FilterOperator.GREATER_THAN, 25)\
+    .filter("tags", FilterOperator.CONTAINS, "important")\
+    .sort("created_time", SortDirection.DESCENDING)\
+    .sort("priority")\
+    .search("urgent", field="title")\
+    .paginate(take=50, skip=100)
+
+records = table.get_records(query)
+```
+
+### Batch Operations
+
+```python
+# Batch create
+records_data = [
+    {"name": "Alice", "department": "Engineering"},
+    {"name": "Bob", "department": "Marketing"}
+]
+batch_result = table.batch_create_records(records_data)
+
+print(f"Successfully created: {batch_result.success_count}")
+if batch_result.failed:
+    print("Failed operations:")
+    for failure in batch_result.failed:
+        print(f"  {failure}")
+
+# Batch update
+updates = [
+    {"id": "rec1", "fields": {"status": "completed"}},
+    {"id": "rec2", "fields": {"status": "completed"}}
+]
+table.batch_update_records(updates)
+
+# Batch delete
+record_ids = ["rec1", "rec2", "rec3"]
+table.batch_delete_records(record_ids)
+```
+
+### Error Handling
+
+```python
+from teable import (
+    TeableError,
+    APIError,
+    ValidationError,
+    ResourceNotFoundError
+)
+
+try:
+    record = table.get_record("invalid_id")
+except ResourceNotFoundError as e:
+    print(f"Record not found: {e}")
+except ValidationError as e:
+    print(f"Validation error: {e}")
+except APIError as e:
+    print(f"API error {e.status_code}: {e}")
+except TeableError as e:
+    print(f"Other error: {e}")
+```
+
+## Configuration Options
+
+The `TeableConfig` class supports various options to customize the client behavior:
+
+```python
+config = TeableConfig(
+    api_url="https://your-teable-instance.com/api",
+    api_key="your-api-key",
+    timeout=30.0,          # Request timeout in seconds
+    max_retries=3,         # Maximum number of retry attempts
+    retry_delay=1.0,       # Delay between retries in seconds
+    default_table_id=None, # Default table ID for operations
+    default_view_id=None   # Default view ID for operations
+)
+```
+
+## Development
+
+To set up the development environment:
+
+1. Clone the repository
+2. Install development dependencies:
+   ```bash
+   pip install -e ".[dev]"
+   ```
+3. Run tests:
+   ```bash
+   pytest
+   ```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

teable_client-1.0.0/README.md

@@ -0,0 +1,205 @@
+# Teable Client Library
+
+A professional Python client library for interacting with the Teable API. This library provides an object-oriented interface for managing tables, records, fields, and views in Teable.
+
+## Features
+
+- Full Teable API coverage with an intuitive object-oriented interface
+- Comprehensive field type support with validation
+- Efficient batch operations for creating, updating, and deleting records
+- Advanced querying capabilities with a fluent query builder
+- Automatic rate limiting and retry handling
+- Resource caching for improved performance
+- Type hints for better IDE support
+- Detailed documentation and examples
+
+## Installation
+
+You can install the package using pip:
+
+```bash
+pip install teable-client
+```
+
+## Quick Start
+
+```python
+from teable import TeableClient, TeableConfig
+
+# Initialize the client
+config = TeableConfig(
+    api_url="https://your-teable-instance.com/api",
+    api_key="your-api-key"
+)
+client = TeableClient(config)
+
+# Get a table
+table = client.get_table("table_id")
+
+# Create a record
+record = table.create_record({
+    "name": "John Doe",
+    "email": "john@example.com",
+    "age": 30
+})
+
+# Query records
+query = table.query()\
+    .filter("age", ">", 25)\
+    .sort("name")\
+    .paginate(take=10)
+    
+records = table.get_records(query)
+
+# Batch create records
+records_data = [
+    {"name": "Alice", "age": 28},
+    {"name": "Bob", "age": 32}
+]
+batch_result = table.batch_create_records(records_data)
+print(f"Created {batch_result.success_count} records")
+```
+
+## Advanced Usage
+
+### Working with Fields
+
+```python
+from teable import FieldType, Field
+
+# Get table fields
+fields = table.fields
+
+# Access field properties
+for field in fields:
+    print(f"{field.name} ({field.field_type})")
+    if field.is_required:
+        print("  Required field")
+    if field.is_primary:
+        print("  Primary field")
+
+# Validate field values
+field = table.get_field("field_id")
+try:
+    field.validate_value(some_value)
+except ValidationError as e:
+    print(f"Invalid value: {e}")
+```
+
+### Using Views
+
+```python
+# Get table views
+views = table.views
+
+# Get records from a specific view
+view = table.get_view("view_id")
+query = view.create_query().paginate(take=20)
+records = table.get_records(query)
+```
+
+### Advanced Querying
+
+```python
+from teable import FilterOperator, SortDirection
+
+# Complex query with multiple conditions
+query = table.query()\
+    .filter("status", FilterOperator.EQUALS, "active")\
+    .filter("age", FilterOperator.GREATER_THAN, 25)\
+    .filter("tags", FilterOperator.CONTAINS, "important")\
+    .sort("created_time", SortDirection.DESCENDING)\
+    .sort("priority")\
+    .search("urgent", field="title")\
+    .paginate(take=50, skip=100)
+
+records = table.get_records(query)
+```
+
+### Batch Operations
+
+```python
+# Batch create
+records_data = [
+    {"name": "Alice", "department": "Engineering"},
+    {"name": "Bob", "department": "Marketing"}
+]
+batch_result = table.batch_create_records(records_data)
+
+print(f"Successfully created: {batch_result.success_count}")
+if batch_result.failed:
+    print("Failed operations:")
+    for failure in batch_result.failed:
+        print(f"  {failure}")
+
+# Batch update
+updates = [
+    {"id": "rec1", "fields": {"status": "completed"}},
+    {"id": "rec2", "fields": {"status": "completed"}}
+]
+table.batch_update_records(updates)
+
+# Batch delete
+record_ids = ["rec1", "rec2", "rec3"]
+table.batch_delete_records(record_ids)
+```
+
+### Error Handling
+
+```python
+from teable import (
+    TeableError,
+    APIError,
+    ValidationError,
+    ResourceNotFoundError
+)
+
+try:
+    record = table.get_record("invalid_id")
+except ResourceNotFoundError as e:
+    print(f"Record not found: {e}")
+except ValidationError as e:
+    print(f"Validation error: {e}")
+except APIError as e:
+    print(f"API error {e.status_code}: {e}")
+except TeableError as e:
+    print(f"Other error: {e}")
+```
+
+## Configuration Options
+
+The `TeableConfig` class supports various options to customize the client behavior:
+
+```python
+config = TeableConfig(
+    api_url="https://your-teable-instance.com/api",
+    api_key="your-api-key",
+    timeout=30.0,          # Request timeout in seconds
+    max_retries=3,         # Maximum number of retry attempts
+    retry_delay=1.0,       # Delay between retries in seconds
+    default_table_id=None, # Default table ID for operations
+    default_view_id=None   # Default view ID for operations
+)
+```
+
+## Development
+
+To set up the development environment:
+
+1. Clone the repository
+2. Install development dependencies:
+   ```bash
+   pip install -e ".[dev]"
+   ```
+3. Run tests:
+   ```bash
+   pytest
+   ```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

teable_client-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

teable_client-1.0.0/setup.py

@@ -0,0 +1,43 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="teable-client",
+    version="1.0.0",
+    author="Volkan Tasci",
+    author_email="volkantasci@gmail.com",
+    description="A professional Python client library for the Teable API",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/volkantasci/teable-client",
+    packages=find_packages(),
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+    ],
+    python_requires=">=3.7",
+    install_requires=[
+        "requests>=2.25.0",
+        "python-dateutil>=2.8.0",
+        "typing-extensions>=4.0.0",
+    ],
+    extras_require={
+        "dev": [
+            "pytest>=6.0.0",
+            "pytest-cov>=2.0.0",
+            "black>=21.0.0",
+            "isort>=5.0.0",
+            "mypy>=0.900",
+        ],
+    },
+)

teable_client-1.0.0/teable/__init__.py

@@ -0,0 +1,66 @@
+"""
+Teable Client Library
+
+A professional Python client library for interacting with the Teable API.
+Provides an object-oriented interface for managing tables, records, fields, and views.
+"""
+
+__version__ = "1.0.0"
+
+from .core.client import TeableClient
+from .exceptions import (
+    TeableError,
+    APIError,
+    AuthenticationError,
+    BatchOperationError,
+    ConfigurationError,
+    NetworkError,
+    RateLimitError,
+    ResourceNotFoundError,
+    ValidationError
+)
+from .models.config import TeableConfig
+from .models.field import Field, FieldType
+from .models.record import Record, RecordBatch
+from .models.table import Table
+from .models.view import (
+    View,
+    QueryBuilder,
+    FilterOperator,
+    SortDirection,
+    FilterCondition,
+    SortCondition
+)
+
+__all__ = [
+    # Core
+    'TeableClient',
+    'TeableConfig',
+    
+    # Models
+    'Table',
+    'Record',
+    'RecordBatch',
+    'Field',
+    'FieldType',
+    'View',
+    'QueryBuilder',
+    'FilterOperator',
+    'SortDirection',
+    'FilterCondition',
+    'SortCondition',
+    
+    # Exceptions
+    'TeableError',
+    'APIError',
+    'AuthenticationError',
+    'BatchOperationError',
+    'ConfigurationError',
+    'NetworkError',
+    'RateLimitError',
+    'ResourceNotFoundError',
+    'ValidationError',
+    
+    # Version
+    '__version__'
+]

teable_client-1.0.0/teable/exceptions/__init__.py

@@ -0,0 +1,146 @@
+"""
+Teable Client Exceptions Module
+
+This module defines the exception hierarchy used throughout the Teable client library.
+All custom exceptions inherit from TeableError to allow for specific error handling.
+"""
+
+from typing import Optional
+
+
+class TeableError(Exception):
+    """Base exception class for all Teable-related errors."""
+    pass
+
+
+class APIError(TeableError):
+    """
+    Exception raised when the Teable API returns an error response.
+    
+    Attributes:
+        message (str): Human-readable error description
+        status_code (Optional[int]): HTTP status code if available
+        response_body (Optional[str]): Raw response body if available
+    """
+    def __init__(
+        self, 
+        message: str, 
+        status_code: Optional[int] = None,
+        response_body: Optional[str] = None
+    ):
+        self.status_code = status_code
+        self.response_body = response_body
+        super().__init__(message)
+
+
+class ValidationError(TeableError):
+    """
+    Exception raised when data validation fails.
+    
+    This could be due to:
+    - Invalid field types
+    - Missing required fields
+    - Value constraints violations
+    """
+    pass
+
+
+class ConfigurationError(TeableError):
+    """
+    Exception raised when there are issues with client configuration.
+    
+    This could be due to:
+    - Missing API credentials
+    - Invalid API URL
+    - Missing required configuration parameters
+    """
+    pass
+
+
+class RateLimitError(APIError):
+    """
+    Exception raised when API rate limits are exceeded.
+    
+    Attributes:
+        reset_time (Optional[float]): Unix timestamp when the rate limit resets
+        limit (Optional[int]): The rate limit ceiling for the given endpoint
+    """
+    def __init__(
+        self,
+        message: str,
+        status_code: Optional[int] = 429,
+        reset_time: Optional[float] = None,
+        limit: Optional[int] = None
+    ):
+        self.reset_time = reset_time
+        self.limit = limit
+        super().__init__(message, status_code)
+
+
+class ResourceNotFoundError(APIError):
+    """
+    Exception raised when a requested resource is not found.
+    
+    This could be due to:
+    - Invalid record ID
+    - Invalid table ID
+    - Invalid view ID
+    - Invalid field ID
+    """
+    def __init__(
+        self,
+        message: str,
+        resource_type: str,
+        resource_id: str,
+        status_code: Optional[int] = 404
+    ):
+        self.resource_type = resource_type
+        self.resource_id = resource_id
+        super().__init__(
+            f"{message} ({resource_type}: {resource_id})",
+            status_code
+        )
+
+
+class AuthenticationError(APIError):
+    """
+    Exception raised when authentication fails.
+    
+    This could be due to:
+    - Invalid API key
+    - Expired credentials
+    - Insufficient permissions
+    """
+    def __init__(self, message: str, status_code: Optional[int] = 401):
+        super().__init__(message, status_code)
+
+
+class NetworkError(TeableError):
+    """
+    Exception raised when network-related issues occur.
+    
+    This could be due to:
+    - Connection timeouts
+    - DNS resolution failures
+    - SSL/TLS errors
+    """
+    pass
+
+
+class BatchOperationError(TeableError):
+    """
+    Exception raised when a batch operation partially fails.
+    
+    Attributes:
+        successful_operations (list): List of successfully processed items
+        failed_operations (list): List of failed operations with their errors
+    """
+    def __init__(
+        self,
+        message: str,
+        successful_operations: list,
+        failed_operations: list
+    ):
+        self.successful_operations = successful_operations
+        self.failed_operations = failed_operations
+        super().__init__(message)

teable_client-1.0.0/teable_client.egg-info/PKG-INFO

@@ -0,0 +1,245 @@
+Metadata-Version: 2.2
+Name: teable-client
+Version: 1.0.0
+Summary: A professional Python client library for the Teable API
+Home-page: https://github.com/volkantasci/teable-client
+Author: Volkan Tasci
+Author-email: volkantasci@gmail.com
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Requires-Dist: python-dateutil>=2.8.0
+Requires-Dist: typing-extensions>=4.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=2.0.0; extra == "dev"
+Requires-Dist: black>=21.0.0; extra == "dev"
+Requires-Dist: isort>=5.0.0; extra == "dev"
+Requires-Dist: mypy>=0.900; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Teable Client Library
+
+A professional Python client library for interacting with the Teable API. This library provides an object-oriented interface for managing tables, records, fields, and views in Teable.
+
+## Features
+
+- Full Teable API coverage with an intuitive object-oriented interface
+- Comprehensive field type support with validation
+- Efficient batch operations for creating, updating, and deleting records
+- Advanced querying capabilities with a fluent query builder
+- Automatic rate limiting and retry handling
+- Resource caching for improved performance
+- Type hints for better IDE support
+- Detailed documentation and examples
+
+## Installation
+
+You can install the package using pip:
+
+```bash
+pip install teable-client
+```
+
+## Quick Start
+
+```python
+from teable import TeableClient, TeableConfig
+
+# Initialize the client
+config = TeableConfig(
+    api_url="https://your-teable-instance.com/api",
+    api_key="your-api-key"
+)
+client = TeableClient(config)
+
+# Get a table
+table = client.get_table("table_id")
+
+# Create a record
+record = table.create_record({
+    "name": "John Doe",
+    "email": "john@example.com",
+    "age": 30
+})
+
+# Query records
+query = table.query()\
+    .filter("age", ">", 25)\
+    .sort("name")\
+    .paginate(take=10)
+    
+records = table.get_records(query)
+
+# Batch create records
+records_data = [
+    {"name": "Alice", "age": 28},
+    {"name": "Bob", "age": 32}
+]
+batch_result = table.batch_create_records(records_data)
+print(f"Created {batch_result.success_count} records")
+```
+
+## Advanced Usage
+
+### Working with Fields
+
+```python
+from teable import FieldType, Field
+
+# Get table fields
+fields = table.fields
+
+# Access field properties
+for field in fields:
+    print(f"{field.name} ({field.field_type})")
+    if field.is_required:
+        print("  Required field")
+    if field.is_primary:
+        print("  Primary field")
+
+# Validate field values
+field = table.get_field("field_id")
+try:
+    field.validate_value(some_value)
+except ValidationError as e:
+    print(f"Invalid value: {e}")
+```
+
+### Using Views
+
+```python
+# Get table views
+views = table.views
+
+# Get records from a specific view
+view = table.get_view("view_id")
+query = view.create_query().paginate(take=20)
+records = table.get_records(query)
+```
+
+### Advanced Querying
+
+```python
+from teable import FilterOperator, SortDirection
+
+# Complex query with multiple conditions
+query = table.query()\
+    .filter("status", FilterOperator.EQUALS, "active")\
+    .filter("age", FilterOperator.GREATER_THAN, 25)\
+    .filter("tags", FilterOperator.CONTAINS, "important")\
+    .sort("created_time", SortDirection.DESCENDING)\
+    .sort("priority")\
+    .search("urgent", field="title")\
+    .paginate(take=50, skip=100)
+
+records = table.get_records(query)
+```
+
+### Batch Operations
+
+```python
+# Batch create
+records_data = [
+    {"name": "Alice", "department": "Engineering"},
+    {"name": "Bob", "department": "Marketing"}
+]
+batch_result = table.batch_create_records(records_data)
+
+print(f"Successfully created: {batch_result.success_count}")
+if batch_result.failed:
+    print("Failed operations:")
+    for failure in batch_result.failed:
+        print(f"  {failure}")
+
+# Batch update
+updates = [
+    {"id": "rec1", "fields": {"status": "completed"}},
+    {"id": "rec2", "fields": {"status": "completed"}}
+]
+table.batch_update_records(updates)
+
+# Batch delete
+record_ids = ["rec1", "rec2", "rec3"]
+table.batch_delete_records(record_ids)
+```
+
+### Error Handling
+
+```python
+from teable import (
+    TeableError,
+    APIError,
+    ValidationError,
+    ResourceNotFoundError
+)
+
+try:
+    record = table.get_record("invalid_id")
+except ResourceNotFoundError as e:
+    print(f"Record not found: {e}")
+except ValidationError as e:
+    print(f"Validation error: {e}")
+except APIError as e:
+    print(f"API error {e.status_code}: {e}")
+except TeableError as e:
+    print(f"Other error: {e}")
+```
+
+## Configuration Options
+
+The `TeableConfig` class supports various options to customize the client behavior:
+
+```python
+config = TeableConfig(
+    api_url="https://your-teable-instance.com/api",
+    api_key="your-api-key",
+    timeout=30.0,          # Request timeout in seconds
+    max_retries=3,         # Maximum number of retry attempts
+    retry_delay=1.0,       # Delay between retries in seconds
+    default_table_id=None, # Default table ID for operations
+    default_view_id=None   # Default view ID for operations
+)
+```
+
+## Development
+
+To set up the development environment:
+
+1. Clone the repository
+2. Install development dependencies:
+   ```bash
+   pip install -e ".[dev]"
+   ```
+3. Run tests:
+   ```bash
+   pytest
+   ```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

teable_client-1.0.0/teable_client.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+setup.py
+teable/__init__.py
+teable/exceptions/__init__.py
+teable_client.egg-info/PKG-INFO
+teable_client.egg-info/SOURCES.txt
+teable_client.egg-info/dependency_links.txt
+teable_client.egg-info/requires.txt
+teable_client.egg-info/top_level.txt

teable_client-1.0.0/teable_client.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

teable_client-1.0.0/teable_client.egg-info/requires.txt

@@ -0,0 +1,10 @@
+requests>=2.25.0
+python-dateutil>=2.8.0
+typing-extensions>=4.0.0
+
+[dev]
+pytest>=6.0.0
+pytest-cov>=2.0.0
+black>=21.0.0
+isort>=5.0.0
+mypy>=0.900

teable_client-1.0.0/teable_client.egg-info/top_level.txt

@@ -0,0 +1 @@
+teable