Skip to main content

logo stressor

Tests Latest Version License Documentation Status codecov Code style: black Released with: Yabs StackOverflow: stressor

Stress-test your web app.

Stressor is a tool, that runs a sequence of activities in one or more parallel sessions. The most common use case is to run a test script with HTTP commands against a web server, simulating a bunch of parallel user sessions. As a result we get metrics about reponse times, failures, resource usage, etc.

Stressor can be used for testing, benchmarking, load testing, or to generate test data. Stressor comes with prebuilt activities for HTTP-request and more, and can be extended by custom activity-plugins.

Test scripts can be defined as text files, using a special syntax, that is then executed by the stressor command line tool. Stressor is also an Open Source Python library that can be included into your own projects. This allows to define test scenarios programmtically.

Quickstart

  1. Install stressor (details)

  2. Create a new scenario folder. For example:

    $ stressor init ./scenario_1
    

    or alternatively import an existing HAR file as a starting point (details):

    $ stressor init ./scenario_1 --convert /path/to/output.har
    
  3. Edit the scripts as needed (users.yaml, main_sequence.yaml, scenario.yaml) (details)

  4. Run the script:

    $ stressor run ./scenario_1/scenario.yaml
    

    Use the --monitor option to view the progress in a separate window:

    $ stressor run ./scenario_1/scenario.yaml --monitor
    

    Use the --log argument to write output to a file or folder:

    $ stressor run ./scenario_1/scenario.yaml --no-color --log .
    

    (Hit Ctrl+C to stop.)

  5. Read The Docs for details.

Release files for stressor 0.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for stressor 0.6.0
File Size Uploaded
stressor-0.6.0.tar.gz 58.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for stressor 0.6.0
File Interpreter ABI Platform
stressor-0.6.0-py3-none-any.whl Python 3 none any Details

Total release size: 515.6 kB

Release files / stressor-0.6.0.tar.gz

Download URL stressor-0.6.0.tar.gz
Size 58.0 kB
Tags Source
SHA-256 checksum
How to use checksums
55a10edc41f5f3402af692a94453f8d51579ca5efa194ec2e246e090e0454b6e
BLAKE2b-256 checksum
How to use checksums
30f773a527c09ee5f6a870340e66640eaf48ee321e610cdb553ef33dbde99091
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.12.2

Release files / stressor-0.6.0-py3-none-any.whl

Download URL stressor-0.6.0-py3-none-any.whl
Size 457.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1b18749af2678d587bffc19cd1ec569badd84a54bd6fa935e44c8fbf2ae76e81
BLAKE2b-256 checksum
How to use checksums
845f33a5c5818252250fdacaeafe77e551fa7b9a1b7dfa7852184741262cc324
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.12.2

Release history Release notifications | RSS feed

This release

0.6.0 This release

2 release files

0.5.2

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.1

2 release files

0.1.1

2 release files

0.1.0

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page