unistore 0.4.0

simple storage abstraction that works on wasm and native Targets
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
63
64
65
66
67

use crate::{AsKey, Error, Key, Value, index::UniIndex};
pub trait UniStoreItem: Value + 'static {
    type Key: Key + 'static;

    fn table() -> impl Future<Output = &'static crate::UniTable<'static, Self::Key, Self>>;
    fn unistore_key(&self) -> Self::Key;

    #[must_use]
    fn index_table(
        index: &'static str,
    ) -> impl Future<Output = Result<&'static UniIndex<'static, String, Self::Key, Self>, Error>>
    {
        futures::future::ready(Err(Error::MissingIndex(index)))
    }

    /// This function is called to insert indices for the item.
    /// It is a no-op by default, but can be overridden in the implementation.
    /// It is called by default when the item is inserted into the table using the traits `insert` method.
    fn insert_indices(&self) -> impl Future<Output = Result<(), Error>> {
        futures::future::ready(Ok(()))
    }

    fn get(key: impl AsKey<Self::Key>) -> impl Future<Output = Result<Option<Self>, crate::Error>> {
        async move {
            let table = Self::table().await;
            table.get(key).await
        }
    }
    fn get_by_index<I: Key>(
        index: &'static str,
        key: impl AsKey<I>,
    ) -> impl Future<Output = Result<Vec<(Self::Key, Self)>, crate::Error>> {
        async move {
            let table = Self::index_table(index).await?;
            table.get(key.as_key().to_key_string()).await
        }
    }
    fn get_first_by_index(
        index: &'static str,
        key: impl AsKey<String>,
    ) -> impl Future<Output = Result<Option<(Self::Key, Self)>, crate::Error>> {
        async move {
            let table = Self::index_table(index).await?;
            table.get_first(key).await
        }
    }
    fn save(&self) -> impl Future<Output = Result<(), crate::Error>> {
        let key = self.unistore_key();
        async move {
            self.insert_indices().await?;
            let table = Self::table().await;
            table.insert(key, self).await
        }
    }
    fn contains(key: impl AsKey<Self::Key>) -> impl Future<Output = Result<bool, crate::Error>> {
        async move {
            let table = Self::table().await;
            table.contains(key).await
        }
    }
    fn remove(key: impl AsKey<Self::Key>) -> impl Future<Output = Result<(), crate::Error>> {
        async move {
            let table = Self::table().await;
            table.remove(key).await
        }
    }
}