CamelCase CoreJSON Codec for easier integration with non-Python clients #162
Description
I've been integrating the new DRF Schemas into my app and converting it to use the CoreAPI JS client. Overall the process has been super smooth, however there's some inconsistencies in variable casing between my API (which uses djangorestframework_camel_case to render responses in a more JS friendly format) and my schema (which does not support this).
I've spent some time messing with it and I've gotten a subclass of the SchemaJSView to render camelcase using the same renderer as the rest of my app.
While this works for me, I'd love to see support for this added to DRF and CoreAPI for others to more easily use. Please let me know what you think and how I could PR this to CoreAPI and DRF.
My CamelCaseCoreAPI Codec
import json
from coreapi.compat import COMPACT_SEPARATORS, VERBOSE_SEPARATORS
from coreapi.compat import force_bytes, string_types, urlparse
from coreapi.codecs.corejson import (
CoreJSONCodec, _document_to_primitive, _primitive_to_document
)
from coreapi.document import Document, Link, Array, Object, Error, Field
from djangorestframework_camel_case.util import camelize, underscoreize
class CamelCaseCoreJSONCodec(CoreJSONCodec):
""" A subclass of the CoreAPI CoreJSON Codec, that additionally performs
a simple transformation to CamelCase-style syntax for easy consumption
by Javascript and other similar clients.
"""
def decode(self, bytestring, **options):
"""
Takes a bytestring and returns a document.
"""
base_url = options.get('base_url')
try:
data = underscoreize(json.loads(bytestring.decode('utf-8')))
except ValueError as exc:
raise ParseError('Malformed JSON. %s' % exc)
doc = _primitive_to_document(data, base_url)
if isinstance(doc, Object):
doc = Document(content=dict(doc))
elif not (isinstance(doc, Document) or isinstance(doc, Error)):
raise ParseError('Top level node should be a document or error.')
return doc
def encode(self, document, **options):
"""
Takes a document and returns a bytestring.
"""
indent = options.get('indent')
if indent:
kwargs = {
'ensure_ascii': False,
'indent': 4,
'separators': VERBOSE_SEPARATORS
}
else:
kwargs = {
'ensure_ascii': False,
'indent': None,
'separators': COMPACT_SEPARATORS
}
data = _document_to_primitive(document)
return force_bytes(json.dumps(camelize(data), **kwargs))Note: In messing around I found that I needed to repeat a lot of the CoreJSONCodec in my code. I'm wondering if we can tweak the CoreJSONCodec a bit to more elegantly do the encoding/decoding.
Edit: wording.