read_transactions.logger

author:

Tim Häberlein

version:

1.2

date:

24.10.2025

organisation:

TU Dresden, FZM

Attributes

logfile

Classes

MainLogger	Globale, rekonfigurierbare Logging-Klasse für das gesamte Paket.
JsonFormatter	Formatter, der Logeinträge als JSON ausgibt.

Module Contents

class read_transactions.logger.MainLogger

Globale, rekonfigurierbare Logging-Klasse für das gesamte Paket.

__default_level = 10

__logfile_path: str | None = None

_per_logger_targets: set[str]

_root_logger: logging.Logger | None = None

classmethod configure(level: str = 'DEBUG', logfile: str | None = None, fmt: str | None = None) → None

(Re)Initialisiert das globale Logging-System. Kann beliebig oft aufgerufen werden, alte Handler werden ersetzt.

Parameter:

• level – Basis-Log-Level für den Logger (Default: DEBUG)

• logfile – Pfad zur Logdatei (optional)

• fmt – Optional benutzerdefiniertes Logformat

classmethod get_logger(name: str | None = None) → logging.Logger

Gibt einen Unterlogger zurück, der an den MainLogger angehängt ist.

classmethod set_level(level: str) → None

Ändert den globalen Logger-Level (wirkt auf alle Handler).

classmethod set_stream_level(level: str) → None

Ändert nur den Level des StreamHandlers (Konsole).

classmethod set_file_level(level: str) → None

Ändert nur den Level des FileHandlers.

classmethod debug_overview() → str

Gibt eine Übersicht der aktuellen Logging-Konfiguration als string zurück: - Logger-Level - Handler-Levels (Stream/File) - Pfad zur Logdatei

classmethod attach_file_for(name: str, logfile: str | None = None, level: str | None = None, max_bytes: int = 1 * 1024 * 1024, backup_count: int = 1) → None

Hängt einen FileHandler an den Hauptlogger, der nur Logs des Unterloggers ‚read_transactions.<logger_name>‘ durchlässt.

classmethod detach_file_for(name: str) → int

Entfernt alle per-Logger FileHandler für ‚read_transactions.<name>‘. Gibt die Anzahl entfernter Handler zurück.

classmethod _rebuild_central_filter() → None

class read_transactions.logger.JsonFormatter(fmt=None, datefmt=None, style='%', validate=True, *, defaults=None)

Bases: logging.Formatter

Formatter, der Logeinträge als JSON ausgibt.

format(record)

Format the specified record as text.

The record’s attribute dictionary is used as the operand to a string formatting operation which yields the returned string. Before formatting the dictionary, a couple of preparatory steps are carried out. The message attribute of the record is computed using LogRecord.getMessage(). If the formatting string uses the time (as determined by a call to usesTime(), formatTime() is called to format the event time. If there is exception information, it is formatted using formatException() and appended to the message.

read_transactions.logger.logfile