Model Classes¶

Of course, there are classes to support dealing with Models.

ModelSerialiser¶

This class will, like a ModelForm, inspect a Model and generate appropriate fields for it.

class MyModelSerialiser(ModelSerialiser):

    class Meta:
        model = MyModel
        fields = [...fields to include...]
        exclude = [...fields to exclude...]
        read_only = [...fields to mark read-only...]

Like any other serialiser, you can define additional fields, as well as custom inflate/deflate methods.

By default, the restore_object method will pass the inflated dict to the model to create a new instance, or update all the properties on an existing instance. It will save the updated instance, however you can pass commit=False to prevent this.

Meta¶

The ModelSerialiser supports additional Meta properties:

class ModelMeta¶

model¶: Default: None The model this Serialiser is for

fields¶: Default: () The list of fields to use from the Model

exclude¶: Default: () The list of fields to ignore from the Model

read_only_fields¶: Default: () The list of fields from the Model to mark as read-only

field_types¶: Default {} A map of field names to Field class overrides.

related_fields¶: Default: ()

ignore_fields¶: Default: () When restoring an object, the fields which should not be passed to the instance.

key_fields¶: Default: (‘id’,) When trying to get_or_create a model instance, which fields from the inflated data should be used to match the model.

defaults¶: Default: {} When trying to get_or_create a model instance, additional default values to pass.

core_fields¶: Default: () When trying to get_or_create a model instance, additional fields to include in the defaults dict.

ModelPublisher sub-classes¶

There are two extra sub-classes to help building complex cases when restoring instances.

ModelReadSerialiser will only retrieve existing instances, passing all data to the managers get method.

The ModelCreateUpdateSerialier will try to construct a new instance, or update an existing one if it can be found.

The values found from Meta.key_fields will be passed to get_or_create. The defaults argument will be constructed from Meta.defaults, and the infalted values listed in Meta.core_fields.

Then, the instance will be updated for all fields not listed in Meta.related_fields or Meta.ignored_fields.

Finally, all Meta.related_fields will be set by calling their add method.

ModelPublisher¶

A ModelPublisher adds a model property to a publisher, which by default yields the model of the serialiser class.

It also adds get_object_list and get_object, where get_object assumes object_id is the pk of the model.

This gives basic read-only access to your model through the API.

modelserialiser_factory¶

This utility class allows you to programmatically generate a ModelSerialiser.

myser = modelserialiser_factory(name, model, [fields=], [exclude=], [read_only=], **kwargs)

The optional arguments will be treated the same as if passed in the Meta of a ModelSerialiser. Additional deflate/inflate methods may be passed in kwargs.

ModelSerialiserField & ModelManySerialiserField¶

Model counterparts to SerialiserField and ManySerialiserField. If not passed a serialiser, they will generate one from the model provided.