测试工具¶

Django提供了一组小工具，在写测试时派上用场。

测试客户端¶

测试客户端是一个Python类，作为一个虚拟的Web浏览器，允许您测试您的视图，并与您的Django供电的应用程序以编程方式交互。

你可以用测试客户端做的一些事情是：

模拟对URL的GET和POST请求，并观察响应 - 从低级HTTP（结果头和状态代码）到页面内容的一切。
查看重定向链（如果有），并在每个步骤中检查网址和状态代码。
测试给定的请求是否由给定的Django模板呈现，其中模板上下文包含某些值。

请注意，测试客户端不是要替代Selenium或其他“浏览器内”框架。Django的测试客户端有不同的焦点。简而言之：

使用Django的测试客户端来确定正在渲染正确的模板，并且传递正确的上下文数据。
使用Selenium等浏览器框架测试网页的呈现的 HTML和行为，即JavaScript功能。Django还为这些框架提供特殊支持；有关详细信息，请参阅LiveServerTestCase一节。

一个全面的测试套件应该使用两种测试类型的组合。

概述和一个快速示例¶

要使用测试客户端，请实例化django.test.Client并检索网页：

>>> from django.test import Client
>>> c = Client()
>>> response = c.post('/login/', {'username': 'john', 'password': 'smith'})
>>> response.status_code
200
>>> response = c.get('/customer/details/')
>>> response.content
'<!DOCTYPE html...'

正如此示例所建议的，您可以在Python交互式解释器的会话中实例化Client。

请注意测试客户端如何工作的几个重要的事情：

测试客户端不要求Web服务器正在运行。事实上，它将运行很好，没有Web服务器运行在所有！这是因为它避免了HTTP的开销，直接处理Django框架。这有助于使单元测试快速运行。
检索网页时，请记住指定网址的路径，而不是整个网域。例如，这是正确的：
```
>>> c.get('/login/')
```
这是不正确的：
```
>>> c.get('http://www.example.com/login/')
```
测试客户端无法检索不受您的Django项目驱动的网页。如果需要检索其他网页，请使用Python标准库模块，例如urllib。
要解析网址，测试客户端将使用您的ROOT_URLCONF设置指向的任何URLconf。
虽然上面的例子可以在Python交互式解释器中工作，但是测试客户端的一些功能，特别是与模板相关的功能，只有在测试运行时才可用。

这样做的原因是，Django的测试运行器执行一些黑魔法，以确定哪个模板由给定的视图加载。这个黑魔法（本质上是Django的模板系统在内存中的修补）只发生在测试运行期间。
默认情况下，测试客户端将禁用由您的站点执行的任何CSRF检查。

如果由于某种原因，您希望测试客户端执行CSRF检查，您可以创建实施CSRF检查的测试客户端的实例。为此，在构建客户端时传递enforce_csrf_checks参数：
```
>>> from django.test import Client
>>> csrf_client = Client(enforce_csrf_checks=True)
```

提出请求¶

使用django.test.Client类发出请求。

class Client(enforce_csrf_checks=False, **defaults)¶

它在建设时不需要论证。但是，您可以使用关键字参数指定一些默认标头。例如，这会在每个请求中发送User-Agent HTTP标头：

>>> c = Client(HTTP_USER_AGENT='Mozilla/5.0')

传递给get()，post()等的extra关键字参数的值优先于传递给类构造函数的默认值。

enforce_csrf_checks参数可用于测试CSRF保护（参见上文）。

一旦您有一个Client实例，您就可以调用以下任何方法：

get(path, data=None, follow=False, secure=False, **extra)¶

New in Django 1.7:

已添加secure参数。

在提供的path上发出GET请求，并返回Response对象，下面将对此进行说明。

data字典中的键值对用于创建GET数据有效内容。例如：

>>> c = Client()
>>> c.get('/customers/details/', {'name': 'fred', 'age': 7})

...将导致GET请求的求值等效于：

/customers/details/?name=fred&age=7

extra关键字arguments参数可用于指定要在请求中发送的标头。例如：

>>> c = Client()
>>> c.get('/customers/details/', {'name': 'fred', 'age': 7},
...       HTTP_X_REQUESTED_WITH='XMLHttpRequest')

