sauce 0.12.6 → 0.12.7

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/README.markdown

@@ -1,41 +1,72 @@
-sauce
-=====
-
-Ruby access to Sauce OnDemand
+Sauce OnDemand is a Selenium testing cloud service, developed by Sauce
+Labs Inc (saucelabs.com). This is the Ruby client adapter for Sauce
+OnDemand.
 
 Features
 --------
-Current:
 
 *   Drop-in replacement for Selenium::Client::Driver that takes care of connecting to Sauce OnDemand
 *   RSpec, Test::Unit, and Rails integration for tests, including automatic setup of Sauce Connect
 *   ActiveRecord-like interface for tunnels and jobs: Find/create/destroy
-*   Start/stop local instances of Sauce RC
-
-Planned:
-
-*   Webrat integration
-*   Extend to automatic retrieval of jobs logs, videos, reverse tunnels
 
 Install
 -------
+
 `gem install sauce`
 
+Rails Integration
+-------
+
+You can use either RSpec or Test::Unit with Rails and Sauce OnDemand.  To get started, run the generator:
+
+`script/generate sauce USERNAME ACCESS_KEY`
+
+The generator will take care of setting up your helpers with Sauce OnDemand
+configuration, which you can tweak inside the `Sauce.config` block if necessary.
+
+### Example RSpec test for Rails
+
+Here's an example test for RSpec.  Drop something like this in spec/selenium/example.rb:
+
+    require "spec_helper"
+    
+    describe "my app" do
+      it "should have a home page" do
+        page.open "/"
+        page.is_text_present("Welcome Aboard").should be_true
+      end
+    end
+
+Here's how you run RSpec tests with Sauce OnDemand using rake:
+
+`rake spec:selenium:sauce`
+
+### Example Test::Unit test for Rails
+
+Here's an example test for Test::Unit.  Drop something like this in test/selenium/example.rb:
+
+    require "test_helper"
+    
+    class DemoTest < Sauce::RailsTestCase
+      test "my app", do
+        page.open "/"
+        page.is_text_present("Welcome Aboard").should be_true
+      end
+    end
+
+Here's how you run Test::Unit tests with Sauce OnDemand using rake:
+
+`rake test:selenium:sauce`
+
+RSpec integration without Rails
+-------------------------------
+
+First, configure with your account info:
+
 `sauce config USERNAME ACCESS_KEY`
 
-Examples
--------
-### Selenium Client driver
-    require 'rubygems'
-    require 'sauce'
-    selenium = Sauce::Selenium.new(:browser_url => "http://saucelabs.com",
-        :browser => "firefox", :browser_version => "3.", :os => "Windows 2003",
-        :job_name => "My first test!")
-    selenium.start
-    selenium.open "/"
-    selenium.stop
+And here's an example test:
 
-### RSpec integration
     #!/usr/bin/env ruby
     #
     # Sample RSpec test case using the Sauce gem
@@ -70,7 +101,15 @@ Examples
       end
     end
 
-### Test::Unit integration
+Test::Unit integration without Rails
+------------------------------------
+
+First, configure with your account info:
+
+`sauce config USERNAME ACCESS_KEY`
+
+And here's an example test:
+
     #!/usr/bin/env ruby
     #
     # Sample Test:Unit test case using the Sauce gem
@@ -98,51 +137,40 @@ Examples
         end
     end
 
-### Rails integration
-You can use either RSpec or Test::Unit with Rails and Sauce OnDemand.
-The generator will take care of setting up your helpers with Sauce OnDemand
-configuration, which you can tweak inside the `Sauce.config` block.
-
-`gem install sauce`
-
-`script/generate sauce USERNAME ACCESS_KEY`
+Direct use of the Selenium Client driver
+----------------------------------------
 
-For RSpec, drop something like this in spec/selenium:
+First, configure with your account info:
 
-    require "spec_helper"
-    
-    describe "my app" do
-      it "should have a home page" do
-        page.open "/"
-        page.is_text_present("Welcome Aboard").should be_true
-      end
-    end
-
-For Test::Unit, drop something like this in test/selenium:
-
-    require "test_helper"
-    
-    class DemoTest < Sauce::RailsTestCase
-      test "my app", do
-        page.open "/"
-        page.is_text_present("Welcome Aboard").should be_true
-      end
-    end
-
-To run your tests, use rake:
+`sauce config USERNAME ACCESS_KEY`
 
-`rake spec:selenium:sauce`
+And here's an example test:
 
-`rake test:selenium:sauce`
+    require 'rubygems'
+    require 'sauce'
+    selenium = Sauce::Selenium.new(:browser_url => "http://saucelabs.com",
+        :browser => "firefox", :browser_version => "3.", :os => "Windows 2003",
+        :job_name => "My first test!")
+    selenium.start
+    selenium.open "/"
+    selenium.stop
 
 Note on Patches/Pull Requests
 ----------------------------- 
