Skip to main content

A beautiful, configurable colored logging utility for Python

Project description

🥝 KiwiLog

A beautiful, colorful logging utility for Python

Python Status License

Elegant • Minimal • Readable • Colorful


Overview

KiwiLog is a lightweight Python logging utility designed to make terminal output clean, colorful, and easy to read.

Instead of dealing with complex logging frameworks, KiwiLog provides simple functions for common log types.

Perfect for:

  • CLI tools
  • Scripts
  • Debugging
  • Automation
  • Bots
  • Development utilities

Available Commands / How to Use

KiwiLog provides simple, color-coded logging functions:

Command Description Example
trace(msg) Very low-level tracing kiwilog.trace("Step 1 check")
debug(msg) Debugging details kiwilog.debug("Loading configuration")
info(msg) General information kiwilog.info("Server started")
notice(msg) Important notices kiwilog.notice("Update available")
success(msg) Success messages kiwilog.success("Build completed")
waiting(msg) Waiting for action kiwilog.waiting("Awaiting input")
warn(msg) Warnings kiwilog.warn("Low disk space")
error(msg) Errors kiwilog.error("Failed to connect")
critical(msg) Fatal or critical errors kiwilog.critical("Database unavailable")

🌀 Loading Animation

Show a beautiful loading animation for long-running tasks:

with kiwilog.loading("Processing data"):
    time.sleep(3)
    # Your work here
kiwilog.success("Data processed!")

📦 Installation

pip install kiwilog

⚙️ Configuration

You can now configure KiwiLog to suit your needs:

import kiwilog

kiwilog.configure(
    level="DEBUG",               # Minimum log level
    log_to_file=True,           # Enable/disable file logging
    log_file="logs/my_bot.log", # Custom log path
    show_timestamp=True,        # Show [HH:MM:SS] in console
    show_filename=True          # Show [filename.py] in console
)

Log Levels

Available levels: DEBUG, INFO, SUCCESS, WARN, ERROR, CRITICAL. Default is INFO.

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

kiwilog-0.2.1.tar.gz (4.9 kB view details)

Uploaded Source

Built Distribution

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

kiwilog-0.2.1-py3-none-any.whl (4.2 kB view details)

Uploaded Python 3

File details

Details for the file kiwilog-0.2.1.tar.gz.

File metadata

  • Download URL: kiwilog-0.2.1.tar.gz
  • Upload date:
  • Size: 4.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for kiwilog-0.2.1.tar.gz
Algorithm Hash digest
SHA256 e90c3b18b033875bf8bc2a4d595b7d84263eec5d0564047edd74acf0d4176663
MD5 0bd3bcbc48adc1ddc327590c860fab90
BLAKE2b-256 9ef54b389c5ddf0d5319a87cc2155c454b0a148634a3ef88b73c8663ff736a29

See more details on using hashes here.

File details

Details for the file kiwilog-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: kiwilog-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 4.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for kiwilog-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 7d5000438b868c6964b03edcd7ef16096150e6bce4d35cece5d663e6d71229f1
MD5 ee77e7f8121983b3d6d43d974fe1373d
BLAKE2b-256 6c94b5b0fae3b359747f274adc6a94434c64bbbca75545376af028cf452f91e3

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