wincent/wopen3

Open3 replacement

<p>Wopen3 is a replacement for Open3. Unlike Open3, Wopen3 does not throw away
the exit code of the executed (grandchild) process. Only a child process is
spawned and the exit status is returned in $? as normal.</p>

<p>Usage example:</p>

<pre>result, errors = '', ''
Wopen3.popen3('git', 'log') do |stdin, stdout, stderr|
  threads = []
  threads &lt;&lt; Thread.new(stdout) do |out|
    out.each { |line| result &lt;&lt; line }
  end
  threads &lt;&lt; Thread.new(stderr) do |err|
    err.each { |line| errors &lt;&lt; line }
  end
  threads.each { |thread| thread.join }
end
status = $?.exitstatus
raise "Non-zero exit status #{status}" if status != 0</pre>

<p>As this is such a common usage pattern, a 'system' method is provided as a
convenience:</p>

<pre>result = Wopen3.system('git', 'log')
result.success? # =&gt; true
result.status   # =&gt; 0
result.stderr   # =&gt; ''
result.stdout   # =&gt; 'commit 491411b3...'</pre>