qubit-redact 0.8.1

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
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

// =============================================================================
//    Copyright (c) 2026 Haixing Hu.
//
//    SPDX-License-Identifier: Apache-2.0
//
//    Licensed under the Apache License, Version 2.0.
// =============================================================================
//! Location of a policy-building validation error.

use std::fmt;

/// Policy construction context where a validation error occurred.
///
/// # Examples
///
/// ```
/// use qubit_redact::PolicyLocation;
///
/// assert_eq!(PolicyLocation::Rules.to_string(), "rules");
/// ```
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
#[non_exhaustive]
pub enum PolicyLocation {
    /// Regular field-rule construction context.
    Rules,
    /// Floor construction context.
    Floor,
    /// HTTP header field rules in an HTTP policy builder.
    HttpHeader,
    /// HTTP query and form field rules in an HTTP policy builder.
    HttpQuery,
    /// HTTP body field rules in an HTTP policy builder.
    HttpBody,
    /// Shared HTTP masking policy.
    HttpMasking,
}

impl fmt::Display for PolicyLocation {
    /// Writes the stable lowercase label, propagating any destination formatter
    /// error.
    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Self::Rules => formatter.write_str("rules"),
            Self::Floor => formatter.write_str("floor"),
            Self::HttpHeader => formatter.write_str("http header"),
            Self::HttpQuery => formatter.write_str("http query"),
            Self::HttpBody => formatter.write_str("http body"),
            Self::HttpMasking => formatter.write_str("http masking"),
        }
    }
}