搜云库技术团队
前言
在之前的文章中，我们已经学习了 parameters 参数化，是在测试脚本中直接指定参数列表。这种方法简单易用，但如果我们的参数列表数据比较多，这种方法可能就不太适合了。
当数据量比较大的时候，我们希望可以把测试数据写到 CSV 文件中，然后直接引用 CSV 文件数据。
本人环境：HttpRunner V1.5.8
测试场景
我们继续以之前的登录接口来学习，如果直接在 YAML/JSON 脚本中指定参数列表内容，那么我们的用例可能就是这样的：
- config:
name: parameters test
request:
base_url: http://api.nnzhp.cn
parameters:
- username-passwd:
- ["niuhanyang", "aA123456"]
- ["test10101", "fasdfasfa"]
- ["test1010", "aA123456"]
- test:
name: login case
request:
url: /api/user/login
method: POST
headers:
Content-Type: application/x-www-form-urlencoded
User-Agent: Fiddler
data:
username: $username
passwd: $passwd
validate:
- eq: [status_code, 200]
- eq: [content.error_code, 0]
上面的用例，只有 3 组测试数据，当我们有10、100组测试数据，如果直接写在测试脚本中，可能会很不方便。我们可以把这些测试数据都写到CSV文件，然后直接引用CSV文件，这样就方便多了，我们的脚本也显得更加简洁。
CSV中存放单个参数
对于 CSV 数据文件，需要遵循如下几项约定的规则：
- 文件需放置在与测试用例文件相同的目录中；
- CSV 文件中的第一行必须为参数名称，从第二行开始为参数值，每个（组）值占一行；
- 若同一个 CSV 文件中具有多个参数，则参数名称和数值的间隔符需实用英文逗号。
比如，我们有多组登录的数据，用户名都不一样，但密码都是一样的，我们就可以创建 username.csv，并把 用户名 这一参数写到 username.csv 中，如下：
username
niuhanyang
test10101
test1010
然后在 YAML/JSON 测试用例中，就可以通过 HttpRunner 内置的 parameterize（可简写为P）函数引用 CSV 文件。
parameters:
- username: ${P(username.csv)} # 或者 ${parameterize(username.csv)}
- passwd: ["aA123456"]
注意：HttpRunner中，在 parameters 中指定的参数名称必须与 CSV 文件中第一行的参数名称一致。
CSV中存放多个参数
对于具有关联性的多个参数，比如，我们有多组登录的数据，用户名和密码都不一样，那么我们可以创建 user.csv ，并把用户名和密码的参数写到 user.csv 中，如下：
username,passwd
niuhanyang,aA123456
test10101,fasdfasfa
test1010,aA123456
再修改一下 YAML 脚本：
parameters:
- username-passwd: ${P(user.csv)} # 或者 ${parameterize(user.csv)}
注意：上面的写法是用户名密码一对一的关系，如果是按下面这样写，那就会是笛卡尔积组合的情况，产生 3 * 3 = 9 种组合。
parameters:
- username: ${P(user.csv)}
- passwd: ${P(user.csv)}
另外，在测试脚本中指定参数时，可以只使用部分参数，并且参数顺序无需与 CSV 文件中参数名称的顺序一致。
运行用例
完整的YAML格式用例（test_csv.yml）：
- config:
name: parameters test
request:
base_url: http://api.nnzhp.cn
parameters:
- username-passwd: ${P(user.csv)} # 或者 ${parameterize(user.csv)}
- test:
name: login case
request:
url: /api/user/login
method: POST
headers:
Content-Type: application/x-www-form-urlencoded
User-Agent: Fiddler
data:
username: $username
passwd: $passwd
validate:
- eq: [status_code, 200]
- eq: [content.error_code, 0]
在HttpRunner 1.x版本中，引用 CSV 数据文件（如 user.csv），需要将 user.csv 和 test_csv.yml 放在同一目录下，然后在运行用例即可。运行用例后的报告如下：
