tarekziade / salvo Goto Github PK

View Code? Open in Web Editor NEW

216.0 8.0 12.0 79 KB

Like Boom, but based on Molotov

License: Apache License 2.0

Python 99.07% Makefile 0.93%

salvo's Introduction

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

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!

salvo's People

Contributors

Stargazers

Watchers

Forkers

stephendonner csemrm ganaraja n1ngu sthagen jldiaz-uniovi dvntaudio nahuelement l3dlp-sandbox tsanghan ractando adeis

salvo's Issues

set user agent

Set user agent header with Salvo version and Molotov version

I tried pip install ...

and got https://pypi.python.org/pypi/boom2/1.2.0 one of the garbage packages on Pypi ...

would be fine to add in README.rst

 pip install git+https://github.com/tarekziade/boom2

got an unexpected keyword argument 'loop'

Hi:

I want to use salvo on my project, install it with pipenv and run against my apache server and got this error:

-------- Server info --------

Server Software: Apache/2.4.41 (Ubuntu)

-------- Running 100 queries - concurrency 10 --------


Traceback (most recent call last):
  File "/home/nomar/.local/share/virtualenvs/fastapi_blueprint_01-Z-nbJPAX/bin/salvo", line 8, in <module>
    sys.exit(console_main())
  File "/home/nomar/.local/share/virtualenvs/fastapi_blueprint_01-Z-nbJPAX/lib/python3.10/site-packages/salvo/run.py", line 221, in console_main
    main()
  File "/home/nomar/.local/share/virtualenvs/fastapi_blueprint_01-Z-nbJPAX/lib/python3.10/site-packages/salvo/run.py", line 200, in main
    res, molotov_res = load(args.url, args)
  File "/home/nomar/.local/share/virtualenvs/fastapi_blueprint_01-Z-nbJPAX/lib/python3.10/site-packages/salvo/run.py", line 44, in load
    molotov_res = run_test(url, res, args)
  File "/home/nomar/.local/share/virtualenvs/fastapi_blueprint_01-Z-nbJPAX/lib/python3.10/site-packages/salvo/scenario.py", line 139, in run_test
    res = run(args, stream=stream)
  File "/home/nomar/.local/share/virtualenvs/fastapi_blueprint_01-Z-nbJPAX/lib/python3.10/site-packages/molotov/run.py", line 301, in run
    res = Runner(args)()
  File "/home/nomar/.local/share/virtualenvs/fastapi_blueprint_01-Z-nbJPAX/lib/python3.10/site-packages/molotov/runner.py", line 73, in __call__
    return self._launch_processes()
  File "/home/nomar/.local/share/virtualenvs/fastapi_blueprint_01-Z-nbJPAX/lib/python3.10/site-packages/molotov/runner.py", line 119, in _launch_processes
    self._process()
  File "/home/nomar/.local/share/virtualenvs/fastapi_blueprint_01-Z-nbJPAX/lib/python3.10/site-packages/molotov/runner.py", line 199, in _process
    display = self.gather(update, display)
  File "/home/nomar/.local/share/virtualenvs/fastapi_blueprint_01-Z-nbJPAX/lib/python3.10/site-packages/molotov/runner.py", line 57, in gather
    return asyncio.gather(*futures, loop=self.loop, return_exceptions=True)
TypeError: gather() got an unexpected keyword argument 'loop'

Any advice?

Thanks in advance
Nomar Mora

TypeError: run() got an unexpected keyword argument 'stream'

I tried both salvo from pypi, and a -e install from the current master (that is as well 0.1, as I discovered ;-)

--- ~ » salvo -c 10 -n 100 https://bnzk.ch                            
-------- Server info --------

Server Software: nginx

-------- Running 100 queries - concurrency 10 --------


Traceback (most recent call last):
  File "/home/benzkji/.local/bin/salvo", line 11, in <module>
    load_entry_point('salvo', 'console_scripts', 'salvo')()
  File "/home/benzkji/src/salvo/salvo/run.py", line 203, in main
    res, molotov_res = load(url, args)
  File "/home/benzkji/src/salvo/salvo/run.py", line 41, in load
    molotov_res = run_test(url, res, args)
  File "/home/benzkji/src/salvo/salvo/scenario.py", line 114, in run_test
    res = run(args, stream=stream)
TypeError: run() got an unexpected keyword argument 'stream'

[feature request] Semi-dynamic url

First of all I really like what you have created, for load testing it's awesome tool. Simple and functional. Sorry for putting this into a ticket but I had no idea how to reach you other way. ;-)

Do you reckon feature that will allow make calls on many different urls would be something that should not be a part of this library. The easiest solution could be to use some sort of random variable or even simpler instead of providing one url, provide list of urls in form of config or coma separated list.

