Filtering Tests
Filters allow you to control which tests are executed during a run.
You can apply simple filter flags or define advanced logical expressions using a raw filter string.
Multiple filters can be combined to precisely narrow execution scope.
Filter Flags
# By tag
devassure run-tests --tag=smoke,regression
# By priority
devassure run-tests --priority=P0,P1
# By folder
devassure run-tests --folder=admin/users,project/integration
# By keyword (text match on summary, steps, and tags)
devassure run-tests --query="login flow"
# Combine multiple flags
devassure run-tests --tag=smoke --priority=P0 --folder=admin/users
Raw Filter String
Use --filter for advanced expressions. This takes precedence over all other filter flags.
# Tag and priority
devassure run-tests --filter="tag = tag1,tag2 && priority = P0"
# Text search
devassure run-tests --filter="query = dashboard"
Filter syntax:
| Element | Details |
|---|---|
tag=<value> | Match by tag |
priority=<value> | Match by priority (e.g., P0, P1) |
folder=<name> | Match by folder |
query=<text> | Text match on summary, steps, and tags |
&& / || | Combine clauses |
( ) | Group clauses |
Examples:
tag=smoke && priority=P0
query=login
(tag=user && priority=P0) || (tag=dashboard && priority=P1)
All filter flags support plural forms: --tags, --priorities, --folders, --queries.