Merge branch 'develop'

Author: jerel

.gitignore

@@ -28,6 +28,9 @@ pip-delete-this-directory.txt
 # Pycharm project files
 .idea/
 
+# PyTest cache
+.cache/
+
 # Tox
 .tox/
 

.travis.yml

@@ -1,30 +1,38 @@
+---
 language: python
-python: 3.5
 sudo: false
-install: pip install tox
-script: tox
+cache: pip
+matrix:
+  exclude:
+    - python: "3.3"
+      env: DJANGO=">=1.9,<1.10" DRF=">=3.3,<3.4"
+    - python: "3.3"
+      env: DJANGO=">=1.9,<1.10" DRF=">=3.4,<3.5"
+    - python: "3.3"
+      env: DJANGO=">=1.10,<1.11" DRF=">=3.4,<3.5"
+python:
+  - "2.7"
+  - "3.3"
+  - "3.4"
+  - "3.5"
 env:
-  - TOXENV=py27-django17-drf31
-  - TOXENV=py27-django17-drf32
-  - TOXENV=py33-django17-drf31
-  - TOXENV=py33-django17-drf32
-  - TOXENV=py34-django17-drf31
-  - TOXENV=py34-django17-drf32
-  - TOXENV=py27-django18-drf31
-  - TOXENV=py27-django18-drf32
-  - TOXENV=py27-django18-drf33
-  - TOXENV=py33-django18-drf31
-  - TOXENV=py33-django18-drf32
-  - TOXENV=py33-django18-drf33
-  - TOXENV=py34-django18-drf31
-  - TOXENV=py34-django18-drf32
-  - TOXENV=py34-django18-drf33
-  - TOXENV=py27-django19-drf31
-  - TOXENV=py27-django19-drf32
-  - TOXENV=py27-django19-drf33
-  - TOXENV=py34-django19-drf31
-  - TOXENV=py34-django19-drf32
-  - TOXENV=py34-django19-drf33
-  - TOXENV=py35-django19-drf31
-  - TOXENV=py35-django19-drf32
-  - TOXENV=py35-django19-drf33
+  - DJANGO=">=1.8,<1.9" DRF=">=3.1,<3.2"
+  - DJANGO=">=1.8,<1.9" DRF=">=3.2,<3.3"
+  - DJANGO=">=1.8,<1.9" DRF=">=3.3,<3.4"
+  - DJANGO=">=1.8,<1.9" DRF=">=3.4,<3.5"
+
+  - DJANGO=">=1.9,<1.10" DRF=">=3.3,<3.4"
+  - DJANGO=">=1.9,<1.10" DRF=">=3.4,<3.5"
+
+  - DJANGO=">=1.10,<1.11" DRF=">=3.4,<3.5"
+before_install:
+  # Force an upgrade of py to avoid VersionConflict
+  - pip install --upgrade py
+  - pip install codecov
+install:
+  - pip install Django${DJANGO} djangorestframework${DRF}
+  - python setup.py install
+script:
+  - coverage run setup.py -v test
+after_success:
+  - codecov

CHANGELOG.md

@@ -1,4 +1,22 @@
 
+v2.1.0
+
+* Parse `meta` in JSONParser
+* Added code coverage reporting and updated Django versions tested against
+* Fixed Django 1.10 compatibility
+* Added support for regular non-ModelSerializers
+* Added performance enhancements to reduce the number of queries in related payloads
+* Fixed bug where related `SerializerMethodRelatedField` fields were not included even if in `include`
+* Convert `include` field names back to snake_case
+* Documented built in `url` field for generating a `self` link in the `links` key
+* Fixed bug that prevented `fields = ()` in a serializer from being valid
+* Fixed stale data returned in PATCH to-one relation
+* Raise a `ParseError` if an `id` is not included in a PATCH request
+
+v2.0.1
+
+* Fixed naming error that caused ModelSerializer relationships to fail
+
 v2.0.0
 
 * Fixed bug where write_only fields still had their keys rendered

docs/api.md

@@ -47,3 +47,14 @@ Calls a `get_root_meta` function on a serializer, if it exists.
 `build_json_resource_obj(fields, resource, resource_instance, resource_name)`
 
 Builds the resource object (type, id, attributes) and extracts relationships.
+
+## rest_framework_json_api.parsers.JSONParser
+
+Similar to `JSONRenderer`, the `JSONParser` you may override the following methods if you need
+highly custom parsing control.
+
+#### parse_metadata
+
+`parse_metadata(result)`
+
+Returns a dictionary which will be merged into parsed data of the request. By default, it reads the `meta` content in the request body and returns it in a dictionary with a `_meta` top level key.

docs/usage.md

@@ -375,7 +375,7 @@ class LineItemViewSet(viewsets.ModelViewSet):
 
 ### RelationshipView
 `rest_framework_json_api.views.RelationshipView` is used to build
