Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mockito/mockito

Most popular Mocking framework for unit tests written in Java
https://github.com/mockito/mockito

java java-library mock mock-library mocking mocking-framework mockito mocks test-automation test-driven-development testing testing-tools

Last synced: 7 days ago
JSON representation

Most popular Mocking framework for unit tests written in Java

Awesome Lists containing this project

README 

        


Mockito




Most popular mocking framework for Java



[![CI](https://github.com/mockito/mockito/workflows/CI/badge.svg)](https://github.com/mockito/mockito/actions?query=workflow%3ACI)

[![Coverage Status](https://img.shields.io/codecov/c/github/mockito/mockito.svg)](https://codecov.io/github/mockito/mockito)

[![MIT License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/mockito/mockito/blob/main/LICENSE)



[![Release Notes](https://img.shields.io/badge/release%20notes-5.x-yellow.svg)](https://github.com/mockito/mockito/releases/)

[![Maven Central](https://img.shields.io/maven-central/v/org.mockito/mockito-core.svg)](https://search.maven.org/artifact/org.mockito/mockito-core/)

[![Javadoc](https://www.javadoc.io/badge/org.mockito/mockito-core.svg)](https://www.javadoc.io/doc/org.mockito/mockito-core)



## Current version is 5.x

Still on Mockito 1.x? See [what's new](https://github.com/mockito/mockito/wiki/What%27s-new-in-Mockito-2) in Mockito 2!

[Mockito 3](https://github.com/mockito/mockito/releases/tag/v3.0.0) does not introduce any breaking API changes, but now requires Java 8 over Java 6 for Mockito 2.

[Mockito 4](https://github.com/mockito/mockito/releases/tag/v4.0.0) removes deprecated API.

[Mockito 5](https://github.com/mockito/mockito/releases/tag/v5.0.0) switches the default mockmaker to mockito-inline, and now requires Java 11.

Only one major version is supported at a time, and changes are not backported to older versions.



## Mockito for enterprise



Available as part of the [Tidelift](https://tidelift.com/subscription/pkg/maven-org-mockito-mockito-core) Subscription.



The maintainers of org.mockito:mockito-core and thousands of other packages are working with Tidelift to deliver

commercial support and maintenance for the open source dependencies you use to build your applications. Save time,

reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use.

[Learn more.](https://tidelift.com/subscription/pkg/maven-org-mockito-mockito-core?utm_source=maven-org-mockito-mockito-core&utm_medium=referral&utm_campaign=enterprise&utm_term=repo)



## Development



Mockito publishes every change as a `-SNAPSHOT` version to a public Sonatype repository. Roughly once a month, we

publish a new minor or patch version to Maven Central. For release automation we use

[Shipkit library](http://shipkit.org), [Gradle Nexus Publish Plugin](https://github.com/gradle-nexus/publish-plugin).

Fully automated releases are awesome, and you should do that for your libraries, too!

See the [latest release notes](https://github.com/mockito/mockito/releases/)

and [latest documentation](https://javadoc.io/page/org.mockito/mockito-core/latest/org/mockito/Mockito.html). Docs in

javadoc.io are available 24h after release. Read also

about [semantic versioning in Mockito](https://github.com/mockito/mockito/wiki/Semantic-Versioning).



Older 1.x and 2.x releases are available in

[Central Repository](https://search.maven.org/artifact/org.mockito/mockito-core/1.10.19/jar)

and [javadoc.io](https://javadoc.io/doc/org.mockito/mockito-core/1.10.19/org/mockito/Mockito.html) (documentation).



## More information



All you want to know about Mockito is hosted at [The Mockito Site](https://site.mockito.org) which is [Open Source](https://github.com/mockito/mockito.github.io) and likes [pull requests](https://github.com/mockito/mockito.github.io/pulls), too.



Want to contribute? Take a look at the [Contributing Guide](https://github.com/mockito/mockito/blob/main/.github/CONTRIBUTING.md).



Enjoy Mockito!



## Need help?



* Search / Ask question on [stackoverflow](https://stackoverflow.com/questions/tagged/mockito)

* Go to the [mockito mailing-list](https://groups.google.com/group/mockito) (moderated)

* Open a ticket in GitHub [issue tracker](https://github.com/mockito/mockito/issues)



## How to develop Mockito?



To build locally:



```shell

./gradlew build

```

You can open in any IDE that support Gradle, e.g. IntelliJ IDEA, or Fleet.

For Eclipse, one may need to run `./gradlew eclipse` before importing the project.



## How to release new version?



1. Every change on the main development branch is released as `-SNAPSHOT` version to Sonatype snapshot repo

   at https://s01.oss.sonatype.org/content/repositories/snapshots/org/mockito/mockito-core.

2. To release a non-snapshot version to Maven Central push an annotated tag, for example:



    ```shell

    git tag -a -m "Release 3.4.5" v3.4.5

    git push origin v3.4.5

    ```



3. At the moment, you **may not create releases from GitHub Web UI**. Doing so will make the CI build fail because the

   CI creates the changelog and posts to GitHub releases. We'll support this in the future.