mirror of https://github.com/d3vyce/fastapi-toolsets.git synced 2026-03-01 17:00:48 +01:00

Go to file

d3vyce 73fae04333 chore: cleanup before v1 (#73 )

* chore: move dependencies module to the project root

* chore:update README

* chore: clean conftest

* chore: remove old code + comment

* fix: uv.lock dependencies

2026-02-19 11:49:57 +01:00

.github

tests: upload test results to codecov (#26 )

2026-02-03 17:00:57 +01:00

src/fastapi_toolsets

chore: cleanup before v1 (#73 )

2026-02-19 11:49:57 +01:00

tests

chore: cleanup before v1 (#73 )

2026-02-19 11:49:57 +01:00

.gitignore

Initial commit

2026-01-25 16:11:44 +01:00

.python-version

feat: add support for python 3.14 (#15 )

2026-01-28 21:01:15 +01:00

LICENSE

Initial commit

2026-01-25 16:11:44 +01:00

pyproject.toml

feat: add proper optional-dependencies for each modules (#75 )

2026-02-19 11:08:18 +01:00

README.md

chore: cleanup before v1 (#73 )

2026-02-19 11:49:57 +01:00

uv.lock

chore: cleanup before v1 (#73 )

2026-02-19 11:49:57 +01:00

README.md

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, logging):

uv add fastapi-toolsets

Install only the extras you need:

uv add "fastapi-toolsets[cli]"      # CLI (typer)
uv add "fastapi-toolsets[metrics]"  # Prometheus metrics (prometheus_client)
uv add "fastapi-toolsets[pytest]"   # Pytest helpers (httpx, pytest-xdist)

Or install everything:

uv add "fastapi-toolsets[all]"

Features

Core

CRUD: Generic async CRUD operations with CrudFactory, built-in search with relationship traversal
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
Standardized API Responses: Consistent response format with Response, PaginatedResponse, and PydanticBase
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.