mirror of
https://github.com/httprunner/httprunner.git
synced 2026-05-07 08:22:41 +08:00
6.6 KiB
6.6 KiB
HttpRunner
HttpRunner is an open source API testing tool that supports HTTP(S)/HTTP2/WebSocket/RPC network protocols, covering API testing, performance testing and digital experience monitoring (DEM) test types. Simple and easy to use, powerful, with rich plug-in mechanism and high scalability.
HttpRunner 用户调研问卷 持续收集中,我们将基于用户反馈动态调整产品特性和需求优先级。
Key Features
API Testing
- Full support for HTTP(S)/1.1 and HTTP/2 requests.
- Support more protocols, WebSocket, TCP, RPC etc.
- Testcases can be described in multiple formats,
YAML/JSON/Golang, and they are interchangeable. - Use Charles/Fiddler/Chrome/etc to record HTTP requests and generate testcases from exported
HAR. - Supports
variables/extract/validate/hooksmechanisms to create extremely complex test scenarios. - Data driven with
parameterizemechanism, supporting sequential/random/unique strategies to select data. - Built-in 100+ commonly used functions for ease, including md5sum, max/min, sleep, gen_random_string etc.
- Create and call custom functions with
pluginmechanism, support hashicorp plugin and go plugin. - Generate html reports with rich test results.
- Using it as a
CLI toolor alibraryare both supported.
Load Testing
Base on the API testing testcases, you can run professional load testing without extra work.
- Inherit all powerful features of
locustandboomer. - Report performance metrics to prometheus pushgateway.
- Use
transactionto define a set of end-user actions that represent the real user activities. - Use
rendezvouspoints to force Vusers to perform tasks concurrently during test execution. - Load testing with specified concurrent users or constant RPS, also supports spawn rate.
- Support mixed-scenario testing with custom weight.
- Simulate browser's HTTP parallel connections.
- IP spoofing.
- Run in distributed mode to generate unlimited RPS.
Digital Experience Monitoring (DEM)
You can also monitor online services for digital experience assessments.
- HTTP(S) latency statistics including DNSLookup, TCP connections, SSL handshakes, content transfers, etc.
pingindicators including latency, throughput and packets loss.- traceroute
- DNS monitoring
Install
You can install HttpRunner via one curl command.
$ bash -c "$(curl -ksSL https://httprunner.com/script/install.sh)"
# backup
$ bash -c "$(curl -ksSL https://httprunner.oss-cn-beijing.aliyuncs.com/install.sh)"
Then you will get a hrp CLI tool.
$ hrp -h
██╗ ██╗████████╗████████╗██████╗ ██████╗ ██╗ ██╗███╗ ██╗███╗ ██╗███████╗██████╗
██║ ██║╚══██╔══╝╚══██╔══╝██╔══██╗██╔══██╗██║ ██║████╗ ██║████╗ ██║██╔════╝██╔══██╗
███████║ ██║ ██║ ██████╔╝██████╔╝██║ ██║██╔██╗ ██║██╔██╗ ██║█████╗ ██████╔╝
██╔══██║ ██║ ██║ ██╔═══╝ ██╔══██╗██║ ██║██║╚██╗██║██║╚██╗██║██╔══╝ ██╔══██╗
██║ ██║ ██║ ██║ ██║ ██║ ██║╚██████╔╝██║ ╚████║██║ ╚████║███████╗██║ ██║
╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═══╝╚═╝ ╚═══╝╚══════╝╚═╝ ╚═╝
HttpRunner is an open source API testing tool that supports HTTP(S)/HTTP2/WebSocket/RPC
network protocols, covering API testing, performance testing and digital experience
monitoring (DEM) test types. Enjoy! ✨ 🚀 ✨
License: Apache-2.0
Website: https://httprunner.com
Github: https://github.com/httprunner/httprunner
Copyright 2021 debugtalk
Usage:
hrp [command]
Available Commands:
boom run load test with boomer
completion generate the autocompletion script for the specified shell
har2case convert HAR to json/yaml testcase files
help Help about any command
pytest run API test with pytest
run run API test with go engine
startproject create a scaffold project
Flags:
-h, --help help for hrp
--log-json set log to json format
-l, --log-level string set log level (default "INFO")
-v, --version version for hrp
Use "hrp [command] --help" for more information about a command.
Subscribe
关注 HttpRunner 的微信公众号,第一时间获得最新资讯。
如果你期望加入 HttpRunner 核心用户群,请填写用户调研问卷并留下你的联系方式,作者将拉你进群。
