伏龙阁资源网

Django单元测试工具test client使用详解
站长资源 2024/11/25 佚名
2 0

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/"htmlcode">



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





当然也可以将查询字符对编码后加入url：





> c = Client()
> c.get('/customers/details/"htmlcode">



> 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/"htmlcode">



> 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是否相当。


以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。
广告合作：本站广告合作请联系QQ：858582 申请时备注：广告合作（否则不回）
免责声明：本站资源来自互联网收集,仅供用于学习和交流,请遵循相关法律法规,本站一切资源不代表本站立场,如有侵权、后门、不妥请联系本站删除！
www.wwsws.com 伏龙阁资源网
39,976影音资源
44,792技术资源
21,817软件资源
651,128站长资源

更新日志

友情链接

杰晶网络 DDR爱好者之家 桃源资源网 杰网资源 富贵资源网 南强小屋 铁雪资源网 幽灵资源网 万梅资源网 狼山资源网 白云岛资源网 昆仑资源网 相思资源网 明霞山资源网 内蒙古资源网 黑松山资源网 茶园资源网 饿虎岗资源网 大旗谷资源网 常春岛资源网 岱庙资源网 兴国资源网 快活林资源网 蝙蝠岛资源网 帝王谷资源网 白云城资源网 伏龙阁资源网 清风细雨楼 天枫庄资源网 圆月山庄资源网 无争山庄资源网 神水资源网 移花宫资源网 神剑山庄资源网 无为清净楼资源网 金钱帮资源网 丐帮资源网 华山资源网 极乐门资源网 小李飞刀资源网 凤求凰客栈 风云阁资源网 金狮镖局 鸳鸯亭资源网 千金楼资源网 更多链接