devela 0.29.0

A development substrate of coherence.
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

// devela/src/data/store/_.rs
//
#![doc = crate::_DOC_DATA_STORE!()] // public
#![doc = crate::_doc!(modules: crate::data; store: arena, key, pool)] // cache, db, intern
#![doc = crate::_doc!(flat:"data")]
#![doc = crate::_doc!(extends: collections)]
//!
//! Storage governs how values remain and are recovered.
//!
//! A store retains values across operations and defines how they are inserted,
//! retrieved, reclaimed, and potentially reused.
//!
//! [`Layout`](crate::data::layout) describes arrangement and occupancy.
//! [`Identity`](crate::data::id) distinguishes one entity from another.
//! Storage determines the lifecycle of the retained values themselves.
//!
//! - [`Arenas`](mod@arena) advance monotonically and reclaim storage collectively.
// - [`Caches`](cache) retain computed or retrieved values to avoid repeated work.
// - [`Databases`](db) persist and query structured data under schema and transaction policies.
// - [`Interners`](intern) canonicalize equal values into shared representatives.
//! - [`Keyed stores`](key) recover values through keys and lookup structures.
//! - [`Pools`](mod@pool) reclaim and reuse individual slots.
//

crate::mods_in! {
    pub mod_ arena; // Monotonic stores with stable handles and collective reclamation
    // mod cache; // Stores that retain values to reduce recomputation or retrieval cost
    // mod db; // Persistent queryable stores with schema and transactional semantics
    pub mod_ intern; // Canonical stores for deduplicated values and shared identity
    pub mod_ key; // Keyed stores and lookup structures
    pub mod_ pool; // Reusable stores with stable handles and individual reclamation
}
crate::mods_out! { // _mods, _pub_mods, _reexports, _hidden
    _mods {
        pub use super::{
            // cache::_all::*,
            // db::_all::*,
        };
    }
    _pub_mods {
        pub use super::{
            arena::_all::*,
            intern::_all::*,
            key::_all::*,
            pool::_all::*,
        };
    }
    _reexports {
        #[doc(inline)]
        pub use super::{
            arena::arena,
            intern::intern_string,
            key::map::map,
            pool::pool,
        };
    }
    _hidden {
        pub use super::{
            arena::_hidden::*,
            intern::_hidden::*,
            key::_hidden::*,
            pool::_hidden::*,
        };
    }
}