slave-framework 0.1.0

Runtime for slave apps: Axum server lifecycle, config, logging, Turso database, migrations and password/token auth
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

use std::io;
#[cfg(feature = "database")]
use std::path::PathBuf;

/// 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 = "auth")]
    #[error("{0}")]
    Auth(String),

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

    #[cfg(feature = "database")]
    #[error("failed to create database directory {}: {source}", path.display())]
    DatabaseDirectory {
        path: PathBuf,
        #[source]
        source: io::Error,
    },

    #[cfg(feature = "database")]
    #[error("statement {index} failed: {source}")]
    Statement {
        index: usize,
        #[source]
        source: turso::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>;