/blacken

Python Black for Emacs

Primary LanguageEmacs LispGNU General Public License v3.0GPL-3.0

MELPA MELPA Stable CI

Blacken

Use the python black package to reformat your python buffers.

usage

The whole buffer can be reformatted with blacken-buffer. If you want to format every time you save, enable blacken-mode in relevant python buffers. Note that if blacken-only-if-project-is-blackened is non-nil, then blacken will only run if your pyproject.toml contains the [tool.black] setting. This setting is off by default.

customization

The following options change the behavior of black when reformatting buffers.

  • blacken-allow-py36 Allow using Python 3.6-only syntax on all input files.
  • blacken-skip-string-normalization Don't normalize string quotes or prefixes.
  • blacken-fast-unsafe Skips temporary sanity checks.
  • blacken-line-length Max line length enforced by blacken.

license

blacken.el is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version.

SPDX-License-Identifier: GPL-3.0-or-later