Establecer explícitamente docstring de un método

Question

Ayudo a mantener un paquete para python llamado nxt-python. Utiliza metaclases para definir los métodos de un objeto de control. Aquí está el método que define las funciones disponibles:

class _Meta(type): 
    'Metaclass which adds one method for each telegram opcode' 

    def __init__(cls, name, bases, dict): 
     super(_Meta, cls).__init__(name, bases, dict) 
     for opcode in OPCODES: 
      poll_func, parse_func = OPCODES[opcode] 
      m = _make_poller(opcode, poll_func, parse_func) 
      setattr(cls, poll_func.__name__, m) 

Quiero ser capaz de añadir una cadena de documentación diferente a cada uno de estos métodos que se añade. m es un método devuelto por _make_poller(). ¿Algunas ideas? ¿Hay alguna forma de evitar la restricción de python al cambiar las cadenas de documentos?

Answer 1

Para las funciones de civil:

def f(): # for demonstration 
    pass 

f.__doc__ = "Docstring!" 
help(f) 

Esto funciona tanto en python2 y python3, en funciones con y sin docstrings definidos. También puede hacer +=. Tenga en cuenta que es __doc__ y no __docs__.

Para los métodos, es necesario utilizar el atributo __func__ del método:

class MyClass(object): 

    def myMethod(self): 
     pass 

MyClass.myMethod.__func__.__doc__ = "A really cool method" 

Answer 2

También se puede utilizar en la setattr/objeto de función de clase y establecer la cadena de documentación.

setattr(foo,'__doc__',"""My Doc string""")