Skip to content

Structlog integration for FastAPI, because setting this stuff up should not take the bulk of your dev time.

Notifications You must be signed in to change notification settings

ApprenticeofEnder/speedbeaver

Repository files navigation

SpeedBeaver - Structlog Integration for FastAPI

When asked what their favourite part of a new project is, I can guarantee you very few developers will say this: setting up logging.

Thing is, logs are crucial for both security and development, giving you detailed insights as to what's going on at any given point with an application. They just . . . really suck to set up.

SpeedBeaver was built to have a simple, approachable, set-it-and-forget-it way of setting up logging middleware in FastAPI using structlog. It's designed as an alternative to the existing fastapi-structlog.

Current Status

The integration is currently in a pre-alpha state. API is subject to change, as is the name of the library itself, even.

Features

  • 3-4 lines of config for the basics
  • Optional BYOP (Bring Your Own Processors)
  • Environment variable configuration via Pydantic Settings
  • File logging

Planned Features and Items

  • OpenTelemetry integrations
  • Database integrations
  • Documentation

Installation

pip install speedbeaver

Configuration

To drop SpeedBeaver into any FastAPI app, see the following Python snippet:

# main.py
from fastapi import FastAPI

import speedbeaver

app = FastAPI()
speedbeaver.quick_configure(app)

logger = speedbeaver.get_logger()


@app.get("/")
async def index():
    await logger.adebug("I'm a debug message!")
    await logger.ainfo("Hello, world!")
    return {"message": "Hello, world!"}

You can see results immediately running the application with uvicorn:

uvicorn main:app --reload

An example of the logger in action.

About

Structlog integration for FastAPI, because setting this stuff up should not take the bulk of your dev time.

Resources

Stars

Watchers

Forks

Packages

No packages published