Struct CompletenessConstraint 

pub struct CompletenessConstraint { /* private fields */ }

A constraint that checks the completeness (non-null ratio) of one or more columns.

This constraint supports:

• Single column completeness checks
• Multiple column completeness with logical operators (All, Any, AtLeast, etc.)
• Configurable thresholds
• Flexible configuration through ConstraintOptions

Examples

use term_guard::constraints::CompletenessConstraint;
use term_guard::core::LogicalOperator;

// Single column - 100% complete (equivalent to is_complete)
let constraint = CompletenessConstraint::complete("user_id");

// Single column with threshold (equivalent to has_completeness)
let constraint = CompletenessConstraint::with_threshold("email", 0.95);

// Multiple columns - all must be complete (equivalent to are_complete)
let constraint = CompletenessConstraint::with_operator(
    vec!["first_name", "last_name"],
    LogicalOperator::All,
    1.0,
);

// Multiple columns - any must be complete (equivalent to are_any_complete)
let constraint = CompletenessConstraint::with_operator(
    vec!["phone", "email", "address"],
    LogicalOperator::Any,
    1.0,
);

// New capability: At least 2 columns must be 90% complete
let constraint = CompletenessConstraint::with_operator(
    vec!["email", "phone", "address", "postal_code"],
    LogicalOperator::AtLeast(2),
    0.9,
);

Implementations

impl CompletenessConstraint

pub fn new(columns: impl Into<ColumnSpec>, options: ConstraintOptions) -> Self

Creates a new unified completeness constraint.

Arguments

• columns - The column(s) to check (accepts single string or vector)
• options - Configuration options including threshold and operator

Panics

Panics if threshold is not between 0.0 and 1.0

pub fn with_threshold(columns: impl Into<ColumnSpec>, threshold: f64) -> Self

Creates a constraint with a specific threshold. Convenience method for the common case.

pub fn complete(columns: impl Into<ColumnSpec>) -> Self

Creates a constraint requiring 100% completeness. Convenience method equivalent to is_complete.

pub fn with_operator( columns: impl Into<ColumnSpec>, operator: LogicalOperator, threshold: f64, ) -> Self

Creates a constraint for multiple columns with a specific operator. Convenience method for multi-column checks.

Trait Implementations

impl Clone for CompletenessConstraint

fn clone(&self) -> CompletenessConstraint

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Constraint for CompletenessConstraint

fn evaluate<'life0, 'life1, 'async_trait>( &'life0 self, ctx: &'life1 SessionContext, ) -> Pin<Box<dyn Future<Output = Result<ConstraintResult>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Evaluates the constraint against the data in the session context.

fn name(&self) -> &str

Returns the name of the constraint.

fn column(&self) -> Option<&str>

Returns the column this constraint operates on (if single-column).

fn metadata(&self) -> ConstraintMetadata

Returns the metadata associated with this constraint.

fn description(&self) -> Option<&str>

Returns a description of what this constraint validates.

impl Debug for CompletenessConstraint

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

Formats the value using the given formatter.

impl UnifiedConstraint for CompletenessConstraint

fn column_spec(&self) -> &ColumnSpec

Returns the column specification for this constraint.

fn logical_operator(&self) -> Option<LogicalOperator>

Returns the logical operator used for multi-column evaluation.

fn evaluate_column<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, ctx: &'life1 SessionContext, column: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<ConstraintResult>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Evaluates the constraint for a single column.

fn options(&self) -> HashMap<String, String>

Returns configuration options as a map.

fn evaluate_unified<'life0, 'life1, 'async_trait>( &'life0 self, ctx: &'life1 SessionContext, ) -> Pin<Box<dyn Future<Output = Result<ConstraintResult>> + Send + 'async_trait>>

where Self: Sync + 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Default implementation of evaluate that handles multi-column logic.