slave-framework 0.6.0

Runtime for slave apps (a Laravel-inspired Rust framework for MCP-first apps): server lifecycle, config, logging, Turso Cloud database and 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
54
55
56
57
58
59
60
61
62
63

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),

    #[cfg(feature = "oidc")]
    #[error("{0} is not set. {hint}", hint = crate::oidc::SETUP_HINT)]
    MissingOidcSetting(&'static str),

    #[cfg(feature = "oidc")]
    #[error("OpenID Connect: {0}")]
    Oidc(String),

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

    #[cfg(feature = "database")]
    #[error("{0} is not set. {hint}", hint = crate::database::SETUP_HINT)]
    MissingDatabaseUrl(&'static str),

    #[cfg(feature = "database")]
    #[error("statement {index} failed: {source}")]
    Statement {
        index: usize,
        #[source]
        source: libsql::Error,
    },

    #[cfg(feature = "database")]
    #[error("migration `{0}` is registered more than once")]
    DuplicateMigration(String),

    #[cfg(feature = "database")]
    #[error("cannot roll back batch {batch}: {reason}")]
    RollbackRefused { batch: i64, reason: String },
}

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