Module: YardExampleTest::Example::Comparison

Included in:

YardExampleTest::Example

Defined in:

lib/yard_example_test/example/comparison.rb

Overview

Comparison and matcher logic for verifying example expectations

This module is included into YardExampleTest::Example so that its methods have direct access to Minitest assertions (+assert+, assert_equal, assert_nil, diff) inherited from Minitest::Spec. It also delegates to the Evaluator (via #evaluator) for expression evaluation.

The module handles three verification strategies:

1. Block matchers — matchers that implement supports_block_expectations? (e.g. RSpec's raise_error, change, output). The actual expression is wrapped in a Proc and passed unevaluated.
2. Value matchers — matchers that implement matches? (e.g. eq, be_a, be_within). The actual expression is evaluated and the resulting value is passed.
3. Bare values — compared via #compare_values using error handling, nil checks, and === case equality.