wuffs 0.2.0

Bindings to wuffs.
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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143

use std::{borrow::Cow, error::Error, ffi::CStr, fmt::Display, iter::FromIterator};

use wuffs_sys::{
  wuffs_base__note__end_of_data, wuffs_base__note__i_o_redirect,
  wuffs_base__note__metadata_reported, wuffs_base__status,
  wuffs_base__suspension__even_more_information,
  wuffs_base__suspension__mispositioned_read,
  wuffs_base__suspension__mispositioned_write, wuffs_base__suspension__short_read,
  wuffs_base__suspension__short_write,
};

pub trait IntoResult<T> {
  fn into_result(self) -> Result<T, WuffsError>;
}

impl<S, T> IntoResult<T> for S
where
  S: Into<WuffsStatus<T>>,
{
  fn into_result(self) -> Result<T, WuffsError> {
    let status: WuffsStatus<T> = self.into();
    status.into_result()
  }
}

#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord)]
pub enum WuffsStatus<T = ()> {
  Ok(T),
  Err(WuffsError),
  Note(WuffsNote),
  Suspension(WuffsSuspension),
}

#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord)]
pub enum WuffsError {
  Message(String),
  Note(WuffsNote),
  Suspension(WuffsSuspension),
}

#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord)]
pub enum WuffsNote {
  Other(String),
  IoRedirect,
  EndOfData,
  MetadataReported,
}

#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord)]
pub enum WuffsSuspension {
  Other(String),
  EvenMoreInformation,
  MispositionedRead,
  MispositionedWrite,
  ShortRead,
  ShortWrite,
}

impl<T> WuffsStatus<T> {
  pub fn into_result(self) -> Result<T, WuffsError> {
    match self {
      Self::Ok(value) => Ok(value),
      Self::Err(err) => Err(err),
      Self::Note(note) => Err(WuffsError::Note(note)),
      Self::Suspension(suspension) => Err(WuffsError::Suspension(suspension)),
    }
  }

  pub fn is_suspension(&self, other: WuffsSuspension) -> bool {
    match self {
      Self::Suspension(suspension) => *suspension == other,
      _ => false,
    }
  }
}

impl From<wuffs_base__status> for WuffsStatus<()> {
  fn from(inner: wuffs_base__status) -> Self {
    let repr = unsafe {
      if inner.repr.is_null() {
        Cow::from("")
      } else {
        CStr::from_ptr(inner.repr).to_string_lossy()
      }
    };

    unsafe {
      let mut chars = repr.chars();
      match chars.next() {
        Some('$') => WuffsStatus::Suspension(WuffsSuspension::from_ptr(inner.repr)),
        Some('#') => WuffsStatus::Err(chars.collect()),
        Some('@') => WuffsStatus::Note(WuffsNote::from_ptr(inner.repr)),
        _ => WuffsStatus::Ok(()),
      }
    }
  }
}

impl WuffsSuspension {
  pub unsafe fn from_ptr(ptr: *const i8) -> Self {
    if ptr == wuffs_base__suspension__even_more_information.as_ptr() {
      WuffsSuspension::EvenMoreInformation
    } else if ptr == wuffs_base__suspension__mispositioned_read.as_ptr() {
      WuffsSuspension::MispositionedRead
    } else if ptr == wuffs_base__suspension__mispositioned_write.as_ptr() {
      WuffsSuspension::MispositionedWrite
    } else if ptr == wuffs_base__suspension__short_read.as_ptr() {
      WuffsSuspension::ShortRead
    } else if ptr == wuffs_base__suspension__short_write.as_ptr() {
      WuffsSuspension::ShortWrite
    } else {
      WuffsSuspension::Other(CStr::from_ptr(ptr).to_string_lossy().to_string())
    }
  }
}

impl WuffsNote {
  pub unsafe fn from_ptr(ptr: *const i8) -> Self {
    if ptr == wuffs_base__note__end_of_data.as_ptr() {
      WuffsNote::EndOfData
    } else if ptr == wuffs_base__note__i_o_redirect.as_ptr() {
      WuffsNote::IoRedirect
    } else if ptr == wuffs_base__note__metadata_reported.as_ptr() {
      WuffsNote::MetadataReported
    } else {
      WuffsNote::Other(CStr::from_ptr(ptr).to_string_lossy().to_string())
    }
  }
}

impl FromIterator<char> for WuffsError {
  fn from_iter<T: IntoIterator<Item = char>>(iter: T) -> Self {
    Self::Message(String::from_iter(iter))
  }
}

impl Display for WuffsError {
  fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
    write!(f, "{}", self)
  }
}

impl Error for WuffsError {}