Updated dependencies

cowwoc · cowwoc · commit 5d124cd2dc12 · 2026-01-06T18:04:12.000-05:00
diff --git a/.github/workflows/reusable-build.yml b/.github/workflows/reusable-build.yml
@@ -26,7 +26,7 @@ jobs:
         uses: actions/setup-java@v4
         with:
           distribution: temurin
-          java-version: 21
+          java-version: 25
 
       - name: Cache Dependencies
         uses: actions/cache@v4
diff --git a/.mvn/wrapper/maven-wrapper.properties b/.mvn/wrapper/maven-wrapper.properties
@@ -14,6 +14,6 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-wrapperVersion=3.3.2
+wrapperVersion=3.3.4
 distributionType=only-script
-distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.9/apache-maven-3.9.9-bin.zip
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.12/apache-maven-3.9.12-bin.zip
diff --git a/README.md b/README.md
@@ -2,7 +2,7 @@
 [![build-status](../../workflows/Build/badge.svg)](../../actions?query=workflow%3ABuild)
 [![Maven Central](https://maven-badges.herokuapp.com/maven-central/io.github.cowwoc.requirements/requirements/badge.svg)](https://central.sonatype.com/search?q=g:io.github.cowwoc.requirements)
 <br>
-[![API](https://img.shields.io/badge/api_docs-5B45D5.svg)](https://cowwoc.github.io/requirements.java/12.0/)
+[![API](https://img.shields.io/badge/api_docs-5B45D5.svg)](https://cowwoc.github.io/requirements.java/12.2/)
 [![Changelog](https://img.shields.io/badge/changelog-A345D5.svg)](docs/changelog.md)
 [![javascript, typescript](https://img.shields.io/badge/other%20languages-javascript,%20typescript-457FD5.svg)](../../../requirements.js)
 
@@ -21,7 +21,7 @@ To get started, add this Maven dependency:
 <dependency>
   <groupId>io.github.cowwoc.requirements</groupId>
   <artifactId>requirements-java</artifactId>
-  <version>12.0</version>
+  <version>12.2</version>
 </dependency>
 ```
 
@@ -151,14 +151,14 @@ This library offers the following features:
 Designed for discovery using your favorite IDE's auto-complete feature.
 The main entry points are:
 
-* [requireThat(value, name)](https://cowwoc.github.io/requirements.java/12.0/io.github.cowwoc.requirements.java/com/github/cowwoc/requirements12/java/DefaultJavaValidators.html#requireThat(T,java.lang.String))
+* [requireThat(value, name)](https://cowwoc.github.io/requirements.java/12.2/io.github.cowwoc.requirements.java/com/github/cowwoc/requirements12/java/DefaultJavaValidators.html#requireThat(T,java.lang.String))
   for method preconditions.
-* [that(value, name)](https://cowwoc.github.io/requirements.java/12.0/io.github.cowwoc.requirements.java/com/github/cowwoc/requirements12/java/DefaultJavaValidators.html#that(T,java.lang.String))
+* [that(value, name)](https://cowwoc.github.io/requirements.java/12.2/io.github.cowwoc.requirements.java/com/github/cowwoc/requirements12/java/DefaultJavaValidators.html#that(T,java.lang.String))
   for [class invariants, method postconditions and private methods](docs/features.md#assertion-support).
-* [checkIf(value, name)](https://cowwoc.github.io/requirements.java/12.0/io.github.cowwoc.requirements.java/com/github/cowwoc/requirements12/java/DefaultJavaValidators.html#checkIf(T,java.lang.String))
+* [checkIf(value, name)](https://cowwoc.github.io/requirements.java/12.2/io.github.cowwoc.requirements.java/com/github/cowwoc/requirements12/java/DefaultJavaValidators.html#checkIf(T,java.lang.String))
   for multiple failures and customized error handling.
 
-See the [API documentation](https://cowwoc.github.io/requirements.java/12.0/) for more details.
+See the [API documentation](https://cowwoc.github.io/requirements.java/12.2/) for more details.
 
 ## Best practices
 
diff --git a/annotation/pom.xml b/annotation/pom.xml
@@ -1,10 +1,11 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 	<modelVersion>4.0.0</modelVersion>
 	<parent>
 		<groupId>io.github.cowwoc.requirements</groupId>
 		<artifactId>requirements</artifactId>
-		<version>12.1-SNAPSHOT</version>
+		<version>12.2-SNAPSHOT</version>
 	</parent>
 	<artifactId>requirements-annotation</artifactId>
 	<name>requirements-annotation</name>
diff --git a/benchmark/assertj/pom.xml b/benchmark/assertj/pom.xml
@@ -1,10 +1,11 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 	<modelVersion>4.0.0</modelVersion>
 	<parent>
 		<groupId>io.github.cowwoc.requirements</groupId>
 		<artifactId>requirements-benchmark</artifactId>
-		<version>12.1-SNAPSHOT</version>
+		<version>12.2-SNAPSHOT</version>
 	</parent>
 	<artifactId>requirements-benchmark-assertj</artifactId>
 	<name>requirements-benchmark-assertj</name>
diff --git a/benchmark/guava/pom.xml b/benchmark/guava/pom.xml
@@ -1,10 +1,11 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 	<modelVersion>4.0.0</modelVersion>
 	<parent>
 		<groupId>io.github.cowwoc.requirements</groupId>
 		<artifactId>requirements-benchmark</artifactId>
-		<version>12.1-SNAPSHOT</version>
+		<version>12.2-SNAPSHOT</version>
 	</parent>
 	<artifactId>requirements-benchmark-guava</artifactId>
 	<name>requirements-benchmark-guava</name>
diff --git a/benchmark/java/pom.xml b/benchmark/java/pom.xml
@@ -1,10 +1,11 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 	<modelVersion>4.0.0</modelVersion>
 	<parent>
 		<groupId>io.github.cowwoc.requirements</groupId>
 		<artifactId>requirements-benchmark</artifactId>
-		<version>12.1-SNAPSHOT</version>
+		<version>12.2-SNAPSHOT</version>
 	</parent>
 	<artifactId>requirements-benchmark-java</artifactId>
 	<name>requirements-benchmark-java</name>
diff --git a/benchmark/pom.xml b/benchmark/pom.xml
@@ -5,7 +5,7 @@
 	<parent>
 		<groupId>io.github.cowwoc.requirements</groupId>
 		<artifactId>requirements</artifactId>
-		<version>12.1-SNAPSHOT</version>
+		<version>12.2-SNAPSHOT</version>
 	</parent>
 	<artifactId>requirements-benchmark</artifactId>
 	<name>requirements-benchmark</name>
diff --git a/docs/features.md b/docs/features.md
@@ -174,7 +174,7 @@ requireThat(nameToAge, "nameToAge").
 ## String diff
 
 When
-a [String comparison](https://cowwoc.github.io/requirements.java/12.0/io.github.cowwoc.requirements.java/com/github/cowwoc/requirements12/java/type/component/ObjectValidatorComponent#isEqualTo(java.lang.Object))
+a [String comparison](https://cowwoc.github.io/requirements.java/12.2/io.github.cowwoc.requirements.java/com/github/cowwoc/requirements12/java/type/component/ObjectValidatorComponent#isEqualTo(java.lang.Object))
 fails, the library outputs a diff of the values being compared.
 
 Depending on the terminal capability, you will see a [textual](textual_diff.md) or a [colored](colored_diff.md) diff.
@@ -188,7 +188,7 @@ terminal.
 
 The use of colors is disabled by default if stdin or stdout are redirected, even if ANSI colors are supported.
 To enable colors,
-invoke [GlobalConfiguration.terminalEncoding(TerminalEncoding)](https://cowwoc.github.io/requirements.java/12.0/io.github.cowwoc.requirements.java/com/github/cowwoc/requirements12/java/GlobalConfiguration.html#terminalEncoding(io.github.cowwoc.requirements12.java.TerminalEncoding)).
+invoke [GlobalConfiguration.terminalEncoding(TerminalEncoding)](https://cowwoc.github.io/requirements.java/12.2/io.github.cowwoc.requirements.java/com/github/cowwoc/requirements12/java/GlobalConfiguration.html#terminalEncoding(io.github.cowwoc.requirements12.java.TerminalEncoding)).
 
 ## Returning the value after validation
 
diff --git a/docs/supported_libraries.md b/docs/supported_libraries.md
@@ -1,11 +1,11 @@
 Each module uses a separate class pair for validation. For example, 
-[DefaultJavaValidators](https://cowwoc.github.io/requirements.java/12.0/io.github.cowwoc.requirements.java/com/github/cowwoc/requirements12/java/DefaultJavaValidators.html)
+[DefaultJavaValidators](https://cowwoc.github.io/requirements.java/12.2/io.github.cowwoc.requirements.java/com/github/cowwoc/requirements12/java/DefaultJavaValidators.html)
 and
-[JavaValidators](https://cowwoc.github.io/requirements.java/12.0/io.github.cowwoc.requirements.java/com/github/cowwoc/requirements12/java/JavaValidators.html)
+[JavaValidators](https://cowwoc.github.io/requirements.java/12.2/io.github.cowwoc.requirements.java/com/github/cowwoc/requirements12/java/JavaValidators.html)
 validate the core Java API. Similarly,
-[DefaultGuavaValidators](https://cowwoc.github.io/requirements.java/12.0/io.github.cowwoc.requirements.java/com/github/cowwoc/requirements12/guava/DefaultGuavaValidators.html)
+[DefaultGuavaValidators](https://cowwoc.github.io/requirements.java/12.2/io.github.cowwoc.requirements.java/com/github/cowwoc/requirements12/guava/DefaultGuavaValidators.html)
 and
-[GuavaValidators](https://cowwoc.github.io/requirements.java/12.0/io.github.cowwoc.requirements.java/com/github/cowwoc/requirements12/guava/GuavaValidators.html)
+[GuavaValidators](https://cowwoc.github.io/requirements.java/12.2/io.github.cowwoc.requirements.java/com/github/cowwoc/requirements12/guava/GuavaValidators.html)
 validate the Guava API.
 
 The following table lists validators for third-party libraries: 
diff --git a/guava/pom.xml b/guava/pom.xml
@@ -5,7 +5,7 @@
 	<parent>
 		<groupId>io.github.cowwoc.requirements</groupId>
 		<artifactId>requirements</artifactId>
-		<version>12.1-SNAPSHOT</version>
+		<version>12.2-SNAPSHOT</version>
 	</parent>
 	<artifactId>requirements-guava</artifactId>
 	<name>requirements-guava</name>
diff --git a/jackson/pom.xml b/jackson/pom.xml
@@ -5,7 +5,7 @@
 	<parent>
 		<groupId>io.github.cowwoc.requirements</groupId>
 		<artifactId>requirements</artifactId>
-		<version>12.1-SNAPSHOT</version>
+		<version>12.2-SNAPSHOT</version>
 	</parent>
 	<artifactId>requirements-jackson</artifactId>
 	<name>requirements-jackson</name>
diff --git a/java/pom.xml b/java/pom.xml
@@ -5,7 +5,7 @@
 	<parent>
 		<groupId>io.github.cowwoc.requirements</groupId>
 		<artifactId>requirements</artifactId>
-		<version>12.1-SNAPSHOT</version>
+		<version>12.2-SNAPSHOT</version>
 	</parent>
 	<artifactId>requirements-java</artifactId>
 	<name>requirements-java</name>
diff --git a/java/src/main/java/io/github/cowwoc/requirements12/java/MultipleFailuresException.java b/java/src/main/java/io/github/cowwoc/requirements12/java/MultipleFailuresException.java
@@ -14,7 +14,7 @@ public final class MultipleFailuresException extends RuntimeException
 {
 	@Serial
 	private static final long serialVersionUID = 0L;
-	private transient final List<ValidationFailure> failures;
+	private final transient List<ValidationFailure> failures;
 
 	/**
 	 * Creates a new exception.
diff --git a/java/src/main/java/io/github/cowwoc/requirements12/java/internal/terminal/Processes.java b/java/src/main/java/io/github/cowwoc/requirements12/java/internal/terminal/Processes.java
@@ -8,6 +8,8 @@
 import java.io.IOException;
 import java.io.InputStreamReader;
 
+import static java.nio.charset.StandardCharsets.UTF_8;
+
 /**
  * Process helper functions.
  */
@@ -32,7 +34,7 @@ public static String run(String... command) throws IOException
 		ProcessBuilder pb = new ProcessBuilder(command).redirectErrorStream(true);
 		Process process = pb.start();
 		StringBuilder result = new StringBuilder(80);
-		try (BufferedReader in = new BufferedReader(new InputStreamReader(process.getInputStream())))
+		try (BufferedReader in = new BufferedReader(new InputStreamReader(process.getInputStream(), UTF_8)))
 		{
 			while (true)
 			{
diff --git a/java/src/main/java/io/github/cowwoc/requirements12/java/internal/util/StampedLocks.java b/java/src/main/java/io/github/cowwoc/requirements12/java/internal/util/StampedLocks.java
@@ -123,6 +123,7 @@ public static <V> V write(StampedLock lock, Callable<V> task)
 	 * @throws NullPointerException    if {@code task} is null
 	 * @throws WrappedCheckedException if {@code task} throws a checked exception
 	 */
+	@SuppressWarnings("PMD.AvoidCatchingGenericException")
 	private static void runTask(Runnable task)
 	{
 		try
@@ -144,6 +145,7 @@ private static void runTask(Runnable task)
 	 * @throws NullPointerException    if {@code task} is null
 	 * @throws WrappedCheckedException if {@code task} throws a checked exception
 	 */
+	@SuppressWarnings("PMD.AvoidCatchingGenericException")
 	private static <V> V runTask(Callable<V> task)
 	{
 		try
@@ -200,6 +202,7 @@ public static <V> V getLazilyInitializedValue(StampedLock lock, Supplier<V> supp
 	 * @return the initialized value
 	 * @throws NullPointerException if any of the arguments are null
 	 */
+	@SuppressWarnings("PMD.AvoidCatchingGenericException")
 	private static <V> V getLazilyInitializedValueUsingRead(StampedLock lock, Supplier<V> supplier,
 		Callable<V> initializer)
 	{
diff --git a/java/src/main/java/io/github/cowwoc/requirements12/java/internal/validator/AbstractCollectionValidator.java b/java/src/main/java/io/github/cowwoc/requirements12/java/internal/validator/AbstractCollectionValidator.java
@@ -95,7 +95,7 @@ public S contains(E expected, String name)
 		return containsImpl(expected, name);
 	}
 
-	@SuppressWarnings("PMD.AvoidCatchingNPE")
+	@SuppressWarnings("PMD.AvoidCatchingGenericException")
 	private S containsImpl(E expected, String name)
 	{
 		if (value.validationFailed(v ->
@@ -136,7 +136,7 @@ public S doesNotContain(E unwanted, String name)
 		return doesNotContainImpl(unwanted, name);
 	}
 
-	@SuppressWarnings("PMD.AvoidCatchingNPE")
+	@SuppressWarnings("PMD.AvoidCatchingGenericException")
 	private S doesNotContainImpl(E unwanted, String name)
 	{
 		if (value.validationFailed(v ->
diff --git a/java/src/main/java/io/github/cowwoc/requirements12/java/internal/validator/JavaValidatorsImpl.java b/java/src/main/java/io/github/cowwoc/requirements12/java/internal/validator/JavaValidatorsImpl.java
@@ -65,7 +65,6 @@
 /**
  * The default implementation of JavaValidators.
  */
-@SuppressWarnings("PMD.UnusedPrivateMethod")
 public final class JavaValidatorsImpl extends AbstractValidators<JavaValidators>
 	implements JavaValidators
 {
diff --git a/pom.xml b/pom.xml
diff --git a/test/pom.xml b/test/pom.xml
