uvrb 0.1.0

data/lib/uv/fs_event.rb

@@ -0,0 +1,21 @@
+module UV
+  class FSEvent
+    include Handle
+
+    EVENTS = {1 => :rename, 2 => :change}.freeze
+
+    def initialize(loop, fs_event_ptr, &block)
+      @fs_event_block = block
+
+      super(loop, fs_event_ptr)
+    end
+
+    private
+
+    def on_fs_event(handle, filename, events, status)
+      @fs_event_block.call(check_result(status), filename, EVENTS[events])
+    end
+
+    public :callback
+  end
+end

data/lib/uv/handle.rb

@@ -0,0 +1,65 @@
+module UV
+  module Handle
+    include Assertions, Resource, Listener
+
+    def initialize(loop, pointer)
+      @loop, @pointer = loop, pointer
+    end
+
+    # Public: Increment internal ref counter for the handle on the loop. Useful for
+    # extending the loop with custom watchers that need to make loop not stop
+    # 
+    # Returns self
+    def ref
+      UV.ref(@pointer)
+
+      self
+    end
+
+    # Public: Decrement internal ref counter for the handle on the loop, useful to stop
+    # loop even when there are outstanding open handles
+    # 
+    # Returns self
+    def unref
+      UV.unref(@pointer)
+
+      self
+    end
+
+    def close(&block)
+      assert_block(block)
+      assert_arity(0, block)
+
+      @close_block = block
+
+      UV.close(@pointer, callback(:on_close))
+
+      self
+    end
+
+    def active?
+      UV.is_active(@pointer) > 0
+    end
+
+    def closing?
+      UV.is_closing(@pointer) > 0
+    end
+
+    protected
+
+    def loop; @loop; end
+    def handle; @pointer; end
+
+    private
+
+    def handle_name
+      self.class.name.split('::').last.downcase.to_sym
+    end
+
+    def on_close(pointer)
+      UV.free(pointer)
+      clear_callbacks
+      @close_block.call
+    end
+  end
+end

data/lib/uv/idle.rb

@@ -0,0 +1,27 @@
+module UV
+  class Idle
+    include Handle
+
+    def start(&block)
+      assert_block(block)
+      assert_arity(1, block)
+
+      @idle_block = block
+
+      check_result! UV.idle_start(handle, callback(:on_idle))
+
+      self
+    end
+
+    def stop
+      check_result! UV.idle_stop(handle)
+
+      self
+    end
+
+    private
+    def on_idle(handle, status)
+      @idle_block.call(check_result(status))
+    end
+  end
+end

data/lib/uv/listener.rb

@@ -0,0 +1,26 @@
+require 'set'
+
+module UV
+  module Listener
+    private
+    def callbacks
+      @callbacks ||= Set.new
+    end
+
+    def callback(name)
+      const_name = "#{name.upcase}_#{object_id}"
+      unless self.class.const_defined?(const_name)
+        callbacks << const_name
+        self.class.const_set(const_name, method(name))
+      end
+      self.class.const_get(const_name)
+    end
+
+    def clear_callbacks
+      callbacks.each do |name|
+        self.class.send(:remove_const, name)
+      end
+      callbacks.clear
+    end
+  end
+end

data/lib/uv/loop.rb

