Go to file
lilong.129 3c077bf555 change: update README 2025-04-08 00:23:44 +08:00
.github fix: hrp path 2025-03-07 23:13:08 +08:00
cmd feat: add GitCommit/GitBranch/BuildTime in version info 2025-03-17 20:40:03 +08:00
code fix: check LLM env 2025-03-19 22:28:42 +08:00
convert fix: convert tests 2025-03-05 22:28:46 +08:00
docs refactor: move hrp/ to root folder 2025-02-06 11:03:41 +08:00
examples refactor: move uixt pkg 2025-03-05 11:04:02 +08:00
internal change: update README 2025-04-08 00:23:44 +08:00
pkg change: use context to contral ScreenRecord timeout or cancel 2025-03-06 22:16:49 +08:00
scripts feat: add GitCommit/GitBranch/BuildTime in version info 2025-03-17 20:40:03 +08:00
server refactor: move uixt ext to EvalTools 2025-03-14 10:55:46 +08:00
tests change: AIAssert 2025-03-25 14:33:07 +08:00
uixt refactor: LoadEnv 2025-03-31 14:54:58 +08:00
.gitignore feat: add ui-tars planner 2025-03-19 00:09:16 +08:00
Dockerfile change: update for v4.1.2 2022-06-09 23:50:04 +08:00
LICENSE update licence 2018-12-17 18:40:26 +08:00
Makefile feat: add git author for build info 2025-03-31 11:03:30 +08:00
README.en.md change: update README 2025-04-08 00:23:44 +08:00
README.md change: update README 2025-04-08 00:23:44 +08:00
build.go refactor: move tests 2025-03-05 11:47:08 +08:00
compat.go refactor: move uixt pkg 2025-03-05 11:04:02 +08:00
config.go refactor: move tests 2025-03-05 11:47:08 +08:00
go.mod feat: add TapByLLM/PlanNextAction for XTDriver 2025-03-19 21:16:21 +08:00
go.sum feat: add TapByLLM/PlanNextAction for XTDriver 2025-03-19 21:16:21 +08:00
loader.go refactor: LoadEnv 2025-03-31 14:54:58 +08:00
logger.go refactor: move hrp/ to root folder 2025-02-06 11:03:41 +08:00
parameters.go refactor: move tests 2025-03-05 11:47:08 +08:00
parser.go refactor: move tests 2025-03-05 11:47:08 +08:00
parser_test.go fix: unittests 2025-03-05 22:08:03 +08:00
plugin.go fix: init plugin 2025-03-05 19:39:18 +08:00
runner.go refactor: move tests 2025-03-05 11:47:08 +08:00
step.go refactor: move uixt pkg 2025-03-05 11:04:02 +08:00
step_api.go refactor: move hrp/ to root folder 2025-02-06 11:03:41 +08:00
step_function.go refactor: move tests 2025-03-05 11:47:08 +08:00
step_rendezvous.go refactor: move hrp/ to root folder 2025-02-06 11:03:41 +08:00
step_request.go refactor: move tests 2025-03-05 11:47:08 +08:00
step_request_response.go refactor: move hrp/ to root folder 2025-02-06 11:03:41 +08:00
step_shell.go refactor: move hrp/ to root folder 2025-02-06 11:03:41 +08:00
step_testcase.go refactor: move hrp/ to root folder 2025-02-06 11:03:41 +08:00
step_thinktime.go refactor: move tests 2025-03-05 11:47:08 +08:00
step_transaction.go refactor: move hrp/ to root folder 2025-02-06 11:03:41 +08:00
step_ui.go change: AIAssert 2025-03-25 14:33:07 +08:00
step_websocket.go fix: websocket 2025-03-05 18:11:00 +08:00
summary.go refactor: move uixt pkg 2025-03-05 11:04:02 +08:00
testcase.go refactor: LoadEnv 2025-03-31 14:54:58 +08:00

README.en.md

HttpRunner

Github Actions codecov Go Reference downloads TesterHome

⚠️ HttpRunner v5 only includes the Golang version, and the Python version of the code has been migrated to httprunner/httprunner.py

HttpRunner (also known as hrp) is an open-source testing framework that was born in 2017. Initially, it was used for API interface and performance testing, and later evolved into a versatile and extensible testing framework.

In 2022, HttpRunner began to support UI automation testing, currently supporting multiple system platforms such as Android/iOS/Harmony/Browser, and integrated large model technology in v5.

Compared to other UI automation frameworks, HttpRunner's main features include:

  • Pure visual-driven solution (OCR/CV/LLM), pursuing universality and minimal performance loss
  • Unified API across multiple platforms, reducing learning and horizontal expansion costs
  • Embracing the open-source ecosystem, fully reusing open-source components

Usage

$ hrp -h

██╗  ██╗████████╗████████╗██████╗ ██████╗ ██╗   ██╗███╗   ██╗███╗   ██╗███████╗██████╗
██║  ██║╚══██╔══╝╚══██╔══╝██╔══██╗██╔══██╗██║   ██║████╗  ██║████╗  ██║██╔════╝██╔══██╗
███████║   ██║      ██║   ██████╔╝██████╔╝██║   ██║██╔██╗ ██║██╔██╗ ██║█████╗  ██████╔╝
██╔══██║   ██║      ██║   ██╔═══╝ ██╔══██╗██║   ██║██║╚██╗██║██║╚██╗██║██╔══╝  ██╔══██╗
██║  ██║   ██║      ██║   ██║     ██║  ██║╚██████╔╝██║ ╚████║██║ ╚████║███████╗██║  ██║
╚═╝  ╚═╝   ╚═╝      ╚═╝   ╚═╝     ╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═══╝╚══════╝╚═╝  ╚═╝

HttpRunner: Enjoy your All-in-One Testing Solution ✨ 🚀 ✨

💡 Simple Yet Powerful
   - Natural language driven test scenarios powered by LLM
   - User-friendly SDK API with IDE auto-completion
   - Intuitive GoTest/YAML/JSON/Text testcase format

📌 Comprehensive Testing Capabilities
   - UI Automation: Android/iOS/Harmony/Browser
   - API Testing: HTTP(S)/HTTP2/WebSocket/RPC
   - Load Testing: run API testcase concurrently with boomer

🧩 High Scalability
   - Plugin system for custom functions
   - Distributed testing support
   - Cross-platform: macOS/Linux/Windows

🛠 Easy Integration
   - CI/CD friendly with JSON logs and HTML reports
   - Rich ecosystem tools

Learn more:
Website: https://httprunner.com
GitHub: https://github.com/httprunner/httprunner

Copyright © 2017-present debugtalk. Apache-2.0 License.

Usage:
  hrp [command]

Available Commands:
  adb          simple utils for android device management
  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
  server       start hrp server
  startproject create a scaffold project
  wiki         visit https://httprunner.com

Flags:
  -h, --help               help for hrp
      --log-json           set log to json format (default colorized console)
  -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

Subscribe

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

HttpRunner