clerk-sdk 0.1.0

Library for interacting with Clerk

CLERK

clerk-sdk is a Python library designed to simplify interactions with the Clerk API. It provides a robust and user-friendly interface for managing documents, handling API requests, and integrating structured data models into your workflows. With built-in support for Prefect task flows and retry mechanisms, clerk-sdk is ideal for developers looking to streamline their integration with Clerk.

Features

• Document Management: Retrieve and manage documents and their associated files.
• API Request Handling: Simplified GET and POST requests with automatic retries and error handling.
• Data Models: Predefined Pydantic models for structured data validation and serialization.
• Task Flow Integration: Prefect-based decorators for creating and managing task flows.
• Extensibility: Easily extend and customize the library to fit your specific use case.

Installation

Install the library using pip:

pip install clerk-sdk

Usage

Initialize the Client

from clerk import Clerk

clerk_client = Clerk(api_key="your_api_key")

Retrieve a Document

document = clerk_client.get_document(document_id="12345")
print(document.title)

Retrieve Files Associated with a Document

files = clerk_client.get_files_document(document_id="12345")
for file in files:
    print(file.name)

Use the Prefect Task Decorator

from clerk.decorator import clerk_code

@clerk_code()
def process_document(payload):
    # Your processing logic here
    return {"status": "processed"}

Requirements

• Python 3.10+
• Dependencies listed in requirements.txt:
  • prefect>=3.4.1
  • pydantic>2.0.0
  • backoff>2.0.0

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributing

Contributions are welcome! Please submit a pull request or open an issue to discuss your ideas.