mirror of https://github.com/d3vyce/fastapi-toolsets.git synced 2026-04-15 22:26:25 +02:00

Go to file

dependabot[bot] f310466697 ⬆ Bump codecov/codecov-action from 5 to 6 (#211 )

Bumps [codecov/codecov-action](https://github.com/codecov/codecov-action) from 5 to 6.
- [Release notes](https://github.com/codecov/codecov-action/releases)
- [Changelog](https://github.com/codecov/codecov-action/blob/main/CHANGELOG.md)
- [Commits](https://github.com/codecov/codecov-action/compare/v5...v6)

---
updated-dependencies:
- dependency-name: codecov/codecov-action
  dependency-version: '6'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

2026-04-02 11:00:22 +02:00

.github

⬆ Bump codecov/codecov-action from 5 to 6 (#211 )

2026-04-02 11:00:22 +02:00

docs

feat: consolidate *_params dependencies into per-paginate-style methods with feature toggles (#209 )

2026-04-01 20:53:14 +02:00

docs_src

feat: consolidate *_params dependencies into per-paginate-style methods with feature toggles (#209 )

2026-04-01 20:53:14 +02:00

src/fastapi_toolsets

feat: consolidate *_params dependencies into per-paginate-style methods with feature toggles (#209 )

2026-04-01 20:53:14 +02:00

tests

feat: consolidate *_params dependencies into per-paginate-style methods with feature toggles (#209 )

2026-04-01 20:53:14 +02:00

.gitignore

Initial commit

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

.pre-commit-config.yaml

chore: add prek (pre-commit alternative)

2026-03-25 14:24:30 -04: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

docs: add documentation versioning (#125 )

2026-03-30 18:55:38 +02:00

README.md

feat: rework async event system (#196 )

2026-03-30 18:24:36 +02:00

uv.lock

feat: consolidate *_params dependencies into per-paginate-style methods with feature toggles (#209 )

2026-04-01 20:53:14 +02:00

zensical.toml

feat: rework async event system (#196 )

2026-03-30 18:24:36 +02: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, 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.