asn1_der

欢迎使用 asn1_der 🎉

此包提供了一个基本兼容 no_std、无 panic 和 零拷贝 的 DER 实现。它旨在可靠且足够快，而不变得太大或牺牲太多舒适度。为此，asn1_der 广泛使用了 no-panic 包，并提供了基于切片的对象视图以避免分配和不必要的复制。

示例

use asn1_der::{
    DerObject,
    typed::{ DerEncodable, DerDecodable }
};

fn main() {
    /// An ASN.1-DER encoded integer `7`
    const INT7: &'static[u8] = b"\x02\x01\x07";

    // Decode an arbitrary DER object
    let object = DerObject::decode(INT7).expect("Failed to decode object");

    // Encode an arbitrary DER object
    let mut encoded_object = Vec::new();
    object.encode(&mut encoded_object).expect("Failed to encode object");

    // Decode a `u8`
    let number = u8::decode(INT7).expect("Failed to decode number");
    assert_eq!(number, 7);

    // Encode a new `u8`
    let mut encoded_number = Vec::new();
    7u8.encode(&mut encoded_number).expect("Failed to encode number");
}

有关通过 derive (序列化和反序列化) 结构体和类似类型的信息，请参阅 serde_asn1_der。

类型实现

还有一些针对原生 Rust 类型等效物的直接 DerDecodable/DerEncodable 实现

• ASN.1 的 BOOLEAN 类型作为 Rust 的 bool
• ASN.1 的 INTEGER 类型作为 Rust 的 [u8、u16、u32、u64、u128、usize]
• ASN.1 的 NULL 类型可以是 () 或 Option::None（允许编码可选值）
• ASN.1 的 OctetString 类型作为 Vec<u8>
• ASN.1 的 SEQUENCE 类型作为 SequenceVec(Vec<T>)
• ASN.1的UTF8String类型作为String

无恐慌

asn1_der设计得尽可能无恐慌。为此，几乎所有函数都被标记为#[no_panic]，这迫使编译器证明函数在给定情况下不会发生恐慌。然而，由于no_panic可能导致大量误报，它目前仅在CI测试中使用，并且在正常构建中默认禁用。如果您想使用带有no_panic的功能，可以通过指定no_panic功能来实现。

无恐慌不涵盖的内容

重要的是要知道no_panic并不是万能的，它不能解决在这个crate中可能发生的某些类型的错误。这特别包括：

• 动态内存分配错误：由于无法预测内存分配错误，需要动态内存分配的所有内容都与no_panic互斥，如果启用no_panic，则将省略。

  这个crate可能在下述情况下分配内存：

  • 在向动态分配的sink（例如Vec<u8>，VecBacking(Vec<u8>)）写入时
  • 解码原生拥有类型，例如Vec<u8>，SequenceVec(Vec<T>)或String
  • 在错误传播过程中

  如果编译这个crate时未启用std，它本身不会直接执行任何动态内存分配 – 然而，传递给这个crate的外部实现可能仍然会分配内存并失败（例如，自定义Sink实现）。

• 栈溢出：由于栈大小在编译时未必已知，因此无法预测栈溢出错误，例如由递归引起的。

• 调用abort或类似函数：由于调用abort或类似函数不会触发栈回溯，因此也无法由no_panic检测。**这也意味着，如果构建配置中使用了panic = "abort"，则no_panic不起作用**。

  这个crate本身永远不会直接调用abort。