{"id":15419015,"url":"https://github.com/fabioz/pydev.formatter","last_synced_at":"2025-10-27T22:30:21.854Z","repository":{"id":142609819,"uuid":"137110228","full_name":"fabioz/PyDev.Formatter","owner":"fabioz","description":"PyDev Code formatter","archived":false,"fork":false,"pushed_at":"2018-06-27T14:23:18.000Z","size":2909,"stargazers_count":3,"open_issues_count":3,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-12-20T04:08:59.450Z","etag":null,"topics":["code-formatter","python"],"latest_commit_sha":null,"homepage":"http://www.pydev.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fabioz.png","metadata":{"files":{"readme":"README.rst","changelog":"HISTORY.rst","contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.rst","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-06-12T18:09:22.000Z","updated_at":"2024-12-04T10:35:10.000Z","dependencies_parsed_at":null,"dependency_job_id":"c4d32f61-ac09-4540-9ba5-c0d8fa479adc","html_url":"https://github.com/fabioz/PyDev.Formatter","commit_stats":{"total_commits":15,"total_committers":2,"mean_commits":7.5,"dds":0.06666666666666665,"last_synced_commit":"1160cedb4bf19f4efb86f4f3af1430e522dc12cd"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabioz%2FPyDev.Formatter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabioz%2FPyDev.Formatter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabioz%2FPyDev.Formatter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabioz%2FPyDev.Formatter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fabioz","download_url":"https://codeload.github.com/fabioz/PyDev.Formatter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238563739,"owners_count":19492976,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["code-formatter","python"],"created_at":"2024-10-01T17:23:55.140Z","updated_at":"2025-10-27T22:30:21.395Z","avatar_url":"https://github.com/fabioz.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"===============\nPyDev Formatter\n===============\n\n\n.. image:: https://img.shields.io/pypi/v/pydevf.svg\n        :target: https://pypi.python.org/pypi/pydevf\n\n.. image:: https://img.shields.io/travis/fabioz/PyDev.Formatter.svg\n        :target: https://travis-ci.org/fabioz/PyDev.Formatter\n\n\nFeatures\n==========\n\nThis package provides a command line API to use the PyDev Code Formatter (the PyDev\nCode formatter is created by extracting the engine for code formatting provided by\nPyDev: http://www.pydev.org).\n\nThe PyDev Formatter is a conservative python code formatter and will try to keep the \nstructure of the code as close as possible to the original sources, while fixing many\ncommon issues such as:\n\n- Keep a space after commas\n- Trim spaces inside parenthesis\n- Right-trim lines\n- Add a space before and after operators\n- Keep 2 lines before top level classes/methods\n- Keep 1 line before inner classes/methods\n- Add new line at end of file\n- Format comments to have 2 spaces before a comment and 1 space inside the comment\n\nNote that it does not try to break statements to fit any pre-specified line length (as gofmt).\n\nCommand line\n=============\n\nBasic use of the formatter is:\n \n``python -m pydevf \u003cfilename_or_directory\u003e``\n\n``python -m pydevf -h`` may be used to see the help for additional parameters.\n\nInstalling\n============\n\nRequisites\n-----------\n\n- java 8+ (so, make sure java is installed and in your PATH)\n- python 2.7 or 3.4 onwards\n- click 6+\n\nInstall with pip\n-----------------\n\nTo install the PyDev Formatter use:\n\n``pip install pydevf``\n\nUsing with pre-commit\n---------------------\n\nTo use it with `pre-commit`_, just add the following repo to your ``.pre-commit-config.yaml``::\n\n    -   repo: https://github.com/fabioz/PyDev.Formatter\n        rev: ''  # Use the sha or tag you want to point at\n        hooks:\n        -   id: pydevf\n\n.. _pre-commit: https://pre-commit.com/\n\nDealing with big lines\n========================\n\nNote that in PyDev there are tools to help on those manual cases. i.e.:\n\nWrap docstrings/comments with ``Ctrl+2, W`` -- See: http://pydev.blogspot.com/2015/04/wrapping-docstringscomments-in-pydev.html.\n\nWrap/unwrap lists/calls with ``Ctrl+1``, ``Wrap expression``/``Unwrap expression`` (used with cursor inside the list/call).\n\nDaemon mode\n============\n\nBy default the formatter will create a daemon and will reuse it among multiple invocations (because\nthe formatter is **very fast** but its startup is slow). If you don't want to use this mode use\nthe ``--no-daemon`` parameter. \n\nLicense\n==========\n\n* EPL (Eclipse Public License) 2.0\n\nReleasing\n==========\n\n- Update versions on ``setup.py`` and ``version.py``\n- ``git tag {{version}}`` (i.e.: v0.1.2)\n- ``git push --tags`` (travis should build and deploy)\n\nLocal release\n---------------\n\n- Update versions on ``setup.py`` and ``version.py``\n- ``python setup.py sdist bdist_wheel``\n- ``python -m twine upload dist/*``\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabioz%2Fpydev.formatter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffabioz%2Fpydev.formatter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabioz%2Fpydev.formatter/lists"}