From 151c0eef039d7ebde1496cb6e46cc6a395d52978 Mon Sep 17 00:00:00 2001
From: AOUDIA <mf.aoudia@gmail.com>
Date: Thu, 27 May 2021 12:43:05 +0200
Subject: [PATCH] feat: add stringContainsInAnyOrder matcher

resolves #346
---
 .../src/main/java/org/hamcrest/Matchers.java  | 28 ++++++++
 .../text/StringContainsInAnyOrder.java        | 66 +++++++++++++++++++
 .../text/StringContainsInAnyOrderTest.java    | 31 +++++++++
 3 files changed, 125 insertions(+)
 create mode 100644 hamcrest/src/main/java/org/hamcrest/text/StringContainsInAnyOrder.java
 create mode 100644 hamcrest/src/test/java/org/hamcrest/text/StringContainsInAnyOrderTest.java

diff --git a/hamcrest/src/main/java/org/hamcrest/Matchers.java b/hamcrest/src/main/java/org/hamcrest/Matchers.java
index 38907b1b..db9c2285 100644
--- a/hamcrest/src/main/java/org/hamcrest/Matchers.java
+++ b/hamcrest/src/main/java/org/hamcrest/Matchers.java
@@ -1912,6 +1912,34 @@ public static Matcher<java.lang.String> matchesPattern(java.lang.String regex) {
     return org.hamcrest.text.MatchesPattern.matchesPattern(regex);
   }
 
+  /**
+   * Creates a matcher of {@link String} that matches when the examined string contains all of
+   * the specified substrings.
+   * For example:
+   * <pre>assertThat("mybarbaz", stringContainsInAnyOrder(Arrays.asList("bar", "foo")))</pre>
+   * fails as "foo" doesn't exist in the string "mybarbaz"
+   *
+   * @param substrings
+   *     the substrings that must be contained within matching strings
+   */
+  public static Matcher<java.lang.String> stringContainsInAnyOrder(java.lang.Iterable<java.lang.String> substrings) {
+    return org.hamcrest.text.StringContainsInAnyOrder.stringContainsInAnyOrder(substrings);
+  }
+
+  /**
+   * Creates a matcher of {@link String} that matches when the examined string contains all of
+   * the specified substrings.
+   * For example:
+   * <pre>assertThat("mybarbaz", stringContainsInOrder("bar", "foo"))</pre>
+   * fails as "foo" doesn't exist in the string "mybarbaz"
+   *
+   * @param substrings
+   *     the substrings that must be contained within matching strings
+   */
+  public static Matcher<java.lang.String> stringContainsInAnyOrder(java.lang.String... substrings) {
+    return org.hamcrest.text.StringContainsInAnyOrder.stringContainsInAnyOrder(substrings);
+  }
+
   /**
    * Creates a matcher of {@link String} that matches when the examined string contains all of
    * the specified substrings, considering the order of their appearance.
diff --git a/hamcrest/src/main/java/org/hamcrest/text/StringContainsInAnyOrder.java b/hamcrest/src/main/java/org/hamcrest/text/StringContainsInAnyOrder.java
new file mode 100644
index 00000000..b0cc4424
--- /dev/null
+++ b/hamcrest/src/main/java/org/hamcrest/text/StringContainsInAnyOrder.java
@@ -0,0 +1,66 @@
+package org.hamcrest.text;
+
+import org.hamcrest.Description;
+import org.hamcrest.Matcher;
+import org.hamcrest.TypeSafeMatcher;
+
+import java.util.Arrays;
+
+public class StringContainsInAnyOrder extends TypeSafeMatcher<String> {
+    private final Iterable<String> substrings;
+
+    public StringContainsInAnyOrder(Iterable<String> substrings) {
+        this.substrings = substrings;
+    }
+
+    @Override
+    public boolean matchesSafely(String s) {
+        for (String substring : substrings) {
+            if (!s.contains(substring) ) {
+                return false;
+            }
+        }
+        
+        return true;
+    }
+
+    @Override
+    public void describeMismatchSafely(String item, Description mismatchDescription) {
+        mismatchDescription.appendText("was \"").appendText(item).appendText("\"");
+    }
+    
+    @Override
+    public void describeTo(Description description) {
+        description.appendText("a string containing ")
+                   .appendValueList("", ", ", "", substrings)
+                   .appendText(" in any order");
+    }
+    
+    /**
+     * Creates a matcher of {@link String} that matches when the examined string contains all of
+     * the specified substrings.
+     * For example:
+     * <pre>assertThat("mybarbaz", stringContainsInAnyOrder(Arrays.asList("bar", "foo")))</pre>
+     * fails as "foo" doesn't exist in the string "mybarbaz"
+     * 
+     * @param substrings
+     *     the substrings that must be contained within matching strings
+     */
+    public static Matcher<String> stringContainsInAnyOrder(Iterable<String> substrings) {
+        return new StringContainsInAnyOrder(substrings);
+    }
+
+    /**
+     * Creates a matcher of {@link String} that matches when the examined string contains all of
+     * the specified substrings.
+     * For example:
+     * <pre>assertThat("mybarbaz", stringContainsInOrder("bar", "foo"))</pre>
+     * fails as "foo" doesn't exist in the string "mybarbaz"
+     *
+     * @param substrings
+     *     the substrings that must be contained within matching strings
+     */
+    public static Matcher<String> stringContainsInAnyOrder(String... substrings) {
+        return new StringContainsInAnyOrder(Arrays.asList(substrings));
+    }
+}
diff --git a/hamcrest/src/test/java/org/hamcrest/text/StringContainsInAnyOrderTest.java b/hamcrest/src/test/java/org/hamcrest/text/StringContainsInAnyOrderTest.java
new file mode 100644
index 00000000..ed1e10b2
--- /dev/null
+++ b/hamcrest/src/test/java/org/hamcrest/text/StringContainsInAnyOrderTest.java
@@ -0,0 +1,31 @@
+package org.hamcrest.text;
+
+import static java.util.Arrays.asList;
+import static org.hamcrest.text.StringContainsInAnyOrder.stringContainsInAnyOrder;
+
+import org.hamcrest.AbstractMatcherTest;
+import org.hamcrest.Matcher;
+
+
+public class StringContainsInAnyOrderTest extends AbstractMatcherTest {
+    final StringContainsInAnyOrder matcher = new StringContainsInAnyOrder(asList("a", "b", "c"));
+
+    @Override
+    protected Matcher<?> createMatcher() {
+        return matcher;
+    }
+    
+    public void testMatchesOnlyIfStringContainsGivenSubstringsInTheSameOrder() {
+        assertMatches("substrings in order", matcher, "abcccccc");
+        assertMatches("substrings out of order", matcher, "cab");
+        assertMatches("substrings separated", matcher, "1c2a3b");
+
+        assertDoesNotMatch("no substrings in string", matcher, "xyz");
+        assertDoesNotMatch("substring missing", matcher, "ac");
+        assertDoesNotMatch("empty string", matcher, "");
+    }
+    
+    public void testHasAReadableDescription() {
+        assertDescription("a string containing \"a\", \"b\", \"c\" in any order", matcher);
+    }
+}