dlab_core.infrastructure.logger

Module Contents

class LogLevelTransformer[source]

Log level transformer used to transform system error levels to logging levels.

static transform(level)[source]

Log level helper validate log level and transform to common format.

Parameters:level (int) – Log level.
Return type:int
Returns:Log level.
class AbstractHandler[source]

Abstract Handler implementation.

emit(self, record)[source]

Emit a record. If a formatter is specified, it is used to format the record.

Parameters:record – Message log or other log format.
class SimpleLoggingHandler(handler, level=NOTSET)[source]

Bases: logging.Handler

Custom logger handler implementation.

Parameters:handler (AbstractHandler) – Logger handler.
Return type:int
Returns:Log level.
emit(self, record)[source]

Emit a record. If a formatter is specified, it is used to format the record.

Parameters:record – Message log or other log format.
class AbstractLogging[source]

Wrapper and Aggregator over Logger Handler to control log level can be used to decorate existing logger functionality.

level[source]

Log level getter.

Return type:int
Returns:Log level.
handlers[source]

Logger Handlers getter.

Return type:list of AbstractHandler
Returns:Log Handlers list.
log(self, level, msg, *args, **kwargs)[source]

Logs a message with integer level lvl on this logger. The other arguments are interpreted as for debug().

Parameters:
  • level (int) – Log level.
  • msg (str) – Logging message.
add_handler(self, handler)[source]

Add logger handler.

Parameters:handler (AbstractHandler) – Logger Handler to be added.
class AbstractLoggingBuilder[source]

AbstractLogging Builder implementation.

logging[source]

Logging getter as builder result

Return type:AbstractLogging
Returns:Logging as result of Builder execution.
add_handlers(self)[source]

Add Logger handlers.

set_log_level(self)[source]

Set Log level to Logger handlers

class LoggerAdapter(core)[source]

Bases: dlab_core.domain.logger.AbstractLogger

The adapter class implements AbstractLogger interface and keeps a reference to an Logging of the class.

Parameters:core (AbstractLogging) – Logger to be Decorated.
_log(self, level, msg, *args, **kwargs)[source]

Logs a message with integer level lvl on this logger. The other arguments are interpreted as for debug().

Parameters:
  • level (int) – Log level.
  • msg (str) – Logging message.
debug(self, msg, *args, **kwargs)[source]

Delegate an debug call to the underlying logger.

Parameters:msg (str) – Logging message.
info(self, msg, *args, **kwargs)[source]

Delegate an info call to the underlying logger.

Parameters:msg (str) – Logging message.
warn(self, msg, *args, **kwargs)[source]

Delegate a warning call to the underlying logger.

Parameters:msg (str) – Logging message.
err(self, msg)[source]

Delegate an error call to the underlying logger.

Parameters:msg (str) – Logging message.
class LoggerDirector(builder)[source]

Logger Director implementation.

Parameters:builder (AbstractLoggingBuilder) – Logger builder.
logger[source]

Logger getter as result of builder building.

Return type:AbstractLogger
Returns:Logger
build(self)[source]

Build Logging

class StreamHandlerAdapter(level, formatter)[source]

Bases: dlab_core.infrastructure.logger.AbstractHandler

Decorator over StreamHandler

Parameters:
  • level (int) – Log level.
  • formatter (logging.Formatter) – Log formatter.
emit(self, record)[source]

Emit a record. If a formatter is specified, it is used to format the record.

Parameters:record – Message log or other log format.
class StreamLogging(name)[source]

Bases: dlab_core.infrastructure.logger.AbstractLogging

Logger which used to log messages.

Parameters:name (str) – Name of the logger
level[source]

Log level getter.

Return type:int
Returns:Log level.
handlers[source]

Logger Handlers getter.

Return type:list of AbstractHandler
Returns:Log Handlers list.
static _process(msg, kwargs)[source]

Pre process log message.

Parameters:
  • msg (str) – Logging message.
  • kwargs (dict) – Logging options.
log(self, level, msg, *args, **kwargs)[source]

Logs a message with integer level lvl on this logger. The other arguments are interpreted as for debug().

Parameters:
  • level (int) – Log level.
  • msg (str) – Logging message.
add_handler(self, handler)[source]

Add logger handler.

Parameters:handler (AbstractHandler) – Logger Handler to be added.
class SysLogFormatter[source]

Bases: logging.Formatter

Log Formatter which formats messages by RFC 3164 - BSD-syslog protocol.

class StreamLogBuilder(name, level)[source]

Bases: dlab_core.infrastructure.logger.AbstractLoggingBuilder

Stream LogBuilder implementation.

Parameters:
  • name (str) – Logger name.
  • level (int) – Log level.
logging[source]

Logging getter as builder result

Return type:AbstractLogging
Returns:Logging as result of Builder execution.
add_stream_handler(self)[source]

Add Stream handler to logger

add_handlers(self)[source]

Add Logger handlers.

set_log_level(self)[source]

Set Log level to Logger handlers