toxiproxy_rust 0.1.6

Lightweight client for Toxiproxy
Documentation

Toxiproxy - Rust client

Build Status Crates.io

Rust client for Toxiproxy.

Usage

Populating proxies:

let proxies = TOXIPROXY.populate(vec![
  Proxy::new(
    "socket_service".into(),
    "localhost:2001".into(),
    "localhost:2000".into(),
  ),
  Proxy::new(
    "redis".into(),
    "localhost:6000".into(),
    "localhost:6379".into(),
  )
])?;

Testing with an unavailable connection:

TOXIPROXY.find_and_reset_proxy("redis")?.with_down(|| {
  // Calling the desired service...
})?;

Testing with toxics (for full documentation on available toxics see the original docs):

TOXIPROXY.find_and_reset_proxy("redis")?.with_latency("downstream".into(), 2000, 0, 1.0).apply(|| {
  // Calling the desired service...
})?;

Or without a safe lambda (that takes care of resetting a proxy):

TOXIPROXY.find_proxy("redis")?.with_latency("downstream".into(), 2000, 0, 1.0)
// Calling the desired service...

TOXIPROXY.find_proxy("redis")?.disable();
// Test unavailability.
TOXIPROXY.find_proxy("redis")?.enable();

Supported toxics:

Using a custom address for Toxiproxy server:

let toxiclient: Client = toxiproxy_rust::Client::new("1.2.3.4:5678");

Development

Tests:

$> cargo test -- --test-threads 1