Skip to main content

Python style guide checker

Project description

Build status Documentation Status Wheel Status Join the chat at https://gitter.im/PyCQA/pycodestyle

pycodestyle is a tool to check your Python code against some of the style conventions in PEP 8.

Features

  • Plugin architecture: Adding new checks is easy.

  • Parseable output: Jump to error location in your editor.

  • Small: Just one Python file, requires only stdlib. You can use just the pycodestyle.py file for this purpose.

  • Comes with a comprehensive test suite.

Installation

You can install, upgrade, and uninstall pycodestyle.py with these commands:

$ pip install pycodestyle
$ pip install --upgrade pycodestyle
$ pip uninstall pycodestyle

There’s also a package for Debian/Ubuntu, but it’s not always the latest version.

Example usage and output

$ pycodestyle --first optparse.py
optparse.py:69:11: E401 multiple imports on one line
optparse.py:77:1: E302 expected 2 blank lines, found 1
optparse.py:88:5: E301 expected 1 blank line, found 0
optparse.py:347:31: E211 whitespace before '('
optparse.py:357:17: E201 whitespace after '{'
optparse.py:472:29: E221 multiple spaces before operator

You can also make pycodestyle.py show the source code for each error, and even the relevant text from PEP 8:

$ pycodestyle --show-source --show-pep8 testing/data/E40.py
testing/data/E40.py:2:10: E401 multiple imports on one line
import os, sys
         ^
    Imports should usually be on separate lines.

    Okay: import os\nimport sys
    E401: import sys, os

Or you can display how often each error was found:

$ pycodestyle --statistics -qq Python-2.5/Lib
232     E201 whitespace after '['
599     E202 whitespace before ')'
631     E203 whitespace before ','
842     E211 whitespace before '('
2531    E221 multiple spaces before operator
4473    E301 expected 1 blank line, found 0
4006    E302 expected 2 blank lines, found 1
165     E303 too many blank lines (4)
325     E401 multiple imports on one line
3615    E501 line too long (82 characters)

Project details


Download files

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

Source Distribution

pycodestyle-2.13.0.tar.gz (39.3 kB view details)

Uploaded Source

Built Distribution

pycodestyle-2.13.0-py2.py3-none-any.whl (31.4 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file pycodestyle-2.13.0.tar.gz.

File metadata

  • Download URL: pycodestyle-2.13.0.tar.gz
  • Upload date:
  • Size: 39.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for pycodestyle-2.13.0.tar.gz
Algorithm Hash digest
SHA256 c8415bf09abe81d9c7f872502a6eee881fbe85d8763dd5b9924bb0a01d67efae
MD5 4e0e9d54c06f24a457a552e8e038f9d2
BLAKE2b-256 046e1f4a62078e4d95d82367f24e685aef3a672abfd27d1a868068fed4ed2254

See more details on using hashes here.

File details

Details for the file pycodestyle-2.13.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for pycodestyle-2.13.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 35863c5974a271c7a726ed228a14a4f6daf49df369d8c50cd9a6f58a5e143ba9
MD5 ac02982fed51d8c47f7204c32636e316
BLAKE2b-256 07beb00116df1bfb3e0bb5b45e29d604799f7b91dd861637e4d448b4e09e6a3e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page