Skip to main content

Data-Driven Testing

Restlyn supports dynamic test generation from CSV or JSON files to cover multiple test cases in a single scenario.

🧪 Gherkin Format​

Use this syntax in your .feature file:

When I POST "/login" using data from "loginData.csv"

Restlyn will look inside the data/ folder by default.

📁 Default Data Folder​

data/

Override in .restlynrc:

[test]
data = my-test-data

📄 Supported Formats​

✅ CSV​

email,password,testName
user1@example.com,pass123,Valid user
user2@example.com,wrong,Invalid password

✅ JSON​

[
  { "email": "user1@example.com", "password": "pass123", "testName": "Valid user" },
  { "email": "user2@example.com", "password": "wrong", "testName": "Invalid password" }
]

🚀 Output Behavior​

Restlyn will:

  • Create a looped test block
  • Use testName as the test case label if present
  • Inject row data into the request body
  • Support row.skip = true to skip specific entries

💡 Inline vs File-based​

If both a Gherkin data table and file are specified:

  • File takes precedence
  • A warning will be logged to avoid confusion

🧬 Combining with Schema Validation​

Each iteration will:

  • Be validated against the expected response status
  • Optionally validate against a .schema.json contract

Data-driven tests help you validate edge cases, boundaries, and regressions — fast!

➡️ Next: Advanced Tags & Control