qubit-redact 0.9.0

Rule-driven redaction for fields, diagnostics, HTTP data, and Rust domain objects
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

// =============================================================================
//    Copyright (c) 2026 Haixing Hu.
//
//    SPDX-License-Identifier: Apache-2.0
//
//    Licensed under the Apache License, Version 2.0.
// =============================================================================
//! Bounded adapter for streaming debug fragments into a domain writer.

use std::fmt;

use crate::domain::RedactionWriter;

/// `fmt::Write` adapter that stops a `Debug` formatter at the writer's final
/// escaped-output ceiling instead of first materializing an unbounded string.
pub(in crate::domain) struct BoundedDebugWriter<'writer, 'session> {
    /// Domain writer receiving complete formatter fragments.
    pub(in crate::domain) writer: &'writer mut RedactionWriter<'session>,
}

impl fmt::Write for BoundedDebugWriter<'_, '_> {
    /// Forwards `value` into the active writer, returning success when it fits.
    ///
    /// Returns `fmt::Error` when the escaped-output ceiling rejects the
    /// fragment; the underlying domain writer records the resulting
    /// incomplete output.
    fn write_str(&mut self, value: &str) -> fmt::Result {
        if self.writer.write_fragment(value) {
            Ok(())
        } else {
            Err(fmt::Error)
        }
    }
}