Почему я должен установить __doc__ частичного объекта в Python?

Question

help() doesn't show the __doc__ частичного объекта. Тем не менее, пример в docs множеств это:

>>> 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 

Это всегда хорошо, чтобы документировать все, даже обертоны.