Home

🐍 SimpleColoredLogs: Das Produktive Logging-Framework

Ein vollständiger, hochperformanter und intelligenter Terminal Logger, konzipiert für Microservices, Data Pipelines und Discord Bots.

---

🚀 Kern-Features im Überblick

• 148 Farbige Kategorien: Extrem granulare, thematisch gruppierte Kategorien (z.B. FRAUD, KUBERNETES, I18N).
• Intelligente Steuerung: Adaptive Logging zur dynamischen Reduzierung der Log-Lautstärke unter Last.
• Sicherheit (Zero Trust): Automatische Sensitive Data Redaction von Tokens, Passwörtern und API-Schlüsseln.
• Observability Ready: Natives Correlation ID Tracing und Prometheus Metrics Export integriert.
• Umweltbewusst: Environment-Aware Coloring zur visuellen Unterscheidung von DEV, STAGING und PROD.

---

📦 Installation und Quick Start

Installation

pip install SimpleColoredLogs

Quick Start: Basis-Setup

from logs import Logs, LogLevel, Category, LogFormat

# Globale Konfiguration: Einmal beim Start aufrufen
Logs.configure(
    log_file="api_service.log",         # Aktiviert File-Logging
    min_level=LogLevel.DEBUG,           # Alles ab DEBUG loggen
    format_type=LogFormat.JSON,         # Für externe Log-Systeme (ELK, Splunk)
    enable_redaction=True,              # Aktiviert Sicherheits-Maskierung
    environment="PROD"                  # Setzt die Umgebung (färbt den Präfix ROT)
)

# Beispiel-Logs
Logs.info(Category.SYSTEM, "Service erfolgreich gestartet.", version="1.5.0")
Logs.success(Category.DATABASE, "Datenbank-Commit erfolgreich", rows=500)

# Fehler-Log mit Metadaten
try:
    process_batch()
except Exception as e:
    # Die exception wird automatisch in den Metadaten und im Traceback gespeichert.
    Logs.error(Category.RUNTIME, "Fehler in der Verarbeitung.", exception=e, input_size=120)