Skip to main content

A stylish and colorful Python logging module with customizable console output

Project description

BeamLogger

A stylish and colorful Python logging module with customizable console output.

Features

  • Beautiful colorized log output with different colors for each log level
  • Custom time stamps in 12-hour format
  • Stylish banners with gradient colors using pystyle
  • Custom console window title (Cross-platform - Windows, Linux, macOS)
  • Input prompt with styled formatting
  • Multiple log levels: info, debug, log, success, input, output, error, critical, warn

Requirements

  • colorama
  • pystyle
  • Python 3.6+

Installation

pip install BeamLogger

Usage

from beamlogger import BeamLogger
import platform

# Initialize logger with custom title
system = platform.system()
logger = BeamLogger(f"My Application on {system}")

# Display a banner
banner = """
██████╗ ███████╗ █████╗ ███╗   ███╗██╗      ██████╗  ██████╗  ██████╗ ███████╗██████╗ 
██╔══██╗██╔════╝██╔══██╗████╗ ████║██║     ██╔═══██╗██╔════╝ ██╔════╝ ██╔════╝██╔══██╗
██████╔╝█████╗  ███████║██╔████╔██║██║     ██║   ██║██║  ███╗██║  ███╗█████╗  ██████╔╝
██╔══██╗██╔══╝  ██╔══██║██║╚██╔╝██║██║     ██║   ██║██║   ██║██║   ██║██╔══╝  ██╔══██╗
██████╔╝███████╗██║  ██║██║ ╚═╝ ██║███████╗╚██████╔╝╚██████╔╝╚██████╔╝███████╗██║  ██║
╚═════╝ ╚══════╝╚═╝  ╚═╝╚═╝     ╚═╝╚══════╝ ╚═════╝  ╚═════╝  ╚═════╝ ╚══════╝╚═╝  ╚═╝
"""
logger.banner(banner)

# Different log levels
logger.info("This is an information message")
logger.debug("This is a debug message")
logger.log("This is a regular log message")
logger.success("This is a success message")
logger.warn("This is a warning message")
logger.error("This is an error message")
logger.critical("This is a critical message")

# Get user input
name = logger.input("Please enter your name", "Name")
logger.info(f"Hello, {name}!")

# Change console title
logger.set_title(f"New Title - {name}")

Log Format

The log format follows this pattern:

[Time stamp in 12hrs] ❆ [PREFIX] ➔ Message

For example:

[09:45:32 AM] ❆ [INFO] ➔ This is an information message

Custom Banners

You can create custom banners with different colors:

logger.banner("Your ASCII Art Here", color=pystyle.Colors.purple_to_blue, spacing=10)

Running the Example

To see BeamLogger in action, run the included example:

py example.py

Changelog

v0.1.3

  • Added cross-platform support for console title setting (Windows, Linux, macOS)
  • Fixed console title setting errors on Linux systems
  • Improved error handling for platform-specific features

Crafted With <3 By Bhaskar

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

BeamLogger-0.1.4.tar.gz (6.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

BeamLogger-0.1.4-py3-none-any.whl (7.0 kB view details)

Uploaded Python 3

File details

Details for the file BeamLogger-0.1.4.tar.gz.

File metadata

  • Download URL: BeamLogger-0.1.4.tar.gz
  • Upload date:
  • Size: 6.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.6

File hashes

Hashes for BeamLogger-0.1.4.tar.gz
Algorithm Hash digest
SHA256 a02f22f7515d482c196f1cc357e51fb6977488656f654208464fb5e94697e1b4
MD5 d7b05ba5ca1c5456e18b1e524c47d38f
BLAKE2b-256 a04be373b29fcf8a10a3f05c06853127b9948b31fc58609399ce06ef8f523cb5

See more details on using hashes here.

File details

Details for the file BeamLogger-0.1.4-py3-none-any.whl.

File metadata

  • Download URL: BeamLogger-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 7.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.6

File hashes

Hashes for BeamLogger-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 1ea4097ac21963e28a1367e23b03c4fbea2f52bc2182361f6075f73b1afae989
MD5 d78b2cd8e5756b75aa59d8f9a55bbc69
BLAKE2b-256 3e2ef961d68c8f5aa9d2e3d1f31095cab7a05cd666251d040608a2a1c294ed36

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page