PT011.md

PT011

pytest.raises({exception}) is too broad, set the match parameter or use a more specific exception

Configuration

• pytest-raises-require-match-for
  Comma-separated list of exception names that require a match= parameter in a pytest.raises() call. By default the list contains the following exceptions:
  • BaseException, Exception
  • ValueError
  • OSError, IOError, EnvironmentError, socket.error

Examples

Bad code:

import pytest

def test_foo():
    with pytest.raises(ValueError):
        ...

    # empty string is also an error
    with pytest.raises(ValueError, match=''):
        ...

Good code:

import pytest

def test_foo():
    with pytest.raises(ValueError, match='expected message'):
        ...

Rationale

• to help ensure that the pytest.raises clause is not too broad