tlbits 0.5.4

TL-B serialization (bits only)
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

use core::fmt::{Debug, Display};
use std::error::Error as StdError;

use thiserror::Error as ThisError;

/// **De**/**ser**ialization error
pub trait Error: StdError + Sized {
    /// Returns a custom error from given message
    fn custom<T>(msg: T) -> Self
    where
        T: Display;

    /// Wraps current error in given context
    fn context<C>(self, context: C) -> Self
    where
        C: Display;
}

/// Adapter for providing context on [`Result`]
pub trait Context: Sized {
    type Ok;
    type Error: Error;

    /// Wrap [`Err`] in context by calling given function
    fn with_context<C>(self, context: impl FnOnce() -> C) -> Result<Self::Ok, Self::Error>
    where
        C: Display;

    /// Wrap [`Err`] in given context
    #[inline]
    fn context<C>(self, context: C) -> Result<Self::Ok, Self::Error>
    where
        C: Display,
    {
        self.with_context(move || context)
    }
}

impl<T, E> Context for Result<T, E>
where
    E: Error,
{
    type Ok = T;
    type Error = E;

    #[inline]
    fn with_context<C>(self, context: impl FnOnce() -> C) -> Result<T, E>
    where
        C: Display,
    {
        self.map_err(move |err| err.context(context()))
    }
}

impl<T> Context for Option<T> {
    type Ok = T;

    type Error = StringError;

    #[inline]
    fn with_context<C>(self, context: impl FnOnce() -> C) -> Result<Self::Ok, Self::Error>
    where
        C: Display,
    {
        self.ok_or_else(context).map_err(Error::custom)
    }
}

/// [`String`]-backed [`Error`]
#[derive(Debug, ThisError)]
#[error("{0}")]
pub struct StringError(String);

impl Error for StringError {
    #[inline]
    fn custom<T>(msg: T) -> Self
    where
        T: Display,
    {
        Self(msg.to_string())
    }

    #[inline]
    fn context<C>(self, context: C) -> Self
    where
        C: Display,
    {
        Self(format!("{context}: {self}"))
    }
}

impl AsRef<str> for StringError {
    #[inline]
    fn as_ref(&self) -> &str {
        self.0.as_str()
    }
}