spawncli 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 299f86db99d8e30a0b14ca6040fff591db71cfbe
+  data.tar.gz: ec23fd6b89dce707ce2c55889606f3a4c734ce10
+SHA512:
+  metadata.gz: 2c19b171c45fb85b16f68981538381ad9dcf142591101ce121868b052e294d791413b3dc3fe31217b3cd48ba37c286686a03ef07460dd3c64a574091e68de19e
+  data.tar.gz: 657daddb7e3e1be0203d87e4be8b6a57a23f8a3c7b021ca8fa4a51f9f28739af5e58e406f26a10f692982ac7d695b237367178a53bcfe03384b1b2589fbada47

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/.idea/
+/**/.DS_Store
+/bin-ignore

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.2.2

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in spawncli.gemspec
+gemspec

data/README.md

@@ -0,0 +1,37 @@
+# Spawncli
+
+Spawncli lets you run several copies of a command-line in parallel, capturing their stdout and stderr.
+
+## Installation
+
+Spawncli doesn't expose any worthwhile functionality as a library.  It can be installed as a command-line gem from RubyGems:
+
+``gem install spawncli``
+
+## Usage
+
+``spawncli n command-line arg1 arg2 argN``
+
+Spawncli takes two arguments:  a number and a command to run.  Any further arguments are interpreted as being part of the second.
+
+To avoid shell interpretation of pipes and redirections, the command-line to run should be quoted.
+
+### Example
+
+``spawncli 10 "curl http://localhost:8080/foo"``
+
+### Return Code
+
+Returns 1 if anything spawned process wrote to its stderr, 0 otherwise.
+
+## Development
+
+TODO
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/spawn/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/spawncli

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby 
+
+require 'spawncli'
+
+spawner = Spawncli::Spawncli.new
+spawner.run $*

data/lib/spawncli.rb

@@ -0,0 +1,131 @@
+require 'open4'
+require 'threadinfo'
+
+module Spawncli
+
+  class Spawncli
+
+    @@help_text = <<-EOF.gsub /^  /, ""
+    Spawn:  Spawns 'n' copies of a command line.
+    John Hawksley <john.hawksley@gmail.com> -*- MIT License
+
+    See https://github.com/jhawksley/spawn for details.
+
+    Options:
+        spawncli 2 "sleep 1 && curl http://localhost"  # Run 2 copies of the command
+    EOF
+
+
+    def run(args)
+
+      # Proces out the arguments - this is a very simple parse since we don't support any options.
+      n = process_args(args)
+
+      # Parse out the remainder of the args values as a command line to run in the shell.
+      argline = generate_arg_line(args) # Gets rid of the trailing space.
+
+      # An array to hold our ThreadInfo objects.
+      threads = spawn_threads(argline, n)
+
+      puts
+
+      # Poll the thread array, seeing if any have completed (status false)
+      # or there was an exception (nil).
+      # Any exceptions are not currently handled.
+      any_stderr = poll_threads(threads)
+
+      # If any thread wrote to stderr, exit 1, otherwise 0.
+      exit any_stderr ? 1 : 0
+
+    end
+
+    private
+
+    def poll_threads(threads)
+      any_stderr = false
+
+      while threads.length > 0 do
+        threads.each do |ti|
+          if (ti.thread.status == false || ti.thread.status == nil) then
+            # Done or exited with exception
+            threads.delete(ti)
+
+            print "#{ti.id}: complete #{ti.thread.status == nil ? '(failed) ' : ''}"
+            $stdout.flush
+            puts (Time.now - ti.start_time).to_s << 's'
+
+            if ti.stdout != nil && !ti.stdout.empty?
+              ti.stdout.each_line do |l|
+                puts "#{ti.id}: out:   #{l}"
+              end
+            end
+            if ti.stderr != nil && !ti.stderr.empty?
+              any_stderr = true
+              ti.stderr.each_line do |l|
+                puts "#{ti.id}: err:   #{l}"
+              end
+            end
+
+            puts
+          end
+        end
+      end
+      any_stderr
+    end
+
+    def spawn_threads(argline, n)
+      threads = Array.new #of ThreadInfos
+
+      puts "Spawning #{n} copies of #{argline}"
+
+      # Do all the spawns
+      (1..n).each do |i|
+        ti = ThreadInfo.new i #... initializes the internal ID with 'i'
+        threads << ti
+        thread = Thread.new do
+          status = Open4::popen4(argline) do |pid, stdin, stdout, stderr|
+            ti.stdout = stdout.read.strip
+            ti.stderr = stderr.read.strip
+          end
+        end
+        ti.thread = thread
+        puts "#{i}: spawned."
+      end
+      threads
+    end
+
+    def generate_arg_line(args)
+      argline=''
+
+      args.each do |a|
+        argline = argline + a + ' '
+      end
+
+      argline.strip!
+      argline
+    end
+
+    def process_args(args)
+      if args.length < 2 then
+        do_help
+        abort
+      else
+        # The first argument is interpreted as the number of concurrent thread
+        # to run.
+        begin
+          n = Integer(args.shift)
+        rescue Exception => e
+          abort "The first argument of a multiple argument invocation must be an integer (#{e})"
+        end
+      end
+      n
+    end
+
+
+    def do_help
+      puts @@help_text
+    end
+
+  end
+
+end

data/lib/threadinfo.rb

@@ -0,0 +1,19 @@
+module Spawncli
+
+
+  # A class to hold information about a spawned thread.
+  class ThreadInfo
+
+    attr_accessor :thread, :id, :stdout, :stderr, :exit_code
+    attr_reader :start_time
+
+    # Create a new ThreadInfo holder.
+    #   @param id [String] the thread ID
+    def initialize(id)
+      @id = id
+      @start_time = Time.now
+    end
+
+  end
+
+end

data/lib/version.rb

@@ -0,0 +1,3 @@
+module Spawncli
+  VERSION = '1.0.1'
+end

data/spawncli.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "spawncli"
+  spec.version       = Spawncli::VERSION
+  spec.authors       = ["John Hawksley"]
+  spec.email         = ["john.hawksley@gmail.com"]
+
+  spec.summary       = %q{Run several command-lines in parallel.}
+  spec.description   = %q{Spawncli forks several processes to run concurrently, and monitors their status.}
+  spec.homepage      = "https://github.com/jhawksley/spawncli/"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "bin"
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency "open4", "~> 1.3"
+
+  spec.add_development_dependency "bundler", "~> 1.9"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification
+name: spawncli
+version: !ruby/object:Gem::Version
+  version: 1.0.1
+platform: ruby
+authors:
+- John Hawksley
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-05-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: open4
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: Spawncli forks several processes to run concurrently, and monitors their
+  status.
+email:
+- john.hawksley@gmail.com
+executables:
+- spawncli
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- README.md
+- Rakefile
+- bin/spawncli
+- lib/spawncli.rb
+- lib/threadinfo.rb
+- lib/version.rb
+- spawncli.gemspec
+homepage: https://github.com/jhawksley/spawncli/
+licenses: []
+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.5
+signing_key: 
+specification_version: 4
+summary: Run several command-lines in parallel.
+test_files: []
+has_rdoc: