• Locust Website: locust.io
• Locust Documentation: docs.locust.io

Boomer is a better load generator for locust, written in golang. It can spawn thousands of goroutines to run your code concurrently.

It will listen and report to the locust master automatically, your test results will be displayed on the master's web UI.

go get github.com/myzhan/boomer

WARNING: Since version 0.8, locust has removed old socket implementation for master/slave communication. If you are using locust 0.8 or later, you have to build boomer with zeromq support. Or you should use locust before 0.8.

Install goczmq by following its installation guide, and build boomer with zeromq support. Once you build boomer with zeromq support, both zeromq socket and tcp socket are supported. We add an additional command line option "--rpc", which defaults to "zeromq". "--rpc=socket" will switch to tcp socket.

If you are new to boomer, and want to give it a try as fast as you can. You can build boomer without zeromq support.

Below is a example of boomer's API. You can find more in "examples" directory.

package main


import "github.com/myzhan/boomer"
import "time"


func foo(){
    time.Sleep(100 * time.Millisecond)
    /*
    Report your test result as a success, if you write it in locust, it will looks like this
    events.request_success.fire(request_type="http", name="foo", response_time=100.0, response_length=10)
    */
    boomer.Events.Publish("request_success", "http", "foo", 100.0, int64(10))
}


func bar(){
    time.Sleep(100 * time.Millisecond)
    /*
    Report your test result as a failure, if you write it in locust, it will looks like this
    events.request_failure.fire(request_type="udp", name="bar", response_time=100.0, exception=Exception("udp error"))
    */
    boomer.Events.Publish("request_failure", "udp", "bar", 100.0, "udp error")
}


func main(){

    task1 := &boomer.Task{
        Name: "foo",
        Weight: 10,
        Fn: foo,
    }

    task2 := &boomer.Task{
        Name: "bar",
        Weight: 20,
        Fn: bar,
    }

    boomer.Run(task1, task2)

}

For debug purpose, you can run tasks without connecting to the master.

go build -o a.out main.go
./a.out --run-tasks foo,bar

If master is listening on zeromq socket.

locust -f dummy.py --master --master-bind-host=127.0.0.1 --master-bind-port=5557
# build boomer with zeromq support
go build -tags 'zeromq' -o a.out main.go 
./a.out --master-host=127.0.0.1 --master-port=5557 --rpc=zeromq

If master is listening on tcp socket.

locust -f dummy.py --master --master-bind-host=127.0.0.1 --master-bind-port=5557
go build -o a.out main.go
./a.out --master-host=127.0.0.1 --master-port=5557

So far, dummy.py is necessary when starting a master, because locust needs such a file.

Don't worry, dummy.py has nothing to do with your test.

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