Testing with external services in PyTest - Test Execution Trace

Test Overview

This test checks if our code correctly fetches user data from an external API and verifies the response contains expected user information.

Test Code - pytest

PyTest

import requests
import pytest

def fetch_user(user_id):
    response = requests.get(f"https://jsonplaceholder.typicode.com/users/{user_id}")
    response.raise_for_status()
    return response.json()


def test_fetch_user():
    user = fetch_user(1)
    assert user["id"] == 1
    assert "name" in user
    assert user["email"].endswith(".biz")

Execution Trace - 8 Steps

Step	Action	System State	Assertion	Result
1	Test starts	Test runner initialized, no tests executed yet	—	PASS
2	Calls fetch_user(1) which sends GET request to https://jsonplaceholder.typicode.com/users/1	HTTP request sent to external API	—	PASS
3	Receives HTTP 200 response with user JSON data	Response contains user data with id=1, name, email, etc.	—	PASS
4	Parses JSON response and returns user dictionary	User data available as Python dict	—	PASS
5	Asserts user["id"] == 1	User id is 1	Check user id matches requested id	PASS
6	Asserts "name" key exists in user dictionary	User data includes name field	Verify user has a name	PASS
7	Asserts user["email"] ends with '.biz'	User email is a string ending with '.biz'	Check email domain suffix	FAIL
8	Test completes successfully	All assertions passed, test finished	—	PASS

Failure Scenario

Failing Condition: External API is down or returns error status

Execution Trace Quiz - 3 Questions

What does the test verify about the user data?

A User id is 2 and email ends with '.com'

B User id is 1, name exists, and email ends with '.biz'

C User has a phone number and address

D User data is empty

Key Result

When testing code that calls external services, it is best to mock those calls to avoid flaky tests caused by network issues or service downtime.

Practice

1. What is the main reason to use mocking when testing with external services in pytest?

easy

A. To avoid calling the real external service and make tests faster

B. To increase the number of real API calls during testing

C. To make tests dependent on internet speed

D. To test the external service itself

Solution

1. Step 1: Understand the role of mocking in tests

   Mocking replaces real external calls with fake ones to avoid delays and failures.

2. Step 2: Identify the benefit of mocking external services

   Mocking makes tests faster and more reliable by not depending on real services.

3. Final Answer:

   To avoid calling the real external service and make tests faster -> Option A

4. Quick Check:

   Mocking speeds up tests by faking external calls [OK]

Hint: Mock external calls to speed tests and avoid failures [OK]

Common Mistakes:

• Thinking mocking increases real API calls
• Believing tests should depend on internet speed
• Confusing testing external service with testing your code

2. Which of the following is the correct way to mock a function get_data from module external_api using pytest's patch decorator?

easy

A. @patch('external_api.get_data')

B. @patch('get_data.external_api')

C. @patch('external_api->get_data')

D. @patch('external_api.getData')

Solution

1. Step 1: Recall correct patch syntax

   The patch decorator requires the full import path as a string: 'module.function'.

2. Step 2: Match the correct option

   @patch('external_api.get_data') uses 'external_api.get_data' which is the correct format and case-sensitive.

3. Final Answer:

   @patch('external_api.get_data') -> Option A

4. Quick Check:

   patch('module.function') syntax is correct [OK]

Hint: Use 'module.function' string in patch decorator [OK]

Common Mistakes:

• Swapping module and function order
• Using wrong separators like '->'
• Incorrect function name casing

3. Given the following pytest test code, what will be the output when running the test?

from unittest.mock import patch
import requests

def fetch_status():
    response = requests.get('https://api.example.com/data')
    return response.status_code

@patch('requests.get')
def test_fetch_status(mock_get):
    mock_get.return_value.status_code = 200
    assert fetch_status() == 200
    print('Test passed')

medium

A. TypeError

B. AssertionError

C. Test passed

D. No output

Solution

1. Step 1: Understand mocking effect on requests.get

   The patch replaces requests.get with a mock that returns an object with status_code 200.

2. Step 2: Check assertion and print statement

   fetch_status() returns 200, matching the assertion, so 'Test passed' is printed.

3. Final Answer:

   Test passed -> Option C

4. Quick Check:

   Mocked return_value.status_code = 200 makes test pass [OK]

Hint: Mock return_value to control function output [OK]

Common Mistakes:

• Forgetting to set return_value.status_code
• Expecting real HTTP call instead of mock
• Missing print output due to assertion failure

4. Identify the error in the following pytest test that mocks an external service call:

from unittest.mock import patch
import myservice

@patch('myservice.call_api')
def test_api(mock_call):
    mock_call.return_value = {'status': 'ok'}
    result = myservice.call_api()
    assert result.status == 'ok'

medium

A. The patch decorator is missing parentheses

B. The assertion should use result['status'] instead of result.status

C. mock_call.return_value should be a string, not a dict

D. The test function is missing a return statement

Solution

1. Step 1: Analyze the mocked return value type

   The mock returns a dictionary {'status': 'ok'}, so result is a dict.

2. Step 2: Check the assertion syntax

   Accessing dict keys requires bracket notation, not dot notation; result.status causes AttributeError.

3. Final Answer:

   The assertion should use result['status'] instead of result.status -> Option B

4. Quick Check:

   Dict keys need brackets, not dot notation [OK]

Hint: Use brackets for dict keys in assertions [OK]

Common Mistakes:

• Using dot notation on dicts
• Forgetting parentheses in patch decorator (not here)
• Expecting return_value must be string always

5. You want to test a function process_data() that calls an external API fetch_data(). The API sometimes returns null. How should you mock fetch_data in pytest to test process_data handles null correctly?

hard

A. Do not mock fetch_data; test process_data only with real data

B. Call the real fetch_data to see if it returns null

C. Mock fetch_data to always raise an exception

D. Use patch to make fetch_data return null and assert process_data handles it

Solution

1. Step 1: Understand the need to test null handling

   Since fetch_data can return null, tests must simulate this to check process_data behavior.

2. Step 2: Use patch to mock fetch_data returning null

   Mocking fetch_data to return null allows controlled testing of process_data's handling of that case.

3. Final Answer:

   Use patch to make fetch_data return null and assert process_data handles it -> Option D

4. Quick Check:

   Mock null return to test edge case handling [OK]

Hint: Mock edge cases like null to test error handling [OK]

Common Mistakes:

• Calling real external API in tests
• Mocking only success cases, ignoring null
• Ignoring exceptions instead of testing them