evt-process_host 0.4.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 923259786e0921de59f0cac14e21764530396d08
+  data.tar.gz: 641f3df3fe348e387d6b00ef7b15e547d4314079
+SHA512:
+  metadata.gz: eaa183daea5d2adc9e1e8001e136a71c16efda922ebd3b7dd16392419db21de7272804ec7e6b7694d1d4adf201dc63b72fe76c5dc1ec780dfcd0160ce3f60c61
+  data.tar.gz: 7d246d999ebc88db94fac3afdd38685ee4cfada4f07110803d9a1ec030c50921e99e4a288bda7f8c3ffc87fc5158be4b8ade0dd1ef3253b4db2b3b2a563721c6

data/lib/process_host.rb

@@ -0,0 +1,16 @@
+require 'actor'
+require 'async_invocation'
+require 'casing'
+require 'log'
+require 'virtual'
+
+require 'process_host/log'
+require 'process_host/signal'
+
+require 'process_host/host'
+require 'process_host/process'
+require 'process_host/process/process_name'
+require 'process_host/supervisor_observers/log'
+require 'process_host/supervisor_observers/record_errors'
+
+require 'process_host/process_host'

data/lib/process_host/controls.rb

@@ -0,0 +1,7 @@
+require 'process_host/controls/component_name'
+require 'process_host/controls/error'
+require 'process_host/controls/process'
+require 'process_host/controls/process/actor_crashes'
+require 'process_host/controls/process/raises_error'
+require 'process_host/controls/process/runs_continuously'
+require 'process_host/controls/process/stops_immediately'

data/lib/process_host/controls/component_name.rb

@@ -0,0 +1,9 @@
+module ProcessHost
+  module Controls
+    module ComponentName
+      def self.example
+        'some-component'
+      end
+    end
+  end
+end

data/lib/process_host/controls/error.rb

@@ -0,0 +1,11 @@
+module ProcessHost
+  module Controls
+    module Error
+      def self.example
+        Example.new
+      end
+
+      Example = Class.new StandardError
+    end
+  end
+end

data/lib/process_host/controls/process.rb

@@ -0,0 +1,33 @@
+module ProcessHost
+  module Controls
+    module Process
+      def self.example
+        Example.new
+      end
+
+      module Name
+        def self.example
+          :example_process
+        end
+      end
+
+      class Example
+        include ProcessHost::Process
+
+        process_name Name.example
+
+        attr_accessor :started
+
+        def start
+          self.started = true
+        end
+
+        module Assertions
+          def started?
+            started ? true : false
+          end
+        end
+      end
+    end
+  end
+end

data/lib/process_host/controls/process/actor_crashes.rb

@@ -0,0 +1,29 @@
+module ProcessHost
+  module Controls
+    module Process
+      class ActorCrashes
+        include ProcessHost::Process
+
+        def start
+          Actor.start
+        end
+
+        def self.error
+          @error ||= Error.example
+        end
+
+        class Actor
+          include ::Actor
+
+          handle :start do
+            raise error
+          end
+
+          def error
+            ActorCrashes.error
+          end
+        end
+      end
+    end
+  end
+end

data/lib/process_host/controls/process/raises_error.rb

@@ -0,0 +1,21 @@
+module ProcessHost
+  module Controls
+    module Process
+      class RaisesError
+        include ProcessHost::Process
+
+        def start
+          raise error
+        end
+
+        def error
+          self.class.error
+        end
+
+        def self.error
+          @error ||= Error.example
+        end
+      end
+    end
+  end
+end

data/lib/process_host/controls/process/runs_continuously.rb

@@ -0,0 +1,42 @@
+module ProcessHost
+  module Controls
+    module Process
+      class RunsContinuously
+        include ProcessHost::Process
+
+        def start
+          Actor.start
+        end
+
+        class Actor
+          include ::Actor
+          include ::Log::Dependency
+
+          attr_writer :counter
+
+          handle :start do
+            :print_heartbeat
+          end
+
+          handle :print_heartbeat do
+            logger.info "Heartbeat (Counter: #{counter})"
+
+            :next
+          end
+
+          handle :next do
+            self.counter += 1
+
+            sleep 1
+
+            :print_heartbeat
+          end
+
+          def counter
+            @counter ||= 0
+          end
+        end
+      end
+    end
+  end
+end

data/lib/process_host/controls/process/stops_immediately.rb

@@ -0,0 +1,21 @@
+module ProcessHost
+  module Controls
+    module Process
+      class StopsImmediately
+        include ProcessHost::Process
+
+        def start
+          Actor.start
+        end
+
+        class Actor
+          include ::Actor
+
+          handle :start do
+            :stop
+          end
+        end
+      end
+    end
+  end
+end

