pycodestyle
pycodestyle is a free Python checker that evaluates selected conventions from PEP 8.
What pycodestyle is
pycodestyle is a free Python checker that evaluates selected conventions from PEP 8. It runs on Linux, macOS, and Windows, and its parseable output can direct an editor to an error location. The command line can show source and PEP 8 guidance, count errors, and format reports as default, pylint, or custom output. Configuration is available at user and project levels, including setup.cfg and tox.ini. Its plugin architecture allows additional checks, while Flake8 is described as a wrapper around pycodestyle and similar tools with plugin support. The project describes the package as a single Python file using only the standard library and includes a comprehensive test suite. Installation, upgrades, and removal are documented through pip. pycodestyle does not enforce every PEP 8 rule; naming conventions, docstrings, and automatic fixing are outside its scope. The listed plan is free, MIT licensed, and requires Python >=3.10.
Good
- Runs on Linux, macOS, and Windows
- Parseable output supports editor navigation
- Configurable at user and project levels
- Plugin architecture adds checks
- Free MIT-licensed package
Watch out
- Does not enforce every PEP 8 rule
- No automatic fixing
- Naming and docstring checks are out of scope
- Requires Python >=3.10
Who it suits
pycodestyle suits Python developers who want configurable PEP 8 checks in editors or CI. Users needing naming, docstring, or automatic fixes need other tools or plugins.
Verdict
pycodestyle provides lightweight, configurable style checking with editor-friendly reports and plugin support. Its limited rule coverage means it should be paired with other tools when broader conventions or autofixing are needed.
Plans and prices
From pycodestyle's own pricing page, checked 9 Oct 2001.
| Plan | Price | What it gives you |
|---|---|---|
| pycodestyle | Free | MIT licensed Python package · requires Python >=3.10 |
The facts
Each one read from pycodestyle's own pages, with the date it was checked.
What it does
- Compatibility
- PyPI classifies the package as OS independent and lists CPython and PyPy implementations.checked 9 Oct 2001
- Configuration
- Users can configure pycodestyle at user and project levels, including through setup.cfg or tox.ini.checked 9 Oct 2001
- Editor output
- Its parseable output lets users jump to an error location in an editor.checked 9 Oct 2001
- Installation
- The documentation gives pip install, upgrade, and uninstall commands for pycodestyle.checked 9 Oct 2001
- Integration
- Flake8 is described as a wrapper around pycodestyle and similar tools that supports plugins.checked 9 Oct 2001
- Lightweight
- The project says it is a single Python file that requires only the standard library.checked 9 Oct 2001
- Limitations
- The checker does not enforce every PEP 8 rule and does not aim to be exhaustive.checked 9 Oct 2001
- Out of scope
- Naming conventions, docstring conventions, and automatic fixing are outside the library’s scope; the documentation points to plugins or related tools for these needs.checked 9 Oct 2001
- Plugins
- Its plugin architecture makes it easy to add new checks.checked 9 Oct 2001
- Purpose
- pycodestyle checks Python code against some of the style conventions in PEP 8.checked 9 Oct 2001
- Reporting
- The CLI can show source and PEP 8 guidance, count errors, and format output as default, pylint, or custom.checked 9 Oct 2001
- Security and trust
- PyPI lists the 2.15.0 source distribution and wheel as not uploaded using Trusted Publishing.checked 9 Oct 2001
- Test suite
- The project says it comes with a comprehensive test suite.checked 9 Oct 2001
Alternatives to pycodestyle
- 1
Flake8
Free planOpen sourceAPILinuxmacOSSelf-hosted7.3Free plan - 2
PMD
Free planLinuxmacOSSelf-hostedWindows6.8Free plan - 3
SwiftLint
Free planLinuxmacOSWindows6.6Free plan - 4

Ruff
Free planWebLinuxmacOSSelf-hosted6.5Free plan - 5

Biome
Free planWebExtensionLinuxmacOS6.4Free plan - 6

Cppcheck
Free planLinuxmacOSSelf-hostedWindows6.4Free plan
