abe 0.2.0

Ascii-byte-expression : a tiny byte templating language
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
106

// Copyright Anton Sol
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at https://mozilla.org/MPL/2.0/.
#![feature(
    split_as_slice,
    split_array,
    try_trait_v2,
    iterator_try_collect,
    array_chunks,
    associated_type_bounds,
    type_alias_impl_trait,
    bigint_helper_methods
)]
pub mod abe_macro;
pub mod abtxt;
pub mod ast;
pub mod convert;
pub mod eval;
pub use thiserror;

use std::error::Error;
use std::fmt::{Debug, Display};

pub use ast::{parse_abe, parse_abe_b, print_abe, ABE};
pub use convert::{ABEValidator, ToABE, TypedABE};

pub fn cut_ending_nulls2(b: &[u8]) -> &[u8] {
    match b.iter().rposition(|v| *v != 0) {
        None => &[],
        Some(i) => &b[0..=i],
    }
}
pub fn cut_prefix_nulls(b: &[u8]) -> &[u8] {
    cut_prefixeq::<0>(b)
}
pub fn cut_prefixeq<const BYTE: u8>(b: &[u8]) -> &[u8] {
    match b.iter().position(|v| *v != BYTE) {
        None => &[],
        Some(i) => &b[i..],
    }
}

pub const fn fit<const L: usize>(slice: &[u8]) -> Result<[u8; L], FitSliceErr> {
    if slice.len() != L {
        return Err(FitSliceErr {
            size: Some(L),
            got: Ok(slice.len()),
        });
    }
    fit_front(slice)
}
pub const fn fit_back<const FILL: u8, const L: usize>(
    slice: &[u8],
) -> Result<[u8; L], FitSliceErr> {
    if slice.len() > L {
        return Err(FitSliceErr {
            size: Some(L),
            got: Ok(slice.len()),
        });
    }
    let mut v = [FILL; L];
    let d = L - slice.len();
    let mut i = 0;
    while i < L - d {
        v[d + i] = slice[i];
        i += 1;
    }
    Ok(v)
}
pub const fn fit_front<const L: usize>(slice: &[u8]) -> Result<[u8; L], FitSliceErr> {
    if slice.len() > L {
        return Err(FitSliceErr {
            size: Some(L),
            got: Ok(slice.len()),
        });
    }
    let mut v = [0u8; L];
    let mut i = 0;
    while i < slice.len() {
        v[i] = slice[i];
        i += 1;
    }
    Ok(v)
}
#[derive(Debug, Copy, Clone)]
pub struct FitSliceErr {
    pub size: Option<usize>,
    // FIXME: This is a mistype. Ok(v) means got, Err(e) is an alternative description
    pub got: Result<usize, &'static str>,
}

impl Error for FitSliceErr {}
impl Display for FitSliceErr {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "Wrong number of bytes.")?;
        if let Some(v) = self.size {
            write!(f, " Expected {v}.")?;
        }
        match self.got {
            Ok(e) => write!(f, " Got {e}."),
            Err(e) => f.write_str(e),
        }
    }
}