Enhance ConsoleAssert.AssertExpectation with detailed wildcard diff output

[Copilot]

Overview

This PR implements enhanced wildcard diff output for ConsoleAssert.AssertExpectation to provide detailed character-by-character analysis when wildcard matching fails, making it much easier to debug test failures.

Problem

Previously, when wildcard pattern matching failed, the output only showed basic expected vs actual strings:

The values are not like (using wildcards) each other:- 
-----------------------------------
Expected: "PING *(* (::1)) 56 data bytes\n64 bytes from * (::1): icmp_seq=1 ttl=64 time=* ms*"
Actual  : "PING localhost (::1) 56 data bytes\n\n--- localhost ping statistics ---\n4 packets transmitted, 0 received, 100% packet loss, time 3087ms\n\n"
-----------------------------------
The expected length of 81 does not match the output length of 136.

This made it very difficult to identify where wildcards matched and where failures occurred, especially in multiline outputs like ping results.

Solution

Added an enhanced wildcard diff system that provides:

• Line-by-line comparison with ✅/❌ status indicators
• Wildcard match tracking showing what each * matched
• Clear identification of extra/missing lines
• Console-friendly output with visual separators and summary

Example Enhanced Output

The values are not like (using wildcards) each other: Output does not match expected pattern using wildcards.

────────────────────────────────────────────────────────────
Line 1:
Expected: PING * (::1) 56 data bytes
Actual  : PING localhost (::1) 56 data bytes
Match   : ✅

Wildcard matches:
  * => "localhost"

────────────────────────────────────────────────────────────
Line 2:
Expected: 64 bytes from * (::1): icmp_seq=1 ttl=64 time=* ms
Actual  : 64 bytes from localhost (::1): icmp_seq=1 ttl=64 time=0.018 ms
Match   : ✅

Wildcard matches:
  * => "localhost"
  * => "0.018"

────────────────────────────────────────────────────────────
Line 3:
Expected: <no more lines>
Actual  : Extra unexpected line
Match   : ❌ (unexpected extra line)

────────────────────────────────────────────────────────────
Summary:
✅ 2 lines matched
❌ 1 unexpected lines in actual output

Implementation

New Components

• DiffOptions enum: Controls diff behavior (Default vs EnhancedWildcardDiff)
• WildcardDiffAnalyzer: Analyzes patterns and tracks wildcard matches
• WildcardDiffFormatter: Formats enhanced output with line-by-line details

API Changes

Enhanced methods with new overloads that accept DiffOptions:

// Enable enhanced diff for ExpectLike
ConsoleAssert.ExpectLike(expected, action, DiffOptions.EnhancedWildcardDiff);

// Enable enhanced diff for ExecuteProcess
ConsoleAssert.ExecuteProcess(expected, "command", args, out output, out error, 
                            workingDir, DiffOptions.EnhancedWildcardDiff);

// Default behavior unchanged
ConsoleAssert.ExpectLike(expected, action); // Original output format

Backward Compatibility

• All existing APIs remain unchanged
• Enhanced diff is opt-in via the DiffOptions.EnhancedWildcardDiff flag
• All existing tests continue to pass (36/37 tests pass, 1 pre-existing failure unrelated to this change)

Testing

Added comprehensive test suite covering:

• Enhanced diff functionality validation
• Wildcard matching and output formatting
• Comparison with original behavior
• Edge cases (extra lines, missing lines, pattern mismatches)

Fixes #69.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.