python - Python で部分オブジェクトの __doc__ を設定する必要があるのはなぜですか?

Question

help()__doc__部分オブジェクトのは表示されません。それでも、ドキュメントの例では次のように設定されています。

>>> from functools import partial
>>> basetwo = partial(int, base=2)
>>> basetwo.__doc__ = 'Convert base 2 string to an int.'
>>> basetwo('10010')
18

__doc__役に立たないのに、なぜ設定するのですか？

Answer 1

部分関数の設定__doc__は、より大きな関数に対してこれを行うのと同じです。

def somefunc(somerandomarg):
    """This is a docstring
    What I am doing is shorthand for __doc__ = "random docstring"
    For partials, you can't do this, so you set it with __doc__"""
    pass

部分的なものであっても、何でも文書化することは常に良いことです。