justlog 0.1.1.5

A simple logging library for Python 3

justlog

A simple library for logging with Python3

Basics

For a quick example, refer to the test.py on the github repository

With justlog, everything is handled within a single class: Logger

Spawn an instance of this class to start logging quickly.

from justlog import justlog, settings
logger = justlog.Logger(settings.Settings())

Instances must be initialized with a Settings instance that can be customized before or after instantiation.

Syntax

Logger

• log(message)
  • message: The message to log
  • Will use the current log level set within the Settings class: logger.settings.current_log_level
• debug(message)
  • message: The message to log
  • Sets the current_log_level to Severity.DBG and calls the log() function
• info(message)
  • message: The message to log
  • Sets the current_log_level to Severity.INF and calls the log() function
• warning(message)
  • message: The message to log
  • Sets the current_log_level to Severity.WRN and calls the log() function
• error(message)
  • message: The message to log
  • Sets the current_log_level to Severity.ERR and calls the log() function

Settings

• appname: str
  • Used as a default for various other settings like the log path
• current_log_level: Severity
  • Sets the current log level. Influences colors and fields.
  • Log levels: DBG INF WRN ERR
• colorized_logs: Bool
  • Enables or disables the log coloration for different Severity
• log_format: Format
  • Sets the log format type
  • TEXT JSON
• log_output: [Output]
  • Defines where the logs are output. Must be a list, can include many.
  • STDOUT STDERR TCP FILE SYSLOG HTTP
• string_format: str
  • Defines the template and fields for logs output in the TEXT format
• timestamp_format
  • Sets the $TIMESTAMP variable format using stfrtime codes
• update_field(key: str, value: str)
  • Adds or updates a field that will be output to the logs. Fields can be reffered using the $ symbol within the string_format
• delete_field(key: str)
  • Removes a field
• tcp_output_host(host: str)
  • Sets the tcp output host
• tcp_output_port(port: int)
  • Sets the tcp output port
• http_url(url: str)
  • Sets the http output url
• http_headers(header: dict)
  • Optional headers to pass to the post request
• http_print_response(bool)
  • Prints the http call response to stdout when True

Builtin Variables

• $TIMESTAMP
  • Will print the current time in the format defined by the timestamp_format setting using stfrtime codes
• $CURRENT_LOG_LEVEL
  • Will print the current log level based on the current_log_level setting at the moment of the call.
• $message
  • Will print the message.

Quickstart

from justlog import justlog, settings
from justlog.classes import Severity, Output, Format

logger_stdout = justlog.Logger(settings.Settings())
logger_stdout.settings.colorized_logs = True
logger_stdout.settings.log_output = [Output.STDOUT]
logger_stdout.settings.update_field("application", "sample")
logger_stdout.settings.update_field("timestamp", "$TIMESTAMP")
logger_stdout.settings.update_field("level", "$CURRENT_LOG_LEVEL")
logger_stdout.settings.string_format = "[ $timestamp ] :: Level: $CURRENT_LOG_LEVEL, application: $application :: $message"

logger_stdout.info("Information")
logger_stdout.error("Error")
logger_stdout.warning("Warning")
logger_stdout.debug("Debug")