{ "info": { "author": "chaostoolkit Team", "author_email": "contact@chaostoolkit.org", "bugtrack_url": null, "classifiers": [ "Development Status :: 2 - Pre-Alpha", "Intended Audience :: Developers", "License :: Freely Distributable", "License :: OSI Approved :: Apache Software License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: Implementation", "Programming Language :: Python :: Implementation :: CPython" ], "description": "# Chaos Toolkit Driver for Spring Chaos.\n\n[![Python versions](https://img.shields.io/pypi/pyversions/chaostoolkit-spring.svg)](https://www.python.org/) [![Build Status](https://travis-ci.org/chaostoolkit-incubator/chaostoolkit-spring.svg?branch=master)](https://travis-ci.org/chaostoolkit-incubator/chaostoolkit-spring)\n\n\nThis project is a collection of [actions][] and [probes][], gathered as an\nextension to the [Chaos Toolkit][chaostoolkit].\n\n[actions]: http://chaostoolkit.org/reference/api/experiment/#action\n[probes]: http://chaostoolkit.org/reference/api/experiment/#probe\n[chaostoolkit]: http://chaostoolkit.org\n\n## Install\n\nThis package requires Python 3.5+\n\nTo be used from your experiment, this package must be installed in the Python\nenvironment where [chaostoolkit][] already lives.\n\n```\n$ pip install -U chaostoolkit-spring\n```\n\n## Usage\n\nCurrently this driver supports interactions with a [Spring Boot-based](https://spring.io/projects/spring-boot) service that has included the [2.0.0.-SNAPSHOT](https://codecentric.github.io/chaos-monkey-spring-boot/2.0.0-SNAPSHOT/) release of the [Chaos Monkey for Spring Boot](https://github.com/codecentric/chaos-monkey-spring-boot). This snapshot includes the necessary Spring Boot Actuator HTTP endpoints so that the Chaos Toolkit to interact with the chaos features at runtime.\n\nOnce you have [added the Chaos Monkey for Spring Boot](https://codecentric.github.io/chaos-monkey-spring-boot/2.0.0-SNAPSHOT/#getting-started) and [enabled the Spring Boot Actuator HTTP endpoints](https://codecentric.github.io/chaos-monkey-spring-boot/2.0.0-SNAPSHOT/#endpoints) you can then use the probes and actions from this driver.\n\nTo use the probes and actions from this package, add the following to your\nexperiment file:\n\n```json\n{\n \"name\": \"enable_chaosmonkey\",\n \"provider\": {\n \"arguments\": {\n \"base_url\": \"http://localhost:8080/actuator\"\n },\n \"func\": \"enable_chaosmonkey\",\n \"module\": \"chaosspring.actions\",\n \"type\": \"python\"\n },\n \"type\": \"action\"\n}\n```\n\nThis will interact with the specified service and enable the Chaos Monkey features. You can also turn off the Chaos Monkey if you wish by specifying the following action:\n\n```json\n{\n \"name\": \"disable_chaosmonkey\",\n \"provider\": {\n \"arguments\": {\n \"base_url\": \"http://localhost:8080/actuator\"\n },\n \"func\": \"disable_chaosmonkey\",\n \"module\": \"chaosspring.actions\",\n \"type\": \"python\"\n },\n \"type\": \"action\"\n}\n```\n\nYou can then manipulate the [Chaos Monkey assaults](https://codecentric.github.io/chaos-monkey-spring-boot/2.0.0-SNAPSHOT/#assaults) active on your service by specifing the following action:\n\n```json\n{\n \"name\": \"configure_assaults\",\n \"provider\": {\n \"arguments\": {\n \"base_url\": \"http://localhost:8080/actuator\",\n \"assaults_configuration\": {\n \"level\": 5,\n \"latencyRangeStart\": 2000,\n \"latencyRangeEnd\": 5000,\n \"latencyActive\": false,\n \"exceptionsActive\": false,\n \"killApplicationActive\": true,\n \"restartApplicationActive\": false\n }\n },\n \"func\": \"change_assaults_configuration\",\n \"module\": \"chaosspring.actions\",\n \"type\": \"python\"\n },\n \"type\": \"action\"\n}\n```\n\nThat's it!\n\nPlease explore the code to use further probes and actions.\n\n## Contribute\n\nIf you wish to contribute more functions to this package, you are more than\nwelcome to do so. Please, fork this project, make your changes following the\nusual [PEP 8][pep8] code style, sprinkling with tests and submit a PR for\nreview.\n\n[pep8]: https://pycodestyle.readthedocs.io/en/latest/\n\nThe Chaos Toolkit projects require all contributors must sign a\n[Developer Certificate of Origin][dco] on each commit they would like to merge\ninto the master branch of the repository. Please, make sure you can abide by\nthe rules of the DCO before submitting a PR.\n\n[dco]: https://github.com/probot/dco#how-it-works\n\n### Develop\n\nIf you wish to develop on this project, make sure to install the development\ndependencies. But first, [create a virtual environment][venv] and then install\nthose dependencies.\n\n[venv]: http://chaostoolkit.org/reference/usage/install/#create-a-virtual-environment\n\n```console\n$ pip install -r requirements-dev.txt -r requirements.txt\n```\n\nThen, point your environment to this directory:\n\n```console\n$ python setup.py develop\n```\n\nNow, you can edit the files and they will be automatically be seen by your\nenvironment, even when running from the `chaos` command locally.\n\n### Test\n\nTo run the tests for the project execute the following:\n\n```\n$ pytest\n```\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://chaostoolkit.org", "keywords": "", "license": "Apache License Version 2.0", "maintainer": "", "maintainer_email": "", "name": "chaostoolkit-spring", "package_url": "https://pypi.org/project/chaostoolkit-spring/", "platform": "", "project_url": "https://pypi.org/project/chaostoolkit-spring/", "project_urls": { "Homepage": "http://chaostoolkit.org" }, "release_url": "https://pypi.org/project/chaostoolkit-spring/0.2.0/", "requires_dist": [ "chaostoolkit-lib (>=0.15.0)", "logzero" ], "requires_python": ">=3.5.*", "summary": "Chaos Toolkit Driver for Spring Chaos.", "version": "0.2.0" }, "last_serial": 4506279, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "05497f8502bc57125b6dd4dbe78f85ed", "sha256": "56d2457be70d282857bf69753d84d80d25ba76b6eb36634a73bccd0f4364ad46" }, "downloads": -1, "filename": "chaostoolkit_spring-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "05497f8502bc57125b6dd4dbe78f85ed", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5.*", "size": 7434, "upload_time": "2018-06-07T08:53:05", "url": "https://files.pythonhosted.org/packages/82/83/3a205aa0c59076e4962065510e9b1015646a28748b9a6fdd3c6948ffe2cf/chaostoolkit_spring-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "35798d414daa150ee72d255d5ddc601e", "sha256": "f69aaf0dce832c96a36db6b5a9b25e3aa1d3687bc85b749bba7aa762dbe45ae9" }, "downloads": -1, "filename": "chaostoolkit-spring-0.1.0.tar.gz", "has_sig": false, "md5_digest": "35798d414daa150ee72d255d5ddc601e", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5.*", "size": 4585, "upload_time": "2018-06-07T08:53:06", "url": "https://files.pythonhosted.org/packages/68/c3/be13ff7006933be1ae3618558c1257d48c66cdedb093fd411ecedb3c5057/chaostoolkit-spring-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "1975e322473140e0f7894bd7b7c3ed47", "sha256": "5abfc816eb437fa06e87b818727299c5a0a18ead3800020966dec166a8bd0f33" }, "downloads": -1, "filename": "chaostoolkit_spring-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "1975e322473140e0f7894bd7b7c3ed47", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5.*", "size": 7437, "upload_time": "2018-06-07T10:03:15", "url": "https://files.pythonhosted.org/packages/64/4c/186460c18d58d03b685b5bc167fb0868c3baf5dafa701e26e6e2c787f3e0/chaostoolkit_spring-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "b384ad3bc20a571bbe33ed4e21b55813", "sha256": "3b0523d516d905b3e74706b78885db3764abbe77574a00fa3c699e8fb3ed51bf" }, "downloads": -1, "filename": "chaostoolkit-spring-0.1.1.tar.gz", "has_sig": false, "md5_digest": "b384ad3bc20a571bbe33ed4e21b55813", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5.*", "size": 9510, "upload_time": "2018-06-07T10:03:15", "url": "https://files.pythonhosted.org/packages/a4/5e/3653e66500ccc493bbb01fcd26aa133cc2dbabb5990fc5453cdf50d19610/chaostoolkit-spring-0.1.1.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "b829998b9fc746876804a40de4033e04", "sha256": "1c86a0d0a2336009c00e912e3ebe2ff25cf907770133e1d71bd3f8187a241e2a" }, "downloads": -1, "filename": "chaostoolkit_spring-0.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "b829998b9fc746876804a40de4033e04", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5.*", "size": 5638, "upload_time": "2018-11-20T08:06:48", "url": "https://files.pythonhosted.org/packages/4f/58/a9c637caaa22008ba700e6450530988e45403dc3da9421f9fd01bf6f7643/chaostoolkit_spring-0.2.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "6bb5894683f57d779efefbfeea096a2b", "sha256": "85dcb75937898c00c6ed44d993696532fbf4b4d8f2bcea5c32511d5f046f239a" }, "downloads": -1, "filename": "chaostoolkit-spring-0.2.0.tar.gz", "has_sig": false, "md5_digest": "6bb5894683f57d779efefbfeea096a2b", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5.*", "size": 9674, "upload_time": "2018-11-20T08:06:49", "url": "https://files.pythonhosted.org/packages/ac/ee/ff015745a5b566076861ba234bf888b9ce13881b8f2846f7046ef82827c9/chaostoolkit-spring-0.2.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "b829998b9fc746876804a40de4033e04", "sha256": "1c86a0d0a2336009c00e912e3ebe2ff25cf907770133e1d71bd3f8187a241e2a" }, "downloads": -1, "filename": "chaostoolkit_spring-0.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "b829998b9fc746876804a40de4033e04", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5.*", "size": 5638, "upload_time": "2018-11-20T08:06:48", "url": "https://files.pythonhosted.org/packages/4f/58/a9c637caaa22008ba700e6450530988e45403dc3da9421f9fd01bf6f7643/chaostoolkit_spring-0.2.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "6bb5894683f57d779efefbfeea096a2b", "sha256": "85dcb75937898c00c6ed44d993696532fbf4b4d8f2bcea5c32511d5f046f239a" }, "downloads": -1, "filename": "chaostoolkit-spring-0.2.0.tar.gz", "has_sig": false, "md5_digest": "6bb5894683f57d779efefbfeea096a2b", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5.*", "size": 9674, "upload_time": "2018-11-20T08:06:49", "url": "https://files.pythonhosted.org/packages/ac/ee/ff015745a5b566076861ba234bf888b9ce13881b8f2846f7046ef82827c9/chaostoolkit-spring-0.2.0.tar.gz" } ] }