我目前从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)
6
Thera在前面的问题中也有很多答案,这是重复的。
—
Alex Dupuy 2014年