This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

Overview

JSON API reference implementation for Django Rest Framework

This is an extremely thorough implementation of the JSON API 1.0 specification for the Django Rest Framework. It has strict error handling of non-compliant clients & follows all of the MUST’s of the spec (or will soon where missing).

Known incomplete JSON API spec features/guidelines are:

  • Error object pointers
  • “Relationship Links”

Error object pointers isn’t very great currently. It handles field-level, resource-level, & relationship “pointer” construction just fine but I don’t think it will handle any sort of complex nested field errors. The pointer may not be accurate. I’ll have to test & figure out a way to do that properly with DRF & it’s native ValidationError field names.

This matters when you look at RFC 6901. We may need something more robust here as an additional DRF plugin that drfjsonapi requires.

Relationship links are the “self” member of the links object for relationships. Currently, ember doesn’t support relationship modificiation for that endpoint so I have no incentive yet to write it. Having said that, some abstractions have already been written in this library to make the transition easy in the future.

Aside from those known limitations this library is REALLY complete. A TON of focus & attention was spent on meaningful errors & good exception handling. Much more to come on that front as I’m aware needs to be more thorough but those enhancements will come without needing to worry about the JSON API spec.

A breakdown of notable features currently implemented that you’d want in any JSON API server implementation are:

  • filter query params (spanning relationships)
  • include query params (spanning relationships)
  • page query params
  • sort query params
  • related resource links
  • ridiculously easy to follow code
  • comprehensive error handling (parsers, serializers, views, etc)
  • error coalescing
  • hooks for almost every part of the JSON API processing pipeline
  • good quality code comments

Requirements

  • Python (2.7, 3.3, 3.4)
  • Django (1.6, 1.7, 1.8)
  • Django REST Framework (2.4, 3.0, 3.1)

Installation

Install using pip

$ pip install drfjsonapi

Example

TODO: Write example.

Testing

Install testing requirements.

$ pip install -r requirements.txt

Run with runtests.

$ ./runtests.py

You can also use the excellent tox testing tool to run the tests against all supported versions of Python and Django. Install tox globally, and then simply run:

$ tox

Documentation

To build the documentation, you’ll need to install mkdocs.

$ pip install mkdocs

To preview the documentation:

$ mkdocs serve
Running at: http://127.0.0.1:8000/

To build the documentation:

$ mkdocs build
Release History

Release History

0.4.0

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.3.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.2.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
drfjsonapi-0.4.0-py2.py3-none-any.whl (27.1 kB) Copy SHA256 Checksum SHA256 2.7 Wheel Apr 6, 2016
drfjsonapi-0.4.0.tar.gz (23.3 kB) Copy SHA256 Checksum SHA256 Source Apr 6, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting