Uploaded image for project: 'CommandBox'

Add "forEach" command to execute command once per incoming line


    • Type: New Feature
    • Status: Resolved (View workflow)
    • Priority: Major
    • Resolution: Fixed
    • Affects versions: None
    • Fix versions: 4.3.0
    • Components: None
    • Labels:


      Excecute a command against every item in an incoming list. The list can be passed directly
      or piped into this command. The default delimiter is a new line so this works great piping
      the output of file listings direclty in, which have a file name per line.

      This powerful construct allows you to perform basic loops from the CLI over arbitrary input.
      Most of the examples show file listings, but any input can be used that you want to iterate over.

      This example will use the echo command to output each filename returned by ls. The echo is called
      once for every line of output being piped in.

      ls --simple | forEach

      The default command is "echo" but you can perform an action against the incoming list of items.
      This example will use "cat" to output the contents of each file in the incoming list.

      ls *.json --simple | forEach cat

      You can customize the delimiter. This example passes a hard-coded input and spits it on commas.
      So here, the install command is run three times, once for each package. A contrived, but effective example.

      forEach input="coldbox,testbox,cborm" delimiter="," command=install

      If you want a more complex command, you can choose exactly where you wish to use the incoming item
      by referencing the default system setting expansion of ${item}. Remember to escape the expansion in
      your command so it's resolution is deferred until the forEach runs it internally.
      Here we echo each file name followed by the contents of the file.

      ls *.json --simple | foreach "echo \${item} && cat \${item}"

      You may also choose a custom placeholder name for readability.

      ll *.json --simple | foreach "echo \${filename} && cat \${filename}" filename

        Gliffy Diagrams




              • Assignee:
                bradwood Brad Wood
                bradwood Brad Wood
              • Votes:
                0 Vote for this issue
                1 Start watching this issue


                • Created: