Skip to main content

Data Driven

CSV data feeds

Since v1.0.0

CSV data files can be passed into the interpreter to perform feature execution over multiple data sets. The first row in a CSV data file must be a list of column names for the contained data that follows. The values in each record will be bound to attributes in the feature scope having these same names. Feature steps can reference the bound data using these names.

Say you have a users.csv file containing following user records.


File: data/users.csv

Gwen,Stefani,Pop Singer
Gwen,Cooper,Torchwood Agent

The first row in this file specifies a comma separated list of column names. The remaining rows specify the comma separated lists of values for each record. Now say you wanted to submit the details for each user to a web page through a single submit-user.feature file that accepts all the user data as input one at a time. You can do this in the feature by referencing CSV data values by their column names as follows:


File: features/submit-user.feature

Feature: Submit user ${FIRST_NAME} ${LAST_NAME}

Scenario: submit user details
Given I navigate to the user details page
When I type FIRST_NAME in the first name field
And I type LAST_NAME in the last name field
And I type JOB in the job field
And I click the save button
Then the alert msg should be "User ${FIRST_NAME} saved"

Note: Interpolation of CSV fields ${FIRST_NAME} ${LAST_NAME} in the feature name and description is supported since v3.12.1

The current CSV record number (starting at 1) is available as an implicit attribute named data record number and can be accessed by reference or interpolation.

You can now execute this feature for all users in the CSV file by launching Gwen with the -i|--input-data CLI ooption.


yarn gwen -b -i gwen/data/users.csv gwen/features/submit-user.feature


yarn gwen -b --input-data gwen/data/users.csv gwen/features/submit-user.feature

Gwen will read in the CSV file, and for each record will:

  • Bind the data to the feature
  • And execute the feature

A feature detail report will be generated for each data record. If you specify the --parallel CLI option, the feature will execute all records in parallel.

Outline data feeds

See also: CSV Driven Examples