mirror of
https://github.com/encode/django-rest-framework.git
synced 2024-11-23 01:57:00 +03:00
454 lines
28 KiB
HTML
454 lines
28 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
<meta charset="utf-8">
|
|
<title>Django REST framework - Testing</title>
|
|
<link href="http://django-rest-framework.org/img/favicon.ico" rel="icon" type="image/x-icon">
|
|
<link rel="canonical" href="http://django-rest-framework.org/api-guide/testing"/>
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<meta name="description" content="Django, API, REST, Testing, APIRequestFactory, APIClient, Test cases, Testing responses, Configuration">
|
|
<meta name="author" content="Tom Christie">
|
|
|
|
<!-- Le styles -->
|
|
<link href="http://django-rest-framework.org/css/prettify.css" rel="stylesheet">
|
|
<link href="http://django-rest-framework.org/css/bootstrap.css" rel="stylesheet">
|
|
<link href="http://django-rest-framework.org/css/bootstrap-responsive.css" rel="stylesheet">
|
|
<link href="http://django-rest-framework.org/css/default.css" rel="stylesheet">
|
|
|
|
<!-- Le HTML5 shim, for IE6-8 support of HTML5 elements -->
|
|
<!--[if lt IE 9]>
|
|
<script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
|
|
<![endif]-->
|
|
|
|
<script type="text/javascript">
|
|
|
|
var _gaq = _gaq || [];
|
|
_gaq.push(['_setAccount', 'UA-18852272-2']);
|
|
_gaq.push(['_trackPageview']);
|
|
|
|
(function() {
|
|
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
|
|
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
|
|
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
|
|
})();
|
|
|
|
</script>
|
|
</head>
|
|
<body onload="prettyPrint()" class="testing-page">
|
|
|
|
<div class="wrapper">
|
|
|
|
<div class="navbar navbar-inverse navbar-fixed-top">
|
|
<div class="navbar-inner">
|
|
<div class="container-fluid">
|
|
<a class="repo-link btn btn-primary btn-small" href="https://github.com/tomchristie/django-rest-framework/tree/master">GitHub</a>
|
|
<a class="repo-link btn btn-inverse btn-small " href="../api-guide/settings">Next <i class="icon-arrow-right icon-white"></i></a>
|
|
<a class="repo-link btn btn-inverse btn-small " href="../api-guide/status-codes"><i class="icon-arrow-left icon-white"></i> Previous</a>
|
|
<a class="repo-link btn btn-inverse btn-small" href="#searchModal" data-toggle="modal"><i class="icon-search icon-white"></i> Search</a>
|
|
<a class="btn btn-navbar" data-toggle="collapse" data-target=".nav-collapse">
|
|
<span class="icon-bar"></span>
|
|
<span class="icon-bar"></span>
|
|
<span class="icon-bar"></span>
|
|
</a>
|
|
<a class="brand" href="http://django-rest-framework.org">Django REST framework</a>
|
|
<div class="nav-collapse collapse">
|
|
<ul class="nav">
|
|
<li><a href="http://django-rest-framework.org">Home</a></li>
|
|
<li class="dropdown">
|
|
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorial <b class="caret"></b></a>
|
|
<ul class="dropdown-menu">
|
|
<li><a href="http://django-rest-framework.org/tutorial/quickstart">Quickstart</a></li>
|
|
<li><a href="http://django-rest-framework.org/tutorial/1-serialization">1 - Serialization</a></li>
|
|
<li><a href="http://django-rest-framework.org/tutorial/2-requests-and-responses">2 - Requests and responses</a></li>
|
|
<li><a href="http://django-rest-framework.org/tutorial/3-class-based-views">3 - Class based views</a></li>
|
|
<li><a href="http://django-rest-framework.org/tutorial/4-authentication-and-permissions">4 - Authentication and permissions</a></li>
|
|
<li><a href="http://django-rest-framework.org/tutorial/5-relationships-and-hyperlinked-apis">5 - Relationships and hyperlinked APIs</a></li>
|
|
<li><a href="http://django-rest-framework.org/tutorial/6-viewsets-and-routers">6 - Viewsets and routers</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="dropdown">
|
|
<a href="#" class="dropdown-toggle" data-toggle="dropdown">API Guide <b class="caret"></b></a>
|
|
<ul class="dropdown-menu">
|
|
<li><a href="http://django-rest-framework.org/api-guide/requests">Requests</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/responses">Responses</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/views">Views</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/generic-views">Generic views</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/viewsets">Viewsets</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/routers">Routers</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/parsers">Parsers</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/renderers">Renderers</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/serializers">Serializers</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/fields">Serializer fields</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/relations">Serializer relations</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/authentication">Authentication</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/permissions">Permissions</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/throttling">Throttling</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/filtering">Filtering</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/pagination">Pagination</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/content-negotiation">Content negotiation</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/format-suffixes">Format suffixes</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/reverse">Returning URLs</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/exceptions">Exceptions</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/status-codes">Status codes</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/testing">Testing</a></li>
|
|
<li><a href="http://django-rest-framework.org/api-guide/settings">Settings</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="dropdown">
|
|
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Topics <b class="caret"></b></a>
|
|
<ul class="dropdown-menu">
|
|
<li><a href="http://django-rest-framework.org/topics/documenting-your-api">Documenting your API</a></li>
|
|
<li><a href="http://django-rest-framework.org/topics/ajax-csrf-cors">AJAX, CSRF & CORS</a></li>
|
|
<li><a href="http://django-rest-framework.org/topics/browser-enhancements">Browser enhancements</a></li>
|
|
<li><a href="http://django-rest-framework.org/topics/browsable-api">The Browsable API</a></li>
|
|
<li><a href="http://django-rest-framework.org/topics/rest-hypermedia-hateoas">REST, Hypermedia & HATEOAS</a></li>
|
|
<li><a href="http://django-rest-framework.org/topics/contributing">Contributing to REST framework</a></li>
|
|
<li><a href="http://django-rest-framework.org/topics/rest-framework-2-announcement">2.0 Announcement</a></li>
|
|
<li><a href="http://django-rest-framework.org/topics/2.2-announcement">2.2 Announcement</a></li>
|
|
<li><a href="http://django-rest-framework.org/topics/2.3-announcement">2.3 Announcement</a></li>
|
|
<li><a href="http://django-rest-framework.org/topics/release-notes">Release Notes</a></li>
|
|
<li><a href="http://django-rest-framework.org/topics/credits">Credits</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<ul class="nav pull-right">
|
|
<!-- TODO
|
|
<li class="dropdown">
|
|
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Version: 2.0.0 <b class="caret"></b></a>
|
|
<ul class="dropdown-menu">
|
|
<li><a href="#">Trunk</a></li>
|
|
<li><a href="#">2.0.0</a></li>
|
|
</ul>
|
|
</li>
|
|
-->
|
|
</ul>
|
|
</div><!--/.nav-collapse -->
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="body-content">
|
|
<div class="container-fluid">
|
|
|
|
<!-- Search Modal -->
|
|
<div id="searchModal" class="modal hide fade" tabindex="-1" role="dialog" aria-labelledby="myModalLabel" aria-hidden="true">
|
|
<div class="modal-header">
|
|
<button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button>
|
|
<h3 id="myModalLabel">Documentation search</h3>
|
|
</div>
|
|
<div class="modal-body">
|
|
<!-- Custom google search -->
|
|
<script>
|
|
(function() {
|
|
var cx = '015016005043623903336:rxraeohqk6w';
|
|
var gcse = document.createElement('script');
|
|
gcse.type = 'text/javascript';
|
|
gcse.async = true;
|
|
gcse.src = (document.location.protocol == 'https:' ? 'https:' : 'http:') +
|
|
'//www.google.com/cse/cse.js?cx=' + cx;
|
|
var s = document.getElementsByTagName('script')[0];
|
|
s.parentNode.insertBefore(gcse, s);
|
|
})();
|
|
</script>
|
|
<gcse:search></gcse:search>
|
|
</div>
|
|
<div class="modal-footer">
|
|
<button class="btn" data-dismiss="modal" aria-hidden="true">Close</button>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="row-fluid">
|
|
|
|
<div class="span3">
|
|
<!-- TODO
|
|
<p style="margin-top: -12px">
|
|
<a class="btn btn-mini btn-primary" style="width: 60px">« previous</a>
|
|
<a class="btn btn-mini btn-primary" style="float: right; margin-right: 8px; width: 60px;">next »</a>
|
|
</p>
|
|
-->
|
|
<div id="table-of-contents">
|
|
<ul class="nav nav-list side-nav well sidebar-nav-fixed">
|
|
<li class="main"><a href="#testing">Testing</a></li>
|
|
<li class="main"><a href="#apirequestfactory">APIRequestFactory</a></li>
|
|
<li><a href="#creating-test-requests">Creating test requests</a></li>
|
|
<li><a href="#forcing-authentication">Forcing authentication</a></li>
|
|
<li><a href="#forcing-csrf-validation">Forcing CSRF validation</a></li>
|
|
<li class="main"><a href="#apiclient">APIClient</a></li>
|
|
<li><a href="#making-requests">Making requests</a></li>
|
|
<li><a href="#authenticating">Authenticating</a></li>
|
|
<li><a href="#csrf-validation">CSRF validation</a></li>
|
|
<li class="main"><a href="#test-cases">Test cases</a></li>
|
|
<li><a href="#example">Example</a></li>
|
|
<li class="main"><a href="#testing-responses">Testing responses</a></li>
|
|
<li><a href="#checking-the-response-data">Checking the response data</a></li>
|
|
<li><a href="#rendering-responses">Rendering responses</a></li>
|
|
<li class="main"><a href="#configuration">Configuration</a></li>
|
|
<li><a href="#setting-the-default-format">Setting the default format</a></li>
|
|
<li><a href="#setting-the-available-formats">Setting the available formats</a></li>
|
|
|
|
<div>
|
|
<hr>
|
|
|
|
<p><strong>The team behind REST framework is launching a new API service.</strong></p>
|
|
|
|
<p>If you want to be first in line when we start issuing invitations, please sign up here:</p>
|
|
|
|
<!-- Begin MailChimp Signup Form -->
|
|
<link href="//cdn-images.mailchimp.com/embedcode/slim-081711.css" rel="stylesheet" type="text/css">
|
|
<style type="text/css">
|
|
#mc_embed_signup{background:#fff; clear:left; font:14px Helvetica,Arial,sans-serif; }
|
|
/* Add your own MailChimp form style overrides in your site stylesheet or in this style block.
|
|
We recommend moving this block and the preceding CSS link to the HEAD of your HTML file. */
|
|
</style>
|
|
<div id="mc_embed_signup" style="background: rgb(245, 245, 245)">
|
|
<form action="http://dabapps.us1.list-manage1.com/subscribe/post?u=cf73a9994eb5b8d8d461b5dfb&id=cb6af8e8bd" method="post" id="mc-embedded-subscribe-form" name="mc-embedded-subscribe-form" class="validate" target="_blank" novalidate>
|
|
<!-- <label for="mce-EMAIL">Keep me posted!</label>
|
|
--> <input style="width: 90%" type="email" value="" name="EMAIL" class="email" id="mce-EMAIL" placeholder="email address" required>
|
|
<div class="clear"><input class="btn btn-success" type="submit" value="Yes, keep me posted!" name="subscribe" id="mc-embedded-subscribe" class="button"></div>
|
|
</form>
|
|
</div>
|
|
</style></div>
|
|
</ul>
|
|
|
|
|
|
<!--End mc_embed_signup-->
|
|
</div>
|
|
</div>
|
|
|
|
<div id="main-content" class="span9">
|
|
<p><a class="github" href="https://github.com/tomchristie/django-rest-framework/tree/master/rest_framework/test.py"><span class="label label-info">test.py</span></a></p>
|
|
<h1 id="testing">Testing</h1>
|
|
<blockquote>
|
|
<p>Code without tests is broken as designed.</p>
|
|
<p>— <a href="http://jacobian.org/writing/django-apps-with-buildout/#s-create-a-test-wrapper">Jacob Kaplan-Moss</a></p>
|
|
</blockquote>
|
|
<p>REST framework includes a few helper classes that extend Django's existing test framework, and improve support for making API requests.</p>
|
|
<h1 id="apirequestfactory">APIRequestFactory</h1>
|
|
<p>Extends <a href="https://docs.djangoproject.com/en/dev/topics/testing/advanced/#django.test.client.RequestFactory">Django's existing <code>RequestFactory</code> class</a>.</p>
|
|
<h2 id="creating-test-requests">Creating test requests</h2>
|
|
<p>The <code>APIRequestFactory</code> class supports an almost identical API to Django's standard <code>RequestFactory</code> class. This means the that standard <code>.get()</code>, <code>.post()</code>, <code>.put()</code>, <code>.patch()</code>, <code>.delete()</code>, <code>.head()</code> and <code>.options()</code> methods are all available.</p>
|
|
<pre class="prettyprint lang-py"><code>from rest_framework.test import APIRequestFactory
|
|
|
|
# Using the standard RequestFactory API to create a form POST request
|
|
factory = APIRequestFactory()
|
|
request = factory.post('/notes/', {'title': 'new idea'})
|
|
</code></pre>
|
|
<h4 id="using-the-format-argument">Using the <code>format</code> argument</h4>
|
|
<p>Methods which create a request body, such as <code>post</code>, <code>put</code> and <code>patch</code>, include a <code>format</code> argument, which make it easy to generate requests using a content type other than multipart form data. For example:</p>
|
|
<pre class="prettyprint lang-py"><code># Create a JSON POST request
|
|
factory = APIRequestFactory()
|
|
request = factory.post('/notes/', {'title': 'new idea'}, format='json')
|
|
</code></pre>
|
|
<p>By default the available formats are <code>'multipart'</code> and <code>'json'</code>. For compatibility with Django's existing <code>RequestFactory</code> the default format is <code>'multipart'</code>.</p>
|
|
<p>To support a wider set of request formats, or change the default format, <a href="#configuration">see the configuration section</a>.</p>
|
|
<h4 id="explicitly-encoding-the-request-body">Explicitly encoding the request body</h4>
|
|
<p>If you need to explicitly encode the request body, you can do so by setting the <code>content_type</code> flag. For example:</p>
|
|
<pre class="prettyprint lang-py"><code>request = factory.post('/notes/', json.dumps({'title': 'new idea'}), content_type='application/json')
|
|
</code></pre>
|
|
<h4 id="put-and-patch-with-form-data">PUT and PATCH with form data</h4>
|
|
<p>One difference worth noting between Django's <code>RequestFactory</code> and REST framework's <code>APIRequestFactory</code> is that multipart form data will be encoded for methods other than just <code>.post()</code>.</p>
|
|
<p>For example, using <code>APIRequestFactory</code>, you can make a form PUT request like so:</p>
|
|
<pre class="prettyprint lang-py"><code>factory = APIRequestFactory()
|
|
request = factory.put('/notes/547/', {'title': 'remember to email dave'})
|
|
</code></pre>
|
|
<p>Using Django's <code>RequestFactory</code>, you'd need to explicitly encode the data yourself:</p>
|
|
<pre class="prettyprint lang-py"><code>from django.test.client import encode_multipart, RequestFactory
|
|
|
|
factory = RequestFactory()
|
|
data = {'title': 'remember to email dave'}
|
|
content = encode_multipart('BoUnDaRyStRiNg', data)
|
|
content_type = 'multipart/form-data; boundary=BoUnDaRyStRiNg'
|
|
request = factory.put('/notes/547/', content, content_type=content_type)
|
|
</code></pre>
|
|
<h2 id="forcing-authentication">Forcing authentication</h2>
|
|
<p>When testing views directly using a request factory, it's often convenient to be able to directly authenticate the request, rather than having to construct the correct authentication credentials.</p>
|
|
<p>To forcibly authenticate a request, use the <code>force_authenticate()</code> method.</p>
|
|
<pre class="prettyprint lang-py"><code>factory = APIRequestFactory()
|
|
user = User.objects.get(username='olivia')
|
|
view = AccountDetail.as_view()
|
|
|
|
# Make an authenticated request to the view...
|
|
request = factory.get('/accounts/django-superstars/')
|
|
force_authenticate(request, user=user)
|
|
response = view(request)
|
|
</code></pre>
|
|
<p>The signature for the method is <code>force_authenticate(request, user=None, token=None)</code>. When making the call, either or both of the user and token may be set.</p>
|
|
<p>For example, when forcibly authenticating using a token, you might do something like the following:</p>
|
|
<pre class="prettyprint lang-py"><code>user = User.objects.get(username='olivia')
|
|
request = factory.get('/accounts/django-superstars/')
|
|
force_authenticate(request, user=user, token=user.token)
|
|
</code></pre>
|
|
<hr />
|
|
<p><strong>Note</strong>: When using <code>APIRequestFactory</code>, the object that is returned is Django's standard <code>HttpRequest</code>, and not REST framework's <code>Request</code> object, which is only generated once the view is called.</p>
|
|
<p>This means that setting attributes directly on the request object may not always have the effect you expect. For example, setting <code>.token</code> directly will have no effect, and setting <code>.user</code> directly will only work if session authentication is being used.</p>
|
|
<pre class="prettyprint lang-py"><code># Request will only authenticate if `SessionAuthentication` is in use.
|
|
request = factory.get('/accounts/django-superstars/')
|
|
request.user = user
|
|
response = view(request)
|
|
</code></pre>
|
|
<hr />
|
|
<h2 id="forcing-csrf-validation">Forcing CSRF validation</h2>
|
|
<p>By default, requests created with <code>APIRequestFactory</code> will not have CSRF validation applied when passed to a REST framework view. If you need to explicitly turn CSRF validation on, you can do so by setting the <code>enforce_csrf_checks</code> flag when instantiating the factory.</p>
|
|
<pre class="prettyprint lang-py"><code>factory = APIRequestFactory(enforce_csrf_checks=True)
|
|
</code></pre>
|
|
<hr />
|
|
<p><strong>Note</strong>: It's worth noting that Django's standard <code>RequestFactory</code> doesn't need to include this option, because when using regular Django the CSRF validation takes place in middleware, which is not run when testing views directly. When using REST framework, CSRF validation takes place inside the view, so the request factory needs to disable view-level CSRF checks.</p>
|
|
<hr />
|
|
<h1 id="apiclient">APIClient</h1>
|
|
<p>Extends <a href="https://docs.djangoproject.com/en/dev/topics/testing/overview/#module-django.test.client">Django's existing <code>Client</code> class</a>.</p>
|
|
<h2 id="making-requests">Making requests</h2>
|
|
<p>The <code>APIClient</code> class supports the same request interface as <code>APIRequestFactory</code>. This means the that standard <code>.get()</code>, <code>.post()</code>, <code>.put()</code>, <code>.patch()</code>, <code>.delete()</code>, <code>.head()</code> and <code>.options()</code> methods are all available. For example:</p>
|
|
<pre class="prettyprint lang-py"><code>from rest_framework.test import APIClient
|
|
|
|
client = APIClient()
|
|
client.post('/notes/', {'title': 'new idea'}, format='json')
|
|
</code></pre>
|
|
<p>To support a wider set of request formats, or change the default format, <a href="#configuration">see the configuration section</a>.</p>
|
|
<h2 id="authenticating">Authenticating</h2>
|
|
<h4 id="loginkwargs">.login(**kwargs)</h4>
|
|
<p>The <code>login</code> method functions exactly as it does with Django's regular <code>Client</code> class. This allows you to authenticate requests against any views which include <code>SessionAuthentication</code>.</p>
|
|
<pre class="prettyprint lang-py"><code># Make all requests in the context of a logged in session.
|
|
client = APIClient()
|
|
client.login(username='lauren', password='secret')
|
|
</code></pre>
|
|
<p>To logout, call the <code>logout</code> method as usual.</p>
|
|
<pre class="prettyprint lang-py"><code># Log out
|
|
client.logout()
|
|
</code></pre>
|
|
<p>The <code>login</code> method is appropriate for testing APIs that use session authentication, for example web sites which include AJAX interaction with the API.</p>
|
|
<h4 id="credentialskwargs">.credentials(**kwargs)</h4>
|
|
<p>The <code>credentials</code> method can be used to set headers that will then be included on all subsequent requests by the test client.</p>
|
|
<pre class="prettyprint lang-py"><code>from rest_framework.authtoken.models import Token
|
|
from rest_framework.test import APIClient
|
|
|
|
# Include an appropriate `Authorization:` header on all requests.
|
|
token = Token.objects.get(user__username='lauren')
|
|
client = APIClient()
|
|
client.credentials(HTTP_AUTHORIZATION='Token ' + token.key)
|
|
</code></pre>
|
|
<p>Note that calling <code>credentials</code> a second time overwrites any existing credentials. You can unset any existing credentials by calling the method with no arguments.</p>
|
|
<pre class="prettyprint lang-py"><code># Stop including any credentials
|
|
client.credentials()
|
|
</code></pre>
|
|
<p>The <code>credentials</code> method is appropriate for testing APIs that require authentication headers, such as basic authentication, OAuth1a and OAuth2 authentication, and simple token authentication schemes.</p>
|
|
<h4 id="force_authenticateusernone-tokennone">.force_authenticate(user=None, token=None)</h4>
|
|
<p>Sometimes you may want to bypass authentication, and simple force all requests by the test client to be automatically treated as authenticated.</p>
|
|
<p>This can be a useful shortcut if you're testing the API but don't want to have to construct valid authentication credentials in order to make test requests.</p>
|
|
<pre class="prettyprint lang-py"><code>user = User.objects.get(username='lauren')
|
|
client = APIClient()
|
|
client.force_authenticate(user=user)
|
|
</code></pre>
|
|
<p>To unauthenticate subsequent requests, call <code>force_authenticate</code> setting the user and/or token to <code>None</code>.</p>
|
|
<pre class="prettyprint lang-py"><code>client.force_authenticate(user=None)
|
|
</code></pre>
|
|
<h2 id="csrf-validation">CSRF validation</h2>
|
|
<p>By default CSRF validation is not applied when using <code>APIClient</code>. If you need to explicitly enable CSRF validation, you can do so by setting the <code>enforce_csrf_checks</code> flag when instantiating the client.</p>
|
|
<pre class="prettyprint lang-py"><code>client = APIClient(enforce_csrf_checks=True)
|
|
</code></pre>
|
|
<p>As usual CSRF validation will only apply to any session authenticated views. This means CSRF validation will only occur if the client has been logged in by calling <code>login()</code>.</p>
|
|
<hr />
|
|
<h1 id="test-cases">Test cases</h1>
|
|
<p>REST framework includes the following test case classes, that mirror the existing Django test case classes, but use <code>APIClient</code> instead of Django's default <code>Client</code>.</p>
|
|
<ul>
|
|
<li><code>APISimpleTestCase</code></li>
|
|
<li><code>APITransactionTestCase</code></li>
|
|
<li><code>APITestCase</code></li>
|
|
<li><code>APILiveServerTestCase</code></li>
|
|
</ul>
|
|
<h2 id="example">Example</h2>
|
|
<p>You can use any of REST framework's test case classes as you would for the regular Django test case classes. The <code>self.client</code> attribute will be an <code>APIClient</code> instance.</p>
|
|
<pre class="prettyprint lang-py"><code>from django.core.urlresolvers import reverse
|
|
from rest_framework import status
|
|
from rest_framework.test import APITestCase
|
|
|
|
class AccountTests(APITestCase):
|
|
def test_create_account(self):
|
|
"""
|
|
Ensure we can create a new account object.
|
|
"""
|
|
url = reverse('account-list')
|
|
data = {'name': 'DabApps'}
|
|
response = self.client.post(url, data, format='json')
|
|
self.assertEqual(response.status_code, status.HTTP_201_CREATED)
|
|
self.assertEqual(response.data, data)
|
|
</code></pre>
|
|
<hr />
|
|
<h1 id="testing-responses">Testing responses</h1>
|
|
<h2 id="checking-the-response-data">Checking the response data</h2>
|
|
<p>When checking the validity of test responses it's often more convenient to inspect the data that the response was created with, rather than inspecting the fully rendered response.</p>
|
|
<p>For example, it's easier to inspect <code>request.data</code>:</p>
|
|
<pre class="prettyprint lang-py"><code>response = self.client.get('/users/4/')
|
|
self.assertEqual(response.data, {'id': 4, 'username': 'lauren'})
|
|
</code></pre>
|
|
<p>Instead of inspecting the result of parsing <code>request.content</code>:</p>
|
|
<pre class="prettyprint lang-py"><code>response = self.client.get('/users/4/')
|
|
self.assertEqual(json.loads(response.content), {'id': 4, 'username': 'lauren'})
|
|
</code></pre>
|
|
<h2 id="rendering-responses">Rendering responses</h2>
|
|
<p>If you're testing views directly using <code>APIRequestFactory</code>, the responses that are returned will not yet be rendered, as rendering of template responses is performed by Django's internal request-response cycle. In order to access <code>response.content</code>, you'll first need to render the response.</p>
|
|
<pre class="prettyprint lang-py"><code>view = UserDetail.as_view()
|
|
request = factory.get('/users/4')
|
|
response = view(request, pk='4')
|
|
response.render() # Cannot access `response.content` without this.
|
|
self.assertEqual(response.content, '{"username": "lauren", "id": 4}')
|
|
</code></pre>
|
|
<hr />
|
|
<h1 id="configuration">Configuration</h1>
|
|
<h2 id="setting-the-default-format">Setting the default format</h2>
|
|
<p>The default format used to make test requests may be set using the <code>TEST_REQUEST_DEFAULT_FORMAT</code> setting key. For example, to always use JSON for test requests by default instead of standard multipart form requests, set the following in your <code>settings.py</code> file:</p>
|
|
<pre class="prettyprint lang-py"><code>REST_FRAMEWORK = {
|
|
...
|
|
'TEST_REQUEST_DEFAULT_FORMAT': 'json'
|
|
}
|
|
</code></pre>
|
|
<h2 id="setting-the-available-formats">Setting the available formats</h2>
|
|
<p>If you need to test requests using something other than multipart or json requests, you can do so by setting the <code>TEST_REQUEST_RENDERER_CLASSES</code> setting.</p>
|
|
<p>For example, to add support for using <code>format='yaml'</code> in test requests, you might have something like this in your <code>settings.py</code> file.</p>
|
|
<pre class="prettyprint lang-py"><code>REST_FRAMEWORK = {
|
|
...
|
|
'TEST_REQUEST_RENDERER_CLASSES': (
|
|
'rest_framework.renderers.MultiPartRenderer',
|
|
'rest_framework.renderers.JSONRenderer',
|
|
'rest_framework.renderers.YAMLRenderer'
|
|
)
|
|
}
|
|
</code></pre>
|
|
</div><!--/span-->
|
|
</div><!--/row-->
|
|
</div><!--/.fluid-container-->
|
|
</div><!--/.body content-->
|
|
|
|
<div id="push"></div>
|
|
</div><!--/.wrapper -->
|
|
|
|
<footer class="span12">
|
|
<p>Sponsored by <a href="http://dabapps.com/">DabApps</a>.</a></p>
|
|
</footer>
|
|
|
|
<!-- Le javascript
|
|
================================================== -->
|
|
<!-- Placed at the end of the document so the pages load faster -->
|
|
<script src="http://django-rest-framework.org/js/jquery-1.8.1-min.js"></script>
|
|
<script src="http://django-rest-framework.org/js/prettify-1.0.js"></script>
|
|
<script src="http://django-rest-framework.org/js/bootstrap-2.1.1-min.js"></script>
|
|
<script>
|
|
//$('.side-nav').scrollspy()
|
|
var shiftWindow = function() { scrollBy(0, -50) };
|
|
if (location.hash) shiftWindow();
|
|
window.addEventListener("hashchange", shiftWindow);
|
|
|
|
$('.dropdown-menu').on('click touchstart', function(event) {
|
|
event.stopPropagation();
|
|
});
|
|
|
|
// Dynamically force sidenav to no higher than browser window
|
|
$('.side-nav').css('max-height', window.innerHeight - 130);
|
|
|
|
$(function(){
|
|
$(window).resize(function(){
|
|
$('.side-nav').css('max-height', window.innerHeight - 130);
|
|
});
|
|
});
|
|
</script>
|
|
</body></html>
|