tribe 0.0.1 → 0.0.2

data/README.rdoc

@@ -1,9 +1,9 @@
 = tribe
 
-Actor Model for Ruby.  Experimental.
+Actor Model for Ruby.  Currently experimental and not recommend for production.  Many standard features of the Actor Model are missing.
 
 == Contributing to tribe
- 
+
 * Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
 * Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
 * Fork the project.

data/Rakefile

@@ -54,3 +54,38 @@ rescue LoadError
 end
 
 require 'tribe'
+
+class MyActor < Tribe::Actor
+  def pre_init
+    @count = 0
+  end
+
+  def increment
+    @count += 1
+    puts "#{@name}=#{@count}" if @count >= 50000
+  end
+
+  def go(friend_name)
+    friend = Tribe.registry[friend_name]
+
+    50000.times do
+      friend.increment!
+    end
+  end
+end
+
+def tribe_demo
+  a1 = Tribe.registry['a1'] || MyActor.new(:name => 'a1')
+  a2 = Tribe.registry['a2'] || MyActor.new(:name => 'a2')
+  a3 = Tribe.registry['a3'] || MyActor.new(:name => 'a3')
+  a4 = Tribe.registry['a4'] || MyActor.new(:name => 'a4')
+  a5 = Tribe.registry['a5'] || MyActor.new(:name => 'a5')
+  a6 = Tribe.registry['a6'] || MyActor.new(:name => 'a6')
+
+  a1.go!('a2')
+  a2.go!('a1')
+  a3.go!('a4')
+  a4.go!('a3')
+  a5.go!('a6')
+  a6.go!('a5')
+end

data/VERSION

@@ -1 +1 @@
-0.0.1
+0.0.2

data/lib/tribe.rb

@@ -1,11 +1,14 @@
 require 'singleton'
 require 'thread'
+require 'set'
 
 require 'tribe/actor'
 require 'tribe/singleton'
 require 'tribe/worker'
 require 'tribe/scheduler'
 require 'tribe/registry'
+require 'tribe/clock'
+require 'tribe/timer'
 
 module Tribe
   def self.scheduler
@@ -15,4 +18,8 @@ module Tribe
   def self.registry
     Tribe::Registry.instance
   end
+
+  def self.clock
+    Tribe::Clock.instance
+  end
 end

data/lib/tribe/actor.rb

@@ -3,10 +3,15 @@ module Tribe
     attr_reader :name
 
     def initialize(options = {})
+      run_hook(:pre_init)
+
+      @alive = true
       @process_lock = Mutex.new
       @name = options[:name].freeze
 
       Tribe.registry.register(self)
+
+      run_hook(:post_init)
     end
 
     def method_missing(method, *args, &block)
@@ -14,14 +19,14 @@ module Tribe
       bang = m[-1] == '!'
 
       if bang && respond_to?(m.chop!)
-        async(m, *args)
+        tell(m, *args)
       else
         super
       end
     end
 
-    def async(method, *args)
-      Tribe.scheduler.schedule do
+    def tell(method, *args)
+      Tribe.scheduler.send(:schedule) do
         process(:method => method, :args => args)
       end
 
@@ -31,12 +36,21 @@ module Tribe
     private
     def process(message)
       @process_lock.synchronize do
-        send(message[:method], *message[:args])
+        begin
+          send(message[:method], *message[:args]) if @alive
+        rescue Exception => e
+          @alive = false
+        end
       end
     end
 
-    def shutdown
-      Tribe.registry.unregistry(self)
+    def terminate
+      @alive = false
+      Tribe.registry.unregister(self)
+    end
+
+    def run_hook(hook)
+      send(hook) if respond_to?(hook, true)
     end
   end
 end

data/lib/tribe/clock.rb

