pycodestyle

Check the style of a single file

$ pycodestyle [file.py]

Check the style of multiple files

$ pycodestyle [file1.py] [file2.py] [file3.py]

Show only the first occurrence of an error

$ pycodestyle --first [file.py]

Show the source code for each error

$ pycodestyle --show-source [file.py]

Show the specific PEP 8 text for each error

$ pycodestyle --show-pep8 [file.py]

pycodestyle [options] input ...

--version

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=patterns

exclude files or directories which match these comma separated patterns (default: .svn,CVS,.bzr,.hg,.git,__pycache__,.tox)

--filename=patterns

when parsing directories, only check filenames matching these comma separated patterns (default: *.py)

--select=errors

select errors and warning (e.g. E,W6)

--ignore=errors

skip errors and warnings (e.g. E4,W) (default: E121,E123,E126,E226,E24,E704,W503)

--first

show first occurrence of each error

-r, --repeat

(obsolete) show all occurrences of the same error

--show-source

show source code for each error

--show-pep8

show text of PEP 8 for each error (implies --first)

--statistics

count errors and warnings

--count

print total number of errors and warnings to standard error and set exit code to 1 if total is not null

--max-line-length=n

set maximum allowed line length (default: 79)

--hang-closing

hang closing bracket instead of matching indentation of opening bracket's line

--format=format

set the error format [default|pylint|<custom>]

--diff

report only lines changed according to the unified diff received on STDIN

--benchmark

measure processing speed

--config=path

user config file location (default: $HOME/.config/pycodestyle)

Display how often each error was found:

% pycodestyle --statistics -qq example/lib/

Show source code and more verbose explanation from PEP 8:

% pycodestyle --show-source --show-pep8 foo.py

This manual page was written by David Watson <dwatson@debian.org>, Michael Prokop <mika@debian.org> and Ondřej Nový <onovy@debian.org>.