Release notes

Version 1.10.0 (2026-07)

New Features / Enhancements

• issue/0050: New method ExceptionMathcher.throwsException(Exception) by @oswaldobapvicjr
• issue/0055: Add Java 25 to the build matrix in maven.yml by @oswaldobapvicjr
• issue/0056: Upgrade junit-jupiter-api to 5.14.2 by @oswaldobapvicjr
• issue/0060: Move release workflow to GHA by @oswaldobapvicjr

Fixed Bugs

• issue/0059: Cache throwable in ExceptionMatcher to avoid executing procedure twice by @lellisls

---

Version 1.9.0 (2025-03)

New Features / Enhancements

• issue/0043: New StringMatcher.containsAllInSequence(String...)

Minor Enhancements

• issue/0042: Upgrade org.junit.jupiter:junit-jupiter-api to 5.11.4

---

Version 1.8.0 (2024-05)

New Features / Enhancements

• issue/0033: New ExceptionMatcher.with(Function, Matcher) to extract and validate custom values

Minor Enhancements

• issue/0032: Upgrade org.junit.jupiter:junit-jupiter-api to 5.10.2

---

Version 1.7.0 (2024-02)

New Features / Enhancements

• issue/0030: Upgrade to JUnit 5
• issue/0031: Upgrade CI/CD setup

---

Version 1.6.1 (2025-02)

New Features / Enhancements / Fixed Bugs

• issue/0039: New ExceptionMatcher.with(Function, Matcher) (cherry-picked from issue/0033)
• issue/0041: Adapt issue/0033 to JUnit 4

---

Version 1.6.0 (2024-01)

New Features / Enhancements

• issue/0028: Nested ExceptionMatcher for enhanced cause validation
• issue/0029: Add support to JDK 21 LTS

---

Version 1.5.0 (2023-06)

New Features / Enhancements

• issue/0026: Allow testing functions that throw checked exceptions

---

Version 1.4.0 (2022-12)

New Features / Enhancements

• issue/0024: New TestUtil methods: assertPositiveNumber() and assertNegativeNumber()
• Add support to JDK 19

---

Version 1.3.1 (2021-08)

Minor Enhancements

• issue/0022: New ExceptionMatcher methods: throwsException() and throwsNoException()
• General Javadoc improvements

---

Version 1.3.0 (2021-02)

New Features / Enhancements

• issue/0020: New number matchers: IsPositive / IsNegative
• General Javadoc improvements

---

Version 1.2.1 (2021-01)

Minor Enhancements

• issue/0016: Combining ExceptionMatcher with InstantiationNotAllowedMatcher
• issue/0018: New AdvancedMatchers class

---

Version 1.2.0 (2020-11)

New Features / Enhancements

• issue/0013: Combining String Matchers with ExceptionMatcher
• issue/0015: Upgrade JUnit dependency from 4.13 to 4.13.1

---

Version 1.1.1 (2020-08)

Fixed Bugs

• issue/0009: ExceptionMatcher fix to allow matching subclasses of expected exception or cause

Minor Enhancements

• issue/0007: StringMatcher Javadoc examples included
• issue/0008: StringMatcher enhancement to accept any CharSequence (e.g., StringBuilder, StringBuffer)

---

Version 1.1.0 (2020-06)

New Features / Enhancements

• New matchers for use with org.hamcrest.MatcherAssert:
  • ExceptionMatcher: Matches if a procedure throws an expected exception, message, or cause
  • InstantiationNotAllowedMatcher: Matches if a class cannot be instantiated
  • StringMatcher: Evaluates string contents by matching substrings
• Documentation improvements

---

Version 1.0.0 (2020-04)

Initial Release

Includes TestUtils, a static class with assertions:

• Methods to assert expected exceptions and details (message, cause)
• Methods to ensure a class cannot be instantiated (useful for utility classes)
• Methods for string assertions

---

For more information or suggestions for improvement, visit: https://obvj.net/junit-utils