moonvar

// The fixed widths, either way round, reading nothing it was not given.
let buf = Buffer()
@fixed.write_u32(buf, 0x12345678)
@fixed.write_u16(buf, 0x1234, order=Little)
let wire = buf.to_bytes()
assert_eq(wire, b"\x12\x34\x56\x78\x34\x12")
assert_eq(@fixed.read_u32(wire[:]), Some(305419896))
assert_eq(@fixed.read_u32(wire[:], at=10), None) // the view is shorter

// One number, in each protocol's own spelling.
assert_eq(@quic.encode(1337UL), b"\x45\x39")
assert_eq(@prefix.encode(1337, prefix=5), b"\x1f\x9a\x0a")
assert_eq(@leb128.encode(1337UL), b"\xb9\x0a")
assert_eq(@lenenc.encode(1337UL), b"\xfc\x39\x05")

#Packages

#The same number, five ways

#Reading is half of it

• Nothing read past the end. Every fixed reader checks the width it needs and answers None when the view is short. The variable-length readers raise a Refused that names the fault: Truncated, or past the ceiling the encoding allows.
• A width without writing it. Every package has size(): how many octets a value takes, without producing them. A length field has to be measured before the payload it describes is written.
• Signed values stay short. leb128.zigzag folds a negative onto an unsigned value, so -1 costs one octet rather than ten.

#Install

moon add moonbitstack/moonvar

import {
  "moonbitstack/moonvar/quic",
}

#Examples

moon run src/examples/tour
moon run src/examples/frame

#Licence