oto 0.1.1

Oto (音) — audio framework: device management, codec support, playback, voice streaming
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
88
89
90
91
92
93
94
95

/// Errors produced by the oto audio framework.
#[derive(Debug, thiserror::Error)]
pub enum OtoError {
    #[error("device not found: {0}")]
    DeviceNotFound(String),

    #[error("playback failed: {0}")]
    PlaybackFailed(String),

    #[error("decoder error: {0}")]
    DecoderError(String),

    #[error("queue is empty")]
    QueueEmpty,

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

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

    #[test]
    fn device_not_found_display() {
        let err = OtoError::DeviceNotFound("headphones".into());
        assert_eq!(err.to_string(), "device not found: headphones");
    }

    #[test]
    fn playback_failed_display() {
        let err = OtoError::PlaybackFailed("buffer underrun".into());
        assert_eq!(err.to_string(), "playback failed: buffer underrun");
    }

    #[test]
    fn decoder_error_display() {
        let err = OtoError::DecoderError("invalid header".into());
        assert_eq!(err.to_string(), "decoder error: invalid header");
    }

    #[test]
    fn queue_empty_display() {
        let err = OtoError::QueueEmpty;
        assert_eq!(err.to_string(), "queue is empty");
    }

    #[test]
    fn io_error_from() {
        let io_err = std::io::Error::new(std::io::ErrorKind::NotFound, "file missing");
        let err = OtoError::from(io_err);
        assert!(err.to_string().contains("file missing"));
    }

    #[test]
    fn error_is_send_and_sync() {
        fn assert_send_sync<T: Send + Sync>() {}
        // OtoError wraps std::io::Error which is Send+Sync,
        // so OtoError must be as well.
        assert_send_sync::<OtoError>();
    }

    #[test]
    fn error_debug_format_includes_variant_name() {
        let err = OtoError::QueueEmpty;
        let debug = format!("{err:?}");
        assert!(debug.contains("QueueEmpty"), "Debug should contain variant name: {debug}");
    }

    #[test]
    fn io_error_preserves_kind_through_conversion() {
        let io_err = std::io::Error::new(std::io::ErrorKind::PermissionDenied, "access denied");
        let err = OtoError::from(io_err);
        // Verify the Display output wraps the original message
        let display = err.to_string();
        assert!(display.contains("access denied"), "Display should contain original message: {display}");
    }

    #[test]
    fn errors_are_distinct_variants() {
        // Ensure different error variants produce different messages
        let e1 = OtoError::DeviceNotFound("x".into());
        let e2 = OtoError::PlaybackFailed("x".into());
        let e3 = OtoError::DecoderError("x".into());
        let e4 = OtoError::QueueEmpty;

        let messages: Vec<String> = vec![e1, e2, e3, e4].into_iter().map(|e| e.to_string()).collect();
        // All messages should be unique
        for i in 0..messages.len() {
            for j in (i + 1)..messages.len() {
                assert_ne!(messages[i], messages[j], "Error messages should be distinct");
            }
        }
    }
}