@@ -0,0 +1,78 @@
+module Tribe
+  class Clock < Tribe::Singleton
+    FREQUENCY = 100 # Hz.
+
+    def initialize(options = {})
+      @frequency = options[:frequency] || FREQUENCY
+      @run = true
+      @timers = SortedSet.new
+      @messages = Queue.new
+      @thread = Thread.new { main }
+    end
+
+    def shutdown
+      message = { :command => :shutdown }
+      @messages.push(message)
+
+      @thread.join
+    end
+
+    def schedule(timer)
+      message = { :command => :schedule, :timer => timer }
+      @messages.push(message)
+
+      true
+    end
+
+    def unschedule(timer)
+      message = { :command => :unschedule, :timer => timer }
+      @messages.push(message)
+
+      true
+    end
+
+    private
+    def main
+      sleep_val = 1.0 / @frequency
+
+      while @run
+        sleep(sleep_val)
+        process_commands
+        fire_timers
+      end
+    end
+
+    def process_commands
+      @messages.length.times do
+        message = @messages.pop
+
+        case message[:command]
+        when :schedule
+          @timers.add(message[:timer])
+        when :unschedule
+          @timers.delete(message[:timer])
+        when :shutdown
+          @run = false
+        else
+          raise("Invalid command: #{message[:command]}")
+        end
+      end
+    end
+
+    def fire_timers
+      count = 0
+
+      while true
+        return 0 if @timers.empty?
+
+        if (timer = @timers.first).send(:fire?)
+          @timers.delete(timer)
+          timer.send(:fire)
+          count += 1
+        else
+          return count
+        end
+      end
+    end
+  end
+end

data/lib/tribe/registry.rb

@@ -2,28 +2,44 @@ module Tribe
   class Registry < Tribe::Singleton
 
     def initialize
+      @lock = Mutex.new
+
       @actors_by_oid = {}
       @actors_by_name = {}
     end
 
     def register(actor)
-      @actors_by_oid[actor.object_id] = actor
+      @lock.synchronize do
+        @actors_by_oid[actor.object_id] = actor
 
-      if actor.name
-        @actors_by_name[actor.name] = actor
+        if actor.name
+          if @actors_by_name[actor.name]
+            raise "Actor already exists. name=#{actor.name}"
+          else
+            @actors_by_name[actor.name] = actor
+          end
+        end
       end
+
+      true
     end
 
     def unregister(actor)
-      @actors_by_oid.delete(actor.object_id)
+      @lock.synchronize do
+        @actors_by_oid.delete(actor.object_id)
 
-      if actor.name
-        @actors_by_name.delete(actor.name)
+        if actor.name
+          @actors_by_name.delete(actor.name)
+        end
       end
+
+      true
     end
 
     def [](val)
-      @actors_by_name[val]
+      @lock.synchronize do
+        return @actors_by_name[val]
+      end
     end
   end
 end

data/lib/tribe/scheduler.rb

@@ -8,10 +8,6 @@ module Tribe
       spawn(@count)
     end
 
-    def schedule(&block)
-      @messages.push({ :command => :perform, :task => block })
-    end
-
     def shutdown
       @count.times do
         @messages.push({ :command => :shutdown })
@@ -23,6 +19,10 @@ module Tribe
     end
 
     private
+    def schedule(&block)
+      @messages.push({ :command => :perform, :task => block })
+    end
+
     def spawn(count)
       count.times do
         worker = Worker.new(@messages)

data/lib/tribe/timer.rb

@@ -0,0 +1,51 @@
+module Tribe
+  class Timer
+    attr_reader :fire_at
+    attr_reader :repeat
+
+    def initialize(seconds, options = {}, &block)
+      @seconds = seconds.to_f
+      @callback = block
+      @clock = options[:clock] || Tribe.clock
+      @repeat = options[:repeat] || false
+
+      schedule
+    end
+
+    def cancel
+      @clock.unschedule(self)
+    end
+
+    def <=>(timer)
+      if self.object_id == timer.object_id
+        return 0
+      else
+        return self.fire_at <=> timer.fire_at
+      end
+    end
+
+    private
+    def fire?(current_time = nil)
+      current_time ||= now
+
+      now >= @fire_at
+    end
+
+    def fire
+      @callback.call
+    rescue Exception => e
+      puts "Timer caught exception: #{e.message}\n#{e.backtrace.join("\n")}"
+    ensure
+      schedule if @repeat
+    end
+
+    def now
+      Time.now.to_f
+    end
+
+    def schedule
+      @fire_at = now + @seconds
+      @clock.schedule(self)
+    end
+  end
+end

data/spec/lib/tribe/clock_spec.rb

