Skip to content

Modules

Tracktolib is organized into modules, each providing utilities for specific use cases. Install only what you need using extras.

Database

Module Extra Description
PostgreSQL (Async) pg Async PostgreSQL helpers using asyncpg
PostgreSQL (Sync) pg-sync Sync PostgreSQL helpers using psycopg v3

Storage

Module Extra Description
S3 (Async) s3-niquests Async S3 helpers using niquests + botocore
S3 (MinIO) s3-minio S3 helpers using MinIO client
S3 (aiobotocore) s3 Async S3 helpers using aiobotocore (deprecated)

Web

Module Extra Description
API (FastAPI) api FastAPI utilities and endpoint builders
Cloudflare cf Cloudflare DNS API helpers
GitHub gh GitHub API helpers
HTTP http HTTP client helpers (deprecated)
Notion notion Notion API helpers

Utilities

Module Extra Description
Logs logs Logging configuration (JSON/console)
Tests tests Testing utilities with deepdiff

Installation Examples

Install a single extra:

uv add tracktolib[pg]

Install multiple extras:

uv add tracktolib[pg,api,logs]

Install all extras:

uv add tracktolib[pg,pg-sync,s3,s3-minio,s3-niquests,api,cf,gh,http,logs,tests,notion]