matchers: containExactly more details for single mismatch (#1594)

Author: MykolaGolubyev

webtau-core/src/main/java/org/testingisdocumenting/webtau/expectation/contain/ContainExactlyMatcher.java

@@ -112,6 +112,11 @@ public boolean matches(ValuePath actualPath, Object actualIterable) {
         return result;
     }
 
+    @Override
+    public Set<ValuePath> matchedPaths() {
+        return comparator.generateEqualMatchPaths();
+    }
+
     @Override
     public TokenizedMessage negativeMatchingTokenizedMessage(ValuePath actualPath, Object actual) {
         comparator = CompareToComparator.comparator(CompareToComparator.AssertionMode.NOT_EQUAL);
@@ -246,7 +251,7 @@ private ValuePathLazyMessageList extractPotentialNotEqualMessages() {
             List<ValuePathLazyMessageList> messagesWithMinFailures = notEqualMessageBatches.stream()
                     .filter(v -> v.size() == minNumberOMismatches).toList();
 
-            if (notEqualMessageBatches.size() != messagesWithMinFailures.size()) {
+            if (messagesWithMinFailures.size() == 1 || notEqualMessageBatches.size() != messagesWithMinFailures.size()) {
                 messagesWithMinFailures.forEach(notEqualCandidateMessages::addAll);
             }
         }

webtau-core/src/test/java/org/testingisdocumenting/webtau/expectation/contain/ContainExactlyMatcherJavaTest.java

@@ -130,13 +130,17 @@ public void suspectCandidateWithMissing() {
                                                                 {"id": "id2", "level": 4, "monthsAtCompany": 20}
                                                               ]:
                     no matches found for: [{"id": "id1", "level": 8, "monthsAtCompany": 10}]
-                    unexpected elements: [{"id": "id1", "level": 5}]
+                    possible mismatches:
+                   \s
+                    [value][0].level:  actual: 5 <java.lang.Integer>
+                                     expected: 8 <java.lang.Integer>
+                   \s
                     missing values:
                    \s
                     [value][0].monthsAtCompany: 10 (Xms)
                  \s
                   [
-                    {"id": "id1", "level": 5, "monthsAtCompany": **<missing>**},
+                    {"id": "id1", "level": **5**, "monthsAtCompany": **<missing>**},
                     {"id": "id1", "level": 7, "monthsAtCompany": 12},
                     {"id": "id2", "level": 4, "monthsAtCompany": 20}
                   ]""", () -> {
@@ -161,13 +165,19 @@ public void suspectCandidateWithExtra() {
                                                                 {"id": "id2", "level": 4, "monthsAtCompany": 20}
                                                               ]:
                     no matches found for: [{"id": "id1", "level": 8, "monthsAtCompany": 10}]
-                    unexpected elements: [{"id": "id1", "level": 5, "monthsAtCompany": 14, "salary": "yes"}]
+                    possible mismatches:
+                   \s
+                    [value][0].level:  actual: 5 <java.lang.Integer>
+                                     expected: 8 <java.lang.Integer>
+                    [value][0].monthsAtCompany:  actual: 14 <java.lang.Integer>
+                                               expected: 10 <java.lang.Integer>
+                   \s
                     extra values:
                    \s
                     [value][0].salary: "yes" (Xms)
                  \s
                   [
-                    {"id": "id1", "level": 5, "monthsAtCompany": 14, "salary": **"yes"**},
+                    {"id": "id1", "level": **5**, "monthsAtCompany": **14**, "salary": **"yes"**},
                     {"id": "id1", "level": 7, "monthsAtCompany": 12},
                     {"id": "id2", "level": 4, "monthsAtCompany": 20}
                   ]""", () -> {
@@ -210,7 +220,7 @@ public void negativeMismatch() {
                 X failed expecting [value] to not contain exactly ["of", "world", "of", "hello", "testing"]:
                     contains exactly ["of", "world", "of", "hello", "testing"] (Xms)
                  \s
-                  ["hello", "world", "of", "of", "testing"]""", () -> {
+                  [**"hello"**, **"world"**, **"of"**, **"of"**, **"testing"**]""", () -> {
             List<String> list = List.of("hello", "world", "of", "of", "testing");
             actual(list).shouldNot(containExactly("of", "world", "of", "hello", "testing"));
         });

webtau-docs/znai/release-notes/2.4/add-2024-05-08-contain-exactly.md

@@ -0,0 +1 @@
+* Add: More details when [containExactly](matchers/contain-exactly) mismatching a single element