slave-framework 0.13.1

Runtime for slave apps (a Laravel-inspired Rust framework for MCP-first apps): server lifecycle, config, logging, a SurrealDB database with SurrealQL migrations, and OpenID Connect sign-in
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

use std::io;

/// Errors raised by the slave runtime.
#[derive(Debug, thiserror::Error)]
pub enum Error {
    #[error("failed to load .env file: {0}")]
    Dotenv(#[from] dotenvy::Error),

    #[error("invalid value {value:?} for environment variable {key}: {reason}")]
    InvalidEnv {
        key: String,
        value: String,
        reason: String,
    },

    #[error("failed to initialize logging: {0}")]
    Logging(String),

    #[error("failed to bind to {addr}: {source}")]
    Bind {
        addr: String,
        #[source]
        source: io::Error,
    },

    #[error("server error: {0}")]
    Server(#[source] io::Error),

    /// A sign-in that cannot go ahead, worded for the user (e.g. a wrong
    /// email address, or too many codes).
    #[cfg(feature = "auth")]
    #[error("{0}")]
    Auth(String),

    #[cfg(feature = "auth")]
    #[error("sign-in setup: {0}")]
    AuthSetup(String),

    #[cfg(feature = "database")]
    #[error("database error: {0}")]
    Database(#[from] surrealdb::Error),

    #[cfg(feature = "database")]
    #[error("{0} is not set")]
    MissingDatabaseSetting(&'static str),

    #[cfg(feature = "database")]
    #[error("migration failed: {0}")]
    Migration(String),
}

/// Shorthand for results returned by the slave runtime.
pub type Result<T, E = Error> = std::result::Result<T, E>;