If decorator is used, function disappears from mkdocstrings documentation

[kmcquade]

Describe the bug

When a decorator is used before a function, the function does NOT appear in the documentation:

To reproduce, try placing this as a decorator before any function:

import functools

@functools.lru_cache(maxsize=1024)
def my_function(some_arg):
    print()

Screenshots
When this decorator is used, the function does NOT appear in the documentation:

When the decorator is not used, the function DOES appear in the documentation:

System (please complete the following information):

• pytkdocs version: latest
• Python version: 3.7
• OS: Mac OS X

[pawamoy]

Indeed, I was able to reproduce. I will investigate right now 🙂 Thank you for the report @kmcquade

[pawamoy]

A few leads: the object is an _lru_cache_wrapper instance. It has a __qualname__ attribute (value is a partial dotted-path to the actual function), but probably more importantly a __wrapped__ attribute which is the actual function. I guess we could check for each member if it has a __wrapped__ attribute, and use it instead of the member itself. This will need more testing.

[kmcquade]

Yes it would be great it this could be added. The functions that leverage this are pretty important. I can't remove the func_tools.lru_cache decorator from the function because it made my program so much faster lol

[pawamoy]

I think we can safely use inspect.unwrap() on every member 🙂