Skip to main content

Extend the Chaos Toolkit with capabilities for the Proofdock Chaos Engineering Platform

Project description

Proofdock extension for the Chaos Toolkit

Build Status Python versions

This project is a collection of features gathered as an extension to the Proofdock Chaos Engineering Platform and the Chaos Toolkit.

Project description

This project is part of the Proofdock Chaos Engineering Platform that helps you to write, run, store and analyze chaos experiments in your Azure DevOps environment.

For more information visit our official website or documentation. Feel free to ask for support for this package on GitHub.

Getting started

To get started check out our official guide.


This package requires Python 3.5+

$ pip install -U proofdock-chaos-kit


The Proofdock Chaos CLI expects that you have a proper API token that allows you to authenticate against the Proofdock cloud. Learn more about the API token generation here.

To configure the API token you simply pass it to the chaos configure command.

chaos configure --token <API token>

Chaos CLI stores your API token in a settings file located under the following path:


Alternatively set the API token using an environment variable PROOFDOCK_API_TOKEN.


Precedence of options

If you specify the API token by using the PROOFDOCK_API_TOKEN environment variable, it overrides any API token value loaded from a settings file.


The Proofdock Chaos CLI introduces new commands:

  • chaos configure
  • chaos experiment

and extends an existing chaos run command with new options.


You use the chaos run command to run an experiment and upload its results to the Proofdock cloud.

chaos run [OPTIONS] experiment.json


You use the chaos configure command to set the API token in a settings file.

chaos configure --token <API token>


  --token TEXT            Token value


You use experiment list command to list all experiments in your project.

chaos experiment list

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

proofdock-chaos-kit-1.0.5.tar.gz (18.2 kB view hashes)

Uploaded Source

Built Distribution

proofdock_chaos_kit-1.0.5-py2.py3-none-any.whl (21.3 kB view hashes)

Uploaded Python 2 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