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
3 Jan 11, 2022
13 Apr 15, 2022
941 Jan 03, 2023
1 Feb 19, 2022
270 Dec 20, 2022
1 Dec 24, 2021
7 Oct 27, 2022
3 Sep 22, 2022
2 Nov 09, 2021
614 Dec 30, 2022
4 Nov 20, 2022
191 Dec 21, 2022
27 Jan 07, 2023
170 Dec 02, 2022
75 Dec 19, 2022
1.7k Dec 27, 2022
15 Sep 14, 2022
4 Dec 11, 2019
209 Dec 20, 2022