妥協のないコードフォーマッター

「お好きな色でどうぞ。」

Black を使用することにより、手動フォーマットの細部を制御することを放棄することに同意したことになります。その代わりに、Black は速度、決定性、そして pycodestyle によるフォーマットに関する nagging からの解放を提供します。より重要な事項に時間と精神的なエネルギーを費やすことができるようになります。

Black は可能な限り最小の差分を生成することで、コードレビューを高速化します。Black化されたコードは、読んでいるプロジェクトに関係なく同じように見えます。フォーマットはしばらくすると透過的になり、コンテンツに集中できるようになります。

Black Playground を使用して、今すぐ試してみてください。

注 - Black は現在安定版です！

Black は大小さまざまなプロジェクトで正常に使用されています。Black には、効率的な並列テスト、独自の自動フォーマット、並列継続的インテグレーションランナーを備えた包括的なテストスイートがあります。安定版になったので、将来的にフォーマットが大きく変更されることは期待しないでください。スタイルの変更は、主にバグレポートへの対応と新しい Python 構文のサポートになります。

また、処理速度を低下させる安全対策として、Black は再フォーマットされたコードが依然として有効な AST を生成し、元のコードと実質的に同等であることを確認します（詳細は実用主義セクションを参照）。自信がある場合は、--fast を使用してください。

注記

Black は MIT ライセンスの下でライセンスされています.

お客様の声

Mike Bayer、SQLAlchemy の作者

私のプログラミングのキャリア全体を通して、導入によってこれほど大きな生産性向上をもたらした単一のツールは他に思い当たりません。コードが自動的にフォーマットされる方法がなかった頃は、リファクタリングに以前のキーストロークの約 1% でできるようになりました。

Dusty Phillips、ライター

Black は意見が強いため、あなたがそうである必要はありません。

Hynek Schlawack、attrs の作成者、Twisted および CPython のコア開発者

クリスマスに欲しいのは、ひどくない自動フォーマッターだけです！

Carl Meyer、Django コア開発者

少なくとも名前はいいですね。

Kenneth Reitz、requests および pipenv の作成者

これは私たちのコードのフォーマットを大幅に改善します。本当にありがとう！

スタイルを見せる

プロジェクトの README.md でバッジを使用してください

[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

README.rst でバッジを使用する

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
   :target: https://github.com/psf/black

このようになります

https://img.shields.io/badge/code%20style-black-000000.svg

目次

ユーザーガイド

開発

索引とテーブル