Httprunner 文件上传场景

使用Httprunner在做接口自动化的时候，经常会遇到需要上传文件的场景，下面讲一下关于Httpruner文件上传的用例编写。

1. 建项目

首先我们使用httprunner的脚手架快速搭建一个工程

  httprunner --startproject demo

生成的工程目录结构如下图

简单介绍一下这些目录的作用，

• apis  放接口的目录
• testcases  放用例的目录
• testsuites   放用例集的目录
• reports   生成的测试报告目录
• .env   存放系统环境变量
• debugtalk.py   编写动态逻辑函数

2. 抓包与解析

本文使用的是Fiddler抓包工具进行抓的包，访问百度识图网站PC版 ，点击本地上传，选中本地一张图片后上传。那么在Fiddler抓包工具中，我们抓到数据大致如下图所示

选中该接口，点击File->Export Sessions->Selected Sessions, 弹出数据包类型选择，选择HTTPArchive v1.2，给文件命名，这里命名的是upload，那么将得到一个upload.har文件

3. 用例编写

打开DOS，进入到文件所在目录，执行下方命令，将har文件转成yaml文件, 得到文件upload.yml, 文件内容如下图

  har2case -2y upload.har

我们注意到，其实这个接口呢，主要就是传递了两个参数值，一个是data,就是图片数据，另一个就是params中的uptime,这是一个13位数的时间戳。其中呢，data数据是可以每次都不变的，但uptime是要随时间变化的，这其实也是一种过滤或者说校验手段，保证每次上传图片的唯一性和有效性。

3.1 处理时间戳问题

关于时间戳呢，在debugtalk.py文件中编写一个获取当前时间戳的动态函数

  import time

  def getTimeStamp():             # 获取一个13位数的时间戳
        return int(time.time()*1000)

将upload.yml文件中的时间戳替换成动态函数之后，就可以无限次数上传刚才上传的那张图片了。更改如下

  uptime: ${getTimeStamp()}

3.2 处理图片上传问题

那么如果我们想要上传其他图片呢，思路也是差不多的，只需要把data中的数据换成新的图片的数据即可，也可以像获取时间戳一样写一个带参数path（图片路径）动态逻辑函数，函数读取图片并对图片进行base64编码以及设置boundary，返回编码后的数据。这样相对来说是复杂一些，对于不同的接口编码函数甚至需要更改，为什么呢？我们看到这两张图

-------------------------------------------图片分割线-----------------------------------------------------------

图一显示的就是data在webform中的样子，图二显示的就是data中的raw数据（省略了很多）。从图一和图二我们可以知道，如果要写一个关于读取图片并编码的函数的话，这个函数的返回值中，不仅被要求包含图片的base64格式数据，还要含有其余三个参数的key与其对应的value，就是 tn，image_source， from这三个key，以及他们的值。

写这样的函数其实也不困难，但如果另外一个接口除了图片数据之外又有其它参数要求呢，这个时候就又需要些另外一个编码函数了， 那么有没有更方便一些的方式呢？

有，接着往下看！

前面都是铺垫，下面才是重点，重点，重点！！！

---

方法一   使用upload关键字

为了方便文件上传呢，Httprunner 2.4.1以上版本支持upload关键字，可以在请求中添加相应参数即可完成图片上传。以刚才的百度图片上传为例，使用关键字upload后的代码是

config:
    name: testcase description
    variables: {}
teststeps:
-   name: /upload
    request:
        verify: False
        upload:
            image: logo.jpg
            image_source: PC_UPLOAD_FILE
            tn: pc
            from: pc

        headers:
            Sec-Fetch-Dest: empty
            Sec-Fetch-Mode: cors
            Sec-Fetch-Site: same-origin
            User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36
                (KHTML, like Gecko) Chrome/86.0.4240.111 Safari/537.36
            X-Requested-With: XMLHttpRequest
        method: POST
        params:
            uptime: ${getTimeStamp()}
        url: https://graph.baidu.com/upload
    validate:
    -   eq:
        - status_code
        - 200
    -   eq:
        - headers.Content-Type
        - application/json
    -   eq:
        - content.is_intervene
        - false
    -   eq:
        - content.status
        - 0
    -   eq:
        - content.msg
        - Success

是不是非常非常简单呢，直接使用upload字段就可以完成编码并上传的功能了。在upload字段下面，我们有四个参数：image, image_source, tn, from。

很眼熟吧，这四个参数就只之前我们提到的那些参数了，其中我们只需要重点关注image, 因为这个key的值是一个file，也就是我们需要上传的文件，所以这里填写的就是我们需要上传的图片的路径。而这个图片路径需要非常注意，它一定是相对于运行路径。以我的项目文件结构为例

如图所示，Logo.jpg文件与api，reports，testcases，testsuites等是处于同一层级的，Logo.jpg和它们都是在根目录demo下的子层级，不要看成属于testsuites了。如果在demo中执行脚本，即命令

  hrun api/upload.yml

那么image的值就Logo.jpg。 如果进入到api中执行，即命令

  hrun upload.yml

那么image的值就是 ../Logo.jpg, 因为图片在api里的上一层级。这一点需要重点注意！！！

此外呢，可能大家也注意到使用upload字段的脚本下Headers选项中Content-type被删除了，这是因为upload会自动生成对应的Content-type，不需要画蛇添足了，不然遇到各种奇奇怪怪的问题都无从定位。

今天写不动了，也写不完了，明天继续写....