murasaki 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0acb7462bef6b0277cbfdfbb84ba90f3394158df
-  data.tar.gz: 1ea68e3f5bc60ac1af1df69f7c1c250414a67f21
+  metadata.gz: 9ecdeb71724f0d1efe13027d3acee86a7575b1f4
+  data.tar.gz: 4523b9a2b5ebb11f93002b3190d360bc8ac667e3
 SHA512:
-  metadata.gz: dfb808c62ad84b2ebde6088251a95d092800c0937b7fa8d9022dcbc0e98af00ce5491befc66f99fdfda3cb1f0b25b9cfd2a9c8f73fd8267699c9479e46fc71e1
-  data.tar.gz: f1070c1e11587753a49c0bfc54ba2d91f4078dd716fa31080c65d3d3b539953c708ff14f981cc1857a256f51777dc6fe2ce0d04f99a088b7a06c3fa468b569ce
+  metadata.gz: ed8ca771ea23774b154477690d892ae658861fe929c42511357249468a562a5a598f005ae90f0b6798dc88d292ee6c948e815c2d52a0154b74cb05079bead52a
+  data.tar.gz: 81e4529da54237d5fe8dbe536c86eaca74c99055c60f781fe9aac6247728babeed2ac8ce19dedca4653db62390e59d7ecd88340b5cde2adf3dd4ee4bdb4d20e4

data/.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+
+[*.rb]
+indent_style = space
+indent_size = 2

data/lib/murasaki.rb

@@ -0,0 +1,7 @@
+require 'fiber'
+require 'nio'
+
+require_relative 'murasaki/version'
+require_relative 'murasaki/event_loop'
+require_relative 'murasaki/timer'
+require_relative 'murasaki/promise'

data/lib/murasaki/event_loop.rb

@@ -0,0 +1,118 @@
+##
+# EventLoop Module, providing main loop for events
+module EventLoop
+  class << self
+    # Config EvnetLoop, call by default if any other methods called
+    # @param [NIO::Selector] selector an event selector
+    def config(selector = NIO::Selector.new)
+      # Raw NIO Selector
+      @selector = selector
+      # Array of active timers
+      @timers = []
+      # Hash of io and its callback
+      @ios = Hash.new
+      # IO queue
+      @queue = Hash.new
+    end
+
+    # Add timer in event loop
+    # @param [EventLoop::Timer] timer timer to insert
+    # @return [nil] nil
+    def add_timer(timer)
+      config if @selector.nil?
+      timer.start_time = Time.now.to_f + timer.time
+      @timers << timer
+      nil
+    end
+
+    # Register I/O event with queue protection
+    # @param [IO] io io to register
+    # @param [Symbol] interest :r for read only, :w for write only, and :rw for both
+    # @yield what to run when io callbacks
+    # @return [nil] nil
+    def register(io, interest=(:rw), &callback)
+      config if @selector.nil?
+      if @queue[io.to_i].nil?
+        @queue[io.to_i] = Array.new
+        register_raw(io, interest, callback)
+      else
+        @queue[io.to_i] << [io, interest, callback]
+      end
+      nil
+    end
+
+    # Register I/O event directly, without any queue protection
+    # @param [IO] io io to register
+    # @param [Symbol] interest :r for read only, :w for write only, and :rw for both
+    # @param [Proc] callback what to run when io callbacks
+    # @return [nil] nil
+    def register_raw(io, interest=(:rw), callback)
+      config if @selector.nil?
+      @selector.register(io, interest)
+      @ios[io] = { callback: callback }
+      nil
+    end
+
+    # Deregister I/O event
+    # @param [IO] io io to deregister
+    # @return [nil] nil
+    def deregister(io)
+      fd = io.to_i
+      @selector.deregister(io)
+      @ios.delete(io)
+      next_register = @queue[fd].shift
+      next_register.nil? ? @queue.delete(fd) : register_raw(*next_register)
+      nil
+    end
+
+    # Run I/O selector once
+    # @return [nil] nil
+    def run_once
+      config if @selector.nil?
+      @selector.select(0.2) do |monitor| # Timeout for 0.2 secs
+        @ios[monitor.io][:callback].call(monitor)
+      end
+      timer_once
+      nil
+    end
+
+    # Run timer once
+    # @return [nil] nil
+    def timer_once
+      config if @selector.nil?
+      now_time = Time.now.to_f
+      @timers.delete_if do |timer|
+        if timer.start_time < now_time
+          timer.callback.call
+          true
+        end
+      end
+      nil
+    end
+
+    # Start the event loop
+    # @return [nil] nil
+    def start
+      return if running?
+      @stop = false
+      until @stop
+        run_once
+      end
+      @stop = nil
+    end
+
+    # Set the stop flag
+    # @return [nil] nil
+    def stop
+      @stop = true
+      nil
+    end
+
+    # Detect the stop flag
+    # @return [Boolean] return if eventloop is set to be stopped
+    def running?
+      @stop = true if @stop.nil?
+      !@stop
+    end
+  end
+end

