How To Fail The Step Explicitly In Behave Step Implementation

I want to explicitly fail the step in behave when I encounter an exception eg. I am writing the code according to behave documentation - from behave import * @when('verify test f

Solution 1:

context.failed is only an attribute set by Behave and doesn't do anything as is. It's an information attribute, and while you can use it to determine a fail-case and throw an assertion error, it will not do anything on it's own. See context.failed

As for the fail method you've mentioned, it is probably from the unittest module, as seen here. This module is used in Behave's development tests (see their Github) as well. I'll agree though, that this should be clarified in their documentation.

To fix your error you'd need to import the unittest module. To explicitly fail the step, you'd just raise the exception after you've logged your message, something like this:

except Exception as e:
    logger.error("arrived at exception: "+str(e))
    fail("failed with exception: "+str(e))
    raise

Solution 2:

As @Verv mentioned in their answer, a behave step will be marked as failed whenever an exception is thrown, so you could just re-raise the exception.

However, behave will show the backtrace for normal exceptions, whereas you probably just want to show a specific failure message.

For that, raise an AssertionError. In your code, that would look like this:

except Exception as e:
  logger.error("arrived at exception: " + str(e))
  raise AssertionError("failed with exception: " + str(e))

If behave encounters an AssertionError, it will fail the step, display the message you instantiate the error with, but not display other exception stuff.