rename JSONAPIDjangoFilter to DjangoFilterBackend.

Per discussion about naming, the idea is that it should be easy to updgrade from DRF to DJA
by simply changing some imports, retaining the same DRF (or in this case, django-filter) class
names that are extended by DJA.
see #467 (comment)

Author: n2ygk

docs/usage.md

@@ -34,7 +34,7 @@ REST_FRAMEWORK = {
     'DEFAULT_METADATA_CLASS': 'rest_framework_json_api.metadata.JSONAPIMetadata',
     'DEFAULT_FILTER_BACKENDS': (
         'rest_framework_json_api.filters.JSONAPIOrderingFilter',
-        'rest_framework_json_api.filters.JSONAPIDjangoFilter',
+        'rest_framework_json_api.filters.DjangoFilterBackend',
     ),
     'TEST_REQUEST_RENDERER_CLASSES': (
         'rest_framework_json_api.renderers.JSONRenderer',
@@ -119,8 +119,8 @@ field name and the other two are not valid:
 If you want to silently ignore bad sort fields, just use `rest_framework.filters.OrderingFilter` and set
 `ordering_param` to `sort`.
 
-#### `JSONAPIDjangoFilter`
-`JSONAPIDjangoFilter` implements a Django ORM-style [JSON:API `filter`](http://jsonapi.org/format/#fetching-filtering)
+#### `DjangoFilterBackend`
+`DjangoFilterBackend` implements a Django ORM-style [JSON:API `filter`](http://jsonapi.org/format/#fetching-filtering)
 using the [django-filter](https://django-filter.readthedocs.io/) package.
 
 This filter is not part of the JSON:API standard per-se, other than the requirement
@@ -176,7 +176,7 @@ from rest_framework_json_api import filters
 class MyViewset(ModelViewSet):
     queryset = MyModel.objects.all()
     serializer_class = MyModelSerializer
-    filter_backends = (filters.JSONAPIOrderingFilter, filters.JSONAPIDjangoFilter,)
+    filter_backends = (filters.JSONAPIOrderingFilter, filters.DjangoFilterBackend,)
 ```
 
 

example/settings/dev.py

@@ -91,7 +91,7 @@
     'DEFAULT_METADATA_CLASS': 'rest_framework_json_api.metadata.JSONAPIMetadata',
     'DEFAULT_FILTER_BACKENDS': (
         'rest_framework_json_api.filters.JSONAPIOrderingFilter',
-        'rest_framework_json_api.filters.JSONAPIDjangoFilter',
+        'rest_framework_json_api.filters.DjangoFilterBackend',
     ),
     'TEST_REQUEST_RENDERER_CLASSES': (
         'rest_framework_json_api.renderers.JSONRenderer',

rest_framework_json_api/filters/__init__.py

@@ -2,5 +2,5 @@
 from .sort import JSONAPIOrderingFilter  # noqa: F401
 # If django-filter is not installed, no-op.
 if pkgutil.find_loader('django_filters') is not None:
-    from .filter import JSONAPIDjangoFilter  # noqa: F401
+    from .django_filter import DjangoFilterBackend  # noqa: F401
 del pkgutil

rest_framework_json_api/filters/filter.py renamed to rest_framework_json_api/filters/django_filter.py

@@ -8,7 +8,7 @@
 from rest_framework_json_api.utils import format_value
 
 
-class JSONAPIDjangoFilter(DjangoFilterBackend):
+class DjangoFilterBackend(DjangoFilterBackend):
     """
     A Django-style ORM filter implementation, using `django-filter`.
 
@@ -110,7 +110,7 @@ def filter_queryset(self, request, queryset, view):
         """
         # TODO: remove when Python 2.7 support is deprecated
         if VERSION >= (2, 0, 0):
-            return super(JSONAPIDjangoFilter, self).filter_queryset(request, queryset, view)
+            return super(DjangoFilterBackend, self).filter_queryset(request, queryset, view)
 
         filter_class = self.get_filter_class(view, queryset)