# delgan/loguru architecture

> Architecture diagram of the GitHub repository delgan/loguru, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/delgan/loguru
- Repository: https://github.com/delgan/loguru

## Overview

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: [`loguru/_logger.py`](https://github.com/delgan/loguru/blob/master/loguru/_logger.py) (Logger API), [`loguru/_handler.py`](https://github.com/delgan/loguru/blob/master/loguru/_handler.py) (Handler), [`loguru/_file_sink.py`](https://github.com/delgan/loguru/blob/master/loguru/_file_sink.py) (File sink), [`loguru/__init__.py`](https://github.com/delgan/loguru/blob/master/loguru/__init__.py) (Public import)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Logger API"]
  node_logger["Logger API<br/>[_logger.py]"]
  node_public["Public import<br/>[__init__.py]"]
  node_defaults["Defaults<br/>[_defaults.py]"]
end

subgraph group_dispatch["Routing and sinks"]
  node_handler["Handler<br/>[_handler.py]"]
  node_file["File sink<br/>[_file_sink.py]"]
  node_simple["Simple sinks<br/>[_simple_sinks.py]"]
  node_asyncio["Async loop<br/>[_asyncio_loop.py]"]
  node_filters["Filters<br/>[_filters.py]"]
end

subgraph group_presentation["Formatting and exceptions"]
  node_colorizer["Colorizer<br/>[_colorizer.py]"]
  node_exceptions["Exception formatter"]
  node_datetime["Date formatting<br/>[_datetime.py]"]
  node_record["Record attributes<br/>[_recattrs.py]"]
end

subgraph group_support["Runtime support"]
  node_parsers["File option parsers<br/>[_string_parsers.py]"]
  node_context["Context variables<br/>[_contextvars.py]"]
  node_errors["Error interception"]
  node_locks["Lock machinery"]
  node_colorama["Terminal support<br/>[_colorama.py]"]
  node_ctime["File timestamps"]
end

node_application(("Application"))

node_application -->|"imports logger"| node_public
node_public -->|"exposes logger"| node_logger
node_logger -->|"dispatches messages"| node_handler
node_handler -.->|"writes messages"| node_file
node_handler -.->|"writes messages"| node_simple
node_logger -.->|"loads defaults"| node_defaults
node_logger -.->|"applies filters"| node_filters
node_handler -->|"formats colors"| node_colorizer
node_handler -->|"creates locks"| node_locks
node_simple -->|"gets event loop"| node_asyncio
node_file -->|"parses options"| node_parsers
node_file -->|"formats dates"| node_datetime
node_file -.->|"reads timestamps"| node_ctime
node_logger -.->|"formats exceptions"| node_exceptions
node_logger -.->|"binds context"| node_context
node_logger -.->|"builds records"| node_record
node_logger -.->|"supports terminals"| node_colorama
node_logger -.->|"intercepts errors"| node_errors

click node_logger "https://github.com/delgan/loguru/blob/master/loguru/_logger.py"
click node_public "https://github.com/delgan/loguru/blob/master/loguru/__init__.py"
click node_defaults "https://github.com/delgan/loguru/blob/master/loguru/_defaults.py"
click node_handler "https://github.com/delgan/loguru/blob/master/loguru/_handler.py"
click node_file "https://github.com/delgan/loguru/blob/master/loguru/_file_sink.py"
click node_simple "https://github.com/delgan/loguru/blob/master/loguru/_simple_sinks.py"
click node_asyncio "https://github.com/delgan/loguru/blob/master/loguru/_asyncio_loop.py"
click node_filters "https://github.com/delgan/loguru/blob/master/loguru/_filters.py"
click node_colorizer "https://github.com/delgan/loguru/blob/master/loguru/_colorizer.py"
click node_exceptions "https://github.com/delgan/loguru/blob/master/loguru/_better_exceptions.py"
click node_datetime "https://github.com/delgan/loguru/blob/master/loguru/_datetime.py"
click node_record "https://github.com/delgan/loguru/blob/master/loguru/_recattrs.py"
click node_parsers "https://github.com/delgan/loguru/blob/master/loguru/_string_parsers.py"
click node_context "https://github.com/delgan/loguru/blob/master/loguru/_contextvars.py"
click node_errors "https://github.com/delgan/loguru/blob/master/loguru/_error_interceptor.py"
click node_locks "https://github.com/delgan/loguru/blob/master/loguru/_locks_machinery.py"
click node_colorama "https://github.com/delgan/loguru/blob/master/loguru/_colorama.py"
click node_ctime "https://github.com/delgan/loguru/blob/master/loguru/_ctime_functions.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_logger,node_public,node_defaults toneBlue
class node_handler,node_file,node_simple,node_asyncio,node_filters toneAmber
class node_colorizer,node_exceptions,node_datetime,node_record toneMint
class node_parsers,node_context,node_errors,node_locks,node_colorama,node_ctime toneRose
class node_application toneIndigo
```

## Components

### Logger API

- [Logger API](https://github.com/delgan/loguru/blob/master/loguru/_logger.py): `loguru/_logger.py`
- [Public import](https://github.com/delgan/loguru/blob/master/loguru/__init__.py): `loguru/__init__.py`
- [Defaults](https://github.com/delgan/loguru/blob/master/loguru/_defaults.py): `loguru/_defaults.py`

### Routing and sinks

- [Handler](https://github.com/delgan/loguru/blob/master/loguru/_handler.py): `loguru/_handler.py`
- [File sink](https://github.com/delgan/loguru/blob/master/loguru/_file_sink.py): `loguru/_file_sink.py`
- [Simple sinks](https://github.com/delgan/loguru/blob/master/loguru/_simple_sinks.py): `loguru/_simple_sinks.py`
- [Async loop](https://github.com/delgan/loguru/blob/master/loguru/_asyncio_loop.py): `loguru/_asyncio_loop.py`
- [Filters](https://github.com/delgan/loguru/blob/master/loguru/_filters.py): `loguru/_filters.py`

### Formatting and exceptions

- [Colorizer](https://github.com/delgan/loguru/blob/master/loguru/_colorizer.py): `loguru/_colorizer.py`
- [Exception formatter](https://github.com/delgan/loguru/blob/master/loguru/_better_exceptions.py): `loguru/_better_exceptions.py`
- [Date formatting](https://github.com/delgan/loguru/blob/master/loguru/_datetime.py): `loguru/_datetime.py`
- [Record attributes](https://github.com/delgan/loguru/blob/master/loguru/_recattrs.py): `loguru/_recattrs.py`

### Runtime support

- [File option parsers](https://github.com/delgan/loguru/blob/master/loguru/_string_parsers.py): `loguru/_string_parsers.py`
- [Context variables](https://github.com/delgan/loguru/blob/master/loguru/_contextvars.py): `loguru/_contextvars.py`
- [Error interception](https://github.com/delgan/loguru/blob/master/loguru/_error_interceptor.py): `loguru/_error_interceptor.py`
- [Lock machinery](https://github.com/delgan/loguru/blob/master/loguru/_locks_machinery.py): `loguru/_locks_machinery.py`
- [Terminal support](https://github.com/delgan/loguru/blob/master/loguru/_colorama.py): `loguru/_colorama.py`
- [File timestamps](https://github.com/delgan/loguru/blob/master/loguru/_ctime_functions.py): `loguru/_ctime_functions.py`

### Other components

- **Application**

## Connections

- Application → Public import: imports logger (evidence: `README.md`)
- Public import → Logger API: exposes logger (evidence: `loguru/__init__.py`)
- Logger API → Handler: dispatches messages (evidence: `README.md`)
- Handler → File sink: writes messages
- Handler → Simple sinks: writes messages
- Logger API → Defaults: loads defaults (evidence: `loguru/_logger.py`)
- Logger API → Filters: applies filters (evidence: `loguru/_logger.py`)
- Handler → Colorizer: formats colors (evidence: `loguru/_handler.py`)
- Handler → Lock machinery: creates locks (evidence: `loguru/_handler.py`)
- Simple sinks → Async loop: gets event loop (evidence: `loguru/_simple_sinks.py`)
- File sink → File option parsers: parses options (evidence: `loguru/_file_sink.py`)
- File sink → Date formatting: formats dates (evidence: `loguru/_file_sink.py`)
- File sink → File timestamps: reads timestamps (evidence: `loguru/_file_sink.py`)
- Logger API → Exception formatter: formats exceptions (evidence: `loguru/_logger.py`)
- Logger API → Context variables: binds context (evidence: `loguru/_logger.py`)
- Logger API → Record attributes: builds records (evidence: `loguru/_logger.py`)
- Logger API → Terminal support: supports terminals (evidence: `loguru/_logger.py`)
- Logger API → Error interception: intercepts errors (evidence: `loguru/_logger.py`)
