You want to contribute to Locust? Great! Here is a list of open bugs/feature requests.
Fork Locust on Github and then run
$ git clone git://github.com/<YourName>/locust.git # clone the repo
$ pip3 install -e locust/ # install in editable mode
Now the locust
command will run your code with no need for reinstalling after making changes.
If you want to contribute back to us, make a branch in your repo, push your changes there and then open a PR on github. Before you open a pull request, make sure the tests work. And if you are adding a feature, make sure it is documented.
To be able to run Locust's test on different Python versions we use tox. You can install tox by running:
pip3 install tox
Then you can run the tests by just invoking tox in the Locust project root directory:
tox
To build the documentation you first need to install the required PyPI packages. You can do that by running the following command in the Locust project's root directory:
pip3 install -r docs/requirements.txt
Then you can build the documentation locally using:
make build_docs
Then the documentation should be build and available at docs/_build/index.html
The CSS styling for Locust's user interface is written in SASS.
In order to make changes to the CSS rules, you need to have SASS installed
and available on your PATH
.
Once you have SASS installed you can have the command line sass program compile the Locust .sass
files
by running the following in the locust project's root path:
make sass_build
Or you can make sass watch for changes to the .sass
files and automatically generate new CSS files by running:
make sass_watch
The CSS files that are generated by SASS should be checked into version control.