Test::BDD::Cucumber::Executor - Run through Feature and Harness objects
version 0.15
The Executor runs through Features, matching up the Step Lines with Step Definitions, and reporting on progress through the passed-in harness.
The attributes steps is a hashref of arrayrefs, storing steps by their Verb. add_steps() takes step definitions of the item list form:
steps
add_steps()
( [ Given => qr//, sub {} ], ),
and populates steps with them.
Execute accepts a feature object, a harness object, and an optional Test::BDD::Cucumber::TagSpec object and for each scenario in the feature which meets the tag requirements (or all of them, if you haven't specified one), runs execute_scenario.
execute_scenario
Accepts a hashref of options, and executes each step in a scenario. Options:
feature - A Test::BDD::Cucumber::Model::Feature object
feature
feature_stash - A hashref that should live the lifetime of feature execution
feature_stash
harness - A Test::BDD::Cucumber::Harness subclass object
harness
scenario - A Test::BDD::Cucumber::Model::Scenario object
scenario
background_obj - An optional Test::BDD::Cucumber::Model::Scenario object representing the Background
background_obj
scenario_stash - We'll create a new scenario stash unless you've posted one in. This is used exclusively for giving Background sections access to the same stash as the scenario they're running before.
scenario_stash
For each step, a Test::BDD::Cucumber::StepContext object is created, and passed to dispatch(). Nothing is returned - everything is played back through the Harness interface.
dispatch()
Accepts a text string and a hashref, and replaces <placeholders > with the values in the hashref, returning a string.
<placeholders
Accepts a Test::BDD::Cucumber::StepContext object, and searches through the steps that have been added to the executor object, executing against the first matching one.
You can also pass in a boolean 'short-circuit' flag if the Scenario's remaining steps should be skipped.
Accepts a step-context, a result-type, and a textual reason, exercises the Harness's step start and step_done methods, and returns a skipped-test result.
Peter Sergeant pete@clueball.com
pete@clueball.com
Copyright 2011, Peter Sergeant; Licensed under the same terms as Perl
To install Test::BDD::Cucumber, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Test::BDD::Cucumber
CPAN shell
perl -MCPAN -e shell install Test::BDD::Cucumber
For more information on module installation, please visit the detailed CPAN module installation guide.