https://github.com/mockito/mockito-testng
Mockito TestNG support
https://github.com/mockito/mockito-testng
mocking mockito testng
Last synced: 6 months ago
JSON representation
Mockito TestNG support
- Host: GitHub
- URL: https://github.com/mockito/mockito-testng
- Owner: mockito
- License: mit
- Created: 2018-08-01T02:42:16.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-03-20T05:50:30.000Z (8 months ago)
- Last Synced: 2025-05-07T19:09:24.314Z (6 months ago)
- Topics: mocking, mockito, testng
- Language: Java
- Homepage:
- Size: 265 KB
- Stars: 16
- Watchers: 2
- Forks: 10
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Mockito for TestNG
Mockito utility classes for easy integration with TestNG
[](https://github.com/mockito/mockito-testng/actions?query=workflow%3ACI)
[](https://search.maven.org/artifact/org.mockito/mockito-testng/)
## Installation
### Gradle
```Gradle
dependencies {
testCompile "org.mockito:mockito-testng:VERSION"
}
```
### Maven
```xml
org.mockito
mockito-testng
VERSION
test
```
For latest version, see the [releases](https://github.com/mockito/mockito-testng/releases).
## Usage
Simply add `@Listeners` annotation on your test class
```java
import org.mockito.InjectMocks;
import org.mockito.Mock;
import org.mockito.testng.MockitoTestNGListener;
import org.testng.annotations.Listeners;
import org.testng.annotations.Test;
import java.util.Map;
@Listeners(MockitoTestNGListener.class)
public class MyTest {
@Mock
Map map;
@InjectMocks
SomeType someType;
@Test
void test() {
// ...
}
}
```
`MockitoTestNGListener` will do job for you and initialize all fields annotated with mockito annotations.
By default `MockitoSession` is started with `STRICT_STUBS`.
You can change this behavior by adding `@MockitoSettings` to your test class.
```java
import org.mockito.quality.Strictness;
import org.mockito.testng.MockitoTestNGListener;
import org.mockito.testng.MockitoSettings;
import org.testng.annotations.Listeners;
@Listeners(MockitoTestNGListener.class)
@MockitoSettings(strictness = Strictness.WARN)
public class MyTest {
// ...
}
```
## Notices
- `MockitoSession` is started before each `test method` or before method annotated with `@BeforeMethod`,
another annotations `@BeforeXXX` aren't supported #40
## Developing
- open in IDEA to develop or run ```./gradlew idea``` and then open in IDEA
- ```./gradlew build``` - tests code and assembles artifacts
- ```./gradlew publishToMavenLocal``` - publishes to local Maven repo, useful for local testing
## Releasing
Every merged pull request is published to Maven Central.
Actually, any change on master that happily builds on CI is published.
The release automation uses Shipkit framework (http://shipkit.org).
## History
The original TestNGListener was a part of the core Mockito repository. However, the jar was never released. Core Mockito team does not work with TestNG so it was hard for us to maintain TestNG integration. In Summer 2018 we moved the TestNG integration to a separate repository under "Mockito" organization.
## Help
We are looking for maintainers of TestNG integration! Let us know if you want to join. Mockito core team has limited capacity and focuses on the core library.