Ignore individual error codes per file with flake8
Switch branches/tags
Nothing to show
Clone or download

README.md

flake8-per-file-ignores

Build Status Pypi Entry

An extension for flake8 that lets you configure (out-of-source) individual error codes to be ignored per file.

This is mostly useful when dealing with legacy code, so that you don't have to ignore any existing error globally, but get the benefits of all checks in new files, while you avoid introducing new kind of errors in existing files.

The advantage over inline # noqa comments is, that it doesn't clutter your source files or even requires touching them.

Installation

pip install flake8-per-file-ignores

Configuration

You can can use following configuration syntax in any configuration file considered by flake8:

[flake8]
per-file-ignores =
  <filename>: <error>[,<error>[,...]]
  [...]
  • filename is the filename, or if starting with a slash, the full path relative to the directory flake8 is running from, of the script that is subject to the ignores. It can also be a glob pattern, but note (just like with the glob module or in UNIX shells), * doesn't match accross directory boundaries, however, you can use ** in order to match recursively.
  • error has the same semantics as the --ignore command line option.

If an ignored error no longer occurs for a given file it will trigger an X100 error to make you progressively reduce the number of ignores as legacy code gets rewritten or removed.

For an example see the test folder.