Struct ratelimit::Limiter

pub struct Limiter { /* fields omitted */ }

Single-threaded rate limiter.

Methods

impl Limiter

fn new() -> Limiter

create a new default ratelimit instance

Example

let mut r = Limiter::new();

fn configure() -> Builder

create a new Config for building a custom Limiter

Example

let mut r = Limiter::configure().build();

fn run(&mut self)

Run the limiter, intended for multi-threaded use

Example

let mut limiter = Limiter::new();

let mut handle = limiter.make_handle();

thread::spawn(move || { limiter.run(); });

handle.wait();

fn make_handle(&mut self) -> Handle

Create a Handle for multi-thread use

Example

let mut limiter = Limiter::new();

let mut handle = limiter.make_handle();

match handle.try_wait() {
    Ok(_) => {
        println!("not limited");
    },
    Err(_) => {
        println!("was limited");
    },
}

fn wait(&mut self)

Blocking wait for 1 token.

Example

let mut limiter = Limiter::new();
for i in -10..0 {
    println!("T {}...", i);
    limiter.wait();
}
println!("Ignition!");

fn wait_for(&mut self, count: usize)

Blocking wait for count tokens.

Example

let mut limiter = Limiter::new();
for i in 1..3 {
    println!("{}...", i);
    limiter.wait_for(i);
}

Trait Implementations

impl Default for Limiter

fn default() -> Limiter

Returns the "default value" for a type.