ultravisor 0.0.0.3.g8cf10dc

data/lib/ultravisor/child/call.rb

@@ -0,0 +1,16 @@
+class Ultravisor::Child::Call
+	attr_reader :method_name
+
+	def initialize(method_name, args, blk, rv_q, rv_fail)
+		@method_name, @args, @blk, @rv_q, @rv_fail = method_name, args, blk, rv_q, rv_fail
+	end
+
+	def go!(receiver)
+		@rv_q << receiver.__send__(@method_name, *@args, &@blk)
+		@rv_q.close
+	end
+
+	def child_restarted!
+		@rv_q << @rv_fail
+	end
+end

data/lib/ultravisor/child/call_receiver.rb

@@ -0,0 +1,13 @@
+class Ultravisor::Child::CallReceiver < BasicObject
+	def initialize(&blk)
+		@blk = blk
+	end
+
+	def method_missing(name, *args, &blk)
+		rv_q = ::Queue.new
+		rv_fail = ::Object.new
+		callback = ::Ultravisor::Child::Call.new(name, args, blk, rv_q, rv_fail)
+		@blk.call(callback)
+		rv_q.pop.tap { |rv| ::Kernel.raise ::Ultravisor::ChildRestartedError.new if rv == rv_fail }
+	end
+end

data/lib/ultravisor/child/cast.rb

@@ -0,0 +1,15 @@
+class Ultravisor::Child::Cast
+	attr_reader :method_name
+
+	def initialize(method_name, args, blk)
+		@method_name, @args, @blk = method_name, args, blk
+	end
+
+	def go!(receiver)
+		receiver.__send__(@method_name, *@args, &@blk)
+	end
+
+	def child_restarted!
+		# Meh
+	end
+end

data/lib/ultravisor/child/cast_receiver.rb

@@ -0,0 +1,10 @@
+class Ultravisor::Child::CastReceiver < BasicObject
+	def initialize(&blk)
+		@blk = blk
+	end
+
+	def method_missing(name, *args, &blk)
+		castback = ::Ultravisor::Child::Cast.new(name, args, blk)
+		@blk.call(castback)
+	end
+end

data/lib/ultravisor/child/process_cast_call.rb

@@ -0,0 +1,38 @@
+module Ultravisor::Child::ProcessCastCall
+	private
+
+	def process_castcall
+		begin
+			loop do
+				item = @ultravisor_child_castcall_queue.pop(true)
+
+				# Queue has been closed, which is a polite way of saying "we're done here"
+				return if item.nil?
+
+				item.go!(self)
+
+				castcall_fd.getc
+			end
+		rescue ThreadError => ex
+			if ex.message != "queue empty"
+				#:nocov:
+				raise
+				#:nocov:
+			end
+		end
+	end
+
+	def castcall_fd
+		@ultravisor_child_castcall_fd
+	end
+
+	def process_castcall_loop
+		#:nocov:
+		loop do
+			IO.select([castcall_fd], nil, nil)
+
+			process_castcall
+		end
+		#:nocov:
+	end
+end

data/lib/ultravisor/error.rb

@@ -0,0 +1,24 @@
+class Ultravisor
+	# Base class of all Ultravisor-specific errors
+	class Error < StandardError; end
+
+	# Tried to register a child with an ID of a child that already exists
+	class DuplicateChildError < Error; end
+
+	# Tried to call `#run` on an ultravisor that is already running
+	class AlreadyRunningError < Error; end
+
+	# A `child.call.<method>` was interrupted by the child instance runner terminating
+	class ChildRestartedError < Error; end
+
+	# Something was wrong with the Klass/Args/Method (KAM) passed
+	class InvalidKAMError < Error; end
+
+	# A child's restart policy was exceeded, and the Ultravisor should
+	# terminate
+	class BlownRestartPolicyError < Error; end
+
+	# An internal programming error (aka "a bug") caused a violation of thread safety
+	# requirements
+	class ThreadSafetyError < Error; end
+end

data/lib/ultravisor/logging_helpers.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+class Ultravisor
+	module LoggingHelpers
+		private
+
+		attr_reader :logger
+
+		def log_exception(ex, progname = nil)
+			#:nocov:
+			progname ||= "#{self.class.to_s}##{caller_locations(2, 1).first.label}"
+
+			logger.error(progname) do
+				explanation = if block_given?
+					yield
+				else
+					false
+				end
+
+				(["#{explanation}#{explanation ? ": " : ""}#{ex.message} (#{ex.class})"] + ex.backtrace).join("\n  ")
+			end
+			#:nocov:
+		end
+
+		def logloc
+			#:nocov:
+			loc = caller_locations.first
+			"#{self.class}##{loc.label}"
+			#:nocov:
+		end
+	end
+end

data/ultravisor.gemspec

@@ -0,0 +1,36 @@
+begin
+	require "git-version-bump"
+rescue LoadError
+	nil
+end
+
+Gem::Specification.new do |s|
+	s.name = "ultravisor"
+
+	s.version = GVB.version rescue "0.0.0.1.NOGVB"
+	s.date    = GVB.date    rescue Time.now.strftime("%Y-%m-%d")
+
+	s.platform = Gem::Platform::RUBY
+
+	s.summary  = "A template gem"
+
+	s.authors  = ["Matt Palmer"]
+	s.email    = ["theshed+ultravisor@hezmatt.org"]
+  s.homepage = "https://github.com/mpalmer/ultravisor"
+
+	s.files = `git ls-files -z`.split("\0").reject { |f| f =~ /^(G|spec|Rakefile)/ }
+
+  s.required_ruby_version = ">= 2.3.0"
+
+
+	s.add_development_dependency "bundler"
+	s.add_development_dependency "github-release"
+	s.add_development_dependency "guard-rspec"
+	s.add_development_dependency "rake", "~> 10.4", ">= 10.4.2"
+	# Needed for guard
+	s.add_development_dependency "rb-inotify", "~> 0.9"
+	s.add_development_dependency "redcarpet"
+	s.add_development_dependency "rspec"
+  s.add_development_dependency "simplecov"
+	s.add_development_dependency "yard"
+end

metadata

@@ -0,0 +1,188 @@
+--- !ruby/object:Gem::Specification
+name: ultravisor
+version: !ruby/object:Gem::Version
+  version: 0.0.0.3.g8cf10dc
+platform: ruby
+authors:
+- Matt Palmer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-06-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  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'
+- !ruby/object:Gem::Dependency
+  name: github-release
+  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'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  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'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 10.4.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 10.4.2
+- !ruby/object:Gem::Dependency
+  name: rb-inotify
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  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'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  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'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  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'
+- !ruby/object:Gem::Dependency
+  name: yard
+  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:
+- theshed+ultravisor@hezmatt.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".yardopts"
+- LICENCE
+- README.md
+- lib/ultravisor.rb
+- lib/ultravisor/child.rb
+- lib/ultravisor/child/call.rb
+- lib/ultravisor/child/call_receiver.rb
+- lib/ultravisor/child/cast.rb
+- lib/ultravisor/child/cast_receiver.rb
+- lib/ultravisor/child/process_cast_call.rb
+- lib/ultravisor/error.rb
+- lib/ultravisor/logging_helpers.rb
+- ultravisor.gemspec
+homepage: https://github.com/mpalmer/ultravisor
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: A template gem
+test_files: []