=====
Salvo
.. image:: http://coveralls.io/repos/github/tarekziade/salvo/badge.svg?branch=master
:target: https://coveralls.io/github/tarekziade/salvo?branch=master
.. image:: http://travis-ci.org/tarekziade/salvo.svg?branch=master
:target: https://travis-ci.org/tarekziade/salvo
This is the replacement for https://github.com/tarekziade/boom
Salvo is a simple command line tool to send some load to an HTTP(S)
endpoint.
Salvo is a script you can use to quickly smoke-test your
web app deployment. If you need a more complex tool,
I'd suggest looking at Molotov <http://molotov.readthedocs.io>_
Salvo was specifically written to replace my Apache Bench (ab) usage.
Salvo is based on Molotov, which uses Python 3 asyncio & aiohttp.
Installation
Salvo requires Python 3.6+ and Molotov, which gets installed as a
dependency.
Just do::
$ pip install salvo
Basic usage
Basic usage example: 100 queries with a maximum concurrency of 10 users::
% salvo http://localhost:80 -c 10 -n 100
-------- Server info --------
Server Software: nginx/1.18.0
Host: localhost
-------- Running 100 queries - concurrency 10 --------
[================================================================>.] 99%
-------- Results --------
Successful calls 1000
Total time 16.0587 s
Average 0.0161 s
Fastest 0.0036 s
Slowest 0.2524 s
Amplitude 0.2488 s
Standard deviation 0.011326
Requests Per Second 62.27
Requests Per Minute 3736.29
-------- Status codes --------
Code 200 1000 times.
You can also use --duration if you want to run for a given amount of time.
For a full list of features, run salvo --help
Contribute
Salvo is very simple and anyone familiar with Python can contribute.
If you are interested in this project, you are welcome to join the fun at
https://github.com/tarekziade/salvo
Make sure to add yourself to the contributors list if your PR gets merged. And
make sure it's in alphabetical order!