@@ -0,0 +1,326 @@
+require 'thread'
+
+module UV
+  class Loop
+    module ClassMethods
+      # Public: Get default loop
+      # 
+      # Returns UV::Loop
+      def default
+        create(UV.default_loop)
+      end
+
+      # Public: Create new loop
+      # 
+      # Returns UV::Loop
+      def new
+        create(UV.loop_new)
+      end
+
+      # Internal: Create custom loop from pointer
+      # 
+      # Returns UV::Loop
+      def create(pointer)
+        allocate.tap { |i| i.send(:initialize, FFI::AutoPointer.new(pointer, UV.method(:loop_delete))) }
+      end
+    end
+
+    extend ClassMethods
+
+    include Resource, Assertions
+
+    # Internal: Initialize a loop using an FFI::Pointer
+    # 
+    # Returns nothing
+    def initialize(pointer) # :notnew:
+      @pointer = pointer
+    end
+
+    # Public: Run the actual event loop. This method will block for the duration of event loop
+    # 
+    # Returns nothing.
+    #
+    # Raises UV::Error::UNKNOWN
+    # Raises UV::Error::EOF
+    # Raises UV::Error::EADDRINFO
+    # Raises UV::Error::EACCES
+    # Raises UV::Error::EAGAIN
+    # Raises UV::Error::EADDRINUSE
+    # Raises UV::Error::EADDRNOTAVAIL
+    # Raises UV::Error::EAFNOSUPPORT
+    # Raises UV::Error::EALREADY
+    # Raises UV::Error::EBADF
+    # Raises UV::Error::EBUSY
+    # Raises UV::Error::ECONNABORTED
+    # Raises UV::Error::ECONNREFUSED
+    # Raises UV::Error::ECONNRESET
+    # Raises UV::Error::EDESTADDRREQ
+    # Raises UV::Error::EFAULT
+    # Raises UV::Error::EHOSTUNREACH
+    # Raises UV::Error::EINTR
+    # Raises UV::Error::EINVAL
+    # Raises UV::Error::EISCONN
+    # Raises UV::Error::EMFILE
+    # Raises UV::Error::EMSGSIZE
+    # Raises UV::Error::ENETDOWN
+    # Raises UV::Error::ENETUNREACH
+    # Raises UV::Error::ENFILE
+    # Raises UV::Error::ENOBUFS
+    # Raises UV::Error::ENOMEM
+    # Raises UV::Error::ENOTDIR
+    # Raises UV::Error::EISDIR
+    # Raises UV::Error::ENONET
+    # Raises UV::Error::ENOTCONN
+    # Raises UV::Error::ENOTSOCK
+    # Raises UV::Error::ENOTSUP
+    # Raises UV::Error::ENOENT
+    # Raises UV::Error::ENOSYS
+    # Raises UV::Error::EPIPE
+    # Raises UV::Error::EPROTO
+    # Raises UV::Error::EPROTONOSUPPORT
+    # Raises UV::Error::EPROTOTYPE
+    # Raises UV::Error::ETIMEDOUT
+    # Raises UV::Error::ECHARSE
+    # Raises UV::Error::EAIFAMNOSUPPORT
+    # Raises UV::Error::EAISERVICE
+    # Raises UV::Error::EAISOCKTYPE
+    # Raises UV::Error::ESHUTDOWN
+    # Raises UV::Error::EEXIST
+    # Raises UV::Error::ESRCH
+    # Raises UV::Error::ENAMETOOLONG
+    # Raises UV::Error::EPERM
+    # Raises UV::Error::ELOOP
+    # Raises UV::Error::EXDEV
+    # Raises UV::Error::ENOTEMPTY
+    # Raises UV::Error::ENOSPC
+    def run
+      check_result! UV.run(@pointer)
+    end
+
+    # Public: Runs outstanding events once, yields control back
+    # 
+    # Returns nothing.
+    #
+    # Raises UV::Error::UNKNOWN
+    # Raises UV::Error::EOF
+    # Raises UV::Error::EADDRINFO
+    # Raises UV::Error::EACCES
+    # Raises UV::Error::EAGAIN
+    # Raises UV::Error::EADDRINUSE
+    # Raises UV::Error::EADDRNOTAVAIL
+    # Raises UV::Error::EAFNOSUPPORT
+    # Raises UV::Error::EALREADY
+    # Raises UV::Error::EBADF
+    # Raises UV::Error::EBUSY
+    # Raises UV::Error::ECONNABORTED
+    # Raises UV::Error::ECONNREFUSED
+    # Raises UV::Error::ECONNRESET
+    # Raises UV::Error::EDESTADDRREQ
+    # Raises UV::Error::EFAULT
+    # Raises UV::Error::EHOSTUNREACH
+    # Raises UV::Error::EINTR
+    # Raises UV::Error::EINVAL
+    # Raises UV::Error::EISCONN
+    # Raises UV::Error::EMFILE
+    # Raises UV::Error::EMSGSIZE
+    # Raises UV::Error::ENETDOWN
+    # Raises UV::Error::ENETUNREACH
+    # Raises UV::Error::ENFILE
+    # Raises UV::Error::ENOBUFS
+    # Raises UV::Error::ENOMEM
+    # Raises UV::Error::ENOTDIR
+    # Raises UV::Error::EISDIR
+    # Raises UV::Error::ENONET
+    # Raises UV::Error::ENOTCONN
+    # Raises UV::Error::ENOTSOCK
+    # Raises UV::Error::ENOTSUP
+    # Raises UV::Error::ENOENT
+    # Raises UV::Error::ENOSYS
+    # Raises UV::Error::EPIPE
+    # Raises UV::Error::EPROTO
+    # Raises UV::Error::EPROTONOSUPPORT
+    # Raises UV::Error::EPROTOTYPE
+    # Raises UV::Error::ETIMEDOUT
+    # Raises UV::Error::ECHARSE
+    # Raises UV::Error::EAIFAMNOSUPPORT
+    # Raises UV::Error::EAISERVICE
+    # Raises UV::Error::EAISOCKTYPE
+    # Raises UV::Error::ESHUTDOWN
+    # Raises UV::Error::EEXIST
+    # Raises UV::Error::ESRCH
+    # Raises UV::Error::ENAMETOOLONG
+    # Raises UV::Error::EPERM
+    # Raises UV::Error::ELOOP
+    # Raises UV::Error::EXDEV
+    # Raises UV::Error::ENOTEMPTY
+    # Raises UV::Error::ENOSPC
+    def run_once
+      check_result! UV.run_once(@pointer)
+    end
+
+    # Public: forces loop time update, useful for getting more granular times
+    # 
+    # Returns nothing
+    def update_time
+      UV.update_time(@pointer)
+    end
+
+    # Public: Get current time in microseconds
+    # 
+    # Returns timestamp with microseconds as an Integer
+    def now
+      UV.now(@pointer)
+    end
+
+    # Internal: Get last error from the loop
+    # 
+    # Returns one of UV::Error or nil
+    def last_error
+      err  = UV.last_error(@pointer)
+      name = UV.err_name(err)
+      msg  = UV.strerror(err)
+
+      return nil if name == "OK"
+
+      Error.const_get(name.to_sym).new(msg)
+    end
+
+    # Public: Get a new timer instance
+    # 
+    # Returns UV::Timer
+    def timer
+      timer_ptr = UV.create_handle(:uv_timer)
+
+      check_result! UV.timer_init(@pointer, timer_ptr)
+      Timer.new(self, timer_ptr)
+    end
+
+    # Public: Get a new TCP instance
+    # 
+    # Returns UV::TCP instance
+    def tcp
+      tcp_ptr = UV.create_handle(:uv_tcp)
+
+      check_result! UV.tcp_init(@pointer, tcp_ptr)
+      TCP.new(self, tcp_ptr)
+    end
+
+    # Public: Get a new UDP instance
+    #
+    # Returns UV::UDP instance
+    def udp
+      udp_ptr = UV.create_handle(:uv_udp)
+
+      check_result! UV.udp_init(@pointer, udp_ptr)
+      UV::UDP.new(self, udp_ptr)
+    end
+
+    # Public: Get a new TTY instance
+    # 
+    # fileno   - Integer file descriptor of a tty device.
+    # readable - Boolean wether TTY is readable or not
+    # 
+    # Returns UV::TTY
+    # 
+    # Raises ArgumentError if fileno argument is not an Integer
+    # Raises Argument error if readable is not a Boolean
+    def tty(fileno, readable = false)
+      assert_type(Integer, fileno, "io#fileno must return an integer file descriptor, #{fileno.inspect} given")
+      assert_boolean(readable)
+
+      tty_ptr = UV.create_handle(:uv_tty)
+
+      check_result! UV.tty_init(@pointer, tty_ptr, fileno, readable ? 1 : 0)
+      TTY.new(self, tty_ptr)
+    end
+
+    # Public: Get a new Pipe instance
+    # 
+    # ipc - Boolean wether handle will be used for ipc, useful for sharing tcp socket
+    #       between processes
+    # 
+    # Returns UV::Pipe
+    def pipe(ipc = false)
+      assert_boolean(ipc)
+
+      pipe_ptr = UV.create_handle(:uv_pipe)
+
+      check_result! UV.pipe_init(@pointer, pipe_ptr, ipc ? 1 : 0)
+      Pipe.new(self, pipe_ptr)
+    end
+
+    # Public: Get a new Prepare handle
+    # 
+    # Returns UV::Prepare
+    def prepare
+      prepare_ptr = UV.create_handle(:uv_prepare)
+
+      check_result! UV.prepare_init(@pointer, prepare_ptr)
+      Prepare.new(self, prepare_ptr)
+    end
+
+    # Public: Get a new Check handle
+    # 
+    # Returns UV::Check
+    def check
+      check_ptr = UV.create_handle(:uv_check)
+
+      check_result! UV.check_init(@pointer, check_ptr)
+      Check.new(self, check_ptr)
+    end
+
+    # Public: Get a new Idle handle
+    # 
+    # Returns UV::Handle
+    def idle
+      idle_ptr = UV.create_handle(:uv_idle)
+
+      check_result! UV.idle_init(@pointer, idle_ptr)
+      Idle.new(self, idle_ptr)
+    end
+
+    # Public: Get a new Async handle
+    # 
+    # Returns UV::Async
+    # 
+    # Raises ArgumentError if block is not given and is not expecting one argument exactly
+    def async(&block)
+      assert_block(block)
+      assert_arity(1, block)
+
+      async_ptr = UV.create_handle(:uv_async)
+      async     = Async.new(self, async_ptr, &block)
+
+      check_result! UV.async_init(@pointer, async_ptr, async.callback(:on_async))
+      async
+    end
+
+    # Public: Get a new Filesystem instance
+    # 
+    # Returns UV::Filesystem
+    def fs
+      Filesystem.new(self)
+    end
+
+    # Public: Get a new FSEvent instance
+    # 
+    # Returns UV::FSEvent
+    def fs_event(path, &block)
+      assert_block(block)
+      assert_arity(3, block)
+
+      fs_event_ptr = UV.create_handle(:uv_fs_event)
+      fs_event     = FSEvent.new(self, fs_event_ptr, &block)
+
+      check_result! UV.fs_event_init(@pointer, fs_event_ptr, path, fs_event.callback(:on_fs_event), 0)
+      fs_event
+    end
+
+    # Internal: Get a hold of internal loop pointer instance
+    # 
+    # Returns FFI::Pointer
+    def to_ptr
+      @pointer
+    end
+  end
+end