コードをBlackにしよう

PythonのコードフォーマッターのBlackはいいぞというLTです。

Transcript

1. コードをBlackにしよう
2. 自己紹介 • Twitter / GitHub ◦ ikura1 • 仕事 ◦ スポーツデータを用いた統計や機械学習 • 最近やってること ◦ Djangoと戯れてる
3. 好きなスタイル教えてください
4. どのスタイルが好きですか？ 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
5. 人によって好きなコードは違う
6. Pythonを使っていても PEP8に守っていても 違いは出る
7. 人のコードを読む機会はよくある • ブログ • 仕事 ◦ チーム ◦ 前任者 • OSS • 1ヶ月前の自分のコード
8. 読みにくいコードもある
9. わたしの場合は前任者のコード • 仕事としては機能追加 • 来たコードは ◦ スタイルが意識されていないコード ◦ 可読性がなくて読むのに時間がかかる ◦ 人力で直すのはつらいコード量
10. フォーマッターは使った • 指定されたフォーマットに直してくれるだけの機能 • 人が処理できない行数を簡単にフォーマットできる • コーディング時にスタイルを気にする必要がなくなる • レビュー時にスタイルを指摘することがなくなります
11. 考えることが減らせる! 必要な所に集中できる!
12. フォーマッターはいいぞ!
13. 有名なフォーマッター • autopep8 • YAPF • Black
14. Blackはいいぞ • 名前がかっこいい • 設定をすることができない
15. Blackは設定することができない • それが魅力でそれが全て ◦ 使っているコードならスタイル気にせず読める ◦ 細かい調整をする必要がない ◦ チームでスタイルの議論をする必要がなくなる ◦ 個人の好みでスタイルが変化することがなくなる
16. Pythonを使っていても PEP8に従っていても 違いは出る
17. Blackを使えば違いは出ない
18. Blackが使われているプロダクト • pytest • SQLAlchemy • Pyramid • Sanic • Tornado • Poetry • Pipenv
19. Blackが使われているプロダクト • pytest • SQLAlchemy • Pyramid • Sanic • Tornado • Poetry • Pipenv
20. DjangoもBlackが提案され承認されている • 既存・新規の障壁を取り除ける • スタイルを気にする必要がない • 設定を調整する必要がない • ハードルが一つ少なくなる • ベータなので安定したら実行する
21. Blackの使い方 $ pip install black $ black hoge.py reformatted hoge.py All done! ✨ ✨ 1 file reformatted.
22. コードをBlackにしませんか？