1 unstable release

0.1.0 Jan 13, 2023

#83 in Caching

Download history 29/week @ 2023-01-12 28/week @ 2023-01-19 74/week @ 2023-01-26 41/week @ 2023-02-02 39/week @ 2023-02-09 31/week @ 2023-02-16 13/week @ 2023-02-23 40/week @ 2023-03-02 23/week @ 2023-03-09

119 downloads per month


190 lines

Cache for controlling and reducing IO calls


This caching library has been designed for specific use-cases where:

  • getting a "fresh" value can be time consuming and can fail (eg. IOs with hardware)
  • getting multiple values at once can be more efficient than getting each value independantly.

Typically, its primary use was to retrieve position/speed/temperature/etc from multiple motors using serial communication. In this setup, the motors are daisy chained, and in the protocol used to communicate with them, a specific message can be used to retrieve a register value for multiple motors at once.

Many other caching implementations exist than can better fit other need.



use cache_cache::Cache;
use std::{error::Error, time::Duration};

fn get_position(ids: &[u8]) -> Result<Vec<f64>, Box<dyn Error>> {
    // For simplicity, this function always work.
    // But it's a mockup for a real world scenario where hardware IO can fail.
    Ok(ids.iter().map(|&id| id as f64 * 10.0).collect())

fn main() {
    let mut present_position = Cache::with_expiry_duration(Duration::from_millis(10));

    present_position.insert(10, 0.0);

    let pos = present_position
        .entries(&[10, 11, 12])

    assert_eq!(pos.unwrap(), vec![&0.0, &110.0, &120.0]);

See https://docs.rs/cache_cache for more information on APIs and examples.


This library is licensed under the Apache License 2.0.


It's developed and maintained by Pollen-Robotics. They developped open-source tools for robotics manipulation. Visit https://pollen-robotics.com to learn more or join our Dicord community if you have any questions or want to share your ideas.

No runtime deps