Our use case is testing api server's load and forcing it to rotate cache.

i am getting this error when trying to run on windows with Python 3.10.8 miniconda

PS C:\Users\isaque.neves> salvo "http://192.168.66.123:3350/api/v1/protocolo/processos?limit=12&offset=0&search=10&orderDir=desc" -c 10 -n 100 -m GET --content-type "application/json" --header "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7ImFub19leGVyY2ljaW8iOiIyMDIzIiwiYW5vX2V4ZXJjaWNpb19zZXRvciI6IjIwMDMiLCJjb2RfZGVwYXJ0YW1lbnRvIjoyLCJjb2Rfb3JnYW8iOjIsImNvZF9zZXRvciI6MSwiY29kX3VuaWRhZGUiOjg5LCJjcGYiOm51bGwsIm5vbV9jZ20iOiJJc2FxdWUgTmV2ZXMgU2FudCdhbmEiLCJudW1jZ20iOjE0MDA1MCwidXNlcm5hbWUiOiJpc2FxdWUuc2FudGFuYSJ9LCJleHAiOjE2OTA0OTQxNTksImlhdCI6MTY5MDQ2MTc1OSwiaXNzIjoibmV3c2FsaS5yaW9kYXNvc3RyYXMucmouZ292LmJyIiwibmJmIjoxNjkwNDYxNzU5fQ.0BvLPlghuRtMkceOQHhjFfYZMvYx9wgRFiv_q4khKh0"
-------- Server info --------

Server Software: Angel3
Authorization:  Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7ImFub19leGVyY2ljaW8iOiIyMDIzIiwiYW5vX2V4ZXJjaWNpb19zZXRvciI6IjIwMDMiLCJjb2RfZGVwYXJ0YW1lbnRvIjoyLCJjb2Rfb3JnYW8iOjIsImNvZF9zZXRvciI6MSwiY29kX3VuaWRhZGUiOjg5LCJjcGYiOm51bGwsIm5vbV9jZ20iOiJJc2FxdWUgTmV2ZXMgU2FudCdhbmEiLCJudW1jZ20iOjE0MDA1MCwidXNlcm5hbWUiOiJpc2FxdWUuc2FudGFuYSJ9LCJleHAiOjE2OTA0OTQxNTksImlhdCI6MTY5MDQ2MTc1OSwiaXNzIjoibmV3c2FsaS5yaW9kYXNvc3RyYXMucmouZ292LmJyIiwibmJmIjoxNjkwNDYxNzU5fQ.0BvLPlghuRtMkceOQHhjFfYZMvYx9wgRFiv_q4khKh0

-------- Running 100 queries - concurrency 10 --------


Traceback (most recent call last):
  File "C:\miniconda3\lib\runpy.py", line 196, in _run_module_as_main
    return _run_code(code, main_globals, None,
  File "C:\miniconda3\lib\runpy.py", line 86, in _run_code
    exec(code, run_globals)
  File "C:\Users\isaque.neves\AppData\Roaming\Python\Python310\Scripts\salvo.exe\__main__.py", line 7, in <module>
  File "C:\Users\isaque.neves\AppData\Roaming\Python\Python310\site-packages\salvo\run.py", line 221, in console_main
    main()
  File "C:\Users\isaque.neves\AppData\Roaming\Python\Python310\site-packages\salvo\run.py", line 200, in main
    res, molotov_res = load(args.url, args)
  File "C:\Users\isaque.neves\AppData\Roaming\Python\Python310\site-packages\salvo\run.py", line 44, in load
    molotov_res = run_test(url, res, args)
  File "C:\Users\isaque.neves\AppData\Roaming\Python\Python310\site-packages\salvo\scenario.py", line 139, in run_test
    res = run(args, stream=stream)
  File "C:\Users\isaque.neves\AppData\Roaming\Python\Python310\site-packages\molotov\run.py", line 306, in run
    res = Runner(args)()
  File "C:\Users\isaque.neves\AppData\Roaming\Python\Python310\site-packages\molotov\runner.py", line 74, in __call__
    return self._launch_processes()
  File "C:\Users\isaque.neves\AppData\Roaming\Python\Python310\site-packages\molotov\runner.py", line 88, in _launch_processes
    self.loop.add_signal_handler(signal.SIGTERM, self._shutdown)
  File "C:\miniconda3\lib\asyncio\events.py", line 553, in add_signal_handler
    raise NotImplementedError
NotImplementedError
PS C:\Users\isaque.neves>

current state

just a quick bumper...how is it going here? love boom1, but it seems broken on modern python versions?

UUID or Random

How can we send post data with UUID for example
'{"user":"UUID", "query":"hello"}'