python-zenlog - GitLite

KO | EN

gitlite — search

#python #llm #golang #go #rust #deep-learning #nodejs #macos #java #cli #vue #mcp #ios #openai

python-zenlog

(★ 53)

Python script logging for the lazy

File Explorer

Download Latest Version (.zip)

- __init__.py
.gitignore
colorlogs.png
LICENSE
README.md
requirements.txt
setup.py
tests.py

# Installation Guide

1. Get the code

git clone https://github.com/ManufacturaInd/python-zenlog

Downloads the entire project code from GitHub to your computer.

cd python-zenlog

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended

Prerequisites

Python 3 Python is required to use pip.

pip install zenlog

Installs the package published on PyPI directly — no need to clone the source.

✅ After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

3. Python

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

pip install zenlog

Installs the package published on PyPI directly — no need to clone the source.

✅ If it runs without errors and prints output in the terminal, it worked.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Zenlog is a Python logging tool for lazy people, meant for quick use of 
prettified log messages.

Usage
-----

Don't want to stop to read the docs every time you want to have some
quick logging in a hacky script you're writing? Just one line and 
you're good to go:

from zenlog import log

It should then be easy to get going:

log.debug("A quirky message only developers care about")
    log.info("Curious users might want to know this")
    log.warn("Something is wrong and any user should be informed")
    log.error("Serious stuff, this is red for a reason")
    log.critical("OH NO everything is on fire")

Output:

![Zenlog output](https://github.com/ManufacturaInd/python-zenlog/raw/master/colorlogs.png)

You can be as lazy as you want:

log.crit("Abbreviations are fine")
    log.c("First letters also work")
    
A keystroke saved is a bone joint slightly spared! ;o)

Installation
------------

Also simple:

pip install zenlog

Design rationale
----------------

Zenlog is a very light wrapper around 
[colorlog](https://github.com/borntyping/python-colorlog), a wonderful library
for color output in logging messages. In addition, Zenlog hides
the standard library logger hierarchy, using only the root logging
instance.

**Isn't this dumbing down the standard logging module?**

Indeed, many features of the stdlib logging module are hidden away
for the sake of simplicity and sanity.

Zenlog probably won't fit many advanced uses, but it's good for quick scripts
that could use easy-to-read and clear log output with a dead simple
interface.

Nevertheless, it would be desirable to make use of the powerful
advanced features of the logging module without introducing
unnecessary complexity to the interface. Pull requests and suggestions
are very welcome!

Switching from the standard logging library
-------------------------------------------

It's straightforward to adapt to scripts that already make use 
of the standard logging library. Just change the line:

import logging

to

from zenlog import logging

And it should make your log messages more readable.

> **Note:** This is only possible if you're directly acessing 
the root logger in your script -- that is, you're not using 
advanced features like multiple loggers or any kind of custom 
changes to the standard logging behavior.

Alternative Import
------------------

You can also import it like this:

try: from zenlog import log as logging 
    except: import logging
    logging.info("info")

That way if zenlog is not installed the standard logging moddule is used and logging still works.
Or if you want to replace the default logger with zenlog without changing the code you can import it like this.

Testing
-------

Unit tests are done using Nose:

nosetests tests.py

Missing features
----------------

Important:

* go beyond styling the errorlevel names, provide other
    variables like human timestamp, username, hostname...
  * datetime support and other useful log output
  * testing on any terminal other than uxterm
  * finer-grained color control
  * make it easy for any coder to change the theme to their style

Less-priority but also important:

* "theme" support, emulating some used log schemes (Xorg, Gentoo...)
  * come up with a simpler template system for theming (a layer on top
    of the shell commands) -- a subset of CSS? See [term-css](https://www.npmjs.org/package/term-css) for the syntax
  * Use of fancy Unicode characters
  * Additional sets of levels other than debug, info, etc?
  * Always show line numbers on debug?