A Django app to generate a simple and automatic api documentation with Tastypie
Project description
A Django app to generate a simple and automatic api documentation with Tastypie.
Installation
pip install django-tastypie-simple-api-doc
Usage
First, add this to installed app and django_markup (we use this package to format classes docstrings).
INSTALLED_APPS = ( 'tastypie_api_doc', 'django_markup', )
Then you need to tell me where is your Tastypie Api object that will be documented. Put it’s path in settings.py like this:
API_OBJECT_LOCATION = "app.module.object_name"
In my test project was like this:
API_OBJECT_LOCATION = "project.urls.v1_api"
Got it? Now go to your urls module and goes like this:
from tastypie_api_doc.views import build_doc urlpatterns = [ ... url(r'^choose_your_url', build_doc), ]
And….We are almost there. Now, you need to “collect your static” if you know what I mean. :P
python manage.py collectstatic
And this is it. :)
This is a work in progress but it can be already used in your projects. So, stay tuned. Feel free to contribute to get this app way more better. =D
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for django-tastypie-simple-api-doc-0.5.0b1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6a1df09f256a2ad4624a2564c4f1d8552b624722175dd19586391da47e72050b |
|
MD5 | 761f9f5e01019b93e44b348fc52d0a6a |
|
BLAKE2b-256 | 1cd0ef486e4e8419011bbf387c0e2c044e0091ad03055a22f0fb35311b2f3b1f |