django-rest-framework/rest_framework/tests/generics.py

352 lines
12 KiB
Python
Raw Normal View History

2012-12-18 01:59:51 +04:00
from django.db import models
2012-09-28 17:28:50 +04:00
from django.test import TestCase
2012-09-28 18:54:00 +04:00
from django.utils import simplejson as json
2012-10-08 15:52:56 +04:00
from rest_framework import generics, serializers, status
from rest_framework.tests.utils import RequestFactory
from rest_framework.tests.models import BasicModel, Comment, SlugBasedModel
2012-09-28 17:28:50 +04:00
factory = RequestFactory()
2012-09-28 17:28:50 +04:00
2012-10-03 12:26:15 +04:00
class RootView(generics.ListCreateAPIView):
2012-09-28 19:41:35 +04:00
"""
Example description for OPTIONS.
"""
2012-09-28 17:28:50 +04:00
model = BasicModel
class InstanceView(generics.RetrieveUpdateDestroyAPIView):
2012-09-28 19:41:35 +04:00
"""
Example description for OPTIONS.
"""
2012-09-28 18:54:00 +04:00
model = BasicModel
2012-10-29 21:20:06 +04:00
class SlugSerializer(serializers.ModelSerializer):
slug = serializers.Field() # read only
class Meta:
model = SlugBasedModel
exclude = ('id',)
class SlugBasedInstanceView(InstanceView):
"""
A model with a slug-field.
"""
model = SlugBasedModel
2012-10-29 21:20:06 +04:00
serializer_class = SlugSerializer
2012-09-28 18:54:00 +04:00
class TestRootView(TestCase):
2012-09-28 17:28:50 +04:00
def setUp(self):
2012-09-28 18:54:00 +04:00
"""
Create 3 BasicModel intances.
"""
2012-09-28 17:28:50 +04:00
items = ['foo', 'bar', 'baz']
for item in items:
BasicModel(text=item).save()
self.objects = BasicModel.objects
self.data = [
{'id': obj.id, 'text': obj.text}
for obj in self.objects.all()
]
2012-09-28 19:23:46 +04:00
self.view = RootView.as_view()
2012-09-28 17:28:50 +04:00
def test_get_root_view(self):
2012-09-28 18:54:00 +04:00
"""
2012-10-03 12:26:15 +04:00
GET requests to ListCreateAPIView should return list of objects.
2012-09-28 18:54:00 +04:00
"""
2012-09-28 17:28:50 +04:00
request = factory.get('/')
2012-09-28 19:23:46 +04:00
response = self.view(request).render()
2012-09-28 17:28:50 +04:00
self.assertEquals(response.status_code, status.HTTP_200_OK)
self.assertEquals(response.data, self.data)
2012-09-28 18:54:00 +04:00
def test_post_root_view(self):
"""
2012-10-03 12:26:15 +04:00
POST requests to ListCreateAPIView should create a new object.
2012-09-28 18:54:00 +04:00
"""
content = {'text': 'foobar'}
request = factory.post('/', json.dumps(content),
content_type='application/json')
2012-09-28 19:23:46 +04:00
response = self.view(request).render()
2012-09-28 18:54:00 +04:00
self.assertEquals(response.status_code, status.HTTP_201_CREATED)
self.assertEquals(response.data, {'id': 4, 'text': u'foobar'})
created = self.objects.get(id=4)
self.assertEquals(created.text, 'foobar')
2012-09-28 19:23:46 +04:00
def test_put_root_view(self):
"""
2012-10-03 12:26:15 +04:00
PUT requests to ListCreateAPIView should not be allowed
2012-09-28 19:23:46 +04:00
"""
content = {'text': 'foobar'}
request = factory.put('/', json.dumps(content),
content_type='application/json')
2012-09-28 19:23:46 +04:00
response = self.view(request).render()
self.assertEquals(response.status_code, status.HTTP_405_METHOD_NOT_ALLOWED)
2012-09-28 19:41:35 +04:00
self.assertEquals(response.data, {"detail": "Method 'PUT' not allowed."})
2012-09-28 19:23:46 +04:00
def test_delete_root_view(self):
"""
2012-10-03 12:26:15 +04:00
DELETE requests to ListCreateAPIView should not be allowed
2012-09-28 19:23:46 +04:00
"""
request = factory.delete('/')
response = self.view(request).render()
self.assertEquals(response.status_code, status.HTTP_405_METHOD_NOT_ALLOWED)
2012-09-28 19:41:35 +04:00
self.assertEquals(response.data, {"detail": "Method 'DELETE' not allowed."})
def test_options_root_view(self):
"""
2012-10-03 12:26:15 +04:00
OPTIONS requests to ListCreateAPIView should return metadata
2012-09-28 19:41:35 +04:00
"""
request = factory.options('/')
response = self.view(request).render()
expected = {
'parses': [
'application/json',
'application/x-www-form-urlencoded',
'multipart/form-data'
],
'renders': [
'application/json',
'text/html'
],
'name': 'Root',
'description': 'Example description for OPTIONS.'
}
self.assertEquals(response.status_code, status.HTTP_200_OK)
self.assertEquals(response.data, expected)
2012-09-28 19:23:46 +04:00
def test_post_cannot_set_id(self):
"""
POST requests to create a new object should not be able to set the id.
"""
content = {'id': 999, 'text': 'foobar'}
request = factory.post('/', json.dumps(content),
content_type='application/json')
response = self.view(request).render()
self.assertEquals(response.status_code, status.HTTP_201_CREATED)
self.assertEquals(response.data, {'id': 4, 'text': u'foobar'})
created = self.objects.get(id=4)
self.assertEquals(created.text, 'foobar')
2012-09-28 18:54:00 +04:00
class TestInstanceView(TestCase):
def setUp(self):
"""
Create 3 BasicModel intances.
"""
items = ['foo', 'bar', 'baz']
for item in items:
BasicModel(text=item).save()
self.objects = BasicModel.objects
self.data = [
{'id': obj.id, 'text': obj.text}
for obj in self.objects.all()
]
2012-09-28 19:23:46 +04:00
self.view = InstanceView.as_view()
self.slug_based_view = SlugBasedInstanceView.as_view()
2012-09-28 18:54:00 +04:00
def test_get_instance_view(self):
"""
2012-10-03 12:26:15 +04:00
GET requests to RetrieveUpdateDestroyAPIView should return a single object.
2012-09-28 18:54:00 +04:00
"""
request = factory.get('/1')
2012-09-28 19:23:46 +04:00
response = self.view(request, pk=1).render()
2012-09-28 18:54:00 +04:00
self.assertEquals(response.status_code, status.HTTP_200_OK)
self.assertEquals(response.data, self.data[0])
2012-09-28 19:23:46 +04:00
def test_post_instance_view(self):
"""
2012-10-03 12:26:15 +04:00
POST requests to RetrieveUpdateDestroyAPIView should not be allowed
2012-09-28 19:23:46 +04:00
"""
content = {'text': 'foobar'}
request = factory.post('/', json.dumps(content),
content_type='application/json')
2012-09-28 19:23:46 +04:00
response = self.view(request).render()
self.assertEquals(response.status_code, status.HTTP_405_METHOD_NOT_ALLOWED)
2012-09-28 19:41:35 +04:00
self.assertEquals(response.data, {"detail": "Method 'POST' not allowed."})
2012-09-28 19:23:46 +04:00
2012-09-28 18:54:00 +04:00
def test_put_instance_view(self):
"""
2012-10-03 12:26:15 +04:00
PUT requests to RetrieveUpdateDestroyAPIView should update an object.
2012-09-28 18:54:00 +04:00
"""
content = {'text': 'foobar'}
request = factory.put('/1', json.dumps(content),
content_type='application/json')
response = self.view(request, pk='1').render()
2012-09-28 18:54:00 +04:00
self.assertEquals(response.status_code, status.HTTP_200_OK)
self.assertEquals(response.data, {'id': 1, 'text': 'foobar'})
updated = self.objects.get(id=1)
self.assertEquals(updated.text, 'foobar')
def test_patch_instance_view(self):
"""
PATCH requests to RetrieveUpdateDestroyAPIView should update an object.
"""
content = {'text': 'foobar'}
request = factory.patch('/1', json.dumps(content),
content_type='application/json')
response = self.view(request, pk=1).render()
self.assertEquals(response.status_code, status.HTTP_200_OK)
self.assertEquals(response.data, {'id': 1, 'text': 'foobar'})
updated = self.objects.get(id=1)
self.assertEquals(updated.text, 'foobar')
2012-09-28 18:54:00 +04:00
def test_delete_instance_view(self):
"""
2012-10-03 12:26:15 +04:00
DELETE requests to RetrieveUpdateDestroyAPIView should delete an object.
2012-09-28 18:54:00 +04:00
"""
request = factory.delete('/1')
2012-09-28 19:23:46 +04:00
response = self.view(request, pk=1).render()
2012-09-28 18:54:00 +04:00
self.assertEquals(response.status_code, status.HTTP_204_NO_CONTENT)
self.assertEquals(response.content, '')
ids = [obj.id for obj in self.objects.all()]
self.assertEquals(ids, [2, 3])
2012-09-28 19:41:35 +04:00
def test_options_instance_view(self):
"""
2012-10-03 12:26:15 +04:00
OPTIONS requests to RetrieveUpdateDestroyAPIView should return metadata
2012-09-28 19:41:35 +04:00
"""
request = factory.options('/')
response = self.view(request).render()
expected = {
'parses': [
'application/json',
'application/x-www-form-urlencoded',
'multipart/form-data'
],
'renders': [
'application/json',
'text/html'
],
'name': 'Instance',
'description': 'Example description for OPTIONS.'
}
self.assertEquals(response.status_code, status.HTTP_200_OK)
self.assertEquals(response.data, expected)
def test_put_cannot_set_id(self):
"""
PUT requests to create a new object should not be able to set the id.
"""
content = {'id': 999, 'text': 'foobar'}
request = factory.put('/1', json.dumps(content),
content_type='application/json')
response = self.view(request, pk=1).render()
self.assertEquals(response.status_code, status.HTTP_200_OK)
self.assertEquals(response.data, {'id': 1, 'text': 'foobar'})
updated = self.objects.get(id=1)
self.assertEquals(updated.text, 'foobar')
2012-10-05 19:24:52 +04:00
def test_put_to_deleted_instance(self):
"""
PUT requests to RetrieveUpdateDestroyAPIView should create an object
if it does not currently exist.
"""
self.objects.get(id=1).delete()
content = {'text': 'foobar'}
request = factory.put('/1', json.dumps(content),
content_type='application/json')
response = self.view(request, pk=1).render()
self.assertEquals(response.status_code, status.HTTP_201_CREATED)
2012-10-05 19:24:52 +04:00
self.assertEquals(response.data, {'id': 1, 'text': 'foobar'})
updated = self.objects.get(id=1)
self.assertEquals(updated.text, 'foobar')
def test_put_as_create_on_id_based_url(self):
"""
PUT requests to RetrieveUpdateDestroyAPIView should create an object
at the requested url if it doesn't exist.
"""
content = {'text': 'foobar'}
# pk fields can not be created on demand, only the database can set th pk for a new object
request = factory.put('/5', json.dumps(content),
content_type='application/json')
response = self.view(request, pk=5).render()
self.assertEquals(response.status_code, status.HTTP_201_CREATED)
2012-10-28 23:56:48 +04:00
new_obj = self.objects.get(pk=5)
self.assertEquals(new_obj.text, 'foobar')
def test_put_as_create_on_slug_based_url(self):
"""
PUT requests to RetrieveUpdateDestroyAPIView should create an object
at the requested url if possible, else return HTTP_403_FORBIDDEN error-response.
"""
content = {'text': 'foobar'}
request = factory.put('/test_slug', json.dumps(content),
content_type='application/json')
2012-10-29 21:20:06 +04:00
response = self.slug_based_view(request, slug='test_slug').render()
self.assertEquals(response.status_code, status.HTTP_201_CREATED)
self.assertEquals(response.data, {'slug': 'test_slug', 'text': 'foobar'})
2012-10-29 21:20:06 +04:00
new_obj = SlugBasedModel.objects.get(slug='test_slug')
self.assertEquals(new_obj.text, 'foobar')
2012-10-08 15:52:56 +04:00
# Regression test for #285
class CommentSerializer(serializers.ModelSerializer):
class Meta:
model = Comment
exclude = ('created',)
class CommentView(generics.ListCreateAPIView):
serializer_class = CommentSerializer
model = Comment
class TestCreateModelWithAutoNowAddField(TestCase):
def setUp(self):
self.objects = Comment.objects
self.view = CommentView.as_view()
def test_create_model_with_auto_now_add_field(self):
"""
Regression test for #285
https://github.com/tomchristie/django-rest-framework/issues/285
"""
content = {'email': 'foobar@example.com', 'content': 'foobar'}
request = factory.post('/', json.dumps(content),
content_type='application/json')
response = self.view(request).render()
self.assertEquals(response.status_code, status.HTTP_201_CREATED)
created = self.objects.get(id=1)
self.assertEquals(created.content, 'foobar')
2012-12-18 01:59:51 +04:00
# Test for particularly ugly reression with m2m in browseable API
class ClassB(models.Model):
name = models.CharField(max_length=255)
class ClassA(models.Model):
name = models.CharField(max_length=255)
childs = models.ManyToManyField(ClassB, blank=True, null=True)
class ClassASerializer(serializers.ModelSerializer):
childs = serializers.ManyPrimaryKeyRelatedField(source='childs')
class Meta:
model = ClassA
class ExampleView(generics.ListCreateAPIView):
serializer_class = ClassASerializer
model = ClassA
class TestM2MBrowseableAPI(TestCase):
def test_m2m_in_browseable_api(self):
"""
Test for particularly ugly reression with m2m in browseable API
"""
request = factory.get('/', HTTP_ACCEPT='text/html')
view = ExampleView().as_view()
response = view(request).render()
self.assertEquals(response.status_code, status.HTTP_200_OK)