Metadata-Version: 2.3
Name: fastapi-healthz
Version: 1.2.4
Summary: A module to have a FastAPI HealthCheck for database, RabbitMQ server, Redis, MongoDB or external URI to validate their healths.
License: MIT
Author: Matteo Cacciola
Author-email: matteo.cacciola@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: FastAPI
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Provides-Extra: all
Provides-Extra: database
Provides-Extra: mongodb
Provides-Extra: rabbitmq
Provides-Extra: redis
Provides-Extra: uri
Requires-Dist: fastapi (>=0.116.1,<0.117.0) ; extra == "rabbitmq" or extra == "redis" or extra == "database" or extra == "mongodb" or extra == "uri" or extra == "all"
Requires-Dist: pika (>=1.3.2,<2.0.0) ; extra == "rabbitmq" or extra == "all"
Requires-Dist: pydantic (>=2.11.7,<3.0.0) ; extra == "rabbitmq" or extra == "redis" or extra == "database" or extra == "mongodb" or extra == "uri" or extra == "all"
Requires-Dist: pymongo (>=4.9.1,<5.0.0) ; extra == "mongodb" or extra == "all"
Requires-Dist: redis (>=6.4.0,<7.0.0) ; extra == "redis" or extra == "all"
Requires-Dist: requests (>=2.32.5,<3.0.0) ; extra == "rabbitmq" or extra == "redis" or extra == "database" or extra == "mongodb" or extra == "uri" or extra == "all"
Requires-Dist: sqlalchemy (>=2.0.43,<3.0.0) ; extra == "database" or extra == "all"
Project-URL: Repository, https://github.com/matteocacciola/fastapi_healthz
Description-Content-Type: text/markdown

# fastapi_healthz

Streamline your health checks with FastAPI using this user-friendly health check module. It serves as the foundational
component for integrating and enhancing health checks within FastAPI.

This core module doesn't include any service checkers by default, but it offers a simple method for adding them. The
reason for housing various modules separately is to accommodate the distinct dependencies required for each, ensuring
that you only import the specific packages you need, thereby preventing any unnecessary package bloat.

**This package is Pydantic v2 compliant**.

## Install

`pip install fastapi-healthz` or `poetry add fastapi-healthz`.

Eventually, you can partially install the package by running

`pip install fastapi-healthz[redis]`

`pip install fastapi-healthz[rabbitmq]`

`pip install fastapi-healthz[database]`

`pip install fastapi-healthz[uri]`

`pip install fastapi-healthz[mongodb]`

to install only the package you really need, with the required dependencies.

## Adding Health Checks

Here is what you need to get started.

```python
from fastapi import FastAPI
from fastapi_healthz import (
    HealthCheckRegistry,
    HealthCheckRabbitMQ,
    HealthCheckRedis,
    HealthCheckUri,
    HealthCheckDatabase,
    health_check_route,
)

app = FastAPI()

# Add Health Checks
_healthChecks = HealthCheckRegistry()

# SQLAlchemy
_healthChecks.add(HealthCheckDatabase(uri="dialect+driver://username:password@host:port/database"))
# RabbitMQ
_healthChecks.add(HealthCheckRabbitMQ(host="localhost", port=5672, vhost="", username="username", password="pwd", ssl=True))
# Redis
_healthChecks.add(HealthCheckRedis(uri="redis://[password:]host:port/database"))
# This will check external URI and validate the response that is returned.
_healthChecks.add(HealthCheckUri(uri="https://www.reddit.com/r/aww.json"))

app.add_api_route('/health', endpoint=health_check_route(registry=_healthChecks))

```

## Returned Data

When you initiate a health check request, it will examine all the submitted entries and execute a fundamental query on
each of them. If the results conform to expectations, a status code of 200 is returned. However, if an error is
encountered, a 500 error response will be provided.

```json
{
    "status":"Healthy",
    "totalTimeTaken":"0:00:00.671642",
    "entities":[
        {
            "alias":"db",
            "status":"Healthy",
            "timeTaken":"0:00:00.009619",
            "tags":["db"]
        },
        {
            "alias":"reddit",
            "status":"Unhealthy",
            "timeTaken":"0:00:00.661716",
            "tags":["uri"]
        }
    ]
}
```

## Writing a custom checker
You can effortlessly extend the functionality of this foundational module by incorporating additional health checks for
various services. Simply create a new service that imports the HealthCheckAbstract. Then, build the corresponding class
around this abstract.

Once your service is prepared, integrate it into the HealthCheckRegistry, and you're all set to commence testing.
