claude_wrapper/
error.rs

1use std::path::PathBuf;
2
3/// Errors returned by claude-wrapper operations.
4#[derive(Debug, thiserror::Error)]
5pub enum Error {
6    /// The `claude` binary was not found in PATH.
7    #[error("claude binary not found in PATH")]
8    NotFound,
9
10    /// A claude command failed with a non-zero exit code.
11    #[error("claude command failed: {command} (exit code {exit_code}){}{}{}", working_dir.as_ref().map(|d| format!(" (in {})", d.display())).unwrap_or_default(), if stdout.is_empty() { String::new() } else { format!("\nstdout: {stdout}") }, if stderr.is_empty() { String::new() } else { format!("\nstderr: {stderr}") })]
12    CommandFailed {
13        command: String,
14        exit_code: i32,
15        stdout: String,
16        stderr: String,
17        working_dir: Option<PathBuf>,
18    },
19
20    /// An I/O error occurred while spawning or communicating with the process.
21    #[error("io error: {message}{}", working_dir.as_ref().map(|d| format!(" (in {})", d.display())).unwrap_or_default())]
22    Io {
23        message: String,
24        #[source]
25        source: std::io::Error,
26        working_dir: Option<PathBuf>,
27    },
28
29    /// The command timed out.
30    #[error("claude command timed out after {timeout_seconds}s")]
31    Timeout { timeout_seconds: u64 },
32
33    /// JSON parsing failed.
34    #[cfg(feature = "json")]
35    #[error("json parse error: {message}")]
36    Json {
37        message: String,
38        #[source]
39        source: serde_json::Error,
40    },
41
42    /// The installed CLI version does not meet the minimum requirement.
43    #[error("CLI version {found} does not meet minimum requirement {minimum}")]
44    VersionMismatch {
45        found: crate::version::CliVersion,
46        minimum: crate::version::CliVersion,
47    },
48
49    /// Construction of a `dangerous::Client` was attempted without
50    /// the opt-in env-var set. The env-var name is a compile-time
51    /// constant exported from [`crate::dangerous::ALLOW_ENV`].
52    #[error(
53        "dangerous operations are not allowed; set the env var `{env_var}=1` at process start if you really mean it"
54    )]
55    DangerousNotAllowed { env_var: &'static str },
56}
57
58impl From<std::io::Error> for Error {
59    fn from(e: std::io::Error) -> Self {
60        Self::Io {
61            message: e.to_string(),
62            source: e,
63            working_dir: None,
64        }
65    }
66}
67
68/// Result type alias for claude-wrapper operations.
69pub type Result<T> = std::result::Result<T, Error>;
70
71#[cfg(test)]
72mod tests {
73    use super::*;
74
75    fn command_failed(stdout: &str, stderr: &str, working_dir: Option<PathBuf>) -> Error {
76        Error::CommandFailed {
77            command: "/bin/claude --print".to_string(),
78            exit_code: 7,
79            stdout: stdout.to_string(),
80            stderr: stderr.to_string(),
81            working_dir,
82        }
83    }
84
85    #[test]
86    fn command_failed_display_includes_command_and_exit_code() {
87        let e = command_failed("", "", None);
88        let s = e.to_string();
89        assert!(s.contains("/bin/claude --print"));
90        assert!(s.contains("exit code 7"));
91    }
92
93    #[test]
94    fn command_failed_display_omits_empty_stdout_and_stderr() {
95        let s = command_failed("", "", None).to_string();
96        assert!(!s.contains("stdout:"));
97        assert!(!s.contains("stderr:"));
98    }
99
100    #[test]
101    fn command_failed_display_includes_nonempty_stdout() {
102        let s = command_failed("hello", "", None).to_string();
103        assert!(s.contains("stdout: hello"));
104    }
105
106    #[test]
107    fn command_failed_display_includes_nonempty_stderr() {
108        let s = command_failed("", "boom", None).to_string();
109        assert!(s.contains("stderr: boom"));
110    }
111
112    #[test]
113    fn command_failed_display_includes_both_streams_when_present() {
114        let s = command_failed("out", "err", None).to_string();
115        assert!(s.contains("stdout: out"));
116        assert!(s.contains("stderr: err"));
117    }
118
119    #[test]
120    fn command_failed_display_includes_working_dir_when_present() {
121        let s = command_failed("", "", Some(PathBuf::from("/tmp/proj"))).to_string();
122        assert!(s.contains("/tmp/proj"));
123    }
124
125    #[test]
126    fn command_failed_display_omits_working_dir_when_absent() {
127        let s = command_failed("", "", None).to_string();
128        assert!(!s.contains("(in "));
129    }
130
131    #[test]
132    fn timeout_display_formats_seconds() {
133        let s = Error::Timeout {
134            timeout_seconds: 42,
135        }
136        .to_string();
137        assert!(s.contains("42s"));
138    }
139
140    #[test]
141    fn io_error_display_includes_working_dir_when_present() {
142        let e = Error::Io {
143            message: "spawn failed".to_string(),
144            source: std::io::Error::new(std::io::ErrorKind::NotFound, "no file"),
145            working_dir: Some(PathBuf::from("/work")),
146        };
147        let s = e.to_string();
148        assert!(s.contains("spawn failed"));
149        assert!(s.contains("/work"));
150    }
151}
claude_wrapper/error.rs

claude_wrapper/
error.rs
