Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/httprunner/httprunner

HttpRunner 是一个开源的 API/UI 测试工具，简单易用，功能强大，具有丰富的插件化机制和高度的可扩展能力。
https://github.com/httprunner/httprunner

adb api-testing benchmarking boomer curl httprunner httptest jmeter load-testing locust performance-testing pytest requests testing ui-testing wda

Last synced: 3 days ago
JSON representation

HttpRunner 是一个开源的 API/UI 测试工具，简单易用，功能强大，具有丰富的插件化机制和高度的可扩展能力。

Host: GitHub
URL: https://github.com/httprunner/httprunner
Owner: httprunner
License: apache-2.0
Created: 2017-06-13T03:54:29.000Z (over 7 years ago)
Default Branch: master
Last Pushed: 2024-08-09T08:02:00.000Z (4 months ago)
Last Synced: 2024-10-29T10:31:01.512Z (about 1 month ago)
Topics: adb, api-testing, benchmarking, boomer, curl, httprunner, httptest, jmeter, load-testing, locust, performance-testing, pytest, requests, testing, ui-testing, wda
Language: Go
Homepage: https://httprunner.com/httprunner/
Size: 35.4 MB
Stars: 4,056
Watchers: 154
Forks: 1,282
Open Issues: 511
Metadata Files:
- Readme: README.en.md
- License: LICENSE

Awesome Lists containing this project

awesome-fancy-toolkit - Http/Https测试框架, httprunner
awesome-locust - httprunner - A HTTP/S testing framework with reuse of Locust. (Tools / Frameworks)
awesome-python-testing - HttpRunner - is a simple & elegant, yet powerful HTTP(S) testing framework. (Rest API Testing)
awesome-pydantic - HttpRunner - HttpRunner is a simple & elegant, yet powerful HTTP(S) testing framework. (Utilities)
awesome-pydantic - HttpRunner - HttpRunner is a simple & elegant, yet powerful HTTP(S) testing framework. (Utilities)
best-of-web-python - GitHub - 38% open · ⏱️ 24.01.2024): (Web Testing)

README

        # HttpRunner

[![Github Actions](https://github.com/httprunner/httprunner/actions/workflows/unittest.yml/badge.svg)](https://github.com/httprunner/httprunner/actions)

[![codecov](https://codecov.io/gh/httprunner/httprunner/branch/master/graph/badge.svg)](https://codecov.io/gh/httprunner/httprunner)

[![Go Reference](https://pkg.go.dev/badge/github.com/httprunner/httprunner.svg)](https://pkg.go.dev/github.com/httprunner/httprunner)

[![downloads](https://pepy.tech/badge/httprunner)](https://pepy.tech/project/httprunner)

[![pypi version](https://img.shields.io/pypi/v/httprunner.svg)](https://pypi.python.org/pypi/httprunner)

[![pyversions](https://img.shields.io/pypi/pyversions/httprunner.svg)](https://pypi.python.org/pypi/httprunner)

[![TesterHome](https://img.shields.io/badge/TTF-TesterHome-2955C5.svg)](https://testerhome.com/github_statistics)

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

![flow chart](https://httprunner.com/image/hrp-flow.jpg)

[CHANGELOG] | [中文]

## Key Features

### API Testing

- [x] Full support for HTTP(S)/1.1 and HTTP/2 requests.

- [ ] Support more protocols, WebSocket, TCP, RPC etc.

- [x] Testcases can be described in multiple formats, `YAML`/`JSON`/`Golang`, and they are interchangeable.

- [x] Use Charles/Fiddler/Chrome/etc to record HTTP requests and generate testcases from exported [`HAR`][HAR].

- [x] Supports `variables`/`extract`/`validate`/`hooks` mechanisms to create extremely complex test scenarios.

- [x] 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.

- [x] Create and call custom functions with `plugin` mechanism, support [hashicorp plugin] and [go plugin].

- [x] Generate html reports with rich test results.

- [x] 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.

- [x] Inherit all powerful features of [`locust`][locust] and [`boomer`][boomer].

- [x] Report performance metrics to [prometheus pushgateway][pushgateway].

- [x] Use `transaction` to define a set of end-user actions that represent the real user activities.

- [x] Use `rendezvous` points to force Vusers to perform tasks concurrently during test execution.

- [x] 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

$ bash -c "$(curl -ksSL https://httprunner.com/script/install.sh)"

```

Then you will get a `hrp` CLI tool.

```text

$ 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:

  adb          simple utils for android device management

  boom         run load test with boomer

  build        build plugin for testing

  completion   Generate the autocompletion script for the specified shell

  convert      convert multiple source format to HttpRunner JSON/YAML/gotest/pytest cases

  help         Help about any command

  ios          simple utils for ios device management

  pytest       run API test with pytest

  run          run API test with go engine

  startproject create a scaffold project

  wiki         visit https://httprunner.com

Flags:

  -h, --help               help for hrp

      --log-json           set log to json format

  -l, --log-level string   set log level (default "INFO")

      --venv string        specify python3 venv path

  -v, --version            version for hrp

Use "hrp [command] --help" for more information about a command.

```

## User Cases









## Sponsor

[](https://qrcode.testing-studio.com/f?from=HttpRunner&url=https://testing-studio.com/)

> 霍格沃兹测试开发学社是中国软件测试开发高端教育品牌，产品由国内顶尖软件测试开发技术专家携手打造，为企业与个人提供专业的技能培训与咨询、测试工具与测试平台、测试外包与测试众包服务。领域涵盖 App/Web 自动化测试、接口自动化测试、性能测试、安全测试、持续交付/DevOps、测试左移、测试右移、精准测试、测试平台开发、测试管理等方向。-> [**联系我们**](http://qrcode.testing-studio.com/f?from=HttpRunner&url=https://ceshiren.com/t/topic/23745)

## Subscribe

关注 HttpRunner 的微信公众号，第一时间获得最新资讯。



[HttpRunner]: https://github.com/httprunner/httprunner

[boomer]: https://github.com/myzhan/boomer

[locust]: https://github.com/locustio/locust

[jmespath]: https://jmespath.org/

[allure]: https://docs.qameta.io/allure/

[HAR]: http://httparchive.org/

[hashicorp plugin]: https://github.com/hashicorp/go-plugin

[go plugin]: https://pkg.go.dev/plugin

[CHANGELOG]: docs/CHANGELOG.md

[pushgateway]: https://github.com/prometheus/pushgateway

[survey]: https://wj.qq.com/s2/9699514/0d19/

[中文]: README.md