libdnf5.logger

class libdnf5.logger.GlobalLogger

GlobalLogger contains methods for setting the target (logger) for global messages - messages that are generated by libraries (eg librepo) without binding to the Base object.

static set(destination, verbosity)
thisown
static unset()
class libdnf5.logger.LogRouter(*args)

LogRouter is an implementation of logging class that forwards incoming logging messages to several other loggers. Loggers can be addressed via index. Index is serial number of the logger starting from zero.

add_logger(logger)

Moves (registers) the “logger” into the log router. It gets next free index number.

get_logger(index)

Returns pointer to the logger at the “index” position.

get_loggers_count()

Returns number of loggers registered in LogRouter.

log_line(level, message)
release_logger(index)

Removes logger at the “index” position from LogRouter. The array of the loggers is squeezed. Index of the loggers behind removed logger is decreased by one.

swap_logger(logger, index)

Swaps the logger at the “index” position with another “logger”.

thisown
write(time, pid, level, message)
class libdnf5.logger.LogRouterWeakPtr(*args)

WeakPtr is a “smart” pointer. It contains a pointer to resource and to guard of resource. WeakPtr pointer can be owner of the resource. However, the resource itself may depend on another resource. WeakPtr registers/unregisters itself at the guard of resource. And the resource guard invalidates the registered WeakPtrs when the resource is unusable (eg. its dependecny was released). Note on thread safety: It is safe to create, access and destroy WeakPtrs in multiple threads simultaneously.

add_logger(logger)

Moves (registers) the “logger” into the log router. It gets next free index number.

critical(msg)
debug(msg)
error(msg)
get()

Returns a pointer to the managed object. Generates exception if object is not valid.

get_logger(index)

Returns pointer to the logger at the “index” position.

get_loggers_count()

Returns number of loggers registered in LogRouter.

has_same_guard(other)

Checks if the other WeakPtr instance has the same WeakPtrGuard.

info(msg)
is_valid()

Checks if managed object is valid.

level_to_cstr(level)
log(level, msg)
log_line(level, message)
notice(msg)
release_logger(index)

Removes logger at the “index” position from LogRouter. The array of the loggers is squeezed. Index of the loggers behind removed logger is decreased by one.

swap_logger(logger, index)

Swaps the logger at the “index” position with another “logger”.

thisown
trace(msg)
warning(msg)
write(time, pid, level, message)
class libdnf5.logger.Logger

Logger is an abstract interface used for logging. An implementation (inherited class) can call callbacks, log the messages to memory, file, or somewhere else.

Level_CRITICAL
Level_DEBUG
Level_ERROR
Level_INFO
Level_NOTICE
Level_TRACE
Level_WARNING
critical(msg)
debug(msg)
error(msg)
info(msg)
static level_to_cstr(level)
log(level, msg)
log_line(level, message)
notice(msg)
thisown
trace(msg)
warning(msg)
write(time, pid, level, message)
class libdnf5.logger.LoggerUniquePtr(*args)
critical(msg)
debug(msg)
error(msg)
get()
info(msg)
level_to_cstr(level)
log(level, msg)
log_line(level, message)
notice(msg)
release()
reset(__p=None)
swap(__u)
thisown
trace(msg)
warning(msg)
write(time, pid, level, message)
class libdnf5.logger.MemoryBufferLogger(max_items_to_keep, reserve=0)

MemoryBufferLogger is an implementation of logging class that stores incoming logging messages into memory buffer. It is usually used as temporary logger until a final logger is configured.

clear()
get_item(item_idx)
get_items_count()
thisown
write(time, pid, level, message)
write_to_logger(logger)
class libdnf5.logger.MemoryBufferLoggerUniquePtr(*args)
clear()
critical(msg)
debug(msg)
error(msg)
get()
get_item(item_idx)
get_items_count()
info(msg)
level_to_cstr(level)
log(level, msg)
log_line(level, message)
notice(msg)
release()
reset(__p=None)
swap(__u)
thisown
trace(msg)
warning(msg)
write(time, pid, level, message)
write_to_logger(logger)
class libdnf5.logger.StringLogger(*args, **kwargs)

Logger is an abstract interface used for logging. An implementation (inherited class) can call callbacks, log the messages to memory, file, or somewhere else.

thisown
write(*args)
libdnf5.logger.create_file_logger(base, filename)

Helper method for creating a file logger in logdir location with given file name. :type base: libdnf5::Base :param base: Reference to Base for loading the configured logger path. :type filename: string :param filename: Name of the log file. :rtype: std::unique_ptr< libdnf5::Logger > :return: Instance of a new file logger.

libdnf5.logger.create_rotating_file_logger(base, filename)

Helper method for creating a rotating file logger in logdir location with given file name. :type base: libdnf5::Base :param base: Reference to Base for loading the configured parameters. :type filename: string :param filename: Name of the log file. :rtype: std::unique_ptr< libdnf5::Logger > :return: Instance of a new rotating file logger.