pytest-logger

What it is and what it does

Pytest-logger extends pytest with structured logging capture for individual named loggers. Instead of pytest's built-in log capture, it lets you configure which loggers to monitor, at what level, and routes their output to both stdout (during test runs) and to separate files organized by test and logger name in a session directory. You set it up via pytest hooks in conftest.py, naming the loggers you care about and their default output levels, then control which loggers appear during a test run using command-line options like `--log foo,bar.debug`.

The plugin is useful when your code or test fixtures use Python's standard logging module and you want fine-grained control over which log streams appear in test output and where they're stored. It organizes logs by test and logger name on disk, making it easy to review detailed logs for specific tests without cluttering the main test output.

Use it for:

• Debugging test failures by reviewing per-logger log files organized by test name and logger
• Selectively enabling verbose logging for specific loggers during test runs via command-line flags
• Capturing logs from library code and fixtures without polluting the main pytest output stream
• Archiving test logs on a per-logger basis for post-test analysis and troubleshooting

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Pytest-logger is a pytest plugin that configures Python logging handlers to capture and display logs from named loggers during test execution, routing output to both the terminal and per-logger files.

Yes. It has low install friction (pytest-only dependency), active maintenance, permissive MIT license, no known vulnerabilities, and solves a real problem for teams using Python logging in tests. Install it if you need structured per-logger log capture and file organization during pytest runs.

Install

pytest-logger on PyPI

pip install pytest-logger

uv add pytest-logger

poetry add pytest-logger

Installing pytest-logger

Before you install

Low install friction; depends only on pytest. Actively maintained with a recent commit (2026-04-13) and marked Production/Stable, supporting Python 3.7 through 3.12 and PyPy.

License in practice

MIT license (permissive); you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart

pip install pytest-logger

# In conftest.py:
def pytest_logger_config(logger_config):
    logger_config.add_loggers(['foo'], stdout_level='info')

# In test_example.py:
import logging
foo = logging.getLogger('foo')

def test_something():
    foo.info('test message')

# Run: pytest -s test_example.py

Verify before relying

• Whether the plugin works with pytest versions older than those listed in classifiers
• Performance impact when capturing logs from many loggers across large test suites

Package facts

Evidence: pytest_logger-1.1.1-py2.py3-none-any.whl

Keywords: py.test, pytest, logging

Tags

More Testing packages