ntl-actor 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 47b2908a5c8c0845acf09f5f4f7a75e89c913d55
-  data.tar.gz: a90ae411a5f3bc54ee2e169067cf6d3c5c0dcadf
+  metadata.gz: 6a248085a59139b5a654ffd3c4d88a125c409847
+  data.tar.gz: 0a95b14dc7bee4ce4ffb259c4058baedf2a59be1
 SHA512:
-  metadata.gz: d6321566f603c6884202bc129e3435bba0a8f91fd8ae8c06c3a6db16dbf6487b1f43ab82a278a61276200c755cacd0ba23b67a6252ec6d6e80f52422f5aee4a2
-  data.tar.gz: 250ba0a32174e3311debcc64bdf92d63bdddb40df5546657403453879992b315a7493e787400a06a125020f72d7826d0a96ad60cd3d52dd34581a3ab2eb02c48
+  metadata.gz: 21bed49350bde9295a5d5380b2d80a6c4a5d4ef2c8241e3b5ef4795d1c24c866116be5695339cd639bb44a7ef850aa6d1dc9fc26b67d0f955865d44f005d14fb
+  data.tar.gz: 9fc7de957667da0179a58e37ff7aaa4d72991839cbbaec75b01ea0b34f52ab42187fde4cdc678b920e8b5b55209d54db61e259c3a7735252dac19292604a682e

data/lib/actor.rb

@@ -18,4 +18,7 @@ require 'actor/messaging/writer/substitute'
 
 require 'actor/message'
 
+require 'actor/time_unit'
+
 require 'actor/actor'
+require 'actor/supervisor'

data/lib/actor/actor.rb

@@ -41,8 +41,9 @@ module Actor
       Statistics::Copy.(status, actor_statistics)
 
       status.state = actor_state
+      status.actor_class = self.class.name
 
-      Messaging::Writer.write status, message.reply_address
+      Messaging::Writer.(status, message.reply_address)
     end
   end
 
@@ -52,7 +53,7 @@ module Actor
 
   def run_loop
     loop do
-      while message = reader.read(wait: actor_state == State::Paused)
+      while message = reader.(wait: actor_state == State::Paused)
         handle message
 
         if message.is_a? Message
@@ -90,7 +91,7 @@ module Actor
 
   module Spawn
     def spawn *positional_arguments, include: nil, **keyword_arguments, &block
-      address = Messaging::Address.get
+      address = Messaging::Address.build
 
       method = if respond_to? :build then :build else :new end
 
@@ -123,10 +124,7 @@ module Actor
         &block
       )
 
-      Messaging::Writer.write(
-        Message::Resume.new,
-        address
-      )
+      Messaging::Writer.(Message::Resume.new, address)
 
       destructure instance, address, thread, include: include
     end

data/lib/actor/controls.rb

@@ -1,4 +1,5 @@
 require 'actor/controls/actor'
+require 'actor/controls/message'
 require 'actor/controls/statistics'
 require 'actor/controls/statistics/elapsed_time'
 require 'actor/controls/statistics/elapsed_time/average'

data/lib/actor/controls/actor.rb

@@ -7,6 +7,68 @@ module Actor
 
       class Example
         include ::Actor
+
+        def action
+          @acted = true
+        end
+
+        def action_executed?
+          @acted == true
+        end
+
+        def handle message
+          handled_messages << message
+        end
+
+        def handled_messages
+          @handled_messages ||= []
+        end
+
+        module Assertions
+          def handled_message? expected_message
+            expected_message ||= Message.example
+
+            @handled_messages.include? expected_message
+          end
+        end
+      end
+
+      class CrashesImmediately < Example
+        def action
+          super
+          raise Error, "Induced error"
+        end
+
+        Error = Class.new StandardError
+      end
+
+      class StopsImmediately < Example
+        def action
+          super
+          raise StopIteration
+        end
+      end
+
+      class ConstructorArguments < StopsImmediately
+        attr_reader :req, :opt, :keyreq, :key, :block
+
+        def initialize req, opt=nil, keyreq:, key: nil, &block
+          @req, @opt, @keyreq, @key, @block = req, opt, keyreq, key, block
+        end
+      end
+
+      class FactoryMethod < ConstructorArguments
+        def self.build req
+          new req, keyreq: 'keyreq-value'
+        end
+
+        def argument_passed_in? value
+          req == value
+        end
+
+        def constructed_by_factory_method?
+          keyreq == 'keyreq-value'
+        end
       end
     end
   end

data/lib/actor/controls/message.rb

@@ -0,0 +1,9 @@
+module Actor
+  module Controls
+    module Message
+      def self.example
+        'some-message'
+      end
+    end
+  end
+end

data/lib/actor/messaging/address.rb

@@ -9,7 +9,7 @@ module Actor
         @queue = queue
       end
 
-      def self.get
+      def self.build
         id = SecureRandom.uuid
         queue = Queue.new
 

data/lib/actor/messaging/reader.rb

