Python接口自动化测试框架（工具篇）-- 接口测试工具HTTPRUNNER

一、前言

又又又到了讲httprunner框架的时候，作为测试界的后起之秀，从其开源默默无闻到家喻户晓，从线上教育机构拿来做噱头到作者在工作中实战应用，就单单它不同的版本支持不同的测试框架，它就值得再一次被解说。尽管这个系列作者已经写过10来篇，其中用法介绍相差不大，但是在整个接口自动化测试框架中没有篇幅，或者叫推荐，那么它又是测试界的新宠儿，不仅是在接口测试方面；还能做接口性能测试，它在测试界应该占有一席之地。

二、HttpRunner介绍

附上github地址，这是开源的免费项目，已经发展到v3.x版本了，unittest进阶pytest框架；可以算是非常优化了。

另附httprunner3.x官方文档地址，本章内容所有的技术点都源自于此；或许一些疑问也应该由此提出；它能做为接口自动化测试的解决方案吗？

• 无论是浏览github还是阅读官方文档，它的描述都不是工具而是框架；没错，它集成了requests、pytest、locust、allure等等诸多工具或者框架、插件，是集大成者。

2.1、如何安装

支持python3.6及以上版本，pip install httprunner，如此默认是安装最新版本；本篇就以最新版本做演示。

如果想去低版本，可以指定安装版本：pip install httprunner==2.4.3；更多安装办法请参考官方文档。

• 验证安装版本是否成功，cmd–>httprunner -V

C:\Users\xxxxx>httprunner -V
3.1.6

        

          
        
        
        

          

          AI 代码解读
        
      
      

2.2、如何使用

记住一点，咱们在选择用什么样的工具做接口测试的时候，往往优先考虑它的使用规则，是简单还是复杂，是容易上手还是需要更高学习成本？很幸运，它是简单易学的，这要归功于它的录制功能(事实证明：如果一个优秀的工具少了录制功能，咱们也会对它少了些兴趣)，通过抓包工具fiddler/charles导出har数据文件，再通过har2case(-2y/-2j)转换成yaml/json格式的测试用例，最后hrun执行脚本；这样就可以完成简单的线性脚本(场景化接口测试)。

• 录制功能，选择自己熟练的工具，作者优先charles

• 设置手机或浏览器代理，教程略，可自行百度搜索
• 开始抓包(录制)，导出har文件，存放于指定位置
• cmd命令进入har文件位置，har2case xxx.har会在当前路径下默认生成xxx_test.py文件

C:\Users\xxxxx>testcase\dir
xxxxxx xxxx  xxx  xxx.har
C:\Users\xxxxx>testcase\har2case xxx.har
C:\Users\xxxxx>testcase\dir
xxxxxx xxxx  xxx  xxx.har
xxxxxx xxxx  xxx  xxx_test.py

# 默认py，har2case -2y 参数可以生成yaml格式
C:\Users\xxxxx>testcase\har2case -2y xxx.har
C:\Users\xxxxx>testcase\dir
xxxxxx xxxx  xxx  xxx.har
xxxxxx xxxx  xxx  xxx_test.py
xxxxxx xxxx  xxx  xxx.yml

# har2case -2j 参数可以生成json格式
C:\Users\xxxxx>testcase\har2case -2j xxx.har
C:\Users\xxxxx>testcase\dir
xxxxxx xxxx  xxx  xxx.har
xxxxxx xxxx  xxx  xxx_test.py
xxxxxx xxxx  xxx  xxx.yml
xxxxxx xxxx  xxx  xxx.json

        

          
        
        
        

          

          AI 代码解读
        
      
      

• 执行用例文件：hrun xxx.json，会在当前目录生成reports报告目录/xxx.html

C:\Users\xxxxx>testcase\hrun xxx.json --html=reports/report.html
C:\Users\xxxxx>testcase\dir
xxxxxx xxxx  <DIR>  reports
xxxxxx xxxx  xxx  xxx.har
xxxxxx xxxx  xxx  xxx_test.py
xxxxxx xxxx  xxx  xxx.yml
xxxxxx xxxx  xxx  xxx.json

        

          
        
        
        

          

          AI 代码解读
        
      
      

• 查看报告，进入reports目录双击report.html报告

• 这个报告相对较丑，再看看美丽的一面，不过需要多做两件事情：pip安装allure-pytest插件和安装allure

C:\Users\xxxxx>testcase\ pip install allure-pytest
C:\Users\xxxxx>testcase\ hrun xxx.json  --alluredir=reports/allure-results
C:\Users\xxxxx>testcase\ allure serve reports/allure-results

        

          
        
        
        

          

          AI 代码解读
        
      
      

• allure serve会生成报告，并且自动打开浏览器：

三、小结

在使用过程中，熟练度肯定不如之前写的httprunner2.x版本，然而hrun/har2case -h所支持的参数列表多少也发生了变化，故而导致使用感觉陌生了点，既然它提供了帮助文档，咱们就应该能用最少的时间来适应它。

关于测试用例的格式，json或者yml，首先推荐yml，因为它能在文件中写注释，就单单这点就够了，虽然格式美化后的json会比yml可读性更高写，但是耐不住yml的运用会比json广。

关于api、测试用例、测试套件的使用，在当前最新版本可能已经不存在这个概念了，所以需要稍微多的时间从个人感觉HttpRunner2.x版本转变过来；个人感觉HttpRunner2.x版本已经可以满足日常测试需求了。

四、扩展

像jmeter都有模版快速创建测试计划，httprunner也不例外有快速创建工程结构

• httprunner -h , 查看帮助文档，httprunner框架支持hrun、har2case、startproject、make操作；
• 其中startproject参数就能满足快速创建工程的需求

• 而make可以将json/yml格式的用例数据转成py测试用例；和hrun直接运行xxx.har一样

4.1、回到刚开始的问题

HttpRunner能作为接口自动化测试的解决方案吗？

• 答案是肯定的，作者当前应用就是通过录制，按模块或者业务功能操作app，分不同场景和业务进行组织测试用例，最后与jenkins集成，通过定时构建触发执行测试，按条件决定是否发送邮件、钉钉、企业微信消息通知。