pyo3 0.28.3

Bindings to Python interpreter
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

/// Calculates the total byte length of all byte pieces in the array.
///
/// This is a useful utility in order to determine the size needed for the constant
/// `combine` function.
pub const fn combined_len(pieces: &[&[u8]]) -> usize {
    let mut len = 0;
    let mut pieces_idx = 0;
    while pieces_idx < pieces.len() {
        len += pieces[pieces_idx].len();
        pieces_idx += 1;
    }
    len
}

/// Combines all bytes pieces into a single byte array.
///
/// `out` should be a buffer at the correct size of `combined_len(pieces)`, else this will panic.
const fn combine(pieces: &[&[u8]], mut out: &mut [u8]) {
    let mut pieces_idx = 0;
    while pieces_idx < pieces.len() {
        let piece = pieces[pieces_idx];
        slice_copy_from_slice(out, piece);
        // using split_at_mut because range indexing not yet supported in const fn
        out = out.split_at_mut(piece.len()).1;
        pieces_idx += 1;
    }
    // should be no trailing buffer
    assert!(out.is_empty(), "output buffer too large");
}

/// Wrapper around `combine` which has a const generic parameter, this is going to be more codegen
/// at compile time (?)
pub const fn combine_to_array<const LEN: usize>(pieces: &[&[u8]]) -> [u8; LEN] {
    let mut out: [u8; LEN] = [0u8; LEN];
    combine(pieces, &mut out);
    out
}

/// Replacement for `slice::copy_from_slice`, which is const from 1.87
pub(crate) const fn slice_copy_from_slice(out: &mut [u8], src: &[u8]) {
    let mut i = 0;
    while i < src.len() {
        out[i] = src[i];
        i += 1;
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_combined_len() {
        let pieces: [&[u8]; 3] = [b"foo", b"bar", b"baz"];
        assert_eq!(combined_len(&pieces), 9);
        let empty: [&[u8]; 0] = [];
        assert_eq!(combined_len(&empty), 0);
    }

    #[test]
    fn test_combine_to_array() {
        let pieces: [&[u8]; 2] = [b"foo", b"bar"];
        let combined = combine_to_array::<6>(&pieces);
        assert_eq!(&combined, b"foobar");
    }

    #[test]
    #[should_panic(expected = "index out of bounds")]
    fn test_combine_to_array_buffer_too_small() {
        let pieces: [&[u8]; 2] = [b"foo", b"bar"];
        // Intentionally wrong length
        let _ = combine_to_array::<5>(&pieces);
    }

    #[test]
    #[should_panic(expected = "output buffer too large")]
    fn test_combine_to_array_buffer_too_big() {
        let pieces: [&[u8]; 2] = [b"foo", b"bar"];
        // Intentionally wrong length
        let _ = combine_to_array::<10>(&pieces);
    }
}