class Tryouts::ExpectationEvaluators::True

  • Part of unified #= prefix convention for all expectation types
    - Expression evaluation provides flexible boolean logic testing
    - Clear expected display explains the exact requirement
    - Strict true matching prevents accidental truthy value acceptance
    DESIGN DECISIONS:
    - Distinguishes from regular expectations through strict true matching
    - Actual display shows the evaluated expression result
    - Expected display shows ‘true (exactly)’ for clarity
    - Expression has access to ‘result` and `_` variables (actual_result)
    IMPLEMENTATION DETAILS:
    - Encourages explicit boolean expressions in documentation
    - Uses Ruby’s === comparison for exact boolean matching
    - Fails for false, nil, 0, “”, [], {}, or any non-true value
    - Only passes when expression evaluates to exactly true (not truthy)
    BOOLEAN STRICTNESS:
    [1, 2, 3] #==> result.length # Fail: expression is 3 (truthy but not true)
    [1, 2, 3] #==> result.empty? # Fail: expression is false
    [] #==> result.empty? # Pass: expression is true
    [1, 2, 3] #==> result.include?(2) # Pass: expression is true
    [1, 2, 3] #==> result.length == 3 # Pass: expression is true
    Examples:
    SYNTAX: #==> boolean_expression
    - Distinguishes between true/false and truthy/falsy values
    - Provides explicit boolean validation for documentation-style tests
    - Validates that an expression evaluates to exactly true (not truthy)
    PURPOSE:
    Evaluator for boolean true expectations using syntax: #==> expression

def self.handles?(expectation_type) 

def self.handles?(expectation_type)
  expectation_type == :true # rubocop:disable Lint/BooleanSymbol
end

def evaluate(actual_result = nil) 

def evaluate(actual_result = nil)
  expectation_result = ExpectationResult.from_result(actual_result)
  expression_result  = eval_expectation_content(@expectation.content, expectation_result)
  build_result(
    passed: expression_result == true,
    actual: expression_result,
    expected: true,
  )
rescue StandardError => ex
  handle_evaluation_error(ex, actual_result)
end