show correct docstring for wrapped function

[wangchao1230]

Environment data

• Pylance language server: 2020.7.1
• OS and version: win 10
• Python version (& distribution if applicable, e.g. Anaconda): Python 3.7.6 64bit

Expected behaviour

Actual behaviour

Steps to reproduce

from functools import wraps

def decorator(func):
    """ This is the decorator doc """
    @wraps(func)
    def wrapper(*args, **kwargs):
        """ This is the wrapper doc """
        return func(*args, **kwargs)
    return wrapper

@decorator
def some_func():
    """ This is the actual doc """
    return 1 + 1

some_func()
print(some_func.__name__)
print(some_func.__doc__)

[erictraut]

When you create a decorator, it replaces the function that it's decorating. Many decorators (like the one in your example) return the original function. This fact can be obscured to the type checker because of the way the they are annotated.

For a detailed explanation and the recommended fix, see this issue. If you apply this fix within your code, the docstring of the original function will appear as you expect.

[wangchao1230]

Eric, thank you so much!
That's exactly what I need. ❤️