コードをBlackにしよう

自己紹介 ● Twitter / GitHub ○ ikura1 ● 仕事 ○ スポーツデータを用いた統計や機械学習 ● 最近やってること ○ Djangoと戯れてる

好きなスタイル教えてください

どのスタイルが好きですか？ def replace( text, old, new ): ... txt = 'Hello, World' replace(txt, 'World', 'Osaka') def replace( text, old, new ): ... txt = "Hello, World" replace( txt, "World", "Osaka" ) def replace(text, old, new): ... txt = "Hello, World" replace(txt, "World", "Osaka") A B C

人によって好きなコードは違う

Pythonを使っていても PEP8に守っていても 違いは出る

人のコードを読む機会はよくある ● ブログ ● 仕事 ○ チーム ○ 前任者 ● OSS ● 1ヶ月前の自分のコード

読みにくいコードもある

わたしの場合は前任者のコード ● 仕事としては機能追加 ● 来たコードは ○ スタイルが意識されていないコード ○ 可読性がなくて読むのに時間がかかる ○ 人力で直すのはつらいコード量

フォーマッターは使った ● 指定されたフォーマットに直してくれるだけの機能 ● 人が処理できない行数を簡単にフォーマットできる ● コーディング時にスタイルを気にする必要がなくなる ● レビュー時にスタイルを指摘することがなくなります

考えることが減らせる! 必要な所に集中できる!

フォーマッターはいいぞ!

有名なフォーマッター ● autopep8 ● YAPF ● Black

Blackはいいぞ ● 名前がかっこいい ● 設定をすることができない

Blackは設定することができない ● それが魅力でそれが全て ○ 使っているコードならスタイル気にせず読める ○ 細かい調整をする必要がない ○ チームでスタイルの議論をする必要がなくなる ○ 個人の好みでスタイルが変化することがなくなる

Pythonを使っていても PEP8に従っていても 違いは出る

Blackを使えば違いは出ない

Blackが使われているプロダクト ● pytest ● SQLAlchemy ● Pyramid ● Sanic ● Tornado ● Poetry ● Pipenv

Blackが使われているプロダクト ● pytest ● SQLAlchemy ● Pyramid ● Sanic ● Tornado ● Poetry ● Pipenv

DjangoもBlackが提案され承認されている ● 既存・新規の障壁を取り除ける ● スタイルを気にする必要がない ● 設定を調整する必要がない ● ハードルが一つ少なくなる ● ベータなので安定したら実行する

Blackの使い方 $ pip install black $ black hoge.py reformatted hoge.py All done! ✨ ✨ 1 file reformatted.

コードをBlackにしませんか？