Skip to main content

py.test plugin to capture logbook log messages

Project description

Capture and show logbook logging output during test runs.

This pytest plugin provides will capture log messages emitted by logbook and display them in their own section in the test report if the test fails. Additionally it provides a fixture which provides easy access to the log records emitted during the test which allows making assertions on emitted log message. The plugin also sets up logging redirection from the stdlib to go via logbook so any libraries which use stdlib logging will also be captured.


Install using pip:

pip install pytest-logbook

Log Capturing

Log capturing happens automatically once installed, including stdlib logging redirection:

def test_foo():'hello')'world')
    assert 0
$ py.test
=========================== test session starts ============================
platform linux -- Python 3.4.3, pytest-2.8.2, py-1.4.30, pluggy-0.3.1
rootdir: /home/flub/Abilisoft/repos/pytest-logbook, inifile:
plugins: logbook-0.1.0
collected 1 items F

================================= FAILURES =================================
_________________________________ test_foo _________________________________

    def test_foo():'hello')'world')
>       assert 0
E       assert 0 AssertionError
--------------------------- Logbook call records ---------------------------
[INFO] Generic: hello
[INFO] root: world
========================= 1 failed in 0.01 seconds =========================

Logs messages emitted during test setup and teardown are also captured individually. If setup fails you will see them in a “Logbook setup records” section and if teardown fails you will see the teardown log messages in a “Logbook teardown records” section.


Several fixtures are provided to access the captured log records.


Access the logbook.TestHandler instance active during the test run. You can use it to inspect the emitted log records, see the full documentation for details on how to use this object. Only log records emitted during the actual test are recorded here, records emitted during test setup or teardown are recorded in the other fixtures.


Access the logbook.TestHandler instance active during the test setup.


Access the logbook.TestHandler instance active during the test teardown.


The plugin can be configured using options in the py.test configuration file in the standard [pytest] section.


This configures whether the stdlib logging is redirected to logbook. Set it to either true (default) or false.



  • Refactor internal workings to improve behaviour during keyboard interrupt and internal py.test errors. As a minor regression and to keep things simple log records are now only captured during test setup, call or teardown phases and are not captured during conftest loading or test collection. This is not an inherent limitation, only avoiding unneeded features.

  • Fix using fixture in a test method rather then just a test function.


  • Do not fail if the application corrupts the Logbook stack.


  • Require Logbook 0.11.3 to get the logging.compat module accessible.


  • Include LICENSE.

  • Add in ship LICENSE, tox.ini and test module.

  • Start keeping a changelog.

  • Fix dependency to require py.test >= 2.8 due to how hooks are implemented.


  • Do not build universal wheel. Only tested/supported on python3.


  • Initial release.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pytest-logbook-1.2.0.tar.gz (6.0 kB view hashes)

Uploaded Source

Built Distribution

pytest_logbook-1.2.0-py3-none-any.whl (7.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page