Camel case JSON support for Django REST framework

django, camel-case, django-rest-framework, camelcase, python
pip install djangorestframework-camel-case2==0.3.0


Django REST Framework JSON CamelCase

Build Status PyPI

Camel case JSON support for Django REST framework.

Compatible with:

  • Python: Python 3.5+
  • Django: 2.2, 3.0+
  • Django REST framework: 3.9, 3.10, 3.11

Note: This is a replacement for djangorestframework-camel-case which seems currently unmaintained.


At the command line::

$ pip install djangorestframework-camel-case2

Add the render and parser to your django settings file.


        # Any other renders

        # Any other parsers

Swapping Renderer

By default the package uses rest_framework.renderers.JSONRenderer. If you want to use another renderer (the only possible alternative is rest_framework.renderers.UnicodeJSONRenderer, only available in DRF < 3.0), you must specify it in your django settings file.

# ...
    'RENDERER_CLASS': 'rest_framework.renderers.UnicodeJSONRenderer'
# ...

Underscoreize Options

As raised in there are two conventions of snake case.

# Case 1 (Package default)
v2Counter -> v_2_counter
fooBar2 -> foo_bar_2

# Case 2
v2Counter -> v2_counter
fooBar2 -> foo_bar2

By default, the package uses the first case. To use the second case, specify it in your django settings file.

    # ...
        'no_underscore_before_number': True,
    # ...

Alternatively, you can change this behavior on a class level by setting json_underscoreize:

from djangorestframework_camel_case2.parser import CamelCaseJSONParser
from rest_framework.generics import CreateAPIView

class NoUnderscoreBeforeNumberCamelCaseJSONParser(CamelCaseJSONParser):
    json_underscoreize = {'no_underscore_before_number': True}
class MyView(CreateAPIView):
    queryset = MyModel.objects.all()
    serializer_class = MySerializer
    parser_classes = (NoUnderscoreBeforeNumberCamelCaseJSONParser,)

Running Tests

To run the current test suite, execute the following from the root of the project

poetry run pytest