loguru-kit 0.7.0

Dead simple loguru setup

loguru-kit

Safe & extensible loguru setup with conflict-free isolation.

Language: 한국어 | English

Installation

pip install loguru-kit

Quick Start

from loguru_kit import setup, get_logger

setup()
logger = get_logger(__name__)
logger.info("Hello, world!")

Features

• Conflict-free: No logger.remove() - safe to use alongside other loguru users
• Isolated loggers: Each module gets its own context via logger.bind()
• Async-safe: contextvars-based context propagation
• Simplified API: One-line setup for common use cases (JSON, File, OTEL)
• Integrations: FastAPI middleware, OpenTelemetry, stdlib intercept

Configuration

Parameters for setup()

Parameter	Type	Default	Description
level	str	"INFO"	Log level
json	bool	False	Enable JSON output
truncate	int	10000	Max message length
file	str | None	None	File path for file logging
rotation	str | int | None	None	File rotation (e.g., "10 MB", "1 day")
retention	str | int | None	None	File retention (e.g., "7 days")
intercept	list[str] | None	None	stdlib loggers to intercept
otel	bool	False	Enable OpenTelemetry trace injection
force	bool	False	Force reconfiguration

Environment Variables

Variable	Default	Description
LOGURU_KIT_LEVEL	INFO	Log level
LOGURU_KIT_JSON	false	JSON output

Priority: code > env > defaults

File Logging

from loguru_kit import setup

setup(
    file="logs/app.log",
    rotation="10 MB",
    retention="7 days"
)

FastAPI Integration

pip install loguru-kit[fastapi]

from fastapi import FastAPI
from loguru_kit import setup, get_logger
from loguru_kit.integrations.fastapi import LoggingMiddleware

setup()
app = FastAPI()
app.add_middleware(LoggingMiddleware, exclude_paths=["/healthz"])

logger = get_logger(__name__)

@app.get("/")
async def root():
    logger.info("Request received")
    return {"status": "ok"}

OpenTelemetry

pip install loguru-kit[otel]

from loguru_kit import setup, get_logger

# Enable OTEL trace injection
setup(otel=True)
logger = get_logger(__name__)

logger.info("This log will have trace_id and span_id")

stdlib Intercept

from loguru_kit import setup

# Intercept specific stdlib loggers
setup(intercept=["uvicorn", "sqlalchemy"])

License

MIT License - See LICENSE for details.