Skip to main content

python module for easy logging

Project description

CCA Logging

Easy python logging module

Installing

Install from pypi

# install into users system site-packages
pip install ccalogging --user
# install into a virtual environment
pip install ccalogging
# as part of your own package, add to setup.py
setup(
    ...,
    install_requires=[
        '...',
        'ccalogging',
        '...',
        ],
    ...,
)

Usage

Import this module, set logging output, optionally set logging level, set a script level variable pointing to this modules log variable, then issue log.debug() etc.

You only need to set the output destination and logging level once, so if you have multiple files in your project, set the output destination and the logging level in the first one. In all the others just point a script level variable to ccalogging.log.

When using a log file, if the file already exists, new log messages are appended to it.

The default logging level is WARNING.

# first (or only) project file

import ccalogging          # import the module

ccalogging.setConsoleOut() # set global logging destination
ccalogging.setDebug()      # set global log level
log = ccalogging.log       # point a script-level variable to the logger

log.info("Logging has been started")
# subsequent project files

import ccalogging    # import the module

log = ccalogging.log # point a script-level variable to the logger

log.warning("continuing to log to the same location as setup in the first file")

Options

It is possible to log to the console and/or to a file. When logging to the console logs go to stderr by default.

setDebug()

Sets the global loglevel to be logging.DEBUG

setInfo()

Sets the global loglevel to be logging.INFO

setWarn()

Sets the global loglevel to be logging.WARNING. This is the default level, if you don't set a level.

setError()

Sets the global loglevel to be logging.ERROR

setLogFile(fqfn)

Sends log output to a file

parameters:

fqfn: the fully qualified path name of the log file

fformat: message format - defaults to: "%(asctime)s [%(levelname)-5.5s] %(message)s"

datefmt: date format - defaults to: "%d/%m/%Y %H:%M:%S"

setConsoleOut()

Sends log output to the console

parameters:

STDOUT: if True send to stdout - defaults to False (stderr)

cformat: message format - defaults to: "%(asctime)s [%(levelname)-5.5s] %(message)s"

datefmt: date format - defaults to: "%d/%m/%Y %H:%M:%S"

Project details


Download files

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

Files for ccalogging, version 0.3.3
Filename, size File type Python version Upload date Hashes
Filename, size ccalogging-0.3.3-py3-none-any.whl (15.5 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size ccalogging-0.3.3.tar.gz (3.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page