data/lib/process_host/host.rb

@@ -0,0 +1,119 @@
+module ProcessHost
+  class Host
+    include ::Log::Dependency
+
+    dependency :signal, Signal
+    dependency :send, Actor::Messaging::Send
+
+    def self.build
+      instance = new
+      Signal.configure instance
+      instance.send = Actor::Messaging::Send
+      instance
+    end
+
+    def register(process_class, process_name=nil)
+      logger.trace { "Registering process (ProcessClass: #{process_class}, Name: #{process_name.inspect})" }
+
+      process_name ||= process_class.process_name
+
+      if registered_process = processes[process_name]
+        error_message = "Process with specified name is already registered (ProcessClass: #{process_class}, Name: #{process_name.inspect}, RegisteredProcessClass: #{registered_process.name})"
+
+        logger.error error_message
+
+        raise NameConflictError, error_message
+      else
+        processes[process_name] = process_class
+      end
+
+      logger.debug { "Process registered (ProcessClass: #{process_class}, Name: #{process_name.inspect})" }
+
+      process_name
+    end
+
+    def record_error(&block)
+      record_errors_observer.record_error_proc = block
+    end
+
+    def start(&block)
+      started_processes = []
+
+      Actor::Supervisor.start do |supervisor|
+        supervisor.add_observer record_errors_observer
+
+        supervisor.add_observer log_observer
+
+        signal.trap 'TSTP' do
+          message = Actor::Messages::Suspend
+
+          send.(message, supervisor.address)
+
+          logger.info { "Handled TSTP signal (MessageName: #{message.message_name}, SupervisorAddress: #{supervisor.address.id})" }
+        end
+
+        signal.trap 'CONT' do
+          message = Actor::Messages::Resume
+
+          send.(message, supervisor.address)
+
+          logger.info { "Handled CONT signal (MessageName: #{message.message_name}, SupervisorAddress: #{supervisor.address.id})" }
+        end
+
+        signal.trap 'INT' do
+          message = Actor::Messages::Shutdown
+
+          send.(message, supervisor.address)
+
+          logger.info { "Handled INT signal (MessageName: #{message.message_name}, SupervisorAddress: #{supervisor.address.id})" }
+        end
+
+        start_processes do |process|
+          started_processes << process
+        end
+
+        block.(supervisor) if block
+      end
+
+      started_processes
+    end
+
+    def start_processes(&block)
+      processes.each_value do |process_class|
+        process = process_class.build
+
+        process.start
+
+        block.(process) if block
+      end
+
+    rescue => error
+      record_errors_observer.(error)
+      raise error
+    end
+
+    def record_errors_observer
+      @record_errors_observer ||= SupervisorObservers::RecordErrors.new
+    end
+
+    def log_observer
+      @log_observer ||= SupervisorObservers::Log.new
+    end
+
+    def processes
+      @processes ||= {}
+    end
+
+    NameConflictError = Class.new StandardError
+
+    module Assertions
+      def registered?(&block)
+        return processes.any? if block.nil?
+
+        processes.any? do |name, process_class|
+          block.(process_class, name)
+        end
+      end
+    end
+  end
+end

data/lib/process_host/log.rb

@@ -0,0 +1,8 @@
+module ProcessHost
+  class Log < Log
+    def tag!(tags)
+      tags << :process_host
+      tags << :verbose
+    end
+  end
+end

data/lib/process_host/process.rb

@@ -0,0 +1,37 @@
+module ProcessHost
+  module Process
+    def self.included(cls)
+      cls.class_exec do
+        include Log::Dependency
+
+        extend Build
+        extend ProcessName
+        prepend Start
+
+        dependency :send, Actor::Messaging::Send
+      end
+    end
+
+    Virtual::PureMethod.define self, :start
+
+    module Start
+      def start
+        logger.trace { "Starting process (ProcessName: #{self.class.process_name})" }
+
+        super
+
+        logger.debug { "Process started (ProcessName: #{self.class.process_name})" }
+
+        AsyncInvocation::Incorrect
+      end
+    end
+
+    module Build
+      def build
+        instance = new
+        instance.send = Actor::Messaging::Send.new
+        instance
+      end
+    end
+  end
+end

data/lib/process_host/process/process_name.rb

