#lazy-evaluation #initialization #cache

sloth

Provides a generic wrapper struct for lazy initialization

5 releases

0.2.0 Sep 3, 2019
0.1.3 Sep 1, 2019
0.1.2 Sep 1, 2019
0.1.1 Aug 31, 2019
0.1.0 Aug 31, 2019

#222 in Caching

Download history 1542/week @ 2024-01-29 670/week @ 2024-02-05 3/week @ 2024-02-12 15/week @ 2024-02-19 88/week @ 2024-02-26 63/week @ 2024-03-04 45/week @ 2024-03-11 31/week @ 2024-03-18 21/week @ 2024-03-25 36/week @ 2024-04-01 56/week @ 2024-04-08 28/week @ 2024-04-15 4/week @ 2024-04-22 120/week @ 2024-04-29 41/week @ 2024-05-06 28/week @ 2024-05-13

194 downloads per month

MIT/Apache

23KB
384 lines

docs.rs Build Status

sloth

This crate provides a generic pointer-like Lazy<T, Eval> struct for lazily initialized values. It can be used for expensive-to-calculate values to ensure that the evaluation logic runs only once and only if needed.

For example:

use sloth::Lazy;

fn get_expensive_string() -> String {
    // do something expensive here to obtain the result,
    // such as read and process file contents
    String::from("some expensive string we got from a file or something")
}

fn get_expensive_number() -> i32 {
    // do something expensive here to calculate the result,
    // such as build a supercomputer and wait 7.5 million years
    42
}

let lazy_string = Lazy::new(get_expensive_string);
let lazy_number = Lazy::new(get_expensive_number);

//...
let must_use_string = true;
//...

if must_use_string {
    println!("Expensive string is: {}", *lazy_string);
    println!("It has length: {}", lazy_string.len());

    // get_expensive_string() has been called only once,
    // get_expensive_number() has not been called
} else {
    println!("Expensive number is: {}", *lazy_number);
    println!("Its square is {}", lazy_number.pow(2));

    // get_expensive_string() has not been called,
    // get_expensive_number() has been called only once
}

The evaluated value of a mutable Lazy can be modified:

use sloth::Lazy;

let mut lazy_vec = Lazy::new(|| vec![2, -5, 6, 0]);

lazy_vec.retain(|n| *n > 0);

assert_eq!(*lazy_vec, vec![2, 6]);

Lazy can be consumed and turned into its value via unwrap():

use sloth::Lazy;

let lazy_value = Lazy::new(|| "moo");

let output = String::from("a cow goes ") + lazy_value.unwrap();

No runtime deps