Data Providers

A data provider defines a data collection to be used with a parameterised test.

A data collection contains one or more data sets. Each data set has a name and provides values for the parameters as required by a test.

Syntax

A data provider defines a data collection. A data collection is a YAML object with user-defined named properties. Each property name is the name of a data set. Each data set maps parameter names to parameter values.

{data-set-name-1}
    {parameter-name-1}: {parameter-value-1}
    ...
    {parameter-name-N}: {parameter-value-N}

...

{data-set-name-N}
    {parameter-name-1}: {parameter-value-1}
    ...
    {parameter-name-N}: {parameter-value-N}

-------------------------------------------

data-set-name-*:
    <string>, must be unique with a data collection

parameter-name-*:
    <string>, must match the name of a parameter as required by a test

parameter-value-*:
    <string>

Examples

# examples/data-provider/google-search-query.yml
foo:
  search_term: "foo"
  expected_title: "foo - Google Search"

bar:
  search_term: "bar"
  expected_title: "bar - Google Search"

# examples/data-provider/example-sign-in.yml
user1:
  username: $env.TEST_USER_1_USERNAME
  password: $env.TEST_USER_1_PASSWORD

user2:
  username: $env.TEST_USER_2_USERNAME
  password: $env.TEST_USER_2_PASSWORD