uselesskey-core-negative 0.6.0

Compatibility facade for negative fixture builders used by uselesskey.
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

#![forbid(unsafe_code)]
#![cfg_attr(not(feature = "std"), no_std)]

//! Compatibility façade for negative fixture primitives.
//!
//! This crate keeps existing `uselesskey_core_negative` paths stable while
//! delegating to focused microcrates:
//! - [`uselesskey_core_negative_der`] for DER corruption helpers.
//! - [`uselesskey_core_negative_pem`] for PEM corruption helpers.
//!
//! # Examples
//!
//! Corrupt a PEM string with a specific strategy:
//!
//! ```
//! use uselesskey_core_negative::{corrupt_pem, CorruptPem};
//!
//! let pem = "-----BEGIN PUBLIC KEY-----\nABC=\n-----END PUBLIC KEY-----\n";
//! let bad = corrupt_pem(pem, CorruptPem::BadHeader);
//! assert!(bad.starts_with("-----BEGIN CORRUPTED KEY-----"));
//! ```
//!
//! Deterministic DER corruption from a variant string:
//!
//! ```
//! use uselesskey_core_negative::corrupt_der_deterministic;
//!
//! let der = vec![0x30, 0x82, 0x01, 0x22, 0x10, 0x20];
//! let a = corrupt_der_deterministic(&der, "corrupt:test-v1");
//! let b = corrupt_der_deterministic(&der, "corrupt:test-v1");
//! assert_eq!(a, b); // same variant ⇒ same corruption
//! ```

pub use uselesskey_core_negative_der::{corrupt_der_deterministic, flip_byte, truncate_der};
pub use uselesskey_core_negative_pem::{CorruptPem, corrupt_pem, corrupt_pem_deterministic};