setting the fields description if you are using function based views

[manosim]

setting the fields description if you are using function based views

[jsangilve]

@Dean-Christian-Armada Did you solve this?

[Dean-Christian-Armada]

Actually no, I switched to class-based views

[jsangilve]

Ok. I imagine as there is not a serializers_class decorator, neither a property that can be extracted from function based views, it's not possible get the fields description

[Dean-Christian-Armada]

Exactly, besides I found out that the class-based view is much better

[niscp]

I am working with the DRF and got struck at this point. I am using fuction based views , and I am not getting the details of input parameters in API doc page. Please help on this one , if someone came across it.

[EssaAlshammri]

@niscp have you found a solution ?

[dmussaku]

So, if you are using a decorator like @api_view, the pattern.callback in rest_framework_docs.api_endpoint.py will not be api_section as you might suspect. But the callable api_view which apparently doesn't contain a docstring.

So there is a way to get a docstring out of api_view function however. It is written here:
http://stackoverflow.com/questions/1782843/python-decorator-handling-docstrings

Basically you need to rewrite api_view in that way that it will contain a decorator functools.wraps() which will update the attrs of the decorator.
like so:

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)