made-core 0.8.0

Domain core of MADE: entities, value objects, events, ports. No IO.
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
85
86
87
88
89
90
91
92
93
94
95
96
97

use std::collections::{BTreeMap, BTreeSet};

use serde::{Deserialize, Serialize};

use crate::value_objects::{DefinitionPin, InputName, RoleId};

use super::{
    CeremonyActivation, CeremonyOutputRef, ParticipantId, SystemCeremonyId, SystemPurpose,
};

/// One ceremony this system composes, referenced and never owned.
///
/// The pin is the whole point: name and version say which definition,
/// the digest says which bytes, and a republished version is therefore
/// a different pin rather than a silent change of what the system does.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct CeremonyComposition {
    id: SystemCeremonyId,
    pin: DefinitionPin,
    purpose: SystemPurpose,
    #[serde(default, skip_serializing_if = "BTreeSet::is_empty")]
    depends_on: BTreeSet<SystemCeremonyId>,
    activation: CeremonyActivation,
    #[serde(default, skip_serializing_if = "BTreeMap::is_empty")]
    role_bindings: BTreeMap<RoleId, ParticipantId>,
    #[serde(default, skip_serializing_if = "BTreeMap::is_empty")]
    inputs_from: BTreeMap<InputName, CeremonyOutputRef>,
}

impl CeremonyComposition {
    #[must_use]
    pub fn new(
        id: SystemCeremonyId,
        pin: DefinitionPin,
        purpose: SystemPurpose,
        depends_on: impl IntoIterator<Item = SystemCeremonyId>,
        activation: CeremonyActivation,
        role_bindings: impl IntoIterator<Item = (RoleId, ParticipantId)>,
        inputs_from: impl IntoIterator<Item = (InputName, CeremonyOutputRef)>,
    ) -> Self {
        Self {
            id,
            pin,
            purpose,
            depends_on: depends_on.into_iter().collect(),
            activation,
            role_bindings: role_bindings.into_iter().collect(),
            inputs_from: inputs_from.into_iter().collect(),
        }
    }

    #[must_use]
    pub const fn id(&self) -> &SystemCeremonyId {
        &self.id
    }

    #[must_use]
    pub const fn pin(&self) -> &DefinitionPin {
        &self.pin
    }

    #[must_use]
    pub const fn purpose(&self) -> &SystemPurpose {
        &self.purpose
    }

    #[must_use]
    pub const fn depends_on(&self) -> &BTreeSet<SystemCeremonyId> {
        &self.depends_on
    }

    #[must_use]
    pub const fn activation(&self) -> &CeremonyActivation {
        &self.activation
    }

    /// Which logical participant sits in each seat the definition
    /// declares.
    #[must_use]
    pub const fn role_bindings(&self) -> &BTreeMap<RoleId, ParticipantId> {
        &self.role_bindings
    }

    #[must_use]
    pub const fn inputs_from(&self) -> &BTreeMap<InputName, CeremonyOutputRef> {
        &self.inputs_from
    }

    /// Every composition this one waits for: its declared dependencies
    /// plus the one its loop runs back to.
    #[must_use]
    pub fn predecessors(&self) -> BTreeSet<&SystemCeremonyId> {
        let mut every: BTreeSet<&SystemCeremonyId> = self.depends_on.iter().collect();
        every.extend(self.activation.loops_after());
        every
    }
}