#  stressor
[](https://github.com/mar10/stressor/actions/workflows/tests.yml)
[](https://pypi.python.org/pypi/stressor/)
[](https://github.com/mar10/stressor/blob/master/LICENSE.txt)
[](http://stressor.readthedocs.io/)
[](https://codecov.io/github/mar10/stressor)
[](https://github.com/ambv/black)
[](https://github.com/mar10/yabs)
[](https://stackoverflow.com/questions/tagged/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](https://stressor.readthedocs.io/en/latest/installation.html))
2. Create a new scenario folder. For example:
```bash
$ stressor init ./scenario_1
```
or alternatively import an existing HAR file as a starting point
([details](https://stressor.readthedocs.io/en/latest/ug_writing_scripts.html#importing-har-files)):
```bash
$ stressor init ./scenario_1 --convert /path/to/output.har
```
3. Edit the scripts as needed (_users.yaml_, _main_sequence.yaml_, _scenario.yaml_)
([details](https://stressor.readthedocs.io/en/latest/ug_writing_scripts.html))
4. Run the script:
```bash
$ stressor run ./scenario_1/scenario.yaml
```
Use the `--monitor` option to view the progress in a separate window:
```bash
$ stressor run ./scenario_1/scenario.yaml --monitor
```
Use the `--log` argument to write output to a file or folder:
```bash
$ stressor run ./scenario_1/scenario.yaml --no-color --log .
```
(Hit <kbd>Ctrl</kbd>+<kbd>C</kbd> to stop.)
5. [Read The Docs](https://stressor.readthedocs.io/en/latest/ug_tutorial.html)
for details.
<img src="https://stressor.readthedocs.io/en/latest/_images/summary.png">
<img src="https://stressor.readthedocs.io/en/latest/_images/teaser.png">
Raw data
{
"_id": null,
"home_page": "https://github.com/mar10/stressor",
"name": "stressor",
"maintainer": "Martin Wendt",
"docs_url": null,
"requires_python": null,
"maintainer_email": "stressor@wwwendt.de",
"keywords": "web, server, load, test, stress",
"author": "Martin Wendt",
"author_email": "stressor@wwwendt.de",
"download_url": "https://files.pythonhosted.org/packages/30/f7/73a527c09ee5f6a870340e66640eaf48ee321e610cdb553ef33dbde99091/stressor-0.6.0.tar.gz",
"platform": null,
"description": "#  stressor\r\n\r\n[](https://github.com/mar10/stressor/actions/workflows/tests.yml)\r\n[](https://pypi.python.org/pypi/stressor/)\r\n[](https://github.com/mar10/stressor/blob/master/LICENSE.txt)\r\n[](http://stressor.readthedocs.io/)\r\n[](https://codecov.io/github/mar10/stressor)\r\n[](https://github.com/ambv/black)\r\n[](https://github.com/mar10/yabs)\r\n[](https://stackoverflow.com/questions/tagged/stressor)\r\n\r\n> Stress-test your web app.\r\n\r\n_Stressor_ is a tool, that runs a sequence of activities in one or more\r\nparallel sessions.\r\nThe most common use case is to run a test script with HTTP commands\r\nagainst a web server, simulating a bunch of parallel user sessions.\r\nAs a result we get metrics about reponse times, failures, resource usage,\r\netc.\r\n\r\nStressor can be used for testing, benchmarking, load testing, or to generate\r\ntest data.\r\nStressor comes with prebuilt activities for HTTP-request and more, and can be\r\nextended by custom activity-plugins.\r\n\r\nTest scripts can be defined as text files, using a special syntax, that is then\r\nexecuted by the `stressor` command line tool.\r\nStressor is also an Open Source Python library that can be included into your\r\nown projects. This allows to define test _scenarios_ programmtically.\r\n\r\n## Quickstart\r\n\r\n1. Install _stressor_ ([details](https://stressor.readthedocs.io/en/latest/installation.html))\r\n\r\n2. Create a new scenario folder. For example:\r\n\r\n ```bash\r\n $ stressor init ./scenario_1\r\n ```\r\n\r\n or alternatively import an existing HAR file as a starting point\r\n ([details](https://stressor.readthedocs.io/en/latest/ug_writing_scripts.html#importing-har-files)):\r\n\r\n ```bash\r\n $ stressor init ./scenario_1 --convert /path/to/output.har\r\n ```\r\n\r\n3. Edit the scripts as needed (_users.yaml_, _main_sequence.yaml_, _scenario.yaml_)\r\n ([details](https://stressor.readthedocs.io/en/latest/ug_writing_scripts.html))\r\n\r\n4. Run the script:\r\n\r\n ```bash\r\n $ stressor run ./scenario_1/scenario.yaml\r\n ```\r\n\r\n Use the `--monitor` option to view the progress in a separate window:\r\n\r\n ```bash\r\n $ stressor run ./scenario_1/scenario.yaml --monitor\r\n ```\r\n\r\n Use the `--log` argument to write output to a file or folder:\r\n\r\n ```bash\r\n $ stressor run ./scenario_1/scenario.yaml --no-color --log .\r\n ```\r\n\r\n (Hit <kbd>Ctrl</kbd>+<kbd>C</kbd> to stop.)\r\n\r\n5. [Read The Docs](https://stressor.readthedocs.io/en/latest/ug_tutorial.html)\r\n for details.\r\n\r\n<img src=\"https://stressor.readthedocs.io/en/latest/_images/summary.png\">\r\n\r\n<img src=\"https://stressor.readthedocs.io/en/latest/_images/teaser.png\">\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Stress-test your web app",
"version": "0.6.0",
"project_urls": {
"Bug Tracker": "https://github.com/mar10/stressor/issues",
"Documentation": "https://stressor.readthedocs.io",
"Download": "https://github.com/mar10/stressor/releases/latest",
"Homepage": "https://github.com/mar10/stressor",
"Source Code": "https://github.com/mar10/stressor"
},
"split_keywords": [
"web",
" server",
" load",
" test",
" stress"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "845f33a5c5818252250fdacaeafe77e551fa7b9a1b7dfa7852184741262cc324",
"md5": "f088c2e43b1daa00a886fc724c6ec2a6",
"sha256": "1b18749af2678d587bffc19cd1ec569badd84a54bd6fa935e44c8fbf2ae76e81"
},
"downloads": -1,
"filename": "stressor-0.6.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f088c2e43b1daa00a886fc724c6ec2a6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 457649,
"upload_time": "2024-04-28T09:46:04",
"upload_time_iso_8601": "2024-04-28T09:46:04.882920Z",
"url": "https://files.pythonhosted.org/packages/84/5f/33a5c5818252250fdacaeafe77e551fa7b9a1b7dfa7852184741262cc324/stressor-0.6.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "30f773a527c09ee5f6a870340e66640eaf48ee321e610cdb553ef33dbde99091",
"md5": "92e97ad3ae39f9fbe9d779e1886c56a9",
"sha256": "55a10edc41f5f3402af692a94453f8d51579ca5efa194ec2e246e090e0454b6e"
},
"downloads": -1,
"filename": "stressor-0.6.0.tar.gz",
"has_sig": false,
"md5_digest": "92e97ad3ae39f9fbe9d779e1886c56a9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 57955,
"upload_time": "2024-04-28T09:46:07",
"upload_time_iso_8601": "2024-04-28T09:46:07.950102Z",
"url": "https://files.pythonhosted.org/packages/30/f7/73a527c09ee5f6a870340e66640eaf48ee321e610cdb553ef33dbde99091/stressor-0.6.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-28 09:46:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mar10",
"github_project": "stressor",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"tox": true,
"lcname": "stressor"
}
JSON
