Skip to main content

Check PEP-8 naming conventions, plugin for flake8

Project description

Check your code against PEP 8 naming conventions.

This module provides a plugin for flake8, the Python code checker.

(It replaces the plugin flint-naming for the flint checker.)


You can install, upgrade, uninstall pep8-naming with these commands:

$ pip install pep8-naming
$ pip install --upgrade pep8-naming
$ pip uninstall pep8-naming

Plugin for Flake8

When both flake8 and pep8-naming are installed, the plugin is available in flake8:

$ flake8 --version
2.0 (pep8: 1.4.3, pyflakes: 0.6.1, naming: 0.2)

By default the plugin is enabled.

Error Codes

These error codes are emitted:

code sample message
N801 class names should use CapWords convention (class names)
N802 function name should be lowercase (function names)
N803 argument name should be lowercase (function arguments)
N804 first argument of a classmethod should be named ‘cls’ (function arguments)
N805 first argument of a method should be named ‘self’ (function arguments)
N806 variable in function should be lowercase
N807 function name should not start and end with ‘__’
N811 constant imported as non constant (constants)
N812 lowercase imported as non-lowercase
N813 camelcase imported as lowercase
N814 camelcase imported as constant (distinct from N817 for selective enforcement)
N815 mixedCase variable in class scope (constants, method names)
N816 mixedCase variable in global scope (constants)
N817 camelcase imported as acronym (distinct from N814 for selective enforcement)
N818 error suffix in exception names (exceptions)


The following flake8 options are added:


Ignore errors for specific names or glob patterns.

Currently, this option can only be used for N802, N803, N804, N805, N806, N815, and N816 errors.

Default: setUp,tearDown,setUpClass,tearDownClass,asyncSetUp,asyncTearDown,setUpTestData,failureException,longMessage,maxDiff.


List of method decorators pep8-naming plugin should consider class method.

Used to prevent false N804 errors.

Default: classmethod.


List of method decorators pep8-naming plugin should consider static method.

Used to prevent false N805 errors.

Default: staticmethod.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pep8-naming, version 0.12.1
Filename, size File type Python version Upload date Hashes
Filename, size pep8_naming-0.12.1-py2.py3-none-any.whl (8.9 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size pep8-naming-0.12.1.tar.gz (17.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page