微服务契约测试框架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 requests

from 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":"dongfangbubai@163.com",
                "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:#定义pact
            result=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 json

from flask import Flask, request, jsonify

app = Flask(__name__)

rsp_body=[{
            "salary":20000,
            "name":"miku",
            "national":"Chinese",
            "contract":{
                "Email":"dongfangbubai@163.com",
                "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 rsp


if __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