rosetta-squint-decode 1.1.2

Byte-exact PIL-compatible image decoder library (Rust). Part of rosetta-squint.
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

use thiserror::Error;
use crate::types::Format;

/// Categorizes decode failures.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum DecodeErrorKind {
    UnsupportedFormat,
    CorruptInput,
    Truncated,
    UnsupportedFeature,
    ImageTooLarge,
}

impl DecodeErrorKind {
    pub fn as_str(&self) -> &'static str {
        match self {
            DecodeErrorKind::UnsupportedFormat => "unsupportedFormat",
            DecodeErrorKind::CorruptInput => "corruptInput",
            DecodeErrorKind::Truncated => "truncated",
            DecodeErrorKind::UnsupportedFeature => "unsupportedFeature",
            DecodeErrorKind::ImageTooLarge => "imageTooLarge",
        }
    }
}

impl std::fmt::Display for DecodeErrorKind {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.write_str(self.as_str())
    }
}

/// Error type returned by `decode`.
#[derive(Debug, Clone, Error, PartialEq, Eq)]
pub struct DecodeError {
    pub kind: DecodeErrorKind,
    pub format: Option<Format>,
    pub detail: String,
}

impl std::fmt::Display for DecodeError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match (&self.format, self.detail.is_empty()) {
            (Some(fmt), false) => write!(f, "{}[{}]: {}", self.kind, fmt, self.detail),
            (Some(fmt), true) => write!(f, "{}[{}]", self.kind, fmt),
            (None, false) => write!(f, "{}: {}", self.kind, self.detail),
            (None, true) => write!(f, "{}", self.kind),
        }
    }
}

impl DecodeError {
    pub(crate) fn new(kind: DecodeErrorKind, format: Option<Format>, detail: impl Into<String>) -> Self {
        DecodeError { kind, format, detail: detail.into() }
    }
}