Checker

Entry point to the app.

Represents a checker business entity. There’s only a single checker instance that runs a lot of visitors.

graph TD C1[Checker] --> V1[Visitor 1] C1[Checker] --> V2[Visitor 2] C1[Checker] --> VN[Visitor N]

Checker relation with visitors.

That’s how all flake8 plugins work:

graph LR F1[flake8] --> F2[add_options] F2 --> F3[parse_options] F3 --> F4[__init__] F4 --> F5[run]

flake8 API calls order.

Checker API

class Checker(tree, file_tokens, filename='stdin')

Bases: object

Implementation of checker.

See also

http://flake8.pycqa.org/en/latest/plugin-development/index.html

name

required by the flake8 API, should match the package name.

version

required by the flake8 API, defined in the packaging file.

config

custom configuration object used to provide and parse options:

:class:`wemake_python_styleguide.options.config.Configuration`.

options

option structure passed by flake8:

:class:`wemake_python_styleguide.types.ConfigurationOptions`.

visitors

preset of visitors that are run by this checker.

__init__(tree, file_tokens, filename='stdin')

Creates new checker instance.

These parameter names should not be changed. flake8 has special API that passes concrete parameters to the plugins that ask for them.

flake8 also decides how to execute this plugin based on its parameters. This one is executed once per module.

Parameters

• tree (AST) – ast parsed by flake8. Differs from ast.parse since it is mutated by multiple flake8 plugins. Why mutated? Since it is really expensive to copy all ast information in terms of memory.

• file_tokens (Sequence[TokenInfo]) – tokenize.tokenize parsed file tokens.

• filename (str) – module file name, might be empty if piping is used.

Return type

None

classmethod add_options(parser)

flake8 api method to register new plugin options.

See wemake_python_styleguide.options.config.Configuration docs for detailed options reference.

Parameters

parser (OptionManager) – flake8 option parser instance.

Return type

None

classmethod parse_options(options)

Parses registered options for providing them to each visitor.

Return type

None

run()

Runs the checker.

This method is used by flake8 API. It is executed after all configuration is parsed.

Yields

Violations that were found by the passed visitors.

Return type

Iterator[Tuple[int, int, str, type]]