PostDiscoveryFilters
based on included and excluded tags or tag expressions.
Tag expressions are boolean expressions with the following allowed
operators: !
(not), &
(and), and |
(or). Parentheses
can be used to adjust for operator precedence. Please refer to the
JUnit 5 User Guide
for usage examples.
Please note that a tag name is a valid tag expression. Thus, wherever a tag expression can be used, a single tag name can also be used.
- Since:
- 1.0
- See Also:
includeTags(String...)
,excludeTags(String...)
,TestTag
-
Method Summary
Modifier and TypeMethodDescriptionstatic PostDiscoveryFilter
excludeTags(String... tagExpressions)
Create an exclude filter based on the supplied tag expressions.static PostDiscoveryFilter
excludeTags(List<String> tagExpressions)
Create an exclude filter based on the supplied tag expressions.static PostDiscoveryFilter
includeTags(String... tagExpressions)
Create an include filter based on the supplied tag expressions.static PostDiscoveryFilter
includeTags(List<String> tagExpressions)
Create an include filter based on the supplied tag expressions.
-
Method Details
-
includeTags
public static PostDiscoveryFilter includeTags(String... tagExpressions) throws PreconditionViolationExceptionCreate an include filter based on the supplied tag expressions.Containers and tests will only be executed if their tags match at least one of the supplied included tag expressions.
- Parameters:
tagExpressions
- the included tag expressions; nevernull
or empty- Throws:
PreconditionViolationException
- if the supplied tag expressions array isnull
or empty, or if any individual tag expression is not syntactically valid- See Also:
includeTags(List)
,TestTag.isValid(String)
-
includeTags
public static PostDiscoveryFilter includeTags(List<String> tagExpressions) throws PreconditionViolationExceptionCreate an include filter based on the supplied tag expressions.Containers and tests will only be executed if their tags match at least one of the supplied included tag expressions.
- Parameters:
tagExpressions
- the included tag expressions; nevernull
or empty- Throws:
PreconditionViolationException
- if the supplied tag expressions array isnull
or empty, or if any individual tag expression is not syntactically valid- See Also:
includeTags(String...)
,TestTag.isValid(String)
-
excludeTags
public static PostDiscoveryFilter excludeTags(String... tagExpressions) throws PreconditionViolationExceptionCreate an exclude filter based on the supplied tag expressions.Containers and tests will only be executed if their tags do not match any of the supplied excluded tag expressions.
- Parameters:
tagExpressions
- the excluded tag expressions; nevernull
or empty- Throws:
PreconditionViolationException
- if the supplied tag expressions array isnull
or empty, or if any individual tag expression is not syntactically valid- See Also:
excludeTags(List)
,TestTag.isValid(String)
-
excludeTags
public static PostDiscoveryFilter excludeTags(List<String> tagExpressions) throws PreconditionViolationExceptionCreate an exclude filter based on the supplied tag expressions.Containers and tests will only be executed if their tags do not match any of the supplied excluded tag expressions.
- Parameters:
tagExpressions
- the excluded tag expressions; nevernull
or empty- Throws:
PreconditionViolationException
- if the supplied tag expressions array isnull
or empty, or if any individual tag expression is not syntactically valid- See Also:
excludeTags(String...)
,TestTag.isValid(String)
-