unittest-mocker
Inspired by the pytest-mock, but written from scratch for using with unittest and convenient tool - patch_class
Installation
pip install unittest-mocker
Usage
General mocker
@activate_mocker
def test_create_client(self, mocker: Mocker):
post_mock = mocker.patch('requests.post')
post_mock.return_value.status_code = 200
post_mock.return_value.json.return_value = {'msg': done}
send_clients_to_crm()
post_mock.assert_called_once_with(...)
or you can put the mocking logic in a separate method:
def mock_post(mocker, status):
response = requests.Response()
response.status_code = status
response.headers = {'Location': '...'}
response._content = 'some content'
return mocker.patch('requests.post', return_value=response)
@activate_mocker
def test_upload_post_success(mocker):
mocked_post = mock_post(mocker, 201)
...
@activate_mocker
def test_upload_post_error(mocker):
mocked_post = mock_post(mocker, 500)
...
Details
mocker.patch under the hood calls unittest.mock.patch So you can apply any arguments of the standard mock library
The same with mocker.patch.object. It has the same parameters asunittest.mock.patch.object
Method patch_class
Basic usage:
from unittest_mocker import activate_mocker, Mocker
from api import ApiClient
@activate_mocker
def test_api_client(self, mocker: Mocker):
client_mock = mocker.patch_class('api.ApiClient')
ApiClient(url='example.com')(command='start')
client_mock.assert_initialized_with(url='example.com')
client_mock.mocks['__call__'].assert_called_once_with(command='start')
Syntax
# Variant 1
mocker.patch_class(target: str, methods=Optional[list[str]])
# Example:
mock = mocker.patch_class('some_module.SomeClass', methods=['method_1', 'method_2'])
# Variant 2
mocker.patch_class.object(target: Union[module, class], attribute: str, methods=Optional[list[str]])
# Example:
import some_module
mock = mocker.patch_class(some_module, 'SomeClass', methods=['method_1', 'method_2'])
All mocked methods are stored in mock.mocks dictionary and can be accessed:
mock.mocks['__init__'].assert_called_once_with(...)
patch_class always patches class's __init__ method.
Also, methods parameter also defaults to [__call__]. So that's correct:
mock = mocker.patch_class('some_module.SomeClass')
...
mock.mocks['__call__'].assert_called_once_with(...)
Helper assert_initialized_with
mock.assert_initialized_with() is just shortcut for mock.mocks['__init__'].assert_called_once_with()
14 Dec 6, 2022
1 Nov 17, 2022
12 Dec 26, 2022
3.2k Dec 31, 2022
3.8k Jan 3, 2023
909 Dec 15, 2022
7.8k Jan 2, 2023
19 Sep 10, 2022
129 Nov 28, 2022
2 Jun 30, 2022
12 Dec 04, 2022
9.6k Jan 02, 2023
122 Nov 22, 2022
39 Jan 06, 2023
14.9k Jan 07, 2023
2 Dec 21, 2021
8 Mar 13, 2022
4 Aug 26, 2022
1 Nov 08, 2021
1 Dec 01, 2021
1 Dec 01, 2021
6 Dec 14, 2022
4 Jan 09, 2022
1 Jul 11, 2022
1.4k Dec 12, 2022
2k Jan 06, 2023