diff options
author | Jelmer Vernooij <jelmer@samba.org> | 2015-04-25 15:34:13 +0000 |
---|---|---|
committer | Jeremy Allison <jra@samba.org> | 2015-04-27 21:18:10 +0200 |
commit | a001b0385412786c50553cfb38c146dfb3646142 (patch) | |
tree | c4bfaf23e826cf036dd66d4f6e46f1e4d23b954d /third_party/pep8/README.rst | |
parent | 0621f07eb482daf7495f6314b0af32853573cb82 (diff) | |
download | samba-a001b0385412786c50553cfb38c146dfb3646142.tar.gz |
pep8: Move to third_party/.
Also, update to latest upstream version.
Signed-Off-By: Jelmer Vernooij <jelmer@samba.org>
Reviewed-by: Jeremy Allison <jra@samba.org>
Diffstat (limited to 'third_party/pep8/README.rst')
-rw-r--r-- | third_party/pep8/README.rst | 91 |
1 files changed, 91 insertions, 0 deletions
diff --git a/third_party/pep8/README.rst b/third_party/pep8/README.rst new file mode 100644 index 00000000000..d842f05829f --- /dev/null +++ b/third_party/pep8/README.rst @@ -0,0 +1,91 @@ +pep8 - Python style guide checker +================================= + +pep8 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/ + + +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 pep8.py file for this purpose. + +* Comes with a comprehensive test suite. + +Installation +------------ + +You can install, upgrade, uninstall pep8.py with these commands:: + + $ pip install pep8 + $ pip install --upgrade pep8 + $ pip uninstall pep8 + +There's also a package for Debian/Ubuntu, but it's not always the +latest version. + +Example usage and output +------------------------ + +:: + + $ pep8 --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 pep8.py show the source code for each error, and +even the relevant text from PEP 8:: + + $ pep8 --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:: + + $ pep8 --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 +----- + +.. image:: https://api.travis-ci.org/jcrocholl/pep8.png?branch=master + :target: https://travis-ci.org/jcrocholl/pep8 + :alt: Build status + +.. image:: https://pypip.in/wheel/pep8/badge.png?branch=master + :target: https://pypi.python.org/pypi/pep8 + :alt: Wheel Status + +* `Read the documentation <http://pep8.readthedocs.org/>`_ + +* `Fork me on GitHub <http://github.com/jcrocholl/pep8>`_ |