pep8(1) A tool to check your Python code against some of the style conventions in PEP 8.


pep8 [options] input ...


show program's version number and exit
-h, --help
show this help message and exit
-v, --verbose
print status messages, or debug with -vv
-q, --quiet
report only file names, or nothing with -qq
exclude files or directories which match these comma separated patterns (default: .svn,CVS,.bzr,.hg,.git,__pycache__)
when parsing directories, only check filenames matching these comma separated patterns (default: *.py)
select errors and warning (e.g. E,W6)
skip errors and warnings (e.g. E4,W)
show first occurrence of each error
-r, --repeat
(obsolete) show all occurrences of the same error
show source code for each error
show text of PEP 8 for each error (implies --first)
count errors and warnings
print total number of errors and warnings to standard error and set exit code to 1 if total is not null
set maximum allowed line length (default: 79)
hang closing bracket instead of matching indentation of opening bracket's line
set the error format [default|pylint|<custom>]
report only lines changed accoring to the unified diff received on STDIN
measure processing speed
user config file location (default: $HOME/.config/pep8)


Display how often each error was found:

% pep8 --statistics -qq example/lib/

Show source code and more verbose explanation from PEP 8:

% pep8 --show-source --show-pep8


This manual page was written by David Watson <dwa[email protected]> and Michael Prokop <[email protected]>.