# pytest.raises

*noun*

say it: **“PY-test dot RAY-ziz”** **/ˈpaɪtɛst dɑt ˈreɪzɪz/**

A pytest tool, used in a with block, that makes a test pass only when the code inside it raises the error you name.

## What does **pytest.raises** do?

**pytest.raises** checks that code raises an error. Put the call inside `with pytest.raises(...)`: the test passes only
if that error is raised, and `match=` can check its message.

```python
import pytest

def test_negative_weight_is_refused():
    with pytest.raises(ValueError, match="weight"):
        shipping_cost(-2)
```

## In a sentence

- “The test uses **pytest.raises** to prove a negative weight is refused.”
- “Without **pytest.raises**, the ValueError would fail the test instead of passing it.”

Level: Journeyman · [More Python terms at this level](https://www.ask-codey.com/glossary?category=python&level=3)

Updated: November 19, 2026

Source: https://www.ask-codey.com/glossary/pytest-raises
