ntl-actor 0.6.2 → 1.0.0.pre1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 43278fd8ce2df41947048d174acb3aaeb444f71d
-  data.tar.gz: b39cb321c8e6b8eb2dbb1dfe3a3db47a807fed91
+  metadata.gz: 9362612be3698e03771c7fb5098807275df662eb
+  data.tar.gz: e3052225551eb88b84ac6ed57d3699c588c0c37d
 SHA512:
-  metadata.gz: b0353f54da12ba8b91f6f26c36e85111c0c67dcd884b9d6de16d504dd987b0c5b80579942d6ade2cc3005237a0a59c2476f78d3ddac930092af9b85ebd3a7ae8
-  data.tar.gz: cfbc11890208f7d8128b133ff89cd3440025e69afd4707c1757010539003bb6d6ba4b4e0c47de90ad7a3d6ea74f2c70d1fce5d4cff97e2b2d5106c939dac04a5
+  metadata.gz: edb4844e21afd14350a9d872cf7fc4eb219b53c7250647fd121c2e7d4fde80307d273fd5e8c585641ea7ff3338b43de6c9b786bf652ed00a4022aa22ec738ae3
+  data.tar.gz: 128a2647b95a7f97b83c91c88d22dca296a6544a2a4b0976aa0dcf669b4ba17236df3da55a5647693fa9aa95a67be9b0c18d44ce992635534386630fc34dc8f6

data/lib/actor.rb

@@ -1,31 +1,57 @@
 require 'securerandom'
 require 'set'
-require 'timeout'
 
-require 'actor/substitutes/kernel'
-require 'actor/substitutes/thread_group'
-require 'actor/substitutes/thread'
+require 'actor/messaging/queue'
+require 'actor/messaging/queue/substitute'
+require 'actor/messaging/queue/substitute'
 
-require 'actor/destructure'
-require 'actor/duration'
-require 'actor/stream'
+require 'actor/messaging/address'
+require 'actor/messaging/address/controls'
+require 'actor/messaging/address/dependency'
+require 'actor/messaging/address/none'
 
-require 'actor/address'
 require 'actor/messaging/message'
-require 'actor/messaging/read'
-require 'actor/messaging/read/substitute'
-require 'actor/messaging/write'
-require 'actor/messaging/write/substitute'
+require 'actor/messaging/message/name'
 
-require 'actor/messages'
+require 'actor/messaging/reader'
+require 'actor/messaging/reader/assertions'
+require 'actor/messaging/reader/dependency'
+require 'actor/messaging/reader/substitute'
 
-require 'actor/handle_macro'
-require 'actor/observers'
+require 'actor/messaging/writer'
+require 'actor/messaging/writer/dependency'
+require 'actor/messaging/writer/substitute'
 
-require 'actor/start'
+require 'actor/messaging/publisher'
+require 'actor/messaging/publisher/assertions'
+require 'actor/messaging/publisher/dependency'
+require 'actor/messaging/publisher/substitute'
 
-require 'actor/actor'
+require 'actor/messages'
+
+require 'actor/module/dependencies'
+require 'actor/module/dependencies/assertions'
+require 'actor/module/handler'
+require 'actor/module/handler/method_name'
+require 'actor/module/handler/macro'
+require 'actor/module/include_assertions'
+require 'actor/module/run_loop'
+require 'actor/module/start'
+require 'actor/module/suspend_resume'
+require 'actor/module/suspend_resume/assertions'
+require 'actor/module/suspend_resume/configure'
+require 'actor/module/suspend_resume/controls'
+require 'actor/module/suspend_resume/handle'
+require 'actor/module/suspend_resume/initialize'
+
+require 'actor/build'
+require 'actor/controls'
+require 'actor/start'
 
-require 'actor/future'
-require 'actor/router'
 require 'actor/supervisor'
+require 'actor/supervisor/address/get'
+require 'actor/supervisor/address/put'
+require 'actor/supervisor/address/registry'
+require 'actor/supervisor/assertions'
+
+require 'actor/actor'

