Executor

Executor aims to provide a standard interface to work with binaries outside of ruby. It provides a standard implementation of the following requirements:

• Capturing exit status and raising appropriate exception
• Redirecting stderr
• Asynchronous callbacks
• Logging of command output

Options

• redirect_stderr - This will cause any stderr from a command to be merged to stdout

• raise_exceptions - This will listen for the exit code of the executed process and raise an exception if non 0

• async - This is true by default if a block is given to Executor::command, async will create a new thread and execute the passed block upon completion of the process

• logger - This takes an instance of logger (or an instance that implements #info)

Usage

Basic

require 'executor'

Executor::command("echo 5")

With redirection

Executor::command("expr 5 / 0", :redirect_stderr => true)

With one-time configuration

Executor::configure(
  :raise_exceptions => false
)

Executor::command("expr 5 / 0")

Special notes

• In async mode (when block given or via explicit configuration), an exception if caught will be returned to the callback

credits: me, robgleeson@freenode