mirror of
https://github.com/encode/django-rest-framework.git
synced 2024-11-10 19:56:59 +03:00
489 lines
19 KiB
Python
489 lines
19 KiB
Python
from __future__ import unicode_literals
|
|
|
|
from django.test import TestCase
|
|
from django.utils import six
|
|
|
|
from rest_framework import serializers
|
|
from tests.models import (
|
|
ForeignKeySource, ForeignKeyTarget, ManyToManySource, ManyToManyTarget,
|
|
NullableForeignKeySource, NullableOneToOneSource,
|
|
NullableUUIDForeignKeySource, OneToOneTarget, UUIDForeignKeyTarget
|
|
)
|
|
|
|
|
|
# ManyToMany
|
|
class ManyToManyTargetSerializer(serializers.ModelSerializer):
|
|
class Meta:
|
|
model = ManyToManyTarget
|
|
fields = ('id', 'name', 'sources')
|
|
|
|
|
|
class ManyToManySourceSerializer(serializers.ModelSerializer):
|
|
class Meta:
|
|
model = ManyToManySource
|
|
fields = ('id', 'name', 'targets')
|
|
|
|
|
|
# ForeignKey
|
|
class ForeignKeyTargetSerializer(serializers.ModelSerializer):
|
|
class Meta:
|
|
model = ForeignKeyTarget
|
|
fields = ('id', 'name', 'sources')
|
|
|
|
|
|
class ForeignKeySourceSerializer(serializers.ModelSerializer):
|
|
class Meta:
|
|
model = ForeignKeySource
|
|
fields = ('id', 'name', 'target')
|
|
|
|
|
|
# Nullable ForeignKey
|
|
class NullableForeignKeySourceSerializer(serializers.ModelSerializer):
|
|
class Meta:
|
|
model = NullableForeignKeySource
|
|
fields = ('id', 'name', 'target')
|
|
|
|
|
|
# Nullable UUIDForeignKey
|
|
class NullableUUIDForeignKeySourceSerializer(serializers.ModelSerializer):
|
|
target = serializers.PrimaryKeyRelatedField(
|
|
pk_field=serializers.UUIDField(),
|
|
queryset=UUIDForeignKeyTarget.objects.all(),
|
|
allow_null=True)
|
|
|
|
class Meta:
|
|
model = NullableUUIDForeignKeySource
|
|
fields = ('id', 'name', 'target')
|
|
|
|
|
|
# Nullable OneToOne
|
|
class NullableOneToOneTargetSerializer(serializers.ModelSerializer):
|
|
class Meta:
|
|
model = OneToOneTarget
|
|
fields = ('id', 'name', 'nullable_source')
|
|
|
|
|
|
# TODO: Add test that .data cannot be accessed prior to .is_valid
|
|
|
|
class PKManyToManyTests(TestCase):
|
|
def setUp(self):
|
|
for idx in range(1, 4):
|
|
target = ManyToManyTarget(name='target-%d' % idx)
|
|
target.save()
|
|
source = ManyToManySource(name='source-%d' % idx)
|
|
source.save()
|
|
for target in ManyToManyTarget.objects.all():
|
|
source.targets.add(target)
|
|
|
|
def test_many_to_many_retrieve(self):
|
|
queryset = ManyToManySource.objects.all()
|
|
serializer = ManyToManySourceSerializer(queryset, many=True)
|
|
expected = [
|
|
{'id': 1, 'name': 'source-1', 'targets': [1]},
|
|
{'id': 2, 'name': 'source-2', 'targets': [1, 2]},
|
|
{'id': 3, 'name': 'source-3', 'targets': [1, 2, 3]}
|
|
]
|
|
with self.assertNumQueries(4):
|
|
assert serializer.data == expected
|
|
|
|
def test_many_to_many_retrieve_prefetch_related(self):
|
|
queryset = ManyToManySource.objects.all().prefetch_related('targets')
|
|
serializer = ManyToManySourceSerializer(queryset, many=True)
|
|
with self.assertNumQueries(2):
|
|
serializer.data
|
|
|
|
def test_reverse_many_to_many_retrieve(self):
|
|
queryset = ManyToManyTarget.objects.all()
|
|
serializer = ManyToManyTargetSerializer(queryset, many=True)
|
|
expected = [
|
|
{'id': 1, 'name': 'target-1', 'sources': [1, 2, 3]},
|
|
{'id': 2, 'name': 'target-2', 'sources': [2, 3]},
|
|
{'id': 3, 'name': 'target-3', 'sources': [3]}
|
|
]
|
|
with self.assertNumQueries(4):
|
|
assert serializer.data == expected
|
|
|
|
def test_many_to_many_update(self):
|
|
data = {'id': 1, 'name': 'source-1', 'targets': [1, 2, 3]}
|
|
instance = ManyToManySource.objects.get(pk=1)
|
|
serializer = ManyToManySourceSerializer(instance, data=data)
|
|
assert serializer.is_valid()
|
|
serializer.save()
|
|
assert serializer.data == data
|
|
|
|
# Ensure source 1 is updated, and everything else is as expected
|
|
queryset = ManyToManySource.objects.all()
|
|
serializer = ManyToManySourceSerializer(queryset, many=True)
|
|
expected = [
|
|
{'id': 1, 'name': 'source-1', 'targets': [1, 2, 3]},
|
|
{'id': 2, 'name': 'source-2', 'targets': [1, 2]},
|
|
{'id': 3, 'name': 'source-3', 'targets': [1, 2, 3]}
|
|
]
|
|
assert serializer.data == expected
|
|
|
|
def test_reverse_many_to_many_update(self):
|
|
data = {'id': 1, 'name': 'target-1', 'sources': [1]}
|
|
instance = ManyToManyTarget.objects.get(pk=1)
|
|
serializer = ManyToManyTargetSerializer(instance, data=data)
|
|
assert serializer.is_valid()
|
|
serializer.save()
|
|
assert serializer.data == data
|
|
|
|
# Ensure target 1 is updated, and everything else is as expected
|
|
queryset = ManyToManyTarget.objects.all()
|
|
serializer = ManyToManyTargetSerializer(queryset, many=True)
|
|
expected = [
|
|
{'id': 1, 'name': 'target-1', 'sources': [1]},
|
|
{'id': 2, 'name': 'target-2', 'sources': [2, 3]},
|
|
{'id': 3, 'name': 'target-3', 'sources': [3]}
|
|
]
|
|
assert serializer.data == expected
|
|
|
|
def test_many_to_many_create(self):
|
|
data = {'id': 4, 'name': 'source-4', 'targets': [1, 3]}
|
|
serializer = ManyToManySourceSerializer(data=data)
|
|
assert serializer.is_valid()
|
|
obj = serializer.save()
|
|
assert serializer.data == data
|
|
assert obj.name == 'source-4'
|
|
|
|
# Ensure source 4 is added, and everything else is as expected
|
|
queryset = ManyToManySource.objects.all()
|
|
serializer = ManyToManySourceSerializer(queryset, many=True)
|
|
expected = [
|
|
{'id': 1, 'name': 'source-1', 'targets': [1]},
|
|
{'id': 2, 'name': 'source-2', 'targets': [1, 2]},
|
|
{'id': 3, 'name': 'source-3', 'targets': [1, 2, 3]},
|
|
{'id': 4, 'name': 'source-4', 'targets': [1, 3]},
|
|
]
|
|
assert serializer.data == expected
|
|
|
|
def test_many_to_many_unsaved(self):
|
|
source = ManyToManySource(name='source-unsaved')
|
|
|
|
serializer = ManyToManySourceSerializer(source)
|
|
|
|
expected = {'id': None, 'name': 'source-unsaved', 'targets': []}
|
|
# no query if source hasn't been created yet
|
|
with self.assertNumQueries(0):
|
|
assert serializer.data == expected
|
|
|
|
def test_reverse_many_to_many_create(self):
|
|
data = {'id': 4, 'name': 'target-4', 'sources': [1, 3]}
|
|
serializer = ManyToManyTargetSerializer(data=data)
|
|
assert serializer.is_valid()
|
|
obj = serializer.save()
|
|
assert serializer.data == data
|
|
assert obj.name == 'target-4'
|
|
|
|
# Ensure target 4 is added, and everything else is as expected
|
|
queryset = ManyToManyTarget.objects.all()
|
|
serializer = ManyToManyTargetSerializer(queryset, many=True)
|
|
expected = [
|
|
{'id': 1, 'name': 'target-1', 'sources': [1, 2, 3]},
|
|
{'id': 2, 'name': 'target-2', 'sources': [2, 3]},
|
|
{'id': 3, 'name': 'target-3', 'sources': [3]},
|
|
{'id': 4, 'name': 'target-4', 'sources': [1, 3]}
|
|
]
|
|
assert serializer.data == expected
|
|
|
|
|
|
class PKForeignKeyTests(TestCase):
|
|
def setUp(self):
|
|
target = ForeignKeyTarget(name='target-1')
|
|
target.save()
|
|
new_target = ForeignKeyTarget(name='target-2')
|
|
new_target.save()
|
|
for idx in range(1, 4):
|
|
source = ForeignKeySource(name='source-%d' % idx, target=target)
|
|
source.save()
|
|
|
|
def test_foreign_key_retrieve(self):
|
|
queryset = ForeignKeySource.objects.all()
|
|
serializer = ForeignKeySourceSerializer(queryset, many=True)
|
|
expected = [
|
|
{'id': 1, 'name': 'source-1', 'target': 1},
|
|
{'id': 2, 'name': 'source-2', 'target': 1},
|
|
{'id': 3, 'name': 'source-3', 'target': 1}
|
|
]
|
|
with self.assertNumQueries(1):
|
|
assert serializer.data == expected
|
|
|
|
def test_reverse_foreign_key_retrieve(self):
|
|
queryset = ForeignKeyTarget.objects.all()
|
|
serializer = ForeignKeyTargetSerializer(queryset, many=True)
|
|
expected = [
|
|
{'id': 1, 'name': 'target-1', 'sources': [1, 2, 3]},
|
|
{'id': 2, 'name': 'target-2', 'sources': []},
|
|
]
|
|
with self.assertNumQueries(3):
|
|
assert serializer.data == expected
|
|
|
|
def test_reverse_foreign_key_retrieve_prefetch_related(self):
|
|
queryset = ForeignKeyTarget.objects.all().prefetch_related('sources')
|
|
serializer = ForeignKeyTargetSerializer(queryset, many=True)
|
|
with self.assertNumQueries(2):
|
|
serializer.data
|
|
|
|
def test_foreign_key_update(self):
|
|
data = {'id': 1, 'name': 'source-1', 'target': 2}
|
|
instance = ForeignKeySource.objects.get(pk=1)
|
|
serializer = ForeignKeySourceSerializer(instance, data=data)
|
|
assert serializer.is_valid()
|
|
serializer.save()
|
|
assert serializer.data == data
|
|
|
|
# Ensure source 1 is updated, and everything else is as expected
|
|
queryset = ForeignKeySource.objects.all()
|
|
serializer = ForeignKeySourceSerializer(queryset, many=True)
|
|
expected = [
|
|
{'id': 1, 'name': 'source-1', 'target': 2},
|
|
{'id': 2, 'name': 'source-2', 'target': 1},
|
|
{'id': 3, 'name': 'source-3', 'target': 1}
|
|
]
|
|
assert serializer.data == expected
|
|
|
|
def test_foreign_key_update_incorrect_type(self):
|
|
data = {'id': 1, 'name': 'source-1', 'target': 'foo'}
|
|
instance = ForeignKeySource.objects.get(pk=1)
|
|
serializer = ForeignKeySourceSerializer(instance, data=data)
|
|
assert not serializer.is_valid()
|
|
assert serializer.errors == {'target': ['Incorrect type. Expected pk value, received %s.' % six.text_type.__name__]}
|
|
|
|
def test_reverse_foreign_key_update(self):
|
|
data = {'id': 2, 'name': 'target-2', 'sources': [1, 3]}
|
|
instance = ForeignKeyTarget.objects.get(pk=2)
|
|
serializer = ForeignKeyTargetSerializer(instance, data=data)
|
|
assert serializer.is_valid()
|
|
# We shouldn't have saved anything to the db yet since save
|
|
# hasn't been called.
|
|
queryset = ForeignKeyTarget.objects.all()
|
|
new_serializer = ForeignKeyTargetSerializer(queryset, many=True)
|
|
expected = [
|
|
{'id': 1, 'name': 'target-1', 'sources': [1, 2, 3]},
|
|
{'id': 2, 'name': 'target-2', 'sources': []},
|
|
]
|
|
assert new_serializer.data == expected
|
|
|
|
serializer.save()
|
|
assert serializer.data == data
|
|
|
|
# Ensure target 2 is update, and everything else is as expected
|
|
queryset = ForeignKeyTarget.objects.all()
|
|
serializer = ForeignKeyTargetSerializer(queryset, many=True)
|
|
expected = [
|
|
{'id': 1, 'name': 'target-1', 'sources': [2]},
|
|
{'id': 2, 'name': 'target-2', 'sources': [1, 3]},
|
|
]
|
|
assert serializer.data == expected
|
|
|
|
def test_foreign_key_create(self):
|
|
data = {'id': 4, 'name': 'source-4', 'target': 2}
|
|
serializer = ForeignKeySourceSerializer(data=data)
|
|
assert serializer.is_valid()
|
|
obj = serializer.save()
|
|
assert serializer.data == data
|
|
assert obj.name == 'source-4'
|
|
|
|
# Ensure source 4 is added, and everything else is as expected
|
|
queryset = ForeignKeySource.objects.all()
|
|
serializer = ForeignKeySourceSerializer(queryset, many=True)
|
|
expected = [
|
|
{'id': 1, 'name': 'source-1', 'target': 1},
|
|
{'id': 2, 'name': 'source-2', 'target': 1},
|
|
{'id': 3, 'name': 'source-3', 'target': 1},
|
|
{'id': 4, 'name': 'source-4', 'target': 2},
|
|
]
|
|
assert serializer.data == expected
|
|
|
|
def test_reverse_foreign_key_create(self):
|
|
data = {'id': 3, 'name': 'target-3', 'sources': [1, 3]}
|
|
serializer = ForeignKeyTargetSerializer(data=data)
|
|
assert serializer.is_valid()
|
|
obj = serializer.save()
|
|
assert serializer.data == data
|
|
assert obj.name == 'target-3'
|
|
|
|
# Ensure target 3 is added, and everything else is as expected
|
|
queryset = ForeignKeyTarget.objects.all()
|
|
serializer = ForeignKeyTargetSerializer(queryset, many=True)
|
|
expected = [
|
|
{'id': 1, 'name': 'target-1', 'sources': [2]},
|
|
{'id': 2, 'name': 'target-2', 'sources': []},
|
|
{'id': 3, 'name': 'target-3', 'sources': [1, 3]},
|
|
]
|
|
assert serializer.data == expected
|
|
|
|
def test_foreign_key_update_with_invalid_null(self):
|
|
data = {'id': 1, 'name': 'source-1', 'target': None}
|
|
instance = ForeignKeySource.objects.get(pk=1)
|
|
serializer = ForeignKeySourceSerializer(instance, data=data)
|
|
assert not serializer.is_valid()
|
|
assert serializer.errors == {'target': ['This field may not be null.']}
|
|
|
|
def test_foreign_key_with_unsaved(self):
|
|
source = ForeignKeySource(name='source-unsaved')
|
|
expected = {'id': None, 'name': 'source-unsaved', 'target': None}
|
|
|
|
serializer = ForeignKeySourceSerializer(source)
|
|
|
|
# no query if source hasn't been created yet
|
|
with self.assertNumQueries(0):
|
|
assert serializer.data == expected
|
|
|
|
def test_foreign_key_with_empty(self):
|
|
"""
|
|
Regression test for #1072
|
|
|
|
https://github.com/encode/django-rest-framework/issues/1072
|
|
"""
|
|
serializer = NullableForeignKeySourceSerializer()
|
|
assert serializer.data['target'] is None
|
|
|
|
def test_foreign_key_not_required(self):
|
|
"""
|
|
Let's say we wanted to fill the non-nullable model field inside
|
|
Model.save(), we would make it empty and not required.
|
|
"""
|
|
class ModelSerializer(ForeignKeySourceSerializer):
|
|
class Meta(ForeignKeySourceSerializer.Meta):
|
|
extra_kwargs = {'target': {'required': False}}
|
|
serializer = ModelSerializer(data={'name': 'test'})
|
|
serializer.is_valid(raise_exception=True)
|
|
assert 'target' not in serializer.validated_data
|
|
|
|
|
|
class PKNullableForeignKeyTests(TestCase):
|
|
def setUp(self):
|
|
target = ForeignKeyTarget(name='target-1')
|
|
target.save()
|
|
for idx in range(1, 4):
|
|
if idx == 3:
|
|
target = None
|
|
source = NullableForeignKeySource(name='source-%d' % idx, target=target)
|
|
source.save()
|
|
|
|
def test_foreign_key_retrieve_with_null(self):
|
|
queryset = NullableForeignKeySource.objects.all()
|
|
serializer = NullableForeignKeySourceSerializer(queryset, many=True)
|
|
expected = [
|
|
{'id': 1, 'name': 'source-1', 'target': 1},
|
|
{'id': 2, 'name': 'source-2', 'target': 1},
|
|
{'id': 3, 'name': 'source-3', 'target': None},
|
|
]
|
|
assert serializer.data == expected
|
|
|
|
def test_foreign_key_create_with_valid_null(self):
|
|
data = {'id': 4, 'name': 'source-4', 'target': None}
|
|
serializer = NullableForeignKeySourceSerializer(data=data)
|
|
assert serializer.is_valid()
|
|
obj = serializer.save()
|
|
assert serializer.data == data
|
|
assert obj.name == 'source-4'
|
|
|
|
# Ensure source 4 is created, and everything else is as expected
|
|
queryset = NullableForeignKeySource.objects.all()
|
|
serializer = NullableForeignKeySourceSerializer(queryset, many=True)
|
|
expected = [
|
|
{'id': 1, 'name': 'source-1', 'target': 1},
|
|
{'id': 2, 'name': 'source-2', 'target': 1},
|
|
{'id': 3, 'name': 'source-3', 'target': None},
|
|
{'id': 4, 'name': 'source-4', 'target': None}
|
|
]
|
|
assert serializer.data == expected
|
|
|
|
def test_foreign_key_create_with_valid_emptystring(self):
|
|
"""
|
|
The emptystring should be interpreted as null in the context
|
|
of relationships.
|
|
"""
|
|
data = {'id': 4, 'name': 'source-4', 'target': ''}
|
|
expected_data = {'id': 4, 'name': 'source-4', 'target': None}
|
|
serializer = NullableForeignKeySourceSerializer(data=data)
|
|
assert serializer.is_valid()
|
|
obj = serializer.save()
|
|
assert serializer.data == expected_data
|
|
assert obj.name == 'source-4'
|
|
|
|
# Ensure source 4 is created, and everything else is as expected
|
|
queryset = NullableForeignKeySource.objects.all()
|
|
serializer = NullableForeignKeySourceSerializer(queryset, many=True)
|
|
expected = [
|
|
{'id': 1, 'name': 'source-1', 'target': 1},
|
|
{'id': 2, 'name': 'source-2', 'target': 1},
|
|
{'id': 3, 'name': 'source-3', 'target': None},
|
|
{'id': 4, 'name': 'source-4', 'target': None}
|
|
]
|
|
assert serializer.data == expected
|
|
|
|
def test_foreign_key_update_with_valid_null(self):
|
|
data = {'id': 1, 'name': 'source-1', 'target': None}
|
|
instance = NullableForeignKeySource.objects.get(pk=1)
|
|
serializer = NullableForeignKeySourceSerializer(instance, data=data)
|
|
assert serializer.is_valid()
|
|
serializer.save()
|
|
assert serializer.data == data
|
|
|
|
# Ensure source 1 is updated, and everything else is as expected
|
|
queryset = NullableForeignKeySource.objects.all()
|
|
serializer = NullableForeignKeySourceSerializer(queryset, many=True)
|
|
expected = [
|
|
{'id': 1, 'name': 'source-1', 'target': None},
|
|
{'id': 2, 'name': 'source-2', 'target': 1},
|
|
{'id': 3, 'name': 'source-3', 'target': None}
|
|
]
|
|
assert serializer.data == expected
|
|
|
|
def test_foreign_key_update_with_valid_emptystring(self):
|
|
"""
|
|
The emptystring should be interpreted as null in the context
|
|
of relationships.
|
|
"""
|
|
data = {'id': 1, 'name': 'source-1', 'target': ''}
|
|
expected_data = {'id': 1, 'name': 'source-1', 'target': None}
|
|
instance = NullableForeignKeySource.objects.get(pk=1)
|
|
serializer = NullableForeignKeySourceSerializer(instance, data=data)
|
|
assert serializer.is_valid()
|
|
serializer.save()
|
|
assert serializer.data == expected_data
|
|
|
|
# Ensure source 1 is updated, and everything else is as expected
|
|
queryset = NullableForeignKeySource.objects.all()
|
|
serializer = NullableForeignKeySourceSerializer(queryset, many=True)
|
|
expected = [
|
|
{'id': 1, 'name': 'source-1', 'target': None},
|
|
{'id': 2, 'name': 'source-2', 'target': 1},
|
|
{'id': 3, 'name': 'source-3', 'target': None}
|
|
]
|
|
assert serializer.data == expected
|
|
|
|
def test_null_uuid_foreign_key_serializes_as_none(self):
|
|
source = NullableUUIDForeignKeySource(name='Source')
|
|
serializer = NullableUUIDForeignKeySourceSerializer(source)
|
|
data = serializer.data
|
|
assert data["target"] is None
|
|
|
|
def test_nullable_uuid_foreign_key_is_valid_when_none(self):
|
|
data = {"name": "Source", "target": None}
|
|
serializer = NullableUUIDForeignKeySourceSerializer(data=data)
|
|
assert serializer.is_valid(), serializer.errors
|
|
|
|
|
|
class PKNullableOneToOneTests(TestCase):
|
|
def setUp(self):
|
|
target = OneToOneTarget(name='target-1')
|
|
target.save()
|
|
new_target = OneToOneTarget(name='target-2')
|
|
new_target.save()
|
|
source = NullableOneToOneSource(name='source-1', target=new_target)
|
|
source.save()
|
|
|
|
def test_reverse_foreign_key_retrieve_with_null(self):
|
|
queryset = OneToOneTarget.objects.all()
|
|
serializer = NullableOneToOneTargetSerializer(queryset, many=True)
|
|
expected = [
|
|
{'id': 1, 'name': 'target-1', 'nullable_source': None},
|
|
{'id': 2, 'name': 'target-2', 'nullable_source': 1},
|
|
]
|
|
assert serializer.data == expected
|