Mockito is a spying framework originally based on the Java library with the same name. (Actually we invented the strict stubbing mode back in 2009.)
pip install mockito
90% use case is that you want to stub out a side effect.
from mockito import when, mock, unstub
when(os.path).exists('/foo').thenReturn(True)
# or:
import requests # the famous library
# you actually want to return a Response-like obj, we'll fake it
response = mock({'status_code': 200, 'text': 'Ok'})
when(requests).get(...).thenReturn(response)
# use it
requests.get('http://google.com/')
# clean up
unstub()
http://mockito-python.readthedocs.io/en/latest/
Two functions have been renamed:
- verifyNoMoreInteractions is deprecated. Use ensureNoUnverifiedInteractions instead.
Although verifyNoMoreInteractions is the name used in mockito for Java, it is a misnomer over there too (imo). Its docs say "Checks if any of given mocks has any unverified interaction.", and we make that clear now in the name of the function, so you don't need the docs to tell you what it does.
- verifyNoUnwantedInteractions is deprecated. Use verifyExpectedInteractions instead.
The new name should make it clear that it corresponds to the usage of expect (as alternative to when).
Context managers now check the usage and any expectations (if you used expect) on exit. You can disable this check by setting the environment variable MOCKITO_CONTEXT_MANAGERS_CHECK_USAGE to "0". Note that this does not disable the check for any explicit expectations you might have set with expect.
This roughly corresponds to the verifyStubbedInvocationsAreUsed contra the verifyExpectedInteractions functions.
- between now supports open ranges, e.g. between=(0, ) to check that at least 0 interactions occurred.
I use uv, and if you do too: you just clone this repo
to your computer, then run uv sync in the root directory. Example usage:
uv run pytest