byte-wrapper 0.1.0

Newtype wrappers for hex byte arrays and base64 vectors, with serde and schemars support.
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

// Copyright (c) The byte-wrapper Contributors
// SPDX-License-Identifier: MIT OR Apache-2.0

use byte_wrapper::{Base64Vec, ParseBase64Error};

// -- FromStr tests --

#[test]
fn base64_from_str() {
    let b: Base64Vec = "AQID".parse().expect("parsed");
    assert_eq!(*b, [1, 2, 3]);

    // With padding.
    let b: Base64Vec = "AQIDBA==".parse().expect("parsed padded");
    assert_eq!(*b, [1, 2, 3, 4]);

    // Empty.
    let b: Base64Vec = "".parse().expect("parsed empty");
    assert!(b.is_empty());
}

#[test]
fn base64_from_str_invalid_byte() {
    let err = "AQ!D".parse::<Base64Vec>().expect_err("invalid byte");
    assert_eq!(
        err,
        ParseBase64Error::InvalidByte { offset: 2, byte: b'!' },
        "got: {err}",
    );
    assert!(err.to_string().contains("offset 2"), "got: {err}",);
}

#[test]
fn base64_from_str_invalid_length() {
    // A single base64 character is not a valid encoding.
    let err = "A".parse::<Base64Vec>().expect_err("invalid length");
    assert_eq!(err, ParseBase64Error::InvalidLength { length: 1 });
}

// -- Display and Debug formatting tests --

#[test]
fn base64_display() {
    let b = Base64Vec::new(vec![1, 2, 3]);
    assert_eq!(format!("{b}"), "AQID");

    // With padding.
    let b = Base64Vec::new(vec![1, 2, 3, 4]);
    assert_eq!(format!("{b}"), "AQIDBA==");

    // Empty.
    let b = Base64Vec::new(vec![]);
    assert_eq!(format!("{b}"), "");

    // Width and alignment.
    let b = Base64Vec::new(vec![1, 2, 3]);
    assert_eq!(format!("{b:>10}"), "      AQID");
    assert_eq!(format!("{b:<10}"), "AQID      ");
    assert_eq!(format!("{b:^10}"), "   AQID   ");
    assert_eq!(format!("{b:_>10}"), "______AQID");

    // Width smaller than content: no truncation.
    assert_eq!(format!("{b:2}"), "AQID");
}

#[test]
fn base64_debug() {
    let b = Base64Vec::new(vec![1, 2, 3]);
    assert_eq!(format!("{b:?}"), r#"Base64Vec("AQID")"#);

    // Empty.
    let b = Base64Vec::new(vec![]);
    assert_eq!(format!("{b:?}"), r#"Base64Vec("")"#);

    // Alternate flag.
    let b = Base64Vec::new(vec![1, 2, 3]);
    assert_eq!(format!("{b:#?}"), "Base64Vec(\n    \"AQID\",\n)",);
}