cobra-log 2.0.4

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")
  

• Basic usage:

  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.13

License

See LICENSE in the repository.

Links

• Homepage/Repo
• Issues