hyperi-rustlib 2.6.0

Opinionated Rust framework for high-throughput data pipelines at PB scale. Auto-wiring config, logging, metrics, tracing, health, and graceful shutdown — built from many years of production infrastructure experience.
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

// Project:   hyperi-rustlib
// File:      src/directory_config/error.rs
// Purpose:   Error types for DirectoryConfigStore
// Language:  Rust
//
// License:   FSL-1.1-ALv2
// Copyright: (c) 2026 HYPERI PTY LIMITED

use thiserror::Error;

/// Errors from directory config store operations.
#[derive(Debug, Error)]
pub enum DirectoryConfigError {
    /// Invalid table name (path traversal, backslash, etc.).
    #[error("invalid table name: {0}")]
    InvalidTableName(String),

    /// Store has not been started.
    #[error("store not started")]
    NotStarted,

    /// Store is already running.
    #[error("store already running")]
    AlreadyRunning,

    /// Table (YAML file) not found.
    #[error("table not found: {0}")]
    TableNotFound(String),

    /// Key not found within a table.
    #[error("key '{key}' not found in table '{table}'")]
    KeyNotFound { table: String, key: String },

    /// Table already exists (on create).
    #[error("table already exists: {0}")]
    TableExists(String),

    /// Store is read-only, writes not permitted.
    #[error("store is read-only")]
    ReadOnly,

    /// YAML parse error.
    #[error("YAML parse error in '{file}': {message}")]
    ParseError { file: String, message: String },

    /// YAML serialisation error.
    #[error("YAML serialisation error: {0}")]
    SerializationError(String),

    /// I/O error.
    #[error("I/O error: {0}")]
    IoError(#[from] std::io::Error),

    /// Directory does not exist or is not a directory.
    #[error("directory not found: {0}")]
    DirectoryNotFound(String),

    /// Git operation failed.
    #[cfg(feature = "directory-config-git")]
    #[error("git error: {0}")]
    GitError(String),

    /// Git not available but git operation requested.
    #[error("not a git repository")]
    NotGitRepo,
}

/// Result type alias for directory config operations.
pub type DirectoryConfigResult<T> = Result<T, DirectoryConfigError>;