Skip to content

One test, many inputs

When the same steps should be tried with different inputs (every validation message, every plan, every language) don’t copy the test. Give it data:, and it runs once per row, each row with its own result.

tests/sign-in-errors.sis.yaml
sisyphus: 1
name: Sign-in rejects ${case}
app: web
data:
- { case: an empty email, email: "", error: Email is required }
- { case: a wrong password, email: ada@example.com, error: Wrong email or password }
- { case: an unknown email, email: nobody@example.com, error: Wrong email or password }
steps:
- fill: textbox "Email" = ${email}
- fill: textbox "Password" = not-it
- click: button "Sign in"
- expect: alert
text: ${error}

Each row’s values become variables. Putting one in the name gives every row a readable result:

✓ Sign-in rejects an empty email 0.4s
✓ Sign-in rejects a wrong password 0.3s
✗ Sign-in rejects an unknown email 5.2s · tests/sign-in-errors.sis.yaml#3

For longer tables, use a CSV file next to the test. The first line is the header:

data: sign-in-errors.csv
tests/sign-in-errors.csv
case,email,error
an empty email,,Email is required
a wrong password,ada@example.com,Wrong email or password
"a name, with a comma",x@example.com,Wrong email or password

Spreadsheets export CSV, so people who don’t write tests can add cases.

Rows are numbered from 1, as in the result above:

Terminal window
sis run tests/sign-in-errors.sis.yaml#3
Made by Bussin Bytes© 2026 Bussin Bytes Ltd · sisyphus.bussinbytes.io