Sublime Text package to format python code using black formatter.

csurfer csurfer Last update: Jan 03, 2024

sublime_black

Licence Thanks

SublimeText3 package to format python code using black formatter.

Demo

Features

  • Black: Diff to see the changes that would be done to the file.
  • Black: Format to format the file in place using black.

Prerequisites

  • Install black and ensure you can use it in command line to format files.

Setup

Directly from the repository

Clone the git repo into your Packages folder using

git clone https://github.com/csurfer/sublime_black Black

and restart SublimeText3.

Package Control

Submitted to Package Control on May 1st 2018. Should be available soon!

Settings

  • Line length setting for the package is set to 88 by default to be in sync with black. If you intend to change the same Open command palette -> Goto Preferences: Black Settings - User -> Change "line_length" to the value you desire.
  • Locale setting for the package (required by click's http://click.pocoo.org/5/python3/#python-3-surrogate-handling) by default is set to en_CA.UTF-8. If you intend to change the same Open command palette -> Goto Preferences: Black Settings - User -> Change "encoding" to the value you desire.
  • String quotes or prefixes are normalized by the default to be in sync with black. This works great for new projects, but may not be the default you want for existing projects. Check out the docs for specific details. If you intend to change the same Open command palette -> Goto Preferences: Black Settings - User -> Change "skip_string_normalization" to either true or false (the default).

Notes

  • Currently supports only saved file formatting due to conflict between SublimeText3 default python version (3.3) and black supported version (3.6).
  • More to come as soon as SublimeText supports latest python version.

Contributing

Bug Reports and Feature Requests

Please use issue tracker for reporting bugs or feature requests.

Development

Pull requests are most welcome.

Buy the developer a cup of coffee!

If you found the utility helpful you can buy me a cup of coffee using

Donate

Tags:

Subscribe to our newsletter