locustodoorpc 0.0.1

Locust custom client: odoorpc

Locust odoorpc
==============

Links
-----

* Locust: https://locust.io/
* Locust docs: https://docs.locust.io/
* OdooRPC: https://pythonhosted.org/OdooRPC/
* Source code: https://github.com/camptocamp/locustodoorpc
* Alternative: https://github.com/nseinlet/OdooLocust (using ``openerplib`` instead of ``odoorpc``)

Description
-----------

Locust custom client integrating the `odoorpc <https://github.com/osiell/odoorpc>`_ library, so you can run load-testing on your odoo services. Have a look at the feature list of `locust <https://github.com/locustio/locust/#description>`_ to see what you can do.

Installation
------------

```
virtualenv .env
source .env/bin/activate
pip install locustodoorpc

```

Usage
-----

For the general documentation on Locust, heads on https://docs.locust.io/en/latest/
A few options can be customized with environment variables:

+--------------+-------------------------------------------------------------+
|Name |Usage |
+--------------+-------------------------------------------------------------+
|ODOO_DB_NAME |Configure the name of the database to load-test |
| |(default: odoo) |
+--------------+-------------------------------------------------------------+
|ODOO_LOGIN |Login to use for the actions (default: admin) |
+--------------+-------------------------------------------------------------+
|ODOO_PASSWORD |Password for the user (default: admin) |
+--------------+-------------------------------------------------------------+
|ODOO_VERSION |Force an Odoo version (e.g. 9.0, 10.0, 11.0), normally |
| |automatically recognized |
+--------------+-------------------------------------------------------------+

Example:

```
ODOO_DB_NAME=demo locust -f examples/profile.py --host http://localhost:8069

```

Check the `examples <https://github.com/camptocamp/locustodoorpc/tree/master/examples>`_

.. image:: https://raw.githubusercontent.com/camptocamp/locustodoorpc/master/images/locustodoorpc.png



.. :changelog:

Release History
===============

0.0.1 (2017-11-03)
------------------

Initial release.