devela 0.27.0

A development layer of coherence.
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

// devela::sys::os::term::ansi::namespace
//
//! Implements the internal [`_ansi_consts!`] macro.
//
// Note: to convert the syntax of old constants for this macro using Vim: s/\*b\(.*\);/\1, *b\1;

/// Implements methods
///
/// Rules:
/// - Use uppercase names.
/// - Invoke from inside an `impl Ansi` block.
macro_rules! _ansi_consts {
    (
    // const fn definition returning a byte slice
    $(
        $(#[$DOCS:meta])*
        $vis:vis const fn $fn:ident($($param:ident: $param_ty:ty),* $(,)?) -> &[u8]
        $fn_body:block
    )*) => { $crate::paste! {
        $(
            // byte slice version
            #[must_use]
            #[allow(missing_docs)]
            $vis const fn [<$fn _B>]($($param: $param_ty),*) -> &[u8] $fn_body

            // string slice version
            $(#[$DOCS])*
            #[must_use]
            $vis const fn $fn($($param: $param_ty),*) -> &str {
                #[cfg(any(feature = "safe_text", not(feature = "unsafe_str")))]
                { $crate::unwrap![ok ::core::str::from_utf8(Ansi::[<$fn _B>]($($param),*))] }

                #[cfg(all(not(feature = "safe_text"), feature = "unsafe_str"))]
                // SAFETY: ANSI codes are all valid UTF-8
                unsafe { $crate::Str::from_utf8_unchecked(Ansi::[<$fn _B>]($($param),*)) }
            }
        )*
    }};
    (
    // const fn definition returning an array
    $(
        $(#[$DOCS:meta])*
        $vis:vis const fn $fn:ident($($param:ident: $param_ty:ty),* $(,)?) -> [u8; $N:literal]
        $fn_body:block
    )*) => { $crate::paste! {
        $(
            // byte array version
            #[must_use]
            #[allow(missing_docs)]
            $vis const fn [<$fn _B>]($($param: $param_ty),*) -> [u8; $N] $fn_body

            // static string version
            $(#[$DOCS])*
            $vis const fn $fn($($param: $param_ty),*) -> $crate::StringNonul<$N> {
                $crate::StringNonul::<$N>::_from_array_trusted(Ansi::[<$fn _B>]($($param),*))
            }
        )*
    }};
   (
    // const definition with 2 const expressions
    $(
        $(#[$DOCS:meta])*
        $vis:vis const $const:ident: $const_ty:ty = $str:expr, $array:expr
    );* $(;)?) => { $crate::paste! {
        $(
            // byte array version
            #[allow(missing_docs, non_upper_case_globals)]
            $vis const [<$const _B>]: $const_ty = $array;

            // string slice version
            $(#[$DOCS])*
            $vis const $const: &str = $str;
        )*
    }};
    (
    // const definition with Ansi const fn call
    $(
        $(#[$DOCS:meta])*
        $vis:vis const $const:ident: [u8; $N:literal] = Ansi::$fn:ident ($($param:expr),*)
    );* $(;)?) => { $crate::paste! {
        $(
            #[allow(missing_docs, non_upper_case_globals)]
            $vis const [<$const _B>]: [u8; $N] = $crate::Ansi::[<$fn _B>]($($param),*);

            $(#[$DOCS])*
            $vis const $const: $crate::StringNonul<$N> = $crate::Ansi::$fn($($param),*);
        )*
    }};
}
pub(crate) use _ansi_consts;