Asserting exceptions (pytest.raises) - Cheat Sheet & Quick Revision

Recall & Review

beginner

What is the purpose of pytest.raises in testing?

pytest.raises is used to check if a specific exception is raised during a test. It helps verify that your code correctly handles error cases.

beginner

How do you use pytest.raises as a context manager?

You wrap the code that should raise an exception inside a with pytest.raises(ExceptionType): block. If the exception occurs, the test passes; if not, it fails.

beginner

Example: Write a test that checks if ValueError is raised when converting 'abc' to int.

<pre>import pytest

def test_value_error():
    with pytest.raises(ValueError):
        int('abc')</pre>

beginner

What happens if the expected exception is not raised inside pytest.raises block?

The test will fail because pytest.raises expects the specified exception to occur. Not raising it means the code did not behave as expected.

intermediate

Can you capture the exception object using pytest.raises? How?

<p>Yes. Use <code>as exc_info</code> to capture the exception object for further checks, like message content.</p><pre>import pytest

with pytest.raises(ValueError) as exc_info:
    int('abc')
assert 'invalid literal' in str(exc_info.value)</pre>

What does pytest.raises(ValueError) check in a test?

A That the test is skipped

B That no exceptions are raised

C That a ValueError exception is raised

D That the code runs without errors

pytest.raises(ValueError) expects a ValueError to be raised. If it is not, the test fails.

How do you write a test to check if a function raises an exception using pytest.raises?

A Call the function normally and catch exceptions manually

B Use <code>with pytest.raises(ExceptionType):</code> around the code

C Use <code>assertRaises</code> from unittest

D Use <code>try-except</code> without pytest

The recommended way in pytest is to use with pytest.raises(ExceptionType): as a context manager.

What happens if the expected exception is not raised inside the pytest.raises block?

A The test fails

B The test passes

C The test is skipped

D The test is marked as xfail

The test fails because the expected exception did not occur.

How can you check the message of an exception raised inside pytest.raises?

A Use <code>assertRaisesMessage</code>

B Use <code>print</code> inside the block

C You cannot check the message

D Capture the exception with <code>as exc_info</code> and check <code>exc_info.value</code>

Using as exc_info captures the exception object for message assertions.

Which of these is a correct use of pytest.raises?

A with pytest.raises(ValueError): int('abc')

B with pytest.raises(IndexError): [1,2,3][1]

C with pytest.raises(TypeError): int('123')

D with pytest.raises(KeyError): {'a':1}['a']

Only int('abc') raises a ValueError. The others do not raise the exceptions listed.

Explain how to use pytest.raises to test that a function raises an exception.

Think about wrapping the code that should fail inside a special block.

Describe how to capture and check the exception message using pytest.raises.

You can save the exception to a variable for more checks.

Practice

1. What is the main purpose of using pytest.raises in a test?

easy

A. To ignore exceptions and continue the test

B. To skip a test when an exception occurs

C. To print the exception message during test execution

D. To check if a specific exception is raised by the code inside the with block

Solution

1. Step 1: Understand the role of pytest.raises

   pytest.raises is used to verify that a certain exception is raised by the code inside its with block.

2. Step 2: Compare options with the purpose

   Only To check if a specific exception is raised by the code inside the with block correctly states that it checks for a specific exception. Other options describe unrelated behaviors.

3. Final Answer:

   To check if a specific exception is raised by the code inside the with block -> Option D

4. Quick Check:

   pytest.raises checks exceptions = A [OK]

Hint: Remember: pytest.raises confirms expected errors happen [OK]

Common Mistakes:

• Thinking pytest.raises skips tests
• Assuming it prints exceptions automatically
• Believing it ignores exceptions

2. Which of the following is the correct syntax to assert that a ValueError is raised when calling func() using pytest.raises?

easy

A. pytest.raises(ValueError, func())

B. with pytest.raises(ValueError): func()

C. with pytest.raises('ValueError'): func()

D. pytest.raises(ValueError): func()

Solution

1. Step 1: Recall correct pytest.raises syntax

   The correct way is to use a with statement with pytest.raises(ExceptionType): followed by the code that should raise the exception.

2. Step 2: Evaluate each option

   with pytest.raises(ValueError): func() uses the correct with block and exception type. pytest.raises(ValueError, func()) calls the function inside the argument, which runs before checking. with pytest.raises('ValueError'): func() uses a string instead of the exception class. pytest.raises(ValueError): func() misses the with keyword.

