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 用户调研问卷 持续收集中，我们将基于用户反馈动态调整产品特性和需求优先级。

CHANGELOG | 中文

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/hooks mechanisms to create extremely complex test scenarios.
• Data driven with parameterize mechanism, 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 plugin mechanism, support hashicorp plugin and go plugin.
• Generate html reports with rich test results.
• Using it as a CLI tool or a library are both supported.

Load Testing

Base on the API testing testcases, you can run professional load testing without extra work.

• Inherit all powerful features of locust and boomer.
• Report performance metrics to prometheus pushgateway.
• Use transaction to define a set of end-user actions that represent the real user activities.
• Use rendezvous points 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.
• ping indicators 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)"

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 2017 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 核心用户群，请填写用户调研问卷并留下你的联系方式，作者将拉你进群。