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

//! Traits for assembling and disassembling items.
use {fehler::throws, std::error::Error};

/// A failure to assemble a composite from a sequence of components.
#[derive(Debug)]
pub enum AssembleFailure<E> {
    /// There were not enough components.
    Incomplete,
    /// There was an error with the components.
    Error(E),
}

impl<E> From<E> for AssembleFailure<E> {
    #[inline]
    fn from(value: E) -> Self {
        Self::Error(value)
    }
}

/// Converts a sequence of components of type `N` into `Self`.
pub trait AssembleFrom<N>
where
    Self: Sized,
{
    /// The type of the error that could be thrown during assembly.
    type Error: Error;

    /// Converts `components` into a `Self`.
    #[throws(AssembleFailure<Self::Error>)]
    fn assemble_from(components: &mut Vec<N>) -> Self;
}

/// Converts a sequence of `Self`s into a composite of type `S`.
pub trait AssembleInto<S>
where
    Self: Sized,
{
    /// The type of the error that could be thrown during assembly.
    type Error: Error;

    /// Converts `components` into a `S`.
    #[throws(AssembleFailure<Self::Error>)]
    fn assemble_into(components: &mut Vec<Self>) -> S;
}

impl<N, S> AssembleInto<S> for N
where
    S: AssembleFrom<N>,
{
    type Error = <S as AssembleFrom<Self>>::Error;

    #[inline]
    #[throws(AssembleFailure<Self::Error>)]
    fn assemble_into(components: &mut Vec<Self>) -> S {
        S::assemble_from(components)?
    }
}

/// Converts a composite of type `S` into a `Vec<Self>`.
pub trait DisassembleFrom<S>
where
    Self: Sized,
{
    /// The type of the error that could be thrown during disassembly.
    type Error: Error;

    /// Converts `composite` into a `Vec<Self>`.
    #[throws(Self::Error)]
    fn disassemble_from(composite: S) -> Vec<Self>;
}

/// Converts `Self` into a `Vec<N>`.
pub trait DisassembleInto<N> {
    /// The type of the error that could be thrown during disassembly.
    type Error: Error;

    /// Converts `self` into a `Vec<N>`.
    #[throws(Self::Error)]
    fn disassemble_into(self) -> Vec<N>;
}

impl<N, S> DisassembleInto<N> for S
where
    N: DisassembleFrom<S>,
{
    type Error = <N as DisassembleFrom<Self>>::Error;

    #[inline]
    #[throws(Self::Error)]
    fn disassemble_into(self) -> Vec<N> {
        N::disassemble_from(self)?
    }
}