ic-stable-structures 0.6.4

A collection of data structures for fearless canister upgrades.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

use crate::cell::{Cell, ValueError};
use crate::storable::Storable;
use crate::vec_mem::VectorMemory;
use crate::{Memory, RestrictedMemory, WASM_PAGE_SIZE};

fn reload<T: Default + Storable, M: Memory>(c: Cell<T, M>) -> Cell<T, M> {
    Cell::init(c.into_memory(), T::default()).unwrap()
}

#[test]
fn test_cell_init() {
    let mem = VectorMemory::default();
    let cell = Cell::init(mem, 1024u64).unwrap();
    assert_eq!(*cell.get(), 1024u64);
    let mem = cell.into_memory();
    assert_ne!(mem.size(), 0);
    let cell = Cell::init(mem, 0u64).unwrap();
    assert_eq!(1024u64, *cell.get());

    // Check that Cell::new overwrites the contents unconditionally.
    let cell = Cell::new(cell.into_memory(), 2048u64).unwrap();
    assert_eq!(2048u64, *cell.get());
}

#[test]
fn test_cell_init_empty() {
    let mem = VectorMemory::default();
    let cell = Cell::init(mem, vec![]).unwrap();
    assert_eq!(Vec::<u8>::new(), *cell.get());
}

#[test]
fn test_out_of_space() {
    let mem = RestrictedMemory::new(VectorMemory::default(), 0..1);
    let data = [1u8; 100];
    let mut cell = Cell::new(mem, data.to_vec()).unwrap();

    assert_eq!(&data[..], &cell.get()[..]);

    assert_eq!(
        Err(ValueError::ValueTooLarge {
            value_size: WASM_PAGE_SIZE,
        }),
        cell.set(vec![2u8; WASM_PAGE_SIZE as usize])
    );

    assert_eq!(&data[..], &cell.get()[..]);
}

#[test]
fn test_cell_grow_and_shrink() {
    let mem = VectorMemory::default();
    let mut cell = Cell::init(mem, vec![1u8; 10]).unwrap();

    cell.set(vec![2u8; 20]).unwrap();
    let mut cell = reload(cell);
    assert_eq!(&[2u8; 20][..], &cell.get()[..]);

    cell.set(vec![3u8; 5]).unwrap();
    let cell = reload(cell);
    assert_eq!(&[3u8; 5][..], &cell.get()[..]);
}