Add throwsException matcher for throwable instance

Author: tumbarumba

hamcrest/src/main/java/org/hamcrest/Matchers.java

@@ -2240,6 +2240,18 @@ public static <T extends Runnable> Matcher<T> throwsException() {
     return ThrowsException.throwsException();
   }
 
+  /**
+   * Matcher for {@link Throwable} that expects that the Runnable throws an exception equal to the provided <code>throwable</code>
+   *
+   * @param <U>       type of the Runnable
+   * @param <T>       type of the Throwable
+   * @param throwable the Throwable class against which examined exceptions are compared
+   * @return The matcher.
+   */
+  public static <T extends Runnable, U extends Throwable> Matcher<T> throwsException(U throwable) {
+    return ThrowsException.throwsException(throwable);
+  }
+
   /**
    * Matcher for {@link Throwable} that expects that the Runnable throws an exception of the provided <code>throwableClass</code> class
    *

hamcrest/src/main/java/org/hamcrest/exception/ThrowsException.java

@@ -26,6 +26,10 @@ public static <T extends Runnable> Matcher<T> throwsException() {
     return throwsException(Throwable.class);
   }
 
+  public static <T extends Runnable, U extends Throwable> Matcher<T> throwsException(U throwable) {
+    return throwsException(throwable.getClass(), throwable.getMessage());
+  }
+
   public static <T extends Runnable, U extends Throwable> Matcher<T> throwsException(Class<U> throwableClass) {
     return new ThrowsException<>(new IsInstanceOf(throwableClass), anything("<anything>"));
   }

hamcrest/src/main/java/org/hamcrest/exception/package-info.java

@@ -0,0 +1,4 @@
+/**
+ * Matchers of exceptions.
+ */
+package org.hamcrest.exception;

hamcrest/src/test/java/org/hamcrest/exception/ThrowsExceptionTest.java

@@ -4,6 +4,7 @@
 
 import static org.hamcrest.MatcherAssert.assertThat;
 import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.throwsExceptionWithMessage;
 import static org.hamcrest.exception.ThrowsException.throwsException;
 import static org.hamcrest.test.MatcherAssertions.*;
 
@@ -22,7 +23,10 @@ public void examples() {
     assertThat(ThrowsExceptionTest::throwIllegalArgumentException, throwsException());
     assertThat(ThrowsExceptionTest::throwIllegalArgumentException, throwsException(RuntimeException.class));
     assertThat(ThrowsExceptionTest::throwIllegalArgumentException, throwsException(RuntimeException.class, "Boom!"));
+    assertThat(ThrowsExceptionTest::throwIllegalArgumentException, throwsException(new IllegalArgumentException("Boom!")));
     assertThat(ThrowsExceptionTest::throwIllegalArgumentException, throwsException(RuntimeException.class, containsString("Boo")));
+    assertThat(ThrowsExceptionTest::throwIllegalArgumentException, throwsExceptionWithMessage("Boom!"));
+    assertThat(ThrowsExceptionTest::throwIllegalArgumentException, throwsExceptionWithMessage(containsString("Boo")));
   }
 
   @Test