Enum Boundary 

pub enum Boundary {
    HttpHeader,
    GrpcMetadata,
    LogField,
    AuditField,
    JsonValue,
}

Serialization boundaries supported by Tainted::escape_for.

Each variant names the exact escape contract the boundary expects. The contract is implemented by Tainted::escape_for and validated by the proptest corpus in this crate’s test suite, so adding a variant requires extending both.

Variants

HttpHeader

HTTP/1.1 + HTTP/2 header value (http::HeaderValue-safe). Strips CR, LF, NUL, and tab — the four bytes that let an attacker terminate the current header and inject a second one. The output is guaranteed to be accepted by [http::HeaderValue::from_str] (modulo bytes outside ASCII 0x20-0x7E which are passed through; the gRPC layer rejects non-visible-ASCII separately).

GrpcMetadata

gRPC metadata value. gRPC metadata sits on HTTP/2 headers, so the contract is identical to Boundary::HttpHeader.

LogField

Plain-text log line emitted via tracing or any other line-oriented formatter. Strips CR / LF / NUL / control bytes (0x00-0x1F + 0x7F) and percent-encodes them, so a smuggled \nlevel=ERROR survives as %0Alevel=ERROR in the captured line — visibly tampered, never authoritative.

AuditField

Structured audit field. Pass-through; the AuditFieldEscaper (#177, slice AC) owns the on-disk encoder and rejects control bytes at emit time. Exposing the typed value here lets the audit lane consume Tainted<String> without going through a string detour.

JsonValue

JSON value. Pass-through; the SerializedJsonField (#178, slice AB) round-trips through serde_json::Value::String and inherits serde’s escape contract. Exposing the typed value here lets the JSON lane consume Tainted<String> without a string detour.

Implementations

impl Boundary

pub fn as_str(self) -> &'static str

Trait Implementations

impl Clone for Boundary

fn clone(&self) -> Boundary

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Boundary

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl PartialEq for Boundary

fn eq(&self, other: &Boundary) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Boundary

impl Eq for Boundary

impl StructuralPartialEq for Boundary