Skip to main content

Simple, robust features for expediting application logging configuration

Project description

Tools and convenience methods to simplify and expedite Python logging.

  • Simple - though opinionated - setup for common use-cases

  • Extensively and easily configurable via user and local files, as well as environ variables

  • Comes with full featured formatters and handlers that can also be used in normal logging situations

Usage

basic_config

The easiest way to begin using prolog is to add the following to your application code:

import prolog
prolog.basic_config()

This will configure the root logger for the default level logging.INFO and set up two handlers: a colorized, console streaming handler, as well as a file handler set to log to the default file - pypro.log - in the main app’s directory.

To specify select loggers defined in application or library code, you pass the comma-seperated names of the desired loggers:

prolog.basic_config('myapp,another_app')

basic_config accepts the following parameters:

loggers

The desired loggers to configure; can be either a comma-separated string of logger names, a list of Logger instances, or None for the root logger.

level

Specify the logging level for all loggers and handlers. Can be either the numeric value or string name for the desired level.

handlers

The handlers to add to the given loggers; can be a comma-separated string of shortcut names (‘stream’ or ‘file’, by default) or a list of Handler instances.

propagate

Indicates whether each logger instance will be set to propagte.

reset_handlers

If True, force a reset of all currently configured handlers.

cfg

The prolog.config.PrologConfig instance to use. If not given, the default will be used (prolog.config.config). For all preceding parameters except for loggers set to None (the default), cfg will be used to determine the appropriate setting.

Examples

Once installed, prolog can be invoked to show configuration settings or sample usage:

$ python -m prolog sample --level=DEBUG basic
https://raw.githubusercontent.com/dakrauth/prolog/master/resources/basic-output.png

Setting colors via environments variables:

$ export PYPROLOG_LEVEL_COLORS='CRITICAL:white,red;ERROR:lightred;DEBUG:lightgray,cyan;*:gray,gray'
$ python -m prolog sample --level=DEBUG basic
https://raw.githubusercontent.com/dakrauth/prolog/master/resources/env-color-output.png

Develop and testing

$ pip install invoke
$ inv develop
$ inv test

Configuration

Prolog can be configured via a number of different options:

  • User-level configuration file, using appdirs to determine the user’s configuration directory plus pyprolog/config, which must be a JSON encoded file containing a dictionary overriding any of the defaults listed below

  • Current working directory configuration file .pyprologrc, also JSON

  • Environment variables, see below

  • Manipulation of the default prolog.config.config instance or instantiating your own

  • Generating a logging.config.dictConfig dict via prolog.config.dict_config

Defaults

LEVEL = 'INFO'
SHORT_FMT = "{levelname}:{name} {message}"
LONG_FMT = '[{asctime} {name}:{levelname}:{module}:{lineno}] {message}'

COLOR_LONG_FMT = '{color}[{asctime} {name}:{levelname}:{module}:{lineno}]{endcolor} {message}'
COLOR_SHORT_FMT = '{color}{levelname}:{name}{endcolor} {message}'
LEVEL_COLORS = 'DEBUG:magenta;INFO:blue;WARNING:yellow;ERROR:red;CRITICAL:white,red'

DATE_FMT = "%Y-%m-%dT%H:%M:%S"
STYLE_FMT = '{'

HANDLERS = 'stream,file'
PROPAGATE = False
DISABLE_EXISTING = True
RESET_HANDLERS = True

STREAM_LEVEL = 'NOTSET'
STREAM_FORMATTER = 'color'
STREAM_STREAM = 'sys.stderr'

FILE_LEVEL = 'NOTSET'
FILE_FORMATTER = 'long'
FILE_FILENAME = 'pypro.log'
FILE_MAX_BYTES = 0
FILE_BACKUP_COUNT = 0

Environment

By default, the prolog.config.config instance will load any environment variable begging with PYPROLOG_ and ending with any of the defaults listed above. For instance, to override the default logging level, do the following before executing your application code:

$ export PYPROLOG_LEVEL='DEBUG'
$ python myapp.py

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

prolog-0.3.1.tar.gz (12.2 kB view details)

Uploaded Source

Built Distribution

prolog-0.3.1-py3-none-any.whl (13.9 kB view details)

Uploaded Python 3

File details

Details for the file prolog-0.3.1.tar.gz.

File metadata

  • Download URL: prolog-0.3.1.tar.gz
  • Upload date:
  • Size: 12.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for prolog-0.3.1.tar.gz
Algorithm Hash digest
SHA256 f0128f6261490438a3b8abe0415c8792148ee1ea3cff94c28efb9eef8c45859e
MD5 ec487b784edc0ae30185c2c47f62046c
BLAKE2b-256 69d42e9538432c64cf97357ef59fae70fa217e96ecfed1e856fed84b443e52e0

See more details on using hashes here.

Provenance

File details

Details for the file prolog-0.3.1-py3-none-any.whl.

File metadata

File hashes

Hashes for prolog-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 184e1d4eafa7853be02ed12e2211e71966341206100d1cecdefcf4aca7efabba
MD5 983d5145b45d254a8e086c3aa9669cb7
BLAKE2b-256 926ff19ba63ea7f40bb48bd85427d18f5a91895ef1c38d5702446b92dd835021

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page