pycodestyle 0,0,1,1,4,1,2 travis-ci python

Simple Python style checker in one Python file

2 years after MIT

pycodestyle (formerly called pep8) - Python style guide checker

.. image:: https://img.shields.io/travis/PyCQA/pycodestyle.svg :target: https://travis-ci.org/PyCQA/pycodestyle :alt: Build status

.. image:: https://readthedocs.org/projects/pycodestyle/badge/?version=latest :target: https://pycodestyle.readthedocs.io :alt: Documentation Status

.. image:: https://img.shields.io/pypi/wheel/pycodestyle.svg :target: https://pypi.python.org/pypi/pycodestyle :alt: Wheel Status

.. image:: https://badges.gitter.im/PyCQA/pycodestyle.svg :alt: Join the chat at https://gitter.im/PyCQA/pycodestyle :target: https://gitter.im/PyCQA/pycodestyle?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge

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

.. _PEP 8: http://www.python.org/dev/peps/pep-0008/

.. note::

This package used to be called ``pep8`` but was renamed to ``pycodestyle``
to reduce confusion. Further discussion can be found `in the issue where
Guido requested this
change <https://github.com/PyCQA/pycodestyle/issues/466>`_, or in the
lightning talk at PyCon 2016 by @IanLee1521:
`slides <https://speakerdeck.com/ianlee1521/pep8-vs-pep-8>`_
`video <https://youtu.be/PulzIT8KYLk?t=36m>`_.

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:222:34: W602 deprecated form of raising exception optparse.py:347:31: E211 whitespace before '(' optparse.py:357:17: E201 whitespace after '{' optparse.py:472:29: E221 multiple spaces before operator optparse.py:544:21: W601 .has_key() is deprecated, use 'in'

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 testsuite/E40.py testsuite/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) 612 W601 .has_key() is deprecated, use 'in' 1188 W602 deprecated form of raising exception

Links

  • Read the documentation <https://pycodestyle.readthedocs.io/>_

  • Fork me on GitHub <http://github.com/PyCQA/pycodestyle>_

Related Repositories

spyder

spyder

Official repository for Spyder - The Scientific PYthon Development EnviRonment ...

autopep8

autopep8

A tool that automatically formats Python code to conform to the PEP 8 style guid ...

pythonVSCode

pythonVSCode

Python support for Visual Studio Code ...

awesome-static-analysis

awesome-static-analysis

A curated list of static analysis tools, linters and code quality checkers for v ...

awesome-linters

awesome-linters

A list of awesome linters. ...


Top Contributors

florentx IanLee1521 jcrocholl sigmavirus24 reinout doismellburning gward mtmiller cburroughs daspecster myint SmileyChris ilam yole dpursehouse timleslie jwilk msabramo emonty alecthomas arthall helenst ymattw ArcTanSusan clayg fabioz memeplex benesch adamv alasdairnicol

Releases

-   2.0.0 zip tar
-   2.0.0a1 zip tar
-   1.7.0 zip tar
-   1.6.2 zip tar
-   1.6.1 zip tar
-   1.6 zip tar
-   1.5.7 zip tar
-   1.5.6 zip tar
-   1.5.5 zip tar
-   1.5.4 zip tar
-   1.5.3 zip tar
-   1.5.2 zip tar
-   1.5.1 zip tar
-   1.5 zip tar
-   1.4.6 zip tar
-   1.4.5 zip tar
-   1.4.4 zip tar
-   1.4.3 zip tar
-   1.4.2 zip tar
-   1.4.1 zip tar
-   1.4 zip tar
-   1.3.4 zip tar
-   1.3.3 zip tar
-   1.3.2 zip tar
-   1.3.1 zip tar
-   1.3 zip tar
-   1.2 zip tar
-   1.1 zip tar
-   1.0.1 zip tar