fbe 0.2.0

Fast Binary Encoding (FBE) for Rust - High-performance, zero-copy binary serialization with 100% C++ FBE parity and binary compatibility
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

use fbe::buffer::{ReadBuffer, WriteBuffer};

#[test]
fn test_timestamp() {
    let mut writer = WriteBuffer::with_capacity(100);
    writer.allocate(8);

    let timestamp: u64 = 1729526400000000000; // 2024-10-21 12:00:00 UTC in nanoseconds
    writer.write_timestamp(0, timestamp);

    let mut reader = ReadBuffer::new();
    reader.attach_buffer(writer.data(), 0, writer.size());

    let read_timestamp = reader.read_timestamp(0);
    assert_eq!(timestamp, read_timestamp);
}

#[test]
fn test_uuid() {
    let mut writer = WriteBuffer::with_capacity(100);
    writer.allocate(16);

    let uuid: [u8; 16] = [
        0x12, 0x3e, 0x45, 0x67, 0xe8, 0x9b, 0x12, 0xd3, 0xa4, 0x56, 0x42, 0x66, 0x55, 0x44, 0x00,
        0x00,
    ];
    writer.write_uuid(0, &uuid);

    let mut reader = ReadBuffer::new();
    reader.attach_buffer(writer.data(), 0, writer.size());

    let read_uuid = reader.read_uuid(0);
    assert_eq!(uuid, read_uuid);
}

#[test]
fn test_bytes() {
    let mut writer = WriteBuffer::with_capacity(100);
    let data = b"Binary data test \x00\xFF\xAB";
    writer.allocate(4 + data.len());

    writer.write_bytes(0, data);

    let mut reader = ReadBuffer::new();
    reader.attach_buffer(writer.data(), 0, writer.size());

    let read_bytes = reader.read_bytes(0);
    assert_eq!(data.to_vec(), read_bytes);
}

#[test]
fn test_decimal() {
    let mut writer = WriteBuffer::with_capacity(100);
    writer.allocate(16);

    // Test: 123456.123456 with scale 6
    let value: i128 = 123456123456;
    let scale: u8 = 6;
    let negative = false;

    writer.write_decimal(0, value, scale, negative);

    let mut reader = ReadBuffer::new();
    reader.attach_buffer(writer.data(), 0, writer.size());

    let (read_value, read_scale, read_negative) = reader.read_decimal(0);
    assert_eq!(value, read_value);
    assert_eq!(scale, read_scale);
    assert_eq!(negative, read_negative);
}

#[test]
fn test_decimal_negative() {
    let mut writer = WriteBuffer::with_capacity(100);
    writer.allocate(16);

    // Test: -999.99 with scale 2
    let value: i128 = 99999;
    let scale: u8 = 2;
    let negative = true;

    writer.write_decimal(0, value, scale, negative);

    let mut reader = ReadBuffer::new();
    reader.attach_buffer(writer.data(), 0, writer.size());

    let (read_value, read_scale, read_negative) = reader.read_decimal(0);
    assert_eq!(value, read_value);
    assert_eq!(scale, read_scale);
    assert_eq!(negative, read_negative);
}