data/lib/actor/actor.rb

@@ -1,137 +1,17 @@
 module Actor
-  # It is possible to `include Actor' in the top-level namespace in order to
-  # bring this library's constants into focus (i.e. reference them without any
-  # leading `Actor' reference to qualify them). The test suite does this; see
-  # tests/test_init.rb. In that case, we take care not to attach any Actor
-  # behavior onto Object. This is achieved by placing the implementation of
-  # Actor in Actor::Module
   def self.included cls
-    cls.include Module unless cls == Object
-  end
-
-  module Module
-    def self.included cls
-      cls.class_exec do
-        extend HandleMacro
-        extend Start
-
-        include Observers
-
-        prepend Configure
-      end
-    end
-
-    attr_writer :address
-    attr_writer :reader
-    attr_writer :writer
-
-    def configure
-    end
-
-    def continuations
-      @continuations ||= []
-    end
-
-    def handle message
-      method = handle? message
-
-      return if method.nil?
-
-      if method.arity == 0
-        return_value = method.()
-      else
-        return_value = method.(message)
-      end
-
-      notify_observers message
-
-      return_value
-    end
-
-    def handle_stop
-      raise StopIteration
-    end
-
-    def handle? message
-      method_name = HandleMacro::MethodName.get message
-
-      if respond_to? method_name
-        method method_name
-      end
-    end
-
-    def next
-      if continuations.empty?
-        message = reader.(wait: true)
-      else
-        message = reader.(wait: false)
-        message ||= continuations.shift
-      end
-
-      continuation_message = handle message
-
-      if handle? continuation_message
-        continuations << continuation_message
-      end
-    end
-
-    def run_loop
-      loop do
-        self.next
-        Thread.pass
-      end
-    end
-    alias_method :start, :run_loop
-
-    def address
-      @address ||= Address::None
-    end
-
-    def reader
-      @reader ||= Messaging::Read::Substitute.new
-    end
-
-    def writer
-      @writer ||= Messaging::Write::Substitute.new
-    end
-
-    module Configure
-      def configure
-        super
-
-        self.reader = Messaging::Read.build address
-        self.writer = Messaging::Write.new
-      end
-    end
-
-    module Start
-      def start *positional_arguments, address: nil, supervisor_address: nil, include: nil, **keyword_arguments, &block
-        address ||= Address.build
-
-        if respond_to? :build
-          constructor = method :build
-        else
-          constructor = method :new
-        end
-
-        if keyword_arguments.empty?
-          instance = constructor.(*positional_arguments, &block)
-        else
-          instance = constructor.(*positional_arguments, **keyword_arguments, &block)
-        end
-
-        instance.address = address
-
-        instance.configure
-
-        thread = Actor::Start.(
-          instance,
-          address,
-          supervisor_address: supervisor_address
-        )
-
-        Destructure.(address, include, { :thread => thread, :actor => instance })
-      end
+    # Actor can be included in the main object (TOPLEVEL_BINDING.receiver) in
+    # order to bring the constants contained in within the Actor namespace to
+    # the top level. When we do so, it is necessary to prevent the actual mixin
+    # from altering the main object.
+    return if cls.eql? Object
+
+    cls.class_exec do
+      extend Module::Start
+      include Module::Dependencies
+      include Module::Handler
+      include Module::RunLoop
+      include Module::SuspendResume
     end
   end
 end

data/lib/actor/build.rb

@@ -0,0 +1,36 @@
+module Actor
+  class Build
+    attr_reader :arguments
+    attr_reader :block
+    attr_reader :cls
+
+    def initialize cls, arguments, &block
+      @arguments = arguments
+      @block = block
+      @cls = cls
+    end
+
+    def self.call cls, *arguments, &block
+      instance = new cls, arguments, &block
+      instance.()
+    end
+
+    def call
+      if cls.respond_to? :build
+        method = cls.method :build
+      else
+        method = cls.method :new
+      end
+
+      if block
+        actor = method.(*arguments, &block)
+      else
+        actor = method.(*arguments)
+      end
+
+      actor.configure
+
+      actor
+    end
+  end
+end

