Skip to content

Commit

Permalink
Documentation update, added changelog
Browse files Browse the repository at this point in the history
  • Loading branch information
reinout authored and jcrocholl committed Oct 6, 2009
1 parent 4ad397b commit f640f0d
Show file tree
Hide file tree
Showing 3 changed files with 30 additions and 19 deletions.
35 changes: 21 additions & 14 deletions README.txt
Original file line number Diff line number Diff line change
@@ -1,23 +1,29 @@
pep8.py 0.2.0 - Python style guide checker
==========================================
pep8 - Python style guide checker
=================================

Announcing the first public release of pep8.py, a tool to check your
Python code against some of the style conventions in `PEP 8`_.
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.

Download
--------
* Small: Just one Python file, requires only stdlib. You can use just the
pep8.py file for this purpose

* Easy_installable, of course!

The file pep8.py (and a regression test suite) is available under the
Expat license:

Installation
------------

Just an ``easy_install pep8`` ought to do the trick.

http://github.com/jcrocholl/pep8

Expand All @@ -26,7 +32,7 @@ Example usage and output

::

$ pep8.py optparse.py
$ pep8 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
Expand All @@ -39,7 +45,7 @@ Example usage and output
You can also make pep8.py show the source code for each error, and
even the relevant text from PEP 8::

$ pep8.py --show-source --show-pep8 testsuite/E111.py
$ pep8 --show-source --show-pep8 testsuite/E111.py
testsuite/E111.py:2:3: E111 indentation is not a multiple of four
print x
^
Expand All @@ -50,7 +56,7 @@ even the relevant text from PEP 8::

Or you can display how often each error was found::

$ pep8.py --statistics -qq --filename=*.py Python-2.5/Lib
$ pep8 --statistics -qq --filename=*.py Python-2.5/Lib
232 E201 whitespace after '['
599 E202 whitespace before ')'
631 E203 whitespace before ','
Expand All @@ -66,8 +72,8 @@ Or you can display how often each error was found::

Quick help is available on the command line::

$ pep8.py -h
usage: pep8.py [options] input ...
$ pep8 -h
usage: pep8 [options] input ...

options:
-h, --help show this help message and exit
Expand All @@ -84,6 +90,7 @@ Quick help is available on the command line::
--testsuite=dir run regression tests from dir
--doctest run doctest on myself


Feedback
--------

Expand Down
10 changes: 6 additions & 4 deletions TODO.txt
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
TODO
====

- script to verify testcases pass.

TODO:
- script to verify testcases pass.
- tesecase for ignoring '#' before function change change.
- I have observed problems with decorators and 200 warnings, look into this.
- testcase for ignoring '#' before function change change.

- I have observed problems with decorators and 200 warnings, look into this.
4 changes: 3 additions & 1 deletion setup.py
Original file line number Diff line number Diff line change
@@ -1,7 +1,9 @@
from setuptools import setup, find_packages

version = '0.3dev'
long_description = open('ANNOUNCE').read()
long_description = '\n\n'.join([open('README.txt').read(),
open('CHANGES.txt').read(),
open('TODO.txt').read()])

setup(name='pep8',
version=version,
Expand Down

0 comments on commit f640f0d

Please sign in to comment.