[B! pep8] koma_gのブックマーク

[Pythonコーディング規約]PEP8を読み解く - Qiita

PEP8という、Python自体の標準ライブラリなどに対するコーディング規約に関して、過去誤って理解していたことが何度かありました。（少し理解が大変なところもあって、しっかり読み込まないと、実はその書き方NGだった、という経験が・・）ただ、17年前に書かれたある種古典的なドキュメントで、今でも大事にされているということを考慮すると、とても良いことが書かれているというのも事実なのかなと思います。（Pythonを使用したプロジェクトでPEP8を加味したり、Jupyterの拡張機能含めPEP8を考慮したライブラリなどが多く用意されていることなども考えると）そこで、本記事では個人的な解釈をしつつ、PEP8について読み解いてまとめてみます。（元の記事は著作権がパブリックドメインなので、使いつつまとめさせていただきます） ※PEP8すべては触れません。はじめに考慮すべきことプロジェクトごとに、

koma_g 2022/08/13

リンク

Python: pep8 は pycodestyle になったし pep257 は pydocstyle になった - CUBE SUGAR CONTAINER

意外とまだあんまり知られていないような気がしたので、このブログにも書いておく。 PEP8 と pep8 と pycodestyle Python には PEP8 という有名なコーディングスタイルガイドラインがある。 www.python.org そして、そのコーディングスタイルに沿ったコードになっているのかをチェックするツールとして pep8 というパッケージがあった。 pypi.python.org 過去形にするのは半分正しくなくて、上記のように今もある。ただ、これは後方互換のために残されているだけで、もうバージョンアップはされないだろう。今後は代わりに pycodestyle というパッケージを使うことになる。 pypi.python.org これは単にパッケージとコマンドの名前が変わっただけ。とはいえ、こちらはバージョンアップが続くので最新の PEP8 に追従していくしチェック

koma_g 2018/09/19

リンク

はじめに — pep8-ja 1.0 ドキュメント

X-Translator: Yoshinari Takaoka <reversethis -> gro tod umumum ta umumum> はじめに¶ この文書は Python の標準ライブラリに含まれているPythonコードのコーディング規約です。CPython に含まれるC言語のコードについては、対応するC言語のスタイルガイドを記した PEP を参照してください。この文書と PEP 257 (Docstring 規約) は、Guido が書いたオリジナルのPythonスタイルガイドのエッセイと、 Barry のスタイルガイドに少し追記したものをまとめたものです。 [2] このスタイルガイドは、追加の規約が必要だとわかったり、Pythonの言語自体が変更されることで過去の規約が時代遅れになった時に徐々に改訂されてゆきます。多くのプロジェクトには、自分たちのコーディングスタイル

koma_g 2018/08/09

Guido の重要な洞察のひとつに、コードは書くよりも読まれることの方が多い、というものがあります。

リンク

はじめに — pep8-ja 1.0 ドキュメント

X-Translator: Yoshinari Takaoka <reversethis -> gro tod umumum ta umumum> はじめに¶ この文書は Python の標準ライブラリに含まれているPythonコードのコーディング規約です。CPython に含まれるC言語のコードについては、対応するC言語のスタイルガイドを記した PEP を参照してください。この文書と PEP 257 (Docstring 規約) は、Guido が書いたオリジナルのPythonスタイルガイドのエッセイと、 Barry のスタイルガイドに少し追記したものをまとめたものです。 [2] このスタイルガイドは、追加の規約が必要だとわかったり、Pythonの言語自体が変更されることで過去の規約が時代遅れになった時に徐々に改訂されてゆきます。多くのプロジェクトには、自分たちのコーディングスタイル

koma_g 2015/04/07

リンク

Python編集環境を整える: pytestとかvimのプラグインとか

B! 120 0 0 0 Python用の環境設定について最近更新したので経過メモ。特にVimのプラグインとかについて。外部コマンド Vim シンタックスハイライト等インデント補完畳み込み外部コマンド文法チェックをしたり pep8 に準拠するような作法に整えたりするために Pythonスクリプトをチェックするコマンドとしては pytest が便利です。 pytest本体ではpep8までチェックできませんが、 pytest-pep8 も入れる事でpep8についてまでチェックできる様になります。 $ pip install pytest-pep8 で必要な物を全てインストールしてくれます(pep8やpytest等)。使い方は $ py.test --pep8 target.py 等と、.pyファイルを与えるかディレクトリを与えるとそのディレクトリ内の.pyファイル全てをチェッ

koma_g 2015/03/19

リンク

vimでpythonのコーディングスタイルを自動でチェック&自動修正する - blog.ton-up.net

PythonにはPEP8 (日本語訳)という公式のコーディングスタイルあります。どうせならちゃんとコーディングスタイルに沿った綺麗なコードが書きたいですよね。ということでvimでPythonコードがPEP8に従っているか自動的にチェック、修正するようにします。 PEP8のチェック PEP8に従っているかチェックするにはpep8という、そのままの名前のツールを使います。 pep8 - Python style guide checker おまけとしてpyflakesという、文法チェックや未使用なimportや変数を教えてくれる便利なツールも入れときます。 pyflakes - passive checker of Python programs インストールはpipで。ちなみに、pep8とpyflakesを合体したような、flake8というツールもあります。 flake8 - the