Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Circle CI Build Status Coverage Status Code Health

toxiproxy-python (Work in Progress)

toxiproxy-python 0.x (latest) is compatible with the Toxiproxy 2.x series.

Toxiproxy is a proxy to simulate network and system conditions. The Python API aims to make it simple to write tests that ensure your application behaves appropriately under harsh conditions. Before you can use the Python library, you need to read the Usage section of the Toxiproxy README.

pip install git+

Make sure the Toxiproxy server is already running.

For more information about Toxiproxy and the available toxics, see the Toxiproxy documentation

Usage (what we want to achieve when this library is ready)

The Python client communicates with the Toxiproxy daemon via HTTP. By default it connects to, but you can point to any host:

to be ported =(

For example, to simulate 1000ms latency on a database server you can use the latency toxic with the latency argument (see the Toxiproxy project for a list of all toxics):

to be ported =(

You can also take an endpoint down for the duration of a block at the TCP level:

to be ported =(

If you want to simulate all your Redis instances being down:

to be ported =(

If you want to simulate that your cache server is slow at incoming network (upstream), but fast at outgoing (downstream), you can apply a toxic to just the upstream:

to be ported =(

By default the toxic is applied to the downstream connection, you can be explicit and chain them:

to be ported =(

See the Toxiproxy README for a list of toxics.


To populate Toxiproxy pass the proxy configurations to the populate method:

to be ported =(

This will create the proxies passed, or replace the proxies if they already exist in Toxiproxy. It's recommended to do this early as early in boot as possible, see the Toxiproxy README. If you have many proxies, we recommend storing the Toxiproxy configs in a configuration file and deserializing it into populate.


A python api for Toxiproxy that can be used for resiliency testing.




No releases published
You can’t perform that action at this time.