HttpRunner_简单入门

httprunner介绍

HttpRunner是一款面向HTTP(S)协议的通用测试框架,只需编写维护一份YAML/JSON脚本,即可实现自动化测试、性能测试、线上监控、持续集成等多种测试需求。

官方文档(内容比较乱)

文档目的

按照本文档,能够快速构建出可以执行大部分接口测试用例的httprunner脚本

必知概念

文档:测试用例结构和hook机制

准备步骤

  • 准备环境
    安装配置python环境,包括pip(HttpRunner的稳定版本托管在 PyPI 上,可使用pip安装)
  • 安装和校验
    1.安装:pip install httprunner
    2.校验:hrun -V,如果正常显示版本号,则说明成功
  • 快速构建httprunner的工程名录(脚手架):hrun --startproject 目录名字
    1.结果示例:
    image.png

    2.目录文件说明:
    api:放置teststep
    testcases:放置testcase
    testsuites:放置testsuite
    reportes:放置测试报告
    .env:存储项目环境变量
    debugtalk.py :hook函数(此处可理解为辅助函数)写在这里
    .gitignore:上传git时需要忽略的文件

fiddler抓包数据生成yaml文件

从头开始写yaml很麻烦,HttpRunner提供了命令工具,能够把fiddler导出的har文件,转换成yaml文件,可以在这个基础上进行自己想要的修改,就可以当成testcase来使用

  • 1.导出har文件:
image.png

Charles Proxy也支持导出har格式的文件,看官网:https://cn.httprunner.org/prepare/record/

  • 2.把har文件生成yaml文件
    har2case xxxxx.har -2y

PS.如果是最简单的执行一个testcase,有这个就可以执行了,但是本文档会说使用到testcase/tsetsuite/参数化parameters(更详细的csv文件/hook函数待续)

文档示例中使用的接口信息

请求方式 :POST
路径 :http://xxx/audience/add
请求参数(部分):

{
  "profile": [                  // 个人资料新增    
  {
      "op": "add",              // 操作类型 
      "wechatNickname": "小明",     // 微信昵称
      "gender": 1, // 性别,0未知 1男 2女
   }  ]
   }

编写测试文件步骤

  • 做法
    1.把gender的值,在testsuite设置成参数化数据,在testcase中提取
    2.把url中的域名提取出来,在testsuite设置成base_url,这样就不需要多次设置
  • 准备testcase
    1.复制上面生成的yaml文件到testcases目录下
    2.根据需求进行修改:字段解释
    image.png
  • 准备testsuite
    原因:httprunnerV2.0之后,参数化数据驱动的值改为放置在testsuite
    1.在testsuite目录下,创建一个yaml文件,可取名为xxx_testsuite.yml
    2.本例子的testsuite内容如下:
    image.png
  • 执行testsuite
    1.切换命令行模式,进入所创建的的工程目录的根路径(比如说工程目录是audience,那么就来到audience下。因为执行运行命令时,会把测试报告保存到当前路径的reporte目录,如果没有则创建该目录,这样是为了让测试报告保存在已有的reporte目录中)
    2.执行testsuite
    hrun testsuites/xxx_testsuite.yml
    3.结果
    image.png

    4.测试报告
    image.png

    image.png

testcase提取出teststep

上面的例子中,所使用的文件层面上,最小单位是testcase,我们也可以把testcase中的每个测试步骤,提取出来,放到teststep

  • api目录下,创建一个yaml文件,比如xxx_teststep.yml
  • 然后到testcase中想要提取的test节点的内容,复制到xxx_teststep.yml中,如:
image.png
  • 在``testcase中指定包含的teststep
image.png
  • testsuite无需修改
  • 执行testsuitehrun testsuites/xxx_testsuite.yml
  • 结果


    image.png

    image.png

参考文档

如果想要更具体深入去了解(比如说更多的参数化数据、读取csv文件、调用hook函数、压测等),可看:
1.测试用例结构和hook机制
2.参数化数据驱动
3.环境变量
4.性能测试
5.开发拓展

建议:多使用,当不会的时候,去看官方文档(虽说很乱),再不行就百度谷歌。得多用才能更熟练

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,258评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,335评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,225评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,126评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,140评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,098评论 1 295
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,018评论 3 417
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,857评论 0 273
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,298评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,518评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,678评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,400评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,993评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,638评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,801评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,661评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,558评论 2 352

推荐阅读更多精彩内容