Function fail

src/_pytest/outcomes.py:179–196

Explicitly fail an executing test with the given message. :param reason: The message to show the user as reason for the failure. :param pytrace: If False, msg represents the full failure information and no python traceback will be reported. :param msg:

(
    reason: str = "", pytrace: bool = True, msg: Optional[str] = None
)

@_with_exception(Failed)
def fail(
    reason: str = "", pytrace: bool = True, msg: Optional[str] = None
) -> "NoReturn":
    """Explicitly fail an executing test with the given message.

    :param reason:
        The message to show the user as reason for the failure.

    :param pytrace:
        If False, msg represents the full failure information and no
        python traceback will be reported.

    :param msg:
        Same as ``reason``, but deprecated. Will be removed in a future version, use ``reason`` instead.
    """
    __tracebackhide__ = True
    reason = _resolve_msg_to_reason("fail", reason, msg)
    raise Failed(msg=reason, pytrace=pytrace)


def _resolve_msg_to_reason(