Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
[Pycon Kyushu 2019] Pythonでの開発を効率的に進めるためのツール設定
Search
Atsushi Odagiri
May 18, 2019
Technology
9
46k
[Pycon Kyushu 2019] Pythonでの開発を効率的に進めるためのツール設定
Atsushi Odagiri
May 18, 2019
Tweet
Share
More Decks by Atsushi Odagiri
See All by Atsushi Odagiri
setuptoolsの最近
aodag
1
2.5k
あなたとPython今すぐパッケージング
aodag
2
3.6k
LL2018 LT Pythonパッケージマネージャーはどれがおすすめ?
aodag
2
1.7k
Other Decks in Technology
See All in Technology
What's Next in OpenShift Q2 CY2025
redhatlivestreaming
1
810
Slackひと声でブログ校正!Claudeレビュー自動化編
yusukeshimizu
3
180
うちの会社の評判は?SNSの投稿分析にAIを使ってみた
doumae
0
240
Javaアプリケーションの配布とパッケージング / Distribution and packaging of Java applications
hogelog
1
190
いまさら聞けない Git 超入門 〜Gitって結局なに?から始める第一歩〜
devops_vtj
0
160
会社紹介資料 / Sansan Company Profile
sansan33
PRO
6
360k
Data Hubグループ 紹介資料
sansan33
PRO
0
1.7k
OTel meets Wasm: プラグイン機構としてのWebAssemblyから見る次世代のObservability
lycorptech_jp
PRO
1
300
LT:組込み屋さんのオシロが壊れた!
windy_pon
0
450
Eight Engineering Unit 紹介資料
sansan33
PRO
0
3.2k
【5分でわかる】セーフィー エンジニア向け会社紹介
safie_recruit
0
25k
libsyncrpcってなに?
uhyo
0
150
Featured
See All Featured
We Have a Design System, Now What?
morganepeng
52
7.6k
The Myth of the Modular Monolith - Day 2 Keynote - Rails World 2024
eileencodes
25
2.8k
Let's Do A Bunch of Simple Stuff to Make Websites Faster
chriscoyier
507
140k
The MySQL Ecosystem @ GitHub 2015
samlambert
251
12k
I Don’t Have Time: Getting Over the Fear to Launch Your Podcast
jcasabona
32
2.3k
Design and Strategy: How to Deal with People Who Don’t "Get" Design
morganepeng
129
19k
Creating an realtime collaboration tool: Agile Flush - .NET Oxford
marcduiker
30
2.1k
Visualizing Your Data: Incorporating Mongo into Loggly Infrastructure
mongodb
45
9.6k
Thoughts on Productivity
jonyablonski
69
4.7k
Responsive Adventures: Dirty Tricks From The Dark Corners of Front-End
smashingmag
252
21k
The Power of CSS Pseudo Elements
geoffreycrofte
76
5.8k
XXLCSS - How to scale CSS and keep your sanity
sugarenia
248
1.3M
Transcript
Python での開発を効率的に進めるためのツー ル設定 Pycon Kyushu 2019 Atushi Odagiri May 18,
2019
Outline はじめに プログラミングエディター コード補完/クオリティチェック/フォーマッタ テスト/デバッグ/プロファイル タスクランナー プロジェクトテンプレート まとめ
お前誰よ aodag open collector pylonsproject.jp
Python 開発ツール クオリティチェック/コード補完/フォーマッタ テスト/デバッグ/プロファイル タスクランナー プログラミングエディター
エディターに望む機能 シンタックスハイライト 賢い補完 静的チェックの結果表示 スニペットの展開 プログラム可能な機能
優秀なプログラミングエディター emacs vim visual studio code pycharm
コード補完 jedi 他に…知らない
jedi コード補完のエンジン いろんなエディタの補完プラグインから呼べる 名前についてはご愛敬
コード補完をもっとうまくやる typing annotation 特に引数につけないと関数内で補完効かない . の連鎖を減らす a.b.c.d など連鎖すると type annotation
がない場合、補完で きる可能性が低くなります
クオリティチェック flake8 おすすめ pylint mypy
pylint pylint は厳しすぎ メソッド数の下限上限 例えばコンストラクタだけのオーバーライドなど禁止 その場しのぎの回避もまた別のチェックにひっかかる 全体的な設計変更に…
flake8 pycodestyle + pyflakes フォーマッタ使うと pycodestyle 部分はそれほど.. pyflakes やってしまいがちなケアレスミスのチェック 宣言のない変数
関数名の重複 利用していない変数 … おすすめというかもはや必須
mypy type annotation のチェック jedi での補完目的で type annotation するなら必ず mypy
で チェックしましょう ignore_missing_imports は必須! type annotation を提供してないライブラリは多いので… docstring でがんばって型を説明するくらいなら annotation にしてほしいところ
フォーマッタ autopep8 yapf black おすすめ isort おすすめ
black のいいところ ほとんど設定変更できない 諦めがつく へんな亜流が出てこない
black のよくわからないところ なぜか行の最大長が 88 文字
その import、ソートできますか? isort は import 文の順番に特化したフォーマッタ 標準ライブラリ、サードパーティライブラリ、開発中ソース ツリーの順になおしてくれる これでエラー出たり、挙動が変わるなら循環依存があるので なんとかしましょう
black と isort を組み合わせる デフォルトだと black のフォーマットと違う isort のスタイル設定を black
に合わせる Vertical Hanging Indent multi_line_output=3 isort の行の長さを black に合わせる line_length=88
isort (3: Vertical Hanging Indent) from third_party import ( lib1,
lib2, lib3, lib4, )
black と flake8 flake8 の独自解釈が black のフォーマットと衝突する 演算子の改行位置 W503 line
break before binary operator スライス演算子の前後スペース E203 whitespace before ':' しょうがないので ignore しましょう
演算子の改行位置 W503 line break before binary operator x = (aaaaaaaaaaaaaaaaa
+ bbbbbbbbbbbbbbbbbbb) y = (aaaaaaaaaaaaaaaaa + bbbbbbbbbbbbbbbbbbb)
スライス演算子の前後スペース E203 whitespace before ':' black はスライス演算子前後で計算式が入るとスペースを入 れる flake8 は
: にスペースをいれてはいけないと言ってくる この場合の : は演算子ではなくブロック構文の区切りの : のことのはず a = x[start:stop] a = x[start:(start + count)] a = x[start : (start + count)]
フォーマッターを導入していくには 一気に導入 フォーマットのみの PR が嫌でなければ blame したときに困るかも 部分的に導入 なんらかの修正時にフォーマッターをかけていく autopep8
などの設定である内容だけ適用していく フォーマットかけると本来の変更との diff が見づらい
black, isort を CI で使う CI でフォーマットするのではない フォーマット済みであるか確認する check オプションや
diff オプション
テスト unittest nose pytest おすすめ zope.testrunner
pytest テストフレームワーク テストランナー
テストランナーとしての pytest 名前でテストを探し出す discovery 機能 test_* とか Test* とか unittest
で書いたテストでも実行可能 賢いテストレポート 成功したテストの print を表示しない assert が落ちた時、付近の変数の内容を表示してくれる
テストフレームワークとしての pytest fixture まあ好き嫌いはありますが 最近は yield で setup/teadown 相当の処理をそのまま書けます yield_fixture
は deprecated marker 適当にテストを分類したり 特殊な fixture を割り当てたり parametrize もうテストメソッドの中で for 文なんかいらないぞ! 入出力の違いだけのテストならこれでいきましょう parametrize 自体に fixture できないのはちょっと不満
pytest アドオン pytest-cov 基本です。いれておきましょう。 自分が狙ったテストを書けているか確認しましょう coverage に溺れないように! pytest-randomly インストールするだけでテスト順序がシャッフルされます 順序に依存したテストを発見しましょう
ユニットテストを一歩先のステージにもっていきましょう pytest-mock patch デコレータがいくつもある人に patch コンテキストな何段も積み重なってる人に SPY など追加のユーティリティもあるので mock をそのまま 使うよりちょっと便利
デバッグ 使ってないのでわかりません (´・ω・`)
プロファイル profiler gprof2dots profiler の結果を (プロットじゃない方の) グラフ表示にしてく れる
pyinvoke tasks.py 関数に @task デコレータつけるだけ from invoke import task @task
def hello(ctx): print("Hello")
nox テストに特化したタスクランナー tox を invoke にしたようなツール virtualenv と連携
paste script メンテナ不在? そろそろ退役? プロジェクトテンプレートをパッケージングする
cookiecutter github とかで公開リポジトリにするだけ pyramid などの有名プロジェクトも cookiecutter で提供する ようになりました paste script
ほど複雑なことはできない もう複雑なことはやめましょう
設定ファイル ツール独自 .flake8 pytest.ini … setup.cfg tox.ini pyproject.toml
最終公分母は setup.cfg か tox.ini しかたないね black だけ pyproject.toml まあ black
は設定しないって割り切れば… テスト系は tox.ini、それ以外は setup.cfg とか分ける方法も
tox.ini [tool:pytest] test_paths = tests [isort] line_length = 88 multi_line_output
= 3 [flake8] max-line-length = 80 ;W503 line break before binary operator ;E203 whitespace before ':' ignore = W503,E203
こんなにツール入れなくても pycharmでできちゃうよ! って人は CI 上でも pycharm 実行してチェッカーにしてくだ さい
まとめ クオリティチェックは機械にやらせましょう せめて flake8 は標準でいれていてほしいところ フォーマッタはレビュアーのためにいれてあげてください 主義主張は black の前には無意味だ 秘伝のコマンドラインはみんなで使えるようにしましょう
自分のローカルマシンでしか動かない? 環境変数に追い 出せ! エディタは 自主規制により省略されました