Locust4j
Links
- Locust Website: locust.io
- Locust Documentation: docs.locust.io
Description
Locust4j is a load generator for locust, written in Java. It’s inspired by boomer and nomadacris.
Features
-
Write user test scenarios in Java
Because it’s written in Java, you can use all the things in the Java Ecosystem. -
Thread-based concurrency
Locust4j uses threadpool to execute your code with low overhead.
Build
git clone https://github.com/myzhan/locust4j
cd locust4j
mvn package
Run BuiltIn Example
# start locust master
locust -f dummy.py --master --master-bind-host=127.0.0.1 --master-bind-port=5557
# start Locust4j
java -cp target/locust4j-1.0-SNAPSHOT-jar-with-dependencies.jar com.github.myzhan.locust4j.examples.Main
Maven
Add this to your Maven project’s pom.xml.
<dependency>
<groupId>com.github.myzhan</groupId>
<artifactId>locust4j</artifactId>
<version>1.0.0</version>
</dependency>
More Examples
See Main.java.
This file represents all the exposed APIs of Locust4j.
Author
- myzhan
- vrajat
Known Issues
- When stop-the-world happens in the JVM, you may get wrong response time reported to the master.
- Because of the JIT compiler, Locust4j will run faster as time goes by, which will lead to shorter response time.
TODO
- Add more tests.
- Add more documentations.
License
Open source licensed under the MIT license (see LICENSE file for details).