Skip to main content

PyDev Code Formatter

Project description

===============
PyDev Formatter
===============


.. image:: https://img.shields.io/pypi/v/pydevf.svg
:target: https://pypi-hypernode.com/pypi/pydevf

.. image:: https://img.shields.io/travis/fabioz/pydevf.svg
:target: https://travis-ci.org/fabioz/PyDev.Formatter

.. image:: https://readthedocs.org/projects/pydevf/badge/?version=latest
:target: https://pydevf.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status



Features
==========

This package provides a command line API to use the PyDev Code Formatter (the PyDev
Code formatter is created by extracting the engine for code formatting provided by
PyDev: http://www.pydev.org).

The PyDev Formatter is a conservative python code formatter and will try to keep the
structure of the code as close as possible to the original sources, while fixing many
common issues such as:

- Keep a space after commas
- Trim spaces inside parenthesis
- Right-trim lines
- Add a space before and after operators
- Keep 2 lines before top level classes/methods
- Keep 1 line before inner classes/methods
- Add new line at end of file
- Format comments to have 2 spaces before a comment and 1 space inside the comment

And will not try to break statements to fit any pre-specified line length (as gofmt).

Command line
=============

To use the formatter use:

`python -m pydevf <filename_or_directory>`

`python -m pydevf -h` may be used to see the help for additional parameters.

Installing
============

Requisites
-----------

- java 8+ (so, make sure java is installed and in your PATH)
- python 2.7 or 3.4 onwards
- click 6+

Install with pip
-----------------

`pip install pydevf` should be used to install the PyDev Formatter.

Dealing with big lines
========================

Note that in PyDev there are tools to help on those manual cases. i.e.:

Wrap docstrings/comments with `Ctrl+2, W` -- See: http://pydev.blogspot.com/2015/04/wrapping-docstringscomments-in-pydev.html.

Wrap/unwrap lists/calls with `Ctrl+1`, `Wrap expression`/`unwrap expression` (used with cursor inside the list/call).

Daemon mode
============

By default the formatter will create a daemon and will reuse it among multiple invocations (because
the formatter is **very fast** but its startup is slow). If you don't want to use this mode use
the `--no-daemon` parameter.

License
==========

* EPL (Eclipse Public License) 2.0

Releasing
==========

- Update versions on setup.py and version.py
- git tag version (v0.1.2)
- git push --tags (travis should build and deploy)

Local release
===============

- Update versions on setup.py and version.py
- python setup.py sdist bdist_wheel
- python -m twine upload dist/*


=======
History
=======

0.1.0 (2018-06-12)
------------------

* First release on PyPI.


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pydevf-0.1.4.tar.gz (2.8 MB view details)

Uploaded Source

Built Distribution

pydevf-0.1.4-py2.py3-none-any.whl (2.8 MB view details)

Uploaded Python 2 Python 3

File details

Details for the file pydevf-0.1.4.tar.gz.

File metadata

  • Download URL: pydevf-0.1.4.tar.gz
  • Upload date:
  • Size: 2.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pydevf-0.1.4.tar.gz
Algorithm Hash digest
SHA256 8a717e479ffb309525853f550d34b3e3fa2307ca1da198b70d68b014b28d0255
MD5 ad69fd794e72b17ebc15fd40e44c3c21
BLAKE2b-256 90f535ba904b1472e9373923e2205cd6d043bf7c5b5177a0dfa6492e08be8a0e

See more details on using hashes here.

Provenance

File details

Details for the file pydevf-0.1.4-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for pydevf-0.1.4-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 841797b640755d6071dec0a1f8addbf27f16205c5364d07f01c1a7793e7f30c7
MD5 8fa038c80411bc628397e79c0401eb9f
BLAKE2b-256 608deabdae4d147d8ead308b80b1306f4bb41bb62c243f87c72ce2d27453f871

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page