spectrograms 1.1.0

High-performance FFT-based computations for audio and image processing
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

//! Python exception types for the spectrograms library.

use pyo3::create_exception;
use pyo3::exceptions::PyException;
use pyo3::prelude::*;

use crate::SpectrogramError;

// Base exception type
create_exception!(
    spectrograms,
    PySpectrogramError,
    PyException,
    "Base exception for all spectrogram errors."
);

// Specific exception types
create_exception!(
    spectrograms,
    PyInvalidInputError,
    PySpectrogramError,
    "Exception raised when invalid input is provided."
);

create_exception!(
    spectrograms,
    PyDimensionMismatchError,
    PySpectrogramError,
    "Exception raised when array dimensions don't match expected values."
);

create_exception!(
    spectrograms,
    PyFFTBackendError,
    PySpectrogramError,
    "Exception raised when an error occurs in the FFT backend."
);

create_exception!(
    spectrograms,
    PyInternalError,
    PySpectrogramError,
    "Exception raised when an internal error occurs."
);

/// Convert a Rust `SpectrogramError` to a Python exception.
///
/// This implementation allows Rust errors to be automatically converted to
/// Python exceptions when crossing the language boundary.
impl From<SpectrogramError> for PyErr {
    #[inline]
    fn from(err: SpectrogramError) -> Self {
        match err {
            SpectrogramError::InvalidInput(msg) => PyInvalidInputError::new_err(msg),
            SpectrogramError::DimensionMismatch { expected, got } => {
                PyDimensionMismatchError::new_err(format!(
                    "Dimension mismatch: expected {expected}, got {got}"
                ))
            }
            SpectrogramError::FftBackendError { backend, msg } => {
                PyFFTBackendError::new_err(format!("{backend} FFT backend error: {msg}"))
            }
            SpectrogramError::InternalError(msg) => PyInternalError::new_err(msg),
        }
    }
}