python docstrings中的字符串操作

更好的解决方案可能是使用装饰器,例如:

def add_docs_for(other_func):  
    def dec(func):  
        func.__doc__ = other_func.__doc__ + "\n\n" + func.__doc__
        return func
    return dec

def foo():
    """documentation for foo"""
    pass

@add_docs_for(foo)
def bar():
    """additional notes for bar"""
    pass

help(bar) # --> "documentation for foo // additional notes for bar"

这样就可以对docstring进行任意操作。

我想 this section 非常清楚:

什么是docstring?

docstring是一个字符串文本, 作为中的第一条语句发生 模块、函数、类或方法 定义。这样的docstring 这个 doc 它的特殊属性 对象。

所以,它不是一个计算为字符串的表达式,而是 字符串文字 .