How delgan/loguru works
Loguru is a Python logging library with a preconfigured logger. The main workflow is an application logging call, routed by the logger through configured handlers to a sink, which formats and writes the message. Separate capabilities include exception capture and rich traceback display, file rotation and retention, asynchronous and queued output, and contextual, colored, and structured logging. The graph reflects documented behavior and visible source references; several internal call paths are not shown in the excerpts, so those links are omitted or marked unverified.
Main entry points: _logger.py Logger API · _handler.py Handler · _file_sink.py File sink · __init__.py Public import
Components 19
Logger API
- Logger API
loguru/_logger.py - Public import
loguru/__init__.py - Defaults
loguru/_defaults.py
Routing and sinks
- Handler
loguru/_handler.py - File sink
loguru/_file_sink.py - Simple sinks
loguru/_simple_sinks.py - Async loop
loguru/_asyncio_loop.py - Filters
loguru/_filters.py
Formatting and exceptions
- Colorizer
loguru/_colorizer.py - Exception formatter
loguru/_better_exceptions.py - Date formatting
loguru/_datetime.py - Record attributes
loguru/_recattrs.py
Runtime support
- File option parsers
loguru/_string_parsers.py - Context variables
loguru/_contextvars.py - Error interception
loguru/_error_interceptor.py - Lock machinery
loguru/_locks_machinery.py - Terminal support
loguru/_colorama.py - File timestamps
loguru/_ctime_functions.py
Other components
- Application
Connections 18
- Application → Public import: imports logger
README.md - Public import → Logger API: exposes logger
loguru/__init__.py - Logger API → Handler: dispatches messages
README.md - Handler → File sink: writes messages
- Handler → Simple sinks: writes messages
- Logger API → Defaults: loads defaults
loguru/_logger.py - Logger API → Filters: applies filters
loguru/_logger.py - Handler → Colorizer: formats colors
loguru/_handler.py - Handler → Lock machinery: creates locks
loguru/_handler.py - Simple sinks → Async loop: gets event loop
loguru/_simple_sinks.py - File sink → File option parsers: parses options
loguru/_file_sink.py - File sink → Date formatting: formats dates
loguru/_file_sink.py - File sink → File timestamps: reads timestamps
loguru/_file_sink.py - Logger API → Exception formatter: formats exceptions
loguru/_logger.py - Logger API → Context variables: binds context
loguru/_logger.py - Logger API → Record attributes: builds records
loguru/_logger.py - Logger API → Terminal support: supports terminals
loguru/_logger.py - Logger API → Error interception: intercepts errors
loguru/_logger.py