robin-local-logger 0.1.0

A local file logger with automatic size trimming and FastAPI integration (JSON format).

robin_local_logger

Librería de Python para logging local con rotación automática por tamaño (MB) e integración directa con FastAPI mediante rutas JSON protegidas.

Características

• Rotación por espacio: Elimina las líneas más antiguas cuando el archivo supera el límite de MB definido.
• Formato JSON: Todos los logs se guardan y entregan como objetos JSON estructurados.
• Integración FastAPI: Monta automáticamente /robin/logs para lectura y escritura.
• Seguridad: Soporte opcional para API Key mediante el header X-API-Key.
• Captura automática: Captura logs del sistema (Uvicorn/FastAPI).

Instalación

pip install robin-local-logger

Uso Rápido

from fastapi import FastAPI
from robin_local_logger import init_robin_logger

app = FastAPI()

@app.on_event("startup")
async def startup():
    init_robin_logger(
        app, 
        log_file="./logs/app.log", 
        max_mb=5.0, 
        api_key="tu_clave_secreta"
    )

Endpoints

• GET /robin/logs?lines=200: Devuelve los últimos logs en formato JSON.
• POST /robin/logs: Permite registrar logs manualmente enviando {"message": "...", "level": "info"}.