See: #585

Merge branch 'master' of https://github.com/steve-gregory/django-rest-framework into slug-field-fixes

See: #584

Adding timedelta support to JSONEncoder, and an example of how to add decode support to a serializer.

Whilst this commit adds *encoding* of timedeltas to a string of a floating
point value of the seconds, you must add your own serializer field for
whatever timedelta model field you are using. This is because Django doesn't
support any kind of timedelta field out-of-the-box, so you have to either
implement your own or use django-timedelta.

If this is the case and you want to serialise timedelta input, you will have
to implement your own special field to use for the timedelta, which is not
included in core as it is based on a 3rd party library. Here is an example:

    import datetime
    import timedelta
    from django import forms
    from django.core import validators
    from django.core.exceptions import ValidationError
    from django.utils.translation import ugettext_lazy as _
    from rest_framework.fields import WritableField

    class TimedeltaField(WritableField):
        type_name = 'TimedeltaField'
        form_field_class = forms.FloatField

        default_error_messages = {
            'invalid': _("'%s' value must be in seconds."),
        }

        def from_native(self, value):
            if value in validators.EMPTY_VALUES:
                return None

            try:
                return datetime.timedelta(seconds=float(value))
            except (TypeError, ValueError):
                msg = self.error_messages['invalid'] % value
                raise ValidationError(msg)

Which is based on the FloatField. This field can then be used in
your serializer like this:

    from yourapp.fields import TimedeltaField

    class YourSerializer(serializers.ModelSerializer):
        duration = TimedeltaField()

Fixed a minor template bug

Format extensions have already been introduced.

If format extensions are used,
they must be used in the creation of the
reverse URLs.

A minor gramatical correction

Make the whitespace uniform

Revised Tutorial

This is to allow the addition of elements without
having to change existing lines of code

Unused imports

Handle ObjectDoesNotExist exceptions when serializing null reverse one-to-one