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: Logging configuration with uvicorn integration via configure_logging and get_logger

Optional

CLI: Django-like command-line interface with fixture management and custom commands support
Metrics: Prometheus metrics endpoint with provider/collector registry
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 5.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 5.0.0
File	Size	Uploaded
fastapi_toolsets-5.0.0.tar.gz	53.2 kB	Jul 11, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for fastapi-toolsets 5.0.0
File	Interpreter	ABI	Platform	Reset
fastapi_toolsets-5.0.0-py3-none-any.whl 69.3 kB Jul 11, 2026	Python 3	none	any	Details

Total release size: 122.5 kB

Release files / fastapi_toolsets-5.0.0.tar.gz

Download URL	fastapi_toolsets-5.0.0.tar.gz
Size	53.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`0cdfecf522275832d8f26ee382ba81b670fce12037c0388a5c334ae7177584e6`
BLAKE2b-256 checksum How to use checksums	`16d912012166e546e577db9bdcb56c16badfef864e3b965e98d12443f2e53569`
Upload date	Jul 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

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/c15aee22b0479f64cbd4e8cef5dac098b1fa4a3e

Workflow

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

Artifact

Subject: fastapi_toolsets-5.0.0.tar.gz
SHA-256 checksum: 0cdfecf522275832d8f26ee382ba81b670fce12037c0388a5c334ae7177584e6 Verifying attestations

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

Download URL	fastapi_toolsets-5.0.0-py3-none-any.whl
Size	69.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`4e920fbf0f1ad3ae6488ec6442135d30bc556979111319f1f6aa3a0b3dc63a2f`
BLAKE2b-256 checksum How to use checksums	`49e114fe415c553df7ed0bf81ddb0d7dca8baeef6b63d820dc13da1ff8dec219`
Upload date	Jul 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

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

Workflow

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

Artifact

Subject: fastapi_toolsets-5.0.0-py3-none-any.whl
SHA-256 checksum: 4e920fbf0f1ad3ae6488ec6442135d30bc556979111319f1f6aa3a0b3dc63a2f Verifying attestations