#stream #async-stream #future #throttle #async #throttling

stream_throttle

Provides a Stream combinator, to limit the rate at which items are produced

6 releases (breaking)

0.5.1 Sep 5, 2023
0.4.0 Apr 7, 2021
0.3.1 Feb 9, 2020
0.2.1 Nov 11, 2018
0.1.1 May 31, 2018

#115 in Asynchronous

Download history 4999/week @ 2024-01-07 4902/week @ 2024-01-14 5991/week @ 2024-01-21 5380/week @ 2024-01-28 4363/week @ 2024-02-04 5744/week @ 2024-02-11 6713/week @ 2024-02-18 6060/week @ 2024-02-25 5621/week @ 2024-03-03 7282/week @ 2024-03-10 6504/week @ 2024-03-17 7049/week @ 2024-03-24 6374/week @ 2024-03-31 7968/week @ 2024-04-07 8185/week @ 2024-04-14 14669/week @ 2024-04-21

37,242 downloads per month
Used in 2 crates

MIT license

14KB
205 lines

stream_throttle

Provides a Rust Stream combinator, to limit the rate at which items are produced.

Crates.io API Documentation

Key Features

  • Throttling is implemented via poll(), and not via any sort of buffering.
  • The throttling behaviour can be applied to both Stream's and Future's.
  • Multiple streams/futures can be throttled together as a group.
  • Feature flags to use various timer implementations.

Feature Flags

  • timer-tokio: Uses the tokio::time::delay_for() timer.
  • timer-futures-timer: Uses the futures_timer::Delay timer.

If you don't use the default timer (tokio), make sure to set default-features = false in your Cargo.toml, when you add stream_throttle as a dependency.

Example throttling of Stream

// allow no more than 5 items every 1 second
let rate = ThrottleRate::new(5, Duration::new(1, 0));
let pool = ThrottlePool::new(rate);

let work = stream::repeat(())
  .throttle(pool)
  .then(|_| futures::future::ready("do something else"))
  .for_each(|_| futures::future::ready(()));
  
work.await;

Example throttling of Future

let rate = ThrottleRate::new(5, Duration::new(1, 0));
let pool = ThrottlePool::new(rate);

let work = pool.queue()
  .then(|_| futures::future::ready("do something else"));
  
work.await;

Dependencies

~0.7–2MB
~37K SLoC