qubit-metadata 0.3.0

Type-safe extensible metadata model for the Qubit LLM SDK
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) 2025 - 2026.
 *    Haixing Hu, Qubit Co. Ltd.
 *
 *    All rights reserved.
 *
 ******************************************************************************/
//! [`MissingKeyPolicy`] — how filters treat missing keys for negative predicates.

use serde::{Deserialize, Serialize};

/// Policy that controls how filters treat missing keys for negative predicates.
///
/// The policy only affects [`crate::Condition::NotEqual`] and [`crate::Condition::NotIn`].
/// Other predicates keep their existing semantics (`equal` requires presence,
/// `exists` / `not_exists` check presence directly, etc.).
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default, Serialize, Deserialize)]
pub enum MissingKeyPolicy {
    /// Missing keys satisfy negative predicates (`not_equal`, `not_in_values`).
    ///
    /// This is the historical behavior and therefore the default.
    #[default]
    Match,
    /// Missing keys do not satisfy negative predicates.
    NoMatch,
}

impl MissingKeyPolicy {
    #[inline]
    pub(crate) const fn matches_negative_predicates(self) -> bool {
        matches!(self, Self::Match)
    }
}