daedalus-engine 0.1.1

High-level engine facade for planning and running Daedalus graphs.
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

use std::io;
use thiserror::Error;

use daedalus_planner::Diagnostic;
use daedalus_registry::diagnostics::RegistryError;
use daedalus_runtime::executor::ExecuteError;

/// Engine errors surfaced to callers.
///
/// ```
/// use daedalus_engine::EngineError;
/// let err = EngineError::FeatureDisabled("gpu");
/// assert!(format!("{err}").contains("gpu"));
/// ```
#[derive(Debug, Error)]
#[non_exhaustive]
pub enum EngineError {
    #[error("invalid configuration: {0}")]
    Config(String),
    #[error("I/O error at {path}: {source}")]
    Io {
        path: String,
        #[source]
        source: io::Error,
    },
    #[error("registry error: {0}")]
    Registry(#[from] RegistryError),
    #[error("planner diagnostics: {0:?}")]
    Planner(Vec<Diagnostic>),
    #[error("runtime failed: {0}")]
    Runtime(#[from] ExecuteError),
    #[error("bundle parse error at {path}: {error}")]
    BundleParse { path: String, error: String },
    #[cfg(feature = "gpu")]
    #[error("gpu selection failed: {0}")]
    Gpu(#[from] daedalus_gpu::GpuError),
    #[error("feature '{0}' is disabled at compile time")]
    FeatureDisabled(&'static str),
}

impl EngineError {
    /// Convenience constructor for I/O errors.
    pub fn io(path: impl Into<String>, source: io::Error) -> Self {
        EngineError::Io {
            path: path.into(),
            source,
        }
    }
}