upyloadthing 0.1.1

Python client for the uploadthing API

Upyloadthing

Python client for the uploadthing API - The easiest way to add file uploads to your Python application.

Installation

pip install upyloadthing

Quick Start

from upyloadthing import UTApi, UTApiOptions

# Initialize with token
api = UTApi(UTApiOptions(token="your-token"))

# Upload a file
with open("example.png", "rb") as f:
    result = api.upload_files(f)
    print(f"File uploaded: {result.url}")

Environment Variables

The SDK can be configured using environment variables:

• UPLOADTHING_TOKEN - Your uploadthing API token (required if not passed to UTApiOptions)
• UPLOADTHING_REGION - Preferred upload region (optional, defaults to first available region found in the decoded token)

Examples

Upload Multiple Files

files = [
    open("image1.jpg", "rb"),
    open("image2.jpg", "rb")
]
results = api.upload_files(files)
for result in results:
    print(f"Uploaded: {result.url}")

Delete Files

# Delete by file key
response = api.delete_files("file_key_123")

# Delete multiple files
response = api.delete_files(["key1", "key2"])

# Delete by custom ID
response = api.delete_files("custom_123", key_type="custom_id")

List Files

# Get first 10 files
files = api.list_files(limit=10)
for file in files.files:
    print(f"{file.name}: {file.url}")

# Pagination
files = api.list_files(limit=10, offset=10)

Check Usage

usage = api.get_usage_info()
print(f"Total storage used: {usage.total_bytes / 1024 / 1024:.2f} MB")
print(f"Files uploaded: {usage.files_uploaded}")

Error Handling

The SDK uses standard Python exceptions:

from requests.exceptions import HTTPError

try:
    api.upload_files(file)
except HTTPError as e:
    if e.response.status_code == 413:
        print("File too large")
    else:
        print(f"Upload failed: {e}")
except Exception as e:
    print(f"Unexpected error: {e}")

API Reference

UTApi Methods

All methods are defined in upyloadthing/client.py:

• upload_files(files) - Upload one or more files
• delete_files(keys, key_type='file_key') - Delete files by key or custom ID
• list_files(limit=None, offset=None) - List uploaded files
• get_usage_info() - Get account usage statistics

Response Models

All response models are defined in upyloadthing/schemas.py:

• UploadResult - File upload result containing:
  • ufs_url: str
  • url: str
  • app_url: str
  • file_hash: str
  • server_data: Dict | None
• DeleteFileResponse - File deletion result containing:
  • success: bool
  • deleted_count: int
• ListFileResponse - File listing result containing:
  • has_more: bool
  • files: List[FileData]
• UsageInfoResponse - Usage statistics containing:
  • total_bytes: int
  • app_total_bytes: int
  • files_uploaded: int
  • limit_bytes: int

License

MIT