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

「好きな色をどうぞ」

Blackを使用することで、手動フォーマットの細部の制御を譲ることに同意することになります。その代わりに、Blackはスピード、決定性、およびフォーマットに関するpycodestyleの煩わしさからの解放を提供します。より重要な事柄に時間と精神的エネルギーを節約できます。

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

目次

ユーザーガイド

開発

索引とテーブル