Skip to main content

Python Easy Logging (LOGG EZ)

Project description

loggez: Python EZ logging

Control logging levels with env vars and have a unique logger per name, for fine-tuned control over logging in various subsystems of your application. By default it only writes to stderr. Optional support for logging to a file too.

Installation

pip install loggez

Usage:

# run.py
from loggez import make_logger, loggez_logger
from loguru import logger # compatibility with other logging systems

logger.info("loguru hi")
my_logger = make_logger("my_logger") # make a new logger with the unique key 'my_logger' for env variables
my_logger.info("my_logger hi") # shows by default, can be turned off with running via my_logger_LOGLEVEL=0 app.py
my_logger.debug("my_logger hi") # shows only if you run with my_logger_LOGLEVEL=2 app.py (or higher)
my_logger.trace("my_logger hi") # LOGLEVEL >= 3
my_logger.trace2("my_logger hi") # LOGLEVEL >= 4

my_logger2 = make_logger("my_logger2", log_file=Path.cwd()/"log.txt") # optional file logging too
my_logger2.info("my_logger2 hi")
my_logger2.debug("my_logger2 hi")
my_logger2.trace("my_logger2 hi")
my_logger2.trace2("my_logger hi")

loggez_logger.info("loggez_logger hi") # the default logger object
loggez_logger.debug("loggez_logger hi")
loggez_logger.trace("loggez_logger hi")
loggez_logger.trace2("loggez_logger hi")

Run with:

my_logger_LOGLEVEL=0 run.py # no message
my_logger_LOGLEVEL=1 run.py # for info (defualt)
my_logger_LOGLEVEL=2 run.py # for debug
LOGGEZ_LOGLEVEL=3 run.py # for trace

Additional env vars:

  • my_logger_MESSAGE=...: see the default in loggez/loggez.py to control colors and stuff.
  • my_logger_INFO_MESSAGE=..., my_logger_DEBUG_MESSAGE=... etc.

Note: You can use also use the global predefined logger: from loggez import loggez_logger as logger; logger.info(...). Env variables are: LOGGEZ_LOGLEVEL=..., LOGGEZ_INFO_MESSAGE=.... etc.

That's all.

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

loggez-0.7.0.tar.gz (6.7 kB view details)

Uploaded Source

File details

Details for the file loggez-0.7.0.tar.gz.

File metadata

  • Download URL: loggez-0.7.0.tar.gz
  • Upload date:
  • Size: 6.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.4

File hashes

Hashes for loggez-0.7.0.tar.gz
Algorithm Hash digest
SHA256 0b3212bf0622ad399f2cddfc20ab7a6abaceabd28bb2802d67ba9926cfa2d411
MD5 7a8483f9123e4d6c3f6ceab89350e065
BLAKE2b-256 04fe6418f98220b0e051890226c8c4a3d58b72bd2b9458036f8e7956032ced6f

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