@@ -0,0 +1,41 @@
+module ProcessHost
+  module Process
+    module ProcessName
+      def self.extended(cls)
+        cls.singleton_class.class_exec do
+          attr_writer :process_name
+        end
+      end
+
+      def process_name_macro(name)
+        self.process_name = name
+      end
+
+      def process_name(name=nil)
+        if name.nil?
+          @process_name ||= Default.get self
+        else
+          process_name_macro name
+        end
+      end
+
+      module Default
+        def self.get(mod)
+          constant_name = mod.name
+
+          return unknown if constant_name.nil?
+
+          *, constant_name = constant_name.split '::'
+
+          constant_name = Casing::Underscore.(constant_name)
+
+          constant_name.to_sym
+        end
+
+        def self.unknown
+          :unknown
+        end
+      end
+    end
+  end
+end

data/lib/process_host/process_host.rb

@@ -0,0 +1,13 @@
+module ProcessHost
+  def self.start(component_name, &block)
+    logger = ::Log.get self
+
+    host = Host.build
+
+    host.instance_exec host, &block
+
+    host.start do
+      logger.info "Started component: #{component_name} (ProcessID: #{::Process.pid})"
+    end
+  end
+end

data/lib/process_host/signal.rb

@@ -0,0 +1,53 @@
+module ProcessHost
+  module Signal
+    def self.configure(receiver, attr_name: nil)
+      attr_name ||= :signal
+
+      receiver.public_send "#{attr_name}=", ::Signal
+    end
+
+    module Substitute
+      def self.build
+        Signal.new
+      end
+
+      class Signal
+        def trap(signal, &handler)
+          handlers[signal] = handler
+        end
+
+        def simulate_signal(signal)
+          handler = handlers[signal]
+
+          return if handler.nil?
+
+          handler.()
+
+          record = Record.new signal
+          records << record
+          record
+        end
+
+        def handlers
+          @handlers ||= {}
+        end
+
+        def records
+          @records ||= []
+        end
+
+        Record = Struct.new :signal
+
+        module Assertions
+          def trapped?(signal=nil)
+            if signal.nil?
+              records.any?
+            else
+              records.any? { |record| record.signal == signal }
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/process_host/supervisor_observers/log.rb

@@ -0,0 +1,22 @@
+module ProcessHost
+  module SupervisorObservers
+    class Log
+      include Actor::Supervisor::Observer
+      include ProcessHost::Log::Dependency
+
+      handle Actor::Messages::ActorStarted do |msg|
+        logger.debug "Actor started (Address: #{msg.address.id}, Actor: #{msg.actor.digest})"
+      end
+
+      handle Actor::Messages::ActorStopped do |msg|
+        logger.debug "Actor stopped (Address: #{msg.address.id}, Actor: #{msg.actor.digest})"
+      end
+
+      handle Actor::Messages::ActorCrashed do |msg|
+        error = msg.error
+
+        logger.error "Error raised (ErrorClass: #{error.class.name}, Actor: #{msg.actor.digest}, Message: #{error.message.inspect})"
+      end
+    end
+  end
+end

data/lib/process_host/supervisor_observers/record_errors.rb

@@ -0,0 +1,23 @@
+module ProcessHost
+  module SupervisorObservers
+    class RecordErrors
+      include Actor::Supervisor::Observer
+
+      attr_writer :record_error_proc
+
+      handle Actor::Messages::ActorCrashed do |msg|
+        error = msg.error
+
+        self.(error)
+      end
+
+      def call error
+        record_error_proc.(error)
+      end
+
+      def record_error_proc
+        @record_error_proc ||= proc { }
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,144 @@
+--- !ruby/object:Gem::Specification
+name: evt-process_host
+version: !ruby/object:Gem::Version
+  version: 0.4.0.1
+platform: ruby
+authors:
+- The Eventide Project
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-12-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: evt-async_invocation
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: evt-casing
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: evt-log
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: evt-virtual
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ntl-actor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: test_bench
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: " "
+email: opensource@eventide-project.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/process_host.rb
+- lib/process_host/controls.rb
+- lib/process_host/controls/component_name.rb
+- lib/process_host/controls/error.rb
+- lib/process_host/controls/process.rb
+- lib/process_host/controls/process/actor_crashes.rb
+- lib/process_host/controls/process/raises_error.rb
+- lib/process_host/controls/process/runs_continuously.rb
+- lib/process_host/controls/process/stops_immediately.rb
+- lib/process_host/host.rb
+- lib/process_host/log.rb
+- lib/process_host/process.rb
+- lib/process_host/process/process_name.rb
+- lib/process_host/process_host.rb
+- lib/process_host/signal.rb
+- lib/process_host/supervisor_observers/log.rb
+- lib/process_host/supervisor_observers/record_errors.rb
+homepage: https://github.com/eventide-project/process-host
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.8
+signing_key: 
+specification_version: 4
+summary: Run multiple logical processes inside a single physical process
+test_files: []