mirror of
https://github.com/httprunner/httprunner.git
synced 2026-05-14 06:37:36 +08:00
61 lines
3.2 KiB
Markdown
61 lines
3.2 KiB
Markdown
|
|
# HttpRunner
|
|
|
|
[](https://pepy.tech/project/httprunner)
|
|
[](https://travis-ci.org/httprunner/httprunner)
|
|
[](https://coveralls.io/github/HttpRunner/HttpRunner?branch=master)
|
|
[](https://pypi.python.org/pypi/httprunner)
|
|
[](https://pypi.python.org/pypi/httprunner)
|
|
[](https://testerhome.com/github_statistics)
|
|
|
|
*HttpRunner* is a simple & elegant, yet powerful HTTP(S) testing framework. Enjoy! ✨ 🚀 ✨
|
|
|
|
## Design Philosophy
|
|
|
|
- Embrace open source, stand on giants' shoulders, like [`Requests`][Requests], [`unittest`][unittest] and [`Locust`][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`][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`][HAR] support. see [`har2case`][har2case].
|
|
- Supports `variables`/`extract`/`validate` mechanisms to create full test scenarios.
|
|
- Supports perfect hook mechanism.
|
|
- With `debugtalk.py` plugin, very easy to implement complex logic in testcase.
|
|
- Testcases can be run in diverse ways, with single testcase, multiple testcases, or entire project folder.
|
|
- Test report is concise and clear, with detailed log records.
|
|
- With reuse of [`Locust`][Locust], you can run performance test without extra work.
|
|
- CLI command supported, perfect combination with `CI/CD`.
|
|
|
|
## Documentation
|
|
|
|
HttpRunner is rich documented.
|
|
|
|
- [`中文用户使用手册`][user-docs-zh]
|
|
- [`开发历程记录博客`][development-blogs]
|
|
|
|
## How to Contribute
|
|
|
|
1. Check for [open issues](https://github.com/httprunner/httprunner/issues) or [open a fresh issue](https://github.com/httprunner/httprunner/issues/new/choose) to start a discussion around a feature idea or a bug.
|
|
2. Fork [the repository](https://github.com/httprunner/httprunner) on GitHub to start making your changes to the **master** branch (or branch off of it). You also need to comply with the [development rules](https://github.com/httprunner/docs/blob/master/en/docs/dev-rules.md).
|
|
3. Write a test which shows that the bug was fixed or that the feature works as expected.
|
|
4. Send a pull request, you will then become a [contributor](https://github.com/httprunner/httprunner/graphs/contributors) after it gets merged and published.
|
|
|
|
## Subscribe
|
|
|
|
关注 HttpRunner 的微信公众号，第一时间获得最新资讯。
|
|
|
|
|
|
|
|
[Requests]: http://docs.python-requests.org/en/master/
|
|
[unittest]: https://docs.python.org/3/library/unittest.html
|
|
[Locust]: http://locust.io/
|
|
[har2case]: https://github.com/httprunner/har2case
|
|
[user-docs-zh]: http://cn.httprunner.org/
|
|
[development-blogs]: http://debugtalk.com/tags/httprunner/
|
|
[HAR]: http://httparchive.org/
|
|
[Swagger]: https://swagger.io/
|
|
|