Go to file
余泓铮 184527d04f Merge branch 'fix-v5' into 'master'
Fix v5

See merge request iesqa/httprunner!121
2025-07-09 03:07:29 +00:00
.github chore: update Go version in CI workflow to 1.23.x 2025-06-28 22:10:37 +08:00
cmd feat: add auto popup handler configuration for HRPRunner 2025-06-27 12:13:13 +08:00
code fix: add direction parameter support for scroll operations in UI-TARS parser 2025-06-10 16:40:10 +08:00
convert refactor: replace OpenFile with Open 2025-05-07 16:40:39 +08:00
docs feat: add time limit for StartToGoal 2025-07-04 14:23:09 +08:00
examples change: update game examples 2025-07-06 10:38:50 +08:00
internal feat: support max retry times option for driver session 2025-07-09 10:35:43 +08:00
mcphost change: upgrade eino sdk 2025-07-03 21:47:45 +08:00
pkg fix: improve package running check and enhance logging in UIA2Driver 2025-06-28 10:17:09 +08:00
scripts change: update install script 2025-06-28 21:32:12 +08:00
server Merge branch 'session_refactor' into 'master' 2025-06-30 11:10:35 +00:00
tests fix: wda offset error by scale 2025-07-02 22:03:40 +08:00
uixt feat: support max retry times option for driver session 2025-07-09 10:35:43 +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 update docs 2025-06-28 21:00:48 +08:00
README.en.md update docs 2025-06-28 21:00:48 +08:00
README.md update docs 2025-06-28 21:00:48 +08:00
build.go refactor: move tests 2025-03-05 11:47:08 +08:00
compat.go refactor: move action options 2025-05-25 00:15:18 +08:00
config.go fix: dump summary with original variables for security 2025-07-03 22:48:39 +08:00
go.mod change: replace openai model with ark model 2025-07-03 22:13:23 +08:00
go.sum change: replace openai model with ark model 2025-07-03 22:13:23 +08:00
loader.go refactor: LoadEnv 2025-03-31 14:54:58 +08:00
logger.go feat: add GetResultsPath() 2025-07-02 21:21:21 +08:00
parameters.go feat: add parameterization support for test cases and steps with configuration options 2025-06-23 21:34:18 +08:00
parser.go change: log message 2025-07-07 22:38:58 +08:00
parser_test.go refactor: move mcphost package to top level 2025-05-17 11:55:26 +08:00
plugin.go fix: init plugin 2025-03-05 19:39:18 +08:00
report.go fix: display ai assert in html report 2025-07-06 11:08:52 +08:00
runner.go refactor: add WDA/UIA logs to summary 2025-07-04 14:32:23 +08:00
runner_uixt.go refactor: setup browser session 2025-07-01 20:51:34 +08:00
step.go change: remove unused step identifier 2025-07-03 19:29:46 +08:00
step_api.go refactor: move hrp/ to root folder 2025-02-06 11:03:41 +08:00
step_function.go fix: update StartTime to use UnixMilli for better precision across step functions 2025-06-18 13:51:44 +08:00
step_rendezvous.go fix: update step failed in ParseStep 2025-06-18 11:31:28 +08:00
step_request.go feat: add parameterization support for test cases and steps with configuration options 2025-06-23 21:34:18 +08:00
step_request_response.go refactor: move hrp/ to root folder 2025-02-06 11:03:41 +08:00
step_shell.go fix: update StartTime to use UnixMilli for better precision across step functions 2025-06-18 13:51:44 +08:00
step_testcase.go fix: update StartTime to use UnixMilli for better precision across step functions 2025-06-18 13:51:44 +08:00
step_thinktime.go fix: 修复 StartToGoal 命令无法通过 CTRL+C 中断的问题 2025-06-05 20:00:20 +08:00
step_transaction.go fix: 修复 StartToGoal 命令无法通过 CTRL+C 中断的问题 2025-06-05 20:00:20 +08:00
step_ui.go fix: display ai assert in html report 2025-07-06 11:08:52 +08:00
step_websocket.go fix: update StartTime to use UnixMilli for better precision across step functions 2025-06-18 13:51:44 +08:00
summary.go fix: display ai assert in html report 2025-07-06 11:08:52 +08:00
testcase.go fix: 修复移动端步骤包含 validate 时验证器不执行的问题 2025-06-06 22:18:43 +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, becoming a universal intelligent automation testing framework.

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

  • Pure visual-driven solution (OCR/CV/VLM), 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
  • Golang technology stack, binary distribution deployment

HttpRunner v5 用户指南(更新中) HttpRunner DeepWiki

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
  mcp-server   Start MCP server for UI automation
  mcphost      Start a chat session to interact with MCP tools
  pytest       Run API test with pytest
  report       Generate HTML report from test results
  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