Skip to main content

Selecting & Ignoring

Depending on the requirements of the development cycle, it's often necessary to select specific test scenarios to run and ignore others. Vedro provides command-line arguments and decorators to precisely control test execution.

Selecting Scenarios

To run scenarios located in a specific file or directory, use the vedro run command, followed by the path to the file or directory:

$ vedro run <file_or_dir>

For example:

# Select directory
$ vedro run scenarios/login/

# Select files
$ vedro run scenarios/register/ \

Ignoring Scenarios

To exclude certain scenarios from your test run that are located in a file or directory, use the -i or --ignore argument followed by the path to the file or directory:

$ vedro run -i (--ignore) <file_or_dir>

For instance:

$ vedro run -i scenarios/logout/

Ignoring scenarios means they are entirely excluded from the run, including from summary statistics. If you want to merely skip scenarios instead of wholly ignoring them, refer to the "Skipping Scenarios" page.

Combining Selecting and Ignoring

In certain situations, you may want to run a collection of test scenarios from a particular directory but ignore one or more individual scenarios within that directory. Vedro enables this by allowing the combining of run and ignore commands:

$ vedro run scenarios/login/ -i scenarios/login/

This command runs all scenarios in the "login/" directory, excluding the "" scenario.


Use the --dry-run argument to preview which scenarios would be executed. This feature helps in fine-tuning your test selection process without actually running the scenarios.

Selecting Specific Scenarios

To execute a specific scenario, add the @vedro.only decorator to the scenario class definition. This decorator tells the framework to run only the decorated scenario, ignoring all others. Here's an example:

import vedro

class Scenario(vedro.Scenario):
subject = "register new user"

Then, simply run:

$ vedro run

If any scenario is decorated with @vedro.only, all scenarios with this decorator will be executed

Selecting Scenarios with Specific Subjects

To run scenarios that have a specific subject, use the --subject argument followed by the subject enclosed in quotes:

$ vedro run --subject '<subject>'

For example:

$ vedro run --subject 'register new user'

This command executes the scenario with the subject "register new user".


If multiple scenarios share the same subject, they will all be executed

Selecting Parameterized Scenarios

If you have scenarios that are parameterized, you can select a specific instance by specifying the scenario's index.

For example, consider the following file with parameterized scenario:

import vedro
from vedro import params

class Scenario(vedro.Scenario):
subject = "{subject}"

@params("get ok status", 200)
@params("get not found status", 404)
def __init__(self, subject, status):
self.subject = subject
self.status = status


To run only the first scenario (with a 200 status code), execute the following command:

$ vedro run scenarios/

To run only the second scenario (with a 404 status code), execute the following command:

$ vedro run scenarios/