पायथन सजावट हैंडलिंग डॉकस्ट्रिंग

Question

मुझे सजावटी के साथ डॉकस्ट्रिंग का उपयोग करने में समस्या है। निम्न उदाहरण को देखते हुए:

def decorator(f): 
    def _decorator(): 
     print 'decorator active' 
     f() 
    return _decorator 

@decorator 
def foo(): 
    '''the magic foo function''' 
    print 'this is function foo' 

help(foo) 

अब मदद की उम्मीद के रूप में मेरे foo की docstring प्रदर्शित नहीं करता है, यह पता चलता है:

Help on function _decorator in module __main__: 

_decorator() 

डेकोरेटर के बिना, मदद सही है:

Help on function foo in module __main__: 

foo() 
    the magic foo function 

मुझे पता है कि समारोह foo सजावट द्वारा लपेटा गया है, और इसलिए फ़ंक्शन ऑब्जेक्ट foo फ़ंक्शन नहीं है। लेकिन उम्मीद के अनुसार डॉकस्ट्रिंग (और सहायता) प्राप्त करने का एक अच्छा समाधान क्या है?

Answer 1

उपयोग functools.wraps() डेकोरेटर की विशेषताओं को अद्यतन करने के:

from functools import wraps 

def decorator(f): 
    @wraps(f) 
    def _decorator(): 
     print 'decorator active' 
     f() 
    return _decorator 

@decorator 
def foo(): 
    '''the magic foo function''' 
    print 'this is function foo' 

help(foo) 

इसके अलावा functools के लिए Standard Library documentation देखते हैं।

Answer 2

मैं एक समाधान नहीं मिला है, लेकिन अगर यह वास्तव में अच्छा है पता नहीं है:

def decorator(f): 
    def _decorator(): 
     print 'decorator active' 
     f() 
    _decorator.__name__=f.__name__ 
    _decorator.__doc__=f.__doc__ 
    return _decorator 

_decorator.__name__=f.__name__ साथ हिस्सा एक छोटा सा घृणित लगता है ... आप क्या सोचते हैं?

Answer 3

functools.wraps पर एक नज़र डालें: http://docs.python.org/library/functools.html

Answer 4

यह शायद अब थोड़ा पुराना है, लेकिन यह तुम कैसे करते है। यह मेरे लिए घृणित नहीं लगती है functools.wraps वास्तव में क्या करना

from functools import wraps 

def decorator(f): 
    @wraps(f) 
    def _decorator(): 
     print 'decorator active' 
     return f() 
    return _decorator 

@decorator 
def foo(): 
    '''the magic foo function''' 
    print 'this is function foo' 

help(foo)