Metadata-Version: 2.4
Name: starlette-healthcheck
Version: 1.2.0
Summary: Structured ASGI request logging and remote log aggregation for FastAPI/Starlette.
Author: ForbiddenFruit
License-Expression: MIT
License-File: LICENSE
Keywords: asgi,logging,middleware,observability
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: Developers
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: Topic :: System :: Logging
Requires-Python: >=3.10
Requires-Dist: starlette>=0.27.0
Description-Content-Type: text/markdown

# Starlette Healthcheck — Python

Structured ASGI request logging middleware and log aggregation for Starlette/FastAPI applications.

## Features

- **ASGI middleware** — logs each request method, path, status code, and duration
- **Structured logging** — configurable console output with standard datetime formatting
- **Remote log aggregation** — sends log entries to a centralised collector service (configurable endpoint and API key)
- **Thread-safe startup registration** — non-blocking handler registration on initialisation

## Installation

```bash
pip install starlette-healthcheck
```

## Quick Start

```python
from starlette_healthcheck import configure_logging, HealthcheckMiddleware
from fastapi import FastAPI

configure_logging(level="INFO")

app = FastAPI()
app.add_middleware(HealthcheckMiddleware)
```

## Consuming in Your App

```bash
pip install starlette-healthcheck
```

```python
from starlette_healthcheck import configure_logging, HealthcheckMiddleware
```
