avt 0.19.0

asciinema virtual terminal
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

//! Single fragments and flat sequences accepted by terminal feeds.

/// One text fragment or character. Text is borrowed; characters are stored inline.
#[derive(Clone, Copy, Debug)]
pub enum Input<'a> {
    Text(&'a str),
    Char(char),
}

/// Borrows a single fragment for synchronous processing.
pub trait AsInput {
    fn as_input(&self) -> Input<'_>;
}

impl AsInput for str {
    fn as_input(&self) -> Input<'_> {
        Input::Text(self)
    }
}

impl AsInput for String {
    fn as_input(&self) -> Input<'_> {
        self.as_str().as_input()
    }
}

impl AsInput for char {
    fn as_input(&self) -> Input<'_> {
        Input::from(*self)
    }
}

impl AsInput for Input<'_> {
    fn as_input(&self) -> Input<'_> {
        *self
    }
}

impl<T: AsInput + ?Sized> AsInput for &T {
    fn as_input(&self) -> Input<'_> {
        (**self).as_input()
    }
}

impl<T: AsInput + ?Sized> AsInput for &mut T {
    fn as_input(&self) -> Input<'_> {
        (**self).as_input()
    }
}

impl<'a, T: AsInput + ?Sized> From<&'a T> for Input<'a> {
    fn from(value: &'a T) -> Self {
        value.as_input()
    }
}

impl From<char> for Input<'_> {
    fn from(value: char) -> Self {
        Self::Char(value)
    }
}

/// Inferred dispatch marker for a single fragment.
pub struct Single;

/// Inferred dispatch marker for a flat sequence of fragments.
pub struct Sequence;

/// Converts a feed argument into its ordinary iterator of fragments.
/// The terminal borrows each item while processing it, including owned strings.
/// `Kind` distinguishes single fragments from sequences and is normally inferred.
pub trait IntoInputs<Kind> {
    type Iter: Iterator<Item: AsInput>;

    fn into_inputs(self) -> Self::Iter;
}

impl<T: AsInput> IntoInputs<Single> for T {
    type Iter = std::iter::Once<T>;

    fn into_inputs(self) -> Self::Iter {
        std::iter::once(self)
    }
}

impl<I> IntoInputs<Sequence> for I
where
    I: IntoIterator,
    I::Item: AsInput,
{
    type Iter = I::IntoIter;

    fn into_inputs(self) -> Self::Iter {
        self.into_iter()
    }
}