Thinlog

Thinlog is a lightweight, fully-typed Python logging toolkit that extends the standard logging library with extra wheels:

• Wildcard logger configuration – define a single "*" logger and have it applied to every registered logger automatically.

• Keyword-friendly logging – pass keyword arguments directly; they become extra fields on the log record.

• Advanced filters – whitelist, blocklist, and conditional attribute assignment without writing custom filter classes.

• Structured JSON output – rich exception context powered by structlog.

• Remote logging – send logs to an HTTP endpoint or a Telegram chat out of the box.

• Fully typed – strict MyPy compliance with a py.typed PEP 561 marker.

Getting started

Install from PyPI:

pip install thinlog

Then head over to the Quick Start to see Thinlog in action.

Contents

• Quick Start
  • Installation
  • Minimal example
  • Console logging with StreamHandler
  • Rich handler
  • JSON logging with QueueHandler
  • Keyword arguments as extra fields
  • Next steps
• Configuration
  • LoggingSettings
  • TOML configuration structure
  • Wildcard logger ("*")
  • Merge ("merge": true)
  • Multi-process applications
  • Separate loggers per component
  • Full example
  • API reference
• Filters
  • WhitelistFilter
  • BlocklistFilter
  • AssignerFilter
  • Custom context filters
  • Complete example with filters
  • Common patterns
• Handlers
  • JsonHTTPHandler
  • TelegramHandler
  • CtxPrintHandler
• Formatters
  • JsonFormatter
  • MsgFormatter
  • TelegramFormatter
• API Reference
  • Core
  • Filters
  • Formatters
  • Handlers