Skip to content

Latest commit

 

History

History
269 lines (180 loc) · 10.4 KB

CHANGELOG.md

File metadata and controls

269 lines (180 loc) · 10.4 KB

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Note that in line with Django REST Framework policy, any parts of the framework not mentioned in the documentation should generally be considered private API, and may be subject to change.

[3.1.0] - 2020-02-08

Added

  • Added support for Python 3.8
  • Added support for Django REST framework 3.11
  • Added support for Django 3.0

Fixed

  • Ensured that 409 Conflict is returned when processing a PATCH request in which the resource object’s type and id do not match the server’s endpoint as outlined in JSON:API spec.
  • Properly return parser error when primary data is of invalid type
  • Pass instance to child serializers when using PolymorphicModelSerializer
  • Properly resolve related resource type when using PolymorphicModelSerializer

[3.0.0] - 2019-10-14

This release is not backwards compatible. For easy migration best upgrade first to version 2.8.0 and resolve all deprecation warnings before updating to 3.0.0

Added

  • Added support for Django REST framework 3.10.
  • Added code from ErrorDetail into the JSON:API error object.

Changed

  • Moved dependency definition for django-polymorphic and django-filter into extra requires. Hence dependencies of each optional module can be installed with pip using 
    pip install djangorestframework-jsonapi['django-polymorphic']
pip install djangorestframework-jsonapi['django-filter']

Removed

  • Removed support for Python 2.7 and 3.4.
  • Removed support for Django Filter 1.1.
  • Removed obsolete dependency six.
  • Removed support for Django REST Framework <=3.9.
  • Removed support for Django 2.0.
  • Removed obsolete mixins MultipleIDMixin and PrefetchForIncludesHelperMixin
  • Removed obsolete settings JSON_API_FORMAT_KEYS, JSON_API_FORMAT_RELATION_KEYS and JSON_API_PLURALIZE_RELATION_TYPE
  • Removed obsolete util methods format_keys and format_relation_name
  • Removed obsolete pagination classes PageNumberPagination and LimitOffsetPagination

Fixed

  • Avoid printing invalid pointer when api returns 404.
  • Avoid exception when using ResourceIdentifierObjectSerializer with unexisting primary key.
  • Format metadata field names correctly for OPTIONS request.

[2.8.0] - 2019-06-13

This is the last release supporting Python 2.7, Python 3.4, Django Filter 1.1, Django REST Framework <=3.9 and Django 2.0.

Added

  • Add support for Django 2.2

Changed

  • Allow to define select_related per include using select_for_includes
  • Use REST framework serializer functionality to extract includes. This adds support like using dotted notations in source attribute in ResourceRelatedField.

Fixed

  • Avoid exception when trying to include skipped relationship
  • Don't swallow filter[] params when there are several
  • Fix DeprecationWarning regarding collections.abc import in Python 3.7
  • Allow OPTIONS request to be used on RelationshipView
  • Remove non-JSONAPI methods (PUT and TRACE) from ModelViewSet and RelationshipView. This fix might be a BREAKING CHANGE if your clients are incorrectly using PUT instead of PATCH.
  • Avoid validation error for missing fields on a PATCH request using polymorphic serializers

Deprecated

  • Deprecate PrefetchForIncludesHelperMixin use PreloadIncludesMixin instead

[2.7.0] - 2019-01-14

Added

  • Add support for Django 2.1, DRF 3.9 and Python 3.7. Please note:
    • Django >= 2.1 is not supported with Python < 3.5.

