タグ

eduとpep8に関するkoma_gのブックマーク (2)

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

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

    [Pythonコーディング規約]PEP8を読み解く - Qiita
  • はじめに — 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
    koma_g 2018/08/09
    Guido の重要な洞察のひとつに、コードは書くよりも読まれることの方が多い、というものがあります。
  • 1