Command-line options

To run a test, use the molotov runner and point it to the scenario module or path:

Load test.

usage: molotov [-h] [--single-run] [-s SINGLE_MODE] [--config CONFIG]
               [--version] [--debug] [-v] [-w WORKERS] [--ramp-up RAMP_UP]
               [--sizing] [--sizing-tolerance SIZING_TOLERANCE]
               [--delay DELAY] [--console-update CONSOLE_UPDATE]
               [-p PROCESSES] [-d DURATION] [-r MAX_RUNS] [-q] [-x] [-f FAIL]
               [-c] [--statsd] [--statsd-address STATSD_ADDRESS] [--uvloop]
               [--use-extension USE_EXTENSION [USE_EXTENSION ...]]
               [--force-shutdown]
               [scenario]

Positional Arguments

scenario

path or module name that contains scenarii Default: “loadtest.py”

Named Arguments

--single-run	Run once every existing scenario Default: False
-s, --single-mode
	Name of a single scenario to run once.
--config	Point to a JSON config file.
--version	Displays version and exits. Default: False
--debug	Run the event loop in debug mode. Default: False
-v, --verbose	Verbosity level. -v will display tracebacks. -vv requests and responses. Default: 0
-w, --workers	Number of workers Default: 1
--ramp-up	Ramp-up time in seconds Default: 0.0
--sizing	Autosizing Default: False
--sizing-tolerance
	Sizing tolerance Default: 5.0
--delay	Delay between each worker run Default: 0.0
--console-update
	Delay between each console update Default: 0.2
-p, --processes
	Number of processes Default: 1
-d, --duration	Duration in seconds Default: 86400
-r, --max-runs	Maximum runs per worker
-q, --quiet	Quiet Default: False
-x, --exception
	Stop on first failure. Default: False
-f, --fail	Number of failures required to fail
-c, --console	Use simple console for feedback Default: False
--statsd	Activates statsd Default: False
--statsd-address
	Statsd Address Default: “udp://localhost:8125”
--uvloop	Use uvloop Default: False
--use-extension
	Imports a module containing Molotov extensions
--force-shutdown
	Cancel all pending workers on shutdown Default: False