doughboy 0.0.2

data/.gitignore

@@ -0,0 +1,6 @@
+pkg/*
+*.gem
+.bundle
+*.DS_Store
+*~*
+*#*

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.rvmrc

@@ -0,0 +1 @@
+rvm 1.9.2@dough_boy

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,26 @@
+PATH
+  remote: .
+  specs:
+    dough_boy (0.0.1)
+      open4 (~> 1.0.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.2)
+    open4 (1.0.1)
+    rspec (2.4.0)
+      rspec-core (~> 2.4.0)
+      rspec-expectations (~> 2.4.0)
+      rspec-mocks (~> 2.4.0)
+    rspec-core (2.4.0)
+    rspec-expectations (2.4.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.4.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  dough_boy!
+  rspec (~> 2.4.0)

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (C) 2011 by Joshua Schairbaum
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE

data/README.markdown

@@ -0,0 +1,52 @@
+Doughboy
+========
+
+Doughboy is a Ruby library that strives to enable developers to easily make subprocessed shell calls. 
+
+Usage
+--------
+
+Doughboy provides a compossible interface to crafting shell commands.
+
+    command = Doughboy::Command.with_exec("ruby").with_options(["-v"])
+    command.run!
+
+Commands components can be set directly on any object.
+
+    command = Doughboy::Command.new(:executable => "easy_install", :arguments => "some-python-library").run!
+
+The preferred method is to use the composable chain methods.
+
+Command Components
+------------------
+
+Each command is composed of 3 separate components: executable, options, arguments.
+
+### Executable
+
+When this component is set, the full-path is captured. If no path information could be determined, the executable passed will be used.
+
+### Options
+
+Options are command line switches that either start w/ "-" or "--". 
+
+### Arguments
+
+Arguments are items that are passed to the executable. They might be a list of ip addresses or files.
+
+Origin of the Name
+------------------
+
+I wish I could say that it was meant to pay homage to the fighting men of the Lost Generation, but it's not. I was watching Boyz N The Hood. 
+
+![Doughboy](http://2.bp.blogspot.com/_xdN0QQwsP1A/TDhzYsJhkpI/AAAAAAAAJZk/yjqX6ZNF1t8/s400/boyz_n_the_hood_xlg+ICE+Cube+crop.jpg)
+
+Author
+------
+
+Joshua Schairbaum \o\ joshua.schairbaum@gmail.com /o/ @jschairb 
+
+License
+-------
+
+See LICENSE file.

data/Rakefile

@@ -0,0 +1,4 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+import 'spec/spec.rake'

data/autotest/.autotest

@@ -0,0 +1,10 @@
+require 'autotest/fsevent'
+
+require 'autotest_notification'
+SPEAKING = true
+DOOM_EDITION = true
+BUUF = false
+PENDING = false
+STICKY = false
+SUCCESS_SOUND = ''
+FAILURE_SOUND = ''

data/autotest/discover.rb

@@ -0,0 +1 @@
+Autotest.add_discovery { "rspec2" }

data/doughboy.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "doughboy/version"
+
+Gem::Specification.new do |s|
+  s.name        = "doughboy"
+  s.version     = Doughboy::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Joshua Schairbaum"]
+  s.email       = ["joshua.schairbaum@gmail.com"]
+  s.homepage    = ""
+  s.summary     = %q{Easily run command-line programs. This }
+  s.description = %q{Doughboy is a Ruby library that strives to enable developers to easily make subprocessed shell calls.}
+
+  s.rubyforge_project = "doughboy"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency('open4', '~>1.0.1')
+  s.add_development_dependency('rspec', "~>2.4.0")
+end

data/lib/doughboy/command.rb

@@ -0,0 +1,55 @@
+module Doughboy
+  class Command
+    attr_accessor :arguments, :executable, :options
+
+    def initialize(*args)
+      if args.any?
+        local_args = args.first
+        self.arguments  = local_args[:arguments]
+        self.executable = local_args[:executable]
+        self.options    = local_args[:options]
+      end
+    end
+
+    def self.with_exec(command)
+      parsed_command = parse_command(command)
+      executable = parsed_command[:executable]
+      arguments  = parsed_command[:arguments]
+      options    = parsed_command[:options]
+
+      new(:executable => executable, :arguments => arguments, :options => options)
+    end
+
+    def command
+      [executable, options, arguments].join(" ")
+    end
+
+    def executable=(value)
+      return nil if value.nil?
+      full_path = `which #{value}`.strip
+      @executable = full_path != "" ? full_path : value
+    end
+
+    def options=(value)
+      return nil if value.nil?
+      @options = value.is_a?(Array) ? value : value.split(" ")
+    end
+
+    def run!
+      Output.new( Open4::popen4(command) )
+    end
+
+    private
+    def self.parse_command(command)
+      split_command = command.split(" ")
+      parsed_command = { }
+      args_and_opts = split_command[1..(split_command.size-1)]
+
+      parsed_command[:executable] = split_command[0]
+      parsed_command[:arguments] = args_and_opts.select { |t| !t.include?("-") }.join(" ")
+      parsed_command[:options]   = args_and_opts.select { |t| t.include?("-") }
+      parsed_command
+    end
+
+  end
+end

data/lib/doughboy/output.rb

@@ -0,0 +1,18 @@
+module Doughboy
+  class Output
+    attr_accessor :pid, :stdin, :stdout, :stderr
+
+    def initialize(*args)
+      local_args  = args.first
+      self.pid    = local_args[0]
+      self.stdin  = local_args[1]
+      self.stdout = local_args[2]
+      self.stderr = local_args[3]
+    end
+
+    def text
+      stdout.read.strip
+    end
+
+  end
+end

data/lib/doughboy/version.rb

@@ -0,0 +1,3 @@
+module Doughboy
+  VERSION = "0.0.2"
+end

data/lib/doughboy.rb

@@ -0,0 +1,7 @@
+require 'open4'
+
+require 'dough_boy/command'
+require 'dough_boy/output'
+
+module DoughBoy
+end

data/spec/doughboy/command_spec.rb

@@ -0,0 +1,149 @@
+require 'spec_helper'
+
+module Doughboy
+  describe Command do
+    describe ".new" do
+      context "with a string argument" do
+        it "sets the executable"
+      end
+
+      context "with a hash argument" do
+        it "sets the arguments" do
+          command = Command.new(:arguments => "setup.py develop")
+          command.arguments.should_not be_nil
+        end
+
+        it "sets the executeable" do
+          command = Command.new(:executable => "python")
+          command.executable.should_not be_nil
+        end
+
+        it "sets the options" do
+          options = "-r -i"
+          command = Command.new(:options => options)
+          command.options.should_not be_nil
+        end
+
+        # Command.with_exec("python setup.py develop).run
+        # Command.with_exec("python").with_option("-r").with_arg("123456").run
+        # Command.with_exec("mi").with_options([]).with_args([]).run
+        # Command.with_exec("python") do |input|
+        #   input.puts("exit()")
+        # end
+      end
+    end
+
+    describe ".with_exec" do
+      it "returns a Command" do
+        Command.with_exec("ruby").should be_kind_of(Command)
+      end
+
+      context "with a string of executable and argument" do
+        before(:each) do
+          @command_string = "ps aux"
+        end
+
+        it "assigns the executable" do
+          command = Command.with_exec(@command_string)
+          command.executable.should == `which ps`.strip
+        end
+
+        it "assigns the arguments" do
+          command = Command.with_exec(@command_string)
+          command.arguments.should == "aux"
+        end
+      end
+
+      context "with a string of executable, arguments, and options" do
+        before(:each) do
+          @command_string = "mi -r 212984"
+        end
+
+        it "assigns the executable" do
+          command = Command.with_exec(@command_string)
+          command.executable.should == `which mi`.strip
+        end
+
+        it "assigns the arguments" do
+          command = Command.with_exec(@command_string)
+          command.arguments.should == "212984"
+        end
+
+        it "assigns the options" do
+          command = Command.with_exec(@command_string)
+          command.options.should == ["-r"]
+        end
+      end
+
+      context "with an executable" do
+        it "assigns the executable" do
+          Command.with_exec("ruby").executable.should include("ruby")
+        end
+      end
+    end
+
+    describe "#arguments=" do
+      it 'sets the arguments' do
+        arguments = "setup.py develop"
+
+        command = Command.new(:arguments => arguments)
+        command.arguments.should == arguments
+      end
+    end
+
+    describe "#command" do
+      it "joins the executable, options, and arguments" do
+        full_command = "/bin/ps  aux"
+        command = Command.new(:executable => "ps", :options => "", :arguments => "aux")
+        command.command.should == full_command
+      end
+    end
+
+    describe "#executable=" do
+      it "sets the full path of the executable" do
+        ruby = `which ruby`.strip
+
+        command = Command.new(:executable => "ruby")
+        command.executable.should == ruby
+      end
+
+      it "sets the value sent if no path could be determined" do
+        command = Command.new(:executable => "noexist")
+        command.executable.should == "noexist"
+      end
+    end
+
+    describe "#options=" do
+      context "with an array of options" do
+        it "sets the options as an array" do
+          options = ["-r", "-i"]
+          command = Command.new(:options => options)
+          command.options.should == options
+        end
+      end
+
+      context "with a string of options" do
+        options = "-r -i"
+        command = Command.new(:options => options)
+        command.options.should == ["-r", "-i"]
+      end
+    end
+
+    describe "#run!" do
+      it "runs the command" do
+        full_command = "/bin/ps  aux"
+        command = Command.new()
+        command.stub!(:command).and_return(full_command)
+
+        Open4.should_receive(:popen4).with(full_command).
+          and_return([1234, StringIO.new, StringIO.new, StringIO.new])
+        command.run!
+      end
+
+      it "returns an output object" do
+        command = Command.new(:executable => "ps", :options => "", :arguments => "aux")
+        command.run!.should be_kind_of(Output)
+      end
+    end
+  end
+end

data/spec/doughboy/output_spec.rb

@@ -0,0 +1,39 @@
+require 'spec_helper'
+
+module Doughboy
+  describe Output do
+    describe ".new" do
+      before(:each) do
+        #popen [pid, stdin, stdout, stderr]
+        @response = Open4::popen4("ps aux")
+        @output = Output.new(@response)
+      end
+
+      it "sets the pid" do
+        @output.pid.should == @response[0]
+      end
+
+      it "sets the stdin" do
+        @output.stdin.should == @response[1]
+      end
+
+      it "sets the stdout" do
+        @output.stdout.should == @response[2]
+      end
+
+      it "sets the stderr" do
+        @output.stderr.should == @response[3]
+      end
+    end
+
+    describe "#text" do
+      it "returns the stdout" do
+        response = Open4::popen4("ruby -v")
+        output = Output.new(response)
+
+        expected = `ruby -v`.strip
+        output.text.should == expected
+      end
+    end
+  end
+end

data/spec/doughboy_spec.rb

@@ -0,0 +1,4 @@
+require 'spec_helper'
+
+describe Doughboy do
+end

data/spec/spec.rake

@@ -0,0 +1,7 @@
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.pattern = "./spec/**/*_spec.rb"
+  # Put spec opts in a file named .rspec in root
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+require 'rspec'
+require ::File.dirname(__FILE__) + '/../lib/doughboy.rb'
+
+Rspec.configure do |config|
+end

metadata

@@ -0,0 +1,117 @@
+--- !ruby/object:Gem::Specification 
+name: doughboy
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 2
+  version: 0.0.2
+platform: ruby
+authors: 
+- Joshua Schairbaum
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-04 00:00:00 -06:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: open4
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 0
+        - 1
+        version: 1.0.1
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 4
+        - 0
+        version: 2.4.0
+  type: :development
+  version_requirements: *id002
+description: Doughboy is a Ruby library that strives to enable developers to easily make subprocessed shell calls.
+email: 
+- joshua.schairbaum@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rspec
+- .rvmrc
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.markdown
+- Rakefile
+- autotest/.autotest
+- autotest/discover.rb
+- doughboy.gemspec
+- lib/doughboy.rb
+- lib/doughboy/command.rb
+- lib/doughboy/output.rb
+- lib/doughboy/version.rb
+- spec/doughboy/command_spec.rb
+- spec/doughboy/output_spec.rb
+- spec/doughboy_spec.rb
+- spec/spec.rake
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: doughboy
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Easily run command-line programs. This
+test_files: 
+- spec/doughboy/command_spec.rb
+- spec/doughboy/output_spec.rb
+- spec/doughboy_spec.rb
+- spec/spec.rake
+- spec/spec_helper.rb