fastutils-hmarcuzzo

Python library for FastAPI, boosting SQLAlchemy and Redis with pagination, error handling, and session management.

FastUtils is a comprehensive Python library designed for FastAPI. It provides robust support for both asynchronous and synchronous operations with SQLAlchemy and asynchronous operations with Redis. Key features include dynamic pagination, custom error handling, automatic database session management within a context manager, and much more.

Source Code: https://github.com/hmarcuzzo/fast-utils

Features

• Fully Async: Leverages Python's async capabilities for non-blocking database operations.
• SQLAlchemy 2.0: Works with the latest SQLAlchemy version for robust database interactions.
• Redis Support: Provides support for Redis for caching and other operations.
• Dynamic Query Building: Supports building simple queries dynamically, including filtering, sorting, and pagination.
• Built-in Offset Pagination: Comes with ready-to-use offset pagination.
• Custom Error Handling: Provides custom error handling for better debugging and user experience.
• Session Management: Automatically manages database sessions within a context manager.

Requirements

Before installing FastUtils, ensure you have the following prerequisites:

• Python: Version 3.10 or newer.
• FastAPI: FastUtils is built to work with FastAPI, so having FastAPI in your project is essential.
• SQLAlchemy: FastUtils uses SQLAlchemy 2.0 for database operations, so you need SQLAlchemy 2.0 or newer.
• Pydantic V2: FastUtils leverages Pydantic models for data validation and serialization, so you need Pydantic 2.0 or newer.
• Redis: If you plan to use Redis with FastUtils, you need to have Redis installed and running in a version 5.0 or newer.

Installing

To install the fastutils-hmarcuzzo package, follow these steps:

Using pip

Run the following command:

pip install fastutils-hmarcuzzo

Using Poetry

Run the following command:

poetry add fastutils-hmarcuzzo

License

This project is licensed under the terms of the MIT license.