tftio-prompter 4.0.0

A CLI tool for composing reusable prompt snippets from a library using TOML profiles
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
64
65
66
67
68
69
70
71
72

//! Error types for the prompter crate.

use crate::profile::ResolveError;
use std::path::PathBuf;

/// All errors that can occur during prompter configuration loading, profile
/// resolution, rendering, and scaffolding.
///
/// Each variant names a distinct failure mode a caller might branch on.
/// Variants that carry a bare `String` do so only for human-facing context
/// (a library/serializer message, a clap usage string) that callers merely
/// display rather than match on.
#[derive(thiserror::Error, Debug)]
pub enum PrompterError {
    /// An I/O operation failed, annotated with the path it concerned.
    #[error("Failed to access {path}: {source}")]
    Io {
        /// The filesystem path the failing operation targeted.
        path: PathBuf,
        /// The underlying I/O error.
        source: std::io::Error,
    },

    /// A write to an output sink failed.
    #[error("Write error: {0}")]
    Write(std::io::Error),

    /// The home directory could not be located (`$HOME` unset).
    #[error("$HOME not set")]
    HomeNotSet,

    /// The current working directory could not be resolved.
    #[error("Failed to resolve working directory: {0}")]
    WorkingDir(std::io::Error),

    /// A config file path lacked a parent directory.
    #[error("Config path {0} has no parent directory")]
    NoParentDir(PathBuf),

    /// The TOML in a config file was syntactically invalid.
    #[error("Invalid TOML: {0}")]
    InvalidToml(#[from] toml::de::Error),

    /// A reserved top-level config field had the wrong type or shape.
    #[error("{0}")]
    ConfigField(String),

    /// A profile name was defined more than once across the merged bundle.
    #[error("{0}")]
    DuplicateProfile(String),

    /// An `import` chain referred back to a config file already being loaded.
    #[error("Import cycle detected at {0}")]
    ImportCycle(PathBuf),

    /// A profile dependency could not be resolved.
    #[error(transparent)]
    Resolve(#[from] ResolveError),

    /// Validation found one or more problems; the message aggregates them.
    #[error("{0}")]
    Validation(String),

    /// A value could not be serialized to JSON.
    #[error("JSON serialization error: {0}")]
    Json(#[from] serde_json::Error),

    /// Command-line arguments could not be parsed; the payload is clap's
    /// formatted usage/error text, shown to the user verbatim.
    #[error("{0}")]
    ArgParse(String),
}