flake8-pytest-style

Description

A flake8 plugin checking common style issues or inconsistencies with pytest-based tests.

Currently the following errors are reported:

Installation and usage

As a dependency

Install the plugin using the package manager of your choice, e.g.

uv add --group dev flake8-pytest-style
# or
poetry add --group dev flake8-pytest-style
# or
pip install flake8-pytest-style

and then run flake8 as you normally would.

As a pre-commit hook

The plugin is a flake8 extension, not a standalone tool. To use it with pre-commit, add the plugin to the additional_dependencies section of the official flake8 hook:

repos:
  - repo: https://github.com/PyCQA/flake8
    rev: 7.3.0
    hooks:
      - id: flake8
        additional_dependencies:
          - flake8-pytest-style==2.2.0

Configuration

The plugin is configured via flake8 configuration file and/or CLI options. Specific errors can be selected or ignored; there are also the following plugin-specific configuration options:

• pytest-fixture-no-parentheses — see PT001
• pytest-parametrize-names-type — see PT006
• pytest-parametrize-values-type — see PT007
• pytest-parametrize-values-row-type — see PT007
• pytest-raises-require-match-for — see PT011
• pytest-mark-no-parentheses — see PT023
• pytest-warns-require-match-for — see PT030

For developers

Install deps and setup pre-commit hook

make init

Run linters, autoformat, tests etc.

make format lint test

Bump new version

make bump_major
make bump_minor
make bump_patch

License

MIT

Change Log

Unreleased

...

2.2.0 - 2025-10-20

• require at least Python 3.10
• support Python 3.14

2.1.0 - 2025-01-10

• support reason= kwarg in pytest.fail for PT016
• add PT028 (checks for default values in test functions)
• add PT029 (checks for pytest.warns without expected warning)
• add PT030 (checks for too broad pytest.warns clauses)
• add PT031 (checks for multiple statements in pytest.warns blocks)
• require at least Python 3.9
• support Python 3.13

2.0.0 - 2024-04-01

• BREAKING: invert default values for pytest-fixture-no-parentheses and pytest-mark-no-parentheses to conform with pytest official style
  • If you get a lot of PT001 or PT023 violations after upgrading, consider setting explicit values for these configuration options
• require at least Python 3.8.1
• support Python 3.12

1.7.2 - 2023-02-15

• fix false positive for PT009 on pytest.fail

1.7.1 - 2023-02-15

• update list of unittest-style assert methods for PT009/PT027

1.7.0 - 2023-02-09

• require at least Python 3.7.2
• support Python 3.11
• add PT027 (checks for unittest-style assertRaises)

1.6.0 - 2021-12-23

• require at least Python 3.6.2
• expose py.typed file

1.5.1 - 2021-11-05

• better wording for PT011
• support Python 3.10

1.5.0 - 2021-06-18

• add PT025 (checks for erroneous pytest.mark.usefixtures on fixtures)
• add PT026 (checks for pytest.mark.usefixtures without parameters)

1.4.4 - 2021-06-17

• fix PT023 not checking marks in classes
• fix PT004 incorrectly firing on fixtures with yield from

1.4.2 - 2021-05-24

• update flake8-plugin-utils version to improve stability

1.4.1 - 2021-04-01

• fix argparse-related warnings

1.4.0 - 2021-03-14

• add PT023 (checks for parentheses consistency in pytest.mark usage)
• add PT024 (checks for unnecessary pytest.mark.asyncio on fixtures)
• fix PT004, PT005 firing on abstract fixtures
• fix PT012 firing on with statements containing a single pass

1.3.0 - 2020-08-30

• add PT022 (checks for yield fixtures without teardown)

1.2.3 - 2020-08-06

• update flake8-plugin-utils dependency to fix encoding problems on Windows

1.2.2 - 2020-07-23

• fix PT004/PT005 inspecting returns of nested functions

1.2.1 - 2020-06-15

• fix PT021 for factory fixtures (#46)

1.2.0 - 2020-06-12

• support scoped mocker fixtures from pytest-mock for PT008
• check for positional-only lambda arguments in PT008
• add PT020 (checks for pytest.yield_fixture)
• add PT021 (checks for request.addfinalizer)
• add documentation pages for all rules

1.1.1 - 2020-04-17

• fix PT011 not reporting match='' as a violation

1.1.0 - 2020-04-14

• add PT015 (checks for assert False)
• add PT016 (checks for pytest.fail() without message)
• add PT017 (checks for assertions on exceptions in except blocks)
• add PT018 (checks for composite assertions)
• add PT019 (checks for fixtures without value injected as parameters)

1.0.0 - 2020-03-26

• add PT014 (checks for duplicate test cases in @pytest.mark.parametrize)

0.6.0 - 2020-03-21

• add configuration option pytest-parametrize-names-type for PT006
• add configuration options pytest-parametrize-values-type and pytest-parametrize-values-row-type for PT007

0.5.0 - 2020-03-09

• add configuration option pytest-fixture-no-parentheses for PT001
• add PT013 (checks for from-imports from pytest)

0.4.0 - 2020-03-09

• add PT012 (checks for multiple statements in with pytest.raises())

0.3.1 - 2020-03-09

• fix default value of pytest-raises-require-match-for config option

0.3.0 - 2020-03-09

• add PT010 and PT011 (checks for pytest.raises parameters)

0.2.0 - 2020-03-01

• add PT009 (ported from flake8-pytest)

0.1.3 - 2019-05-24

• add yield fixtures support
• fix changelog entry for 0.1.2

0.1.2 - 2019-05-23

• fix parametrize checkers not working in decorators

0.1.1 - 2019-05-23

• update PyPI description

0.1.0 - 2019-05-23

• initial