ruby_channel 0.0.1

data/.gitignore

@@ -0,0 +1,3 @@
+pkg/*
+*.gem
+.bundle

data/Gemfile

@@ -0,0 +1,4 @@
+source :gemcutter
+
+# Specify your gem's dependencies in ruby_channel.gemspec
+gemspec

data/README

@@ -0,0 +1,7 @@
+This is a simple library aimed to use channels in Ruby the same concept that channels in Google's Go.
+
+Missing tests and decent README? Read the very simple code!
+
+Shame on me!
+
+MIT license... bla, bla, bla

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/lib/ruby_channel.rb

@@ -0,0 +1,29 @@
+require 'monitor'
+require 'thread'
+
+require 'ruby_channel/channel.rb'
+require 'ruby_channel/selector.rb'
+require 'ruby_channel/version.rb'
+
+module RubyChannel
+  CHANNEL_DEBUG = false
+end
+
+module Kernel
+  def go(*args)
+    Thread.new do
+      begin
+        yield(*args)
+      rescue Exception => e
+        p e
+        p e.backtrace
+      end
+    end
+  end
+
+  def select_channel
+    s = RubyChannel::Selector.new
+    yield s
+    s.select
+  end
+end

data/lib/ruby_channel/channel.rb

@@ -0,0 +1,140 @@
+module RubyChannel
+  class Channel
+    attr_reader :mutex, :queue
+
+    #
+    # Creates a new channel.
+    #
+    def initialize
+      @queue   = []
+      @waiting = []
+      @mutex   = Mutex.new
+    end
+
+    #
+    # Pushes +obj+ to the queue.
+    #
+    def push(obj)
+      @mutex.synchronize do
+        @queue.push obj
+        begin
+          t = @waiting.shift
+          t.wakeup if t
+        rescue ThreadError
+          retry
+        end
+      end
+    end
+
+    #
+    # Alias of push
+    #
+    alias << push
+
+    #
+    # Retrieves data from channel. If the channel is empty, the calling thread is
+    # suspended until data is pushed onto channel.
+    #
+    def pop
+      @mutex.synchronize do
+        loop do
+          if @queue.empty?
+            @waiting.push Thread.current
+            @mutex.sleep
+          else
+            return @queue.shift
+          end
+        end
+      end
+    end
+
+    #
+    # Retrieves data from channel like method +pop+, but if +non_block+ is true, the
+    # thread isn't suspended, and an exception is raised.
+    #
+    def pop!
+      @mutex.synchronize do
+        loop do
+          if @queue.empty?
+            raise ThreadError, "Empty Channel"
+            @waiting.push Thread.current
+            @mutex.sleep
+          else
+            return @queue.shift
+          end
+        end
+      end
+    end
+
+    #
+    # Redirect signal to other channel
+    #
+    def redirect_to(channel, callback_method=nil, *args)
+      value = self.pop
+      value.send(callback_method, *args) if callback_method
+      yield value if block_given?
+      channel << value
+    end
+    alias >> redirect_to
+
+    #
+    # Returns +true+ if the channel is empty.
+    #
+    def empty?
+      @queue.empty?
+    end
+
+    #
+    # Removes all objects from the channel.
+    #
+    def clear
+      @queue.clear
+    end
+
+    #
+    # Returns the length of the channel.
+    #
+    def length
+      @queue.length
+    end
+
+    #
+    # Alias of length.
+    #
+    alias size length
+
+    #
+    # Returns the number of threads waiting on the queue.
+    #
+    def waiting_size
+      @waiting.size
+    end
+
+    #
+    # Method called only by selector to subscribe listeners, dont
+    # use it, unless you understand exactly what you're doing!
+    #
+    def subscribe(selector)
+      channel = self
+      @mutex.synchronize do
+        loop do
+          return selector.result unless selector.waiting?
+          if @queue.empty?
+            @waiting.push Thread.current
+            @mutex.sleep
+          else
+            selector.mutex.synchronize do
+              if selector.waiting?
+                result = selector.update_result(channel, @queue.shift)
+                yield result
+              end
+            end
+            selector.release_result
+            return selector.result
+          end
+        end
+      end
+    end
+
+  end
+end

data/lib/ruby_channel/selector.rb

@@ -0,0 +1,63 @@
+module RubyChannel
+  class Selector
+    attr_reader :waiting, :result, :mutex
+    alias waiting? waiting
+
+    def initialize
+      @threads       = []
+      @waiting       = true
+      @mutex         = Mutex.new
+      @return_thread = nil
+    end
+
+    def listen(channel, &block)
+      selector = self
+      @threads << Thread.new do
+        Thread.current[:name]  = "Listener" if RubyChannel::CHANNEL_DEBUG
+        channel.subscribe(selector, &block)
+      end
+    end
+
+    def timeout(value, &block)
+      timeout_channel = Channel.new
+      Thread.new do
+        Thread.current[:name]  = "Timeout Listener" if RubyChannel::CHANNEL_DEBUG
+        sleep value
+        timeout_channel << :timeout
+      end
+      listen timeout_channel, &block
+    end
+
+    def default(&block)
+      default_channel = Channel.new
+      Thread.new do
+        Thread.current[:name]  = "Default Listener" if RubyChannel::CHANNEL_DEBUG
+        default_channel << :default
+      end
+      listen default_channel, &block
+    end
+
+    def select
+      Thread.current[:name] = "select" if RubyChannel::CHANNEL_DEBUG
+      @mutex.synchronize do
+        if waiting?
+          @return_thread = Thread.current
+          Thread.list.each{|t| puts "#{t.inspect}: #{t[:name]}"} if RubyChannel::CHANNEL_DEBUG
+          @mutex.sleep
+        end
+      end
+      @threads.each{ |thread| thread.wakeup }
+      @threads.clear
+      return @result
+    end
+
+    def update_result(channel, value)
+      @waiting = false
+      @result  = value
+    end
+
+    def release_result
+      @return_thread.run if @return_thread
+    end
+  end
+end

data/lib/ruby_channel/version.rb

@@ -0,0 +1,3 @@
+module RubyChannel
+  VERSION = "0.0.1"
+end

data/ruby_channel.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path("../lib/ruby_channel/version", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "ruby_channel"
+  s.version     = RubyChannel::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ['Dalton Pinto']
+  s.email       = ['dalthon@aluno.ita.br']
+  s.homepage    = "http://rubygems.org/gems/ruby_channel"
+  s.summary     = "A way to use channels in Ruby, inspired by Google's Go"
+  s.description = "A way to use channels in Ruby, inspired by Google's Go and Ilya Grigorik's gem 'agent'"
+
+  s.required_rubygems_version = ">= 1.3.6"
+  s.rubyforge_project         = "ruby_channel"
+
+  s.add_development_dependency "bundler", ">= 1.0.0"
+
+  s.files        = `git ls-files`.split("\n")
+  s.executables  = `git ls-files`.split("\n").map{|f| f =~ /^bin\/(.*)/ ? $1 : nil}.compact
+  s.require_path = 'lib'
+end

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification 
+name: ruby_channel
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Dalton Pinto
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-09 00:00:00 -02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  type: :development
+  version_requirements: *id001
+description: A way to use channels in Ruby, inspired by Google's Go and Ilya Grigorik's gem 'agent'
+email: 
+- dalthon@aluno.ita.br
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README
+- Rakefile
+- lib/ruby_channel.rb
+- lib/ruby_channel/channel.rb
+- lib/ruby_channel/selector.rb
+- lib/ruby_channel/version.rb
+- ruby_channel.gemspec
+has_rdoc: true
+homepage: http://rubygems.org/gems/ruby_channel
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: ruby_channel
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: A way to use channels in Ruby, inspired by Google's Go
+test_files: []
+