subcontractor 0.0.1 → 0.1.0

data/README.md

@@ -0,0 +1,44 @@
+### Overview
+
+[Foreman](https://github.com/ddollar/foreman) is a gem released by Heroku that allows you to easily manage multiple processes with a Procfile. It ensures all processes launch successfully, colorizes output, and allows you to kill all processes with a simple CTL+C. It's simple and elegant.
+
+Its not perfect however. For one, it doesn't handle running processes from a different directory. It also doesn't deal well with the complexity of running processes under a different RVM. You are probably thinking, "well, those aren't really Foreman's responsibilities". I agree with you. This gem fills that gap.
+
+### Usage
+
+```
+gem install subcontractor
+```
+
+or with bundler
+
+```ruby
+gem 'subcontractor', '0.1.0'
+```
+
+The gem provides an executable called ```subcontract``` that you will use from your Procfile. You can see what it does by running ```subcontract --help```
+
+```
+USAGE: subcontract [options] -- executable
+    -r, --rvm RVM                    run in a specific RVM
+    -d, --chdir PATH                 chdir to PATH before starting process
+    -s, --signal SIGNAL              signal to send to process to kill it, default TERM
+```
+
+An example Procfile tells the story
+
+```
+rails: rails s
+another_app: subcontract --rvm ruby-1.8.7-p249@another_app --chdir ../another_app --signal INT -- rails s -p 3001
+```
+
+Here another_app will be launch from the sibling directory another_app and will use the rvm ruby-1.8.7-p249@another_app. As you can see, the command that we wish to use to launch our application follows the double dashes (--).
+
+### Contributions
+* Fork the project
+* Make your change
+* Add your name and contact info the the Contributors section below
+* Send a pull request (bonus points for feature branches)
+
+### Contributors
+* Tony Pitluga [github](http://github.com/pitluga) [twitter](http://twitter.com/pitluga)

data/examples/Procfile

@@ -1,2 +1,3 @@
-webapp: ruby -I ../lib ../bin/subcontract --rvm ruby-1.8.7-p249@subcontractor-webapp --chdir webapp -- bundle exec thin --rackup config.ru start
+thin: ruby -I ../lib ../bin/subcontract --rvm ruby-1.8.7-p249@subcontractor-webapp --chdir webapp --signal INT -- bundle exec rackup config.ru -p 3001
+webrick: ruby -I ../lib ../bin/subcontract --rvm ruby-1.8.7-p249@subcontractor-webapp --chdir webapp --signal INT -- bundle exec thin --rackup config.ru -p 3002 start
 sleepy: ruby -I ../lib ../bin/subcontract --chdir script -- ruby sleepy.rb

data/lib/subcontractor/cli.rb

@@ -8,9 +8,10 @@ module Subcontractor
       options = parse_options(ARGV)
       command = build_command(ARGV.dup, options)
       Dir.chdir(options[:chdir]) if options[:chdir]
+      signal = options[:signal] || "TERM"
       PTY.spawn(command) do |stdin, stdout, pid|
         trap("TERM") do
-          options.has_key?(:rvm) ? kill_term(*child_pids(pid)) : kill_term(pid)
+          options.has_key?(:rvm) ? send_kill(signal, *child_pids(pid)) : send_kill(signal, pid)
         end
         until stdin.eof?
           puts stdin.gets
@@ -18,8 +19,8 @@ module Subcontractor
       end
     end
 
-    def kill_term(*pids)
-      pids.each { |pid| Process.kill("SIGTERM", pid) }
+    def send_kill(signal, *pids)
+      pids.each { |pid| Process.kill(signal, pid) }
     end
 
     def child_pids(pid)
@@ -37,12 +38,16 @@ module Subcontractor
     def parse_options(argv)
       options = {}
       parser = OptionParser.new do |opt|
+        opt.banner = "USAGE: subcontract [options] -- executable"
         opt.on('-r', '--rvm RVM', 'run in a specific RVM') do |rvm|
           options[:rvm] = rvm
         end
         opt.on('-d', '--chdir PATH', 'chdir to PATH before starting process') do |path|
           options[:chdir] = path
         end
+        opt.on('-s', '--signal SIGNAL', 'signal to send to process to kill it, default TERM') do |signal|
+          options[:signal] = signal
+        end
       end
 
       parser.parse! argv

data/lib/subcontractor/version.rb

@@ -1,3 +1,3 @@
 module Subcontractor
-  VERSION = "0.0.1"
+  VERSION = "0.1.0"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: subcontractor
 version: !ruby/object:Gem::Version 
-  hash: 29
+  hash: 27
   prerelease: 
   segments: 
   - 0
-  - 0
   - 1
-  version: 0.0.1
+  - 0
+  version: 0.1.0
 platform: ruby
 authors: 
 - Tony Pitluga
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-10-11 00:00:00 Z
+date: 2011-10-12 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: foreman