gofer 0.2.1 → 0.2.2

data/HISTORY.md

@@ -1,16 +1,20 @@
 # Revision History
 
+### v0.2.2 10/05/20011
+
+ * Add `run_multiple` method to `Gofer::Host`
+ 
 ### v0.2.1 08/05/2011
 
  * Add `quiet=` to Host instance to allow setting quiet to be the default.
 
 ### v0.2.0 03/05/2011
 
- * Flip ordering of username/hostname on instantiation to match that of Net::SSH
+ * Flip ordering of username/hostname on instantiation to match that of `Net::SSH`
  
 ### v0.1.2 03/05/2011
 
- * Pass through Gofer::Host instantiation options straight through to Net::SSH.
+ * Pass through `Gofer::Host` instantiation options straight through to `Net::SSH`.
 
 ### v0.1.1 23/04/2011
 

data/README.md

@@ -54,6 +54,11 @@
     h.run "echo noisier 1>&2", :quiet_stderr => true # don't print stderr
     h.quiet = true                                   # never print stdout
 
+### Run multiple commands
+    
+    response = h.run_multiple(['echo hello', 'echo goodbye'], :quiet => true)
+    puts response.stdout # will print "hello\ngoodbye\n"
+    
 ## Planned Features
 
     h.write("a string buffer", 'a_remote_file')

data/lib/gofer/host.rb

@@ -52,6 +52,33 @@ module Gofer
       end
       response
     end
+    
+    # Run +commands+ one by one in order.
+    #
+    # Raise an error if a command in +commands+ exits with a non-zero status.
+    #
+    # Print +stdout+ and +stderr+ as they're received. 
+    #
+    # Return a Gofer::Response object.
+    # 
+    # Options:
+    #
+    # +quiet+:: Don't print +stdout+, can also be set with +quiet=+ on the instance
+    # +quiet_stderr+:: Don't print +stderr+
+    #
+    # The behaviour of passing +capture_exit_status+ here is undefined.
+    def run_multiple commands, opts={}
+      return if commands.empty?
+      
+      responses = commands.map do |command|
+        run command, opts
+      end
+      
+      first_response = responses.shift
+      responses.reduce(first_response) do |cursor, response|
+        Response.new(cursor.stdout + response.stdout, cursor.stderr + response.stderr, cursor.output + response.output, 0)
+      end
+    end
 
     # Return +true+ if +path+ exits.
     def exists? path

data/lib/gofer/version.rb

@@ -1,3 +1,3 @@
 module Gofer # :nodoc:
-  VERSION = "0.2.1"
+  VERSION = "0.2.2"
 end

data/spec/gofer/integration_spec.rb

@@ -59,29 +59,34 @@ describe Gofer do
     end
   end
 
+  shared_examples_for "an output capturer" do
+    it "and capture stdout in @response.stdout" do
+      @response.stdout.should == "stdout\n"
+    end
+  
+    it "and capture stderr in @response.stderr" do
+      @response.stderr.should == "stderr\n"
+    end
+  
+    it "and combine captured stdout / stderr in @response.output" do
+      @response.output.should == "stdout\nstderr\n"
+    end
+  
+    it "and @response by itself should be the captured stdout" do
+      @response.should == "stdout\n"
+    end
+  end
+  
   describe :run do
-    describe "with stdout and stderr responses" do
+      
+    describe "with a stdout and stderr responses" do
       before :all do 
         @response = @host.run "echo stdout; echo stderr 1>&2", :quiet_stderr => true
       end
-    
-      it "should capture stdout in @response.stdout" do
-        @response.stdout.should == "stdout\n"
-      end
-    
-      it "should capture stderr in @response.stderr" do
-        @response.stderr.should == "stderr\n"
-      end
-    
-      it "should combine captured stdout / stderr in @response.output" do
-        @response.output.should == "stdout\nstderr\n"
-      end
-    
-      it "@response by itself should be the captured stdout" do
-        @response.should == "stdout\n"
-      end
-    end
       
+      it_should_behave_like "an output capturer"
+    end
+
     it "should error if a command returns a non-zero response" do
       lambda {@host.run "false"}.should raise_error /failed with exit status/
     end
@@ -91,7 +96,20 @@ describe Gofer do
       response.exit_status.should == 1
     end
   end
-
+  
+  describe :run_multiple do
+    describe "with stdout and stderr responses" do
+      before :all do
+        @response = @host.run_multiple ["echo stdout", "echo stderr 1>&2"], :quiet_stderr => true
+      end
+      it_should_behave_like "an output capturer"
+    end
+    
+    it "should error if a command returns a non-zero response" do
+      lambda {@host.run_multiple ["echo", "false"]}.should raise_error /failed with exit status/
+    end
+  end
+    
   describe :exists? do
     it "should return true if a path or file exists" do
       raw_ssh "touch #{in_tmpdir 'exists'}"

metadata

@@ -2,7 +2,7 @@
 name: gofer
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors: 
 - Michael Pearson
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-05-08 00:00:00 +10:00
+date: 2011-05-10 00:00:00 +10:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency