mtp 0.1.0

MTP client implementation based on mtp_spec
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

//! Error types for MTP communication

use core::fmt::Display;
use std::sync::Arc;
use tokio_stream::wrappers::errors::BroadcastStreamRecvError;

pub use mtp_spec::error::*;

/// A specialized `Result` type for MTP operations.
pub type Result<T, TransportError> = core::result::Result<T, Error<TransportError>>;

/// Errors that can occur during MTP operations
#[derive(Clone, Debug)]
pub enum Error<Transport> {
    /// Any I/O errors
    Io(Arc<std::io::Error>),
    /// Channel errors while attempting to receive events
    EventStream(BroadcastStreamRecvError),
    /// Any protocol errors from [`mtp_spec`]
    Core(MtpError<Transport>),
    /// Any other errors
    Generic(Arc<dyn std::error::Error + Send + Sync>),
}

impl<Transport> Display for Error<Transport>
where
    Transport: Display,
{
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            Self::Io(error) => write!(f, "{error}"),
            Self::EventStream(error) => write!(f, "{error}"),
            Self::Core(error) => write!(f, "{error}"),
            Self::Generic(error) => write!(f, "{error}"),
        }
    }
}

impl<Transport> core::error::Error for Error<Transport> where Transport: core::error::Error {}

impl<Transport> From<std::io::Error> for Error<Transport> {
    fn from(error: std::io::Error) -> Self {
        Self::Io(Arc::new(error))
    }
}

impl<Transport> From<BroadcastStreamRecvError> for Error<Transport> {
    fn from(error: BroadcastStreamRecvError) -> Self {
        Self::EventStream(error)
    }
}

impl<Transport> From<MtpError<Transport>> for Error<Transport> {
    fn from(error: MtpError<Transport>) -> Self {
        Self::Core(error)
    }
}

impl<Transport> From<deku::DekuError> for Error<Transport> {
    fn from(error: deku::DekuError) -> Self {
        Self::Core(MtpError::Serialization(error.into()))
    }
}