今回は、Pythonのdocstring(ドックストリング)についてまとめてみました。 docstringは、Pythonコードの可読性を向上させるための非常に便利なツールです。特に、Pythonを学んでいる方や、コードの品質を向上させたい方にお役に立てればと思い執筆しました。
コードに「説明書(ドキュメント)」を埋め込むための公式な方法です。 三重クォート(""" ... """)の文字列。 コードの説明文で、help()コマンドやツールから読める。 例: def say_hello(): """うさうさ店長があいさつします。""" print("🐇 こんにちは、うさうさ ...
本ツールは、指定されたディレクトリ配下の Python ファイルに対し、docstring を生成するツールである。 構造は保持:関数・クラス・メソッドの名前や引数をコピー。 docstring を挿入: 関数の定義の下に docstring を挿入。 既にdocstring がある場合は上書きする。