1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
6 VARIANTS= py27 py35 py36
7 SDESC[py35]= Formatter for Python code (PY 35)
8 SDESC[py36]= Formatter for Python code (PY 36)
9 SDESC[py27]= Formatter for Python code (PY 27)
11 CONTACT= Python_Automaton[python@ironwolf.systems]
14 SITES[main]= PYPI/y/yapf
15 DISTFILE[1]= yapf-0.22.0.tar.gz:main
21 OPTIONS_AVAILABLE= PY27 PY35 PY36
22 OPTIONS_STANDARD= none
23 VOPTS[py35]= PY27=OFF PY35=ON PY36=OFF
24 VOPTS[py36]= PY27=OFF PY35=OFF PY36=ON
25 VOPTS[py27]= PY27=ON PY35=OFF PY36=OFF
31 [PY35].USES_ON= python:py35
33 [PY36].USES_ON= python:py36
35 [PY27].USES_ON= python:py27
37 [FILE:3097:descriptions/desc.single]
42 .. image:: https://badge.fury.io/py/yapf.svg
43 :target: https://badge.fury.io/py/yapf
46 .. image:: https://travis-ci.org/google/yapf.svg?branch=master
47 :target: https://travis-ci.org/google/yapf
50 .. image:: https://coveralls.io/repos/google/yapf/badge.svg?branch=master
51 :target: https://coveralls.io/r/google/yapf?branch=master
58 Most of the current formatters for Python --- e.g., autopep8, and pep8ify
60 are made to remove lint errors from code. This has some obvious
62 For instance, code that conforms to the PEP 8 guidelines may not be
63 reformatted. But it doesn't mean that the code looks good.
65 YAPF takes a different approach. It's based off of 'clang-format',
67 Daniel Jasper. In essence, the algorithm takes the code and reformats it
69 best formatting that conforms to the style guide, even if the original code
70 didn't violate the style guide. The idea is also similar to the 'gofmt'
72 the Go programming language: end all holy wars about formatting - if the
74 codebase of a project is simply piped through YAPF whenever modifications
76 made, the style remains consistent throughout the project and there's no
78 arguing about style in every code review.
80 The ultimate goal is that the code YAPF produces is as good as the code
82 programmer would write if they were following the style guide. It takes
84 some of the drudgery of maintaining your code.
86 Try out YAPF with this `online demo <https://yapf.now.sh>`_.
90 YAPF is not an official Google product (experimental or otherwise), it
92 just code that happens to be owned by Google.
100 To install YAPF from PyPI:
106 (optional) If you are using Python 2.7 and want to enable multiprocessing:
110 $ pip install futures
112 YAPF is still considered in "alpha" stage, and the released version may
114 often; therefore, the best way to keep up-to-date with the latest
116 is to clone this repository.
118 Note that if you intend to use YAPF as a command-line tool rather than as a
119 library, installation is not necessary. YAPF supports being run as a
121 by the Python interpreter. If you cloned/unzipped YAPF into ``DIR``, it's
126 $ PYTHONPATH=DIR python DIR/yapf [options] ...
132 YAPF supports Python 2.7 and 3.6.4+. (Note that some Python 3 features may
134 to parse with Python versions before 3.6.4.)
136 YAPF requires the code it formats to be valid Python for the version YAPF
138 runs under. Therefore, if you format Python 3 code with YAPF, run YAPF
140 under Python 3 (and similarly for Python 2).
148 usage: yapf [-h] [-v] [-d | -i] [-r | -l START-END] [-e PATTERN]
149 [--style STYLE] [--style-help] [--no-local-style] [-p]
153 Formatter for Python code.
158 a98a6eacca64d2b920558f4a2f78150db9474de821227e60deaa29f186121c63 135605 yapf-0.22.0.tar.gz