@@ -0,0 +1,4 @@
+require 'spec_helper'
+
+describe Tribe::Clock do
+end

data/spec/lib/tribe/timer_spec.rb

@@ -0,0 +1,4 @@
+require 'spec_helper'
+
+describe Tribe::Timer do
+end

data/tribe.gemspec

@@ -0,0 +1,91 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "tribe"
+  s.version = "0.0.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Chad Remesch"]
+  s.date = "2012-06-10"
+  s.description = "Actor Model for Ruby.  Can support millions of actors (limited by memory). Currently experimental and not recommended for production."
+  s.email = "chad@remesch.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "Guardfile",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "lib/tribe.rb",
+    "lib/tribe/actor.rb",
+    "lib/tribe/clock.rb",
+    "lib/tribe/registry.rb",
+    "lib/tribe/scheduler.rb",
+    "lib/tribe/singleton.rb",
+    "lib/tribe/timer.rb",
+    "lib/tribe/worker.rb",
+    "spec/lib/tribe/actor_spec.rb",
+    "spec/lib/tribe/clock_spec.rb",
+    "spec/lib/tribe/registry_spec.rb",
+    "spec/lib/tribe/scheduler_spec.rb",
+    "spec/lib/tribe/timer_spec.rb",
+    "spec/lib/tribe/worker_spec.rb",
+    "spec/spec_helper.rb",
+    "tribe.gemspec"
+  ]
+  s.homepage = "http://github.com/chadrem/tribe"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.23"
+  s.summary = "Actor Model for Ruby"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.10.0"])
+      s.add_development_dependency(%q<bundler>, [">= 1.1.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.3"])
+      s.add_development_dependency(%q<simplecov>, [">= 0"])
+      s.add_development_dependency(%q<rb-fsevent>, [">= 0"])
+      s.add_development_dependency(%q<guard>, ["~> 1.1.1"])
+      s.add_development_dependency(%q<guard-rspec>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<growl>, [">= 0"])
+      s.add_development_dependency(%q<debugger>, [">= 0"])
+    else
+      s.add_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_dependency(%q<rspec>, ["~> 2.10.0"])
+      s.add_dependency(%q<bundler>, [">= 1.1.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.3"])
+      s.add_dependency(%q<simplecov>, [">= 0"])
+      s.add_dependency(%q<rb-fsevent>, [">= 0"])
+      s.add_dependency(%q<guard>, ["~> 1.1.1"])
+      s.add_dependency(%q<guard-rspec>, ["~> 1.0.0"])
+      s.add_dependency(%q<growl>, [">= 0"])
+      s.add_dependency(%q<debugger>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rdoc>, ["~> 3.12"])
+    s.add_dependency(%q<rspec>, ["~> 2.10.0"])
+    s.add_dependency(%q<bundler>, [">= 1.1.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.3"])
+    s.add_dependency(%q<simplecov>, [">= 0"])
+    s.add_dependency(%q<rb-fsevent>, [">= 0"])
+    s.add_dependency(%q<guard>, ["~> 1.1.1"])
+    s.add_dependency(%q<guard-rspec>, ["~> 1.0.0"])
+    s.add_dependency(%q<growl>, [">= 0"])
+    s.add_dependency(%q<debugger>, [">= 0"])
+  end
+end
+

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tribe
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -191,15 +191,20 @@ files:
 - VERSION
 - lib/tribe.rb
 - lib/tribe/actor.rb
+- lib/tribe/clock.rb
 - lib/tribe/registry.rb
 - lib/tribe/scheduler.rb
 - lib/tribe/singleton.rb
+- lib/tribe/timer.rb
 - lib/tribe/worker.rb
 - spec/lib/tribe/actor_spec.rb
+- spec/lib/tribe/clock_spec.rb
 - spec/lib/tribe/registry_spec.rb
 - spec/lib/tribe/scheduler_spec.rb
+- spec/lib/tribe/timer_spec.rb
 - spec/lib/tribe/worker_spec.rb
 - spec/spec_helper.rb
+- tribe.gemspec
 homepage: http://github.com/chadrem/tribe
 licenses:
 - MIT
@@ -215,7 +220,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -1241874824708307471
+      hash: 4061265025390310383
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: