kutil 0.0.6

Kutil utilities collection
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

use super::{Local, Mutable, Problem, ProblemConversion, ProblemResultExt, SendSync};

use {
    rootcause::{IntoReport, IntoReportCollection},
    std::fmt,
};

//
// ProblemResultExtension
//

/// Extension for [ProblemResultExt].
pub trait ProblemResultExtension<OkT, ErrorT> {
    /// On error, create a new problem with the provided context. The error will be its child.
    ///
    /// Alias for [ProblemResultExt::context].
    fn in_context<ContextT>(self, context: ContextT) -> Result<OkT, Problem<ContextT, Mutable, SendSync>>
    where
        ErrorT: IntoReportCollection<SendSync>,
        ContextT: fmt::Debug + fmt::Display + Send + Sync;

    /// On error, create a new problem with the provided context. The error will be its child.
    ///
    /// Alias for [ProblemResultExt::local_context].
    fn in_context_local<ContextT>(self, context: ContextT) -> Result<OkT, Problem<ContextT, Mutable, Local>>
    where
        ErrorT: IntoReportCollection<Local>,
        ContextT: fmt::Debug + fmt::Display;

    /// On error, convert into a problem with a different context.
    ///
    /// Depends on an existing implementation of [ProblemConversion].
    ///
    /// Alias for [ProblemResultExt::context_to].
    fn convert_into<ContextT>(self) -> Result<OkT, Problem<ContextT, Mutable, SendSync>>
    where
        ErrorT: IntoReport<SendSync>,
        ContextT: ProblemConversion<ErrorT::Context, ErrorT::Ownership, SendSync>;

    /// On error, convert into a problem with a different context.
    ///
    /// Depends on an existing implementation of [ProblemConversion].
    ///
    /// Alias for [ProblemResultExt::local_context_to].
    fn convert_into_local<ContextT>(self) -> Result<OkT, Problem<ContextT, Mutable, Local>>
    where
        ErrorT: IntoReport<Local>,
        ContextT: ProblemConversion<ErrorT::Context, ErrorT::Ownership, Local>;
}

impl<OkT, ErrorT> ProblemResultExtension<OkT, ErrorT> for Result<OkT, ErrorT> {
    fn in_context<ContextT>(self, context: ContextT) -> Result<OkT, Problem<ContextT, Mutable, SendSync>>
    where
        ErrorT: IntoReportCollection<SendSync>,
        ContextT: fmt::Debug + fmt::Display + Send + Sync,
    {
        self.context(context)
    }

    fn in_context_local<ContextT>(self, context: ContextT) -> Result<OkT, Problem<ContextT, Mutable, Local>>
    where
        ErrorT: IntoReportCollection<Local>,
        ContextT: fmt::Debug + fmt::Display,
    {
        self.local_context(context)
    }

    fn convert_into<ContextT>(self) -> Result<OkT, Problem<ContextT, Mutable, SendSync>>
    where
        ErrorT: IntoReport<SendSync>,
        ContextT: ProblemConversion<ErrorT::Context, ErrorT::Ownership, SendSync>,
    {
        self.context_to()
    }

    fn convert_into_local<ContextT>(self) -> Result<OkT, Problem<ContextT, Mutable, Local>>
    where
        ErrorT: IntoReport<Local>,
        ContextT: ProblemConversion<ErrorT::Context, ErrorT::Ownership, Local>,
    {
        self.local_context_to()
    }
}