Package dev.dokimos.core.evaluators.agents

Class TolerantArgumentMatcher

java.lang.Object

dev.dokimos.core.evaluators.agents.TolerantArgumentMatcher

All Implemented Interfaces:

ArgumentMatcher

public final class TolerantArgumentMatcher
extends Object
implements ArgumentMatcher

Default ArgumentMatcher that compares arguments structurally with a few deliberate tolerances.

Value comparison rules:

• Numbers are compared by numeric value, so 1, 1.0 and 1L are equal. This is always on, because exact Map.equals treating 1 and 1.0 as different is a JSON-widening artifact, not intended behavior.
• Strings are compared exactly by default. TolerantArgumentMatcher.Builder.trimStrings(boolean) and TolerantArgumentMatcher.Builder.caseInsensitive(boolean) relax this, but both are off by default so existing pass/fail outcomes are never silently changed.
• Maps and lists are compared recursively using the same rules.

Key-set handling follows the configured ArgMatchMode.

 ArgumentMatcher matcher = TolerantArgumentMatcher.builder()
         .mode(ArgMatchMode.SUBSET)   // only expected keys must be present and correct
         .trimStrings(true)
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	TolerantArgumentMatcher.Builder	Builder for constructing the matcher.

Method Summary

Modifier and Type	Method	Description
static TolerantArgumentMatcher.Builder	builder()	Creates a new builder for constructing the matcher.
boolean	matches(Map<String,Object> expected, Map<String,Object> actual)	Determines whether the actual arguments match the expected arguments.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

builder

public static TolerantArgumentMatcher.Builder builder()

Creates a new builder for constructing the matcher.

Returns:

a new builder

matches

public boolean matches(Map<String,Object> expected,
 Map<String,Object> actual)

Description copied from interface: ArgumentMatcher

Determines whether the actual arguments match the expected arguments.

Specified by:

matches in interface ArgumentMatcher

Parameters:

expected - the expected arguments

actual - the actual arguments produced by the agent

Returns:

true if the arguments match under this matcher's policy