108 lines
3.8 KiB
Python
108 lines
3.8 KiB
Python
from django.db import models
|
|
|
|
|
|
class MinMaxIntegerField(models.IntegerField):
|
|
"""
|
|
IntegerField with options to set a min- and a max-value.
|
|
"""
|
|
|
|
def __init__(self, min_value=None, max_value=None, *args, **kwargs):
|
|
self.min_value, self.max_value = min_value, max_value
|
|
super(MinMaxIntegerField, self).__init__(*args, **kwargs)
|
|
|
|
def formfield(self, **kwargs):
|
|
defaults = {'min_value': self.min_value, 'max_value': self.max_value}
|
|
defaults.update(kwargs)
|
|
return super(MinMaxIntegerField, self).formfield(**defaults)
|
|
|
|
|
|
class RESTModelMixin:
|
|
"""
|
|
Mixin for Django models which are used in our REST API.
|
|
"""
|
|
|
|
access_permissions = None
|
|
|
|
def get_root_rest_element(self):
|
|
"""
|
|
Returns the root rest instance.
|
|
|
|
Uses self as default.
|
|
"""
|
|
return self
|
|
|
|
@classmethod
|
|
def get_access_permissions(cls):
|
|
"""
|
|
Returns a container to handle access permissions for this model and
|
|
its corresponding viewset.
|
|
"""
|
|
return cls.access_permissions
|
|
|
|
@classmethod
|
|
def get_collection_string(cls):
|
|
"""
|
|
Returns the string representing the name of the collection. Returns
|
|
None if this is not a so called root rest instance.
|
|
"""
|
|
# TODO Check if this is a root rest element class and return None if not.
|
|
return '/'.join((cls._meta.app_label.lower(), cls._meta.object_name.lower()))
|
|
|
|
def get_rest_pk(self):
|
|
"""
|
|
Returns the primary key used in the REST API. By default this is
|
|
the database pk.
|
|
"""
|
|
return self.pk
|
|
|
|
def save(self, skip_autoupdate=False, information=None, *args, **kwargs):
|
|
"""
|
|
Calls Django's save() method and afterwards hits the autoupdate system.
|
|
|
|
If skip_autoupdate is set to True, then the autoupdate system is not
|
|
informed about the model changed. This also means, that the model cache
|
|
is not updated. You have to do this manually, by creating a collection
|
|
element from the instance:
|
|
|
|
CollectionElement.from_instance(instance)
|
|
|
|
The optional argument information can be a dictionary that is given to
|
|
the autoupdate system.
|
|
"""
|
|
# We don't know how to fix this circular import
|
|
from .autoupdate import inform_changed_data
|
|
return_value = super().save(*args, **kwargs)
|
|
if not skip_autoupdate:
|
|
inform_changed_data(self.get_root_rest_element(), information=information)
|
|
return return_value
|
|
|
|
def delete(self, skip_autoupdate=False, information=None, *args, **kwargs):
|
|
"""
|
|
Calls Django's delete() method and afterwards hits the autoupdate system.
|
|
|
|
If skip_autoupdate is set to True, then the autoupdate system is not
|
|
informed about the model changed. This also means, that the model cache
|
|
is not updated. You have to do this manually, by creating a collection
|
|
element from the instance:
|
|
|
|
CollectionElement.from_instance(instance, deleted=True)
|
|
|
|
or
|
|
|
|
CollectionElement.from_values(collection_string, id, deleted=True)
|
|
|
|
The optional argument information can be a dictionary that is given to
|
|
the autoupdate system.
|
|
"""
|
|
# We don't know how to fix this circular import
|
|
from .autoupdate import inform_changed_data, inform_deleted_data
|
|
instance_pk = self.pk
|
|
return_value = super().delete(*args, **kwargs)
|
|
if not skip_autoupdate:
|
|
if self != self.get_root_rest_element():
|
|
# The deletion of a included element is a change of the root element.
|
|
inform_changed_data(self.get_root_rest_element(), information=information)
|
|
else:
|
|
inform_deleted_data(self.get_collection_string(), instance_pk, information=information)
|
|
return return_value
|