---
name: "Test::BDD::Cucumber"
section: "3pm"
platform: "linux"
package: "libtest-bdd-cucumber-perl"
version: "0.87-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Test::BDD::Cucumber"
---

# Test::BDD::Cucumber(3pm)

Feature-complete Cucumber-style testing in Perl

## NAME

Test::BDD::Cucumber - Feature-complete Cucumber-style testing in Perl

## VERSION

version 0.87

## SYNOPSIS

```
   # Driving tests using the 'pherkin' binary that comes with the distribution
   $ pherkin -l -b t/
   # Or choose a subset of tests to be run by selecting all scenarios tagged 'slow'
   $ pherkin -l -b --tags @slow t/
   # Or all those /not/ tagged 'slow'
   $ pherkin -l -b --tags ~@slow
   # Fail on missing steps (by default prints as orange output and succeeds tests)
   $ pherkin -l -b --strict t/
   # Driving tests using 'prove' integration
   $ prove --source Feature --ext=.feature examples/
   # Driving parallel tests using 'prove'
   $ prove -r --source Feature -j 9 --ext=.feature t/
```

## DESCRIPTION

Cucumber for Perl, integrated with Test2, Test::More and prove.

The implementation supports the following Gherkin keywords in feature files: `"Feature"`, `"Scenario"`, `"Scenario Outline"`, `"Examples"`, `"Given"`, `"When"`, `"Then"`, `"And"` and `"But"`. Additionally, `"Scenario"` can be used as a synonym for `"Scenario Outline"` (with `"Examples"`). This best maps to Gherkin version 6.0.13 \<https://github.com/cucumber/cucumber/blob/master/gherkin/CHANGELOG.md#6013---2018-09-25\>, but without support for its new `"Rule"` and `"Example"` keywords.

This implementation supports the same languages as Gherkin 15.0.0 - that is, it supports exactly the same translated keywords.

Behaviour of this module is similar to that, but sometimes different from the *real* Cucumber, the plan is to move use the same parser and behaviour.

## GETTING STARTED

This module comes with a few introductory tutorials.

- •

  A Cucumber feature writing tutorial

  for those new to Cucumber and BDD testing

- •

  A Step writing tutorial

  to get you started writing the code run for each `"Given"`, `"Then"`, `"When"` step

- •

  A guide on integrating with your test suite

- •

  An architecture overview

  for those who want to extend or hook into feature file execution

- •

  Documentation of the command-line tool App::pherkin

## BUGS AND LIMITATIONS

For current bugs, check the issue tracer at GitHub: \<https://github.com/pherkin/test-bdd-cucumber-perl/issues\>

One thing need specific mentioning:

- •

  Due to the use of its own parser, differences probably exist in the interpretation of feature files when comparing to Cucumber.

  Also see the issue \<https://github.com/pherkin/test-bdd-cucumber-perl/issues/73\> for tracking this topic.

## PROJECT RESOURCES

- •

  Source code repository at \<https://github.com/pherkin/test-bdd-cucumber-perl\>

- •

  Bug tracker at \<https://github.com/pherkin/test-bdd-cucumber-perl/issues\>

- •

  Mailing list at \<mailto:perl-pherkin@googlegroups.com\>

- •

  Chat (Gitter) at \<https://gitter.im/pjlsergeant/test-bdd-cucumber-perl\>

- •

  Chat (IRC) at \<irc://irc.freenode.net/#perl\>

- •

  Website at \<https://pherkin.pm\>

## SEE ALSO

Gherkin - A Gherkin parser and compiler

## AUTHORS

Peter Sergeant `"pete@clueball.com"`

Erik Huelsmann `"ehuels@gmail.com"`

Ben Rodgers `"ben@bdr.org"`

## LICENSE

```
  Copyright 2019-2023, Erik Huelsmann
  Copyright 2011-2019, Peter Sergeant; Licensed under the same terms as Perl
```