NAME¶

SYNOPSIS¶

 # If data is like:
 
   numbers:
      - one
      - two
      - three
   person:
      name: jennie
      age: 44
      color:
         - green
         - purple
         - brown
         - more:
            foo: bar

 do visitor()
    upcase(scalar)  # upcase every scalar value in the record
 end

 # will produce

   numbers:
      - ONE
      - TWO
      - THREE
   person:
      name: JENNIE
      age: 44
      color:
         - GREEN
         - PURPLE
         - BROWN
         - more:
            foo: BAR

  do visitor()
    # upcase all the 'name' fields in the record
    if all_match(key,name)
      upcase(scalar)
    end
  end

DESCRIPTION¶

Special node names are available to process every visited element:

scalar

Process a Fix on every scalar value. E.g.

   upcase(scalar)
   replace_all(scalar,'$','tested')
    

array

Process a Fix on every array value. E.g.

   sort_field(array)
    

Values need to be put in the 'array' field to be available for fixes. The scope of the array is limited to the array visited.

hash

Process a Fix on every hash value. E.g.

   copy_field(hash.age,hash.age2)
    

Values need to be put in the 'hash' field to be available for fixes. The scope of the hash is limited to the hash visited.

key

Provides access to the key on which the scalar,array or hash value is found. Eg.

   # Upcase all 'name' fields in the record
   if all_match(key,name)
      upcase(scalar)
   end
    

CONFIGURATION¶

  # Visit any field
  do visitor()
    ...
  end

  # Visit only the fields at my.deep.field
  do visitor(-path => my.deep.field )
    ...
  end

SEE ALSO¶