Skip to content

python-modules/gbe0-log

Repository files navigation

gbe0 Log

My standard logging module.

Installation

To install from PyPI:

python3 -m pip install gbe0-log

Usage

To use in scripts check example.py.

Example:

## Import module
from gbe0_log import Logger
import logging as log

## Initialize logger
## This only needs to be done once
Logger(verbosity = 5)

## Log some messages
log.critical('A message to log at critical level') # Always logged (verbosity level 0)
log.error('A message to log at error level') # Always logged (verbosity level 0)
log.warning('A message to log at warning level') # Verbosity level 1
log.info('A message to log at info level') # Verbosity level 2
log.verbose('A message to log at verbose level') # Verbosity level 3
log.debug('A message to log at debug level') # Verbosity level 4
log.trace('A message to log at trace level') # Verbosity level 5

For convenience, a fatal log level has been added. If this log level is called it will log the message and cause the script to exit (with an optional error code). As an example:

## Log a fatal error and exit with default exit code (EINTR)
log.fatal('A fatal error occured')

## Log a fatal error and exit with code 99
log.fatal('A fatal error occured', code = 99)

Example Output

Output is to stderr and looks like this:

Log output

Optimization

If Python is running in optimized mode calls to the following log levels are a no-op:

  • trace
  • debug
  • verbose

About

My logging

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages