Enum Eval 

pub enum Eval {
    Boolean {
        criterion: String,
        expected: bool,
        name: Option<String>,
    },
    Numeric {
        criterion: String,
        min: f64,
        max: f64,
        threshold: f64,
        comparator: Comparator,
        name: Option<String>,
    },
    Called {
        mock: String,
        times: Option<u64>,
        where: BTreeMap<String, FieldPredicate>,
        name: Option<String>,
    },
    NotCalled {
        mock: String,
        where: BTreeMap<String, FieldPredicate>,
        name: Option<String>,
    },
}

An eval specification, as written in a test case’s YAML.

Variants

Boolean

Assert a plain-English criterion holds (or, with expected: false, that it does not).

Fields

criterion: String

The criterion the judge evaluates against the transcript.

expected: bool

What the judge’s verdict must equal to pass. Defaults to true.

name: Option<String>

Optional human label for reports.

Numeric

Score a plain-English criterion on a numeric scale and compare it to a threshold.

Fields

criterion: String

The criterion the judge scores.

min: f64

Inclusive lower bound of the scale.

max: f64

Inclusive upper bound of the scale.

threshold: f64

The passing threshold.

comparator: Comparator

How the score is compared to threshold. Defaults to >=.

name: Option<String>

Optional human label for reports.

Called

Deterministic: assert the referenced mock/spy observed at least one matching call (or exactly times). Evaluated against the mock channel’s records, not by a judge.

Fields

mock: String

The mocks: declaration (mock or spy) this asserts on, by name.

times: Option<u64>

Exact required call count; absent means “at least once”.

where: BTreeMap<String, FieldPredicate>

Optional per-field input predicates narrowing which calls count.

name: Option<String>

Optional human label for reports.

NotCalled

Deterministic: assert the referenced mock/spy observed no matching call.

Fields

mock: String

The mocks: declaration (mock or spy) this asserts on, by name.

where: BTreeMap<String, FieldPredicate>

Optional per-field input predicates narrowing which calls count.

name: Option<String>

Optional human label for reports.

Implementations

impl Eval

pub fn criterion(&self) -> Option<&str>

The criterion text the judge sees; None for the deterministic (called/not_called) kinds, which no judge ever scores.

pub fn label(&self) -> String

A short label for reports: the explicit name if given, else the criterion (judge kinds) or called: <mock> / not_called: <mock>.

pub fn validate(&self) -> Result<()>

Validate the eval’s own parameters (independent of any transcript).

Errors

Error::Invalid when a criterion is empty, a numeric scale is degenerate (min >= max), the threshold falls outside [min, max], a call eval references an empty mock name or asks for times: 0, or a where predicate is malformed.

pub fn outcome_for_calls( &self, count: usize, observed: &str, ) -> Result<EvalOutcome>

Apply a deterministic call eval’s pass rule to the number of matching observed calls, producing an outcome. Only meaningful for Eval::Called/Eval::NotCalled; the runner never routes judge kinds here.

Errors

Error::Invalid if invoked on a judge-backed eval kind (a runner bug, surfaced loudly rather than scored vacuously).

pub fn outcome(&self, raw: &JudgeValue, reason: String) -> Result<EvalOutcome>

Apply this eval’s pass rule to a raw judge value, producing an outcome.

raw is the value the judge returned: JudgeValue::Bool for boolean evals, JudgeValue::Number for numeric. A mismatch is a provider error.

Errors

Error::Provider if the judge returned the wrong value kind for this eval.

Trait Implementations

impl Clone for Eval

fn clone(&self) -> Eval

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Eval

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Eval

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Eval

fn eq(&self, other: &Eval) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Eval

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Eval