/locust-runner

A helper for locust to allow users to build Locust tests using a YAML file.

Primary LanguagePythonMIT LicenseMIT

Locust Runner

Travis GitHub tag GitHub last commit license

locust-runner is a helper for locust to allow users to build Locust tests using a YAML file.

What does it do?

locust is a great library to build load testing with plenty of features, but sometimes you just want to run a simple load test without writing a bunch of code. The locust-runner allows you to run a simple load test with a YAML file and without any code writing.

How do I use it?

Check out the code and update the config.yaml. There is a sample config file already ready for you. You should be able to update that file to get you going. Once you have modified the config.yaml to match your need, run locust with locust_runner/runner.py as your locust file and with options that you like.

$ locust -f locust_runner/runner.py --no-web -c 1 -r 1 -t 10s --only-summary

How do I contribute?

We welcome your contribution! Check out CONTRIBUTING.md.