melodium-engine 0.10.0

Mélodium core engine and executor implementation
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
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

use crate::building::builder::get_value;
use crate::building::{
    BuildId, CheckBuildResult, CheckEnvironment, CheckStep, ContextualEnvironment,
    DynamicBuildResult, GenesisEnvironment, StaticBuildResult,
};
use crate::building::{Builder as BuilderTrait, HostTreatment};
use crate::debug::Event;
use crate::design::Model;
use crate::error::LogicResult;
use crate::world::World;
use core::fmt::Debug;
use melodium_common::descriptor::{Model as ModelDescriptor, Parameterized};
use std::sync::{Arc, Weak};

#[derive(Debug)]
pub struct Builder {
    world: Weak<World>,
    design: Arc<Model>,
}

impl Builder {
    pub fn new(world: Weak<World>, design: Arc<Model>) -> Self {
        Self { world, design }
    }
}

impl BuilderTrait for Builder {
    fn static_build(
        &self,
        host_treatment: HostTreatment,
        host_build: Option<BuildId>,
        label: String,
        environment: &GenesisEnvironment,
    ) -> LogicResult<StaticBuildResult> {
        let mut environment = environment.clone();
        let mut remastered_environment = GenesisEnvironment::new();
        let descriptor = self.design.descriptor.upgrade().unwrap();

        // Assigning missing default values
        for (name, parameter) in descriptor
            .parameters()
            .iter()
            .filter(|(_, p)| p.default().is_some())
        {
            if !environment.variables().contains_key(name) {
                environment.add_variable(name, parameter.default().as_ref().unwrap().clone());
            }
        }

        // Assigning explicit data
        for (_, parameter) in self.design.parameters.iter() {
            let data = get_value(&parameter.value, &environment, None)
                .expect("Impossible data recoverage");

            remastered_environment.add_variable(&parameter.name, data.clone());
        }

        let world = self.world.upgrade().unwrap();

        world.send_debug(Event::new(crate::debug::EventKind::ModelBuilt {
            model: Arc::clone(&descriptor) as Arc<dyn ModelDescriptor>,
            parameters: remastered_environment.variables().clone(),
            host_treatment: host_treatment.clone(),
            host_build,
            label: label.clone(),
        }));

        world
            .builder(descriptor.base_model().unwrap().identifier())
            .and_then(|builder| {
                builder.static_build(host_treatment, host_build, label, &remastered_environment)
            })
    }

    fn dynamic_build(
        &self,
        _build: BuildId,
        _with_inputs: Vec<String>,
        _environment: &ContextualEnvironment,
    ) -> Option<DynamicBuildResult> {
        // Doing nothing, models are not supposed to have dynamic building phase

        None
    }

    fn give_next(
        &self,
        _within_build: BuildId,
        _for_label: String,
        _for_outputs: Vec<String>,
        _environment: &ContextualEnvironment,
    ) -> Option<DynamicBuildResult> {
        // Doing nothing, models are not supposed to have dynamic building phase

        None
    }

    fn check_dynamic_build(
        &self,
        _build: BuildId,
        _environment: CheckEnvironment,
        _previous_steps: Vec<CheckStep>,
    ) -> Option<CheckBuildResult> {
        // Doing nothing, models are not supposed to have dynamic building phase

        None
    }

    fn check_give_next(
        &self,
        _within_build: BuildId,
        _for_label: String,
        _environment: CheckEnvironment,
        _previous_steps: Vec<CheckStep>,
    ) -> Option<CheckBuildResult> {
        // Doing nothing, models are not supposed to have dynamic building phase

        None
    }
}