restor

Crates.iorestor
lib.rsrestor
version2.0.2
sourcesrc
created_at2019-04-14 22:24:25.495459
updated_at2019-06-16 14:07:06.181953
descriptionA dynamic resource storage system in rust.
homepage
repositoryhttps://github.com/OptimisticPeach/restor
max_upload_size
id127975
size99,409
Patrik Buhring (OptimisticPeach)

documentation

README

restor

Crates.io LOC A dyamic resource storage written in rust. It supports storage of multiple types and multiple entries and dynamic borrow checking with the help of RefCells, Mutexs and RwLocks from parking_lot. It also supports extracting and aqcuiring multiple types at once.

Example:

use restor::{DynamicStorage, make_storage};

fn main() {
    // Use the shorthand for creating storage with preallocated types 
    let x = make_storage!(DynamicStorage: usize, String);
    // Insert some data into the storage, either many at once, or one
    x.insert_many((0..10).collect::<Vec<usize>>()).unwrap();
    x.insert("abc".to_string()).unwrap();
    create_string(&x);
    println!("{}", &*x.get::<&String>().unwrap());
}

fn create_string(x: &DynamicStorage) {
    let mut mystring = x.get::<&mut String>().unwrap();
    for i in x.get::<&[usize]>().unwrap().iter() {
        *mystring = format!("{}, {}", &*mystring, i);
    }
}

How it works:

BlackBox (Or DynamicStorage) is defined as so (More or less):

struct BlackBox {
    data: HashMap<TypeId, Box<dyn Unit>>
}

The Unit trait allows us to abstract over the generic type of the container (Referred to as UnitStorage in the code), so we can pass data in and out of it by using the seemingly magical Any trait. When you insert something into the storage it goes through these stages:

  1. Your data in BlackBox::insert<T>
  2. Boxed into a Box<dyn Any>
  3. Passed to the StorageUnit as dyn Unit
  4. Try to downcast as either a T or a Vec<T>
  5. Put into its own place in the storage or in a Vec
Commit count: 104

cargo fmt