cobra-log 2.0.3

A lightweight Python logging library that combines standard logging with exception-friendly workflows and richer terminal output.

🐱‍👓 cobra-log 🐱‍👓
_{Exception-Aware Logging for Python with Rich Console Output}

About

cobra-log is a lightweight Python logging library that combines standard logging with exception-friendly workflows and richer terminal output.

• Python: 3.9+

Features

• 🚀 Exception-integrated logging API: critical, error, and warning can return/raise typed exceptions while recording context and stack info.
• 🚀 Rich terminal presentation: A custom console formatter supports styled output, bordered exception traces, and optional color support.
• 🚀 Flexible handler management: Easy logger activation plus console, stdout, and rotating file handlers with per-handler levels and conflict/overwrite control.

Installation

Install from PyPI

This installs the core package with minimal dependencies.

pip install cobra-log

Install with Optional Dependencies

color support.

pip install cobra-log[color]

Quick Start

• Simple warning

  from cobra_log import warning, use_logger
  
  use_logger("your_log_file.log")
  
  warning("warning message")
  

Example

from cobra_log import (use_logger, info, warning, error)

# initialize and activate loggers
use_logger("my_logger_1", "stdout", "console")
use_logger("my_logger_2", "log_save_path.log", ("stdout", "error"))
# use my_logger_2
try:
    try:
        try:
            1 / 0
        except Exception as e:
            raise error("An error occurred.", throw=None) from e
    except Exception as ee:
        raise error(
            "An error(TimeoutError) occurred.",
            throw=TimeoutError
        ) from ee
except Exception:
    critical("A critical error occurred.", throw=None)
# activate my_logger_1
use_logger("my_logger_1")
# use my_logger_1
warning("A warning occurred.")
info("An info occurred.")

Requirements

• Python >= 3.9
• (Optional) cobra-color >= 1.3.11

License

See LICENSE in the repository.

Links

• Homepage/Repo
• Issues