Struct RedactionTextOutput 

pub struct RedactionTextOutput { /* private fields */ }

Published safe text and completion metadata from one redaction operation.

When redaction is enabled, Self::text remains confidentiality-safe for every completion state. Truncated and Exhausted describe incomplete diagnostics, not unsafe text. Callers need to reject or replace such text only when their own contract requires completeness.

Examples

use qubit_redact::RedactionCompletion;
use qubit_redact::Redactor;

let output = Redactor::strict().redact_field("password", "raw-secret");
assert_eq!(output.summary().completion(), RedactionCompletion::Complete);

Implementations

impl RedactionTextOutput

pub const fn text(&self) -> &RedactedText

Borrows the final text.

pub const fn summary(&self) -> &RedactionSummary

Borrows the execution summary.

pub fn complete_text(&self) -> Result<&RedactedText, &RedactionSummary>

Borrows the final text when the operation completed without truncation or exhaustion.

Errors

Returns the execution summary when the safe output was truncated or exhausted. The error reports completeness; it does not imply that the published text is unsafe for diagnostics.

pub fn text_or_marker(&self, marker: &str) -> Cow<'_, str>

Borrows the final text or returns an escaped caller-selected marker when the operation was incomplete.

The complete path does not allocate. An incomplete marker is escaped before publication so control characters cannot forge diagnostic log structure. The marker is selected after the transaction and therefore does not consume its resource budget.

pub fn into_complete_text(self) -> Result<RedactedText, RedactionSummary>

Consumes a complete output and returns its final text.

Errors

Returns the execution summary when the safe output was truncated or exhausted. The error reports completeness; it does not imply that the published text is unsafe for diagnostics.

pub fn into_text_or_marker(self, marker: &str) -> RedactedText

Consumes the output and returns a caller-selected marker when it is incomplete.

The marker is escaped before becoming RedactedText, so it remains safe for diagnostic presentation.

pub fn into_parts(self) -> (RedactedText, RedactionSummary)

Consumes the output and returns both parts.

Trait Implementations

impl Clone for RedactionTextOutput

fn clone(&self) -> RedactionTextOutput

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RedactionTextOutput

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

Formats the value using the given formatter.

impl Eq for RedactionTextOutput

impl PartialEq for RedactionTextOutput

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RedactionTextOutput