+
 *   Fork the project.
 *   Make your feature addition or bug fix.
 *   Add tests for it. This is important so we don't break it in a future version unintentionally.
 *   Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
 *   Send me a pull request. Bonus points for topic branches.
 
+Plans
+-----
+
+*   Webrat integration
+*   Extend to automatic retrieval of jobs logs, videos, reverse tunnels
+
 Copyright
 ---------
-Copyright (c) 2009-2010 Sauce Labs Inc. See LICENSE for details.
+
+Copyright (c) 2009-2011 Sauce Labs Inc. See LICENSE for details.

data/VERSION

@@ -1 +1 @@
-0.12.6
+0.12.7

data/bin/sauce

@@ -32,7 +32,7 @@ else
   configure = ConfigureCommand.new('configure', false)
   configure.short_desc = "Configure Sauce OnDemand credentials"
   configure.set_execution_block do |args|
-    if args.length < 2:
+    if args.length < 2
       puts configure.usage
       exit 1
     end

data/generators/sauce/sauce_generator.rb

@@ -24,7 +24,7 @@ class SauceGenerator < Rails::Generator::Base
       m.directory File.join('lib', 'tasks')
       m.directory File.join('test', 'selenium') if File.directory? 'test'
       m.file      'sauce.rake', File.join('lib', 'tasks', 'sauce.rake')
-      m.setup_helper(File.join('test', 'test_helper.rb'))
+      m.setup_helper(File.join('test', 'test_helper.rb')) if File.directory? 'test'
     end
   end
 

data/lib/generators/sauce_generator.rb

@@ -8,6 +8,10 @@ class SauceGenerator < Rails::Generators::Base
     copy_file "sauce.rake", "lib/tasks/sauce.rake"
   end
 
+  def configure_credentials
+    system("sauce config #{username} #{api_key}")
+  end
+
   def setup_spec
     if File.directory? 'spec'
       empty_directory "spec/selenium"
@@ -16,8 +20,10 @@ class SauceGenerator < Rails::Generators::Base
   end
 
   def setup_test
-    empty_directory "test/selenium"
-    append_file "test/test_helper.rb", generate_config
+    if File.directory? 'test'
+      empty_directory "test/selenium"
+      append_file "test/test_helper.rb", generate_config
+    end
   end
 
   private

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: sauce
 version: !ruby/object:Gem::Version 
-  hash: 35
+  hash: 33
   prerelease: false
   segments: 
   - 0
   - 12
-  - 6
-  version: 0.12.6
+  - 7
+  version: 0.12.7
 platform: ruby
 authors: 
 - Sean Grove
@@ -17,7 +17,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-01-15 00:00:00 -08:00
+date: 2011-01-17 00:00:00 -08:00
 default_executable: sauce
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -151,6 +151,7 @@ extra_rdoc_files:
 - README.markdown
 files: 
 - .document
+- .gitignore
 - LICENSE
 - README.markdown
 - Rakefile
@@ -177,7 +178,6 @@ files:
 - lib/sauce/selenium.rb
 - lib/sauce/tunnel.rb
 - lib/sauce/utilities.rb
-- sauce.gemspec
 - support/sauce_connect
 - support/selenium-server.jar
 - support/simplejson/LICENSE.txt
@@ -198,8 +198,8 @@ homepage: http://github.com/saucelabs/sauce
 licenses: []
 
 post_install_message: 
-rdoc_options: []
-
+rdoc_options: 
+- --charset=UTF-8
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -228,14 +228,14 @@ signing_key:
 specification_version: 3
 summary: Ruby access to Sauce Labs' features
 test_files: 
-- examples/helper.rb
-- examples/other_spec.rb
-- examples/saucelabs_spec.rb
-- examples/test_saucelabs.rb
-- examples/test_saucelabs2.rb
 - test/helper.rb
 - test/test_config.rb
 - test/test_connect.rb
 - test/test_jobs.rb
 - test/test_selenium.rb
 - test/test_tunnels.rb
+- examples/helper.rb
+- examples/other_spec.rb
+- examples/saucelabs_spec.rb
+- examples/test_saucelabs.rb
+- examples/test_saucelabs2.rb

data/sauce.gemspec

