Skip to content

Simple Python Logger package to easily manage custom loggers in Python projects.

License

Notifications You must be signed in to change notification settings

M4RC0Sx/SimplePyLogger

Repository files navigation

SimplePyLogger

Sonarqube Workflow Release Workflow PyPI - Downloads

Reliability Rating Security Rating Bugs Vulnerabilities

Simple Python Logger package to easily manage custom loggers in Python projects.

Installation

Because the package is hosted on PyPi, the installation process is quite simple:

Notice that the package name has a 3 in place of an E, this is due to the availability of names in PyPi.

pip install simplepylogg3r

Upgrade to latest version

pip install simplepylogg3r -U

Usage

Currently, the package supports 3 different loggers:

  • Console Logger
  • File Logger

IMPORTANT NOTE: Every logger must be configured before using it, this is done by calling the configure method of the logger. Once you have configured a logger, the configuration gets saved and everytime you use the logger again, it uses this initial configuration.

All logger configuration methods are static, so you can call them directly from the class. They also have all necessary parameters with default values, allowing you to use them without any configuration or customizing whatever you want.

Console Logger

from splogger.loggers import ConsoleLogger

ConsoleLogger.configure('logger_name')  # Logger configuration

ConsoleLogger.debug('Debug Message')
ConsoleLogger.info('Info Message')
ConsoleLogger.warning('Warning Message')
ConsoleLogger.error('Error Message')
ConsoleLogger.critical('Critical Message')

File Logger

from splogger.loggers import FileLogger

FileLogger.configure('logger_name', filename='example.log')  # Logger configuration

FileLogger.debug('Debug Message')
FileLogger.info('Info Message')
FileLogger.warning('Warning Message')
FileLogger.error('Error Message')
FileLogger.critical('Critical Message')

To-Do List

  • Add README docs.
  • Generate wiki docs.
  • Add Rotating File Logger (time).
  • Add Rotating File Logger (size).
  • Implement unit tests.
  • Run unit tests on CI.

License

Apache License 2.0