【python】Pytest+Request+Allure+Jenkins 接口自动化测试Demo

蔚落 2021-12-07 11:23 761阅读 0赞

摘要：用postman的一个接口为例子，做了一个接口自动化测试，使用Pytest+Request+Allure+Jenkins 框架，现在加以总结。

## 技术栈： ##

*  python3 、pytest、Requests
 *  Allure
 *  Jenkins

## 测试接口介绍 ##

本例使用Postman自带的一个接口来做测试，url如下：

https://postman-echo.com/time/before?timestamp=2016-10-10&target=2018-12-13

根据接口的请求参数timestamp、target和返回内容，大概设计了如下测试数据：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dhbGVuMjAxNg_size_16_color_FFFFFF_t_70]

## 项目介绍 ##

1、本项目用Pycharm开发，新建一个项目后，还要添加如下依赖包：

*  PyYAML
 *  allure-pytest
 *  requests
 *  selenium
 *  xlrd

2、 项目目录如下图：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dhbGVuMjAxNg_size_16_color_FFFFFF_t_70 1]  
3、config  
这个包下放的配置文件，如环境、url地址等

4、test\_case  
这个包放的是测试用例文件，本次接口测试用例为：test\_postman\_api.py  
另：conftest.py是pytest的一个pytest的配置文件，单独管理一些预置的操作场景

*  用例代码

# encoding: utf-8
    import allure
    import pytest
    import requests
    from utils.read_excel import *
    '''
    @author: lingshu
    @file: test_postman_api.py
    @time: 2019/7/8 20:54
    @desc: 测试postman API
    '''
    
    test_data = get_xls()
    
    @allure.feature('postman')
    @allure.story('postman-api')
    @pytest.mark.parametrize('timestamp,target,expected',test_data)
    def test_timestamp(timestamp,target,expected,env_config):
        """
        用例描述：测试不同的timestamp和target
        """
        #从yml配置文件获取url
        url = env_config['host']['url']
        payload = {'timestamp':timestamp,'target':target}
        r = requests.get(url,params=payload)
        print(r.url)
        result = r.json()
        assert str(result['before'])==expected

5、 testdata  
把测试数据放到excel里，实现脚本和数据分离

6、utils  
工具类包，如读取excel文件

7、test\_all\_run.py  
全局运行文件，实现运行所有测试用例

## Jenkins运行 ##

1、 Jenkins添加Allure插件。可以参考我的另一篇博客：[https://blog.csdn.net/galen2016/article/details/88015322][https_blog.csdn.net_galen2016_article_details_88015322]

2、 新建一个任务

*  新建一个任务，从svn拉取上面项目的代码
 *  构建命令

python test_all_run.py
    pytest -s -q --alluredir allure-results

*  构建后操作：添加Allure Report  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dhbGVuMjAxNg_size_16_color_FFFFFF_t_70 2]  
    3、 立即构建
 *  构建后如下图：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dhbGVuMjAxNg_size_16_color_FFFFFF_t_70 3]

### Allure测试报告 ###

1、点击Allure Report，参考测试报告  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dhbGVuMjAxNg_size_16_color_FFFFFF_t_70 4]  
2、测试套  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dhbGVuMjAxNg_size_16_color_FFFFFF_t_70 5]  
3、点击一个具体的行，查看详情，可以看到用例描述、参数信息等  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dhbGVuMjAxNg_size_16_color_FFFFFF_t_70 6]

### 项目地址：[https://github.com/Adien-galen/api\_auto\_test][https_github.com_Adien-galen_api_auto_test] ###

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dhbGVuMjAxNg_size_16_color_FFFFFF_t_70]: /images/20211207/b46c4fa2c85648a1b547ebd1f2f0c96e.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dhbGVuMjAxNg_size_16_color_FFFFFF_t_70 1]: /images/20211207/96460fd47e744045a657d256814e82a5.png
[https_blog.csdn.net_galen2016_article_details_88015322]: https://blog.csdn.net/galen2016/article/details/88015322
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dhbGVuMjAxNg_size_16_color_FFFFFF_t_70 2]: /images/20211207/2b00688d30d4410fa04f94d74890129d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dhbGVuMjAxNg_size_16_color_FFFFFF_t_70 3]: /images/20211207/6642a16e8d3a4a90a19e50aeea479901.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dhbGVuMjAxNg_size_16_color_FFFFFF_t_70 4]: /images/20211207/8889c5bee9de4576a01ce82f2cbebd1a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dhbGVuMjAxNg_size_16_color_FFFFFF_t_70 5]: /images/20211207/8907fb6c1d4343319765a4593ec49bff.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dhbGVuMjAxNg_size_16_color_FFFFFF_t_70 6]: /images/20211207/1f733bd0b016490c9cae36efd883be8c.png
[https_github.com_Adien-galen_api_auto_test]: https://github.com/Adien-galen/api_auto_test