multi_process 0.1.0

data/lib/multi_process/process/bundle_exec.rb

@@ -0,0 +1,13 @@
+class MultiProcess::Process
+
+  # Provides functionality to wrap command in with bundle
+  # execute.
+  #
+  module BundleExec
+
+    def initialize(*args)
+      opts = Hash === args.last ? args.pop : Hash.new
+      super %w(bundle exec) + args, opts
+    end
+  end
+end

data/lib/multi_process/process/rails.rb

@@ -0,0 +1,74 @@
+class MultiProcess::Process
+
+  # Provides functionality for a process that is a rails server
+  # process.
+  #
+  # Include this module if required.
+  #
+  # Functions include port generation, default server command and
+  # availability check based on if server socket is reachable.
+  #
+  module Rails
+
+    # Server wrapper given as argument to `server` action.
+    #
+    attr_reader :server
+
+    # Port server should be running on.
+    #
+    # Default will be a free port determined when process is created.
+    #
+    attr_reader :port
+
+    def initialize(opts = {})
+      self.server = opts[:server] if opts[:server]
+      self.port   = opts[:port]   if opts[:port]
+
+      super ['rails', 'server', server, '--port', port].reject(&:nil?).map(&:to_s), opts
+    end
+
+    def server=(server)
+      @server = server.to_s.empty? ? nil : server.to_s
+    end
+
+    def port=(port)
+      @port = port.to_i == 0 ? free_port : port.to_i
+    end
+
+    def port
+      @port ||= free_port
+    end
+
+    def available?
+      raise ArgumentError.new "Cannot check availability for port #{port}." if port == 0
+
+      TCPSocket.new('127.0.0.1', port).close
+      true
+    rescue Errno::ECONNREFUSED, Errno::EHOSTUNREACH
+      false
+    end
+
+    # Load environment options from initialize options.
+    #
+    def configure(opts)
+      super
+      puts 'Configure RAILS'
+      self.dir = Dir.pwd
+      self.dir = opts[:dir].to_s if opts[:dir]
+    end
+
+    def start_childprocess(*args)
+      Dir.chdir(dir) { super }
+    end
+
+    private
+
+    def free_port
+      socket = Socket.new(:INET, :STREAM, 0)
+      socket.bind(Addrinfo.tcp("127.0.0.1", 0))
+      socket.local_address.ip_port
+    ensure
+      socket.close if socket
+    end
+  end
+end

data/lib/multi_process/receiver.rb

@@ -0,0 +1,90 @@
+module MultiProcess
+
+  # Can handle input from multiple processes and run custom
+  # actions on event and output.
+  #
+  class Receiver
+
+    # Mutex to synchronize operations.
+    #
+    attr_reader :mutex
+
+    def initialize
+      @mutex   = Mutex.new
+      @readers = {}
+
+      Thread.new do
+        begin
+          loop do
+            io = IO.select(@readers.keys, nil, nil, 0.1)
+            (io.nil? ? [] : io.first).each do |reader|
+              if reader.eof?
+                op = @readers[reader]
+                @readers.delete_if { |key, value| key == reader }
+                removed op[:process], op[:name]
+              else
+                op = @readers[reader]
+                received op[:process], op[:name], read(reader)
+              end
+            end
+          end
+        rescue Exception => ex
+          puts ex.message
+          puts ex.backtrace
+        end
+      end
+    end
+
+    # Request a new pipe writer for given process and name.
+    #
+    # @param process [ Process ] Process requesting pipe.
+    # @param name [ Symbol ] Name associated to pipe e.g.
+    #   `:out` or `:err`.
+    #
+    def pipe(process, name)
+      reader, writer = IO.pipe
+      @readers[reader] = {name: name, process: process}
+      connected process, name
+      writer
+    end
+
+    # Send a custom messages.
+    #
+    def message(process, name, message)
+      received process, name, message
+    end
+
+    protected
+
+    # Will be called when content is received for given
+    # process and name.
+    #
+    # Must be overridden by subclass.
+    #
+    def received(process, name, message)
+      raise NotImplementedError.new 'Subclass responsibility.'
+    end
+
+    # Read content from pipe. Can be used to provide custom reading
+    # like reading lines instead of byte ranges.
+    #
+    # Should be non blocking.
+    #
+    def read(reader)
+      reader.read_nonblock 4096
+    end
+
+    # Called after pipe for process and name was removed because it
+    # reached EOF.
+    #
+    def removed(process, name)
+
+    end
+
+    # Called after new pipe for process and name was created.
+    #
+    def connected(process, name)
+
+    end
+  end
+end

data/lib/multi_process/version.rb

