Creating delicious APIs for Django apps since 2010. v1.0.0-beta
Pull request Compare This branch is even with ff0000:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



Creating delicious APIs for Django apps since 2010.

Currently in beta (v1.0.0-beta) but being used actively in production on several

Differences between this patched version and Django Tastypie

This version includes three patches that have been submitted as pull requests
to the creators of Django Tastypie:

* 6bf187d > if an Error 500 occurs, the message of the exception is shown in 
  the error description, instead of a generic 'This request could not be 
* 18d7a90 > when using Django's DummyCache, CacheThrottle does not fail
* 1fbc0a8 > allows file uploads (attachments) on POST requests

Once these patches are included in the source repository, this fork will not
be required anymore.



* Python 2.5+
* Django 1.2+ (May work on Django 1.1)
* mimeparse 0.1.3+ (

  * Older versions will work, but their behavior on JSON/JSONP is a touch wonky.

* dateutil ( >= 1.5, < 2.0


* python_digest (
* lxml ( if using the XML serializer
* pyyaml ( if using the YAML serializer
* biplist ( if using the binary plist serializer

What's It Look Like?

A basic example looks like::

    # myapp/
    # ============
    from tastypie.resources import ModelResource
    from myapp.models import Entry

    class EntryResource(ModelResource):
        class Meta:
            queryset = Entry.objects.all()

    # =======
    from django.conf.urls.defaults import *
    from tastypie.api import Api
    from myapp.api import EntryResource

    v1_api = Api(api_name='v1')

    urlpatterns = patterns('',
        # The normal jazz here then...
        (r'^api/', include(v1_api.urls)),

That gets you a fully working, read-write API for the ``Entry`` model that
supports all CRUD operations in a RESTful way. JSON/XML/YAML support is already
there, and it's easy to add related data/authentication/caching.

You can find more in the documentation at

Why tastypie?

There are other, better known API frameworks out there for Django. You need to
assess the options available and decide for yourself. That said, here are some
common reasons for tastypie.

* You need an API that is RESTful and uses HTTP well.
* You want to support deep relations.
* You DON'T want to have to write your own serializer to make the output right.
* You want an API framework that has little magic, very flexible and maps well to
  the problem domain.
* You want/need XML serialization that is treated equally to JSON (and YAML is
  there too).
* You want to support my perceived NIH syndrome, which is less about NIH and more
  about trying to help out friends/coworkers.

Reference Material

* shows
  basic usage of tastypie

:author: Daniel Lindsley
📅 2011/09/16