Issue 22: Django Rest Framework autohttp support

[Nekmo]

Closes #22.

To use it add to conf.py:

directory = os.path.dirname(os.path.abspath(__file__))
# Add project root path to sys.path
sys.path.append(os.path.abspath(os.path.join(directory, '../')))

os.environ['DJANGO_SETTINGS_MODULE'] = 'my_project.settings'
django.setup()

This requirement is the same as to use autodoc, so if autodoc is probably already configured.

Add the extension:

extensions = [
    'sphinx.ext.autodoc',
    ...
    'sphinxcontrib.autohttp.drf',
]

And use it:

.. autodrf:: 

Features:

• List routes with their description and action method (post, get...).
• List the query params, urls params and form/json params with their description. Includes types.

More features could be added in the future.

[ashb]

Hi @Nekmo, I've just taken over working on this project, and noticed your (now very old PR).

Do you still want this? If so could you please add some unit tests?

If I don't hear back from you in two weeks I'll close this PR.

[moorchegue]

This looks promising. Any chance of being finished/merged?

[stevepiercy]

@Nekmo @moorchegue I've taken on maintenance of httpdomain. This feature would be a nice addition. Would you like to add unittests? There are examples for the other servers to serve as a guide. Without tests, it's not something that I feel comfortable maintaining. Please let me know. Thank you!

[moorchegue]

I've used this and it worked IIRC. Can't help with tests though.

[stevepiercy]

The criteria to merge this PR would be the following:

• Add unittests
• Update this branch against main
• Add documentation in doc/index.rst
• Add a change log entry in doc/changelog.rst

Then I'll review and merge. Thank you!