私は現在Pythonから始めており、PHPのバックグラウンドが高く、PHPではjavadoc
ドキュメントテンプレートとして使用する習慣をつけています。
Pythonのドキュメンテーションjavadoc
としての場所があるのかと思っていましたdocstring
。ここで確立された規則および/または公式のガイドラインは何ですか?
たとえば、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)