that() records exceptions instead of throwing them immediately.

Author: cowwoc

README.md

@@ -50,11 +50,11 @@ public final class Cake
   public int eat()
   {
     ++bitesTaken;
-    assert that(bitesTaken, "bitesTaken").isNotNegative();
+    assert that(bitesTaken, "bitesTaken").isNotNegative().elseThrow();
 
     piecesLeft -= ThreadLocalRandom.current().nextInt(5);
 
-    assert that(piecesLeft, "piecesLeft").isNotNegative();
+    assert that(piecesLeft, "piecesLeft").isNotNegative().elseThrow();
     return piecesLeft;
   }
 

guava/src/main/java/com/github/cowwoc/requirements10/guava/DefaultGuavaValidators.java

@@ -58,8 +58,9 @@ public static <K, V, T extends Multimap<K, V>> MultimapValidator<T, K, V> requir
 	/**
 	 * Validates the state of a {@code Multimap}.
 	 * <p>
-	 * The returned validator throws an exception immediately if a validation fails. This exception is then
-	 * converted into an {@link AssertionError}. Exceptions unrelated to validation failures are not converted.
+	 * The returned validator captures exceptions on validation failure rather than throwing them immediately.
+	 * The exceptions are converted into an {@link AssertionError} and can be retrieved or thrown once the
+	 * validation completes. Exceptions unrelated to validation failures are thrown immediately.
 	 * <p>
 	 * This method is intended to be used with the {@code assert} keyword, like so:
 	 * {@code assert that(value, name)}.

guava/src/main/java/com/github/cowwoc/requirements10/guava/GuavaAssertThat.java

@@ -11,8 +11,9 @@ public interface GuavaAssertThat
 	/**
 	 * Validates the state of a {@code Multimap}.
 	 * <p>
-	 * The returned validator throws an exception immediately if a validation fails. This exception is then
-	 * converted into an {@link AssertionError}. Exceptions unrelated to validation failures are not converted.
+	 * The returned validator captures exceptions on validation failure rather than throwing them immediately.
+	 * The exceptions are converted into an {@link AssertionError} and can be retrieved or thrown once the
+	 * validation completes. Exceptions unrelated to validation failures are thrown immediately.
 	 * <p>
 	 * This method is intended to be used with the {@code assert} keyword, like so:
 	 * {@code assert that(value, name)}.
@@ -31,8 +32,9 @@ public interface GuavaAssertThat
 	/**
 	 * Validates the state of a {@code Multimap}.
 	 * <p>
-	 * The returned validator throws an exception immediately if a validation fails. This exception is then
-	 * converted into an {@link AssertionError}. Exceptions unrelated to validation failures are not converted.
+	 * The returned validator captures exceptions on validation failure rather than throwing them immediately.
+	 * The exceptions are converted into an {@link AssertionError} and can be retrieved or thrown once the
+	 * validation completes. Exceptions unrelated to validation failures are thrown immediately.
 	 * <p>
 	 * This method is intended to be used with the {@code assert} keyword, like so:
 	 * {@code assert that(value, name)}.

jackson/src/main/java/com/github/cowwoc/requirements10/jackson/DefaultJacksonValidators.java

@@ -57,8 +57,9 @@ public static <T extends JsonNode> JsonNodeValidator<T> requireThat(T value, Str
 	/**
 	 * Validates the state of a {@code JsonNode}.
 	 * <p>
-	 * The returned validator throws an exception immediately if a validation fails. This exception is then
-	 * converted into an {@link AssertionError}. Exceptions unrelated to validation failures are not converted.
+	 * The returned validator captures exceptions on validation failure rather than throwing them immediately.
+	 * The exceptions are converted into an {@link AssertionError} and can be retrieved or thrown once the
+	 * validation completes. Exceptions unrelated to validation failures are thrown immediately.
 	 * <p>
 	 * This method is intended to be used with the {@code assert} keyword, like so:
 	 * {@code assert that(value, name)}.
@@ -78,8 +79,9 @@ public static <T extends JsonNode> JsonNodeValidator<T> that(T value, String nam
 	/**
 	 * Validates the state of a {@code JsonNode}.
 	 * <p>
-	 * The returned validator throws an exception immediately if a validation fails. This exception is then
-	 * converted into an {@link AssertionError}. Exceptions unrelated to validation failures are not converted.
+	 * The returned validator captures exceptions on validation failure rather than throwing them immediately.
+	 * The exceptions are converted into an {@link AssertionError} and can be retrieved or thrown once the
+	 * validation completes. Exceptions unrelated to validation failures are thrown immediately.
 	 * <p>
 	 * This method is intended to be used with the {@code assert} keyword, like so:
 	 * {@code assert that(value, name)}.

jackson/src/main/java/com/github/cowwoc/requirements10/jackson/JacksonAssertThat.java

@@ -12,8 +12,9 @@ public interface JacksonAssertThat
 	/**
 	 * Validates the state of a {@code JsonNode}.
 	 * <p>
-	 * The returned validator throws an exception immediately if a validation fails. This exception is then
-	 * converted into an {@link AssertionError}. Exceptions unrelated to validation failures are not converted.
+	 * The returned validator captures exceptions on validation failure rather than throwing them immediately.
+	 * The exceptions are converted into an {@link AssertionError} and can be retrieved or thrown once the
+	 * validation completes. Exceptions unrelated to validation failures are thrown immediately.
 	 * <p>
 	 * This method is intended to be used with the {@code assert} keyword, like so:
 	 * {@code assert that(value, name)}.
@@ -30,8 +31,9 @@ public interface JacksonAssertThat
 	/**
 	 * Validates the state of a {@code JsonNode}.
 	 * <p>
-	 * The returned validator throws an exception immediately if a validation fails. This exception is then
-	 * converted into an {@link AssertionError}. Exceptions unrelated to validation failures are not converted.
+	 * The returned validator captures exceptions on validation failure rather than throwing them immediately.
+	 * The exceptions are converted into an {@link AssertionError} and can be retrieved or thrown once the
+	 * validation completes. Exceptions unrelated to validation failures are thrown immediately.
 	 * <p>
 	 * This method is intended to be used with the {@code assert} keyword, like so:
 	 * {@code assert that(value, name)}.