data/lib/actor/controls.rb

@@ -1,7 +1,7 @@
-require 'actor/controls/address'
-require 'actor/controls/error'
-require 'actor/controls/message'
-require 'actor/controls/actor'
-require 'actor/controls/message/attribute'
-require 'actor/controls/uuid'
-require 'actor/controls/thread'
+module Actor
+  module Controls
+    def next_message= message
+      reader.add message
+    end
+  end
+end

data/lib/actor/messages.rb

@@ -1,10 +1,14 @@
 module Actor
   module Messages
-    class Start
+    module Start
+      extend Messaging::Message
+    end
+
+    ActorStarted = Struct.new :address do
       include Messaging::Message
     end
 
-    ActorStarted = Struct.new :actor_address do
+    ActorStopped = Struct.new :address do
       include Messaging::Message
     end
 
@@ -12,8 +16,20 @@ module Actor
       include Messaging::Message
     end
 
-    class Stop
-      include Messaging::Message
+    module Suspend
+      extend Messaging::Message
+    end
+
+    module Resume
+      extend Messaging::Message
+    end
+
+    module Shutdown
+      extend Messaging::Message
+    end
+
+    module Stop
+      extend Messaging::Message
     end
   end
 end

data/lib/actor/messaging/address.rb

@@ -0,0 +1,26 @@
+module Actor
+  module Messaging
+    Address = Struct.new :id, :queue
+
+    class Address
+      def self.build max_queue_size: nil
+        id = SecureRandom.uuid
+        queue = Queue.get max_size: max_queue_size
+
+        new id, queue
+      end
+
+      def actors_waiting
+        queue.num_waiting
+      end
+
+      def queue_size
+        queue.size
+      end
+
+      def queue_max_size
+        queue.max
+      end
+    end
+  end
+end

data/lib/actor/messaging/address/controls.rb

@@ -0,0 +1,11 @@
+module Actor
+  module Messaging
+    class Address
+      module Controls
+        def write message
+          queue.enq message
+        end
+      end
+    end
+  end
+end

data/lib/actor/messaging/address/dependency.rb

@@ -0,0 +1,13 @@
+module Actor
+  module Messaging
+    class Address
+      module Dependency
+        attr_writer :address
+
+        def address
+          @address ||= Address::None.instance
+        end
+      end
+    end
+  end
+end

data/lib/actor/messaging/address/none.rb

@@ -0,0 +1,33 @@
+module Actor
+  module Messaging
+    class Address
+      class None < Address
+        def self.build
+          id = ID.get
+          queue = Queue.new
+
+          new id, queue
+        end
+
+        def self.instance
+          @instance ||= build
+        end
+
+        class Queue
+          def deq non_block=nil
+            sleep unless non_block == true
+          end
+
+          def enq msg, non_block=nil
+          end
+        end
+
+        module ID
+          def self.get
+            '(none)'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/actor/messaging/message.rb

@@ -1,5 +1,43 @@
 module Actor
   module Messaging
-    Message = Module.new
+    module Message
+      def self.included cls
+        cls.class_exec do
+          extend Matcher
+          extend MessageName
+
+          include MessageName
+        end
+      end
+
+      def self.extended receiver
+        receiver.instance_exec do
+          extend Matcher
+          extend MessageName
+        end
+      end
+
+      def self.=== object
+        if object.is_a? Symbol
+          true
+        else
+          super
+        end
+      end
+
+      module Matcher
+        def === other
+          other_message_name = Name.get other
+
+          message_name == other_message_name
+        end
+      end
+
+      module MessageName
+        def message_name
+          Name.get name
+        end
+      end
+    end
   end
 end