trellis-core 0.1.0

Deterministic reactive resource graph core types.
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

use crate::{
    DependencyList, GraphError, GraphResult, MaterializedOutput, OutputContext, OutputError,
    OutputMeta, OutputOptions, RebaselineReason, Transaction, output::OutputSpec,
};

impl<C: 'static, O> Transaction<'_, C, O>
where
    O: Clone + PartialEq + 'static,
{
    /// Stages creation of a materialized output with default options.
    pub fn materialized_output(
        &mut self,
        debug_name: impl Into<String>,
        scope: crate::ScopeId,
        dependencies: DependencyList,
        materialize: impl for<'ctx> Fn(&OutputContext<'ctx, C, O>) -> Result<O, OutputError> + 'static,
    ) -> GraphResult<MaterializedOutput<O>> {
        self.materialized_output_with_options(
            debug_name,
            scope,
            dependencies,
            OutputOptions::default(),
            materialize,
        )
    }

    /// Stages creation of a materialized output with explicit options.
    pub fn materialized_output_with_options(
        &mut self,
        debug_name: impl Into<String>,
        scope: crate::ScopeId,
        dependencies: DependencyList,
        options: OutputOptions,
        materialize: impl for<'ctx> Fn(&OutputContext<'ctx, C, O>) -> Result<O, OutputError> + 'static,
    ) -> GraphResult<MaterializedOutput<O>> {
        self.ensure_open()?;
        self.working.require_scope_open(scope)?;
        let key = self.graph.allocate_output_key();
        self.working.validate_output_dependencies(&dependencies)?;
        self.working.outputs.insert(
            key,
            OutputMeta::new(
                key,
                debug_name,
                scope,
                dependencies.clone(),
                options,
                self.working.revision,
            ),
        );
        self.working
            .output_specs
            .insert(key, OutputSpec::new(materialize));
        self.graph_mutated = true;
        Ok(MaterializedOutput::new(key))
    }

    /// Stages an explicit output rebaseline.
    pub fn rebaseline_output(&mut self, output: MaterializedOutput<O>) -> GraphResult<()> {
        self.ensure_open()?;
        let meta = self
            .working
            .output_meta(output.key())
            .ok_or(GraphError::UnknownOutput(output.key()))?;
        self.working.require_scope_open(meta.scope())?;
        self.staged_output_rebaselines
            .insert(output.key(), RebaselineReason::Requested);
        self.graph_mutated = true;
        Ok(())
    }
}