@@ -0,0 +1,11 @@
+module MultiProcess
+  module VERSION
+    MAJOR = 0
+    MINOR = 1
+    PATCH = 0
+    STAGE = nil
+    STRING = [MAJOR, MINOR, PATCH, STAGE].reject(&:nil?).join('.')
+
+    def self.to_s; STRING end
+  end
+end

data/multi_process.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'multi_process/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "multi_process"
+  spec.version       = MultiProcess::VERSION
+  spec.authors       = ["Jan Graichen"]
+  spec.email         = ["jg@altimos.de"]
+  spec.summary       = %q{Handle multiple child processes.}
+  spec.description   = %q{Handle multiple child processes.}
+  spec.homepage      = "https://github.com/jgraichen/multi_process"
+  spec.license       = "GPLv3"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency 'activesupport', '>= 3.1'
+  spec.add_runtime_dependency 'childprocess'
+
+  spec.add_development_dependency "bundler", "~> 1.5"
+end

data/spec/files/sleep.rb

@@ -0,0 +1,2 @@
+
+sleep ARGV[0].to_i

data/spec/files/test.rb

@@ -0,0 +1,6 @@
+
+2.times do
+  $stdout.print "Output from #{ARGV[0]}"
+  $stdout.flush
+  sleep rand
+end

data/spec/multi_process_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+
+describe MultiProcess do
+
+  it 'should run processes' do
+    reader, writer = IO.pipe
+
+    logger = MultiProcess::Logger.new writer
+    group  = MultiProcess::Group.new #receiver: logger
+    group << MultiProcess::Process.new(%w(ruby spec/files/test.rb A), title: 'rubyA')
+    group << MultiProcess::Process.new(%w(ruby spec/files/test.rb B), title: 'rubyB')
+    group << MultiProcess::Process.new(%w(ruby spec/files/test.rb C), title: 'rubyC')
+    group.run
+
+    expect(reader.read_nonblock(4096).split("\n")).to match_array <<-EOF.gsub(/^\s+/, ' ').split("\n")
+    rubyB | Output from B
+    rubyA | Output from A
+    rubyA | Output from A
+    rubyC | Output from C
+    rubyC | Output from C
+    rubyB | Output from B
+    EOF
+  end
+
+  it 'should run processes' do
+    start = Time.now
+
+    group = MultiProcess::Group.new# logger: MultiProcess::NilReceiver.new
+    group << MultiProcess::Process.new(%w(ruby spec/files/sleep.rb 5000), title: 'rubyA')
+    group << MultiProcess::Process.new(%w(ruby spec/files/sleep.rb 5000), title: 'rubyB')
+    group << MultiProcess::Process.new(%w(ruby spec/files/sleep.rb 5000), title: 'rubyC')
+    group.start
+    sleep 1
+    group.stop
+
+    group.processes.each do |p|
+      expect(p).to_not be_alive
+    end
+    expect(Time.now - start).to be < 2
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,27 @@
+require 'rspec'
+
+require 'bundler'
+Bundler.require
+
+require 'multi_process'
+
+Dir[File.expand_path('spec/support/**/*.rb')].each {|f| require f}
+
+RSpec.configure do |config|
+  # ## Mock Framework
+  #
+  # If you prefer to use mocha, flexmock or RR, uncomment the appropriate line:
+  #
+  # config.mock_with :mocha
+  # config.mock_with :flexmock
+  # config.mock_with :rr
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+
+  # Raise error when using old :should expectation syntax.
+  config.raise_errors_for_deprecations!
+end

metadata

@@ -0,0 +1,109 @@
+--- !ruby/object:Gem::Specification
+name: multi_process
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jan Graichen
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-01-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: childprocess
+  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: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+description: Handle multiple child processes.
+email:
+- jg@altimos.de
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/multi_process.rb
+- lib/multi_process/group.rb
+- lib/multi_process/logger.rb
+- lib/multi_process/nil_receiver.rb
+- lib/multi_process/process.rb
+- lib/multi_process/process/bundle_exec.rb
+- lib/multi_process/process/rails.rb
+- lib/multi_process/receiver.rb
+- lib/multi_process/version.rb
+- multi_process.gemspec
+- spec/files/sleep.rb
+- spec/files/test.rb
+- spec/multi_process_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/jgraichen/multi_process
+licenses:
+- GPLv3
+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.2.1
+signing_key: 
+specification_version: 4
+summary: Handle multiple child processes.
+test_files:
+- spec/files/sleep.rb
+- spec/files/test.rb
+- spec/multi_process_spec.rb
+- spec/spec_helper.rb