Iterators

CSV Iterator

CSV iterators are used in cases when some argument has multiple values and you need to iterate for each value separately. The Digger itself will parse the passed CSV values and create a list of argument sets. The following parameters are used to initialize the iterator:

The following is an example of initializing an iterator:

              iterator:
- type: csv
  # ARGUMENT NAME
  name: age
  # ARGUMENT VALUES
  value: 1,2,3,4
              

As a result, the following list of sets of fields with values ​will be formed ​for each of which the digger will execute the main logic block:

              [
    { "age": 1 },
    { "age": 2 },
    { "age": 3 },
    { "age": 4 }
]
              

An example of using an iterator in a digger:

              ---
config:
    debug: 2
    agent: Firefox
iterator:
    type: csv
    name: age
    value: 18,19,25
do:
- walk:
    to: https://www.diggernaut.com/sandbox/meta-lang-object-en.html?age=<%age%>
    do:
              

You can use a combination of iterators to create a list with all possible combinations of arguments from different iterators.

An example of using a combination of iterators in a digger:

              ---
config:
    debug: 2
    agent: Firefox
iterator:
# by dates
- type: date
  start: '2017-10-01'
  period: 2
  interval: 1
  template: '%Y-%m-%d'
# and ages
- type: csv
  name: age
  value: 30,40
do:
- walk:
    to: https://www.diggernaut.com/sandbox/meta-lang-object-en.html?age=<%age%>&from=<%start_date%>
    do:
              

Next, we learn more about fieldset iterators.