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 4.0.1 (mccabe: 0.6.1, naming: 0.13.0, pycodestyle: 2.8.0, pyflakes: 2.4.0) CPython 3.8.10 on Linux
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,setUpModule,tearDownModule,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.
Release files for pep8-naming 0.13.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pep8-naming-0.13.1.tar.gz | 15.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pep8_naming-0.13.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 24.5 kB
Release files / pep8-naming-0.13.1.tar.gz
| Download URL | pep8-naming-0.13.1.tar.gz |
|---|---|
| Size | 15.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3af77cdaa9c7965f7c85a56cd579354553c9bbd3fdf3078a776f12db54dd6944
|
|
BLAKE2b-256 checksum How to use checksums |
5feb55406edc1c5eb5efacf469f0cf5f207527ef018d84da0fdcbaf0a26e9892
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.9.13
|
Release files / pep8_naming-0.13.1-py3-none-any.whl
| Download URL | pep8_naming-0.13.1-py3-none-any.whl |
|---|---|
| Size | 8.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f7867c1a464fe769be4f972ef7b79d6df1d9aff1b1f04ecf738d471963d3ab9c
|
|
BLAKE2b-256 checksum How to use checksums |
668fec60626cd61ffa3862705e4c7a0096060ea9bc481cee4a7f73dc892a5c2c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.9.13
|
