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