跳转至

安装说明

运行环境

HttpRunner 是一个基于 Python 开发的测试框架,可以运行在 macOS、Linux、Windows 系统平台上。

Python 版本:HttpRunner 支持 Python 3.5 及以上的所有版本,并使用 Travis-CI 进行了持续集成测试,测试覆盖的版本包括 2.7/3.5/3.6/3.7/3.8。虽然 HttpRunner 暂时保留了对 Python 2.7 的兼容支持,但强烈建议使用 Python 3.6 及以上版本。

操作系统:推荐使用 macOS/Linux。

安装方式

HttpRunner 的稳定版本托管在 PyPI 上,可以使用 pip 进行安装。

$ pip install httprunner

如果你需要使用最新的开发版本,那么可以采用项目的 GitHub 仓库地址进行安装:

$ pip install git+https://github.com/HttpRunner/HttpRunner.git@master

版本升级

假如你之前已经安装过了 HttpRunner,现在需要升级到最新版本,那么你可以使用-U参数。该参数对以上三种安装方式均生效。

$ pip install -U HttpRunner
$ pip install -U git+https://github.com/HttpRunner/HttpRunner.git@master

安装校验

在 HttpRunner 安装成功后,系统中会新增如下 5 个命令:

  • httprunner: 核心命令
  • ate: 曾经用过的命令(当时框架名称为 ApiTestEngine),功能与 httprunner 完全相同
  • hrun: httprunner 的缩写,功能与 httprunner 完全相同
  • locusts: 基于 Locust 实现性能测试
  • har2case: 辅助工具,可将标准通用的 HAR 格式(HTTP Archive)转换为YAML/JSON格式的测试用例

httprunner、hrun、ate 三个命令完全等价,功能特性完全相同,个人推荐使用hrun命令。

运行如下命令,若正常显示版本号,则说明 HttpRunner 安装成功。

$ hrun -V
2.4.1

$ har2case -V
0.3.1

开发者模式

默认情况下,安装 HttpRunner 的时候只会安装运行 HttpRunner 的必要依赖库。

如果你不仅仅是使用 HttpRunner,还需要对 HttpRunner 进行开发调试(debug),那么就需要进行如下操作。

HttpRunner 使用 poetry 对依赖包进行管理,若你还没有安装 poetry,需要先执行如下命令进行安装:

$ curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python

获取 HttpRunner 源码:

$ git clone https://github.com/HttpRunner/HttpRunner.git

进入仓库目录,安装所有依赖:

$ poetry install

运行单元测试,若测试全部通过,则说明环境正常。

$ poetry run python -m unittest discover

查看 HttpRunner 的依赖情况:

$  poetry show --tree
colorama 0.4.1 Cross-platform colored terminal text.
colorlog 4.0.2 Log formatting with colors!
└── colorama *
coverage 4.5.4 Code coverage measurement for Python
coveralls 1.8.2 Show coverage stats online via coveralls.io
├── coverage >=3.6,<5.0
├── docopt >=0.6.1
├── requests >=1.0.0
│   ├── certifi >=2017.4.17 
│   ├── chardet >=3.0.2,<3.1.0 
│   ├── idna >=2.5,<2.9 
│   └── urllib3 >=1.21.1,<1.25.0 || >1.25.0,<1.25.1 || >1.25.1,<1.26 
└── urllib3 *
filetype 1.0.5 Infer file type and MIME type of any file/buffer. No external dependencies.
flask 0.12.4 A microframework based on Werkzeug, Jinja2 and good intentions
├── click >=2.0
├── itsdangerous >=0.21
├── jinja2 >=2.4
│   └── markupsafe >=0.23 
└── werkzeug >=0.7
future 0.18.1 Clean single-source support for Python 3 and 2
har2case 0.3.1 Convert HAR(HTTP Archive) to YAML/JSON testcases for HttpRunner.
└── pyyaml *
jinja2 2.10.3 A very fast and expressive template engine.
└── markupsafe >=0.23
jsonpath 0.82 An XPath for JSON
pyyaml 5.1.2 YAML parser and emitter for Python
requests 2.22.0 Python HTTP for Humans.
├── certifi >=2017.4.17
├── chardet >=3.0.2,<3.1.0
├── idna >=2.5,<2.9
└── urllib3 >=1.21.1,<1.25.0 || >1.25.0,<1.25.1 || >1.25.1,<1.26
requests-toolbelt 0.9.1 A utility belt for advanced users of python-requests
└── requests >=2.0.1,<3.0.0
    ├── certifi >=2017.4.17 
    ├── chardet >=3.0.2,<3.1.0 
    ├── idna >=2.5,<2.9 
    └── urllib3 >=1.21.1,<1.25.0 || >1.25.0,<1.25.1 || >1.25.1,<1.26 

调试运行方式:

# 调试运行 hrun
$ poetry run python -m httprunner -h

# 调试运行 locusts
$ pipenv run python -m httprunner.ext.locusts -h

Docker

TODO