def xfail(reason="<STR_LIT>"):
__tracebackhide__ = True<EOL>raise XFailed(reason)<EOL>
Imperatively xfail an executing test or setup functions with the given reason.

This function should be called only during testing (setup, call or teardown).

.. note::
    It is better to use the :ref:`pytest.mark.xfail ref` marker when possible to declare a test to be
    xfailed under certain conditions like known bugs or missing features.