Django单元测试工具test client使用详解
The test client
test client是一个python类,来模拟一个简单的“哑”浏览器,允许你来测试你的view函数.你可以使用test client完成下列事情：
1.模拟"Get"和"Post"请求,观察响应结果--从HTTP(headers,status codes)到页面内容.
2.检查重定向链(如果有的话)，在每一步检查URL和status code。
3.用一个包括特定值的模板context来测试一个request被Django模板渲染。
>>> from django.test.client 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...'
使用django.test.client.Client的实例来使用test client。
注意：请求网页时，使用path而不是整个domain。
>>> c.get('/login/')
是正确的。
>>> c.get('http://www.example.com/login/')
是错误的。
test client不适合操作不是由Django建立的网站.所以，请求其它网页时，请使用python的标准库--urllib或者urllib2.
为了解析URl,test client使用由ROOT_URLCONF(settings.py)指定的URLconf。
默认情况下，test client会忽略CSRF检查，如果要强制进行CSRF检查，可以
csrf_client = Client(enforce_csrf_checks=True)
Making Requests
使用django.test.client.Client()来执行请求。
class Client(enforce_csrf_checks=False, **defaults)
可以使用关键字参数来指定默认的请求报头：
c = Client(HTTP_USER_AGENT='Mozilla/5.0')
记得在USER_AGENT前加HTTP_。
Client实例具有以下方法：
get(path, data={}, follow=False, **extra)
执行一个GET请求并返回Response对象。
>>> c = Client()
>>> c.get('/customers/details/', {'name': 'fred', 'age': 7})
相当于向以下url执行GET：
/customers/details/?name=fred&age=7
extra关键字参数可用作请求报头：
>>> c = Client()
>>> c.get('/customers/details/', {'name': 'fred', 'age': 7},
... HTTP_X_REQUESTED_WITH='XMLHttpRequest')
当然也可以将查询字符对编码后加入url：
>>> c = Client()
>>> c.get('/customers/details/?name=fred&age=7')
data参数的优先级在编码后的url之上。
如果将follow设置为True，client会追踪任何重定向，返回的response有redirect_chain属性，包括所有重定向过程中的url和状态码组成的元祖列表。
如果有个URL /redirect_me/ 重定向向 /next/, 再重定向向 /final/：
>>> response = c.get('/redirect_me/', follow=True)
>>> response.redirect_chain
[(u'http://testserver/next/', 302), (u'http://testserver/final/', 302)]
post(path, data={}, content_type=MULTIPART_CONTENT, follow=False, **extra)
执行一个POST请求并返回response对象，data参数为POST数据。
如果提供content_type参数(例如 text/xml),数据会被作为报头中Content-Type的类型进行POST上传。
如果不提供content_type参数，数据会被作为multipart/form-data类型上传。
为一个参数提交多个多个值时--比如选住<select multiple>域的多个值--这些值可以是列表或者元组.举例来说,提交choice域的三个被选中的值:
{'choices': ('a', 'b', 'd')}
上传文件：
>>> c = Client()
>>> with open('wishlist.doc') as fp:
... c.post('/customers/wishes/', {'name': 'fred', 'attachment': fp})
文件的名字'attachment'是不相关的，取决于你处理文件的代码。
如果同一个文件要post多次，注意每次post都要恢复文件的指针，最简单的方法就是将文件关闭再重新打开。
注意文件要以正确的方式被打开以便于读取，如果文件是binary data，例如读取img时，要将打开模式设为rb。
post的路径中也可以包含查询字符对：
>>> c.post('/login/?visitor=true', {'name': 'fred', 'passwd': 'secret'})
这样既会通过post上传data数据，也向GET确定visitor=True。
options(path, data='', content_type='application/octet-stream', follow=False, **extra)
做OPTIONS请求，对测试REST接口很有用。data被用作请求的主体。
put(path, data='', content_type='application/octet-stream', follow=False, **extra)
做PUT请求，测试RESTful接口。
patch(path, data='', content_type='application/octet-stream', follow=False, **extra)
做PATCH请求，测试RESTful接口。
delete(path, data='', content_type='application/octet-stream', follow=False, **extra)
做DELETE请求，测试RESTful接口。
login(**credentials)
如果使用django的用户验证系统，可用login方法进行测试。
>>> c = Client() >>> c.login(username='fred', password='secret')
登陆成功的话，返回True。
使用之前，当然要创建一个用户。由于测试数据库使用的是单独的数据库，原先数据库中的用户是不能用于测试的。
设置密码时，不能用user的密码属性进行设置，而是用set_password()方法设置正确的哈希密码，或者使用create_user()方法创建一个带哈希密码的用户。
logout()
登出。
Testing Responses
client的get和post方法都返回response对象，和HttpResponse对象是不同的。
class Response具有以下属性：
client：the test client
content：response的主体,string类型,是view render后的页面的最终内容，或者是错误信息。
context：用来渲染模板的context实例。如果页面使用了多个模板,那context就会是Context Object列表.它们的排序方式就是它们被渲染的顺序。
>>> response = client.get('/foo/')
>>> response.context['name']
'Arthur'
request：用于请求的数据。
status_code:状态码。
templates：被用来渲染最终的content的Template实例列表.template.name可以得到template的文件名,如果template是由文件载入的话(如 'admin/index.html')。那template就会是Template列表,它们的排序方式就是它们被渲染的顺序.
response也可以当做字典来查询Http header：
response['Content-Type']
Exceptions
如果你将TestClient指向了由view函数raise的异常,那这个异常在test case里是可见的.你可以使用标准的try...except块或者assertRaises()来测试它们.对test client唯一不可见的异常是Http404,PermissionDenied和SystemExit。django会在内部捕捉这些异常并返回合适的response.这种情况下,你可以查看下你的response.status_code.
Persistent state
如果一个response返回了一个cookie,那么这个cookie就会被存储在test client里,并被其后的所有get()和post()传送.如果你想要终止这个cookie,你可以新建一个Client实例,或者手动删除它。
一个test client具有两个存储持久化状态信息的属性：
Client.cookies
一个python SimpleCookie对象，存储cilent的所有cookie。
Client.sessions
包含session信息的类字典对象。
如果要修改一个session并且存储，首先将session存储在变量中：
def test_something(self): session = self.client.session session['somekey'] = 'test' session.save()
一个使用client进行测试的实例：
from django.utils import unittest
from django.test.client import Client
class SimpleTest(unittest.TestCase):
def setUp(self):
# Every test needs a client.
self.client = Client()
def test_details(self):
# Issue a GET request.
response = self.client.get('/customer/details/')
# Check that the response is 200 OK.
self.assertEqual(response.status_code, 200)
# Check that the rendered context contains 5 customers.
self.assertEqual(len(response.context['customers']), 5)
Test cases的一些功能
默认的test client
每个django.test.*TestCase的test case实例都会访问django test client，所以Client可以不用实例化，而直接用self.client访问：
from django.test import TestCase
class SimpleTest(TestCase):
def test_details(self):
response = self.client.get('/customer/details/')
self.assertEqual(response.status_code, 200)
def test_index(self):
response = self.client.get('/customer/index/')
self.assertEqual(response.status_code, 200)
Fixture loading
如果数据库里没有数据,那么对于一个基于数据库的网站来说,test case并无多大的用处.为了给测试数据库加入测试数据更方便,django提供了载入fixtures的方法.
fixture是一系列的数据集合,django知道如何将它导入数据库。
创建fixture最直接的方法就是使用manage.py dumpdata.当然,这假设你的实际数据库里已经有数据了.
注意:
如果你运行过manage.py syncdb命令,那么你已经使用过fixture了--只是你不知道而已。当你使用syncdb去创建数据库时,会创建一个叫initial_data的fixture。
其他名字的Fixture可以通过manage.py loaddata命令手动安装.
一旦建立了一个fixture,并将它放在了某个django app的fixtures目录中,你就可以在你的测试类里使用它了：
from django.test import TestCase
from myapp.models import Animal
class AnimalTestCase(TestCase):
fixtures = ['mammals.json', 'birds']
def setUp(self):
# Test definitions as before.
call_setup_methods()
def testFluffyAnimals(self):
# A test that uses the fixtures.
call_some_test_code()
这是具体发生的过程:
1. 在setup()运行前,django会清空数据库,相当于你执行了syncdb。
2.然后,所有的fixture会被安装.在例子中,django会安装任何一个名字为mammals的JSON格式的fixture和名为birds的fixture数据。
Assertions
除了python中的assertEqual()和assertTrue()外，django的TestCase还提供了几个额外的assert方法。
assertContains(response, text, count=None, status_code=200, msg_prefix='', html=False)
断言response是否与status_code和text内容相应。将html设为True会将text作为html处理。
assertJSONEqual(raw, expected_data, msg=None)
断言Json片段raw和expected_data是否相当。
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持我们。
相关推荐
-
对Python的Django框架中的项目进行单元测试的方法
Python中的单元测试 我们先来回顾一下Python中的单元测试方法. 下面是一个 Python的单元测试简单的例子: 假如我们开发一个除法的功能,有的同学可能觉得很简单,代码是这样的: def division_funtion(x, y): return x / y 但是这样写究竟对还是不对呢,有些同学可以在代码下面这样测试: def division_funtion(x, y): return x / y if __name__ == '__main__': print division
-
详尽讲述用Python的Django框架测试驱动开发的教程
测试驱动开发(TDD)是一个迭代的开发周期,强调编写实际代码之前编写自动化测试. 这个过程很简单: 先编写测试. 查看测试失败的地方 编写足够的代码以使测试通过. 再次测试. 代码重构 . 重复以上操作. 为什么要用TDD? 使用TDD,你将学会把你的代码拆分成符合逻辑的,简单易懂的片段,这有助于确保代码的正确性. 这一点非常重要,因为做到下面这些事情是非常困难的: 在我们的脑中一次性处理所有复杂的问题. 了解何时从哪里开始着手解决问题. 在代码库的复杂度不断增长的同时不引入错误和bug:并且
-
Django使用unittest模块进行单元测试过程解析
Django测试框架非常简单,首选方法是使用python标准库中的unittest模块. Writing tests Django的单元测试使用python的unittest模块,这个模块使用基于类的方法来定义测试.类名为django.test.TestCase,继承于python的unittest.TestCase. from django.test import TestCase from myapp.models import Animal class AnimalTestCase(Tes
-
Django中对通过测试的用户进行限制访问的方法
限制访问可以基于某种权限,某些检查或者为login视图提供不同的位置,这些实现方式大致相同. 一般的方法是直接在视图的 request.user 上运行检查. 例如,下面视图确认用户登录并是否有 polls.can_vote权限: def vote(request): if request.user.is_authenticated() and request.user.has_perm('polls.can_vote')): # vote here else: return HttpRespo
-
Python Django框架单元测试之文件上传测试示例
本文实例讲述了Python Django框架单元测试之文件上传测试.分享给大家供大家参考,具体如下: Submitting files is a special case. To POST a file, you need only provide the file field name as a key, and a file handle to the file you wish to upload as a value. For example: >>> c = Client()
-
python常用web框架简单性能测试结果分享(包含django、flask、bottle、tornado)
测了一下django.flask.bottle.tornado 框架本身最简单的性能.对django的性能完全无语了. django.flask.bottle 均使用gunicorn+gevent启动,单进程,并且关闭DEBUG,请求均只返回一个字符串ok. tornado直接自己启动,其他内容一致. 测试软件为 siege,测试os为cenos6 64位,测试命令为: 复制代码 代码如下: siege -c 100 -r 100 -b http://127.0.0.1:5000/ django
-
Django单元测试工具test client使用详解
The test client test client是一个python类,来模拟一个简单的"哑"浏览器,允许你来测试你的view函数.你可以使用test client完成下列事情: 1.模拟"Get"和"Post"请求,观察响应结果--从HTTP(headers,status codes)到页面内容. 2.检查重定向链(如果有的话),在每一步检查URL和status code. 3.用一个包括特定值的模板context来测试一个request被
-
Django admin管理工具TabularInline类用法详解
TabularInline类用于在A页面上编辑B表的字段,举例说明,如果models.py中有Staff.Job两个model: from django.db import models class Staff(models.Model): name = models.CharField(max_length=10) class Job(models.Model): staff = models.ForeignKey(Staff) task = models.CharField(max_leng
-
Python Django的安装配置教程图文详解
Django 教程 Python下有许多款不同的 Web 框架.Django是重量级选手中最有代表性的一位.许多成功的网站和APP都基于Django. Django是一个开放源代码的Web应用框架,由Python写成. Django遵守BSD版权,初次发布于2005年7月, 并于2008年9月发布了第一个正式版本1.0 . Django采用了MVC的软件设计模式,即模型M,视图V和控制器C. 学习Django前,我们要确定电脑上是否已经安装了Python,目前Python有两个版本,不过这两个版
-
Go单元测试利器testify使用示例详解
目录 testify assert 包 require 包 mock 包 suite 包 testify 在团队里推行单元测试的时候,有一个反对的意见是:写单元测试耗时太多.且不论这个意见对错,单元测试确实不应该太费时间.这时候,一个好的单测辅助工具,显得格外重要.本文推荐的 testify(github.com/stretchr/te…) 包,具有断言.mock 等功能,能配合标准库,使你的单元测试更加简洁易读. testify 有三个主要功能: 断言,在 assert 包和 require
-
Golang单元测试与断言编写流程详解
目录 编写单元测试 批量测试(test tables) 执行测试 性能测试 配置计算时间 断言(assertion) Go 在testing包中内置测试命令go test,提供了最小化但完整的测试体验.标准工具链还包括基准测试和基于代码覆盖的语句,类似于NCover(.NET)或Istanbul(Node.js).本文详细讲解go编写单元测试的过程,包括性能测试及测试工具的使用,另外还介绍第三方断言库的使用. 编写单元测试 go中单元测试与语言中其他特性一样具有独特见解,如格式化.命名规范.语法
-
获取Django项目的全部url方法详解
在为一个项目添加权限时,遇到一个问题,就是为项目所有的url设置权限,但是一个一个手动输入太麻烦了,所以考虑用代码获取到一个项目所有的url 首先,考虑到项目最外层的urlpartterns,因为所有的url都要通过这里 urlpatterns = [ # url(r'^admin/', admin.site.urls), url(r'^arya/', site.urls), url(r'^index/', index), ] 先循环打印一下这个列表,看一下拿到的结果: <RegexURLRes
-
web开发之对比时间大小的工具函数的实例详解
web开发之对比时间大小的工具函数的实例详解 js时间大小比较,格式yyyy-MM-dd hh:mm:ss 把时间比较封装成一个工具函数: /** * 比较两个时间的大小 * 时间格式:yyyy-MM-dd hh:mm:ss * @param {Object} beginTime 开始时间 * @param {Object} endTime 结束时间 */ var getDataLarge = function(beginTimeString,endTimeString){ var b = be
-
Java 中DateUtils日期工具类的实例详解
Java 中DateUtils日期工具类的实例详解 介绍 在java中队日期类型的处理并不方便,通常都需要借助java.text.SimpleDateFormat类来实现日期类型 和字符串类型之间的转换,但是在jdk1.8之后有所改善,jdk1.7以及之前的版本处理日期类型并不方便, 可以借助Joda Time组件来处理,尤其是日期类型的一些数学操作就更是不方便. java代码 /** * * 日期工具类 java对日期的操作一直都很不理想,直到jdk1.8之后才有了本质的改变. * 如果使用的
-
Django的HttpRequest和HttpResponse对象详解
本文研究的主要是Django的HttpRequest和HttpResponse对象的相关内容,具体如下. 请求一张页面时,Django把请求的metadata数据包装成一个HttpRequest对象,然后Django加载合适的view方法,把这个HttpRequest 对象作为第一个参数传给view方法.任何view方法都应该返回一个HttpResponse对象. 我们在本书中大量使用这两个对象:本附录详细解释HttpRequest和HttpResponse对象. HttpRequest Htt
-
django 使用全局搜索功能的实例详解
安装需要的包 1 第一步: 全文检索不同于特定字段的模糊查询,使用全文检索的效率更高,并且能够对于中文进行分词处理. haystack:全文检索的框架,支持whoosh.solr.Xapian.Elasticsearc四种全文检索引擎 whoosh:纯Python编写的全文搜索引擎对于小型的站点,whoosh已经足够使用 jieba:一款免费的中文分词包 1)在虚拟环境中依次安装需要的包. pip install django-haystack pip install whoosh pip in