tweakstreet-logo
  • Enter search terms

Run Process

Run any executable program

Processing

For every input row, the step runs any executable program or script and provides its output and exit code as step results.

Settings

Name Type Description
Command Settings
Executable
 string

The executable file to run.

Paths starting with . are interpreted as relative to the current flow.

Evaluated for each input row
Working Directory
 string

The working directory of the executable when run.

Paths starting with . are interpreted as relative to the current flow.

Evaluated for each input row
Arguments
 list

List of string arguments to pass to the executable.

On most systems no escaping of arguments is required.

On MS Windows systems it is often necessary to enclose arguments containing spaces with the character sequence \" in order for the target executable to see them as single arguments.

Evaluated for each input row
Environment Variables
 dict

Environment variables to set for the program

Evaluated for each input row
Errors
Propagate Errors
 string

Determines behaviour of this step when executable exits with a non-zero exit code

  • if true, the step fails with an error
  • if false, the step continues,
    you can use results.exit_code and and results.std_err to handle the failure

Evaluated for each input row
I/O
Handle IN
 string

How to handle std in for the executable. One of the following:

  • std in is “empty”
  • a “file” is piped into std in
  • a “string” is piped into std in

Evaluated for each input row
File to pipe into IN
 string

Path to file to pipe into std in, if piping in a file is selected.

Evaluated for each input row
String to pipe into IN
 string

String to pipe into std in, if piping in a string is selected.

Evaluated for each input row
Charset when piping String
 string

Charset of string to pipe into std in, if piping in a string is selected.

Evaluated for each input row
Handle OUT
 string

How to handle std out for the executable. One of the following:

  • inherit std out of flow process, so executable prints to flow std out
  • discard std out of executable
  • capture std out of executable as string
  • redirect std out of executable to a file (truncating it)
  • redirect std out of executable to a file (appending)

Evaluated for each input row
File to pipe OUT into
 string

Path to output file, if redirecting std out to a file.

Evaluated for each input row
Charset to capture OUT
 string

Charset to use, if capturing std out to a string.

Evaluated for each input row
Handle ERR
 string

How to handle std out for the executable. One of the following:

  • redirect executable’s std err into its std out, effectively merging std err into std out
  • discard std err of executable
  • capture std err of executable as string
  • redirect std err of executable to a file (truncating it)
  • redirect std err of executable to a file (appending)

Evaluated for each input row
File to pipe ERR into
 string

Path to output file, if redirecting std err to a file.

Evaluated for each input row
Charset to capture ERR
 string

Charset to use, if capturing std err to a string.

Evaluated for each input row

Results

Name Type Description
exit_code
 long exit code of executable
std_out
 string standard output of executable when capturing
std_err
 string error output of executable when capturing
On this page