from locust import HttpUser, between, taskclass WebsiteUser(HttpUser):wait_time = between(5, 15)  def on_start(self):self.client.post("/login", { "username": "test_user", "password": "" })  @task def index(self):self.client.get("/") self.client.get("/static/assets.js")  @task def about(self):self.client.get("/about/")

# This locust test script example will simulate a user # browsing the Locust documentation on https://docs.locust.ioimport randomfrom locust import HttpUser, between, taskfrom pyquery import PyQueryclass AwesomeUser(HttpUser):host = "https://docs.locust.io/en/latest/"  # we assume someone who is browsing the Locust docs,  # generally has a quite long waiting time (between  # 10 and 600 seconds), since there's a bunch of text  # on each page wait_time = between(10, 600)  def on_start(self): # start by waiting so that the simulated users  # won't all arrive at the same timeself.wait() # assume all users arrive at the index page self.index_page() self.urls_on_current_page = self.toc_urls  @task(10) def index_page(self):r = self.client.get("") pq = PyQuery(r.content) link_elements = pq(".toctree-wrapper a.internal") self.toc_urls = [ l.attrib["href"] for l in link_elements ]  @task(50) def load_page(self):url = random.choice(self.toc_urls) r = self.client.get(url) pq = PyQuery(r.content) link_elements = pq("a.internal") self.urls_on_current_page = [ l.attrib["href"] for l in link_elements ]  @task(30) def load_sub_page(self):url = random.choice(self.urls_on_current_page) r = self.client.get(url)

# An example on how to use and nest TaskSetsfrom locust import HttpUser, TaskSet, task, betweenclass ForumThread(TaskSet):passclass ForumPage(TaskSet): # wait_time can be overridden for individual TaskSetswait_time = between(10, 300)  # TaskSets can be nested multiple levels tasks = { ForumThread:3 }  @task(3) def forum_index(self):pass  @task(1) def stop(self):self.interrupt()class AboutPage(TaskSet):passclass WebsiteUser(HttpUser):wait_time = between(5, 15)  # We can specify sub TaskSets using the tasks dict tasks = { ForumPage: 20, AboutPage: 10, }  # We can use the @task decorator as well as the  # tasks dict in the same Locust/TaskSet @task(10) def index(self):pass

Example code

A fundamental feature of Locust is that you describe all your test in Python code. No need for clunky UIs or bloated XML, just plain code.

Select example

Cloud Hosted Locust

We are working on a hosted cloud version of Locust. It's the simplest way to set up large-scale load tests with detailed reporting.

Check it out at locust.cloud