这是一个自动生成接口测试测试用例的项目, 您可以通过如下方式使用他

run in python3 当你git clone 该项目后,可以通过如下命令配置你的环境 如果你习惯使用venv环境, 那么你可以进行如下操作

>>> cd doraemon
>>> . venv/bin/activate
>>> pip3 install -r requirements.txt

测试用例的编写

• 在根路径下找到cases路径

• 在cases路径下, 新增 .json尾缀的文件

• 如果是单个文件单个case, 可参考如下示例: test_history_day.json

{
  "test_get_history_days": {
    "url": "http://api.juheapi.com/japi/toh",
    "params": "v=&month=&day=&key=1d39d53a70ebed87d5cabbc8b73b96e2",
    "method": "get",
    "desc": "测试历史上的今天接口, get请求",
    "assert": {
      "result": ["len", 0],
      "error_code": 10005
    }
  }
}

用字典包含字典的结构进行保存

在上面的示例中, {key: {...}},

• 文件名表示生成测试用例中的class的命名(以test开头,下划线分割多个单词)
• key表示测试方法名, 如果需要case有序执行, 可以将示例中: test_get_history_days 修改为test_1_get_history_days
• key对应的字典, 是这条case中所有的需要用到的参数, 目前支持结构体如下

run.py

当你编写完成测试用例后, 可以通过以下命令运行测试

python3 run.py
>>> Testing ...

run.py是一个可以接受外部传参的文件, 当你需要自定义测试用例路径/ 测试报告生成路径 / 测试用例的Pattern时, 可以先通过 python3 run.py --help 来查看对应的入参后按需修改

☁  doraemon [master] ⚡ python3 run.py --help
Usage: run.py [OPTIONS]

Options:
  --cases TEXT    case file path
  --pattern TEXT  get cases file pattern
  --report TEXT   generator report in path
  --help          Show this message and exit.

默认参数配置如下

@click.option('--cases', default='src/testcases/', help="case file path")
@click.option('--pattern', default='*.py', help="get cases file pattern")
@click.option('--report', default='src/report/', help="generator report in path")

测试报告

当测试运行完成后, 可以通过进入src/report路径, 找到执行用例后生成的测试报告, 如下图:

如果大家在使用过程中, 发现任何问题可以提交issues 或直接给我发邮件[email protected] 希望大家喜欢这个项目!