README_ZH.md

QiwuGrader

齐悟自动测试工具，支持对 知识库 / QA问答对 / 服务器后端 进行 正确性 / 压力 测试。

English version

[TOC]

1. 作者

Feliciano Long

Zhiyu.Zhou

统计数据

2. 支持

Python2 > 2.7 及 Python3 （推荐）

3. 安装

通过 PYPI

pip install QiwuGrader

下载源代码

1. Windows用户请先安装（Mac用户可跳过此步）：

https://www.python.org/ftp/python/2.7.15/python-2.7.15.msi

2. （可选步骤）如果系统环境变量没有被正确是设置（无法直接通过cmd/terminal运行python/pip），把python可执行文件及pip路径添加进系统环 境变量中 详情

3. 安装依赖

pip install -r requirements.txt

下载发行版

已废弃，请使用 pip 直接安装

直接下载发行版exe

4. 运行方法

最后两个参数可省略

使用 module 运行

qiwugrader [testcase] [session number] [test duration]

or

python -m qiwugrader.app [testcase] [session number] [test duration]

使用源代码运行

python qiwugrader/app.py [testcase] [session number] [test duration]

5. 使用方法

单会话测试

测试一个用例：

qiwugrader ./testcases/test1.yml

轮流测试多个用例：

qiwugrader ./testcases/test1.yml ./testcases/test2.yml

多线程压力测试

使用多个线程进行高并发测试，多线程模式下只会使用一个CPU

5秒内启动10个线程：

qiwugrader ./testcases/test3.yml 10 5

在多线程测试中，建议关闭 print_conversation 开关以获得更佳的测试报告阅读效果

多进程压力测试

使用多个进程进行高并发测试，多进程模式下会启动 逻辑CPU 个进程进行测试（每个进程分配 会话数整除CPU数量 个任务）。

与多线程类似，当需要测试的 会话数多于 1000 且 启动间隔小于 0.1s 时，会自动启用多进程模式进行测试。

60s 内进行 1200 次测试：

qiwugrader ./testcases/test4.yml 1200 60

6. 配置

所有参考的配置样例都在 testcases 文件夹下

知识库测试参考 test1 （带有详细解释的完整测试样例） 和 test2 （最简测试样例）。 API/模糊匹配测试参照 test3 （json请求，即QA问答对测试）和 test4 （表单请求，即知识库后端）

7. Windows控制台出现乱码

先输入 chcp 65001 激活UTF-8代码页