Skip to main content

Apply black formatter for a piece of python source code

Project description

A tool that applies the Black python source code formatter to a single piece of python source code instead of a whole file or project.


$ pip install blacken-selection
$ blacken-selection -h
usage: Apply the black code formatter for a piece of python source code

positional arguments:
  SOURCE                The python source code to be formatted. If not
                        provided then source is read from stdin.

optional arguments:
  -h, --help            show this help message and exit
  -l LINE_LENGTH, --line-length LINE_LENGTH
                        How many characters per line to allow. [default: 88]
$ blacken-selection "def main(): pass"
def main():

Usage from PyCharm on linux

Unfortunately PyCharm External Tools cannot be used directly. The $SelectedText$ macro passes the selection as a command line argument to the tool but there is no way to properly quote a python string using double quotes.

But there is a solution:

  • Install the xclip command line tool, we will use it to grab the code selection in PyCharm via the clipboard
  • Install blacken_selection as described above
  • Grab the simple shell script

Setup as an external tool in PyCharm:

File -> Settings -> Tools -> External Tools

Click the + icon to add a new external tool with the following values:

    Name: blacken
    Description: Blacken a piece of python code
    Program: <absolute path for your>

Select a piece of python source code in your editor and from the right click context menu select:

External Tools -> blacken

Or you can confiugre a shortcut (e.g. Shift+Alt+B) to trigger the tool in:

Settings -> Keymap-> External Tools -> blacken

The tool will grab the selected text form the clipboard, format it with black, and the copy the formatted code back to the clipboard. So you can basically do the select, shift+alt+B, insert in PyCharm to format a piece of python code with black.

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

blacken-selection-0.2.0.tar.gz (3.4 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page