Struct UniquenessConstraint 

pub struct UniquenessConstraint { /* private fields */ }

A unified constraint that handles all types of uniqueness validation.

This constraint consolidates the functionality of multiple uniqueness-related constraints:

• UniquenessConstraint - Full uniqueness with threshold
• DistinctnessConstraint - Distinctness ratio validation
• UniqueValueRatioConstraint - Values appearing exactly once
• PrimaryKeyConstraint - Unique + non-null validation

Examples

Full Uniqueness (replacing UniquenessConstraint)

use term_guard::constraints::{UniquenessConstraint, UniquenessType};

// Single column uniqueness
let constraint = UniquenessConstraint::full_uniqueness("user_id", 1.0)?;

// Multi-column uniqueness with threshold
let constraint = UniquenessConstraint::full_uniqueness_multi(
    vec!["email", "domain"],
    0.95
)?;

Distinctness (replacing DistinctnessConstraint)

use term_guard::constraints::{UniquenessConstraint, Assertion};

let constraint = UniquenessConstraint::distinctness(
    vec!["category"],
    Assertion::GreaterThan(0.8)
)?;

Primary Key (replacing PrimaryKeyConstraint)

use term_guard::constraints::UniquenessConstraint;

let constraint = UniquenessConstraint::primary_key(
    vec!["order_id", "line_item_id"]
)?;

Implementations

impl UniquenessConstraint

pub fn new<I, S>( columns: I, uniqueness_type: UniquenessType, options: UniquenessOptions, ) -> Result<Self>

where I: IntoIterator<Item = S>, S: Into<String>,

Creates a new unified uniqueness constraint.

Arguments

• columns - The columns to check for uniqueness
• uniqueness_type - The type of uniqueness validation to perform
• options - Configuration options for the constraint

Errors

Returns error if column names are invalid or thresholds are out of range.

pub fn full_uniqueness( column: impl Into<String>, threshold: f64, ) -> Result<Self>

Creates a full uniqueness constraint for a single column.

This replaces UniquenessConstraint::single().

pub fn full_uniqueness_multi<I, S>(columns: I, threshold: f64) -> Result<Self>

where I: IntoIterator<Item = S>, S: Into<String>,

Creates a full uniqueness constraint for multiple columns.

This replaces UniquenessConstraint::multiple() and UniquenessConstraint::with_threshold().

pub fn distinctness<I, S>(columns: I, assertion: Assertion) -> Result<Self>

where I: IntoIterator<Item = S>, S: Into<String>,

Creates a distinctness constraint.

This replaces DistinctnessConstraint::new().

pub fn unique_value_ratio<I, S>( columns: I, assertion: Assertion, ) -> Result<Self>

where I: IntoIterator<Item = S>, S: Into<String>,

Creates a unique value ratio constraint.

This replaces UniqueValueRatioConstraint::new().

pub fn primary_key<I, S>(columns: I) -> Result<Self>

where I: IntoIterator<Item = S>, S: Into<String>,

Creates a primary key constraint.

This replaces PrimaryKeyConstraint::new().

pub fn unique_with_nulls<I, S>( columns: I, threshold: f64, null_handling: NullHandling, ) -> Result<Self>

where I: IntoIterator<Item = S>, S: Into<String>,

Creates a uniqueness constraint that allows NULLs.

pub fn unique_composite<I, S>( columns: I, threshold: f64, null_handling: NullHandling, case_sensitive: bool, ) -> Result<Self>

where I: IntoIterator<Item = S>, S: Into<String>,

Creates a composite uniqueness constraint with advanced options.

pub fn columns(&self) -> &[String]

Returns the columns being validated.

pub fn uniqueness_type(&self) -> &UniquenessType

Returns the uniqueness type.

pub fn options(&self) -> &UniquenessOptions

Returns the constraint options.

Trait Implementations

impl Clone for UniquenessConstraint

fn clone(&self) -> UniquenessConstraint

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Constraint for UniquenessConstraint

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 UniquenessConstraint

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

Formats the value using the given formatter.