Python mock requests.post to throw exception

Question

Using Python 3.5, requests==2.18.4, Flask==0.12.2, urllib3==1.22

I have a method some_method in my main server.py file, that is supposed to make a POST to some url with some data:

def some_method(url, data):
    ...
    error = None
    try:
        response = requests.post(url, json=data)
    except requests.exceptions.ConnectionError as e:
        ...
        app.logger.error(...)
        response = None
        error = str(e)
    return error, response

The server file defines: app = Flask(__name__) , and some_method is called from @app.route(... methods=['PATCH']) .
If this method throws an error, the route will eventually return a 500 .

Tests are run from a test file importing the app with import server and app = server.app , using unittest , and importing mock.patch .

I am able to test the overall app behavior, with a test that shows that the app route behave as expected when the method returns an error and seeing that the route terminates at the right spot:

class ServerTestCase(unittest.TestCase):
    ...
    @patch('server.some_method')
    def test_route_response_status_500_when_throws(self, mock_response):
        mock_response.return_value = 'some_error_string', None
        response = self.app.patch(some_url, some_data, content_type='application/json')
        self.assertEqual(response.status_code, 500)

However, I would really like to have another test to test some_method in isolation:

1. Mock requests.post to throw requests.exceptions.ConnectionError
2. Show that the method logs an error (I know I can mock my app.logger and assert that it logged during the execution)

Answer 1

Mock the requests.post function, and on the mock set the side_effect attribute to the desired exception:

@patch('requests.post')
def test_request_post_exception(self, post_mock):
    post_mock.side_effect = requests.exceptions.ConnectionError()
    # run your test, code calling `requests.post()` will trigger the exception.

From the linked documentation:

This can either be a function to be called when the mock is called, an iterable or an exception (class or instance) to be raised.

[...]

An example of a mock that raises an exception (to test exception handling of an API):

 >>> mock = Mock() >>> mock.side_effect = Exception('Boom!') >>> mock() Traceback (most recent call last): ... Exception: Boom!

(Bold emphasis mine).

This is also covered in the Quick Guide section :

side_effect allows you to perform side effects, including raising an exception when a mock is called:

 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'