microde-application 0.4.0

Composition and lifecycle runtime for modular Microde applications.
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

use std::fmt::{self, Debug, Formatter};
use std::marker::PhantomData;

use crate::MicrodeModule;

/// Stable identity of one installed module instance.
#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
pub struct ModuleInstanceId(String);

impl ModuleInstanceId {
    pub fn new(value: impl Into<String>) -> Self {
        Self(value.into())
    }

    pub fn as_str(&self) -> &str {
        &self.0
    }
}

/// Opaque binding target for one installed module instance.
pub struct ModuleHandle<Module: MicrodeModule> {
    id: ModuleInstanceId,
    pub(crate) owner: u64,
    module: PhantomData<fn() -> Module>,
}

#[doc(hidden)]
pub trait ModuleHandleIdentity {
    fn module_instance_id(&self) -> &ModuleInstanceId;
    fn composition_owner(&self) -> u64;
}

impl<Module: MicrodeModule> Debug for ModuleHandle<Module> {
    fn fmt(&self, formatter: &mut Formatter<'_>) -> fmt::Result {
        formatter
            .debug_struct("ModuleHandle")
            .field("id", &self.id)
            .finish_non_exhaustive()
    }
}

impl<Module: MicrodeModule> ModuleHandle<Module> {
    pub(crate) fn new(id: ModuleInstanceId, owner: u64) -> Self {
        Self {
            id,
            owner,
            module: PhantomData,
        }
    }

    pub fn id(&self) -> &ModuleInstanceId {
        &self.id
    }
}

impl<Module: MicrodeModule> ModuleHandleIdentity for ModuleHandle<Module> {
    fn module_instance_id(&self) -> &ModuleInstanceId {
        &self.id
    }
    fn composition_owner(&self) -> u64 {
        self.owner
    }
}

#[cfg(test)]
mod tests {
    use crate::{Dependency, Port, Reference};

    trait Database: Send + Sync {}

    #[test]
    fn declares_independent_typed_relationship_slots() {
        let port = Port::<dyn Database>::new("database");
        let first = Dependency::new("database", port.clone());
        let second = Dependency::new("database", port.clone());
        let peer = Reference::new("peer", port);

        assert_eq!(first.name(), "database");
        assert_eq!(first.port().description(), "database");
        assert_ne!(first.slot_id(), second.slot_id());
        assert_eq!(peer.name(), "peer");
        assert_eq!(peer.port().description(), "database");
    }
}