...将HTTP标头HTTP_X_REQUESTED_WITH发送到详细信息视图，这是一个测试使用django.http.HttpRequest.is_ajax()方法的代码路径的好方法。

CGI规范

通过**extra发送的标头应遵循CGI规范。例如，模拟从浏览器到服务器的HTTP请求中发送的不同“主机”标头应作为HTTP_HOST传递。

如果您已经有以URL编码形式的GET参数，则可以使用该编码，而不是使用data参数。例如，先前的GET请求也可以被提出为：

>>> c = Client()
>>> c.get('/customers/details/?name=fred&age=7')

如果您提供的网址包含编码的GET数据和数据参数，则数据参数优先。

如果您将follow设置为True，则客户端将跟踪任何重定向，并且将在包含中间网址元组的响应对象中设置redirect_chain属性和状态代码。

如果您有重定向到/next/的网址/redirect_me/，则重定向到/final/，这是您会看到的：

>>> response = c.get('/redirect_me/', follow=True)
>>> response.redirect_chain
[('http://testserver/next/', 302), ('http://testserver/final/', 302)]

如果您将secure设置为True，则客户端将模拟HTTPS请求。

post(path, data=None, content_type=MULTIPART_CONTENT, follow=False, secure=False, **extra)¶

在提供的path上发出POST请求，并返回Response对象，这在下面进行了说明。

data字典中的键值对用于提交POST数据。例如：

>>> c = Client()
>>> c.post('/login/', {'name': 'fred', 'passwd': 'secret'})

...将导致对此URL的POST请求的评估：

/login/

...用这个POST数据：

name=fred&passwd=secret

如果您为XML有效内容提供content_type（例如text / xml），则data的内容将作为POST请求，使用HTTP Content-Type标头中的content_type。

如果不为content_type提供值，则data中的值将以内容类型multipart / form-data传输。在这种情况下，data中的键值对将被编码为一个多部分消息，并用于创建POST数据有效负载。

要为给定键提交多个值 - 例如，为＆lt； select multiple>指定选择，列表或元组。例如，data的此值将为名为choices的字段提交三个选定值：

{'choices': ('a', 'b', 'd')}

提交文件是一种特殊情况。要发布文件，您只需要提供文件字段名作为键，以及要作为值上传的文件的文件句柄。例如：

>>> c = Client()
>>> with open('wishlist.doc') as fp:
...     c.post('/customers/wishes/', {'name': 'fred', 'attachment': fp})

（名称attachment这里不相关；使用您的文件处理代码所期望的任何名称。）

您还可以提供任何类似文件的对象（例如，StringIO或BytesIO）作为文件句柄。

New in Django 1.8:

添加了使用类文件对象的能力。

请注意，如果您希望对多个post()调用使用相同的文件句柄，则需要在文章之间手动重置文件指针。最简单的方法是在文件提供给post()之后手动关闭文件，如上所示。

您还应确保以允许读取数据的方式打开文件。如果您的文件包含二进制数据，如图像，这意味着您需要以rb（读取二进制）模式打开该文件。

extra参数的作用与Client.get()相同。

如果您通过POST请求的URL包含已编码的参数，则这些参数将在请求中可用。GET数据。例如，如果您提出请求：

>>> c.post('/login/?visitor=true', {'name': 'fred', 'passwd': 'secret'})

...处理此请求的视图可以询问请求。POST以检索用户名和密码，并且可以询问请求。GET以确定用户是否是访问者。

如果您将follow设置为True，则客户端将跟踪任何重定向，并且将在包含中间网址元组的响应对象中设置redirect_chain属性和状态代码。

如果您将secure设置为True，则客户端将模拟HTTPS请求。

head(path, data=None, follow=False, secure=False, **extra)¶: 在提供的path上执行HEAD请求，并返回Response对象。此方法的工作方式与Client.get()一样，除了它之外，包括follow，secure和extra

options(path, data='', content_type='application/octet-stream', follow=False, secure=False, **extra)¶

在提供的path上执行OPTIONS请求，并返回Response对象。用于测试RESTful接口。

当提供data时，它用作请求主体，并且Content-Type头设置为content_type。