rainforest-cli 0.0.7 → 0.0.8

data/README.md

@@ -6,20 +6,35 @@ A command line interface to interact with RainforestQA.
 
     $ gem install rainforest-cli
 
-## Usage
+## Basic Usage
 To use the cli client, you'll need your API token from a test settings page from inside [Rainforest](https://app.rainforestqa.com/).
 
 Run all of your tests
 
     rainforest run all --token YOUR_TOKEN_HERE
 
-Run and report
+Run all in the foreground and report
 
-    rainforest run --fg all --token YOUR_TOKEN_HERE
+    rainforest run all --fg --token YOUR_TOKEN_HERE
 
 Run all tests with tag 'run-me' and abort previous in-progress runs.
 
-    rainforest run --tag run-me --conflict abort --token YOUR_TOKEN_HERE 
+    rainforest run --tag run-me --fg --conflict abort --token YOUR_TOKEN_HERE 
+
+
+## Options
+
+Required:
+- `--token <your-rainforest-token>` - you must supply your token (get it from any tests API tab)
+
+The options are:
+
+- `--browsers ie8` or `--browsers ie8,chrome` - specficy the browsers you wish to run against. This overrides the test own settings. Valid browsers are ie8, ie9, chrome, firefox and safari.
+- `--tag run-me` - only run tests which have this tag (recommended if you have lots of [test-steps](http://docs.rainforestqa.com/pages/example-test-suite.html#test_steps))!)
+- `--conflict abort` - if you trigger rainforest more than once, anything running will be aborted and a fresh run started
+- `--fail-fast` - fail the build as soon as the first failed result comes in. If you don't pass this it will wait until 100% of the run is done
+- `--fg` - results in the foreground - this is what you want to make the build pass / fail dependent on rainforest results 
+
 
 ## Contributing
 

data/lib/rainforest/cli.rb

@@ -18,6 +18,7 @@ module Rainforest
       end
 
       post_opts[:conflict] = @options.conflict if @options.conflict
+      post_opts[:browsers] = @options.browsers if @options.browsers
 
       puts "Issuing run"
 

data/lib/rainforest/cli/options.rb

@@ -2,14 +2,25 @@ require 'optparse'
 
 module Rainforest
   module Cli
+    class BrowserException < Exception
+      def initialize browsers
+        invalid_browsers = browsers - OptionParser::VALID_BROWSERS
+        super "#{invalid_browsers.join(', ')} is not valid. Valid browsers: #{OptionParser::VALID_BROWSERS.join(', ')}"
+      end
+    end
+
     class OptionParser
-      attr_reader :command, :token, :tags, :conflict
+      attr_reader :command, :token, :tags, :conflict, :browsers
+
+      VALID_BROWSERS = %w{chrome firefox safari ie8 ie9}.freeze
 
       def initialize(args)
         @args = args.dup
         @tags = []
+        @browsers = nil
 
         @parsed = ::OptionParser.new do |opts|
+          puts opts.inspect
           opts.on("--fg", "Run the tests in foreground.") do |value|
             @foreground = value
           end
@@ -22,10 +33,16 @@ module Rainforest
             @token = value
           end
 
-          opts.on("--tag TOKEN", String, "A tag to run the tests with") do |value|
+          opts.on("--tag TAG", String, "A tag to run the tests with") do |value|
             @tags << value
           end
 
+          opts.on("--browsers LIST", "Run against the specified browsers") do |value|
+            @browsers = value.split(',').map{|x| x.strip.downcase }.uniq
+
+            raise BrowserException, @browsers unless (@browsers - VALID_BROWSERS).empty?
+          end
+
           opts.on("--conflict MODE", String, "How should Rainforest handle existing in progress runs?") do |value|
             @conflict = value
           end

data/lib/rainforest/cli/version.rb

@@ -1,5 +1,5 @@
 module Rainforest
   module Cli
-    VERSION = "0.0.7"
+    VERSION = "0.0.8"
   end
 end

data/spec/options_spec.rb

@@ -13,6 +13,24 @@ describe Rainforest::Cli::OptionParser do
     its(:tags) { should == ["run-me"]}
   end
 
+  context "only run in specific browsers" do
+    let(:args) { ["run", "--browsers", "ie8"] }
+    its(:browsers) { should == ["ie8"]}
+  end
+
+  context "raises errors with invalid browsers" do
+    let(:args) { ["run", "--browsers", "lulbrower"] }
+
+    it "raises an exception" do
+      expect{subject}.to raise_error(Rainforest::Cli::BrowserException)
+    end
+  end
+
+  context "accepts multiple browsers" do
+    let(:args) { ["run", "--browsers", "ie8,chrome"] }
+    its(:browsers) { should == ["ie8", "chrome"]}
+  end
+
   context "it parses the --fg flag" do
     let(:args) { ["run", "--fg", "all"] }
     its(:tests) { should == ["all"]}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rainforest-cli
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.8
   prerelease: 
 platform: ruby
 authors:
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-09-13 00:00:00.000000000 Z
+date: 2013-09-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty