mockito/mockito (org.mockito:mockito-core)
### [`v5.5.0`](https://togithub.com/mockito/mockito/releases/tag/v5.5.0)
[Compare Source](https://togithub.com/mockito/mockito/compare/v5.4.0...v5.5.0)
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 5.5.0
- 2023-08-22 - [25 commit(s)](https://togithub.com/mockito/mockito/compare/v5.4.0...v5.5.0) by Andreas Turban, Chris Egerton, Róbert Papp, Thach Le, dependabot\[bot]
- Bump org.gradle.toolchains.foojay-resolver-convention from 0.6.0 to 0.7.0 [(#3096)](https://togithub.com/mockito/mockito/pull/3096)
- Excessive locking in TypeCachingBytecodeGenerator#BOOTSTRAP_LOCK [(#3095)](https://togithub.com/mockito/mockito/pull/3095)
- Bump versions.bytebuddy from 1.14.5 to 1.14.6 [(#3094)](https://togithub.com/mockito/mockito/pull/3094)
- Fixes 3087 : Add note on backporting to README [(#3090)](https://togithub.com/mockito/mockito/pull/3090)
- Backporting policy [(#3087)](https://togithub.com/mockito/mockito/issues/3087)
- Bump versions.errorprone from 2.21.0 to 2.21.1 [(#3083)](https://togithub.com/mockito/mockito/pull/3083)
- Fixes [#3077](https://togithub.com/mockito/mockito/issues/3077) : Report unused stubbing exceptions when test filter is no-op [(#3078)](https://togithub.com/mockito/mockito/pull/3078)
- Unused stubbings are not reported when filters are used [(#3077)](https://togithub.com/mockito/mockito/issues/3077)
- Bump versions.errorprone from 2.20.0 to 2.21.0 [(#3076)](https://togithub.com/mockito/mockito/pull/3076)
- Bump com.gradle.enterprise from 3.14 to 3.14.1 [(#3074)](https://togithub.com/mockito/mockito/pull/3074)
- Bump org.opentest4j:opentest4j from 1.2.0 to 1.3.0 [(#3072)](https://togithub.com/mockito/mockito/pull/3072)
- Bump versions.junitJupiter from 5.9.3 to 5.10.0 [(#3071)](https://togithub.com/mockito/mockito/pull/3071)
- Bump org.junit.platform:junit-platform-launcher from 1.9.3 to 1.10.0 [(#3070)](https://togithub.com/mockito/mockito/pull/3070)
- Bump gradle/wrapper-validation-action from 1.0.6 to 1.1.0 [(#3069)](https://togithub.com/mockito/mockito/pull/3069)
- Gradle 8.3 compatibility: buildDir -> layout.buildDirectory [(#3068)](https://togithub.com/mockito/mockito/pull/3068)
- Bump com.gradle.enterprise from 3.13.4 to 3.14 [(#3067)](https://togithub.com/mockito/mockito/pull/3067)
- Bump com.diffplug.spotless from 6.19.0 to 6.20.0 [(#3066)](https://togithub.com/mockito/mockito/pull/3066)
- Toolchain for Test task [(#3064)](https://togithub.com/mockito/mockito/pull/3064)
- Gradle build script improvements [(#3062)](https://togithub.com/mockito/mockito/pull/3062)
- Fixes [#3046](https://togithub.com/mockito/mockito/issues/3046) [(#3060)](https://togithub.com/mockito/mockito/pull/3060)
- Fix Gradle 8.2 deprecation of Conventions in nexus plugin. [(#3056)](https://togithub.com/mockito/mockito/pull/3056)
- Bump kotlinVersion from 1.8.22 to 1.9.0 [(#3055)](https://togithub.com/mockito/mockito/pull/3055)
- Bump ru.vyarus.animalsniffer from 1.7.0 to 1.7.1 [(#3054)](https://togithub.com/mockito/mockito/pull/3054)
- Gradle 8.2: work around fix for release publishing [(#3053)](https://togithub.com/mockito/mockito/pull/3053)
- Rewire Jacoco for Gradle 8/9 [(#3052)](https://togithub.com/mockito/mockito/pull/3052)
- Gradle 7.6 to 8.2 (conventions to extensions migration, mostly) [(#3051)](https://togithub.com/mockito/mockito/pull/3051)
- Bump org.codehaus.groovy:groovy from 3.0.17 to 3.0.18 [(#3049)](https://togithub.com/mockito/mockito/pull/3049)
- Mockito#reset Condescending Documentation [(#3046)](https://togithub.com/mockito/mockito/issues/3046)
- Excessive locking in TypeCachingBytecodeGenerator#BOOTSTRAP_LOCK [(#3035)](https://togithub.com/mockito/mockito/issues/3035)
### [`v5.4.0`](https://togithub.com/mockito/mockito/releases/tag/v5.4.0)
[Compare Source](https://togithub.com/mockito/mockito/compare/v5.3.1...v5.4.0)
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 5.4.0
- 2023-06-18 - [22 commit(s)](https://togithub.com/mockito/mockito/compare/v5.3.1...v5.4.0) by Alexander von Trostorff, Andriy Redko, Benoit Maggi, Chris Povirk, DerFrZocker, Nicolas Ot, Tim van der Lippe, dependabot\[bot], ellaella12
- Bump versions.errorprone from 2.19.1 to 2.20.0 [(#3041)](https://togithub.com/mockito/mockito/pull/3041)
- Bump org.eclipse.platform:org.eclipse.osgi from 3.18.300 to 3.18.400 [(#3038)](https://togithub.com/mockito/mockito/pull/3038)
- Bump com.google.auto.service:auto-service from 1.1.0 to 1.1.1 [(#3036)](https://togithub.com/mockito/mockito/pull/3036)
- Bump com.github.ben-manes.versions from 0.46.0 to 0.47.0 [(#3034)](https://togithub.com/mockito/mockito/pull/3034)
- Bump kotlinVersion from 1.8.21 to 1.8.22 [(#3033)](https://togithub.com/mockito/mockito/pull/3033)
- Documentation about MockMakers slightly outdated in some places. Fixes [#3031](https://togithub.com/mockito/mockito/issues/3031) [(#3032)](https://togithub.com/mockito/mockito/pull/3032)
- Documentation about MockMakers slightly outdated in some places [(#3031)](https://togithub.com/mockito/mockito/issues/3031)
- Bump versions.bytebuddy from 1.14.4 to 1.14.5 [(#3025)](https://togithub.com/mockito/mockito/pull/3025)
- Edit DoAnswerStyleStubbing.isSet() to return true if there are answers [(#3020)](https://togithub.com/mockito/mockito/pull/3020)
- Bump com.diffplug.spotless from 6.18.0 to 6.19.0 [(#3018)](https://togithub.com/mockito/mockito/pull/3018)
- Bump com.google.auto.service:auto-service from 1.0.1 to 1.1.0 [(#3017)](https://togithub.com/mockito/mockito/pull/3017)
- Bump versions.errorprone from 2.18.0 to 2.19.1 [(#3009)](https://togithub.com/mockito/mockito/pull/3009)
- Fix `@Mock(serializable = true)` for parameterized types. [(#3007)](https://togithub.com/mockito/mockito/pull/3007)
- Add varargs changes to `ArgumentMatchers#any()` JavaDoc
[(#3003)](https://togithub.com/mockito/mockito/pull/3003)
- Mockito 5 any() does not match a vararg int\[] argument anymore. I need to use any(int\[].class) to get the ArgumentMatcher to work [(#2998)](https://togithub.com/mockito/mockito/issues/2998)
- Bump com.google.googlejavaformat:google-java-format from 1.16.0 to 1.17.0 [(#2996)](https://togithub.com/mockito/mockito/pull/2996)
- Remove redundant double "now" in JavaDocs for mock without class [(#2994)](https://togithub.com/mockito/mockito/pull/2994)
- Bump org.junit.platform:junit-platform-launcher from 1.9.2 to 1.9.3 [(#2993)](https://togithub.com/mockito/mockito/pull/2993)
- Bump versions.junitJupiter from 5.9.2 to 5.9.3 [(#2992)](https://togithub.com/mockito/mockito/pull/2992)
- Provide a variant of assertArg that works well with checked exceptions [(#2991)](https://togithub.com/mockito/mockito/pull/2991)
- Bump kotlinVersion from 1.8.10 to 1.8.21 [(#2990)](https://togithub.com/mockito/mockito/pull/2990)
- Fix [#2915](https://togithub.com/mockito/mockito/issues/2915) Forbid spy on mocked interface [(#2989)](https://togithub.com/mockito/mockito/pull/2989)
- Bump net.ltgt.gradle:gradle-errorprone-plugin from 3.0.1 to 3.1.0 [(#2987)](https://togithub.com/mockito/mockito/pull/2987)
- `@Mock(serializable = true)` no longer works with parameterized types [(#2979)](https://togithub.com/mockito/mockito/issues/2979)
- Bug with [@InjectMocks](https://togithub.com/InjectMocks) in 5.3.0 [(#2978)](https://togithub.com/mockito/mockito/issues/2978)
- Function name is incorrect. [(#2955)](https://togithub.com/mockito/mockito/issues/2955)
- Verify on Spy Interface incorrect count of actual invocation [(#2915)](https://togithub.com/mockito/mockito/issues/2915)
- Only run injection once [(#2603)](https://togithub.com/mockito/mockito/pull/2603)
- mockito-core MockitoAnnotations::openMocks initializes class twice if said class has super class [(#2602)](https://togithub.com/mockito/mockito/issues/2602)
### [`v5.3.1`](https://togithub.com/mockito/mockito/releases/tag/v5.3.1)
[Compare Source](https://togithub.com/mockito/mockito/compare/v5.3.0...v5.3.1)
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 5.3.1
- 2023-04-21 - [2 commit(s)](https://togithub.com/mockito/mockito/compare/v5.3.0...v5.3.1) by Rafael Winterhalter, jfrantzius
- Fixes 2972: Weakens visibility constraint [(#2983)](https://togithub.com/mockito/mockito/pull/2983)
- Bugfix 2974 fix npe [(#2976)](https://togithub.com/mockito/mockito/pull/2976)
- Fix for [#2958](https://togithub.com/mockito/mockito/issues/2958) eliminates CCE but leads to NPE [(#2974)](https://togithub.com/mockito/mockito/issues/2974)
- Spying objects not working properly since 5.3.0 [(#2972)](https://togithub.com/mockito/mockito/issues/2972)
### [`v5.3.0`](https://togithub.com/mockito/mockito/releases/tag/v5.3.0)
[Compare Source](https://togithub.com/mockito/mockito/compare/v5.2.0...v5.3.0)
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 5.3.0
- 2023-04-11 - [14 commit(s)](https://togithub.com/mockito/mockito/compare/v5.2.0...v5.3.0) by Krzysztof Krasoń, Maciej Walkowiak, Rafael Winterhalter, Wesley Tsai, dependabot\[bot], jfrantzius
- Bump com.diffplug.spotless from 6.17.0 to 6.18.0 [(#2967)](https://togithub.com/mockito/mockito/pull/2967)
- Bump versions.bytebuddy from 1.14.3 to 1.14.4 [(#2966)](https://togithub.com/mockito/mockito/pull/2966)
- Adds `withoutAnnotations` parameter to `@Mock` [(#2965)](https://togithub.com/mockito/mockito/pull/2965)
- Fix ClassCastException [(#2962)](https://togithub.com/mockito/mockito/pull/2962)
- Bump org.codehaus.groovy:groovy from 3.0.16 to 3.0.17 [(#2959)](https://togithub.com/mockito/mockito/pull/2959)
- ClassCastException when combining InjectMocks with generified Mock field [(#2958)](https://togithub.com/mockito/mockito/issues/2958)
- Bump versions.bytebuddy from 1.14.2 to 1.14.3 [(#2950)](https://togithub.com/mockito/mockito/pull/2950)
- Add `ArgumentMatchers#assertArg` method. [(#2949)](https://togithub.com/mockito/mockito/pull/2949)
- Fixes 2947: correct visibility check to respect nestmates [(#2948)](https://togithub.com/mockito/mockito/pull/2948)
- spy does not initialize objects fully with InstrumentationMemberAccessor [(#2947)](https://togithub.com/mockito/mockito/issues/2947)
- Fixes [#2877](https://togithub.com/mockito/mockito/issues/2877): removed mockito-inline as subproject and actual subproject [(#2945)](https://togithub.com/mockito/mockito/pull/2945)
- [#2934](https://togithub.com/mockito/mockito/issues/2934) throw exception on multiple matches by type if cannot be reduce… [(#2942)](https://togithub.com/mockito/mockito/pull/2942)
- Bump org.eclipse.platform:org.eclipse.osgi from 3.18.200 to 3.18.300 [(#2941)](https://togithub.com/mockito/mockito/pull/2941)
- Bump com.diffplug.spotless from 6.16.0 to 6.17.0 [(#2940)](https://togithub.com/mockito/mockito/pull/2940)
- Bump org.codehaus.groovy:groovy from 3.0.15 to 3.0.16 [(#2939)](https://togithub.com/mockito/mockito/pull/2939)
- Bump versions.bytebuddy from 1.14.1 to 1.14.2 [(#2938)](https://togithub.com/mockito/mockito/pull/2938)
- Feature suggestion: TerminalMockCandidateFilter should report error when more than one candidate left [(#2934)](https://togithub.com/mockito/mockito/issues/2934)
- Mockito-inline dependency after upgrade 5.0.0 [(#2877)](https://togithub.com/mockito/mockito/issues/2877)
- Assertions on parameters during verification [(#2285)](https://togithub.com/mockito/mockito/issues/2285)
### [`v5.2.0`](https://togithub.com/mockito/mockito/releases/tag/v5.2.0)
[Compare Source](https://togithub.com/mockito/mockito/compare/v5.1.1...v5.2.0)
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 5.2.0
- 2023-03-09 - [25 commit(s)](https://togithub.com/mockito/mockito/compare/v5.1.1...v5.2.0) by Andriy Redko, Iulian Dragos, Roberto Trunfio, Róbert Papp, dependabot\[bot], jfrantzius, tobiasbaum
- Fixes 2933: IOUtils does not depend on platform encoding any more [(#2935)](https://togithub.com/mockito/mockito/pull/2935)
- Execution with mockito-inline fails on platforms with EBCDIC as default encoding [(#2933)](https://togithub.com/mockito/mockito/issues/2933)
- Bump io.github.gradle-nexus:publish-plugin from 1.2.0 to 1.3.0 [(#2932)](https://togithub.com/mockito/mockito/pull/2932)
- Bump versions.bytebuddy from 1.14.0 to 1.14.1 [(#2931)](https://togithub.com/mockito/mockito/pull/2931)
- Bump com.diffplug.spotless from 6.15.0 to 6.16.0 [(#2930)](https://togithub.com/mockito/mockito/pull/2930)
- Bump com.google.googlejavaformat:google-java-format from 1.15.0 to 1.16.0 [(#2928)](https://togithub.com/mockito/mockito/pull/2928)
- Bump io.github.gradle-nexus:publish-plugin from 1.1.0 to 1.2.0 [(#2924)](https://togithub.com/mockito/mockito/pull/2924)
- Feature 2921 generic types [(#2923)](https://togithub.com/mockito/mockito/pull/2923)
- Bump com.github.ben-manes.versions from 0.45.0 to 0.46.0 [(#2922)](https://togithub.com/mockito/mockito/pull/2922)
- Use generic type information in TypeBasedCandidateFilter to circumvent type erasure [(#2921)](https://togithub.com/mockito/mockito/issues/2921)
- Make project relocatable by using relative paths in the OSGi test task [(#2920)](https://togithub.com/mockito/mockito/pull/2920)
- Cache misses due to OSGi tests referencing absolute paths [(#2919)](https://togithub.com/mockito/mockito/issues/2919)
- Bump versions.bytebuddy from 1.13.0 to 1.14.0 [(#2918)](https://togithub.com/mockito/mockito/pull/2918)
- Bump gradle/wrapper-validation-action from 1.0.5 to 1.0.6 [(#2917)](https://togithub.com/mockito/mockito/pull/2917)
- Bump com.diffplug.spotless from 6.14.1 to 6.15.0 [(#2913)](https://togithub.com/mockito/mockito/pull/2913)
- Bump versions.bytebuddy from 1.12.23 to 1.13.0 [(#2912)](https://togithub.com/mockito/mockito/pull/2912)
- Bump ru.vyarus.animalsniffer from 1.6.0 to 1.7.0 [(#2911)](https://togithub.com/mockito/mockito/pull/2911)
- Bump org.codehaus.groovy:groovy from 3.0.14 to 3.0.15 [(#2910)](https://togithub.com/mockito/mockito/pull/2910)
- Fixes [#2905](https://togithub.com/mockito/mockito/issues/2905) : ThreadLocal classes can be mocked. [(#2908)](https://togithub.com/mockito/mockito/pull/2908)
- StackOverflow while mocking a ThreadLocal on Mockito 5.1.1 [(#2905)](https://togithub.com/mockito/mockito/issues/2905)
- Fix most Gradle warnings in build [(#2904)](https://togithub.com/mockito/mockito/pull/2904)
- Android CI improvements, improves [#2892](https://togithub.com/mockito/mockito/issues/2892) [(#2903)](https://togithub.com/mockito/mockito/pull/2903)
- Bump com.diffplug.spotless from 6.14.0 to 6.14.1 [(#2902)](https://togithub.com/mockito/mockito/pull/2902)
- Bump versions.bytebuddy from 1.12.22 to 1.12.23 [(#2901)](https://togithub.com/mockito/mockito/pull/2901)
- CI on Android API level 33 for Java 11 compatibility testing [(#2899)](https://togithub.com/mockito/mockito/pull/2899)
- Bump kotlinVersion from 1.8.0 to 1.8.10 [(#2897)](https://togithub.com/mockito/mockito/pull/2897)
- Bump com.github.ben-manes.versions from 0.44.0 to 0.45.0 [(#2895)](https://togithub.com/mockito/mockito/pull/2895)
- Simplify and modernize Android Test module. [(#2894)](https://togithub.com/mockito/mockito/pull/2894)
- Set up Android Github Action pipeline. Fixes [#2892](https://togithub.com/mockito/mockito/issues/2892) [(#2893)](https://togithub.com/mockito/mockito/pull/2893)
### [`v5.1.1`](https://togithub.com/mockito/mockito/releases/tag/v5.1.1)
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 5.1.1
- 2023-01-30 - [1 commit(s)](https://togithub.com/mockito/mockito/compare/v5.1.0...v5.1.1) by Andriy Redko
- StackWalker.Option not found on Mockito 5.1.0 [(#2891)](https://togithub.com/mockito/mockito/pull/2891)
- StackWalker.Option not found on Mockito 5.1.0 [(#2890)](https://togithub.com/mockito/mockito/issues/2890)
### [`v5.1.0`](https://togithub.com/mockito/mockito/releases/tag/v5.1.0)
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 5.1.0
- 2023-01-29 - [12 commit(s)](https://togithub.com/mockito/mockito/compare/v5.0.0...v5.1.0) by Andriy Redko, Ashley, Róbert Papp, Stephan Schroevers, Tim te Beek, dependabot\[bot]
- Fixes some mistakes and missing details in documentation [(#2889)](https://togithub.com/mockito/mockito/pull/2889)
- Bump com.diffplug.spotless from 6.13.0 to 6.14.0 [(#2888)](https://togithub.com/mockito/mockito/pull/2888)
- Clean up JDK-8 related code [(#2883)](https://togithub.com/mockito/mockito/pull/2883)
- Feat: reified mock overloads [(#2882)](https://togithub.com/mockito/mockito/pull/2882)
- Clean up JDK-8 related code [(#2879)](https://togithub.com/mockito/mockito/issues/2879)
- Bump assertj-core from 3.24.1 to 3.24.2 [(#2875)](https://togithub.com/mockito/mockito/pull/2875)
- Make sure the tests use mock maker with intended member accessor [(#2872)](https://togithub.com/mockito/mockito/pull/2872)
- Bump com.diffplug.spotless from 6.12.1 to 6.13.0 [(#2871)](https://togithub.com/mockito/mockito/pull/2871)
- Remove broken link from `CONTRIBUTING.md` [(#2870)](https://togithub.com/mockito/mockito/pull/2870)
- Update outdated badge 3.x to 5.x [(#2869)](https://togithub.com/mockito/mockito/pull/2869)
- Broken link in `CONTRIBUTING.md` [(#2868)](https://togithub.com/mockito/mockito/issues/2868)
- Set current version to 5.x in README and highlight changes [(#2867)](https://togithub.com/mockito/mockito/pull/2867)
- Annotate `Mockito#{mock,spy}(T... reified)` with `@SafeVarargs` [(#2866)](https://togithub.com/mockito/mockito/pull/2866)
- Make sure the tests use mock maker with intended member accessor [(#2855)](https://togithub.com/mockito/mockito/issues/2855)
- Improve examples for InOrder [(#2843)](https://togithub.com/mockito/mockito/pull/2843)
### [`v5.0.0`](https://togithub.com/mockito/mockito/releases/tag/v5.0.0)
### Mockito 5: prepare for future JDK versions
For a while now, we have seen an increase in problems/incompatibilities with recent versions of the JDK due to our usage of JVM-internal API.
Most notably, JDK 17 made some changes which are incompatible with the current subclass mockmaker.
Therefore, to prepare for the future of JDK, we are making some core changes to ensure Mockito keeps on working.
#### Switch the default mockmaker to `mockito-inline`
Back in Mockito 2.7.6, we published a new mockmaker based on the "inline bytecode" principle.
This mockmaker creates mocks manipulating bytecode equivalent within the original class such that its method implementations hook into the normal Mockito machinery.
As a comparison, the subclass mockmaker generates "real" subclasses for mocks, to mimic the same behavior.
While the approaches are similar, the inline mockmaker avoids certain restrictions that the JDK imposes.
For example, it does not violate module boundaries (introduced in JDK 9, but more heavily used in JDK 17) and avoids the leaking of the creation of the subclass.
Massive thanks to community member [@reta](https://togithub.com/reta) who implemented this change.
Note: this does not affect `mockito-android` nor testing on Android.
##### When should I still be using the subclass mockmaker?
There are legitimate remaining use cases for the subclass mockmaker.
For example, on the Graal VM's native image, the inline mockmaker will not work and the subclass mockmaker is the appropriate choice.
Additionally, if you would like to avoid mocking final classes, using the subclass mockmaker is a possibibility.
Note however that if you solely want to use the subclass mockmaker to avoid mocking final, you will run into the above mentioned issues on JDK 17+.
We want to leave this choice up to our users, which is why we will keep on supporting the subclass mockmaker.
If you want to use the subclass mockmaker instead, you can use the new `mockito-subclass` artifact (published [on Maven Central](https://search.maven.org/artifact/org.mockito/mockito-subclass) along with all our other artifacts).
#### Update the minimum supported Java version to 11
Mockito 4 supports Java 8 and above.
Similar to other open source projects, we are moving away from JDK 8 and to newer versions.
The primary reason for moving away from JDK 8 is the increasing maintenance costs with keeping our own infrastructure working.
Lately we have been running into more and more JDK 8 breakages.
Additionally, while we want to support the newest JDK API's, our current solution to support both JDK 8 and newer versions causes [issues with the `SecurityManager`](https://togithub.com/mockito/mockito/issues/2798).
Since we want Mockito to work on the newest version and more and more businesses adopting JDK 11, we have decided to make the switch as well.
Massive thanks to community member [@reta](https://togithub.com/reta) who implemented this change.
##### What should I do if I still run JDK 8?
For JDK 8 and below, you can keep on using Mockito 4.
This is similar to if you are using JDK 6, for which you can keep on using Mockito 2.
The changes in Mockito 5 (for now) are primarily focused on the latest JDK versions, which means the API differences between Mockito 4 and 5 are minimal.
However, over time this will most likely widen, so we do recommend adopting JDK 11 in the future.
#### New `type()` method on `ArgumentMatcher`
One of our most used public API's for customizing Mockito is the [`ArgumentMatcher` interface](https://javadoc.io/doc/org.mockito/mockito-core/latest/org/mockito/ArgumentMatcher.html).
The interface allows you to define a custom matcher, which you can pass into method arguments to provide more targeted matches.
One major shortcoming of the `ArgumentMatcher` was the lack of varargs support.
There were many, many issues filed related to varargs and Mockito unable to handle them.
Community member [@big-andy-coates](https://togithub.com/big-andy-coates) put in a lot of effort to come up with an appropriate solution, including fully implementing and comparing 2 approaches.
Ultimately, we decided that introducing a new `type()` method on `ArgumentMatcher` is the best solution.
As a result, it is now possible to update your custom matchers to implement varargs support, if you so desire.
Note that `ArgumentMatcher` is still a `@FunctionalInterface` and can therefore still be written as a lambda.
Massive thanks to community member [@big-andy-coates](https://togithub.com/big-andy-coates) who implemented this change.
##### What is the effect of this new method?
For varargs methods, there was previously a way to only match zero arguments, or two or more arguments, by using the exact number of matchers, i.e.
```java
long call(String... args);
// Will match calls with exactly zero arguments:
when(mock.call()).thenReturn(0L);
// Will match calls with exactly two arguments:
when(mock.call(any(), any())).thenReturn(0L);
```
But following the pattern to match exactly one argument:
```java
when(mock.call(any())).thenReturn(0L);
```
doesn't work, as `any` is "vararg aware", so Mockito matched the `any` against *each element* of the varargs parameter, meaning it will match any number of arguments, i.e. the above would of matched all of these:
```java
mock.call();
mock.call("a");
mock.call("a", "b");
```
With the new `type` method, it's now possible to differentiate matching calls with any exact number of arguments, or to match any number of arguments.
```java
// Match any number of arguments:
when(mock.call(any(String[].class))).thenReturn(1L);
// Match invocations with no arguments:
when(mock.call()).thenReturn(1L);
// Match invocations with exactly one argument:
when(mock.call(any())).thenReturn(1L);
// Alternative to match invocations with exactly one argument:
when(mock.call(any(String.class))).thenReturn(1L);
// Match invocations with exactly two arguments:
when(mock.call(any(), any())).thenReturn(1L);
```
Therefore, if you want to match 0 or more arguments, use `any(String[].class)`.
If you want to match an exact number of arguments, use `any(String.class)` (and specify as many `any` matchers as arguments you want to match on).
In a similar fashion, the behavior of `ArgumentCaptor.forClass` has changed as well.
If you want to capture all arguments, use an `ArgumentCaptor` for `String[]`, otherwise `String`:
```java
// Will capture 1 string
@Captor private ArgumentCaptor captor;
// Will capture all strings
@Captor private ArgumentCaptor captor;
```
For more information, see the description and conversation in [pull request 2835](https://togithub.com/mockito/mockito/pull/2835) and [pull request 2807](https://togithub.com/mockito/mockito/pull/2807).
At the same time, `ArgumentCaptor` is now fully type-aware.
This allows for capturing specific subclasses on a generic method:
```java
// Given:
int simpleMethod(Collection> arg);
// When:
mock.simpleMethod(Set.of());
mock.simpleMethod(List.of());
// Then:
ArgumentCaptor> captor = ArgumentCaptor.forClass(List.class);
verify(mock).simpleMethod(captor.capture());
assertThat(captor.getAllValues()).containsExactly(List.of());
```
##### Do I need to implement this new method?
No, you don't need to.
Mockito 5 declares a default implementation, returning `Void.type` as the type of an `ArgumentMatcher`.
This essentially means that Mockito will not consider the type when handling varargs.
However, if you do return a specific type, Mockito will consider this when matching arguments.
As a result, this new method is not a source-breaking change, but is a bytecode-breaking change.
All code working on Mockito 4 should work as-is when recompiled with Mockito 5.
### [`v4.11.0`](https://togithub.com/mockito/mockito/releases/tag/v4.11.0)
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 4.11.0
- 2022-12-28 - [1 commit(s)](https://togithub.com/mockito/mockito/compare/v4.10.0...v4.11.0) by Andy Coates
- Improve vararg handling: approach 2 [(#2807)](https://togithub.com/mockito/mockito/pull/2807)
- Mocking varargs method with `any(String[].class)` doesn't work as expected [(#2796)](https://togithub.com/mockito/mockito/issues/2796)
- (Argument)Matchers regression from 1.10.19 to 2.18.3 for varargs [(#1498)](https://togithub.com/mockito/mockito/issues/1498)
- Cannot verify varargs parameter as an array [(#1222)](https://togithub.com/mockito/mockito/issues/1222)
- ArgumentCaptor can't capture varargs-arrays [(#584)](https://togithub.com/mockito/mockito/issues/584)
- Verification of an empty varargs call fails when isNotNull() is used [(#567)](https://togithub.com/mockito/mockito/issues/567)
### [`v4.10.0`](https://togithub.com/mockito/mockito/releases/tag/v4.10.0)
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 4.10.0
- 2022-12-14 - [13 commit(s)](https://togithub.com/mockito/mockito/compare/v4.9.0...v4.10.0) by Andrei Solntsev, Andriy Redko, Andy Coates, Christopher Lambert, Marcono1234, Vladimir Glinskikh, dependabot\[bot]
- Add new artifact mockito-subclass (to use mock-maker-subclass MockMaker) [(#2821)](https://togithub.com/mockito/mockito/pull/2821)
- Bump gradle from 7.5.1 to 7.6 [(#2817)](https://togithub.com/mockito/mockito/pull/2817)
- Fix incorrect Javadoc inline tag for MockitoJUnitRunner [(#2816)](https://togithub.com/mockito/mockito/pull/2816)
- Bump shipkit-auto-version from 1.2.1 to 1.2.2 [(#2811)](https://togithub.com/mockito/mockito/pull/2811)
- Bump com.github.ben-manes.versions from 0.42.0 to 0.44.0 [(#2810)](https://togithub.com/mockito/mockito/pull/2810)
- Bump kotlinVersion from 1.7.21 to 1.7.22 [(#2809)](https://togithub.com/mockito/mockito/pull/2809)
- Bump junit from 1.1.3 to 1.1.4 [(#2806)](https://togithub.com/mockito/mockito/pull/2806)
- Simplify `MatcherApplicationStrategy` [(#2803)](https://togithub.com/mockito/mockito/pull/2803)
- Bump kotlinVersion from 1.7.10 to 1.7.21 [(#2801)](https://togithub.com/mockito/mockito/pull/2801)
- Bump espresso-core from 3.4.0 to 3.5.0 [(#2800)](https://togithub.com/mockito/mockito/pull/2800)
- Bump versions.bytebuddy from 1.12.16 to 1.12.19 [(#2799)](https://togithub.com/mockito/mockito/pull/2799)
- Upgrade errorprone from 2.14.0 to 2.16 [(#2794)](https://togithub.com/mockito/mockito/pull/2794)
- automatically detect class to mock [(#2779)](https://togithub.com/mockito/mockito/pull/2779)
### [`v4.9.0`](https://togithub.com/mockito/mockito/releases/tag/v4.9.0)
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 4.9.0
- 2022-11-14 - [6 commit(s)](https://togithub.com/mockito/mockito/compare/v4.8.1...v4.9.0) by Andrei Solntsev, Rafael Winterhalter, Rick Ossendrijver, dependabot\[bot]
- Upgrade objenesis 3.2 -> 3.3 [(#2784)](https://togithub.com/mockito/mockito/pull/2784)
- Upgrade objenesis 3.2 -> 3.3 [(#2783)](https://togithub.com/mockito/mockito/issues/2783)
- Avoids clearing stale weak entries from critical code segments. [(#2780)](https://togithub.com/mockito/mockito/pull/2780)
- bump gradle from 7.3.1 to 7.5.1 [(#2776)](https://togithub.com/mockito/mockito/pull/2776)
- Bump gradle/wrapper-validation-action from 1.0.4 to 1.0.5 [(#2775)](https://togithub.com/mockito/mockito/pull/2775)
- Bump gradle-errorprone-plugin from 2.0.2 to 3.0.1 [(#2770)](https://togithub.com/mockito/mockito/pull/2770)
- Bump junit-platform-launcher from 1.9.0 to 1.9.1 [(#2768)](https://togithub.com/mockito/mockito/pull/2768)
### [`v4.8.1`](https://togithub.com/mockito/mockito/releases/tag/v4.8.1)
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 4.8.1
- 2022-10-17 - [6 commit(s)](https://togithub.com/mockito/mockito/compare/v4.8.0...v4.8.1) by andrepaschoal, dependabot\[bot]
- Possible fix [#2765](https://togithub.com/mockito/mockito/issues/2765): Add task to download package-list file from java as element-list [(#2766)](https://togithub.com/mockito/mockito/pull/2766)
- JavaDoc warning is blocking all pull requests [(#2765)](https://togithub.com/mockito/mockito/issues/2765)
- Bump versions.junitJupiter from 5.9.0 to 5.9.1 [(#2758)](https://togithub.com/mockito/mockito/pull/2758)
- Bump groovy from 3.0.12 to 3.0.13 [(#2756)](https://togithub.com/mockito/mockito/pull/2756)
- Bump com.diffplug.spotless from 6.10.0 to 6.11.0 [(#2753)](https://togithub.com/mockito/mockito/pull/2753)
- Bump org.eclipse.osgi from 3.18.0 to 3.18.100 [(#2751)](https://togithub.com/mockito/mockito/pull/2751)
- Bump versions.bytebuddy from 1.12.14 to 1.12.16 [(#2747)](https://togithub.com/mockito/mockito/pull/2747)
### [`v4.8.0`](https://togithub.com/mockito/mockito/releases/tag/v4.8.0)
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 4.8.0
- 2022-09-07 - [10 commit(s)](https://togithub.com/mockito/mockito/compare/v4.7.0...v4.8.0) by Alex, James Baker, Johannes Spangenberg, Kurt Alfred Kluever, Rafael Winterhalter, Thibault Helsmoortel, dependabot\[bot]
- GitHub Workflows security hardening [(#2744)](https://togithub.com/mockito/mockito/pull/2744)
- Assign GlobalConfiguration initializer to unused variable [(#2742)](https://togithub.com/mockito/mockito/pull/2742)
- Bump com.diffplug.spotless from 6.9.1 to 6.10.0 [(#2738)](https://togithub.com/mockito/mockito/pull/2738)
- Drop varargs collector before invoking a user method. [(#2736)](https://togithub.com/mockito/mockito/pull/2736)
- Bump versions.bytebuddy from 1.12.13 to 1.12.14 [(#2734)](https://togithub.com/mockito/mockito/pull/2734)
- Remove useless thrown exception from constructor [(#2732)](https://togithub.com/mockito/mockito/pull/2732)
- TypeSafeMatching no longer iterates over class methods inefficiently [(#2729)](https://togithub.com/mockito/mockito/pull/2729)
- Fixes [#2720](https://togithub.com/mockito/mockito/issues/2720): Use StackWalker on Java 9+ to create Locations [(#2723)](https://togithub.com/mockito/mockito/pull/2723)
- LocationImpl adds performance overheads due to instantiating a stack trace [(#2720)](https://togithub.com/mockito/mockito/issues/2720)
- Fixes [#2626](https://togithub.com/mockito/mockito/issues/2626) : Introduce MockSettings.mockMaker [(#2701)](https://togithub.com/mockito/mockito/pull/2701)
- Introduce option to disable inline-mock-maker for a specific instance [(#2626)](https://togithub.com/mockito/mockito/issues/2626)
### [`v4.7.0`](https://togithub.com/mockito/mockito/releases/tag/v4.7.0)
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 4.7.0
- 2022-08-13 - [33 commit(s)](https://togithub.com/mockito/mockito/compare/v4.6.1...v4.7.0) by [`1988123`](https://togithub.com/mockito/mockito/commit/198812345678), Andy Coates, Chen Ni, Marius Lichtblau, Nikita Koselev. Developer Advocate, Open Source Ally, Rafael Winterhalter, dependabot\[bot], dstango, fishautumn, heqiang
- Bump com.diffplug.spotless from 6.9.0 to 6.9.1 [(#2725)](https://togithub.com/mockito/mockito/pull/2725)
- Bump versions.bytebuddy from 1.12.12 to 1.12.13 [(#2719)](https://togithub.com/mockito/mockito/pull/2719)
- Fix Javadoc for Mockito. [(#2718)](https://togithub.com/mockito/mockito/pull/2718)
- Bump com.diffplug.spotless from 6.8.0 to 6.9.0 [(#2717)](https://togithub.com/mockito/mockito/pull/2717)
- Fix a typo in comment of InternalRunner.java [(#2715)](https://togithub.com/mockito/mockito/pull/2715)
- Bump junit-platform-launcher from 1.8.2 to 1.9.0 [(#2713)](https://togithub.com/mockito/mockito/pull/2713)
- Bump versions.junitJupiter from 5.8.2 to 5.9.0 [(#2712)](https://togithub.com/mockito/mockito/pull/2712)
- Bump groovy from 3.0.11 to 3.0.12 [(#2711)](https://togithub.com/mockito/mockito/pull/2711)
- Bump shipkit-auto-version from 1.2.0 to 1.2.1 [(#2709)](https://togithub.com/mockito/mockito/pull/2709)
- Bump kotlinVersion from 1.7.0 to 1.7.10 [(#2705)](https://togithub.com/mockito/mockito/pull/2705)
- Bump com.diffplug.spotless from 6.7.2 to 6.8.0 [(#2699)](https://togithub.com/mockito/mockito/pull/2699)
- Bump versions.bytebuddy from 1.12.11 to 1.12.12 [(#2695)](https://togithub.com/mockito/mockito/pull/2695)
- Makes error message less misleading and points to github for help. Issue [#2692](https://togithub.com/mockito/mockito/issues/2692) [(#2693)](https://togithub.com/mockito/mockito/pull/2693)
- Misleading error message when mocking and a class (of a parameter) is not found [(#2692)](https://togithub.com/mockito/mockito/issues/2692)
- Bump kotlinx-coroutines-core from 1.6.1-native-mt to 1.6.3-native-mt [(#2691)](https://togithub.com/mockito/mockito/pull/2691)
- Bump versions.bytebuddy from 1.12.10 to 1.12.11 [(#2690)](https://togithub.com/mockito/mockito/pull/2690)
- Fixes [#2679](https://togithub.com/mockito/mockito/issues/2679) : Update Javadoc [(#2689)](https://togithub.com/mockito/mockito/pull/2689)
- Bump org.eclipse.osgi from 3.17.200 to 3.18.0 [(#2688)](https://togithub.com/mockito/mockito/pull/2688)
- RETURNS_SELF: Avoids returning mock when mock type is assignable to method return type, but method return type is Object. [(#2687)](https://togithub.com/mockito/mockito/pull/2687)
- RETURNS_SELF breaks methods with generic return type [(#2686)](https://togithub.com/mockito/mockito/issues/2686)
- Fix [#2616](https://togithub.com/mockito/mockito/issues/2616) wrong stub for nested static [(#2685)](https://togithub.com/mockito/mockito/pull/2685)
- Bump com.diffplug.spotless from 6.7.0 to 6.7.2 [(#2684)](https://togithub.com/mockito/mockito/pull/2684)
- Avoids starting mocks "half-way" if a superclass constructor is mocked but an unmocked subclass is initiated. [(#2682)](https://togithub.com/mockito/mockito/pull/2682)
- Fix typo [(#2681)](https://togithub.com/mockito/mockito/pull/2681)
- Update javadoc of `Strictness.STRICT_STUBS` [(#2679)](https://togithub.com/mockito/mockito/issues/2679)
- Bump kotlinVersion from 1.6.21 to 1.7.0 [(#2677)](https://togithub.com/mockito/mockito/pull/2677)
- Bump biz.aQute.bnd.builder from 6.3.0 to 6.3.1 [(#2675)](https://togithub.com/mockito/mockito/pull/2675)
- Bump biz.aQute.bnd.gradle from 6.3.0 to 6.3.1 [(#2674)](https://togithub.com/mockito/mockito/pull/2674)
- Bump com.diffplug.spotless from 6.6.1 to 6.7.0 [(#2672)](https://togithub.com/mockito/mockito/pull/2672)
- update CONTRIBUTING.md - stackoverflow [(#2671)](https://togithub.com/mockito/mockito/pull/2671)
- stackoverflow.com is a non-actionable text, to be replaced with a hyperlink [(#2670)](https://togithub.com/mockito/mockito/issues/2670)
- Fix typos [(#2669)](https://togithub.com/mockito/mockito/pull/2669)
- Bump biz.aQute.bnd.gradle from 6.2.0 to 6.3.0 [(#2666)](https://togithub.com/mockito/mockito/pull/2666)
- Bump biz.aQute.bnd.builder from 6.2.0 to 6.3.0 [(#2665)](https://togithub.com/mockito/mockito/pull/2665)
- Improve Varargs handling in AdditionalAnswers [(#2664)](https://togithub.com/mockito/mockito/pull/2664)
- Bump appcompat from 1.4.1 to 1.4.2 [(#2663)](https://togithub.com/mockito/mockito/pull/2663)
- Varargs methods cause `ClassCastException` in `AnswerFunctionalInterfaces` [(#2644)](https://togithub.com/mockito/mockito/issues/2644)
- Mock static class seems records wrong invocations if called nested method throws exception [(#2616)](https://togithub.com/mockito/mockito/issues/2616)
### [`v4.6.1`](https://togithub.com/mockito/mockito/releases/tag/v4.6.1)
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 4.6.1
- 2022-06-02 - [6 commit(s)](https://togithub.com/mockito/mockito/compare/v4.6.0...v4.6.1) by Andy Coates, Chen Ni, dependabot\[bot]
- Bump material from 1.6.0 to 1.6.1 [(#2662)](https://togithub.com/mockito/mockito/pull/2662)
- Bump core-ktx from 1.7.0 to 1.8.0 [(#2661)](https://togithub.com/mockito/mockito/pull/2661)
- Bump groovy from 3.0.10 to 3.0.11 [(#2660)](https://togithub.com/mockito/mockito/pull/2660)
- Fix for Issue2656 [(#2659)](https://togithub.com/mockito/mockito/pull/2659)
- Bump assertj-core from 3.22.0 to 3.23.1 [(#2658)](https://togithub.com/mockito/mockito/pull/2658)
- Regression? Strictness set in `@MockitoSettings` ignored after upgrade from 4.5.1 to 4.6.0 [(#2656)](https://togithub.com/mockito/mockito/issues/2656)
- Fix typo [(#2655)](https://togithub.com/mockito/mockito/pull/2655)
### [`v4.6.0`](https://togithub.com/mockito/mockito/releases/tag/v4.6.0)
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 4.6.0
- 2022-05-27 - [14 commit(s)](https://togithub.com/mockito/mockito/compare/v4.5.1...v4.6.0) by Hervé Boutemy, K. Siva Prasad Reddy, Rafael Winterhalter, dependabot\[bot]
- Bump shipkit-changelog from 1.1.15 to 1.2.0 [(#2654)](https://togithub.com/mockito/mockito/pull/2654)
- Bump versions.errorprone from 2.13.1 to 2.14.0 [(#2653)](https://togithub.com/mockito/mockito/pull/2653)
- Bump shipkit-auto-version from 1.1.20 to 1.2.0 [(#2651)](https://togithub.com/mockito/mockito/pull/2651)
- Fixes [#2648](https://togithub.com/mockito/mockito/issues/2648) : Add support for customising strictness via [@Mock](https://togithub.com/Mock) annotation and MockSettings [(#2650)](https://togithub.com/mockito/mockito/pull/2650)
- Any way to enable Strict Stubbing when using Mockito.mock() without using [@Mock](https://togithub.com/Mock)? [(#2648)](https://togithub.com/mockito/mockito/issues/2648)
- Reintroduce inheriting type annotations from interfaces if only one interface is mocked, including additional interfaces. [(#2645)](https://togithub.com/mockito/mockito/pull/2645)
- Bump com.diffplug.spotless from 6.6.0 to 6.6.1 [(#2643)](https://togithub.com/mockito/mockito/pull/2643)
- fix Reproducible Build issue [(#2642)](https://togithub.com/mockito/mockito/pull/2642)
- Bump com.diffplug.spotless from 6.5.2 to 6.6.0 [(#2641)](https://togithub.com/mockito/mockito/pull/2641)
- Mockito mock of interfaces lost annotation information [(#2640)](https://togithub.com/mockito/mockito/issues/2640)
- Bump material from 1.5.0 to 1.6.0 [(#2637)](https://togithub.com/mockito/mockito/pull/2637)
- Bump com.diffplug.spotless from 6.5.1 to 6.5.2 [(#2636)](https://togithub.com/mockito/mockito/pull/2636)
- Bump versions.bytebuddy from 1.12.9 to 1.12.10 [(#2635)](https://togithub.com/mockito/mockito/pull/2635)
- Bump com.diffplug.spotless from 6.5.0 to 6.5.1 [(#2632)](https://togithub.com/mockito/mockito/pull/2632)
- Bump com.diffplug.spotless from 6.4.2 to 6.5.0 [(#2631)](https://togithub.com/mockito/mockito/pull/2631)
### [`v4.5.1`](https://togithub.com/mockito/mockito/releases/tag/v4.5.1)
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 4.5.1
- 2022-04-21 - [2 commit(s)](https://togithub.com/mockito/mockito/compare/v4.5.0...v4.5.1) by Jeremy Landis, dependabot\[bot]
- Fixes [#2623](https://togithub.com/mockito/mockito/issues/2623): Use zulu distribution and java 11 for release GHA job [(#2624)](https://togithub.com/mockito/mockito/pull/2624)
- Missing errorprone module for 4.5.0 in central as release was done with jdk 8 [(#2623)](https://togithub.com/mockito/mockito/issues/2623)
- Bump kotlinVersion from 1.6.20 to 1.6.21 [(#2622)](https://togithub.com/mockito/mockito/pull/2622)
#### Missing `net.bytebuddy.utility.GraalImageCode` exception
If you encounter any issues with missing ByteBuddy classes, make sure you are using ByteBuddy 1.12 or higher.
### [`v4.5.0`](https://togithub.com/mockito/mockito/releases/tag/v4.5.0)
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 4.5.0
- 2022-04-19 - [15 commit(s)](https://togithub.com/mockito/mockito/compare/v4.4.0...v4.5.0) by Andrei Silviu Dragnea, Rafael Winterhalter, Rick Ossendrijver, dependabot\[bot]
- Bump versions.errorprone from 2.13.0 to 2.13.1 [(#2621)](https://togithub.com/mockito/mockito/pull/2621)
- Bump versions.errorprone from 2.12.1 to 2.13.0 [(#2619)](https://togithub.com/mockito/mockito/pull/2619)
- Groovy inline [(#2618)](https://togithub.com/mockito/mockito/pull/2618)
- Bump actions/setup-java from 2 to 3 [(#2615)](https://togithub.com/mockito/mockito/pull/2615)
- Bump versions.bytebuddy from 1.12.8 to 1.12.9 [(#2614)](https://togithub.com/mockito/mockito/pull/2614)
- Support subclass mocks on Graal VM. [(#2613)](https://togithub.com/mockito/mockito/pull/2613)
- Bump com.diffplug.spotless from 6.4.1 to 6.4.2 [(#2611)](https://togithub.com/mockito/mockito/pull/2611)
- Bump kotlinx-coroutines-core from 1.6.0-native-mt to 1.6.1-native-mt [(#2609)](https://togithub.com/mockito/mockito/pull/2609)
- Bump versions.errorprone from 2.10.0 to 2.12.1 [(#2608)](https://togithub.com/mockito/mockito/pull/2608)
- Bump kotlinVersion from 1.6.10 to 1.6.20 [(#2607)](https://togithub.com/mockito/mockito/pull/2607)
- Bump com.diffplug.spotless from 6.4.0 to 6.4.1 [(#2606)](https://togithub.com/mockito/mockito/pull/2606)
- Bump com.diffplug.spotless from 6.3.0 to 6.4.0 [(#2605)](https://togithub.com/mockito/mockito/pull/2605)
- Bump org.eclipse.osgi from 3.17.100 to 3.17.200 [(#2597)](https://togithub.com/mockito/mockito/pull/2597)
- Deprecate ListUtil and Fields classes [(#2593)](https://togithub.com/mockito/mockito/pull/2593)
- mockito-errorprone seems not compatible with ErrorProne 2.11.0 [(#2554)](https://togithub.com/mockito/mockito/issues/2554)
- NullPointerException from Groovy metaclass methods when using mockito-inline (but not mockito-core) [(#2522)](https://togithub.com/mockito/mockito/issues/2522)
### [`v4.4.0`](https://togithub.com/mockito/mockito/releases/tag/v4.4.0)
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 4.4.0
- 2022-03-08 - [16 commit(s)](https://togithub.com/mockito/mockito/compare/v4.3.1...v4.4.0) by Andrew Kozel, Brice Dutheil, Jean-Baptiste Mille, Mirko Alicastro, dependabot\[bot]
- Bump groovy from 3.0.9 to 3.0.10 [(#2586)](https://togithub.com/mockito/mockito/pull/2586)
- Bump google-java-format from 1.14.0 to 1.15.0 [(#2585)](https://togithub.com/mockito/mockito/pull/2585)
- Bump actions/checkout from 2.4.0 to 3 [(#2582)](https://togithub.com/mockito/mockito/pull/2582)
- Bump shipkit-auto-version from 1.1.19 to 1.1.20 [(#2580)](https://togithub.com/mockito/mockito/pull/2580)
- Bump biz.aQute.bnd.builder from 6.1.0 to 6.2.0 [(#2579)](https://togithub.com/mockito/mockito/pull/2579)
- Bump biz.aQute.bnd.gradle from 6.1.0 to 6.2.0 [(#2578)](https://togithub.com/mockito/mockito/pull/2578)
- Adds a Google Java Format for JDK17 [(#2572)](https://togithub.com/mockito/mockito/pull/2572)
- Clean up JUnit3 references [(#2570)](https://togithub.com/mockito/mockito/pull/2570)
- Bump com.diffplug.spotless from 6.2.2 to 6.3.0 [(#2567)](https://togithub.com/mockito/mockito/pull/2567)
- Bump google-java-format from 1.13.0 to 1.14.0 [(#2565)](https://togithub.com/mockito/mockito/pull/2565)
- Bump versions.bytebuddy from 1.12.7 to 1.12.8 [(#2564)](https://togithub.com/mockito/mockito/pull/2564)
- Bump com.diffplug.spotless from 6.2.1 to 6.2.2 [(#2562)](https://togithub.com/mockito/mockito/pull/2562)
- Bump com.github.ben-manes.versions from 0.41.0 to 0.42.0 [(#2559)](https://togithub.com/mockito/mockito/pull/2559)
- Bump com.diffplug.spotless from 6.2.0 to 6.2.1 [(#2556)](https://togithub.com/mockito/mockito/pull/2556)
- Fixes [#2548](https://togithub.com/mockito/mockito/issues/2548) : Makes InOrder able to verify static methods [(#2549)](https://togithub.com/mockito/mockito/pull/2549)
- \[PR open] Add feature to verify static methods calls in order [(#2548)](https://togithub.com/mockito/mockito/issues/2548)
- Fixes [#2201](https://togithub.com/mockito/mockito/issues/2201) : Fixed checking of declared exceptions. [(#2547)](https://togithub.com/mockito/mockito/pull/2547)
- Calling getExceptionTypes() on concrete object that is used as interface doesn't return exception types from interface [(#2201)](https://togithub.com/mockito/mockito/issues/2201)
### [`v4.3.1`](https://togithub.com/mockito/mockito/releases/tag/v4.3.1)
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 4.3.1
- 2022-01-25 - [1 commit(s)](https://togithub.com/mockito/mockito/compare/v4.3.0...v4.3.1) by Stefano Cordio
- Add `mockito-core` to the BOM [(#2550)](https://togithub.com/mockito/mockito/pull/2550)
### [`v4.3.0`](https://togithub.com/mockito/mockito/releases/tag/v4.3.0)
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 4.3.0
- 2022-01-24 - [20 commit(s)](https://togithub.com/mockito/mockito/compare/v4.2.0...v4.3.0) by Andrew Kozel, John Pyeatt, Liam Miller-Cushon, Thomas Keller, Tim van der Lippe, dependabot\[bot], temp-droid
- Fixes [#2489](https://togithub.com/mockito/mockito/issues/2489) : Fixed issue related to exceptions thrown from the nested spies [(#2546)](https://togithub.com/mockito/mockito/pull/2546)
- Issue 2544 [(#2545)](https://togithub.com/mockito/mockito/pull/2545)
- Bump versions.bytebuddy from 1.12.6 to 1.12.7 [(#2543)](https://togithub.com/mockito/mockito/pull/2543)
- Bump com.diffplug.spotless from 6.1.2 to 6.2.0 [(#2542)](https://togithub.com/mockito/mockito/pull/2542)
- Bump material from 1.4.0 to 1.5.0 [(#2541)](https://togithub.com/mockito/mockito/pull/2541)
- Bump appcompat from 1.4.0 to 1.4.1 [(#2539)](https://togithub.com/mockito/mockito/pull/2539)
- Bump com.diffplug.spotless from 6.1.1 to 6.1.2 [(#2536)](https://togithub.com/mockito/mockito/pull/2536)
- Remove an `@link` [(#2535)](https://togithub.com/mockito/mockito/pull/2535)
- Bump com.diffplug.spotless from 6.1.0 to 6.1.1 [(#2534)](https://togithub.com/mockito/mockito/pull/2534)
- Bump com.github.ben-manes.versions from 0.40.0 to 0.41.0 [(#2533)](https://togithub.com/mockito/mockito/pull/2533)
- Bump assertj-core from 3.21.0 to 3.22.0 [(#2531)](https://togithub.com/mockito/mockito/pull/2531)
- Bump com.github.ben-manes.versions from 0.39.0 to 0.40.0 [(#2529)](https://togithub.com/mockito/mockito/pull/2529)
- Bump com.diffplug.spotless from 6.0.5 to 6.1.0 [(#2527)](https://togithub.com/mockito/mockito/pull/2527)
- Bump kotlinx-coroutines-core from 1.5.2-native-mt to 1.6.0-native-mt [(#2526)](https://togithub.com/mockito/mockito/pull/2526)
- Bump versions.bytebuddy from 1.12.5 to 1.12.6 [(#2524)](https://togithub.com/mockito/mockito/pull/2524)
- Bump com.diffplug.spotless from 6.0.4 to 6.0.5 [(#2520)](https://togithub.com/mockito/mockito/pull/2520)
- Bump versions.bytebuddy from 1.12.4 to 1.12.5 [(#2519)](https://togithub.com/mockito/mockito/pull/2519)
- Fixes [#2510](https://togithub.com/mockito/mockito/issues/2510): Remove ExpectedException from internal test suite [(#2518)](https://togithub.com/mockito/mockito/pull/2518)
- Fix JavaDoc warnings and enforce zero errors in Gradle [(#2513)](https://togithub.com/mockito/mockito/pull/2513)
- Remove `ExpectedException` from internal test suite [(#2510)](https://togithub.com/mockito/mockito/issues/2510)
- Incomplete stack trace returned from spy inside another spy [(#2489)](https://togithub.com/mockito/mockito/issues/2489)
- Introduce a BOM for Mockito's artifacts (closes [#2321](https://togithub.com/mockito/mockito/issues/2321)) [(#2323)](https://togithub.com/mockito/mockito/pull/2323)
- Provide a bill of materials (BOM) [(#2321)](https://togithub.com/mockito/mockito/issues/2321)
### [`v4.2.0`](https://togithub.com/mockito/mockito/releases/tag/v4.2.0)
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 4.2.0
- 2021-12-16 - [21 commit(s)](https://togithub.com/mockito/mockito/compare/v4.1.0...v4.2.0) by Liam Miller-Cushon, Rafael Winterhalter, Tim van der Lippe, dependabot\[bot], temp-droid
- Update ByteBuddy to 1.12.4 [(#2515)](https://togithub.com/mockito/mockito/pull/2515)
- Bump kotlinVersion from 1.6.0 to 1.6.10 [(#2514)](https://togithub.com/mockito/mockito/pull/2514)
- Add DoNotMock mention to main JavaDoc [(#2512)](https://togithub.com/mockito/mockito/pull/2512)
- Replace ExpectedException in MissingInvocationInOrderCheckerTest [(#2511)](https://togithub.com/mockito/mockito/pull/2511)
- Update Gradle to version 7.3.1 [(#2509)](https://togithub.com/mockito/mockito/pull/2509)
- Fixes [#2497](https://togithub.com/mockito/mockito/issues/2497): Throw exception on invalid matchers for `mockStatic` [(#2506)](https://togithub.com/mockito/mockito/pull/2506)
- Make sure interface types are initialized before inline mocking to avoid blocking code of static initializers. [(#2505)](https://togithub.com/mockito/mockito/pull/2505)
- Bump org.eclipse.osgi from 3.17.0 to 3.17.100 [(#2504)](https://togithub.com/mockito/mockito/pull/2504)
- Bump com.diffplug.spotless from 6.0.2 to 6.0.4 [(#2501)](https://togithub.com/mockito/mockito/pull/2501)
- Bump com.diffplug.spotless from 6.0.1 to 6.0.2 [(#2498)](https://togithub.com/mockito/mockito/pull/2498)
- ArgumentMatchers not working for Mockito.mockStatic [(#2497)](https://togithub.com/mockito/mockito/issues/2497)
- Bump versions.bytebuddy from 1.12.2 to 1.12.3 [(#2496)](https://togithub.com/mockito/mockito/pull/2496)
- Bump com.diffplug.spotless from 6.0.0 to 6.0.1 [(#2495)](https://togithub.com/mockito/mockito/pull/2495)
- Remove the recommendation to import ArgumentMatchers methods using Mockito [(#2494)](https://togithub.com/mockito/mockito/pull/2494)
- Bump versions.junitJupiter from 5.8.1 to 5.8.2 [(#2491)](https://togithub.com/mockito/mockito/pull/2491)
- Bump junit-platform-launcher from 1.8.1 to 1.8.2 [(#2490)](https://togithub.com/mockito/mockito/pull/2490)
- Fix typo 'DoNoMock' should be 'DoNotMock' [(#2487)](https://togithub.com/mockito/mockito/pull/2487)
- Bump biz.aQute.bnd.gradle from 6.0.0 to 6.1.0 [(#2486)](https://togithub.com/mockito/mockito/pull/2486)
- Bump biz.aQute.bnd.builder from 6.0.0 to 6.1.0 [(#2485)](https://togithub.com/mockito/mockito/pull/2485)
- Bump versions.bytebuddy from 1.12.1 to 1.12.2 [(#2484)](https://togithub.com/mockito/mockito/pull/2484)
- Bump google-java-format from 1.12.0 to 1.13.0 [(#2483)](https://togithub.com/mockito/mockito/pull/2483)
- Add annotation to mark a type as DoNotMock [(#1833)](https://togithub.com/mockito/mockito/pull/1833)
### [`v4.1.0`](https://togithub.com/mockito/mockito/releases/tag/v4.1.0)
### Major new feature: `@DoNotMock`
You can now mark classes/interfaces with `@org.mockito.DoNotMock` to disallow mocking with Mockito. For more information, see our documentation: https://javadoc.io/doc/org.mockito/mockito-core/latest/org/mockito/DoNotMock.html
*Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)*
##### 4.1.0
- 2021-11-19 - [20 commit(s)](https://togithub.com/mockito/mockito/compare/v4.0.0...v4.1.0) by Lars Vogel, Mikaël Francoeur, S.YAMAMOTO, Tim van der Lippe, dependabot\[bot]
- Disable memory test [(#2480)](https://togithub.com/mockito/mockito/pull/2480)
- Bump appcompat from 1.3.1 to 1.4.0 [(#2477)](https://togithub.com/mockito/mockito/pull/2477)
- Bump kotlinVersion from 1.5.31 to 1.6.0 [(#2474)](https://togithub.com/mockito/mockito/pull/2474)
- Bump versions.bytebuddy from 1.12.0 to 1.12.1 [(#2472)](https://togithub.com/mockito/mockito/pull/2472)
- Bump com.diffplug.gradle.spotless from 4.5.1 to 6.0.0 [(#2471)](https://togithub.com/mockito/mockito/pull/2471)
- Bump versions.bytebuddy from 1.11.22 to 1.12.0 [(#2469)](https://togithub.com/mockito/mockito/pull/2469)
- Bump versions.errorprone from 2.9.0 to 2.10.0 [(#2466)](https://togithub.com/mockito/mockito/pull/2466)
- Bump auto-service from 1.0 to 1.0.1 [(#2463)](https://togithub.com/mockito/mockito/pull/2463)
- Bump actions/checkout from 2.3.5 to 2.4.0 [(#2462)](https://togithub.com/mockito/mockito/pull/2462)
- Fixes [#2460](https://togithub.com/mockito/mockito/issues/2460): Remove a sentence commits to a particular version [(#2461)](https://togithub.com/mockito/mockito/pull/2461)
- Clarify Javadoc of RETURNS_SMART_NULLS, default answer in Mockito 4.0.0? [(#2460)](https://togithub.com/mockito/mockito/issues/2460)
- Bump versions.bytebuddy from 1.11.21 to 1.11.22 [(#2458)](https://togithub.com/mockito/mocki
Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
[ ] If you want to rebase/retry this PR, check this box
This PR has been generated by Mend Renovate. View repository job log here.
This PR contains the following updates:
3.5.11
->5.5.0
Release Notes
mockito/mockito (org.mockito:mockito-core)
### [`v5.5.0`](https://togithub.com/mockito/mockito/releases/tag/v5.5.0) [Compare Source](https://togithub.com/mockito/mockito/compare/v5.4.0...v5.5.0) *Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)* ##### 5.5.0 - 2023-08-22 - [25 commit(s)](https://togithub.com/mockito/mockito/compare/v5.4.0...v5.5.0) by Andreas Turban, Chris Egerton, Róbert Papp, Thach Le, dependabot\[bot] - Bump org.gradle.toolchains.foojay-resolver-convention from 0.6.0 to 0.7.0 [(#3096)](https://togithub.com/mockito/mockito/pull/3096) - Excessive locking in TypeCachingBytecodeGenerator#BOOTSTRAP_LOCK [(#3095)](https://togithub.com/mockito/mockito/pull/3095) - Bump versions.bytebuddy from 1.14.5 to 1.14.6 [(#3094)](https://togithub.com/mockito/mockito/pull/3094) - Fixes 3087 : Add note on backporting to README [(#3090)](https://togithub.com/mockito/mockito/pull/3090) - Backporting policy [(#3087)](https://togithub.com/mockito/mockito/issues/3087) - Bump versions.errorprone from 2.21.0 to 2.21.1 [(#3083)](https://togithub.com/mockito/mockito/pull/3083) - Fixes [#3077](https://togithub.com/mockito/mockito/issues/3077) : Report unused stubbing exceptions when test filter is no-op [(#3078)](https://togithub.com/mockito/mockito/pull/3078) - Unused stubbings are not reported when filters are used [(#3077)](https://togithub.com/mockito/mockito/issues/3077) - Bump versions.errorprone from 2.20.0 to 2.21.0 [(#3076)](https://togithub.com/mockito/mockito/pull/3076) - Bump com.gradle.enterprise from 3.14 to 3.14.1 [(#3074)](https://togithub.com/mockito/mockito/pull/3074) - Bump org.opentest4j:opentest4j from 1.2.0 to 1.3.0 [(#3072)](https://togithub.com/mockito/mockito/pull/3072) - Bump versions.junitJupiter from 5.9.3 to 5.10.0 [(#3071)](https://togithub.com/mockito/mockito/pull/3071) - Bump org.junit.platform:junit-platform-launcher from 1.9.3 to 1.10.0 [(#3070)](https://togithub.com/mockito/mockito/pull/3070) - Bump gradle/wrapper-validation-action from 1.0.6 to 1.1.0 [(#3069)](https://togithub.com/mockito/mockito/pull/3069) - Gradle 8.3 compatibility: buildDir -> layout.buildDirectory [(#3068)](https://togithub.com/mockito/mockito/pull/3068) - Bump com.gradle.enterprise from 3.13.4 to 3.14 [(#3067)](https://togithub.com/mockito/mockito/pull/3067) - Bump com.diffplug.spotless from 6.19.0 to 6.20.0 [(#3066)](https://togithub.com/mockito/mockito/pull/3066) - Toolchain for Test task [(#3064)](https://togithub.com/mockito/mockito/pull/3064) - Gradle build script improvements [(#3062)](https://togithub.com/mockito/mockito/pull/3062) - Fixes [#3046](https://togithub.com/mockito/mockito/issues/3046) [(#3060)](https://togithub.com/mockito/mockito/pull/3060) - Fix Gradle 8.2 deprecation of Conventions in nexus plugin. [(#3056)](https://togithub.com/mockito/mockito/pull/3056) - Bump kotlinVersion from 1.8.22 to 1.9.0 [(#3055)](https://togithub.com/mockito/mockito/pull/3055) - Bump ru.vyarus.animalsniffer from 1.7.0 to 1.7.1 [(#3054)](https://togithub.com/mockito/mockito/pull/3054) - Gradle 8.2: work around fix for release publishing [(#3053)](https://togithub.com/mockito/mockito/pull/3053) - Rewire Jacoco for Gradle 8/9 [(#3052)](https://togithub.com/mockito/mockito/pull/3052) - Gradle 7.6 to 8.2 (conventions to extensions migration, mostly) [(#3051)](https://togithub.com/mockito/mockito/pull/3051) - Bump org.codehaus.groovy:groovy from 3.0.17 to 3.0.18 [(#3049)](https://togithub.com/mockito/mockito/pull/3049) - Mockito#reset Condescending Documentation [(#3046)](https://togithub.com/mockito/mockito/issues/3046) - Excessive locking in TypeCachingBytecodeGenerator#BOOTSTRAP_LOCK [(#3035)](https://togithub.com/mockito/mockito/issues/3035) ### [`v5.4.0`](https://togithub.com/mockito/mockito/releases/tag/v5.4.0) [Compare Source](https://togithub.com/mockito/mockito/compare/v5.3.1...v5.4.0) *Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)* ##### 5.4.0 - 2023-06-18 - [22 commit(s)](https://togithub.com/mockito/mockito/compare/v5.3.1...v5.4.0) by Alexander von Trostorff, Andriy Redko, Benoit Maggi, Chris Povirk, DerFrZocker, Nicolas Ot, Tim van der Lippe, dependabot\[bot], ellaella12 - Bump versions.errorprone from 2.19.1 to 2.20.0 [(#3041)](https://togithub.com/mockito/mockito/pull/3041) - Bump org.eclipse.platform:org.eclipse.osgi from 3.18.300 to 3.18.400 [(#3038)](https://togithub.com/mockito/mockito/pull/3038) - Bump com.google.auto.service:auto-service from 1.1.0 to 1.1.1 [(#3036)](https://togithub.com/mockito/mockito/pull/3036) - Bump com.github.ben-manes.versions from 0.46.0 to 0.47.0 [(#3034)](https://togithub.com/mockito/mockito/pull/3034) - Bump kotlinVersion from 1.8.21 to 1.8.22 [(#3033)](https://togithub.com/mockito/mockito/pull/3033) - Documentation about MockMakers slightly outdated in some places. Fixes [#3031](https://togithub.com/mockito/mockito/issues/3031) [(#3032)](https://togithub.com/mockito/mockito/pull/3032) - Documentation about MockMakers slightly outdated in some places [(#3031)](https://togithub.com/mockito/mockito/issues/3031) - Bump versions.bytebuddy from 1.14.4 to 1.14.5 [(#3025)](https://togithub.com/mockito/mockito/pull/3025) - Edit DoAnswerStyleStubbing.isSet() to return true if there are answers [(#3020)](https://togithub.com/mockito/mockito/pull/3020) - Bump com.diffplug.spotless from 6.18.0 to 6.19.0 [(#3018)](https://togithub.com/mockito/mockito/pull/3018) - Bump com.google.auto.service:auto-service from 1.0.1 to 1.1.0 [(#3017)](https://togithub.com/mockito/mockito/pull/3017) - Bump versions.errorprone from 2.18.0 to 2.19.1 [(#3009)](https://togithub.com/mockito/mockito/pull/3009) - Fix `@Mock(serializable = true)` for parameterized types. [(#3007)](https://togithub.com/mockito/mockito/pull/3007) - Add varargs changes to `ArgumentMatchers#any()` JavaDoc [(#3003)](https://togithub.com/mockito/mockito/pull/3003) - Mockito 5 any() does not match a vararg int\[] argument anymore. I need to use any(int\[].class) to get the ArgumentMatcher to work [(#2998)](https://togithub.com/mockito/mockito/issues/2998) - Bump com.google.googlejavaformat:google-java-format from 1.16.0 to 1.17.0 [(#2996)](https://togithub.com/mockito/mockito/pull/2996) - Remove redundant double "now" in JavaDocs for mock without class [(#2994)](https://togithub.com/mockito/mockito/pull/2994) - Bump org.junit.platform:junit-platform-launcher from 1.9.2 to 1.9.3 [(#2993)](https://togithub.com/mockito/mockito/pull/2993) - Bump versions.junitJupiter from 5.9.2 to 5.9.3 [(#2992)](https://togithub.com/mockito/mockito/pull/2992) - Provide a variant of assertArg that works well with checked exceptions [(#2991)](https://togithub.com/mockito/mockito/pull/2991) - Bump kotlinVersion from 1.8.10 to 1.8.21 [(#2990)](https://togithub.com/mockito/mockito/pull/2990) - Fix [#2915](https://togithub.com/mockito/mockito/issues/2915) Forbid spy on mocked interface [(#2989)](https://togithub.com/mockito/mockito/pull/2989) - Bump net.ltgt.gradle:gradle-errorprone-plugin from 3.0.1 to 3.1.0 [(#2987)](https://togithub.com/mockito/mockito/pull/2987) - `@Mock(serializable = true)` no longer works with parameterized types [(#2979)](https://togithub.com/mockito/mockito/issues/2979) - Bug with [@InjectMocks](https://togithub.com/InjectMocks) in 5.3.0 [(#2978)](https://togithub.com/mockito/mockito/issues/2978) - Function name is incorrect. [(#2955)](https://togithub.com/mockito/mockito/issues/2955) - Verify on Spy Interface incorrect count of actual invocation [(#2915)](https://togithub.com/mockito/mockito/issues/2915) - Only run injection once [(#2603)](https://togithub.com/mockito/mockito/pull/2603) - mockito-core MockitoAnnotations::openMocks initializes class twice if said class has super class [(#2602)](https://togithub.com/mockito/mockito/issues/2602) ### [`v5.3.1`](https://togithub.com/mockito/mockito/releases/tag/v5.3.1) [Compare Source](https://togithub.com/mockito/mockito/compare/v5.3.0...v5.3.1) *Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)* ##### 5.3.1 - 2023-04-21 - [2 commit(s)](https://togithub.com/mockito/mockito/compare/v5.3.0...v5.3.1) by Rafael Winterhalter, jfrantzius - Fixes 2972: Weakens visibility constraint [(#2983)](https://togithub.com/mockito/mockito/pull/2983) - Bugfix 2974 fix npe [(#2976)](https://togithub.com/mockito/mockito/pull/2976) - Fix for [#2958](https://togithub.com/mockito/mockito/issues/2958) eliminates CCE but leads to NPE [(#2974)](https://togithub.com/mockito/mockito/issues/2974) - Spying objects not working properly since 5.3.0 [(#2972)](https://togithub.com/mockito/mockito/issues/2972) ### [`v5.3.0`](https://togithub.com/mockito/mockito/releases/tag/v5.3.0) [Compare Source](https://togithub.com/mockito/mockito/compare/v5.2.0...v5.3.0) *Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)* ##### 5.3.0 - 2023-04-11 - [14 commit(s)](https://togithub.com/mockito/mockito/compare/v5.2.0...v5.3.0) by Krzysztof Krasoń, Maciej Walkowiak, Rafael Winterhalter, Wesley Tsai, dependabot\[bot], jfrantzius - Bump com.diffplug.spotless from 6.17.0 to 6.18.0 [(#2967)](https://togithub.com/mockito/mockito/pull/2967) - Bump versions.bytebuddy from 1.14.3 to 1.14.4 [(#2966)](https://togithub.com/mockito/mockito/pull/2966) - Adds `withoutAnnotations` parameter to `@Mock` [(#2965)](https://togithub.com/mockito/mockito/pull/2965) - Fix ClassCastException [(#2962)](https://togithub.com/mockito/mockito/pull/2962) - Bump org.codehaus.groovy:groovy from 3.0.16 to 3.0.17 [(#2959)](https://togithub.com/mockito/mockito/pull/2959) - ClassCastException when combining InjectMocks with generified Mock field [(#2958)](https://togithub.com/mockito/mockito/issues/2958) - Bump versions.bytebuddy from 1.14.2 to 1.14.3 [(#2950)](https://togithub.com/mockito/mockito/pull/2950) - Add `ArgumentMatchers#assertArg` method. [(#2949)](https://togithub.com/mockito/mockito/pull/2949) - Fixes 2947: correct visibility check to respect nestmates [(#2948)](https://togithub.com/mockito/mockito/pull/2948) - spy does not initialize objects fully with InstrumentationMemberAccessor [(#2947)](https://togithub.com/mockito/mockito/issues/2947) - Fixes [#2877](https://togithub.com/mockito/mockito/issues/2877): removed mockito-inline as subproject and actual subproject [(#2945)](https://togithub.com/mockito/mockito/pull/2945) - [#2934](https://togithub.com/mockito/mockito/issues/2934) throw exception on multiple matches by type if cannot be reduce… [(#2942)](https://togithub.com/mockito/mockito/pull/2942) - Bump org.eclipse.platform:org.eclipse.osgi from 3.18.200 to 3.18.300 [(#2941)](https://togithub.com/mockito/mockito/pull/2941) - Bump com.diffplug.spotless from 6.16.0 to 6.17.0 [(#2940)](https://togithub.com/mockito/mockito/pull/2940) - Bump org.codehaus.groovy:groovy from 3.0.15 to 3.0.16 [(#2939)](https://togithub.com/mockito/mockito/pull/2939) - Bump versions.bytebuddy from 1.14.1 to 1.14.2 [(#2938)](https://togithub.com/mockito/mockito/pull/2938) - Feature suggestion: TerminalMockCandidateFilter should report error when more than one candidate left [(#2934)](https://togithub.com/mockito/mockito/issues/2934) - Mockito-inline dependency after upgrade 5.0.0 [(#2877)](https://togithub.com/mockito/mockito/issues/2877) - Assertions on parameters during verification [(#2285)](https://togithub.com/mockito/mockito/issues/2285) ### [`v5.2.0`](https://togithub.com/mockito/mockito/releases/tag/v5.2.0) [Compare Source](https://togithub.com/mockito/mockito/compare/v5.1.1...v5.2.0) *Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)* ##### 5.2.0 - 2023-03-09 - [25 commit(s)](https://togithub.com/mockito/mockito/compare/v5.1.1...v5.2.0) by Andriy Redko, Iulian Dragos, Roberto Trunfio, Róbert Papp, dependabot\[bot], jfrantzius, tobiasbaum - Fixes 2933: IOUtils does not depend on platform encoding any more [(#2935)](https://togithub.com/mockito/mockito/pull/2935) - Execution with mockito-inline fails on platforms with EBCDIC as default encoding [(#2933)](https://togithub.com/mockito/mockito/issues/2933) - Bump io.github.gradle-nexus:publish-plugin from 1.2.0 to 1.3.0 [(#2932)](https://togithub.com/mockito/mockito/pull/2932) - Bump versions.bytebuddy from 1.14.0 to 1.14.1 [(#2931)](https://togithub.com/mockito/mockito/pull/2931) - Bump com.diffplug.spotless from 6.15.0 to 6.16.0 [(#2930)](https://togithub.com/mockito/mockito/pull/2930) - Bump com.google.googlejavaformat:google-java-format from 1.15.0 to 1.16.0 [(#2928)](https://togithub.com/mockito/mockito/pull/2928) - Bump io.github.gradle-nexus:publish-plugin from 1.1.0 to 1.2.0 [(#2924)](https://togithub.com/mockito/mockito/pull/2924) - Feature 2921 generic types [(#2923)](https://togithub.com/mockito/mockito/pull/2923) - Bump com.github.ben-manes.versions from 0.45.0 to 0.46.0 [(#2922)](https://togithub.com/mockito/mockito/pull/2922) - Use generic type information in TypeBasedCandidateFilter to circumvent type erasure [(#2921)](https://togithub.com/mockito/mockito/issues/2921) - Make project relocatable by using relative paths in the OSGi test task [(#2920)](https://togithub.com/mockito/mockito/pull/2920) - Cache misses due to OSGi tests referencing absolute paths [(#2919)](https://togithub.com/mockito/mockito/issues/2919) - Bump versions.bytebuddy from 1.13.0 to 1.14.0 [(#2918)](https://togithub.com/mockito/mockito/pull/2918) - Bump gradle/wrapper-validation-action from 1.0.5 to 1.0.6 [(#2917)](https://togithub.com/mockito/mockito/pull/2917) - Bump com.diffplug.spotless from 6.14.1 to 6.15.0 [(#2913)](https://togithub.com/mockito/mockito/pull/2913) - Bump versions.bytebuddy from 1.12.23 to 1.13.0 [(#2912)](https://togithub.com/mockito/mockito/pull/2912) - Bump ru.vyarus.animalsniffer from 1.6.0 to 1.7.0 [(#2911)](https://togithub.com/mockito/mockito/pull/2911) - Bump org.codehaus.groovy:groovy from 3.0.14 to 3.0.15 [(#2910)](https://togithub.com/mockito/mockito/pull/2910) - Fixes [#2905](https://togithub.com/mockito/mockito/issues/2905) : ThreadLocal classes can be mocked. [(#2908)](https://togithub.com/mockito/mockito/pull/2908) - StackOverflow while mocking a ThreadLocal on Mockito 5.1.1 [(#2905)](https://togithub.com/mockito/mockito/issues/2905) - Fix most Gradle warnings in build [(#2904)](https://togithub.com/mockito/mockito/pull/2904) - Android CI improvements, improves [#2892](https://togithub.com/mockito/mockito/issues/2892) [(#2903)](https://togithub.com/mockito/mockito/pull/2903) - Bump com.diffplug.spotless from 6.14.0 to 6.14.1 [(#2902)](https://togithub.com/mockito/mockito/pull/2902) - Bump versions.bytebuddy from 1.12.22 to 1.12.23 [(#2901)](https://togithub.com/mockito/mockito/pull/2901) - CI on Android API level 33 for Java 11 compatibility testing [(#2899)](https://togithub.com/mockito/mockito/pull/2899) - Bump kotlinVersion from 1.8.0 to 1.8.10 [(#2897)](https://togithub.com/mockito/mockito/pull/2897) - Bump com.github.ben-manes.versions from 0.44.0 to 0.45.0 [(#2895)](https://togithub.com/mockito/mockito/pull/2895) - Simplify and modernize Android Test module. [(#2894)](https://togithub.com/mockito/mockito/pull/2894) - Set up Android Github Action pipeline. Fixes [#2892](https://togithub.com/mockito/mockito/issues/2892) [(#2893)](https://togithub.com/mockito/mockito/pull/2893) ### [`v5.1.1`](https://togithub.com/mockito/mockito/releases/tag/v5.1.1) *Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)* ##### 5.1.1 - 2023-01-30 - [1 commit(s)](https://togithub.com/mockito/mockito/compare/v5.1.0...v5.1.1) by Andriy Redko - StackWalker.Option not found on Mockito 5.1.0 [(#2891)](https://togithub.com/mockito/mockito/pull/2891) - StackWalker.Option not found on Mockito 5.1.0 [(#2890)](https://togithub.com/mockito/mockito/issues/2890) ### [`v5.1.0`](https://togithub.com/mockito/mockito/releases/tag/v5.1.0) *Changelog generated by [Shipkit Changelog Gradle Plugin](https://togithub.com/shipkit/shipkit-changelog)* ##### 5.1.0 - 2023-01-29 - [12 commit(s)](https://togithub.com/mockito/mockito/compare/v5.0.0...v5.1.0) by Andriy Redko, Ashley, Róbert Papp, Stephan Schroevers, Tim te Beek, dependabot\[bot] - Fixes some mistakes and missing details in documentation [(#2889)](https://togithub.com/mockito/mockito/pull/2889) - Bump com.diffplug.spotless from 6.13.0 to 6.14.0 [(#2888)](https://togithub.com/mockito/mockito/pull/2888) - Clean up JDK-8 related code [(#2883)](https://togithub.com/mockito/mockito/pull/2883) - Feat: reified mock overloads [(#2882)](https://togithub.com/mockito/mockito/pull/2882) - Clean up JDK-8 related code [(#2879)](https://togithub.com/mockito/mockito/issues/2879) - Bump assertj-core from 3.24.1 to 3.24.2 [(#2875)](https://togithub.com/mockito/mockito/pull/2875) - Make sure the tests use mock maker with intended member accessor [(#2872)](https://togithub.com/mockito/mockito/pull/2872) - Bump com.diffplug.spotless from 6.12.1 to 6.13.0 [(#2871)](https://togithub.com/mockito/mockito/pull/2871) - Remove broken link from `CONTRIBUTING.md` [(#2870)](https://togithub.com/mockito/mockito/pull/2870) - Update outdated badge 3.x to 5.x [(#2869)](https://togithub.com/mockito/mockito/pull/2869) - Broken link in `CONTRIBUTING.md` [(#2868)](https://togithub.com/mockito/mockito/issues/2868) - Set current version to 5.x in README and highlight changes [(#2867)](https://togithub.com/mockito/mockito/pull/2867) - Annotate `Mockito#{mock,spy}(T... reified)` with `@SafeVarargs` [(#2866)](https://togithub.com/mockito/mockito/pull/2866) - Make sure the tests use mock maker with intended member accessor [(#2855)](https://togithub.com/mockito/mockito/issues/2855) - Improve examples for InOrder [(#2843)](https://togithub.com/mockito/mockito/pull/2843) ### [`v5.0.0`](https://togithub.com/mockito/mockito/releases/tag/v5.0.0) ### Mockito 5: prepare for future JDK versions For a while now, we have seen an increase in problems/incompatibilities with recent versions of the JDK due to our usage of JVM-internal API. Most notably, JDK 17 made some changes which are incompatible with the current subclass mockmaker. Therefore, to prepare for the future of JDK, we are making some core changes to ensure Mockito keeps on working. #### Switch the default mockmaker to `mockito-inline` Back in Mockito 2.7.6, we published a new mockmaker based on the "inline bytecode" principle. This mockmaker creates mocks manipulating bytecode equivalent within the original class such that its method implementations hook into the normal Mockito machinery. As a comparison, the subclass mockmaker generates "real" subclasses for mocks, to mimic the same behavior. While the approaches are similar, the inline mockmaker avoids certain restrictions that the JDK imposes. For example, it does not violate module boundaries (introduced in JDK 9, but more heavily used in JDK 17) and avoids the leaking of the creation of the subclass. Massive thanks to community member [@reta](https://togithub.com/reta) who implemented this change. Note: this does not affect `mockito-android` nor testing on Android. ##### When should I still be using the subclass mockmaker? There are legitimate remaining use cases for the subclass mockmaker. For example, on the Graal VM's native image, the inline mockmaker will not work and the subclass mockmaker is the appropriate choice. Additionally, if you would like to avoid mocking final classes, using the subclass mockmaker is a possibibility. Note however that if you solely want to use the subclass mockmaker to avoid mocking final, you will run into the above mentioned issues on JDK 17+. We want to leave this choice up to our users, which is why we will keep on supporting the subclass mockmaker. If you want to use the subclass mockmaker instead, you can use the new `mockito-subclass` artifact (published [on Maven Central](https://search.maven.org/artifact/org.mockito/mockito-subclass) along with all our other artifacts). #### Update the minimum supported Java version to 11 Mockito 4 supports Java 8 and above. Similar to other open source projects, we are moving away from JDK 8 and to newer versions. The primary reason for moving away from JDK 8 is the increasing maintenance costs with keeping our own infrastructure working. Lately we have been running into more and more JDK 8 breakages. Additionally, while we want to support the newest JDK API's, our current solution to support both JDK 8 and newer versions causes [issues with the `SecurityManager`](https://togithub.com/mockito/mockito/issues/2798). Since we want Mockito to work on the newest version and more and more businesses adopting JDK 11, we have decided to make the switch as well. Massive thanks to community member [@reta](https://togithub.com/reta) who implemented this change. ##### What should I do if I still run JDK 8? For JDK 8 and below, you can keep on using Mockito 4. This is similar to if you are using JDK 6, for which you can keep on using Mockito 2. The changes in Mockito 5 (for now) are primarily focused on the latest JDK versions, which means the API differences between Mockito 4 and 5 are minimal. However, over time this will most likely widen, so we do recommend adopting JDK 11 in the future. #### New `type()` method on `ArgumentMatcher` One of our most used public API's for customizing Mockito is the [`ArgumentMatcher` interface](https://javadoc.io/doc/org.mockito/mockito-core/latest/org/mockito/ArgumentMatcher.html). The interface allows you to define a custom matcher, which you can pass into method arguments to provide more targeted matches. One major shortcoming of the `ArgumentMatcher` was the lack of varargs support. There were many, many issues filed related to varargs and Mockito unable to handle them. Community member [@big-andy-coates](https://togithub.com/big-andy-coates) put in a lot of effort to come up with an appropriate solution, including fully implementing and comparing 2 approaches. Ultimately, we decided that introducing a new `type()` method on `ArgumentMatcher` is the best solution. As a result, it is now possible to update your custom matchers to implement varargs support, if you so desire. Note that `ArgumentMatcher` is still a `@FunctionalInterface` and can therefore still be written as a lambda. Massive thanks to community member [@big-andy-coates](https://togithub.com/big-andy-coates) who implemented this change. ##### What is the effect of this new method? For varargs methods, there was previously a way to only match zero arguments, or two or more arguments, by using the exact number of matchers, i.e. ```java long call(String... args); // Will match calls with exactly zero arguments: when(mock.call()).thenReturn(0L); // Will match calls with exactly two arguments: when(mock.call(any(), any())).thenReturn(0L); ``` But following the pattern to match exactly one argument: ```java when(mock.call(any())).thenReturn(0L); ``` doesn't work, as `any` is "vararg aware", so Mockito matched the `any` against *each element* of the varargs parameter, meaning it will match any number of arguments, i.e. the above would of matched all of these: ```java mock.call(); mock.call("a"); mock.call("a", "b"); ``` With the new `type` method, it's now possible to differentiate matching calls with any exact number of arguments, or to match any number of arguments. ```java // Match any number of arguments: when(mock.call(any(String[].class))).thenReturn(1L); // Match invocations with no arguments: when(mock.call()).thenReturn(1L); // Match invocations with exactly one argument: when(mock.call(any())).thenReturn(1L); // Alternative to match invocations with exactly one argument: when(mock.call(any(String.class))).thenReturn(1L); // Match invocations with exactly two arguments: when(mock.call(any(), any())).thenReturn(1L); ``` Therefore, if you want to match 0 or more arguments, use `any(String[].class)`. If you want to match an exact number of arguments, use `any(String.class)` (and specify as many `any` matchers as arguments you want to match on). In a similar fashion, the behavior of `ArgumentCaptor.forClass` has changed as well. If you want to capture all arguments, use an `ArgumentCaptor` for `String[]`, otherwise `String`: ```java // Will capture 1 string @Captor private ArgumentCaptorConfiguration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR has been generated by Mend Renovate. View repository job log here.