Lib.rs

ur 是一个用于与 "Uniform Resources (UR)" 二进制数据编码交互的 crate。

编码方案优化了在 URI 和 QR 码中的传输。

编码器 允许字节有效载荷分多阶段传输，同时遵守最大大小要求。底层使用 fountain 编码器创建一个无界的 URI 流，接收端可以将其中的一部分重新组合成有效载荷。

例如

const MAX_FRAGMENT_LENGTH: usize = 5;

let data = "Ten chars!".repeat(10);

encoder.start("bytes", data.as_bytes(), MAX_FRAGMENT_LENGTH);
assert_eq!(
    encoder.next_part().to_string(),
    "ur:bytes/1-20/lpadbbcsiecyvdidatkpfeghihjtcxiabdfevlms"
);

while !decoder.is_complete() {
    let sequence = encoder.current_sequence();
    let part = encoder.next_part();
    // Simulate some communication loss
    if sequence & 1 > 0 {
        decoder.receive(part).unwrap();
    }
}
assert_eq!(decoder.message().unwrap().as_deref(), Some(data.as_bytes()));

以下有用的构建块也是公共 API 的一部分

• bytewords 模块包含将字节有效载荷编码为合适字母表的功能，实现每字符十六进制字节效率。

• fountain 模块提供了一个 fountain 编码器的实现，它将字节有效载荷分割成多个部分，并发出一个无界的部分流，接收端的解码器可以将这些部分重新组合。