Skip to main content

Simple logging service shared by all application modules

Project description

Singleton Logging Service

Logging service that is guaranteed to be a singleton. Based on Python logging, but every instantiation of LoggingService from any of an application's modules returns the same logger instance. Uses RotatingFileHandler by default, if logfile is provided.

Code example:

    from logging_service import LoggingService

    self.log = LoggingService()"Constructing output file names...")
    self.log.err("Failed to construct output file names...")
    self.log.warn("Output file names are unusual...")
    self.log.debug("Constructing output file names, fum.txt...")

This API is more primitive than the hierarchical native logging module, but hopefully simple to use. One can:

    * Log to a file,
    * The console, or
    * Both

A single formatter is built in for info/debug/warn/err. Example: 2020-09-03 14:58:33,017;INFO: Start Epoch [1/50]

When first creating a LoggingService instance, the following options are available in the constructor; all are optional:

logging_level=logging.INFO    # the Python logging package's constants
logfile=None,                 # destination file; None implies console only
tee_to_console=True,          # if logfile is specified, also log to console
msg_identifier=None,          # shown at start of each msg; default is module name
rotating_logs=True,           # if logging to file, rotate log if size exceeded
log_size=1000000,             # max log size for rotation
max_num_logs=500,             # max number of full logs to retain
logger_name=None              # name for the logger instance

After creation a logger instance may only be modified like this:

- my_logger.logging_level = logging.NEW_LEVEL
- my_logger.log_file      = '/tmp/new_logfile'

where logging levels are the usual logging.INFO, logging.WARN, etc.

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

logging-singleton-1.0.tar.gz (5.9 kB view hashes)

Uploaded source

Built Distribution

logging_singleton-1.0-py3-none-any.whl (6.2 kB view hashes)

Uploaded py3

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