Skip to main content

Extensions for locustio

Project description


Locust Links


Easy-Locust is an extension tool for Locust. With this tool, you don't need to write locust scripts. What you need to do is just to edit Excel. Easy-Locust will generate locustfile automatically and run it.

If you need master-slave mode, you just need to fill Excel Sheet 'Slave', and use --master. The only precondition is to install the same version locustio in each Slave. Easy-Locust is not necessary for slaves.

easy-locust --web --web-port=8899 -- Run in web mode, you can config and trigger slave-nodes with this mode.

Use easy-locust --demo to generate an Excel demo, fill it and start your test.

Same parameters with locust, so I just introduce the different parameters here:

easy-locust -f xxx.xls -- This will transform Excel to locustfile, and run it. You can also use -f

easy-locust --xf xxx.xls -- -- This just transform Excel to locustfile, will not start test.

easy-locust -f xxx.xls --master -d -- -d is distributed mode, can automatically run slaves. There is one precondition, you need write slaves information in Excel at Slave Sheet.

easy-locust -f xxx.xls --master -d --boomer -- --boomer running boomer client in slaves, which is compiling by Golang. In this mode expect_code and expect_str is inoperative. Please keep port 9999 is unused in each slave, when using this mode.

OR, use:

import easy_locust

data = {
    "config": {},
    "apis": [],
    "auth": {},
    "user_info": [],
    "master_ip": "",
    "slaves": []

locustfile_str = easy_locust.factory(data)

Bug reporting

Open a Github issue and follow the template listed there.


  • Guo Tengda


Open source licensed under the MIT license (see LICENSE file for details).

Change Log

  • 0.2.1: Easy-locust web mode.
  • 0.1.12: content-type support.
  • 0.1.11: Add boomer client as slave, which has much more preformance.
  • 0.1.10: Delete useless code.
  • 0.1.9: Support Json to locustfile. And can use easy_locust.factory(dict) to get strings of locustfile.
  • 0.1.6: Optimize
  • 0.1.5: Check Response info (status code & expect str) if set "Expect Status Code" in Excel, otherwise not. Rely on locustio>=0.13.5

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for easy-locust, version
Filename, size File type Python version Upload date Hashes
Filename, size easy_locust- (11.5 MB) File type Wheel Python version py3 Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page