codechu-log 0.1.0

Stdlib-only structured logging — rotation, JSON, context, redaction.

codechu-log

Stdlib-only structured logging for Python 3.10+. One call configures a rotating file handler, a TTY-aware console handler, optional JSON output, and a redaction list. Context is propagated through contextvars so it works across await boundaries.

from codechu_log import setup, bind, Context

log = bind(setup("myapp", file="app.log", json=True), service="api")

with Context(request_id="r-42"):
    log.info("started", user="onur")

Output (one JSON object per line):

{"ts": "2026-05-20T12:34:56.789012+00:00", "level": "INFO",
 "logger": "myapp", "msg": "started",
 "fields": {"service": "api", "request_id": "r-42", "user": "onur"},
 "exc_info": null, "pid": 4321, "thread": "MainThread"}

Features

• setup(name, *, level, file, json, max_bytes, backup_count, fmt, redact) — one-call configuration with RotatingFileHandler and a TTY-aware console handler.
• Context(**fields) — context manager backed by contextvars; nested scopes merge, child wins on key conflict, propagation survives await.
• bind(logger, **fields) — always-on fields per logger.
• structured(logger) — log.info("msg", key=value) lifts kwargs into the structured payload.
• redact=[...] — replace listed field keys with <redacted> in both text and JSON output.

Install

pip install codechu-log

Documentation

• API reference — every public symbol and the JSON schema.
• Recipes — common configurations.
• CHANGELOG

License

MIT — see LICENSE.