arigato 0.2.1

barebones Rust framework for creating and serving a 9p filesystem
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

// {{{ Copyright (c) Paul R. Tagliamonte <paultag@gmail.com>, 2023-2024
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
// THE SOFTWARE. }}}

use super::{Dehydrate, Hydrate, SliceError};
use std::{
    io::{Cursor, Error},
    num::TryFromIntError,
    str::Utf8Error,
};

/// Error when taking bytes and turning it into a String.
#[derive(Debug)]
pub enum StringError {
    /// String is larger than the configured msize.
    TooLarge,

    /// underlying I/O error.
    IoError(Error),

    /// Issue turning bytes into unicode.
    UnicodeError(Utf8Error),
}

impl From<Utf8Error> for StringError {
    fn from(e: Utf8Error) -> Self {
        Self::UnicodeError(e)
    }
}

impl From<Error> for StringError {
    fn from(e: Error) -> Self {
        Self::IoError(e)
    }
}

impl From<TryFromIntError> for StringError {
    fn from(_e: TryFromIntError) -> Self {
        Self::TooLarge
    }
}

impl From<SliceError<std::io::Error>> for StringError {
    fn from(se: SliceError<std::io::Error>) -> Self {
        match se {
            SliceError::Inner(e) => Self::IoError(e),
            SliceError::IoError(e) => Self::IoError(e),
            SliceError::TooLong => Self::TooLarge,
        }
    }
}

impl<T> Hydrate<T> for String
where
    Self: Sized,
    T: AsRef<[u8]>,
{
    type Error = StringError;

    fn hydrate(b: &mut Cursor<T>) -> Result<Self, Self::Error> {
        let buf = Vec::<u8>::hydrate(b)?;
        Ok(std::str::from_utf8(&buf)?.to_owned())
    }
}

impl Dehydrate for &str
where
    Self: Sized,
{
    type Error = StringError;

    fn dehydrate(&self, b: &mut Cursor<Vec<u8>>) -> Result<(), Self::Error> {
        let buf = self.as_bytes();
        Ok(buf.dehydrate(b)?)
    }
}

impl Dehydrate for String
where
    Self: Sized,
{
    type Error = StringError;

    fn dehydrate(&self, b: &mut Cursor<Vec<u8>>) -> Result<(), Self::Error> {
        self.as_str().dehydrate(b)
    }
}

#[cfg(test)]
mod tests {
    use super::{super::test_round_trip, Dehydrate, Hydrate};
    use std::io::Cursor;
    test_round_trip!(round_trip_string, &str, String, ("foo bar", "fnord", ""));
}

// vim: foldmethod=marker