Skip to main content

Bombards target server with simultaneous requests

Project description

Made with Python Latest release Pip upload Latest release MIT license Documentation Status

Bombard is a tool for stress test and benchmarking your HTTP server. Especially it’s good to simulate a heavy load and initial burst of simultaneous HTTP requests with complex logic.

It is designed to be extremely simple yet powerful tool to load test functional behavior.

Thanks to optional Python inlines you can fast and easy describe complex logic for the tests.

Test report shows you how many requests per second your server is capable of serving and with what latency.

Installation

pip install bombard --upgrade

After that use bombard (bombard.exe in Windows) executable:

bombard --help

Requests description

Requests can be just URL or contain JSON described like this

supply:  # you can redefine variables from command line (--supply host=http://localhost/)
  host: https://jsonplaceholder.typicode.com/

getToken:
    url: "{host}auth"  # use custom {host} variable to stay DRY
    method: POST
    body:  # below is JSON object for request body
        email: name@example.com
        password: admin
    extract:  # get token for next requests
        token:

In first request you can get security token as in example above.

And use it in next requests:

postsList:
   url: "{host}posts"
   headers:
       Authorization: "Bearer {token}"  # we get {token} in 1st request
   script: |
       for post in resp[:3]:  # for 1st three posts from response
           # schedule getPost request (from ammo section)
           # and provide it with id we got from the response
           reload(ammo.getPost, id=post['id'])

Included examples. To list examples

bombard --examples

Command line

From command line you can change number of threads, loop count, supply vars, customize report and so on.

Also you can bootstrap your own bombard.yaml file from any example you like:

bombard --init --example simple

Report

Example of report for the command:

bombard --example simple --repeat 2 --threshold 100
https://github.com/andgineer/bombard/blob/master/docs/_static/simple_stdout.png?raw=true

Documentation

Bombard documentation

Translation managed with Transifex

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bombard-1.20.tar.gz (22.4 kB view hashes)

Uploaded Source

Built Distribution

bombard-1.20-py3-none-any.whl (30.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page