data/lib/murasaki/promise.rb

@@ -0,0 +1,70 @@
+##
+# Meta-programming String for Syntactic Sugars
+# Referenced from {Qiita}[http://qiita.com/south37/items/99a60345b22ef395d424]
+class Promise
+  # Init a Promise
+  # @param [Proc] callback an async method
+  def initialize(&callback)
+    @callback = callback
+  end
+
+  # Define what to do after a method callbacks
+  # @param [Proc] resolve what on callback
+  # @return [nil] nil
+  def then(&resolve)
+    @callback.call(resolve)
+  end
+end
+
+module Kernel
+  # Make fiber as async chain
+  # @param [Fiber] fiber root of async chain
+  def async_fiber(fiber)
+    chain = proc do |result|
+      next unless result.is_a? Promise
+      result.then do |val|
+        chain.call(fiber.resume(val))
+      end
+    end
+    chain.call(fiber.resume)
+  end
+
+  # Define an async method
+  # @param [Symbol] method method name
+  # @yield async method
+  # @example
+  #   async :hello do 
+  #     puts 'Hello'
+  #   end
+  def async(method)
+    define_singleton_method method do |*args|
+      async_fiber(Fiber.new {yield(*args)})
+    end
+  end
+
+  # Block the I/O to wait for async method response
+  # @param [Promise] promise promise method
+  # @example
+  #   result = await SQL.query('SELECT * FROM hello')
+  def await(promise)
+    result = Fiber.yield promise
+    if result.is_a? PromiseException
+      raise result.payload
+    end
+    result
+  end
+end
+
+
+##
+# Exceptions for Promises
+# @!attribute [r] payload
+#   @return [Exception] raw execption
+class PromiseException < Exception
+  attr_reader :payload
+  # Init PromiseException with existed Exception
+  # @param [Exception] payload raw execption
+  def initialize(payload)
+    @payload = payload
+  end
+end

data/lib/murasaki/timer.rb

@@ -0,0 +1,22 @@
+##
+# Timer Object in EventLoop
+# @!attribute [r] time
+#   @return [Float] timeout length
+# @!attribute [r] callback
+#   @return [Proc] proc to call when callbacks
+# @!attribute start_time
+#   @return [Float] when timer should callbacks
+class EventLoop::Timer
+
+  attr_reader :time, :callback
+  attr_accessor :start_time
+
+  # Init a timer with a time period and callback
+  # @param [Float] time timeout length
+  # @yield proc to call when callbacks
+  def initialize(time, &callback)
+    @time = time
+    @callback = callback
+    @start_time = Float::INFINITY
+  end
+end

data/lib/murasaki/version.rb

@@ -0,0 +1,5 @@
+# Murasaki Module
+module Murasaki
+  # Current Version Code
+  VERSION = '0.1.0'.freeze
+end

data/murasaki.gemspec

@@ -0,0 +1,19 @@
+require './lib/murasaki/version'
+
+Gem::Specification.new do |s|
+  s.name                     = 'murasaki'
+  s.version                  = Murasaki::VERSION
+  s.required_ruby_version    = '>=2.2.6'
+  s.date                     = Time.now.strftime('%Y-%m-%d')
+  s.summary                  = 'Event Kernel for Ruby'
+  s.description              = 'Event Kernel for Ruby, power for midori project'
+  s.authors                  = ['HeckPsi Lab']
+  s.email                    = 'business@heckpsi.com'
+  s.require_paths            = ['lib']
+  s.files                    = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(spec|.resources)/}) } \
+    - %w(README.md CONTRIBUTOR_COVENANT_CODE_OF_CONDUCT.md Gemfile Rakefile em-midori.gemspec .gitignore .rspec .codeclimate.yml .rubocop.yml .travis.yml logo.png Rakefile Gemfile)
+  s.homepage                 = 'https://github.com/heckpsi-lab/murasaki'
+  s.metadata                 = { 'issue_tracker' => 'https://github.com/heckpsi-lab/murasaki/issues' }
+  s.license                  = 'MIT'
+  s.add_runtime_dependency     'nio4r', '~> 2.0'
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: murasaki
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - HeckPsi Lab
@@ -9,14 +9,35 @@ autorequire:
 bindir: bin
 cert_chain: []
 date: 2017-06-13 00:00:00.000000000 Z
-dependencies: []
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nio4r
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 description: Event Kernel for Ruby, power for midori project
 email: business@heckpsi.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".editorconfig"
 - LICENSE
+- lib/murasaki.rb
+- lib/murasaki/event_loop.rb
+- lib/murasaki/promise.rb
+- lib/murasaki/timer.rb
+- lib/murasaki/version.rb
+- murasaki.gemspec
 homepage: https://github.com/heckpsi-lab/murasaki
 licenses:
 - MIT