Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/myint/pyformat

Formats Python code to follow a consistent style
https://github.com/myint/pyformat

formatter python

Last synced: 3 months ago
JSON representation

Formats Python code to follow a consistent style

Awesome Lists containing this project

README

        

========
pyformat
========

.. image:: https://travis-ci.org/myint/pyformat.svg?branch=master
:target: https://travis-ci.org/myint/pyformat
:alt: Build status

*pyformat* formats Python code to follow a consistent style.

Features
========

- Formats code to follow the PEP 8 style guide (using autopep8_).
- Removes unused imports (using autoflake_).
- Formats docstrings to follow PEP 257 (using docformatter_).
- Makes strings all use the same type of quote where possible (using unify_).

Installation
============

From pip::

$ pip install --upgrade pyformat

Example
=======

After running::

$ pyformat --in-place example.py

This code:

.. code-block:: python

def launch_rocket ():

"""Launch
the
rocket. Go colonize space."""

def factorial(x):
'''

Return x factorial.

This uses math.factorial.

'''
import math
import re
import os
return math.factorial( x );
def print_factorial(x):
"""Print x factorial"""
print( factorial(x) )
def main():
"""Main
function"""
print_factorial(5)
if factorial(10):
launch_rocket()

Gets formatted into this:

.. code-block:: python

def launch_rocket():
"""Launch the rocket.

Go colonize space.

"""

def factorial(x):
"""Return x factorial.

This uses math.factorial.

"""
import math
return math.factorial(x)

def print_factorial(x):
"""Print x factorial."""
print(factorial(x))

def main():
"""Main function."""
print_factorial(5)
if factorial(10):
launch_rocket()

.. _autoflake: https://github.com/myint/autoflake
.. _autopep8: https://github.com/hhatto/autopep8
.. _docformatter: https://github.com/myint/docformatter
.. _unify: https://github.com/myint/unify