https://github.com/spulec/pep8ify

A library that modifies python source code to conform to pep8.
https://github.com/spulec/pep8ify

Last synced: about 2 months ago
JSON representation

A library that modifies python source code to conform to pep8.

• Host: GitHub
• URL: https://github.com/spulec/pep8ify
• Owner: spulec
• License: apache-2.0
• Created: 2012-06-03T03:31:33.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2019-03-08T03:06:14.000Z (over 5 years ago)
• Last Synced: 2024-07-25T04:34:58.606Z (2 months ago)
• Language: Python
• Size: 496 KB
• Stars: 118
• Watchers: 5
• Forks: 12
• Open Issues: 7
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
Pep8ify: Clean your code with ease

==================================

.. image:: https://secure.travis-ci.org/spulec/pep8ify.png?branch=master

Pep8ify is a library that modifies python source code to conform to

pep8_.

Installation

------------

This library currently works with python 2.7, 3.2, and 3.3.

To install pep8ify, simply: ::

    $ pip install pep8ify

Usage

------------

To print a diff of changes that pep8ify will make against a particular source

file or directory: ::

    $ pep8ify source_folder

To have those changes written to the files: ::

    $ pep8ify -w source_folder

By default, this will create backup files for each file that will be changed.

You can add the `-n` option to not create the backups. Please do not do this

if you are not using a version control system. Although this code is

well-tested, there are most likely bugs still.

For more options about running particular fixers, read the

`lib2to3 documentation`_. This

library is built on top of that one.

Fixes

------------

A list of the available fixers can be found with the following: ::

    $ pep8ify -l

    Available transformations for the -f/--fix option:

    blank_lines

    compound_statements

    extraneous_whitespace

    imports_on_separate_lines

    indentation

    maximum_line_length

    missing_newline

    missing_whitespace

    tabs

    trailing_blank_lines

    trailing_whitespace

    whitespace_around_operator

    whitespace_before_inline_comment

    whitespace_before_parameters

All of these are set to run by default except for 'maximum_line_length'.

To run all fixes including 'maximum_line_length', run: ::

    $ pep8ify -f all -f maximum_line_length example.py

.. _`lib2to3 documentation`: http://docs.python.org/library/2to3.html

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