libuv 3.1.9 → 3.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9fa444336638ad13d76688a5cb3b497a7583b452
-  data.tar.gz: 5873c7caef9490d06fc0a115190b2d503fbbd7b3
+  metadata.gz: bd16f081b56087f5fc6c17dcea3cfaa2aeca8968
+  data.tar.gz: 6d22b971ef7eee595abd656a0d53e80080de0130
 SHA512:
-  metadata.gz: 6f6061acb31cd5b6621c2ce2b4f22984facb29f211523a9aa3ddea2dc21c237bb96a0eeeb1abb0f1c3893b8364a1a7fba876722d9a174306a23e0bbbd5cfda06
-  data.tar.gz: da178e269d1724cf912fa9e4b2180b2657894a151b219fcb4638e4ad34c896f2fe852024c2595fc457a843cd4d1b3bf2b7efdbb6769ef8cde8d6839e5ec03d08
+  metadata.gz: 7928432c64a8b4182ef95d17979cfe81c6bed6f1a2113fed5e048f97c823badd7cbf79c437d69ad65389b0a87107dcbfa973833db6a3fbc707ef6caaf4a7c908
+  data.tar.gz: 746acbece27866330a475d6fb9dfff6fa2604291cc053c87a4fd3c1f4ef073c1034c46ccf2e28d632738c16088ae1061377f474b47da7c9c3744ed739d711750

data/.travis.yml

@@ -1,10 +1,10 @@
 language: ruby
 rvm:
-  - ruby-2.3.3
+  - ruby-2.3.4
   - ruby-2.4.1
   - ruby-head
   - rubinius-3.76
-  - jruby-9.1.8.0
+  - jruby-9.1.10.0
   - jruby-head
 branches:
   only:

data/README.md

@@ -178,3 +178,12 @@ server.remove_host('somehost2.com')
 
 You don't have to specify any hosts at binding time.
 
