iso_latte 1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 5780f40ea4f18590135725740fccd26e885510fd
+  data.tar.gz: 3201f17dad3af7bf0be4ae3b42596601f7c9b62a
+SHA512:
+  metadata.gz: 86beb89d8fcfb691d81748deb32169fbf4aa41aa4c43c0cccfd49d901f25c5dfa2430588f44e2cc2986013aa73975a64ae1aec5104096ce98a2c7bde780ee91a
+  data.tar.gz: fe992f6f80a746bcdbd5287d77c760498a221a8c5be79d8cdcf8ad960b9f9d957f4a7a16e78ccbb39c3f1fc72eaec714557e73800f11ef6d5eb62af724ee91b5

data/lib/iso_latte/version.rb

@@ -0,0 +1,3 @@
+module IsoLatte
+  VERSION = "1.0"
+end

data/lib/iso_latte.rb

@@ -0,0 +1,92 @@
+require "ostruct"
+
+module IsoLatte
+  NO_EXIT = 122
+  EXCEPTION_RAISED = 123
+
+  # Available options:
+  #   stderr:   a path to write stderr into. Defaults to '/dev/null'
+  #             nil means "do not change stderr"
+  #   finish:   a callable to execute when the subprocess terminates (in any way).
+  #             receives a boolean 'success' value, and an exitstatus as arguments
+  #   success:  a callable to execute if the subprocess completes successfully.
+  #             note: this can exit ALONGSIDE the exit callback, if the subprocess
+  #             exits with zero explicitly!
+  #   kill:     a callable to execute if the subprocess is killed (SIGKILL).
+  #   fault:    a callable to execute if the subprocess segfaults, core dumps, etc.
+  #   exit:     a callable to execute if the subprocess voluntarily exits with nonzero.
+  #             receives the exit status value as its argument.
+  #
+  # It is allowable to Isolatte.fork from inside an IsoLatte.fork block (reentrant)
+  #
+  # We are using the exit statuses of 122 and 123 as sentinels that mean
+  # 'the code did not exit on its own' and 'the code raised an exception'.
+  # If you have code that actually uses those exit statuses.. change the special
+  # statuses I guess.
+  #
+  def self.fork(options = nil, &block)
+    defaults = { stderr: "/dev/null", exit: nil }
+    opts = OpenStruct.new(defaults.merge(options || {}))
+
+    read_ex, write_ex = IO.pipe
+
+    child_pid = Process.fork do
+      read_ex.close
+      begin
+        if opts.stderr
+          File.open(opts.stderr, "w") do |stderr_file|
+            STDERR.reopen(stderr_file)
+            STDERR.sync = true
+            $stderr = STDERR
+            block.call
+          end
+        else
+          block.call
+        end
+      rescue StandardError => e
+        # Things that stick un-marshalable attributes on exceptions need to be handled here.
+        ivars = ["@__better_errors_bindings_stack"]
+        ivars.each { |v| e.instance_variable_set(v, nil) if e.instance_variable_defined?(v) }
+
+        Marshal.dump e, write_ex
+        write_ex.flush
+        write_ex.close
+        exit!(EXCEPTION_RAISED)
+      end
+
+      exit!(NO_EXIT)
+    end
+
+    write_ex.close
+
+    pid, rc = Process.wait2(child_pid)
+    fail(Error, "Wrong child's exit received!") unless pid == child_pid
+
+    if rc.exited? && rc.exitstatus == EXCEPTION_RAISED
+      e = Marshal.load read_ex
+      read_ex.close
+      fail e
+    else
+      read_ex.close
+    end
+
+    success = rc.success? || rc.exitstatus == NO_EXIT
+    code = rc.exitstatus == NO_EXIT ? 0 : rc.exitstatus
+
+    if success
+      opts.success.call if opts.success
+    else
+      opts.fault.call if opts.fault && (rc.termsig == 6 || rc.coredump?)
+      opts.kill.call if opts.kill && rc.termsig == 9
+    end
+
+    # This can execute on success OR failure - it indicates that the subprocess
+    # *explicitly* exited, whether with zero or nonzero.
+    opts.exit.call(rc.exitstatus) if opts.exit && rc.exited? && rc.exitstatus != NO_EXIT
+
+    # This should execute *no matter what*
+    opts.finish.call(success, code) if opts.finish
+  end
+
+  class Error < StandardError; end
+end

metadata

@@ -0,0 +1,47 @@
+--- !ruby/object:Gem::Specification
+name: iso_latte
+version: !ruby/object:Gem::Version
+  version: '1.0'
+platform: ruby
+authors:
+- Emcien Engineering
+- Eric Mueller
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-07-01 00:00:00.000000000 Z
+dependencies: []
+description: IsoLatte allows execution to be forked from the main process for safety
+email:
+- engineering@emcien.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/iso_latte.rb
+- lib/iso_latte/version.rb
+homepage: https://github.com/emcien/iso_latte
+licenses:
+- BSD-3-Clause
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.3
+signing_key: 
+specification_version: 4
+summary: A gem for isolating execution in a subprocess
+test_files: []