FastAPI Toolsets

A modular collection of production-ready utilities for FastAPI. Install only what you need — from async CRUD and database helpers to CLI tooling, Prometheus metrics, and pytest fixtures. Each module is independently installable via optional extras, keeping your dependency footprint minimal.

Documentation: https://fastapi-toolsets.d3vyce.fr

Source Code: https://github.com/d3vyce/fastapi-toolsets

Installation

The base package includes the core modules (CRUD, database, schemas, exceptions, fixtures, dependencies, model mixins, logging):

uv add fastapi-toolsets

Install only the extras you need:

uv add "fastapi-toolsets[cli]"
uv add "fastapi-toolsets[metrics]"
uv add "fastapi-toolsets[pytest]"

Or install everything:

uv add "fastapi-toolsets[all]"

Features

Core

CRUD: Generic async CRUD operations with CrudFactory, built-in full-text/faceted search and Offset/Cursor pagination.
Database: Session management, transaction helpers, table locking, and polling-based row change detection
Dependencies: FastAPI dependency factories (PathDependency, BodyDependency) for automatic DB lookups from path or body parameters
Fixtures: Fixture system with dependency management, context support, and pytest integration
Model Mixins: SQLAlchemy mixins for common column patterns (UUIDMixin, UUIDv7Mixin, CreatedAtMixin, UpdatedAtMixin, TimestampMixin)
Lifecycle Events: Post-commit event system (EventSession, listens_for) that dispatches async/sync callbacks for insert, update, and delete operations
Standardized API Responses: Consistent response format with Response, ErrorResponse, PaginatedResponse, CursorPaginatedResponse and OffsetPaginatedResponse.
Exception Handling: Structured error responses with automatic OpenAPI documentation
Logging: Console or JSON logging with request context, an access log middleware, and trace correlation for FastAPI's OpenTelemetry support

Optional

CLI: Django-like command-line interface with fixture management and custom commands support
Metrics: Prometheus metrics endpoint with provider/collector registry
OpenTelemetry logs: Forward standard logging records to OpenTelemetry logs
Pytest Helpers: Async test client, database session management, pytest-xdist support, and table cleanup utilities

License

MIT License - see LICENSE for details.

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

Metadata

Release files for fastapi-toolsets 6.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fastapi-toolsets 6.0.0
File	Size	Uploaded
fastapi_toolsets-6.0.0.tar.gz	78.3 kB	Oct 10, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for fastapi-toolsets 6.0.0
File	Interpreter	ABI	Platform	Reset
fastapi_toolsets-6.0.0-py3-none-any.whl 94.6 kB Oct 10, 2026	Python 3	none	any	Details

Total release size: 172.9 kB

Release files / fastapi_toolsets-6.0.0.tar.gz

Download URL	fastapi_toolsets-6.0.0.tar.gz
Size	78.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`d1c36f6b268455bad54382fb4b8d16e3a810db0aff422bde9da41e51b0b30b80`
BLAKE2b-256 checksum How to use checksums	`64558c8861ea7c1e2f703dc760cbea7b8175ed5d41392a83941cafcb94aa658d`
Upload date	Oct 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/d3vyce/fastapi-toolsets
Publishing commit: github.com/d3vyce/fastapi-toolsets/tree/66c2553d8ee4aa69f1bbc6f1ba0337e3e79d7c7e

Workflow

Publishing configuration: github.com/d3vyce/fastapi-toolsets/blob/66c2553d8ee4aa69f1bbc6f1ba0337e3e79d7c7e/.github/workflows/build-release.yml
Publishing logs: github.com/d3vyce/fastapi-toolsets/actions/runs/38054487776/attempts/1

Artifact

Subject: fastapi_toolsets-6.0.0.tar.gz
SHA-256 checksum: d1c36f6b268455bad54382fb4b8d16e3a810db0aff422bde9da41e51b0b30b80 Verifying attestations

Release files / fastapi_toolsets-6.0.0-py3-none-any.whl

Download URL	fastapi_toolsets-6.0.0-py3-none-any.whl
Size	94.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`868aa0b872b46d828a9aa367efb278dc0f01e945855a073762b2501d366b8d31`
BLAKE2b-256 checksum How to use checksums	`f0d9d254f99e804daac3d3144240f1b9b632f67b979b878b3b4df25f7fddfd8b`
Upload date	Oct 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/d3vyce/fastapi-toolsets
Publishing commit: github.com/d3vyce/fastapi-toolsets/tree/66c2553d8ee4aa69f1bbc6f1ba0337e3e79d7c7e

Workflow

Publishing configuration: github.com/d3vyce/fastapi-toolsets/blob/66c2553d8ee4aa69f1bbc6f1ba0337e3e79d7c7e/.github/workflows/build-release.yml
Publishing logs: github.com/d3vyce/fastapi-toolsets/actions/runs/38054487776/attempts/1

Artifact

Subject: fastapi_toolsets-6.0.0-py3-none-any.whl
SHA-256 checksum: 868aa0b872b46d828a9aa367efb278dc0f01e945855a073762b2501d366b8d31 Verifying attestations