[解決済み] Pythonのドキュメントにjavadocを使う [終了しました]
2022-04-23 14:46:21
質問
私は現在Pythonを使い始めていますが、PHPのバックグラウンドが強く、PHPでは
javadoc
をドキュメントのテンプレートとして使用します。
と思っていたのですが
javadoc
は、その場所を
docstring
のドキュメントをPythonで作成します。
ここで確立された規約や公式ギルドラインは何ですか?
例えば、このようなことはPythonの考え方に合わせるには凝りすぎでしょうか、それともできるだけ簡潔にした方が良いでしょうか?
"""
replaces template place holder with values
@param string timestamp formatted date to display
@param string priority priority number
@param string priority_name priority name
@param string message message to display
@return string formatted string
"""
そして、もし私が少し網羅的すぎるのであれば、代わりにこのようなものを選ぶべきでしょう(ここでは、ほとんどのドキュメントは
__doc__
メソッド) を使うことができますか?
# replaces template place holder with values
#
# @param string timestamp formatted date to display
# @param string priority priority number
# @param string priority_name priority name
# @param string message message to display
#
# @return string formatted string
def format(self, timestamp = '', priority = '', priority_name = '', message = ''):
"""
replaces template place holder with values
"""
values = {'%timestamp%' : timestamp,
'%priorityName%' : priority_name,
'%priority%' : priority,
'%message%' : message}
return self.__pattern.format(**values)
解決方法は?
をご覧ください。 reStructuredText (別名 "reST") フォーマットはプレーンテキスト/docstring マークアップフォーマットで、おそらく Python の世界で最も人気のあるフォーマットでしょう。そして、あなたは確かに スフィンクス reStructuredTextからドキュメントを生成するツールです(例えば、Pythonのドキュメント自体に使用されています)。Sphinxには、コードの中のdocstringからドキュメントを抽出する機能があります( sphinx.ext.autodoc を認識します。 フィールドリスト は、一定の規則に従っています。これはおそらく最も一般的な方法になっている(あるいはなりつつある)でしょう。
例としては、次のようなものが考えられます。
"""Replaces template placeholder with values.
:param timestamp: formatted date to display
:param priority: priority number
:param priority_name: priority name
:param message: message to display
:returns: formatted string
"""
または型情報で拡張。
"""Replaces template placeholder with values.
:param timestamp: formatted date to display
:type timestamp: str or unicode
:param priority: priority number
:type priority: str or unicode
:param priority_name: priority name
:type priority_name: str or unicode
:param message: message to display
:type message: str or unicode
:returns: formatted string
:rtype: str or unicode
"""
関連
-
[解決済み】DataFrameのコンストラクタが正しく呼び出されない!エラー
-
[解決済み】Python regex AttributeError: 'NoneType' オブジェクトに 'group' 属性がない。
-
[解決済み] for'ループでインデックスにアクセスする?
-
[解決済み] 関数内でグローバル変数を使用する
-
[解決済み] Pythonには文字列の'contains'サブストリングメソッドがありますか?
-
[解決済み] Pythonで現在時刻を取得する方法
-
[解決済み] Pythonで2つのリストを連結する方法は?
-
[解決済み】ネストされたディレクトリを安全に作成するには?
-
[解決済み】forループを使った辞書の反復処理
-
[解決済み】Pythonに三項条件演算子はありますか?
最新
-
nginxです。[emerg] 0.0.0.0:80 への bind() に失敗しました (98: アドレスは既に使用中です)
-
htmlページでギリシャ文字を使うには
-
ピュアhtml+cssでの要素読み込み効果
-
純粋なhtml + cssで五輪を実現するサンプルコード
-
ナビゲーションバー・ドロップダウンメニューのHTML+CSSサンプルコード
-
タイピング効果を実現するピュアhtml+css
-
htmlの選択ボックスのプレースホルダー作成に関する質問
-
html css3 伸縮しない 画像表示効果
-
トップナビゲーションバーメニュー作成用HTML+CSS
-
html+css 実装 サイバーパンク風ボタン
おすすめ
-
ピロウズ画像色処理の具体的な活用方法
-
PicgoのイメージベッドツールをPythonで実装する
-
Python 入出力と高次代入の基礎知識
-
[解決済み】numpyの配列連結。"ValueError:すべての入力配列は同じ次元数でなければならない"
-
[解決済み】ImportError: PILという名前のモジュールがない
-
[解決済み] 'int'オブジェクトに'__getitem__'属性がない。
-
[解決済み】ImportError: bs4という名前のモジュールがない(BeautifulSoup)
-
[解決済み] パラメータを持つメソッドを文書化する方法は?
-
[解決済み] Pythonのdocstringで最も一般的な形式は何ですか?[クローズド]です。
-
[解決済み] "パラメータ "と "引数 "の比較【重複