@@ -15,7 +15,7 @@ module Actor
         new queue_reader
       end
 
-      def read wait: nil
+      def call wait: nil
         queue_reader.read wait: wait
       end
 

data/lib/actor/messaging/reader/substitute.rb

@@ -4,7 +4,7 @@ module Actor
       class Substitute
         attr_accessor :stopped
 
-        def read wait: nil
+        def call wait: nil
           message = messages.shift
 
           return message if message

data/lib/actor/messaging/writer.rb

@@ -13,12 +13,12 @@ module Actor
         new queue
       end
 
-      def self.write message, address
+      def self.call message, address
         instance = build address
-        instance.write message
+        instance.(message)
       end
 
-      def write message
+      def call message
         queue.write message
       end
     end

data/lib/actor/messaging/writer/substitute.rb

@@ -2,7 +2,7 @@ module Actor
   module Messaging
     class Writer
       class Substitute
-        def write message
+        def call message
           messages << message
         end
 

data/lib/actor/supervisor.rb

@@ -0,0 +1,77 @@
+module Actor
+  class Supervisor
+    attr_reader :actors
+    attr_writer :exception_notifier
+
+    def initialize
+      @actors = Set.new
+    end
+
+    def add address, thread
+      actor = Actor.new address, thread
+
+      actors << actor
+
+      actor
+    end
+
+    def remove address
+      actors.delete_if do |actor|
+        actor.address == address
+      end
+    end
+
+    def broadcast message
+      addresses = actors.map &:address
+
+      addresses.each do |address|
+        Messaging::Writer.(message, address)
+      end
+    end
+
+    def pause
+      broadcast Message::Pause.new
+    end
+
+    def resume
+      broadcast Message::Resume.new
+    end
+
+    def stop
+      broadcast Message::Stop.new
+    end
+
+    def start &supplementary_action
+      loop do
+        supplementary_action.() if supplementary_action
+
+        actors.delete_if do |actor|
+          thread = actor.thread
+          thread.join TimeUnit.millisecond
+        end
+
+        break if actors.empty?
+
+        Thread.pass
+      end
+
+    rescue => error
+      exception_notifier.(error)
+      raise error
+    end
+
+    def exception_notifier
+      @exception_notifier ||= proc { }
+    end
+
+    Actor = Struct.new :address, :thread
+
+    module Assertions
+      def actor? actor_address
+        actors.any? do |actor|
+          actor.address == actor_address
+        end
+      end
+    end
+  end
+end

data/lib/actor/test_fixtures/sample_actor_status.rb

@@ -14,7 +14,7 @@ module Actor
       end
 
       def self.call prose, address:, test:
-        reply_address = Messaging::Address.get
+        reply_address = Messaging::Address.build
         reader = Messaging::Reader.build reply_address
 
         writer = Messaging::Writer.build address
@@ -24,13 +24,13 @@ module Actor
       end
 
       def call test_prose, &block
-        writer.write record_status_message
+        writer.(record_status_message)
 
-        status_0 = reader.read wait: true
+        status_0 = reader.(wait: true)
 
-        writer.write record_status_message
+        writer.(record_status_message)
 
-        status_1 = reader.read wait: true
+        status_1 = reader.(wait: true)
 
         test test_prose do
           block.(status_1, status_0)

data/lib/actor/time_unit.rb

@@ -0,0 +1,7 @@
+module Actor
+  module TimeUnit
+    def self.millisecond
+      0.001
+    end
+  end
+end

metadata

@@ -1,17 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: ntl-actor
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Nathan Ladd
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
 date: 2016-08-31 00:00:00.000000000 Z
 dependencies: []
-description: Implementation of actor pattern for ruby designed for simplicity and
-  frugality
+description: Implementation of actor pattern for ruby designed for simplicity and frugality
 email: nathanladd+github@gmail.com
 executables: []
 extensions: []
@@ -21,6 +20,7 @@ files:
 - lib/actor/actor.rb
 - lib/actor/controls.rb
 - lib/actor/controls/actor.rb
+- lib/actor/controls/message.rb
 - lib/actor/controls/statistics.rb
 - lib/actor/controls/statistics/elapsed_time.rb
 - lib/actor/controls/statistics/elapsed_time/average.rb
@@ -42,14 +42,16 @@ files:
 - lib/actor/statistics.rb
 - lib/actor/statistics/copy.rb
 - lib/actor/statistics/timer.rb
+- lib/actor/supervisor.rb
 - lib/actor/test_fixtures.rb
 - lib/actor/test_fixtures/parallel_iteration.rb
 - lib/actor/test_fixtures/sample_actor_status.rb
+- lib/actor/time_unit.rb
 homepage: https://github.com/ntl/actor
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -64,9 +66,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.6
-signing_key: 
+rubyforge_project:
+rubygems_version: 2.6.4
+signing_key:
 specification_version: 4
 summary: Implementation of actor pattern for ruby
 test_files: []