Skip to main content

No project description provided

Project description

Keyed Lists for Django REST Framework

This package supports the serialization and deserialization of a list of objects stored in a dict where a unique value from the object (often a pk) is used as the key in the dict. For example,

{
    "1": {<other fields for object with id 1>},
    "2": {<other fields for object with id 2>},
    ...
}

Install

pip install drf-keyed-list

Usage

The following is a usage example:

class MySerializer(ModelSerializer):

    class Meta:
        list_serializer_class = KeyedListSerializer
        keyed_list_serializer_field = 'id'

By replacing the list_serializer_class, this behavior will only be enabled when the many=True flag is used:

instance = {
   "id": "pk_val",
   "field1": "val1",
   "field2": "val2",
   ...
}

serializer = MySerializer(data=instance)
# this should work
serializer.is_valid()
serializer.save()

keyed_list = {
   "pk_val": {
       "field1": "val1",
       "field2": "val2",
       ...
   }
}

# many=True will trigger the keyed-list behavior
serializer = MySerializer(data=keyed_list, many=True)
# this should also work
serializer.is_valid()
serializer.save()

NOTE: keyed_list_serializer_field MUST refer to a Unique field or key collision may occur during serialization, plus undefined deserializaiton behavior if used in combination with nested writable serializers (e.g. drf-writable-nested). At this time, the package does not make any effort to verify that a Unique field has been selected.

Authors

2018, Clayton Daley III

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for drf-keyed-list, version 0.0.2
Filename, size File type Python version Upload date Hashes
Filename, size drf_keyed_list-0.0.2-py3-none-any.whl (7.5 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page