Method matches

src/_pytest/raises.py:631–664

Check if an exception matches the requirements of this :class:`RaisesExc`. If it fails, :attr:`RaisesExc.fail_reason` will be set. Examples:: assert RaisesExc(ValueError).matches(my_exception): # is equivalent to assert isinstance(my_exception, V

(
        self,
        exception: BaseException | None,
    )

        self._just_propagate = False

    def matches(
        self,
        exception: BaseException | None,
    ) -> TypeGuard[BaseExcT_co_default]:
        class="st">"""Check if an exception matches the requirements of this :class:`RaisesExc`.
        If it fails, :attr:`RaisesExc.fail_reason` will be set.

        Examples::

            assert RaisesExc(ValueError).matches(my_exception):
            class="cm"># is equivalent to
            assert isinstance(my_exception, ValueError)

            class="cm"># this can be useful when checking e.g. the ``__cause__`` of an exception.
            with pytest.raises(ValueError) as excinfo:
                ...
            assert RaisesExc(SyntaxError, match=class="st">"foo").matches(excinfo.value.__cause__)
            class="cm"># above line is equivalent to
            assert isinstance(excinfo.value.__cause__, SyntaxError)
            assert re.search(class="st">"foo", str(excinfo.value.__cause__)

        class="st">"""
        self._just_propagate = False
        if exception is None:
            self._fail_reason = class="st">"exception is None"
            return False
        if not self._check_type(exception):
            self._just_propagate = True
            return False

        if not self._check_match(exception):
            return False

        return self._check_check(exception)

    def __repr__(self) -> str:
        parameters = []