Struct opendal::layers::ChaosLayer

pub struct ChaosLayer { /* private fields */ }

Inject chaos into underlying services for robustness test.

Chaos

Chaos tests is a part of stress test. By generating errors at specified error ratio, we can reproduce underlying services error more reliable.

Running tests under ChaosLayer will make your application more robust.

For example: If we specify an error rate of 0.5, there is a 50% chance of an EOF error for every read operation.

Note

For now, ChaosLayer only injects read operations. More operations may be added in the future.

Examples

use anyhow::Result;
use opendal::layers::ChaosLayer;
use opendal::services;
use opendal::Operator;
use opendal::Scheme;

let _ = Operator::new(services::Memory::default())
    .expect("must init")
    .layer(ChaosLayer::new(0.1))
    .finish();

Implementations

impl ChaosLayer

pub fn new(error_ratio: f64) -> Self

Create a new chaos layer with specified error ratio.

Panics

Input error_ratio must in [0.0..=1.0]

Trait Implementations

impl Clone for ChaosLayer

fn clone(&self) -> ChaosLayer

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ChaosLayer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<A: Accessor> Layer<A> for ChaosLayer

type LayeredAccessor = ChaosAccessor<A>

The layered accessor that return by this layer.

fn layer(&self, inner: A) -> Self::LayeredAccessor

Intercept the operations on the underlying storage.