aloe

Aloe

A Gherkin runner for Python based on Nose and Lettuce.

Install:

pip install aloe

Read the documentation.

Invocation

Pass the --with-gherkin argument to nosetests to run your BDD tests. You may also pass the --no-ignore-python argument to run other nose discovered tests as well.

The aloe command line tool is a wrapper for the nose runner, configured to only run Gherkin tests. As such, the invocation is the same as nose, but the following parameters are added:

• -n N[,N...] - only run the specified scenarios (by number, 1-based) in each feature. Makes sense when only specifying one feature to run, for example

  aloe features/calculator.feature -n 1

• --test-class - override the class used as a base for each feature.

• --no-ignore-python - run Python tests as well as Gherkin.

Migrating from Lettuce

Aloe, started as a fork of Lettuce, tries to be compatible where it makes sense. However, there are following incompatible changes:

• each_scenario and each_background callbacks are removed. Use each_example.
• -s option for running particular scenarios is renamed to -n.
• Django-related functionality, including the harvest command, is moved to a separate project, Aloe-Django.
• terrain.py has no particular significance. It will be imported but only if it exists at the same directory with the other step definition files, and not above it.
• Scenario outlines must be declared with "Scenario Outline", and scenarios without examples must use "Scenario" - Lettuce allowed using either.
• By default, the steps run are output as dots, corresponding to Lettuce verbosity 1. To get colored output with steps printed as they run, use -v 3.

License

Aloe - Cucumber runner for Python based on Lettuce and Nose

Copyright (C) <2015> Alexey Kotlyarov [e-mail]

Copyright (C) <2014-2015> Danielle Madeley [e-mail]

Copyright (C) <2010-2012> Gabriel Falcão [e-mail]

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.