测试工具¶

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

测试客户端¶

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

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

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

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

使用Django的测试客户端来确定正在渲染正确的模板，并且传递正确的上下文数据。
使用浏览器中的框架（如 Selenium）测试 rendered HTML和网页的 behavior，即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
b'<!DOCTYPE html...'

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

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

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

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

如果由于某种原因，您 want 测试客户端执行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)[源代码]¶

在提供的 path 上发出GET请求，并返回一个 Response 对象，这在下面记录。

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

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

...将导致对等于的GET请求的求值:

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

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

>>> 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参数，则可以使用该编码，而不使用数据参数。例如，先前的GET请求也可以被建议为:

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

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

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

如果您有一个网址 /redirect_me/ 重定向到 /next/，重定向到 /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

如果您提供 content_type （例如用于XML有效载荷的 text/xml），data 的内容将在POST请求中使用 content_type 在HTTP Content-Type 头中原样发送。

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

要为给定的键提交多个值 - 例如，为 <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）作为文件句柄。

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

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

extra 参数的行为与 Client.get() 相同。

如果使用POST请求的URL包含已编码的参数，则这些参数将在request.GET数据中可用。例如，如果您要提出请求:

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

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

如果将 follow 设置为 True，则客户端将跟随任何重定向，并且将在包含中间URL和状态代码的元组的响应对象中设置 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。