sudo-rs 0.2.0-dev.20230627

A memory safe implementation of sudo and su.
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
98
99
100
101
102
103
104
105

macro_rules! add_from {
    ($ctor:ident, $type:ty) => {
        impl From<$type> for $crate::defaults::SudoDefault {
            fn from(value: $type) -> Self {
                $crate::defaults::SudoDefault::$ctor(value.into())
            }
        }
    };

    ($ctor:ident, $type:ty, negatable$(, $vetting_function:expr)?) => {
        impl From<$type> for $crate::defaults::SudoDefault {
            fn from(value: $type) -> Self {
                $crate::defaults::SudoDefault::$ctor(OptTuple {
                    default: value.into(),
                    negated: None,
                }$(, $vetting_function)?)
            }
        }

        impl From<($type, $type)> for $crate::defaults::SudoDefault {
            fn from((value, neg): ($type, $type)) -> Self {
                $crate::defaults::SudoDefault::$ctor(OptTuple {
                    default: value.into(),
                    negated: Some(neg.into()),
                }$(, $vetting_function)?)
            }
        }
    };
}

macro_rules! sliceify {
    ([$($value:tt),*]) => {
        &[$($value),*][..]
    };
    ($value:tt) => {
        ($value)
    };
}

macro_rules! tupleify {
    ($fst:expr, $snd:expr) => {
        ($fst, $snd)
    };
    ($value:tt) => {
        $value
    };
}

macro_rules! optional {
    () => {
        |x| x
    };
    ($block: block) => {
        $block
    };
}

macro_rules! defaults {
    ($($name:ident = $value:tt $((!= $negate:tt))? $([$($key:ident),*])? $([$first:literal ..= $last:literal$(; radix: $radix: expr)?])?)*) => {
        pub const ALL_PARAMS: &'static [&'static str] = &[
            $(stringify!($name)),*
        ];

        // because of the nature of radix and ranges, 'let mut result' is not always necessary, and
        // a radix of 10 can also not always be avoided (and for uniformity, I would also not avoid this
        // if this was hand-written code.
        #[allow(unused_mut)]
        #[allow(clippy::from_str_radix_10)]
        pub fn sudo_default(var: &str) -> Option<SudoDefault> {
            add_from!(Flag, bool);
            add_from!(Integer, i128, negatable, |text| i128::from_str_radix(text, 10).ok());
            add_from!(Text, &'static str, negatable);
            add_from!(Text, Option<&'static str>, negatable);
            add_from!(List, &'static [&'static str]);
            add_from!(Enum, StrEnum<'static>, negatable);

            Some(
                match var {
                    $(stringify!($name) => {
                          let restrict = optional![$({
                              let keys = &[$(stringify!($key)),*];
                              |key: &'static str| StrEnum::new(key, keys).unwrap_or_else(|| unreachable!())
                          })?];
                          let datum = restrict(sliceify!($value));
                          let mut result = tupleify!(datum$(, restrict($negate))?).into();
                          $(
                              if let SudoDefault::Integer(_, ref mut checker) = &mut result {
                                  *checker = |text| i128::from_str_radix(text, 10$(*0 + $radix)?).ok().filter(|val| ($first ..= $last).contains(val));
                              }
                          )?
                          result
                    },
                    )*
                    _ => return None
                }
            )
        }
    };
}

pub(super) use add_from;
pub(super) use defaults;
pub(super) use optional;
pub(super) use sliceify;
pub(super) use tupleify;