lasprs 0.14.3

Library for Acoustic Signal Processing (Rust edition, with optional Python bindings via pyo3)
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

//! Provides stream messages that come from a running stream
use std::time::{Instant, SystemTime};
use strum_macros::{Display, EnumMessage};

use crate::tools::get_current_timestamp;

use super::*;

/// Gives the stream status of a (possible) stream, either input / output or duplex.
#[cfg_attr(
    feature = "python-bindings",
    gen_stub_pyclass_complex_enum,
    pyclass(from_py_object)
)]
#[derive(EnumMessage, Debug, Clone, Display, PartialEq)]
pub enum StreamStatus {
    /// Stream is not running
    #[strum(message = "NotRunning", detailed_message = "Stream is not running")]
    NotRunning {},
    /// Stream is running properly
    #[strum(message = "Running", detailed_message = "Stream is running")]
    Running {
        /// Start time as UTC unix time stamp
        start_time: SystemTime,
    },

    /// An error occured in the stream.
    #[strum(
        message = "Error",
        detailed_message = "An error occured with the stream"
    )]
    Error {
        /// In case the stream has an error: e is the field name
        e: StreamError,
    },
}

#[cfg(feature = "python-bindings")]
#[cfg_attr(feature = "python-bindings", gen_stub_pymethods)]
#[cfg_attr(feature = "python-bindings", pymethods)]
impl StreamStatus {
    fn __eq__(&self, other: &Self) -> bool {
        self == other
    }
    /// Whether the stream has an error.
    pub fn hasError(&self) -> bool {
        matches!(self, StreamStatus::Error { .. })
    }
    /// Get the error if the stream has an error.
    pub fn getError(&self) -> Option<StreamError> {
        use StreamStatus::*;
        if let Error { e } = self {
            Some(e.clone())
        } else {
            None
        }
    }
    /// Number of seconds the stream is currently running
    fn secondsRunning(&self) -> u64 {
        match self {
            StreamStatus::NotRunning {} => 0,
            StreamStatus::Running { start_time } => start_time
                .elapsed()
                .expect("System clock has run backward")
                .as_secs(),
            StreamStatus::Error { .. } => 0,
        }
    }
}

impl StreamStatus {
    /// Create a new `running` stream status, where start time is initialized.
    pub fn newRunning() -> StreamStatus {
        StreamStatus::Running {
            start_time: SystemTime::now(),
        }
    }
}