1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
|
Feature: Tag Expression
As a tester
I want to select a subset of all features/scenarios by using tags
And I want to include and/or exclude some tags
So that I can focus on the "important" scenarios (and features).
. SPECIFICATION:
. * a tag expression is a boolean expression
. * a tag expression supports the operators: and, or, not
. * a tag expression is structured as:
. (or_expr1) and (or_expr2) and ...
.
. EXAMPLES:
. | Tag logic | Tag expression | Comment |
. | @foo | @foo | Select elements with @foo tag |
. | @foo | foo | Same, '@' is optional. |
. | not @foo | -@foo | Use minus for "not". |
. | not @foo | ~foo | Same, use tilde instead of minus |
. | @foo or @bar | @foo,@bar | Use comma for "or". |
. | @foo and @bar | @foo @bar | Use space separated terms. |
. | @foo or not @bar | @foo,-@bar | |
. | @foo and not @bar | @foo -@bar | |
Scenario: Select @foo
Given the tag expression "@foo"
Then the tag expression selects elements with tags:
| tags | selected? |
| | no |
| @foo | yes |
| @other | no |
| @foo @other | yes |
Scenario: Tag expression with 0..1 tags
Given the model elements with name and tags:
| name | tags | Comment |
| S0 | | Untagged |
| S1 | @foo | With 1 tag |
| S2 | @other | |
| S3 | @foo @other | With 2 tags |
And note that "are all combinations of 0..2 tags"
Then the tag expression selects model elements with:
| tag expression | selected? | Case comment |
| | S0, S1, S2, S3 | Select all (empty tag expression) |
| @foo | S1, S3 | Select @foo |
| -@foo | S0, S2 | not @foo, selects untagged elements |
But note that "tag expression variants are also supported"
And the tag expression selects model elements with:
| tag expression | selected? | Case comment |
| foo | S1, S3 | @foo: '@' is optional |
| -foo | S0, S2 | not @foo: '@' is optional |
| ~foo | S0, S2 | not @foo: tilde as minus |
| ~@foo | S0, S2 | not @foo: '~@' is supported |
Scenario: Tag expression with two tags (@foo, @bar)
Given the model elements with name and tags:
| name | tags | Comment |
| S0 | | Untagged |
| S1 | @foo | With 1 tag |
| S2 | @bar | |
| S3 | @other | |
| S4 | @foo @bar | With 2 tags |
| S5 | @foo @other | |
| S6 | @bar @other | |
| S7 | @foo @bar @other | With 3 tags |
And note that "are all combinations of 0..3 tags"
Then the tag expression selects model elements with:
| tag expression | selected? | Case |
| | S0, S1, S2, S3, S4, S5, S6, S7 | Select all |
| @foo,@bar | S1, S2, S4, S5, S6, S7 | @foo or @bar |
| @foo,-@bar | S0, S1, S3, S4, S5, S7 | @foo or not @bar |
| -@foo,-@bar | S0, S1, S2, S3, S5, S6 | not @foo or @not @bar |
| @foo @bar | S4, S7 | @foo and @bar |
| @foo -@bar | S1, S5 | @foo and not @bar |
| -@foo -@bar | S0, S3 | not @foo and not @bar |
Scenario: Tag expression with three tags (@foo, @bar, @zap)
Given the model elements with name and tags:
| name | tags | Comment |
| S0 | | Untagged |
| S1 | @foo | With 1 tag |
| S2 | @bar | |
| S3 | @zap | |
| S4 | @other | |
| S5 | @foo @bar | With 2 tags |
| S6 | @foo @zap | |
| S7 | @foo @other | |
| S8 | @bar @zap | |
| S9 | @bar @other | |
| S10 | @zap @other | |
| S11 | @foo @bar @zap | With 3 tags |
| S12 | @foo @bar @other | |
| S13 | @foo @zap @other | |
| S14 | @bar @zap @other | |
| S15 | @foo @bar @zap @other | With 4 tags |
And note that "are all combinations of 0..4 tags"
Then the tag expression selects model elements with:
| tag expression | selected? | Case |
| @foo,@bar @zap | S6, S8, S11, S13, S14, S15 | (@foo or @bar) and @zap |
| @foo,@bar -@zap | S1, S2, S5, S7, S9, S12 | (@foo or @bar) and not @zap |
| @foo,-@bar @zap | S3, S6, S10, S11, S13, S15 | (@foo or not @bar) and @zap |
|
