bluefox-core 0.2.0

The foundation of every Bluefox app — settings, database, logging, health, and app factory.

bluefox-core

The foundation of every Bluefox app — settings, database, logging, health endpoints, and app factory for FastAPI.

Quick start

uv init my-app && cd my-app
uv add bluefox-core

# main.py
from bluefox_core import BluefoxSettings, create_bluefox_app

settings = BluefoxSettings()
app = create_bluefox_app(settings)

uv run uvicorn main:app --reload

What you get

• Settings — Typed configuration via pydantic-settings. Reads from environment variables and .env files.
• Async database — SQLAlchemy 2.x with asyncpg. Engine lifecycle, session dependency, URL normalization.
• Structured logging — structlog with JSON in production, colored console in development. Request IDs via contextvars.
• Health endpoints — /health for liveness, /readiness for dependency checks.
• Request ID middleware — Generates or preserves X-Request-ID headers, bound to log context.
• App factory — One function wires everything together and returns a standard FastAPI app.

Demo app

Pass demo=True to get a working Todo CRUD app:

app = create_bluefox_app(settings, demo=True)
# Visit /docs to interact with the Todo API

Links

• Documentation
• PyPI
• Bluefox Stack