@@ -1,118 +0,0 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
-# -*- encoding: utf-8 -*-
-
-Gem::Specification.new do |s|
-  s.name = %q{sauce}
-  s.version = "0.12.6"
-
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Sean Grove", "Eric Allen", "Steven Hazel"]
-  s.date = %q{2011-01-15}
-  s.default_executable = %q{sauce}
-  s.description = %q{A Ruby interface to Sauce Labs' services. Start/stop tunnels, retrieve Selenium logs, access video replays, etc.}
-  s.email = %q{help@saucelabs.com}
-  s.executables = ["sauce"]
-  s.extra_rdoc_files = [
-    "LICENSE",
-    "README.markdown"
-  ]
-  s.files = [
-    ".document",
-    "LICENSE",
-    "README.markdown",
-    "Rakefile",
-    "VERSION",
-    "bin/sauce",
-    "examples/helper.rb",
-    "examples/other_spec.rb",
-    "examples/saucelabs_spec.rb",
-    "examples/test_saucelabs.rb",
-    "examples/test_saucelabs2.rb",
-    "generators/sauce/sauce_generator.rb",
-    "generators/sauce/templates/sauce.rake",
-    "lib/generators/sauce_generator.rb",
-    "lib/generators/templates/sauce.rake",
-    "lib/sauce.rb",
-    "lib/sauce/client.rb",
-    "lib/sauce/config.rb",
-    "lib/sauce/connect.rb",
-    "lib/sauce/gateway_ext.rb",
-    "lib/sauce/heroku.rb",
-    "lib/sauce/integrations.rb",
-    "lib/sauce/job.rb",
-    "lib/sauce/raketasks.rb",
-    "lib/sauce/selenium.rb",
-    "lib/sauce/tunnel.rb",
-    "lib/sauce/utilities.rb",
-    "sauce.gemspec",
-    "support/sauce_connect",
-    "support/selenium-server.jar",
-    "support/simplejson/LICENSE.txt",
-    "support/simplejson/__init__.py",
-    "support/simplejson/decoder.py",
-    "support/simplejson/encoder.py",
-    "support/simplejson/ordered_dict.py",
-    "support/simplejson/scanner.py",
-    "support/simplejson/tool.py",
-    "test/helper.rb",
-    "test/test_config.rb",
-    "test/test_connect.rb",
-    "test/test_jobs.rb",
-    "test/test_selenium.rb",
-    "test/test_tunnels.rb"
-  ]
-  s.homepage = %q{http://github.com/saucelabs/sauce}
-  s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.3.7}
-  s.summary = %q{Ruby access to Sauce Labs' features}
-  s.test_files = [
-    "examples/helper.rb",
-    "examples/other_spec.rb",
-    "examples/saucelabs_spec.rb",
-    "examples/test_saucelabs.rb",
-    "examples/test_saucelabs2.rb",
-    "test/helper.rb",
-    "test/test_config.rb",
-    "test/test_connect.rb",
-    "test/test_jobs.rb",
-    "test/test_selenium.rb",
-    "test/test_tunnels.rb"
-  ]
-
-  if s.respond_to? :specification_version then
-    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
-    s.specification_version = 3
-
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_development_dependency(%q<thoughtbot-shoulda>, [">= 0"])
-      s.add_runtime_dependency(%q<rest-client>, [">= 0"])
-      s.add_runtime_dependency(%q<net-ssh>, [">= 0"])
-      s.add_runtime_dependency(%q<net-ssh-gateway>, [">= 0"])
-      s.add_runtime_dependency(%q<selenium-client>, [">= 1.2.18"])
-      s.add_runtime_dependency(%q<json>, [">= 1.4.6"])
-      s.add_runtime_dependency(%q<cmdparse>, [">= 2.0.2"])
-      s.add_runtime_dependency(%q<highline>, [">= 1.5.0"])
-    else
-      s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
-      s.add_dependency(%q<rest-client>, [">= 0"])
-      s.add_dependency(%q<net-ssh>, [">= 0"])
-      s.add_dependency(%q<net-ssh-gateway>, [">= 0"])
-      s.add_dependency(%q<selenium-client>, [">= 1.2.18"])
-      s.add_dependency(%q<json>, [">= 1.4.6"])
-      s.add_dependency(%q<cmdparse>, [">= 2.0.2"])
-      s.add_dependency(%q<highline>, [">= 1.5.0"])
-    end
-  else
-    s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
-    s.add_dependency(%q<rest-client>, [">= 0"])
-    s.add_dependency(%q<net-ssh>, [">= 0"])
-    s.add_dependency(%q<net-ssh-gateway>, [">= 0"])
-    s.add_dependency(%q<selenium-client>, [">= 1.2.18"])
-    s.add_dependency(%q<json>, [">= 1.4.6"])
-    s.add_dependency(%q<cmdparse>, [">= 2.0.2"])
-    s.add_dependency(%q<highline>, [">= 1.5.0"])
-  end
-end
-