Struct ScoreValidator 

pub struct ScoreValidator { /* private fields */ }

A reusable validator for score ranges.

This validator can be configured with custom min/max bounds and field names, making it suitable for validating confidence scores, probabilities, and other numerical ranges across different tasks.

Examples

use oar_ocr_core::utils::validation::ScoreValidator;
use oar_ocr_core::core::OCRError;
let validator = ScoreValidator::new_unit_range("confidence");
validator.validate_scores(&[0.5, 0.8, 0.95], "Detection")?;

Implementations

impl ScoreValidator

pub fn new(min: f32, max: f32, field_name: impl Into<String>) -> ScoreValidator

Creates a new score validator with custom bounds.

Arguments

• min - Minimum valid score (inclusive)
• max - Maximum valid score (inclusive)
• field_name - Name of the field being validated (for error messages)

pub fn new_unit_range(field_name: impl Into<String>) -> ScoreValidator

Creates a validator for unit range scores [0.0, 1.0].

This is the most common case for confidence scores and probabilities.

pub fn validate_score(&self, score: f32, context: &str) -> Result<(), OCRError>

Validates a single score value.

Errors

Returns OCRError::InvalidInput if the score is outside the valid range.

pub fn validate_scores( &self, scores: &[f32], context_prefix: &str, ) -> Result<(), OCRError>

Validates a collection of scores.

Errors

Returns OCRError::InvalidInput if any score is outside the valid range. The error message includes the index of the invalid score.

pub fn validate_scores_with<F>( &self, scores: &[f32], format_context: F, ) -> Result<(), OCRError>

where F: Fn(usize) -> String,

Validates a collection of scores with a custom index formatter.

This is useful when you want to provide more context in error messages, such as “Image 3, detection 2” instead of just an index.

Trait Implementations

impl Clone for ScoreValidator

fn clone(&self) -> ScoreValidator

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ScoreValidator

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

Formats the value using the given formatter.