One-stop solution for HTTP(S) testing.
Clone or download
Latest commit a42c582 Sep 20, 2018


LICENSE travis-ci coveralls pypi version pyversions

Httprunner is an HTTP(S) protocol-oriented universal testing framework. Write testing scripts in YAML/JSON once, you can then achieve automated testing, performance testing, online monitoring, continuous integration and other testing needs.

Former name: ApiTestEngine.

Design Philosophy

  • Take full reuse of Python's existing powerful libraries: Requests, unittest and Locust.
  • Convention over configuration.
  • Pursuit of high rewards, write once and achieve a variety of testing needs

Key Features

  • Inherit all powerful features of Requests, just have fun to handle HTTP(S) in human way.
  • Define testcases in YAML or JSON format in concise and elegant manner.
  • Record and generate testcases with HAR support. see har2case.
  • Supports function/variable/extract/validate mechanisms to create full test scenarios.
  • Supports perfect hook mechanism.
  • With plugin, module functions can be auto-discovered in recursive upward directories.
  • Testcases can be run in diverse ways, with single testset, multiple testsets, or entire project folder.
  • Test report is concise and clear, with detailed log records.
  • With reuse of Locust, you can run performance test without extra work.
  • CLI command supported, perfect combination with CI/CD.


HttpRunner is rich documented.


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