django-rest-framework/rest_framework/utils/model_meta.py

135 lines
4.6 KiB
Python
Raw Normal View History

2014-09-09 20:46:28 +04:00
"""
2014-09-18 14:20:56 +04:00
Helper function for returning the field information that is associated
2014-09-12 12:12:56 +04:00
with a model class. This includes returning all the forward and reverse
relationships and their associated metadata.
2014-09-18 14:20:56 +04:00
Usage: `get_field_info(model)` returns a `FieldInfo` instance.
2014-09-09 20:46:28 +04:00
"""
2014-09-10 19:57:22 +04:00
from collections import namedtuple
from django.core.exceptions import ImproperlyConfigured
2014-09-09 20:46:28 +04:00
from django.db import models
from django.utils import six
from rest_framework.compat import OrderedDict
2014-09-09 20:46:28 +04:00
import inspect
2014-09-18 14:20:56 +04:00
FieldInfo = namedtuple('FieldResult', [
'pk', # Model field instance
'fields', # Dict of field name -> model field instance
'forward_relations', # Dict of field name -> RelationInfo
'reverse_relations', # Dict of field name -> RelationInfo
'fields_and_pk', # Shortcut for 'pk' + 'fields'
'relations' # Shortcut for 'forward_relations' + 'reverse_relations'
])
RelationInfo = namedtuple('RelationInfo', [
'model_field',
'related',
'to_many',
'has_through_model'
])
2014-09-09 20:46:28 +04:00
def _resolve_model(obj):
"""
Resolve supplied `obj` to a Django model class.
`obj` must be a Django model class itself, or a string
representation of one. Useful in situtations like GH #1225 where
Django may not have resolved a string-based reference to a model in
another model's foreign key definition.
String representations should have the format:
'appname.ModelName'
"""
if isinstance(obj, six.string_types) and len(obj.split('.')) == 2:
app_name, model_name = obj.split('.')
resolved_model = models.get_model(app_name, model_name)
if resolved_model is None:
msg = "Django did not return a model for {0}.{1}"
raise ImproperlyConfigured(msg.format(app_name, model_name))
return resolved_model
2014-09-09 20:46:28 +04:00
elif inspect.isclass(obj) and issubclass(obj, models.Model):
return obj
raise ValueError("{0} is not a Django model".format(obj))
def get_field_info(model):
"""
Given a model class, returns a `FieldInfo` instance containing metadata
about the various field types on the model.
"""
opts = model._meta.concrete_model._meta
# Deal with the primary key.
pk = opts.pk
while pk.rel and pk.rel.parent_link:
# If model is a child via multitable inheritance, use parent's pk.
pk = pk.rel.to._meta.pk
# Deal with regular fields.
fields = OrderedDict()
2014-09-09 20:46:28 +04:00
for field in [field for field in opts.fields if field.serialize and not field.rel]:
fields[field.name] = field
# Deal with forward relationships.
forward_relations = OrderedDict()
2014-09-09 20:46:28 +04:00
for field in [field for field in opts.fields if field.serialize and field.rel]:
forward_relations[field.name] = RelationInfo(
2014-09-18 14:20:56 +04:00
model_field=field,
2014-09-09 20:46:28 +04:00
related=_resolve_model(field.rel.to),
to_many=False,
has_through_model=False
)
# Deal with forward many-to-many relationships.
for field in [field for field in opts.many_to_many if field.serialize]:
forward_relations[field.name] = RelationInfo(
2014-09-18 14:20:56 +04:00
model_field=field,
2014-09-09 20:46:28 +04:00
related=_resolve_model(field.rel.to),
to_many=True,
has_through_model=(
not field.rel.through._meta.auto_created
)
)
# Deal with reverse relationships.
reverse_relations = OrderedDict()
2014-09-09 20:46:28 +04:00
for relation in opts.get_all_related_objects():
accessor_name = relation.get_accessor_name()
reverse_relations[accessor_name] = RelationInfo(
2014-09-18 14:20:56 +04:00
model_field=None,
2014-09-09 20:46:28 +04:00
related=relation.model,
to_many=relation.field.rel.multiple,
has_through_model=False
)
# Deal with reverse many-to-many relationships.
for relation in opts.get_all_related_many_to_many_objects():
accessor_name = relation.get_accessor_name()
reverse_relations[accessor_name] = RelationInfo(
2014-09-18 14:20:56 +04:00
model_field=None,
2014-09-09 20:46:28 +04:00
related=relation.model,
to_many=True,
has_through_model=(
2014-10-08 19:09:37 +04:00
(getattr(relation.field.rel, 'through', None) is not None)
and not relation.field.rel.through._meta.auto_created
2014-09-09 20:46:28 +04:00
)
)
2014-09-18 14:20:56 +04:00
# Shortcut that merges both regular fields and the pk,
# for simplifying regular field lookup.
fields_and_pk = OrderedDict()
2014-09-18 14:20:56 +04:00
fields_and_pk['pk'] = pk
fields_and_pk[pk.name] = pk
fields_and_pk.update(fields)
# Shortcut that merges both forward and reverse relationships
relations = OrderedDict(
2014-09-18 14:20:56 +04:00
list(forward_relations.items()) +
list(reverse_relations.items())
)
return FieldInfo(pk, fields, forward_relations, reverse_relations, fields_and_pk, relations)