Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
18 changed files
with
2,295 additions
and
2,295 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Original file line | Diff line number | Diff line change |
---|---|---|---|
@@ -1,2 +1,2 @@ | |||
recursive-include locust/static * | recursive-include locust/static * | ||
recursive-include locust/templates * | recursive-include locust/templates * |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Original file line | Diff line number | Diff line change |
---|---|---|---|
@@ -1,78 +1,78 @@ | |||
### | ### | ||
API | API | ||
### | ### | ||
|
|
||
|
|
||
Locust class | Locust class | ||
============ | ============ | ||
|
|
||
.. autoclass:: locust.core.Locust | .. autoclass:: locust.core.Locust | ||
:members: min_wait, max_wait, task_set | :members: min_wait, max_wait, task_set | ||
|
|
||
HttpLocust class | HttpLocust class | ||
================ | ================ | ||
|
|
||
.. autoclass:: locust.core.HttpLocust | .. autoclass:: locust.core.HttpLocust | ||
:members: min_wait, max_wait, task_set, client | :members: min_wait, max_wait, task_set, client | ||
|
|
||
|
|
||
TaskSet class | TaskSet class | ||
============= | ============= | ||
|
|
||
.. autoclass:: locust.core.TaskSet | .. autoclass:: locust.core.TaskSet | ||
:members: locust, parent, min_wait, max_wait, client, tasks, interrupt, schedule_task | :members: locust, parent, min_wait, max_wait, client, tasks, interrupt, schedule_task | ||
|
|
||
task decorator | task decorator | ||
============== | ============== | ||
|
|
||
.. autofunction:: locust.core.task | .. autofunction:: locust.core.task | ||
|
|
||
|
|
||
HttpSession class | HttpSession class | ||
================= | ================= | ||
|
|
||
.. autoclass:: locust.clients.HttpSession | .. autoclass:: locust.clients.HttpSession | ||
:members: __init__, request, get, post, delete, put, head, options, patch | :members: __init__, request, get, post, delete, put, head, options, patch | ||
|
|
||
Response class | Response class | ||
============== | ============== | ||
|
|
||
This class actually resides in the `python-requests <http://python-requests.org>`_ library, | This class actually resides in the `python-requests <http://python-requests.org>`_ library, | ||
since that's what Locust is using to make HTTP requests, but it's included in the API docs | since that's what Locust is using to make HTTP requests, but it's included in the API docs | ||
for locust since it's so central when writing locust load tests. You can also look at the | for locust since it's so central when writing locust load tests. You can also look at the | ||
:py:class:`Response <requests.Response>` class at the | :py:class:`Response <requests.Response>` class at the | ||
`requests documentation <http://python-requests.org>`_. | `requests documentation <http://python-requests.org>`_. | ||
|
|
||
.. autoclass:: requests.Response | .. autoclass:: requests.Response | ||
:inherited-members: | :inherited-members: | ||
:noindex: | :noindex: | ||
|
|
||
ResponseContextManager class | ResponseContextManager class | ||
============================ | ============================ | ||
|
|
||
.. autoclass:: locust.clients.ResponseContextManager | .. autoclass:: locust.clients.ResponseContextManager | ||
:members: success, failure | :members: success, failure | ||
|
|
||
|
|
||
InterruptTaskSet Exception | InterruptTaskSet Exception | ||
========================== | ========================== | ||
.. autoexception:: locust.exception.InterruptTaskSet | .. autoexception:: locust.exception.InterruptTaskSet | ||
|
|
||
|
|
||
.. _events: | .. _events: | ||
|
|
||
Event hooks | Event hooks | ||
=========== | =========== | ||
|
|
||
The event hooks are instances of the **locust.events.EventHook** class: | The event hooks are instances of the **locust.events.EventHook** class: | ||
|
|
||
.. autoclass:: locust.events.EventHook | .. autoclass:: locust.events.EventHook | ||
|
|
||
Available hooks | Available hooks | ||
--------------- | --------------- | ||
|
|
||
The following event hooks are available under the **locust.events** module: | The following event hooks are available under the **locust.events** module: | ||
|
|
||
.. automodule:: locust.events | .. automodule:: locust.events | ||
:members: request_success, request_failure, locust_error, report_to_master, slave_report, hatch_complete, quitting | :members: request_success, request_failure, locust_error, report_to_master, slave_report, hatch_complete, quitting | ||
|
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Original file line | Diff line number | Diff line change |
---|---|---|---|
@@ -1,26 +1,26 @@ | |||
===================== | ===================== | ||
Locust Documentation | Locust Documentation | ||
===================== | ===================== | ||
|
|
||
.. rubric:: Everything you need to know about Locust | .. rubric:: Everything you need to know about Locust | ||
|
|
||
.. sidebar:: About locust | .. sidebar:: About locust | ||
|
|
||
Locust is a scalable load testing framework written in Python | Locust is a scalable load testing framework written in Python | ||
|
|
||
* **Website**: `http://locust.io <http://locust.io>`_ | * **Website**: `http://locust.io <http://locust.io>`_ | ||
* **Source code**: `http://github.com/locustio/locust <http://github.com/locustio/locust>`_ | * **Source code**: `http://github.com/locustio/locust <http://github.com/locustio/locust>`_ | ||
* **Twitter**: `@locustio <http://twitter.com/locustio>`_ | * **Twitter**: `@locustio <http://twitter.com/locustio>`_ | ||
|
|
||
|
|
||
.. toctree :: | .. toctree :: | ||
:maxdepth: 2 | :maxdepth: 2 | ||
what-is-locust | what-is-locust | ||
installation | installation | ||
quickstart | quickstart | ||
writing-a-locustfile | writing-a-locustfile | ||
api | api | ||
extending-locust | extending-locust | ||
changelog | changelog | ||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Original file line | Diff line number | Diff line change |
---|---|---|---|
@@ -1,53 +1,53 @@ | |||
Installation | Installation | ||
============ | ============ | ||
|
|
||
Locust is available on PyPI and can be installed through pip or easy_install | Locust is available on PyPI and can be installed through pip or easy_install | ||
|
|
||
:: | :: | ||
|
|
||
pip install locustio | pip install locustio | ||
|
|
||
or:: | or:: | ||
|
|
||
easy_install locustio | easy_install locustio | ||
|
|
||
When Locust is installed, a **locust** command should be available in your shell (if you're not using | When Locust is installed, a **locust** command should be available in your shell (if you're not using | ||
virtualenv - which you should - make sure your python script directory is on your path). | virtualenv - which you should - make sure your python script directory is on your path). | ||
|
|
||
To see available options, run:: | To see available options, run:: | ||
|
|
||
locust --help | locust --help | ||
|
|
||
|
|
||
Installing ZeroMQ | Installing ZeroMQ | ||
----------------- | ----------------- | ||
|
|
||
If you intend to run Locust distributed across multiple processes/machines, we recommend you to also | If you intend to run Locust distributed across multiple processes/machines, we recommend you to also | ||
install **pyzmq**:: | install **pyzmq**:: | ||
|
|
||
pip install pyzmq | pip install pyzmq | ||
|
|
||
or:: | or:: | ||
|
|
||
easy_install pyzmq | easy_install pyzmq | ||
|
|
||
Installing Locust on Windows | Installing Locust on Windows | ||
---------------------------- | ---------------------------- | ||
|
|
||
The easiest way to get Locust running on Windows is to first install pre built binary packages for | The easiest way to get Locust running on Windows is to first install pre built binary packages for | ||
gevent (0.13) and greenlet and then follow the above instructions. | gevent (0.13) and greenlet and then follow the above instructions. | ||
|
|
||
You can find an unofficial collection of pre built python packages for windows here: | You can find an unofficial collection of pre built python packages for windows here: | ||
`http://www.lfd.uci.edu/~gohlke/pythonlibs/ <http://www.lfd.uci.edu/~gohlke/pythonlibs/>`_ | `http://www.lfd.uci.edu/~gohlke/pythonlibs/ <http://www.lfd.uci.edu/~gohlke/pythonlibs/>`_ | ||
|
|
||
Installing Locust on OS X | Installing Locust on OS X | ||
---------------------------- | ---------------------------- | ||
|
|
||
The following is currently the shortest path to installing gevent on OS X using Homebrew. | The following is currently the shortest path to installing gevent on OS X using Homebrew. | ||
|
|
||
#. Install [Homebrew](http://mxcl.github.com/homebrew/). | #. Install [Homebrew](http://mxcl.github.com/homebrew/). | ||
#. Install libevent (dependency for gevent):: | #. Install libevent (dependency for gevent):: | ||
|
|
||
brew install libevent | brew install libevent | ||
|
|
||
#. Then follow the above instructions. | #. Then follow the above instructions. |
Oops, something went wrong.