4 releases

0.2.0 Feb 5, 2020
0.1.2 Jan 31, 2020
0.1.1 Jan 29, 2020
0.1.0 Jan 28, 2020

#321 in Memory management

Download history 31/week @ 2024-03-14 7/week @ 2024-03-21 17/week @ 2024-03-28 19/week @ 2024-04-04 16/week @ 2024-04-11 22/week @ 2024-04-18 41/week @ 2024-04-25 69/week @ 2024-05-02 18/week @ 2024-05-09 18/week @ 2024-05-16 32/week @ 2024-05-23 63/week @ 2024-05-30 73/week @ 2024-06-06 63/week @ 2024-06-13 64/week @ 2024-06-20 86/week @ 2024-06-27

297 downloads per month
Used in 3 crates

MIT license

18KB
203 lines

memory-cache-rs

Simple local in-memory cache for Rust.

  1. Example
  2. Memoization
  3. Breaking Changes
  4. Licence

Example

use std::time::Duration;
use memory_cache::MemoryCache;

let mut cache = MemoryCache::new();

let key: &'static str = "key";
let value: &'static str = "Hello, World!";

// `None` - if the value must be kept forever.
let lifetime = Some(Duration::from_secs(30));

cache.insert(key, value, lifetime);

assert_eq!(cache.get(&key), Some(&value));

Memoization

use once_cell::sync::Lazy;
use std::sync::Mutex;
use memory_cache::{MemoryCache, cached};

cached! {
    fn factorial(x: u128) -> u128 = {
        if x <= 1 {
            1
        } else {
            x * factorial(x - 1)
        }
    }
}

assert_eq!(factorial(21), 51090942171709440000);

Breaking Changes:

0.2.0:

Constructors:

- MemoryCache::new(full_scan_frequency: Duration) -> Self
+ MemoryCache::new() -> Self
+ MemoryCache::with_full_scan(full_scan_frequency: Duration) -> Self

Renamed Methods:

To look like a HashMap.

MemoryCache<A, B> {

-   fn has_key(&self, key: &A) -> bool
+   fn contains_key(&self, key: &A) -> bool

-   fn set(&mut self, key: A, value: B, duration: Option<Duration>) -> Option<B>
+   fn insert(&mut self, key: A, value: B, lifetime: Option<Duration>) -> Option<B>

-   fn get_or_set<F>(&mut self, key: A, factory: F, duration: Option<Duration>) -> &B
+   fn get_or_insert<F>(&mut self, key: A, factory: F, lifetime: Option<Duration>) -> &B

}

Changed types of parameters/results:

MemoryCache<A, B> {

-   fn get_full_scan_frequency(&self) -> &Duration
+   fn get_full_scan_frequency(&self) -> Option<Duration>

}

Licence

MIT

Dependencies

~48KB