Fixed

  • Pass context from PolymorphicModelSerializer to child serializers to support fields which require a request context such as url.
  • Avoid patch on RelationshipView deleting relationship instance when constraint would allow null (#242)
  • Avoid error with related urls when retrieving relationship which is referenced as ForeignKey on parent
  • Do not render write_only relations
  • Do not skip empty one-to-one relationships
  • Allow HyperlinkRelatedField to be used with related urls
  • Avoid exception in AutoPrefetchMixin when including a reverse one to one relation (#537)
  • Avoid requested resource(s) to be added to included as well (#524)

[2.6.0] - 2018-09-20

Added

  • Add testing configuration to REST_FRAMEWORK configuration as described in DRF
  • Add HyperlinkedRelatedField and SerializerMethodHyperlinkedRelatedField. See usage docs
  • Add related urls support. See usage docs
  • Add optional jsonapi-style filter backends. See usage docs

Deprecated

  • Deprecate MultipleIDMixin because it doesn't comply with the JSON:API 1.0 spec. Replace it with DjangoFilterBackend and change clients to use filter[id.in] query parameter instead of ids[]. See usage docs. You also have the option to copy the mixin into your code.

Changed

Fixed

  • Performance improvement when rendering relationships with ModelSerializer
  • Do not show deprecation warning when user has implemented custom pagination class overwriting default values.

[2.5.0] - 2018-07-11

Added

  • Add new pagination classes based on JSON:API query parameter recommendations:
    • JsonApiPageNumberPagination and JsonApiLimitOffsetPagination. See usage docs.
  • Add ReadOnlyModelViewSet extension with prefetch mixins
  • Add support for Django REST Framework 3.8.x
  • Introduce JSON_API_FORMAT_FIELD_NAMES option replacing JSON_API_FORMAT_KEYS but in comparison preserving values from being formatted as attributes can contain any json value.
  • Allow overwriting of get_queryset() in custom ResourceRelatedField

Deprecated

  • Deprecate PageNumberPagination and LimitOffsetPagination. Use JsonApiPageNumberPagination and JsonApiLimitOffsetPagination instead.
    • To retain deprecated values for PageNumberPagination and LimitOffsetPagination create new custom class like the following in your code base:
    class CustomPageNumberPagination(PageNumberPagination):
  page_query_param = "page"
  page_size_query_param = "page_size"

class CustomLimitOffsetPagination(LimitOffsetPagination):
  max_limit = None
    and adjust REST_FRAMEWORK['DEFAULT_PAGINATION_CLASS'] setting accordingly.
  • Deprecate JSON_API_FORMAT_KEYS, use JSON_API_FORMAT_FIELD_NAMES.

Fixed

  • Performance improvement when rendering included data

[2.4.0] - 2018-01-25

Added

  • Add support for Django REST Framework 3.7.x.
  • Add support for Django 2.0.

Removed

  • Drop support for Django 1.8 - 1.10 (EOL)
  • Drop support for Django REST Framework < 3.6.3 (3.6.3 is the first to support Django 1.11)
  • Drop support for Python 3.3 (EOL)

[2.3.0] - 2017-11-28

Added

  • Add support for polymorphic models
  • Add nested included serializer support for remapped relations

Changed

  • Enforcing flake8 linting

Fixed

  • When JSON_API_FORMAT_KEYS is False (the default) do not translate request attributes and relations to snake_case format. This conversion was unexpected and there was no way to turn it off.
  • Fix for apps that don't use django.contrib.contenttypes.
  • Fix resource_name support for POST requests and nested serializers

[2.2.0] - 2017-04-22

Added

  • Add support for Django REST Framework 3.5 and 3.6
  • Add support for Django 1.11
  • Add support for Python 3.6

[2.1.1] - 2016-09-26

Added

  • Allow default DRF serializers to operate even when mixed with DRF-JA serializers

Fixed

  • Avoid setting id to None in the parser simply because it's missing
  • Fix out of scope relation_instance variable in renderer
  • Fix wrong resource type for reverse foreign keys
  • Fix documentation typos

[2.1.0] - 2016-08.18

Added

  • Parse meta in JSONParser
  • Add code coverage reporting and updated Django versions tested against
  • Add support for regular non-ModelSerializers

Changed

  • Documented built in url field for generating a self link in the links key
  • Convert include field names back to snake_case
  • Raise a ParseError if an id is not included in a PATCH request

Fixed

  • Fix Django 1.10 compatibility
  • Performance enhancements to reduce the number of queries in related payloads
  • Fix issue where related SerializerMethodRelatedField fields were not included even if in include
  • Fix bug that prevented fields = () in a serializer from being valid
  • Fix stale data returned in PATCH to-one relation

[2.0.1] - 2016-05-02

Fixed

  • Fixes naming error that caused ModelSerializer relationships to fail

[2.0.0] - 2016-04-29

Added

  • Add get_related_field_name for views subclassing RelationshipView to override
  • Added LimitOffsetPagination
  • Support deeply nested ?includes=foo.bar.baz without returning intermediate models (bar)
  • Allow a view's serializer_class to be fetched at runtime via get_serializer_class
  • Added support for get_root_meta on list serializers

Changed

  • Exception handler can now easily be used on DRF-JA views alongside regular DRF views
  • Rename JSON_API_FORMAT_RELATION_KEYS to JSON_API_FORMAT_TYPES to match what it was actually doing
  • Rename JSON_API_PLURALIZE_RELATION_TYPE to JSON_API_PLURALIZE_TYPES
  • Documented ResourceRelatedField and RelationshipView

Fixed

  • Fixes bug where write_only fields still had their keys rendered