Scroll to navigation

Test::BDD::Cucumber::Model::TagSpec(3pm) User Contributed Perl Documentation Test::BDD::Cucumber::Model::TagSpec(3pm)

NAME

Test::BDD::Cucumber::Model::TagSpec - Encapsulates tag selectors

VERSION

version 0.86

STATUS

DEPRECATED - This module's functionality has been superseded by Cucumber::TagExpressions. A module published by the Cucumber project, with cross-implementation tests to achieve overall consistency.

DESCRIPTION

Try and deal with the crazy-sauce tagging mechanism in a sane way.

OVERVIEW

Cucumber tags are all sortsa crazy. This appears to be a direct result of trying to shoe-horn the syntax in to something you can use on the command line. Because 'Cucumber' is the name of a gem, application, language, methodology etc etc etc look of disapproval.

Here is some further reading on how it's meant to work: <https://github.com/cucumber/cucumber/wiki/Tags>. This is obviously a little insane.

Here's how they work here, on a code level: You pass in a list of lists that look like Lisp expressions, with a function: "and", "or", or "not". You can nest these to infinite complexity, but the parser is pretty inefficient, so don't do that. The "not" function accepts only one argument.

eg:

@important AND @billing: "<[and =" 'important', 'billing']>>

(@billing OR @WIP) AND @important: "<[ and =" [ or => 'billing', 'wip' ], 'important' ]>>

Skipping both @todo and @wip tags: "<[ and =" [ not => 'todo' ], [ not => 'wip' ] ]>>

ATTRIBUTES

tags

An arrayref representing a structure like the above.

 TagSet->new({
        tags => [ and => 'green', 'blue', [ or => 'red', 'yellow' ], [ not => 'white' ] ]
 })

METHODS

filter

Filter a list of Scenarios by the value of "tags"

 my @matched = $tagset->filter( @scenarios );

If "tags" is empty, no filtering is done.

2023-08-29 perl v5.36.0