3. Final Answer:

   with pytest.raises(ValueError): func() -> Option B

4. Quick Check:

   Use with + pytest.raises(Exception): code [OK]

Hint: Always use 'with pytest.raises(Exception):' before the code [OK]

Common Mistakes:

• Calling the function inside pytest.raises() arguments
• Using exception name as string instead of class
• Omitting the 'with' keyword

3. What will be the output of the following test code?

import pytest

def test_zero_division():
    with pytest.raises(ZeroDivisionError) as exc_info:
        1 / 0
    assert 'division by zero' in str(exc_info.value)

medium

A. Test passes because ZeroDivisionError is raised and message matches

B. Test fails because exception message is not checked correctly

C. Test fails because ZeroDivisionError is not raised

D. SyntaxError due to incorrect use of pytest.raises

Solution

1. Step 1: Analyze the code behavior

   The code inside the with pytest.raises(ZeroDivisionError) as exc_info: block raises a ZeroDivisionError by dividing 1 by 0.

2. Step 2: Check the assertion

   The assertion verifies that the exception message contains 'division by zero', which is true for this error.

3. Final Answer:

   Test passes because ZeroDivisionError is raised and message matches -> Option A

4. Quick Check:

   Exception raised and message checked = D [OK]

Hint: Use exc_info.value to check exception message text [OK]

Common Mistakes:

• Not using 'as exc_info' to capture exception details
• Checking wrong exception message text
• Expecting no exception raised

4. Identify the error in this test code snippet:

def test_key_error():
    with pytest.raises(KeyError):
        d = {'a': 1}
        value = d['b']
    assert value == 1

medium

A. The variable 'value' is used outside the with block where it may not be assigned

B. The exception type should be ValueError, not KeyError

C. The dictionary key 'b' exists, so no exception is raised

D. pytest.raises cannot be used with dictionary lookups

Solution

1. Step 1: Understand variable scope and exception flow

   The line value = d['b'] raises a KeyError, so value is never assigned inside the with block.

2. Step 2: Identify the error in assertion

   After the with block, the code tries to assert value == 1, but value is undefined because the assignment never happened due to the exception.

3. Final Answer:

   The variable 'value' is used outside the with block where it may not be assigned -> Option A

4. Quick Check:

   Exception stops assignment, so variable undefined after [OK]

Hint: Don't use variables assigned inside exception blocks outside [OK]

Common Mistakes:

• Assuming variable is assigned despite exception
• Confusing exception types
• Thinking pytest.raises can't handle dict key errors

5. You want to test a function parse_int(s) that should raise ValueError with message containing 'invalid literal' when given a non-integer string. Which pytest code correctly asserts this behavior and checks the error message?

hard

A. with pytest.raises(ValueError):
parse_int('abc')
assert 'invalid literal' in e.value

B. pytest.raises(ValueError, parse_int('abc'))
assert 'invalid literal' in e.value

C. with pytest.raises(ValueError) as e:
parse_int('abc')
assert 'invalid literal' in str(e.value)

D. with pytest.raises('ValueError') as e:
parse_int('abc')
assert 'invalid literal' in str(e.value)

Solution

1. Step 1: Use correct syntax to capture exception info

   Use with pytest.raises(ValueError) as e: to catch the exception and store info in e.

2. Step 2: Check error message properly

   After the block, check if the string 'invalid literal' is in str(e.value). This converts the exception to string for message checking.

3. Step 3: Eliminate incorrect options

   with pytest.raises(ValueError): parse_int('abc') assert 'invalid literal' in e.value tries to use e outside the block without capturing it. pytest.raises(ValueError, parse_int('abc')) assert 'invalid literal' in e.value calls the function inside pytest.raises incorrectly and uses e undefined. with pytest.raises('ValueError') as e: parse_int('abc') assert 'invalid literal' in str(e.value) uses exception name as string instead of class.

4. Final Answer:

   with pytest.raises(ValueError) as e: parse_int('abc') assert 'invalid literal' in str(e.value) -> Option C

5. Quick Check:

   Capture exception with 'as' and check message string [OK]

Hint: Use 'as' to capture exception and check message with str(e.value) [OK]

Common Mistakes:

• Using exception name as string instead of class
• Calling function inside pytest.raises arguments
• Accessing exception info outside 'with' without 'as'