如何以编程方式设置文档字符串？

Question

我有一个返回一个函数的包装函数。有没有办法以编程方式设置返回函数的文档字符串？如果可以写信，__doc__请执行以下操作：

def wrapper(a):
    def add_something(b):
       return a + b
    add_something.__doc__ = 'Adds ' + str(a) + ' to `b`'
    return add_something

那我可以做

>>> add_three = wrapper(3)
>>> add_three.__doc__
'Adds 3 to `b`

但是，由于__doc__是只读的，所以我不能这样做。正确的方法是什么？

编辑：好的，我想保持这个简单，但是，这当然不是我真正想做的。即使__doc__就我而言通常是可写的，但事实并非如此。

我正在尝试unittest自动创建测试用例。我有一个包装函数，该函数创建一个类对象，该类对象是的子类unittest.TestCase：

import unittest
def makeTestCase(filename, my_func):
    class ATest(unittest.TestCase):
        def testSomething(self):
            # Running test in here with data in filename and function my_func
            data  = loadmat(filename)
            result = my_func(data)
            self.assertTrue(result > 0)

    return ATest

如果我创建此类并尝试设置docstring，testSomething则会出现错误：

>>> def my_func(): pass
>>> MyTest = makeTestCase('some_filename', my_func)
>>> MyTest.testSomething.__doc__ = 'This should be my docstring'
AttributeError: attribute '__doc__' of 'instancemethod' objects is not writable

Answer 1

我会将文档字符串传递给工厂函数，并用于type手动构造类。

def make_testcase(filename, myfunc, docstring):
    def test_something(self):
        data = loadmat(filename)
        result = myfunc(data)
        self.assertTrue(result > 0)

    clsdict = {'test_something': test_something,
               '__doc__': docstring}
    return type('ATest', (unittest.TestCase,), clsdict)

MyTest = makeTestCase('some_filename', my_func, 'This is a docstring')