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.)
Installation
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) |
Options
The following flake8 options are added:
- --ignore-names
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.
- --classmethod-decorators
List of method decorators pep8-naming plugin should consider class method.
Used to prevent false N804 errors.
Default: classmethod.
- --staticmethod-decorators
List of method decorators pep8-naming plugin should consider static method.
Used to prevent false N805 errors.
Default: staticmethod.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pep8_naming-0.12.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4a8daeaeb33cfcde779309fc0c9c0a68a3bbe2ad8a8308b763c5068f86eb9f37 |
|
MD5 | 68dde7095b5912ee24ded5e54af66d0f |
|
BLAKE2b-256 | 5d5d2b8fc7b8776e0285d9a1f88593ee2bd84ba35736c5a3b80b0d8adf45b799 |