Locust Documentation

About locust

Locust is a scalable load testing framework written in Python

• Website: https://locust.io/

• Source code: https://github.com/locustio/locust

• Twitter: @locustio

Getting started

• What is Locust?
  • Features
  • Name & background
  • Authors
  • License
• Installation
  • Bleeding edge version
• Quick start
  • Example locustfile.py
  • Start Locust
  • Locust’s web interface
  • More options
    • How to write a real locust file?

Writing Locust tests

• Writing a locustfile
  • User class
  • Tasks
  • Events
  • HttpUser class
  • TaskSets
  • How to structure your test code

Running your Locust tests

• Configuration
• Running Locust distributed
• Running Locust with Docker
• Running Locust without the web UI
• Increase Locust’s performance with a faster HTTP client

Other functionalities

• Generating a custom load shape
  • Example
• Retrieve test statistics in CSV format
• Testing other systems using custom clients
  • Example: writing an XML-RPC User/client
• Extending Locust using event hooks
  • Request context
  • Adding Web Routes
  • Extending Web UI
  • Run a background greenlet
  • More examples
• Logging
  • Options
  • Locust loggers
• Using Locust as a library
  • Full example

Further reading / knowledgebase

• Developing Locust itself
• Further reading / knowledgebase

API

• API
  • User class
  • HttpUser class
  • TaskSet class
  • task decorator
  • tag decorator
  • SequentialTaskSet class
  • Built in wait_time functions
  • HttpSession class
  • Response class
  • ResponseContextManager class
  • Exceptions
  • Environment class
  • Event hooks
    • EventHook class
  • Runner classes
  • Web UI class

Changelog

• Changelog Highlights
  • 1.5.1
  • 1.5.0
  • 1.4.4
  • 1.4.3
  • 1.4.2
  • 1.4.1
  • 1.4.0
  • 1.3.2
  • 1.3.1
  • 1.3.0
  • 1.2.3
  • 1.2.2
  • 1.2.1
  • 1.2
  • 1.1.1
  • 1.1
  • 1.0.3
  • 1.0.2
  • 1.0, 1.0.1
  • 0.14.6
  • 0.14.0
  • 0.13.5
  • 0.13.4
  • 0.13.3
  • 0.13.2
  • 0.13.1
  • 0.13.0
  • 0.12.2
  • 0.12.1
  • 0.10.0
  • 0.9.0
  • 0.8.1
  • 0.8
  • 0.7.5
  • 0.7.4
  • 0.7.3
  • 0.7.2
  • 0.7.1
  • 0.7
  • 0.6.2
  • 0.6.1
  • 0.6
  • 0.5.1
  • 0.5
  • 0.4