robotbackgroundlogger 1.2

Usage

The logger can be taken into use like this:

from robotbackgroundlogger import BackgroundLogger
logger = BackgroundLogger()

After that logger can be used mostly like robot.api.logger:

logger.debug('Hello, world!')
logger.info('<b>HTML</b> example', html=True)

When used by the main thread, messages will be logged immediately exactly like with robot.api.logger. When used by other threads, messages will be stored internally. They can be later logged by the main thread by running:

logger.log_background_messages()

If you want to log only messages logged by a certain thread, you can use pass the name of the thread as an argument:

logger.log_background_messages('Example thread')

Logged messages are also removed from the internal message storage. It is possible to do that also without logging:

# Remove all messages
logger.reset_background_messages()
# Remove messages logged by the named thread
logger.reset_background_messages('Another thread')

Example

example.py library that is used by example.robot shows how this module can be used in practice. You can run the example like:

pybot example.robot