pytest学习教程--做简单的接口测试(8)

背景

我们现在需要测试v2ex网站的查看论坛节点信息的api。具体如下:

节点信息

获得指定节点的名字，简介，URL 及头像图片的地址。

https://www.v2ex.com/api/nodes/show.json

Method: GET Authentication: None 接受参数：

name: 节点名（V2EX 的节点名全是半角英文或者数字） 例如：

https://www.v2ex.com/api/nodes/show.json?name=python

接口返回

{
“id” : 90,
“name” : “python”,
“url” : “http://www.v2ex.com/go/python”,
“title” : “Python”,
“title_alternative” : “Python”,
“topics” : 7963,
“stars” : 5138,
“header” : “这里讨论各种 Python 语言编程话题，也包括 Django，Tornado 等框架的讨论。这里是一个能够帮助你解决实际问题的地方。”,
“footer” : null,
“created” : 1278683336,
“avatar_mini” : “//v2ex.assets.uxengine.net/navatar/8613/985e/90_mini.png?m=1509941286”,
“avatar_normal” : “//v2ex.assets.uxengine.net/navatar/8613/985e/90_normal.png?m=1509941286”,
“avatar_large” : “//v2ex.assets.uxengine.net/navatar/8613/985e/90_large.png?m=1509941286”
}

需求分析

该接口是获取数据的接口，一般来说，这种接口我们的测试重点是验证数据的准确性。

根据3A原则，我们可以设计如下的用例

测试数据: 节点的名称:python
接口地址: https://www.v2ex.com/api/nodes/show.json
断言: 返回的结果里，id必须是90,name必须等于python，大家想一想为什么？

代码

新建名为v2ex_api_test.py的文件，键入如下内容

import requests

class TestV2exApi(object):
    domain = 'https://www.v2ex.com/'

def test_node(self):
    path = 'api/nodes/show.json?name=python'
    url = self.domain + path
    res = requests.get(url).json()
    assert res['id'] == 90
    assert res['name'] == 'python'

需要注意的点

• 使用requests库来简化发送get请求并将返回值的json字符串转换成python字典
• 使用domain变量来参数化测试的地址，因为不同环境的地址可能不一样，使用domain变量之后只需要改动这个变量就可以切换测试环境了
• 断言id为90是因为测试数据是静态的，id不会发生变化

运行

$ pytest v2ex_api_test.py
================== test session starts ==============================
platform darwin – Python 2.7.12, pytest-3.2.3, py-1.4.34,
pluggy-0.4.0 rootdir: /Users/easonhan/code/testclass.net/src/pytest,
inifile: collected 1 item

v2ex_api_test.py .

================= 1 passed in 1.39 seconds =====================

用例执行成功，我们实现了最简单的接口测试场景。