Awesome Flake8 Extensions

A curated list of awesome flake8 extensions.

Inspired after reading a post.

Contents

• All-in-one
• Clean code
• Limitations
• Naming
• Complexity
• Comments
• Docstrings
• Tools
• Imports
• Testing
• Type annotations
• Library-specific checks
• Integrations
• Wrappers

All-in-one

Extensions with more than 20 rules inside.

• dlint - Tool for encouraging best coding practices and helping ensure Python code is secure.
• flake8-bugbear - Finding likely bugs and design problems in your program.
• flake8-pie - Extension that implements misc. lints.
• flake8-simplify - Plugin that helps you to simplify code.
• hacking - Set of flake8 plugins that test and enforce the OpenStack StyleGuide.
• wemake-python-styleguide - The strictest and most opinionated python linter ever.

Clean code

Small extensions for finding possible bugs and stylistic issues.

• flake8-2020 - Plugin which checks for misuse of sys.version or sys.version_info.
• flake8-alfred - Alfred is a flake8 plugin to warn on unsafe/obsolete symbols.
• flake8-commas - Enforcing trailing commas in python.
• flake8-comprehensions - Helps you write better list/set/dict comprehensions.
• flake8-encodings - Identify incorrect use of encodings.
• flake8-implicit-str-concat - Plugin to encourage correct string literal concatenation.
• flake8-multiline-containers - Plugin to ensure a consistent format for multiline containers.
• flake8-quotes - Extension for checking quotes in python.
• flake8-requirements - Package requirements checker.
• flake8-return - Plugin that checks return values.
• flake8-sql - Plugin that checks SQL code against opinionated style rules.
• flake8-strict - Checks Python code against a set of opinionated style rules.
• flake8-string-format - Check that indexed parameters are used in strings.
• flake8-warnings - Detect usage of deprecated modules, classes, and functions.

Limitations

Extensions banning specific Python features.

• flake8-broken-line - Report line break with backslash (\).
• flake8-debugger - Report debug statements (pdb, ipdb).
• flake8-logging-format - Report string formatting inside logging.
• flake8-match - Report match statement.
• flake8-no-implicit-concat - Report implicit string concatenation.
• flake8-no-pep420 - Report implicit namespace packages.
• flake8-pep3101 - Report %-formatting.
• flake8-print - Report print statement.
• flake8-printf-formatting - Report %-formatting.
• flake8-use-fstring - Report %-formatting and str.format.
• flake8-use-pathlib - Report os.path.
• flake8-walrus - Report walrus operator (:=).

Naming

Extensions for checking names of variables, functions, etc.

• flake8-builtins - Check for python builtins being used as variables or parameters.
• flake8-functions-names - Validate functions names, decomposition and conformity with annotations.
• flake8-test-name - Checks that test functions names follow a given convention.
• flake8-variables-names - Extension that helps to make more readable variables names.
• pep8-naming - Check the PEP-8 naming conventions.

Complexity

Extensions for ensuring low code complexity.

• cohesion - Extension for measuring Python class cohesion.
• flake8-annotations-complexity - Plugin to validate annotations complexity.
• flake8-cognitive-complexity - Extension for flake8 that validates cognitive functions complexity.
• flake8-expression-complexity - Plugin to validate expressions complexity.
• flake8-functions - Plugin for validation of function parameters (length, complexity, etc).
• flake8-length - Smart line length validation.

Comments

Extensions for checking comments.

• flake8-coding - Adds coding magic comment checks (coding:) to flake8.
• flake8-comments - Reports redundant comments.
• flake8-copyright - Adds copyright checks to flake8.
• flake8-eradicate - Plugin to find commented out or dead code.
• flake8-executable - Plugin for checking executable permissions and shebangs.
• flake8-fixme - Check for FIXME, TODO and other temporary developer notes.
• flake8-jira-todo-checker - Check that every TODO comment has a valid JIRA issue ID next to it.
• flake8-noqa - Validate # noqa comments.
• flake8-ownership - Checker for assuring that author, copyright, and license are specified in source files.
• flake8-todo - Check for TODO notes.
• flake8-todos - Lint TODO comments to be consistent and have an issue linked.

Docstrings

Extensions for checking docstrings.

• darglint - Check that the docstring description matches the definition.
• flake8-docstrings - Include checks provided by pep257.
• flake8-rst-docstrings - Validate Python docstrings as reStructuredText (RST).
• flake8-spellcheck - Spellcheck variables, classnames, comments, docstrings etc.

Tools

Tools empowering flake8.

• flake8-codes - CLI tool to introspect flake8 plugins and their codes.
• flake8-dashboard - Plugin to generate an HTML dashboard with reporting the flake8 violations found.
• flake8-ruler - More powerful configs for flake8.
• flakehell - Wrapper to make it nice, legacy-friendly, and configurable.
• nitpick - Enforce the same lint configuration (flake8, isort, mypy, pylint) across multiple Python projects.
• yesqa - A tool to automatically remove unnecessary # noqa comments.

Imports

Extensions for checking import statements.

• flake8-absolute-import - Plugin to require absolute imports.
• flake8-alphabetize - Checking the order of import statements and the __all__ list.
• flake8-future-import - Extension to check imports.
• flake8-import-order-spoqa - Spoqa's import order style for flake8-import-order.
• flake8-import-order - Include checks import order against various Python Style Guides.
• flake8-import-style - Plugin to ensure explicit module imports.
• flake8-tidy-imports - Extension that helps you write tidier imports.
• flake8-type-checking - Plugin for managing type-checking imports & forward references.

Testing

Extensions for testing.

• flake8-aaa - Lints tests against the Arrange Act Assert pattern.
• flake8-assertive - Unittest assert method checker.
• flake8-mock - Provides checking mock non-existent methods.
• flake8-pytest - Enforces to use pytest-style assertions.
• flake8-pytestrail - Checks TestRail test case IDs.

Type annotations

Extensions for type annotations.

• flake8-annotations-coverage - Plugin to validate annotations coverage.
• flake8-annotations - Plugin for flake8 to check for presence of type annotations in function definitions.
• flake8-future-annotations - Verifies Python 3.7+ files use from __future__ import annotations.
• flake8-new-union-types - Plugin to enforce new Union/Optional syntax Foo | Bar | None defined in PEP406.
• flake8-no-types - Plugin to ban type hints.
• flake8-type-checking - flake8 plugin that helps identify which imports to put into type-checking blocks, and how to adjust your type annotations once imports are moved.
• flake8-typing-imports - Plugin which checks that typing imports are properly guarded.
• flake8-pep585 - Enforce new style annotations from PEP585 such as list[int] instead of typing.List[int].

Library-specific checks

Extensions for linting usage of specific libraries.

• flake8-django - Plugin for Django projects.
• flake8-fastapi - Checks FastAPI code against opinionated style rules.
• flake8-pytest-style - Plugin checking common style issues or inconsistencies with pytest-based tests.
• flake8-scrapy - Plugin to catch common issues on Scrapy spiders.
• pandas-vet - Plugin that provides opinionated linting for pandas code.

Integrations

Extensions for running flake8 not only on Python files.

• flake8-markdown - Lints Python code blocks in Markdown files using flake8.
• flake8-pyi - Plugin for Flake8 that provides specializations for type hinting stub files.
• flake8-rst - Checks on code in *.rst files or in docstrings.
• jupyterlab-flake8 - Jupyterlab python linter for notebooks and text files using flake8.

Wrappers

Wrappers around other tools making it possible to use them with flake8.

• flake8-bandit - Wrapper around bandit.
• flake8-black - Wrapper around black.
• flake8-isort - Wrapper around isort.