dangerous 0.10.0

Safely and explicitly parse untrusted / dangerous data
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

use core::convert::TryFrom;

use dangerous::{error, BytesReader, Error, Expected, Input};

fn main() {
    println!("=== VALID PARSE ===");
    let input = dangerous::input(b"foo");
    let result: Result<_, Expected<'_>> = input.read_all(read_custom);
    println!("{:?}", result.unwrap());

    println!("\n=== INVALID PARSE ===");
    let input = dangerous::input(b"bar");
    let error: Expected<'_> = input.read_all(read_custom).unwrap_err();
    println!("{:#}", error);
}

#[derive(Debug)]
pub struct Custom<'i>(&'i str);

impl<'i> TryFrom<dangerous::String<'i>> for Custom<'i> {
    type Error = ParseCustomError;

    fn try_from(s: dangerous::String<'i>) -> Result<Self, Self::Error> {
        if s.as_dangerous() == "foo" {
            Ok(Self(s.as_dangerous()))
        } else {
            Err(ParseCustomError)
        }
    }
}

pub struct ParseCustomError;

impl<'i> error::External<'i> for ParseCustomError {
    fn push_backtrace<E>(self, error: E) -> E
    where
        E: error::WithContext<'i>,
    {
        error.with_context(error::ExternalContext {
            operation: Some("read my custom type"),
            expected: Some("my custom type"),
        })
    }
}

fn read_custom<'i, E>(r: &mut BytesReader<'i, E>) -> Result<Custom<'i>, E>
where
    E: Error<'i>,
{
    r.take_remaining_str()?
        .into_external("my custom type", Custom::try_from)
}