微服务契约测试框架Pact-Python实战

Pact是一个契约测试框架，有多种语言实现，本文以基于pact-python探究契约测试到底是什么？以及如何实现

官网：自述文件 |契约文档 (pact.io)

契约测试步骤

1、为消费者写一个单元测试，让它通过，并生成契约文件。

2、在生产者服务执行该契约文件，验证测试是否通过。

 安装pact-Python

官方介绍的是直接使用pip下载，但是国内下载有问题。

下载方法参考：契约测试第一步--pact-python安装_51CTO博客_pact 契约测试

下载安装包：

https://pypi.org/project/pact-python/0.19.0/#modal-close

 点击下载后手动解压：

入主目录，与setup.py同级，进入命令行执行：

python setup.py build      

python setup.py install

 消费者测试

新建项目，创建contract_miku.py文件

 代码

# -*- coding: utf-8 -*-
"""
@author dongfangbubai
@date 2023年07月27日 18:08:14
@packageName 
@className contract_miku
@describe 模拟消费者去请求真实的生产者
"""
import atexit
import unittest
# from query import get_cartoon_characters
import requestsfrom pact import Consumer,Provider
#构造pact对象，定义消费者服务的名字并给他绑定一个生产者服务
pact = Consumer('consumer').has_pact_with(Provider('provider'))
pact.start_service()#start mock service
# # #注册推出的时候关闭pact服务
atexit.register(pact.stop_service)class GetMikuInfoContract(unittest.TestCase):def test_miku(self):#定义期望的结果expected={"salary":20000,"name":"miku","national":"Chinese","contract":{"Email":"[e-mail]","Phone":"13265523433"}}#定义expected响应头headers={"Content-Type":"application/json"}#定义预期请求以及响应的方式(consumer will request in this way and expected to get the repsponed from the procide)(pact.upon_receiving("a request for UserA")#请求的名字.with_request(method="GET",path='/information',query={"name":"miku"}) #期望的请求方法，请求url.will_respond_with(200,headers, expected)#期望请求的返回)#定义消费者服务向模拟生产者发生请求，并获得响应#the url and port is the mockservice not real provider with pact:#定义pactresult=requests.get('http://127.0.0.1:1234/information',{"name":"miku"})print(result)print(result.headers)print(result.json())#做最后的断言self.assertEqual(result.json(),expected)
if __name__ == '__main__':unittest.main()

可以看到首先构造一个pact，并使用pact启动mock服务。

在具体的测试类和方法中采用了unittest测试框架，采用什么测试框架可以根据所使用的语言，这里也可以用pytest。js语言就可以用mocha框架。

在test_miku函数中定义了expected,headers，在pact中定义消费者预期的请求方式和响应结果。后续会根据这些生成契约。

在with pact里定义向mock服务的请求，最后断言请求的结果与预期是否一致。

需要注意的是，with pact里的url是pact带的mock服务对应的1234端口，而不是真实的服务，也不能填写真实服务。

运行结果

使用python方式运行contract_miku.py

在窗口输出了一些关于ruby编码的提示，对结果好像没有影响。

在result.json的打印中可以看到打印的内容与我们的expected内容一致。

测试用例为通过状态。其实消费者端的单元测试代码无论expected怎么写，测试用例都是通过的，因为我们的目的就是写一个单元测试让测试用例通过。

契约文件

代码运行后，会生成consumer-provider.json文件，这就是契约文件。

契约文件里定义了consumer，provider的名称，和交互。

交互包括request,response,请求body。

契约文件就是消费者的需求，而生产者应该满足这些需求。

 生产者测试

这里采用flask框架生成了一个接口

api_server.py

# -*- coding: utf-8 -*-
"""
@author 
@date 2023年07月28日 09:31:25
@packageName 
@className api_server
@describe TODO
"""
import jsonfrom flask import Flask, request, jsonifyapp = Flask(__name__)rsp_body=[{"salary":20000,"name":"miku","national":"Chinese","contract":{"Email":"[e-mail]","Phone":"13265523433"}}]
@app.route('/information')
def test():get_name=request.args.get("name","").lower()print(get_name)if get_name=='miku':rsp=jsonify(rsp_body[0])elif get_name=='nanpha':rsp = jsonify(rsp_body[1])else:rsp=jsonify({'status':'404 not found'})return rspif __name__ == '__main__':app.run(host='0.0.0.0',port=8080)

运行api_server.py，使用postman请求接口

 测试生产者服务只需要在命令行执行

pact-verifier --provider-base-url=http://localhost:8080 --pact-url=consumer-provider.json

 这里指定了生产者服务的url和契约文件即消费者测试生成的文件

运行结果显示没有失败，说明执行成功。

可以看到生产者服务返回的状态码，响应体和响应头都与契约文件匹配，所以验证成功。

契约测试与接口测试和集成测试的区别

 

 

 参考

【软件测试课程中——微服务架构测试中的契约测试。】 https://www.bilibili.com/video/BV1Qf4y1F76L/?p=4&share_source=copy_web&vd_source=1aab39b433529f6f488e61847b342350