如何测试¶

如何运行uliweb的单元测试¶

uliweb的单元测试代码是放在 uliweb/test 目录下， test 开始的就是测试代码。运行它需要安装nose，然后进入 test目录，在命令行下运行：

nosetests --with-doctest <test_xxx.py>

介绍¶

根据测试的要求，我们可以将其分为：函数测试，web测试。其中，函数测试大多数情况 下可以使用象doctest的技术来实现，这里不描述了。主要讲web测试。web测试一般需要 一个环境，如web server。然后通过在客户端录制脚本来摸拟页面操作，再比较返回的 内容。因为uliweb底层使用werkzeug模块，它提供了 werkzeug.test 功能，所以你可以 使用它来进行测试。它可以摸拟web server的工作方式，通过程序的方式发出get, post 请求，还可以自动处理cookie和redirect，所以使用很方便。

为了简化在uliweb中的使用，uliweb.utils.test中提供了client的函数，它将返回一个 Client对象。关于如何使用werkzeug进行测试的文档请参见werkzeug的 文档 。

示例如下:

from uliweb.utils.test import client

c = client('..')
r = c.post('/login', data={'username':'username', 'password':'password'}, follow_redirects=True)
r = c.get('/')
print r.data

上面的代码摸拟用户登录的例子。

client接受一个project_path的参数，它是你的uliweb项目的目录，其下应该有apps子目录。 它会自动创建app。c.get()和c.post()分别对应GET和POST的HTTP的请求，返回值为Response 对象。

自动测试脚本¶

有时我们需要检测版本修改之后的正确性，最简单的就是将一些主要的链接访问一下， 看一看有没有报错，没有报错的话，基本上就没有太大问题。下面是一段利用了Test功能 进行自动测试的脚本。

from uliweb.utils.test import client
c = client('..')

urls = [
('post', '/login', {'username':'username', 'password':'password'}),
'/',
'/systems'
]

for url in urls:
    if isinstance(url, tuple):
        method, path, param = url
    else:
        method = 'get'
        param = {}
        path = url
    func = getattr(c, method.lower())
    r = func(path, data=param)
    
    if r.status_code in (200, 304, 302):
        result = 'PASSED'
    else:
        result = 'FAILED'
    print url, r.status_code, result

这个脚本的主要思路就是组织一个要检测的URL的列表，每项URL可以是一个地址或 tuple 值。如果是一个 tuple，格式为:

method, url, param

method

表示请求的方法，取值可以为 post 或 get 。

URL

是访问的路径。

param

是调用时的参数。

有些页面可能需要登录才可以继续访问，所以可以把 /login 作为第一个URL来处理。

Test在执行时并不需要真正启动服务器，它是象批处理一样只是启动应用的实例，所以可 以很方便执行。