(エンジニアに送る)人に優しくなるための3つの方法 / 3 Ways for Engineers to Be Kind to People

(エンジニアの方々に送る) 人に優しくなるための 3つの方法 Webナイト宮崎 Vol.8　～てげ良いコード書きたい～

お前誰よ？？名前：杉田尚弥(@suginao17) 出身：宮崎所属：株式会社アラタナ趣味：辛麺

良いコード is 何？

先生に聞いてみた！

今回話す、”良いコード” 他人(レビュアー)が見て理解しやすい・親切なコード

どうやったら書けるの？・エンジニア個々人が努力する💦 ・プロジェクトやチーム単位でコーディング規約を設ける😩

結論：エンジニアが疲弊するだけなのでツールやライブラリを使おう！

【フォーマッタ】 ﬂake8, black 【静的型チェッカー】 mypy 【ツール・エディタ】 pre-commit VSCode PyCharm

　フォーマッタ【ﬂake8】・PEP8に加え、シンタックスエラーまでチェックする・pyﬂakes(論理的なエラーを検知) ・pycodestyle(規約に準拠しているか検知) ・mccabe(循環複雑度の高いコードを検知) ・設定ファイルで自由に規約を変更できる

　フォーマッタ【black】・PEP8に準拠しているかのチェック・制限が強く自由に設定ができない → 導入が楽・ﬂake8と相性が悪いので、一部設定を変える必要有

　静的型チェッカー【mypy】・Python3.5で実装された型ヒントを静的に解析する・実行前に型エラーを検知できる・可読性を担保する

　ツール【pre-commit】・フックスクリプトを管理する・GitHubで公開されているリポジトリを指定して実行できる・任意のタイミングで処理を実行できる・コミット前にフォーマット・プッシュ前に型チェック

　エディタ【VSCode】・設定ファイル次第で可能性は∞👍 ・設定沼にハマらないように注意【PyCharm】・Pythonを書くんだったら、間違いない・設定しなくても、だいたいのことができる

【言語別対応表】並べたものの、あまりピンとこない... 大体あってる！？　おまけ Python PHP JavaScript フォーマッタ black PHPMD
Prettier リンター flake8 PHPCS ESLint 型チェック mypy Phan Flow

ツールを上手に使って人間に優しくなろう！　最後に

naoya_s