brainwires-hardware 0.10.0

Hardware I/O for the Brainwires Agent Framework — audio, GPIO, Bluetooth, and network
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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

use thiserror::Error;

/// Errors that can occur during audio operations.
#[derive(Debug, Error)]
pub enum AudioError {
    /// Audio device not found or unavailable.
    #[error("device error: {0}")]
    Device(String),

    /// Audio capture failed.
    #[error("capture error: {0}")]
    Capture(String),

    /// Audio playback failed.
    #[error("playback error: {0}")]
    Playback(String),

    /// Speech-to-text transcription failed.
    #[error("transcription error: {0}")]
    Transcription(String),

    /// Text-to-speech synthesis failed.
    #[error("synthesis error: {0}")]
    Synthesis(String),

    /// Audio format conversion failed.
    #[error("format error: {0}")]
    Format(String),

    /// API communication error.
    #[error("api error: {0}")]
    Api(String),

    /// Audio stream was interrupted or closed.
    #[error("stream closed: {0}")]
    StreamClosed(String),

    /// Unsupported configuration requested.
    #[error("unsupported: {0}")]
    Unsupported(String),

    /// IO error.
    #[error("io error: {source}")]
    Io {
        /// The underlying IO error.
        #[from]
        source: std::io::Error,
    },
}

/// Result alias for audio operations.
pub type AudioResult<T> = Result<T, AudioError>;

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn display_device_error() {
        let err = AudioError::Device("no mic found".into());
        assert_eq!(err.to_string(), "device error: no mic found");
    }

    #[test]
    fn display_capture_error() {
        let err = AudioError::Capture("buffer overrun".into());
        assert_eq!(err.to_string(), "capture error: buffer overrun");
    }

    #[test]
    fn display_api_error() {
        let err = AudioError::Api("401 unauthorized".into());
        assert_eq!(err.to_string(), "api error: 401 unauthorized");
    }

    #[test]
    fn display_format_error() {
        let err = AudioError::Format("unsupported codec".into());
        assert_eq!(err.to_string(), "format error: unsupported codec");
    }

    #[test]
    fn display_stream_closed_error() {
        let err = AudioError::StreamClosed("peer hung up".into());
        assert_eq!(err.to_string(), "stream closed: peer hung up");
    }
}