+
+## Protocols and 3rd party plugins
+
+* [HTTP](https://github.com/cotag/uv-rays - with SNI [server name indication] support)
+  * [Faraday plugin](https://github.com/cotag/uv-rays/blob/master/lib/faraday/adapter/libuv.rb)
+  * [HTTPI plugin](https://github.com/cotag/uv-rays/blob/master/lib/httpi/adapter/libuv.rb)
+  * [HTTP2](https://github.com/igrigorik/http-2)
+  * [SOAP](https://github.com/savonrb/savon) (using HTTPI plugin)
+* [SNMP](https://github.com/acaprojects/ruby-engine/blob/master/lib/protocols/snmp.rb)

data/lib/libuv.rb

@@ -21,8 +21,9 @@ module Libuv
     require 'libuv/prepare'     # Called at the end of a reactor cycle
     require 'libuv/async'       # Provide a threadsafe way to signal the event reactor
     require 'libuv/timer'       # High resolution timer
-    require 'libuv/reactor'        # The libuv reactor or event reactor
-    require 'libuv/coroutines'
+    require 'libuv/reactor'     # The libuv reactor or event reactor
+    require 'libuv/coroutines'  # Pause program execution until a result is returned
+    require 'libuv/fiber_pool'  # Fibers on jRuby and Rubinius are threads and expensive to re-create
     # --
 
     autoload :FsChecks, 'libuv/mixins/fs_checks'   # Common code to check file system results
@@ -32,6 +33,7 @@ module Libuv
     autoload :Filesystem, 'libuv/filesystem'  # Async directory manipulation
     autoload :FSEvent,    'libuv/fs_event'    # Notifies of changes to files and folders as they occur
     autoload :Signal,     'libuv/signal'      # Used to handle OS signals
+    autoload :Spawn,      'libuv/spawn'       # Executes a child process
     autoload :Check,      'libuv/check'       # Called before processing events on the reactor
     autoload :File,       'libuv/file'        # Async file reading and writing
     autoload :Idle,       'libuv/idle'        # Called when there are no events to process

data/lib/libuv/async.rb

@@ -40,13 +40,13 @@ module Libuv
 
 
         def on_async(handle)
-            ::Fiber.new {
+            @reactor.exec do
                 begin
                     @callback.call
                 rescue Exception => e
                     @reactor.log e, 'performing async callback'
                 end
-            }.resume
+            end
         end
     end
 end

data/lib/libuv/check.rb

@@ -48,13 +48,13 @@ module Libuv
 
 
         def on_check(handle)
-            ::Fiber.new {
+            @reactor.exec do
                 begin
                     @callback.call
                 rescue Exception => e
                     @reactor.log e, 'performing check callback'
                 end
-            }.resume
+            end
         end
     end
 end

data/lib/libuv/dns.rb

@@ -72,7 +72,7 @@ module Libuv
 
             e = check_result(status)
 
-            ::Fiber.new { 
+            @reactor.exec do
                 if e
                     @defer.reject(e)
                 else
@@ -89,7 +89,7 @@ module Libuv
                     end
                     ::Libuv::Ext.freeaddrinfo(addrinfo)
                 end
-            }.resume
+            end
 
             # Clean up references
             cleanup_callbacks

data/lib/libuv/error.rb

@@ -78,5 +78,11 @@ module Libuv
         class ENXIO < Error; end
         class EMLINK < Error; end
         class EHOSTDOWN < Error; end
+        class EREMOTEIO < Error; end
+
+        # Non-zero exit code
+        class ProcessExitCode < Error
+            attr_accessor :exit_status, :term_signal
+        end
     end
 end

data/lib/libuv/ext/ext.rb

@@ -209,7 +209,7 @@ module Libuv
         attach_function :getaddrinfo, :uv_getaddrinfo, [:uv_loop_t, :uv_getaddrinfo_t, :uv_getaddrinfo_cb, :string, :string, UvAddrinfo.by_ref], :int
         attach_function :freeaddrinfo, :uv_freeaddrinfo, [UvAddrinfo.by_ref], :void
 
-        attach_function :spawn, :uv_spawn, [:uv_loop_t, :uv_process_t, :uv_options_t], :int, :blocking => true
+        attach_function :spawn, :uv_spawn, [:uv_loop_t, :uv_process_t, UvProcessOptions.by_ref], :int, :blocking => true
         attach_function :process_kill, :uv_process_kill, [:uv_process_t, :int], :int, :blocking => true
         attach_function :kill, :uv_kill, [:int, :int], :int, :blocking => true
         attach_function :queue_work, :uv_queue_work, [:uv_loop_t, :uv_work_t, :uv_work_cb, :uv_after_work_cb], :int, :blocking => true

data/lib/libuv/ext/types.rb

@@ -147,6 +147,33 @@ module Libuv
                     :active_handles, :uint
         end
 
+        enum :uv_stdio_flags, [
+            :UV_IGNORE, 0,
+            :UV_CREATE_PIPE, 1,
+            :UV_INHERIT_FD, 2,
+            :UV_INHERIT_STREAM, 4,
+            :UV_READABLE_PIPE, 0x10,
+            :CREATE_READABLE_PIPE, 0x11,
+            :UV_WRITABLE_PIPE, 0x20,
+            :CREATE_WRITABLE_PIPE, 0x21
+        ]
+
+        class StdioData < FFI::Union
+            layout  :pipe_handle, :pointer,
+                    :fd,          :int
+        end
+
+        class UvStdioContainer < FFI::Struct
+            layout :flags, :uv_stdio_flags,
+                   :data,  StdioData.by_value
+        end
+
+        class StdioObjs < FFI::Struct
+            layout :stdin,  UvStdioContainer.by_value,
+                   :stdout, UvStdioContainer.by_value,
+                   :stderr, UvStdioContainer.by_value
+        end
+
         typedef :pointer, :sockaddr_in
         typedef :pointer, :uv_handle_t
         typedef :pointer, :uv_fs_event_t
@@ -205,7 +232,7 @@ module Libuv
         callback :uv_check_cb,       [:uv_check_t],                                      :void
         callback :uv_idle_cb,        [:uv_idle_t],                                       :void
         callback :uv_getaddrinfo_cb, [:uv_getaddrinfo_t, :status, UvAddrinfo.by_ref],    :void
-        callback :uv_exit_cb,        [:uv_process_t, :int, :int],                        :void
+        callback :uv_exit_cb,        [:uv_process_t, :int64, :int],                      :void
         callback :uv_walk_cb,        [:uv_handle_t, :pointer],                           :void
         callback :uv_work_cb,        [:uv_work_t],                                       :void
         callback :uv_after_work_cb,  [:uv_work_t, :int],                                 :void
@@ -214,5 +241,18 @@ module Libuv
         callback :uv_udp_send_cb,    [:uv_udp_send_t, :int],                             :void
         callback :uv_udp_recv_cb,    [:uv_udp_t, :ssize_t, :uv_buf_t, Sockaddr.by_ref, :uint],  :void
         callback :uv_cb,             [],                                                 :void
+
+        class UvProcessOptions < FFI::Struct
+            layout  :exit_cb,     :uv_exit_cb,
+                    :file,        :pointer,
+                    :args,        :pointer, # arg[0] == file
+                    :env,         :pointer, # environment array of strings
+                    :cwd,         :pointer,  # working dir
+                    :flags,       :uint,
+                    :stdio_count, :int,
+                    :stdio,       StdioObjs.by_ref,
+                    :uid,         :uint64,
+                    :gid,         :uint64
+        end
     end
 end

data/lib/libuv/fiber_pool.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+module Libuv; end
+
+# Use of a Fiber Pool increases performance as stack allocations
+# don't need to continually occur. Especially useful on JRuby and
+# Rubinius where multiple kernel threads and locks emulate Fibers.
+class Libuv::FiberPool
+    def initialize(thread)
+        @reactor = thread
+        @pool = []
+        @count = 0
+    end
+
+    def exec
+        if @reactor.reactor_thread?
+            # Execute the block in a Fiber
+            next_fiber do
+                begin
+                    yield
+                rescue Exception => e
+                    @on_error.call(e) if @on_error
+                end
+            end
+        else
+            # move the block onto the reactor thread
+            @reactor.schedule do
+                exec do
+                    yield
+                end
+            end
+        end
+    end
+
+    def on_error(&block)
+        @on_error = block
+    end
+
+    def available
+        @pool.size
+    end
+
+    def size
+        @count
+    end
+
+
+    protected
+
+
+    def next_fiber(&block)
+        fib = if @pool.empty?
+            new_fiber
+        else
+            @pool.pop
+        end
+
+        @job = block
+        fib.resume
+    end
+
+    # Fibers are never cleaned up which shouldn't be much of an issue
+    # This might lead to issues on Rubinius or JRuby however it should
+    # generally improve performance on these platforms
+    def new_fiber
+        @count += 1
+
+        Fiber.new do
+            loop do
+                job = @job
+                @job = nil
+                job.call
+
+                @pool << Fiber.current
+                Fiber.yield
+            end
+        end
+    end
+end

data/lib/libuv/file.rb

@@ -232,7 +232,7 @@ module Libuv
                 @fileno = req[:result]
                 cleanup(req)
                 @closed = false
-                ::Fiber.new { @defer.notify(self) }.resume
+                @reactor.exec { @defer.notify(self) }
 
                 if @coroutine
                     @coroutine.resolve(nil)
@@ -244,7 +244,7 @@ module Libuv
         def on_close(req)
             if post_check(req, @defer)
                 cleanup(req)
-                ::Fiber.new { @defer.resolve(nil) }.resume
+                @reactor.exec { @defer.resolve(nil) }
             end
         end
 
@@ -253,7 +253,7 @@ module Libuv
             if post_check(req, deferred)
                 data = buffer1.read_string(req[:result])
                 cleanup(req)
-                ::Fiber.new { deferred.resolve(data) }.resume
+                @reactor.exec { deferred.resolve(data) }
             end
         end
 
@@ -261,7 +261,7 @@ module Libuv
             deferred, buffer1 = @request_refs.delete req.to_ptr.address
             if post_check(req, deferred)
                 cleanup(req)
-                ::Fiber.new { deferred.resolve(nil) }.resume
+                @reactor.exec { deferred.resolve(nil) }
             end
         end
 
@@ -269,7 +269,7 @@ module Libuv
             deferred = @request_refs.delete req.to_ptr.address
             if post_check(req, deferred)
                 cleanup(req)
-                ::Fiber.new { deferred.resolve(nil) }.resume
+                @reactor.exec { deferred.resolve(nil) }
             end
         end
 
@@ -277,7 +277,7 @@ module Libuv
             deferred = @request_refs.delete req.to_ptr.address
             if post_check(req, deferred)
                 cleanup(req)
-                ::Fiber.new { deferred.resolve(nil) }.resume
+                @reactor.exec { deferred.resolve(nil) }
             end
         end
 
@@ -285,7 +285,7 @@ module Libuv
             deferred = @request_refs.delete req.to_ptr.address
             if post_check(req, deferred)
                 cleanup(req)
-                ::Fiber.new { deferred.resolve(nil) }.resume
+                @reactor.exec { deferred.resolve(nil) }
             end
         end
 
@@ -293,7 +293,7 @@ module Libuv
             deferred = @request_refs.delete req.to_ptr.address
             if post_check(req, deferred)
                 cleanup(req)
-                ::Fiber.new { deferred.resolve(nil) }.resume
+                @reactor.exec { deferred.resolve(nil) }
             end
         end
 
@@ -301,7 +301,7 @@ module Libuv
             deferred = @request_refs.delete req.to_ptr.address
             if post_check(req, deferred)
                 cleanup(req)
-                ::Fiber.new { deferred.resolve(nil) }.resume
+                @reactor.exec { deferred.resolve(nil) }
             end
         end
 
@@ -309,7 +309,7 @@ module Libuv
             deferred = @request_refs.delete req.to_ptr.address
             if post_check(req, deferred)
                 cleanup(req)
-                ::Fiber.new { deferred.resolve(nil) }.resume
+                @reactor.exec { deferred.resolve(nil) }
             end
         end
     end

data/lib/libuv/filesystem.rb

@@ -152,7 +152,7 @@ module Libuv
             if post_check(req, @unlink_deferred)
                 path = req[:path]
                 cleanup(req)
-                ::Fiber.new { @unlink_deferred.resolve(path) }.resume
+                @reactor.exec { @unlink_deferred.resolve(path) }
             end
             @unlink_deferred = nil
         end
@@ -161,7 +161,7 @@ module Libuv
             if post_check(req, @mkdir_deferred)
                 path = req[:path]
                 cleanup(req)
-                ::Fiber.new { @mkdir_deferred.resolve(path) }.resume
+                @reactor.exec { @mkdir_deferred.resolve(path) }
             end
             @mkdir_deferred = nil
         end
@@ -170,7 +170,7 @@ module Libuv
             if post_check(req, @rmdir_deferred)
                 path = req[:path]
                 cleanup(req)
-                ::Fiber.new { @rmdir_deferred.resolve(path) }.resume
+                @reactor.exec { @rmdir_deferred.resolve(path) }
             end
             @rmdir_deferred = nil
         end
@@ -191,7 +191,7 @@ module Libuv
                 end
 
                 cleanup(req)
-                ::Fiber.new { @readdir_deferred.resolve(files) }.resume
+                @reactor.exec { @readdir_deferred.resolve(files) }
             end
             @readdir_deferred = nil
         end
@@ -200,7 +200,7 @@ module Libuv
             if post_check(req, @rename_deferred)
                 path = req[:path]
                 cleanup(req)
-                ::Fiber.new { @rename_deferred.resolve(path) }.resume
+                @reactor.exec { @rename_deferred.resolve(path) }
             end
             @rename_deferred = nil
         end
@@ -209,7 +209,7 @@ module Libuv
             if post_check(req, @chmod_deferred)
                 path = req[:path]
                 cleanup(req)
-                ::Fiber.new { @chmod_deferred.resolve(path) }.resume
+                @reactor.exec { @chmod_deferred.resolve(path) }
             end
             @chmod_deferred = nil
         end
@@ -218,7 +218,7 @@ module Libuv
             if post_check(req, @utime_deferred)
                 path = req[:path]
                 cleanup(req)
-                ::Fiber.new { @utime_deferred.resolve(path) }.resume
+                @reactor.exec { @utime_deferred.resolve(path) }
             end
             @utime_deferred = nil
         end
@@ -227,7 +227,7 @@ module Libuv
             if post_check(req, @link_deferred)
                 path = req[:path]
                 cleanup(req)
-                ::Fiber.new { @link_deferred.resolve(path) }.resume
+                @reactor.exec { @link_deferred.resolve(path) }
             end
             @link_deferred = nil
         end
@@ -236,7 +236,7 @@ module Libuv
             if post_check(req, @symlink_deferred)
                 path = req[:path]
                 cleanup(req)
-                ::Fiber.new { @symlink_deferred.resolve(path) }.resume
+                @reactor.exec { @symlink_deferred.resolve(path) }
             end
             @symlink_deferred = nil
         end
@@ -246,7 +246,7 @@ module Libuv
                 string_ptr = req[:ptr]
                 path = string_ptr.null? ? nil : string_ptr.read_string_to_null
                 cleanup(req)
-                ::Fiber.new { @readlink_deferred.resolve(path) }.resume
+                @reactor.exec { @readlink_deferred.resolve(path) }
             end
             @readlink_deferred = nil
         end
@@ -255,7 +255,7 @@ module Libuv
             if post_check(req, @chown_deferred)
                 path = req[:path]
                 cleanup(req)
-                ::Fiber.new { @chown_deferred.resolve(path) }.resume
+                @reactor.exec { @chown_deferred.resolve(path) }
             end
             @chown_deferred = nil
         end

data/lib/libuv/fs_event.rb

@@ -30,7 +30,7 @@ module Libuv
                 reject(e)
             else
                 # notify of a change
-                ::Fiber.new { defer.notify(filename, EVENTS[events]) }.resume
+                @reactor.exec { defer.notify(filename, EVENTS[events]) }
             end
         end
     end

data/lib/libuv/handle.rb

@@ -91,7 +91,7 @@ module Libuv
             #clear_callbacks
             cleanup_callbacks
 
-            ::Fiber.new {
+            @reactor.exec do
                 if @close_error
                     defer.reject(@close_error)
                 else
@@ -102,7 +102,7 @@ module Libuv
                     @coroutine.resolve(self)
                     @coroutine = nil
                 end
-            }.resume
+            end
         end
     end
 end

data/lib/libuv/idle.rb

@@ -48,13 +48,13 @@ module Libuv
 
 
         def on_idle(handle)
-            ::Fiber.new {
+            @reactor.exec do
                 begin
                     @callback.call
                 rescue Exception => e
                     @reactor.log e, 'performing idle callback'
                 end
-            }.resume
+            end
         end
     end
 end

data/lib/libuv/mixins/fs_checks.rb

@@ -53,7 +53,7 @@ module Libuv
                 end
 
                 cleanup(req)
-                ::Fiber.new { @stat_deferred.resolve(stats) }.resume
+                @reactor.exec { @stat_deferred.resolve(stats) }
             end
             @stat_deferred = nil
         end
@@ -80,13 +80,13 @@ module Libuv
             if error
                 cleanup(req)
 
-                ::Fiber.new {
+                @reactor.exec do
                     deferrable.reject(error)
                     if @coroutine
                         @coroutine.resolve(deferrable.promise)
                         @coroutine = nil
                     end
-                }.resume
+                end
                 false
             else
                 true

data/lib/libuv/mixins/stream.rb

@@ -201,7 +201,7 @@ module Libuv
         def on_listen(server, status)
             e = check_result(status)
 
-            ::Fiber.new {
+            @reactor.exec do
                 if e
                     reject(e)   # is this cause for closing the handle?
                 else
@@ -211,7 +211,7 @@ module Libuv
                         @reactor.log e, 'performing stream listening callback'
                     end
                 end
-            }.resume
+            end
         end
 
         def on_allocate(client, suggested_size, buffer)
@@ -226,10 +226,10 @@ module Libuv
             ::Libuv::Ext.free(req)
             buffer1.free
 
-            ::Fiber.new {
+            @reactor.exec do
                 resolve deferred, status
                 check_flush_buffer if @flush_defer
-            }.resume
+            end
         end
 
         def on_read(handle, nread, buf)
@@ -239,19 +239,19 @@ module Libuv
             if e
                 ::Libuv::Ext.free(base)
 
-                ::Fiber.new { 
+                @reactor.exec do
                     # I assume this is desirable behaviour
                     if e.is_a? ::Libuv::Error::EOF
                         close   # Close gracefully 
                     else
                         reject(e)
                     end
-                }.resume
+                end
             else
                 data = base.read_string(nread)
                 ::Libuv::Ext.free(base)
                 
-                ::Fiber.new {
+                @reactor.exec do
                     if @tls.nil?
                         begin
                             @progress.call data, self
@@ -261,7 +261,7 @@ module Libuv
                     else
                         @tls.decrypt(data)
                     end
-                }.resume
+                end
             end
         end
 
@@ -270,7 +270,7 @@ module Libuv
             ::Libuv::Ext.free(req)
             @close_error = check_result(status)
 
-            ::Fiber.new { close }.resume
+            @reactor.exec { close }
         end
     end
 end

data/lib/libuv/pipe.rb

@@ -165,13 +165,13 @@ module Libuv
                 @reactor.log e, 'pipe accept failed'
             end
             if pipe
-                ::Fiber.new {
+                @reactor.exec do
                     begin
                         @on_accept.call(pipe)
                     rescue Exception => e
                         @reactor.log e, 'performing pipe accept callback'
                     end
-                }.resume
+                end
             end
         end
 
@@ -180,7 +180,7 @@ module Libuv
             ::Libuv::Ext.free(req)
             e = check_result(status)
 
-            ::Fiber.new {
+            @reactor.exec do
                 if e
                     reject(e)
                 else
@@ -190,7 +190,7 @@ module Libuv
                         @reactor.log e, 'performing pipe connected callback'
                     end
                 end
-            }.resume
+            end
         end
 
         def write2_complete(req, status)
@@ -199,9 +199,9 @@ module Libuv
 
             ::Libuv::Ext.free(req)
             
-            ::Fiber.new {
+            @reactor.exec do
                 resolve promise, status
-            }.resume
+            end
         end
 
         def windows_path(name)

data/lib/libuv/prepare.rb

@@ -48,13 +48,13 @@ module Libuv
 
 
         def on_prepare(handle)
-            ::Fiber.new {
+            @reactor.exec do
                 begin
                     @callback.call
                 rescue Exception => e
                     @reactor.log e, 'performing prepare callback'
                 end
-            }.resume
+            end
         end
     end
 end

data/lib/libuv/reactor.rb

@@ -58,6 +58,7 @@ module Libuv
             @reactor = self
             @run_count = 0
             @ref_count = 0
+            @fiber_pool = FiberPool.new(self)
 
             # Create an async call for scheduling work from other threads
             @run_queue = Queue.new
@@ -91,9 +92,10 @@ module Libuv
             @reactor_notify_default = @reactor_notify = proc { |error|
                 @throw_on_exit = error
             }
+            @fiber_pool.on_error &@reactor_notify
         end
 
-        attr_reader :run_count
+        attr_reader :run_count, :fiber_pool
 
 
         protected
@@ -128,7 +130,7 @@ module Libuv
             update_time
             length.times do
                 # This allows any item to pause its execution without effecting this loop
-                ::Fiber.new { process_item }.resume
+                @fiber_pool.exec { process_item }
             end
         end
 
@@ -167,17 +169,8 @@ module Libuv
 
                     Thread.current.thread_variable_set(:reactor, @reactor)
                     @throw_on_exit = nil
-
-                    if block_given?
-                        update_time
-                        ::Fiber.new {
-                            begin
-                                yield @reactor
-                            rescue Exception => e
-                                log(e, 'in reactor run block')
-                            end
-                        }.resume
-                    end
+                    update_time
+                    @fiber_pool.exec { yield @reactor } if block_given?
                     @run_count += 1
                     ::Libuv::Ext.run(@pointer, run_type)  # This is blocking
                 ensure
@@ -201,6 +194,11 @@ module Libuv
             @reactor
         end
 
+        # Execute the provided block of code in a fiber from the pool
+        def exec
+            @fiber_pool.exec { yield }
+        end
+
         # Prevents the reactor loop from stopping
         def ref
             if reactor_thread? && reactor_running?

data/lib/libuv/signal.rb

@@ -54,9 +54,9 @@ module Libuv
 
 
         def on_sig(handle, signal)
-            ::Fiber.new {
+            @reactor.exec do
                 defer.notify(signal)   # notify of a call
-            }.resume
+            end
         end
     end
 end

data/lib/libuv/spawn.rb

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+module Libuv
+    class Spawn < Handle
+        define_callback function: :on_exit, params: [:pointer, :int64, :int]
+
+        attr_reader :stdin, :stdout, :stderr
+
+        # @param reactor [::Libuv::Reactor] reactor this timer will be associated
+        # @param callback [Proc] callback to be called when the timer is triggered
+        def initialize(reactor, cmd, working_dir: '.', args: [], env: nil, flags: 0, mode: :capture)
+            @reactor = reactor
+
+            process_ptr = ::Libuv::Ext.allocate_handle_process
+            @options = Ext::UvProcessOptions.new
+
+            # Configure IO objects
+            @io_obj = Ext::StdioObjs.new
+            case mode.to_sym
+            when :capture
+                @stdin  = @reactor.pipe
+                @stdout = @reactor.pipe
+                @stderr = @reactor.pipe
+                @io_obj[:stdin] = build_stdio(:CREATE_READABLE_PIPE, pipe: @stdin)
+                @io_obj[:stdout] = build_stdio(:CREATE_WRITABLE_PIPE, pipe: @stdout)
+                @io_obj[:stderr] = build_stdio(:CREATE_WRITABLE_PIPE, pipe: @stderr)
+            when :ignore
+                @io_obj[:stdin] = build_stdio(:UV_IGNORE)
+                @io_obj[:stdout] = build_stdio(:UV_IGNORE)
+                @io_obj[:stderr] = build_stdio(:UV_IGNORE)
+            when :inherit
+                @io_obj[:stdin] = build_stdio(:UV_INHERIT_FD, fd: ::STDIN.fileno)
+                @io_obj[:stdout] = build_stdio(:UV_INHERIT_FD, fd: ::STDOUT.fileno)
+                @io_obj[:stderr] = build_stdio(:UV_INHERIT_FD, fd: ::STDERR.fileno)
+            end
+
+            # Configure arguments
+            @cmd = FFI::MemoryPointer.from_string(cmd)
+            @args = args.map { |arg| FFI::MemoryPointer.from_string(arg) }
+            @args.unshift(@cmd)
+            @args_ptr = FFI::MemoryPointer.new(:pointer, @args.length + 1)
+            @args_ptr.write_array_of_pointer(@args)
+
+            # Configure environment
+            if env
+                @env = env.map { |e| FFI::MemoryPointer.from_string(e) }
+                @env_ptr = FFI::MemoryPointer.new(:pointer, @env.length + 1)
+                @env_ptr.write_array_of_pointer(@env)
+            end
+
+            @working_dir = FFI::MemoryPointer.from_string(working_dir)
+
+            # Apply the options
+            @options[:exit_cb] = callback(:on_exit, process_ptr.address)
+            @options[:file] = @cmd
+            @options[:args] = @args_ptr
+            @options[:env] = @env_ptr
+            @options[:cwd] = @working_dir
+            @options[:flags] = 0
+            @options[:stdio_count] = 3
+            @options[:stdio] = @io_obj
+
+            error = check_result(::Libuv::Ext.spawn(reactor.handle, process_ptr, @options))
+            super(process_ptr, error)
+        end
+
+        def kill(signal = 2)
+            return self if @closed
+            ::Libuv::Ext.process_kill(handle, signal)
+            self
+        end
+
+
+        private
+
+
+        def build_stdio(flags, pipe: nil, fd: nil)
+            io = Ext::UvStdioContainer.new
+            io[:flags] = flags
+            if pipe
+                io[:data][:pipe_handle] = pipe.handle
+            elsif fd
+                io[:data][:fd] = fd
+            end
+            io
+        end
+
+        def on_exit(handle, exit_status, term_signal)
+            @reactor.exec do
+                if exit_status == 0
+                    @defer.resolve(term_signal)
+                else
+                    err = ::Libuv::Error::ProcessExitCode.new "Non-zero exit code returned #{exit_status}"
+                    err.exit_status = exit_status
+                    err.term_signal = term_signal
+                    @defer.reject(err)
+                end
+
+                if @stdin
+                    @reactor.next_tick do
+                        @stdin.close
+                        @stdout.close
+                        @stderr.close
+
+                        close
+                    end
+                else
+                    close
+                end
+            end
+        end
+    end
+end

data/lib/libuv/tcp.rb

@@ -12,7 +12,7 @@ module Libuv
         define_callback function: :on_connect, params: [:pointer, :int]
 
 
-        TLS_ERROR = "TLS write failed".freeze
+        TLS_ERROR = "TLS write failed"
 
 
         attr_reader :connected
@@ -259,7 +259,7 @@ module Libuv
                 @callback = callback || blk
                 @coroutine = @reactor.defer if @callback.nil?
             end
-            error = check_result UV.tcp_open(handle, fd)
+            error = check_result ::Libuv::Ext.tcp_open(handle, fd)
             reject(error) if error
             co @coroutine.promise if @coroutine
 
@@ -288,6 +288,7 @@ module Libuv
             self
         end
 
+        # The name of the client (local) end of the socket
         def sockname
             return [] if @closed
             sockaddr, len = get_sockaddr_and_len
@@ -295,6 +296,7 @@ module Libuv
             get_ip_and_port(::Libuv::Ext::Sockaddr.new(sockaddr), len.get_int(0))
         end
 
+        # The IP address of the peer (remote) end of the socket
         def peername
             return [] if @closed
             sockaddr, len = get_sockaddr_and_len
@@ -355,7 +357,7 @@ module Libuv
             ::Libuv::Ext.free(req)
             e = check_result(status)
 
-            ::Fiber.new {
+            @reactor.exec do
                 if e
                     reject(e)
                 else
@@ -375,7 +377,7 @@ module Libuv
                         @reactor.log e, 'performing TCP connection callback'
                     end
                 end
-            }.resume
+            end
         end
 
         def accept(_)
@@ -383,13 +385,13 @@ module Libuv
                 raise RuntimeError, CLOSED_HANDLE_ERROR if @closed
                 tcp = TCP.new(reactor, handle, **@tls_options)
 
-                ::Fiber.new {
+                @reactor.exec do
                     begin
                         @on_accept.call(tcp)
                     rescue Exception => e
                         @reactor.log e, 'performing TCP accept callback'
                     end
-                }.resume
+                end
             rescue Exception => e
                 @reactor.log e, 'failed to accept TCP connection'
             end

data/lib/libuv/timer.rb

@@ -97,13 +97,13 @@ module Libuv
 
 
         def on_timer(handle)
-            ::Fiber.new {
+            @reactor.exec do
                 begin
                     @callback.call
                 rescue Exception => e
                     @reactor.log e, 'performing timer callback'
                 end
-            }.resume
+            end
         end
     end
 end

data/lib/libuv/udp.rb

@@ -47,9 +47,9 @@ module Libuv
             self
         end
 
-        def open(fd, binding = true, callback = nil, &blk)
+        def open(fd, binding = true)
             return if @closed
-            error = check_result UV.udp_open(handle, fd)
+            error = check_result ::Libuv::Ext.udp_open(handle, fd)
             reject(error) if error
 
             self
@@ -268,20 +268,20 @@ module Libuv
             e = check_result(nread)
 
             if e
-                ::Fiber.new { reject(e) }.resume   # Will call close
+                @reactor.exec { reject(e) }   # Will call close
             elsif nread > 0
                 data = @receive_buff.read_string(nread)
                 unless sockaddr.null?
                     ip, port = get_ip_and_port(sockaddr)
                 end
 
-                ::Fiber.new {
+                @reactor.exec do
                     begin
                         @progress.call data, ip, port, self
                     rescue Exception => e
                         @reactor.log e, 'performing UDP data received callback'
                     end
-                }.resume
+                end
             else
                 ::Libuv::Ext.free(@receive_buff)
                 @receive_buff = nil
@@ -296,7 +296,7 @@ module Libuv
             ::Libuv::Ext.free(req)
             buffer1.free
 
-            ::Fiber.new { resolve deferred, status }.resume
+            @reactor.exec { resolve(deferred, status) }
         end
     end
 end

data/lib/libuv/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Libuv
-    VERSION = '3.1.9'
+    VERSION = '3.2.0'
 end

data/lib/libuv/work.rb

@@ -58,7 +58,7 @@ module Libuv
             @complete = true
             ::Libuv::Ext.free(req)
 
-            ::Fiber.new {
+            @reactor.exec do
                 e = check_result(status)
                 if e
                     @defer.reject(e)
@@ -69,8 +69,8 @@ module Libuv
                         @defer.resolve(@result)
                     end
                 end
-            }.resume
-            
+            end
+
             # Clean up references
             cleanup_callbacks @instance_id
         end

data/spec/idle_spec.rb

@@ -35,7 +35,7 @@ describe Libuv::Idle do
 				@reactor.stop
 			}.start(1000)
 
-			expect(@reactor.active_handles).to eq(4)
+			expect(@reactor.active_handles).to be >= 4
 		}
 
 		expect(@general_failure).to eq([])

data/spec/spawn_spec.rb

@@ -0,0 +1,119 @@
+require 'libuv'
+
+describe Libuv::Spawn do
+    describe 'basic spawn of external process' do
+        it "should accept arguments and return an termination signal code" do
+            @reactor = Libuv::Reactor.new
+            @log = []
+            @reactor.run { |reactor|
+                begin
+                    p = Libuv::Spawn.new(reactor, './spec/test.sh', args: ['arg1', 'arg2'], env: ['SOME_VAR=123'])
+                    p.stdout.progress do |data|
+                        @log << data
+                    end
+                    p.stdout.start_read
+                    @log << p.value
+                rescue => e
+                    @log << e
+                    @reactor.stop
+                end
+            }
+
+            term_signal = @log.pop
+            expect(term_signal).to be(0)
+
+            expect(@log[0]).to eq("123\narg1\narg2\n")
+        end
+
+        it "should return termination signal if exit code was 0" do
+            @reactor = Libuv::Reactor.new
+            @log = []
+            @reactor.run { |reactor|
+                begin
+                    p = Libuv::Spawn.new(reactor, './spec/test.sh', args: ['arg1', 'arg2'], env: ['SOME_VAR=123'])
+                    p.kill
+                    p.stdout.progress do |data|
+                        @log << data
+                    end
+                    p.stdout.start_read
+                    @log << p.value
+                rescue => e
+                    @log << e
+                    @reactor.stop
+                end
+            }
+
+            term_signal = @log.pop
+            expect(term_signal).to be(2)
+            expect(@log[0]).to be(nil)
+        end
+
+        it "should fail if exit code was not 0 and read output from stderr" do
+            @reactor = Libuv::Reactor.new
+            @log = []
+            @reactor.run { |reactor|
+                begin
+                    p = Libuv::Spawn.new(reactor, './spec/test_fail.sh')
+                    p.stderr.progress do |data|
+                        @log << data
+                    end
+                    p.stderr.start_read
+                    @log << p.value
+                rescue => e
+                    @log << e
+                    @reactor.stop
+                end
+            }
+
+            stderr = @log[0]
+            e = @log[1]
+            expect(e.class).to be(::Libuv::Error::ProcessExitCode)
+            expect(e.exit_status).to be(1)
+            expect(e.term_signal).to be(0)
+            expect(stderr.length).to be > 0
+        end
+
+        it "should be interactive" do
+            @reactor = Libuv::Reactor.new
+            @log = []
+            @reactor.run { |reactor|
+                begin
+                    p = Libuv::Spawn.new(reactor, './spec/test_read.sh')
+                    p.stdout.progress do |data|
+                        @log << data
+                    end
+                    p.stdout.start_read
+                    p.stdin.write("2017\n")
+                    @log << p.value
+                rescue => e
+                    @log << e
+                    @reactor.stop
+                end
+            }
+
+            term_signal = @log.pop
+            expect(term_signal).to be(0)
+
+            expect(@log[0]).to eq("you entered 2017 - sweet\n")
+        end
+
+        it "should support inheriting parent processes streams" do
+            @reactor = Libuv::Reactor.new
+            @log = []
+            @reactor.run { |reactor|
+                begin
+                    p = Libuv::Spawn.new(reactor, './spec/test.sh', args: ['arg1', 'arg2'], env: ['SOME_VAR=123'], mode: :inherit)
+                    @log << p.stdout
+                    @log << p.value
+                rescue => e
+                    @log << e
+                    @reactor.stop
+                end
+            }
+
+            term_signal = @log.pop
+            expect(term_signal).to be(0)
+            expect(@log[0]).to be(nil)
+        end
+    end
+end

data/spec/test.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+echo $SOME_VAR
+echo $1
+echo $2

data/spec/test_fail.sh

@@ -0,0 +1,3 @@
+#!/bin/bash
+ech $SOME_VAR
+exit 1

data/spec/test_read.sh

@@ -0,0 +1,3 @@
+#!/bin/bash
+read year
+echo "you entered $year - sweet"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: libuv
 version: !ruby/object:Gem::Version
-  version: 3.1.9
+  version: 3.2.0
 platform: ruby
 authors:
 - Stephen von Takach
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-06-01 00:00:00.000000000 Z
+date: 2017-07-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -450,6 +450,7 @@ files:
 - ext/libuv/test/test-poll-close-doesnt-corrupt-stack.c
 - ext/libuv/test/test-poll-close.c
 - ext/libuv/test/test-poll-closesocket.c
+- ext/libuv/test/test-poll-oob.c
 - ext/libuv/test/test-poll.c
 - ext/libuv/test/test-process-title.c
 - ext/libuv/test/test-queue-foreach-delete.c
@@ -517,6 +518,7 @@ files:
 - ext/libuv/test/test-walk-handles.c
 - ext/libuv/test/test-watcher-cross-stop.c
 - ext/libuv/tools/make_dist_html.py
+- ext/libuv/tools/vswhere_usability_wrapper.cmd
 - ext/libuv/uv.gyp
 - ext/libuv/vcbuild.bat
 - lib/libuv.rb
@@ -534,6 +536,7 @@ files:
 - lib/libuv/ext/tasks/unix.rb
 - lib/libuv/ext/tasks/win.rb
 - lib/libuv/ext/types.rb
+- lib/libuv/fiber_pool.rb
 - lib/libuv/file.rb
 - lib/libuv/filesystem.rb
 - lib/libuv/fs_event.rb
@@ -551,6 +554,7 @@ files:
 - lib/libuv/q.rb
 - lib/libuv/reactor.rb
 - lib/libuv/signal.rb
+- lib/libuv/spawn.rb
 - lib/libuv/tcp.rb
 - lib/libuv/timer.rb
 - lib/libuv/tty.rb
@@ -567,7 +571,11 @@ files:
 - spec/filesystem_spec.rb
 - spec/idle_spec.rb
 - spec/pipe_spec.rb
+- spec/spawn_spec.rb
 - spec/tcp_spec.rb
+- spec/test.sh
+- spec/test_fail.sh
+- spec/test_read.sh
 - spec/timer_spec.rb
 - spec/udp_spec.rb
 - spec/zen_spec.rb
@@ -591,7 +599,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.10
+rubygems_version: 2.6.12
 signing_key: 
 specification_version: 4
 summary: libuv bindings for Ruby
@@ -605,7 +613,11 @@ test_files:
 - spec/filesystem_spec.rb
 - spec/idle_spec.rb
 - spec/pipe_spec.rb
+- spec/spawn_spec.rb
 - spec/tcp_spec.rb
+- spec/test.sh
+- spec/test_fail.sh
+- spec/test_read.sh
 - spec/timer_spec.rb
 - spec/udp_spec.rb
 - spec/zen_spec.rb