-relationship views (see the 
+relationship views (see the
 [JSON API spec](http://jsonapi.org/format/#fetching-relationships)).
 The `self` link on a relationship object should point to the corresponding
 relationship view.
@@ -449,9 +449,16 @@ def get_root_meta(self, resource, many):
 ```
 to the serializer. It must return a dict and will be merged with the existing top level `meta`.
 
+To access metadata in incoming requests, the `JSONParser` will add the metadata under a top level `_meta` key in the parsed data dictionary. For instance, to access meta data from a `serializer` object, you may use `serializer.initial_data.get("_meta")`. To customize the `_meta` key, see [here](api.md).
+
+### Links
+
+Adding `url` to `fields` on a serializer will add a `self` link to the `links` key.
+
+Related links will be created automatically when using the Relationship View.
+
 <!--
 ### Relationships
-### Links
 ### Included
 ### Errors
 -->

drf_example

@@ -0,0 +1,94 @@
+# -*- coding: utf-8 -*-
+# Generated by Django 1.9.5 on 2016-05-02 08:26
+from __future__ import unicode_literals
+
+from django.db import migrations, models
+import django.db.models.deletion
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Author',
+            fields=[
+                ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('modified_at', models.DateTimeField(auto_now=True)),
+                ('name', models.CharField(max_length=50)),
+                ('email', models.EmailField(max_length=254)),
+            ],
+            options={
+                'abstract': False,
+            },
+        ),
+        migrations.CreateModel(
+            name='AuthorBio',
+            fields=[
+                ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('modified_at', models.DateTimeField(auto_now=True)),
+                ('body', models.TextField()),
+                ('author', models.OneToOneField(on_delete=django.db.models.deletion.CASCADE, related_name='bio', to='example.Author')),
+            ],
+            options={
+                'abstract': False,
+            },
+        ),
+        migrations.CreateModel(
+            name='Blog',
+            fields=[
+                ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('modified_at', models.DateTimeField(auto_now=True)),
+                ('name', models.CharField(max_length=100)),
+                ('tagline', models.TextField()),
+            ],
+            options={
+                'abstract': False,
+            },
+        ),
+        migrations.CreateModel(
+            name='Comment',
+            fields=[
+                ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('modified_at', models.DateTimeField(auto_now=True)),
+                ('body', models.TextField()),
+                ('author', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, to='example.Author')),
+            ],
+            options={
+                'abstract': False,
+            },
+        ),
+        migrations.CreateModel(
+            name='Entry',
+            fields=[
+                ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('modified_at', models.DateTimeField(auto_now=True)),
+                ('headline', models.CharField(max_length=255)),
+                ('body_text', models.TextField(null=True)),
+                ('pub_date', models.DateField(null=True)),
+                ('mod_date', models.DateField(null=True)),
+                ('n_comments', models.IntegerField(default=0)),
+                ('n_pingbacks', models.IntegerField(default=0)),
+                ('rating', models.IntegerField(default=0)),
+                ('authors', models.ManyToManyField(to='example.Author')),
+                ('blog', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='example.Blog')),
+            ],
+            options={
+                'abstract': False,
+            },
+        ),
+        migrations.AddField(
+            model_name='comment',
+            name='entry',
+            field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='example.Entry'),
+        ),
+    ]

example/migrations/0001_initial.py

@@ -17,7 +17,7 @@ def get_root_meta(self, resource, many):
 
     class Meta:
         model = Blog
-        fields = ('name', )
+        fields = ('name', 'url',)
         meta_fields = ('copyright',)
 
 
@@ -35,6 +35,7 @@ def __init__(self, *args, **kwargs):
         'authors': 'example.serializers.AuthorSerializer',
         'comments': 'example.serializers.CommentSerializer',
         'featured': 'example.serializers.EntrySerializer',
+        'suggested': 'example.serializers.EntrySerializer',
     }
 
     body_format = serializers.SerializerMethodField()

example/migrations/__init__.py

@@ -26,6 +26,29 @@
     'example',
 ]
 
+TEMPLATES = [
+    {
+        'BACKEND': 'django.template.backends.django.DjangoTemplates',
+        'DIRS': [
+            # insert your TEMPLATE_DIRS here
+        ],
+        'APP_DIRS': True,
+        'OPTIONS': {
+            'context_processors': [
+                # Insert your TEMPLATE_CONTEXT_PROCESSORS here or use this
+                # list if you haven't customized them:
+                'django.contrib.auth.context_processors.auth',
+                'django.template.context_processors.debug',
+                'django.template.context_processors.i18n',
+                'django.template.context_processors.media',
+                'django.template.context_processors.static',
+                'django.template.context_processors.tz',
+                'django.contrib.messages.context_processors.messages',
+            ],
+        },
+    },
+]
+
 STATIC_URL = '/static/'
 
 ROOT_URLCONF = 'example.urls'