audio_samples_streaming 0.1.0

Chunk-based audio streaming for Rust, built on audio_samples (core audio representation and processing) and audio_samples_io. Streams AudioSamples buffers through a unified AudioStream/AudioSink trait pair; WAV, FLAC, hardware devices, rodio, and async.
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

use thiserror::Error;

/// All errors that can be produced by streaming operations.
#[derive(Debug, Error)]
pub enum StreamingError {
    /// An underlying I/O error from the OS or file system.
    #[error(transparent)]
    Io(#[from] std::io::Error),

    /// An error from the `audio_samples` crate (e.g. shape mismatch, SIMD conversion failure).
    #[error(transparent)]
    AudioSamples(#[from] audio_samples::AudioSampleError),

    /// An error from the `audio_samples_io` crate (e.g. malformed WAV header, unsupported codec).
    #[error(transparent)]
    AudioIO(#[from] audio_samples_io::AudioIOError),

    /// The stream has no more data to produce.
    ///
    /// Returned by sources that signal exhaustion through an error rather than `Ok(None)`.
    #[error("stream exhausted")]
    Exhausted,

    /// The source and sink disagree on sample rate, channel count, or bit depth.
    #[error("format mismatch: {0}")]
    FormatMismatch(String),

    /// A requested feature or sample format is not supported by this implementation.
    ///
    /// Common cause: a cpal device reports a native format (e.g. `F64`) that has no
    /// conversion path in this crate.
    #[error("unsupported: {0}")]
    Unsupported(String),

    /// A construction or configuration parameter was invalid.
    ///
    /// Common causes: no default input/output device, device open failure, ring buffer
    /// size of zero.
    #[error("parameter error: {0}")]
    Parameter(String),
}

pub type StreamingResult<T> = Result<T, StreamingError>;