Tote

A lightweight data cache for CLI libraries

For CLIs that query a default set of information with each invocation, Tote offers a convenient way to cache data to a file for quicker subsequent CLI runs.

```rust use std::time::Duration; use asynctrait::asynctrait; use serde_derive::{Serialize, Deserialize}; use tote::{Fetch, Tote, Result};

// Implement serde's Serialize/Deserialize for you own data // or make a NewType and derive so Tote can read and write the cached data

[derive(Debug, Deserialize, Serialize)]

struct MyData(Vec);

[async_trait]

impl Fetch for MyData { async fn fetch() -> Result { // This would likely do some I/O to fetch common data Ok(MyData(vec!["Larkspur".toowned(), "Lavender".toowned(), "Periwinkle".to_owned()])) } }

[tokio::main]

async fn main () -> Result<()> { // Create a Tote at the given path, with data expiry of 1 day let cache: Tote = Tote::new("./colors.cache", Duration::from_secs(86400));

// This `.get().await` call will use data cached in "colors.cache" if:
// - The file exists & has valid data
// - The file has been modified in the past 1 day
// Otherwise `MyData::fetch` is called to get the data and populate the cache file
let available_colors = cache.get().await?;
println!("Colors you can use are: {:?}", available_colors);
Ok(())

} ```