RubyGems - rubidium - Versions diffs - 0.0.0 - Mend

rubidium 0.0.0

Files changed (26) hide show

data/.gitignore +8 -0
data/Gemfile +16 -0
data/LICENSE +20 -0
data/README +8 -0
data/README.rdoc +18 -0
data/VERSION +1 -0
data/bin/rubidium +54 -0
data/examples/google.com/googleSuite.html +14 -0
data/examples/google.com/sanityTest.html +58 -0
data/init.rb +29 -0
data/lib/rubidium.rb +9 -0
data/lib/rubidium/converter.rb +25 -0
data/lib/rubidium/spec_writer.rb +75 -0
data/lib/rubidium/test_case.rb +26 -0
data/lib/rubidium/test_suite.rb +24 -0
data/lib/rubidium/translator.rb +242 -0
data/rakefile.rb +68 -0
data/rubidium.gemspec +90 -0
data/spec/rubidium/google.com/sanity_test_spec.rb +29 -0
data/spec/rubidium_spec.rb +22 -0
data/spec/spec_helper.rb +8 -0
data/templates/rakefile.rb.erb +56 -0
data/templates/spec.rb.erb +23 -0
data/templates/spec_helper.rb.erb +100 -0
data/todo.org +0 -0
metadata +152 -0

data/.gitignore ADDED

@@ -0,0 +1,8 @@
+pkg/*
+tmp/*
+# bundler
+# bin/*
+# vendor/gems/*
+# !vendor/gems/cache/

data/Gemfile ADDED

@@ -0,0 +1,16 @@
+# disable_system_gems
+clear_sources
+source 'http://gemcutter.org'
+source 'http://gems.github.com'
+source 'http://gems.rubyforge.org'
+gem "rake"
+gem "selenium-client", "1.2.7", :require_as => 'selenium/client'
+gem "nokogiri", ">= 1.4.0"
+#gem "jeweler"
+gem "rspec", "1.1.8", :require_as => 'spec', :only => :never
+gem "deep_test", "1.2.2"
+gem "ruby-debug"
+gem "syntax"

data/LICENSE ADDED

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Incite
+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 ADDED

@@ -0,0 +1,8 @@
+gem install bundler
+gem bundle
+rake spec
+rake generate
+(start up a selenium hub & remotes)
+rake tests:run_in_parallel

data/README.rdoc ADDED

@@ -0,0 +1,18 @@
+= rubidium
+Description goes here.
+== Note on Patches/Pull Requests
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I 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.
+== Copyright
+Copyright (c) 2009 davidlee. See LICENSE for details.

data/VERSION ADDED

	@@ -0,0 +1 @@
1	+ 0.0.0

data/bin/rubidium ADDED

@@ -0,0 +1,54 @@
+#!/usr/bin/env ruby
+require 'optparse'
+require File.join(File.dirname(__FILE__), '../init')
+options = {}
+optparse = OptionParser.new do |opts|
+  # Set a banner, displayed at the top
+  # of the help screen.
+  opts.banner = "Usage: rubidium [options] source_folder destination_folder"
+  opts.separator ""
+  opts.separator "Specific options:"
+  # Define the options, and what they do
+  options[:verbose] = false
+  opts.on( '-v', '--verbose', 'Output more information' ) do
+    options[:verbose] = true
+  end
+  # This displays the help screen, all programs are
+  # assumed to have this option.
+  opts.on( '-h', '--help', 'You\'re looking at it' ) do
+    puts opts
+    exit
+  end
+  # Mandatory argument.
+  opts.on("-i", "--input FOLDER",
+          "Find and convert all test suites in FOLDER") do |src|
+    options[:source] << src
+  end
+  opts.on("-o", "--output FOLDER",
+          "Find and convert all test suites in FOLDER") do |dest|
+    options[:destination] << dest
+  end
+end
+optparse.parse!
+p options
+p ARGV
+options[:source]      ||= ARGV.shift
+options[:destination] ||= ARGV.shift
+if options[:source] && options[:destination]
+  Rubidium::Converter.new(options[:source]).write!(options[:destination])
+end

data/examples/google.com/googleSuite.html ADDED

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <meta content="text/html; charset=UTF-8" http-equiv="content-type" />
+  <title>Test Suite</title>
+</head>
+<body>
+<table id="suiteTable" cellpadding="1" cellspacing="1" border="1" class="selenium"><tbody>
+<tr><td><b>Test Suite</b></td></tr>
+<tr><td><a href="sanityTest.html">sanityTest</a></td></tr>
+</tbody></table>
+</body>
+</html>

data/examples/google.com/sanityTest.html ADDED

@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head profile="http://selenium-ide.openqa.org/profiles/test-case">
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+<link rel="selenium.base" href="http://www.google.com.au/" />
+<title>sanityTest</title>
+</head>
+<body>
+<table cellpadding="1" cellspacing="1" border="1">
+<thead>
+<tr><td rowspan="1" colspan="3">sanityTest</td></tr>
+</thead><tbody>
+<!--testing google loads-->
+<tr>
+	<td>open</td>
+	<td>/</td>
+	<td></td>
+</tr>
+<tr>
+	<td>assertTextPresent</td>
+	<td>Google</td>
+	<td></td>
+</tr>
+<tr>
+	<td>assertTextNotPresent</td>
+	<td>Bing</td>
+	<td></td>
+</tr>
+<tr>
+	<td>type</td>
+	<td>q</td>
+	<td>wikipedia</td>
+</tr>
+<tr>
+	<td>keyPress</td>
+	<td>q</td>
+	<td>\13</td>
+</tr>
+<tr>
+	<td>waitForElementPresent</td>
+	<td>css=a.l</td>
+	<td></td>
+</tr>
+<tr>
+	<td>verifyTextPresent</td>
+	<td>Wikipedia, the free encyclopedia</td>
+	<td></td>
+</tr>
+<tr>
+	<td>assertElementPresent</td>
+	<td>link=Wikipedia, the free encyclopedia</td>
+	<td></td>
+</tr>
+</tbody></table>
+</body>
+</html>

data/init.rb ADDED

@@ -0,0 +1,29 @@
+def f(relpath)
+  root_path = File.dirname(__FILE__)
+  File.expand_path(File.join(root_path, relpath))
+end
+begin
+  #  require f 'vendor/gems/environment'
+  #  Bundler.require_env
+  # rescue LoadError
+  #  puts "ack! run gem bundle"
+  require 'rubygems'
+  gem "rake", ">= 0.8.7"
+  gem "selenium-client", "= 1.2.7"
+  gem "nokogiri", ">= 1.4.0"
+  gem "rspec", "= 1.1.8"
+  gem "deep_test", "= 1.2.2"
+  gem "ruby-debug", "> 0"
+  require 'rake'
+  require 'nokogiri'
+  require 'spec'
+  require 'deep_test'
+  require 'ruby-debug'
+  require 'selenium/client'
+  require f 'lib/rubidium'
+end

data/lib/rubidium.rb ADDED

@@ -0,0 +1,9 @@
+$: << File.dirname(__FILE__)
+require 'rubidium/test_case'
+require 'rubidium/test_suite'
+require 'rubidium/translator'
+require 'rubidium/spec_writer'
+require 'rubidium/converter'

data/lib/rubidium/converter.rb ADDED

@@ -0,0 +1,25 @@
+require 'fileutils'
+module Rubidium
+  class Converter
+    attr_reader :test_suites
+    # given a source directory, find all test suites in it, and prepare ruby translations of them.
+    def initialize(source_folder)
+      raise ArgumentError.new("source folder expected") unless File.directory?(source_folder)
+      @test_suites = `grep -rnl suiteTable #{source_folder}`.split("\n").map do |fn|
+        TestSuite.new(fn)
+      end
+    end
+    # write the ruby tests to the given output folder
+    def write!(output_folder)
+      FileUtils.mkdir_p output_folder unless File.directory?(output_folder)
+      SpecWriter.new(output_folder).write!(@test_suites)
+    end
+  end
+end

data/lib/rubidium/spec_writer.rb ADDED

@@ -0,0 +1,75 @@
+require 'fileutils'
+require 'erb'
+module Rubidium
+  class SpecWriter
+    def initialize(output_folder)
+      @output_folder   = output_folder
+    end
+    def write!(*tests)
+      tests.flatten!
+      process_rakefile
+      process_helper
+      test_suites, test_cases = tests.partition { |t| t.is_a?(Rubidium::TestSuite) }
+      process_test_suites test_suites
+      process_test_cases test_cases
+    end
+    private
+    def process_rakefile
+      template_path = f 'templates/rakefile.rb.erb'
+      output_path   = File.join(@output_folder, "rakefile.rb")
+      process_template(template_path, output_path)
+    end
+    def process_helper
+      template_path = f 'templates/spec_helper.rb.erb'
+      output_path   = File.join(@output_folder, "spec_helper.rb")
+      process_template(template_path, output_path)
+    end
+    def process_test_suites(test_suites)
+      template_path = f 'templates/spec.rb.erb'
+      test_suites.each do |ts|
+        ts.test_cases.each do |tc|
+          output_folder = File.join(@output_folder, underscore(ts.name))
+          output_path   = File.join(output_folder, "#{underscore tc.name}_spec.rb")
+          FileUtils.mkdir_p(output_folder)
+          process_template(template_path, output_path) do
+            @application_url = tc.base_url unless tc.base_url == ""
+            @test_case       = tc
+            @test_suite      = ts
+          end
+        end
+      end
+    end
+    def underscore string
+      string.gsub(/ /,'_')
+    end
+    def process_test_cases(test_cases)
+      test_cases.each do |tc|
+        template_path = f 'templates/spec.erb'
+        output_path   = File.join(@output_folder, "#{tc.name}_spec.rb")
+        process_template(template_path, output_path) do
+          @test_case          = tc
+        end
+      end
+    end
+    def process_template(template_path, output_path, &block)
+      if File.exists?(output_path)
+        FileUtils.rm(output_path)
+      end
+      File.open(output_path, 'w') do |fh|
+        yield if block_given?
+        fh.write ERB.new(File.read(template_path)).result(binding)
+      end
+    end
+  end
+end

data/lib/rubidium/test_case.rb ADDED

@@ -0,0 +1,26 @@
+module Rubidium
+  class TestCase
+    attr_reader :title, :base_url, :selenese, :path
+    alias_method :table, :selenese
+    alias_method :name, :title
+    def initialize(path)
+      @path     = path
+      x         = Nokogiri::HTML(File.read(path))
+      @title    = x.xpath('//title').first.text
+      @base_url = x.xpath('//link').attr('href').value
+      @selenese = x.xpath('//tbody/tr').map do |tr|
+        tr.search('td').map(&:text).reject { |txt| txt == "" }
+      end
+    end
+    def ruby
+      Translator.translate(selenese)
+    end
+    def commands
+      Translator.translate(selenese)
+    end
+  end
+end

data/lib/rubidium/test_suite.rb ADDED

@@ -0,0 +1,24 @@
+module Rubidium
+  class TestSuite
+    attr_reader :path, :title, :test_case_paths, :test_cases
+    alias_method :name, :title
+    def initialize(path)
+      @path            = path
+      @test_cases      = []
+      x                = Nokogiri::HTML(File.read(path))
+      @title           = x.xpath('//title').text
+      return false unless x.search('html').attribute 'xmlns' # filter out test reports
+      @test_case_paths = x.xpath('//table/tbody/tr/td/a').map {|a| test_case_path a.attributes['href'].text }
+      @test_cases      = @test_case_paths.map { |p| Rubidium::TestCase.new(p) }
+    end
+    protected
+    def test_case_path relpath
+      dir = File.dirname(path)
+      File.expand_path(File.join(dir, relpath))
+    end
+  end
+end

data/lib/rubidium/translator.rb ADDED

@@ -0,0 +1,242 @@
+module Rubidium
+  # these commands accept an assert | verify | waitFor prefix
+  VARIANTS = {
+    'Alert'                                     => [:pattern],
+    'AlertNotPresent'                           => [],
+    'AlertPresent'                              => [],
+    'AllButtons'                                => [:pattern],
+    'AllFields'                                 => [:pattern],
+    'AllLinks'                                  => [:pattern],
+    'AllWindowIds'                              => [:pattern],
+    'AllWindowNames'                            => [:pattern],
+    'AllWindowTitles'                           => [:pattern],
+    'Attribute'                                 => [:attributeLocator, :pattern],
+    'AttributeFromAllWindows'                   => [:attributeName, :pattern],
+    'BodyText'                                  => [:pattern],
+    'Checked'                                   => [:locator],
+    'Confirmation'                              => [:pattern],
+    'ConfirmationNotPresent'                    => [],
+    'ConfirmationPresent'                       => [],
+    'Cookie'                                    => [:pattern],
+    'CookieByName'                              => [:name, :pattern],
+    'CookieNotPresent'                          => [:name],
+    'CookiePresent'                             => [:name],
+    'CursorPosition'                            => [:locator, :pattern],
+    'Editable'                                  => [:locator],
+    'ElementHeight'                             => [:locator, :pattern],
+    'ElementIndex'                              => [:locator, :pattern],
+    'ElementNotPresent'                         => [:locator],
+    'ElementPositionLeft'                       => [:locator, :pattern],
+    'ElementPositionTop'                        => [:locator, :pattern],
+    'ElementPresent'                            => [:locator],
+    'ElementWidth'                              => [:locator, :pattern],
+    'Eval'                                      => [:script, :pattern],
+    'Expression'                                => [:expression, :pattern],
+    'HtmlSource'                                => [:pattern],
+    'Location'                                  => [:pattern],
+    'MouseSpeed'                                => [:pattern],
+    'NotAlert'                                  => [:pattern],
+    'NotAllButtons'                             => [:pattern],
+    'NotAllFields'                              => [:pattern],
+    'NotAllLinks'                               => [:pattern],
+    'NotAllWindowIds'                           => [:pattern],
+    'NotAllWindowNames'                         => [:pattern],
+    'NotAllWindowTitles'                        => [:pattern],
+    'NotAttribute'                              => [:attributeLocator, :pattern],
+    'NotAttributeFromAllWindows'                => [:attributeName, :pattern],
+    'NotBodyText'                               => [:pattern],
+    'NotChecked'                                => [:locator],
+    'NotConfirmation'                           => [:pattern],
+    'NotCookie'                                 => [:pattern],
+    'NotCookieByName'                           => [:name, :pattern],
+    'NotCursorPosition'                         => [:locator, :pattern],
+    'NotEditable'                               => [:locator],
+    'NotElementHeight'                          => [:locator, :pattern],
+    'NotElementIndex'                           => [:locator, :pattern],
+    'NotElementPositionLeft'                    => [:locator, :pattern],
+    'NotElementPositionTop'                     => [:locator, :pattern],
+    'NotElementWidth'                           => [:locator, :pattern],
+    'NotErrorOnNext'                            => [:message],
+    'NotEval'                                   => [:script, :pattern],
+    'NotExpression'                             => [:expression, :pattern],
+    'NotFailureOnNext'                          => [:message],
+    'NotHtmlSource'                             => [:pattern],
+    'NotLocation'                               => [:pattern],
+    'NotMouseSpeed'                             => [:pattern],
+    'NotOrdered'                                => [:locator, :locator],
+    'NotPrompt'                                 => [:pattern],
+    'NotSelectOptions'                          => [:selectLocator, :pattern],
+    'NotSelected'                               => [:selectLocator, :optionLocator],
+    'NotSelectedId'                             => [:selectLocator, :pattern],
+    'NotSelectedIds'                            => [:selectLocator, :pattern],
+    'NotSelectedIndex'                          => [:selectLocator, :pattern],
+    'NotSelectedIndexes'                        => [:selectLocator, :pattern],
+    'NotSelectedLabel'                          => [:selectLocator, :pattern],
+    'NotSelectedLabels'                         => [:selectLocator, :pattern],
+    'NotSelectedValue'                          => [:selectLocator, :pattern],
+    'NotSelectedValues'                         => [:selectLocator, :pattern],
+    'NotSomethingSelected'                      => [:selectLocator],
+    'NotSpeed'                                  => [:pattern],
+    'NotTable'                                  => [:tableCellAddress, :pattern],
+    'NotText'                                   => [:locator, :pattern],
+    'NotTitle'                                  => [:pattern],
+    'NotValue'                                  => [:locator, :pattern],
+    'NotVisible'                                => [:locator],
+    'NotWhetherThisFrameMatchFrameExpression'   => [:currentFrameString, :target],
+    'NotWhetherThisWindowMatchWindowExpression' => [:currentWindowString, :target],
+    'NotXpathCount'                             => [:xpath, :pattern],
+    'Ordered'                                   => [:locator1, :locator2],
+    'Prompt'                                    => [:pattern],
+    'PromptNotPresent'                          => [],
+    'PromptPresent'                             => [],
+    'SelectOptions'                             => [:selectLocator, :pattern],
+    'SelectedId'                                => [:selectLocator, :pattern],
+    'SelectedIds'                               => [:selectLocator, :pattern],
+    'SelectedIndex'                             => [:selectLocator, :pattern],
+    'SelectedIndexes'                           => [:selectLocator, :pattern],
+    'SelectedLabel'                             => [:selectLocator, :pattern],
+    'SelectedLabels'                            => [:selectLocator, :pattern],
+    'SelectedValue'                             => [:selectLocator, :pattern],
+    'SelectedValues'                            => [:selectLocator, :pattern],
+    'SomethingSelected'                         => [:selectLocator],
+    'Speed'                                     => [:pattern],
+    'Table'                                     => [:tableCellAddress, :pattern],
+    'Text'                                      => [:locator, :pattern],
+    'TextNotPresent'                            => [:pattern],
+    'TextPresent'                               => [:pattern],
+    'Title'                                     => [:pattern],
+    'Value'                                     => [:locator, :pattern],
+    'Visible'                                   => [:locator],
+    'WhetherThisFrameMatchFrameExpression'      => [:currentFrameString, :target],
+    'WhetherThisWindowMatchWindowExpression'    => [:currentWindowString, :target],
+    'XpathCount'                                => [:xpath, :pattern],
+  }
+  class Translator
+    COMPOSITE  = /^(assert|verify|waitFor)([a-zA-Z]+)$/
+    PATTERN    = /^(regexpi?|exact|glob):/
+    def self.translate(selenese)
+      selenese.map { |row| translate_command(*row) }
+    end
+    private
+    # A "Pattern" in selenium nomenclature is a string matcher.
+    # The default is a glob (? and * expansion).
+    def self.pattern(string)
+      # string =~ PATTERN
+      string.gsub! PATTERN, ''
+      type = $1 || 'glob'
+      send("#{type}_pattern", string)
+    end
+    def self.glob_pattern(string)
+      if string =~ /\?|\*/
+        string = Regexp.escape(string)
+        string.gsub! /\\\?/, '.'
+        string.gsub! /\\\*/, '.*'
+        Regexp.new(string)
+      else
+        string
+      end
+    end
+    def self.exact_pattern(string)
+      string
+    end
+    def self.regexp_pattern(string)
+      /#{string}/
+    end
+    def self.regexpi_pattern(string)
+      /#{string}/i
+    end
+    protected
+    def self.default_timeout
+      10000
+    end
+    def self.build_composite_command(command, target=nil, value=nil)
+      # p [:build, command, target, value]
+      command       =~ COMPOSITE
+      verb          = $1
+      variant       = $2
+      expectation   = variant.gsub!(/Not/, '') ? 'should_not' : 'should'
+      ruby_command  = ['', 'get_', 'is_'].map {|s| s + underscore(variant) }.detect { |s| client.respond_to?(s) }
+      ruby_args     = []
+      args          = [target, value].compact
+      client.method(ruby_command).arity.times do
+        ruby_args << args.shift
+      end
+      ruby_args     = ruby_args.compact.map(&:inspect).join(", ")
+      result     = args.first ? pattern(args.first) : true
+      comparison = result.is_a?(Regexp) ? '=~' : '=='
+      result     = result.inspect
+      expression = "selenium.#{ruby_command}(#{ruby_args}).#{expectation} #{comparison} #{result}"
+      case verb
+      when 'assert'
+        expression
+      when 'verify'
+        "begin\n      " +
+        "#{expression}\n    " +
+        "rescue ::Test::Unit::AssertionFailedError, ::Spec::Expectations::ExpectationNotMetError => e\n        " +
+        "@verification_errors << e\n    " +
+        "end\n"
+      when 'waitFor'
+        "wait_for do\n      #{expression}\n    end\n"
+      end
+    end
+    def self.translate_command(command, target=nil, value=nil)
+      # p [:translate, command, target, value]
+      # TODO - custom treatment of patterns
+      # HACK / FIXME in the meantime
+      [target, value].compact.map(&:to_s).each { |s| s.gsub!(/^exact:/, '') }
+      if command.gsub!(/AndWait$/, '')
+        [translate_command(command, target, value), translate_command('waitForPageToLoad', default_timeout)].join("\n    ")
+      elsif command =~ COMPOSITE && VARIANTS.has_key?($2)
+        build_composite_command(command, target, value)
+      else
+        case command
+        when 'pause'
+          "sleep #{target.to_i / 1000}"
+        when 'waitForPageToLoad'
+          "selenium.wait_for_page_to_load(\"#{default_timeout}\")"
+        else
+          ruby_command = underscore(command)
+          if client.respond_to?(ruby_command)
+            args = [target, value].compact
+            while args.length < client.method(ruby_command).arity
+              args << ""
+            end
+            "selenium.#{ruby_command} #{args.map(&:inspect).join(", ")}"
+          else
+            raise "unkown command error: #{command}"
+          end
+        end
+      end
+    end
+    def self.underscore(str)
+      str.split(/([A-Z])/).inject("") { |s, ch| s << (ch =~ /[A-Z]/ ? "_#{ch.downcase}" : ch) }.gsub(/^_/,'')
+    end
+    def self.client
+      @test_client ||= Selenium::Client::Driver.new(nil, nil, nil, nil)
+    end
+  end
+end

data/rakefile.rb ADDED

@@ -0,0 +1,68 @@
+#!/usr/bin/env ruby
+# require 'vendor/gems/environment'
+require File.join(File.dirname(__FILE__),"init")
+Bundler.require_env :runner rescue nil
+# load rake tasks
+require 'rake'
+require "spec/rake/spectask"
+require "selenium/rake/tasks"
+require "deep_test/rake_tasks"
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name    = "rubidium"
+    gem.summary = %Q{convert Selenium tests to ruby/rspec for running against a Grid }
+    gem.description = %Q{convert Selenium tests to ruby/rspec for running against a Grid. Performs much better translation than the Selenium IDE, and a harness for running the resulting specs.}
+    gem.email    = "david@davelee.com.au"
+    gem.homepage = "http://github.com/incite/rubidium"
+    gem.authors  = ["davidlee"]
+    gem.add_development_dependency "jeweler", ">= 0"
+    gem.add_dependency "rake", ">= 0.8.7"
+    gem.add_dependency "selenium-client", "= 1.2.7"
+    gem.add_dependency "nokogiri", ">= 1.4.0"
+    gem.add_dependency "rspec", "= 1.1.8"
+    gem.add_dependency "deep_test", "= 1.2.2"
+    gem.add_dependency "ruby-debug", "> 0"
+    # gem.add_dependency "syntax"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+# Make sure we pick up the reporter from the appropriate selenium-client
+# install as RSpec runner --require does not discriminate between multiple
+# selenium-client gems.
+gem_executable = Config::CONFIG["host_os"] =~ /mswin/ ? "gem.bat" : "gem"
+report_formatter_path = `#{gem_executable} which -q "selenium/rspec/reporting/selenium_test_report_formatter"`.chomp
+report_formatter_path.gsub!(/selenium-client-\d+\.\d+.\d+/, "selenium-client-1.2.7")
+desc "Check whether you installed all dependencies and you environmnet is OK."
+task :sanity_check do
+  require report_formatter_path
+  STDOUT.puts "yeah looks ok"
+end
+desc "Run all specs in spec directory (excluding plugin specs)"
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.spec_files = FileList['spec/**/*/*_spec.rb']
+end
+desc 'generate test suites'
+task :generate do
+  root = File.dirname(__FILE__)
+  Rubidium::Converter.new(File.join(root,'examples/')).write!(File.join(root,'tmp/tests'))
+end
+task :convert do
+  root    = File.dirname(__FILE__)
+  src_dir = 1
+  Rubidium::Converter.new(File.join(root,'examples/')).write!(File.join(root,'tmp/tests'))
+end
+task :default => :spec

data/rubidium.gemspec ADDED

@@ -0,0 +1,90 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in rakefile.rb, and run the gemspec command
+# -*- encoding: utf-8 -*-
+Gem::Specification.new do |s|
+  s.name = %q{rubidium}
+  s.version = "0.0.0"
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["davidlee"]
+  s.date = %q{2009-11-11}
+  s.description = %q{convert Selenium tests to ruby/rspec for running against a Grid. Performs much better translation than the Selenium IDE, and a harness for running the resulting specs.}
+  s.email = %q{david@davelee.com.au}
+  s.executables = ["bin/rubidium"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".gitignore",
+     "Gemfile",
+     "LICENSE",
+     "README",
+     "README.rdoc",
+     "VERSION",
+     "examples/google.com/googleSuite.html",
+     "examples/google.com/sanityTest.html",
+     "init.rb",
+     "lib/rubidium.rb",
+     "lib/rubidium/converter.rb",
+     "lib/rubidium/spec_writer.rb",
+     "lib/rubidium/test_case.rb",
+     "lib/rubidium/test_suite.rb",
+     "lib/rubidium/translator.rb",
+     "rakefile.rb",
+     "rubidium.gemspec",
+     "script/rubidium",
+     "spec/rubidium/google.com/sanity_test_spec.rb",
+     "spec/rubidium_spec.rb",
+     "spec/spec_helper.rb",
+     "templates/rakefile.rb.erb",
+     "templates/spec.rb.erb",
+     "templates/spec_helper.rb.erb",
+     "todo.org"
+  ]
+  s.homepage = %q{http://github.com/incite/rubidium}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{convert Selenium tests to ruby/rspec for running against a Grid}
+  s.test_files = [
+    "spec/rubidium/google.com/sanity_test_spec.rb",
+    "spec/rubidium_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<jeweler>, [">= 0"])
+      s.add_runtime_dependency(%q<rake>, [">= 0.8.7"])
+      s.add_runtime_dependency(%q<selenium-client>, ["= 1.2.7"])
+      s.add_runtime_dependency(%q<nokogiri>, [">= 1.4.0"])
+      s.add_runtime_dependency(%q<rspec>, ["= 1.1.8"])
+      s.add_runtime_dependency(%q<deep_test>, ["= 1.2.2"])
+      s.add_runtime_dependency(%q<ruby-debug>, ["> 0"])
+    else
+      s.add_dependency(%q<jeweler>, [">= 0"])
+      s.add_dependency(%q<rake>, [">= 0.8.7"])
+      s.add_dependency(%q<selenium-client>, ["= 1.2.7"])
+      s.add_dependency(%q<nokogiri>, [">= 1.4.0"])
+      s.add_dependency(%q<rspec>, ["= 1.1.8"])
+      s.add_dependency(%q<deep_test>, ["= 1.2.2"])
+      s.add_dependency(%q<ruby-debug>, ["> 0"])
+    end
+  else
+    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency(%q<rake>, [">= 0.8.7"])
+    s.add_dependency(%q<selenium-client>, ["= 1.2.7"])
+    s.add_dependency(%q<nokogiri>, [">= 1.4.0"])
+    s.add_dependency(%q<rspec>, ["= 1.1.8"])
+    s.add_dependency(%q<deep_test>, ["= 1.2.2"])
+    s.add_dependency(%q<ruby-debug>, ["> 0"])
+  end
+end

data/spec/rubidium/google.com/sanity_test_spec.rb ADDED

@@ -0,0 +1,29 @@
+require File.join(File.dirname(__FILE__), '../../spec_helper.rb')
+describe "sanity check w/ google" do
+  before do
+    @test = Rubidium::TestCase.new f 'examples/google.com/sanityTest.html'
+  end
+  it "is called sanityTest" do
+    @test.name.should == 'sanityTest'
+  end
+  it "operates on google.com.au" do
+    @test.base_url.should == "http://www.google.com.au/"
+  end
+  it "has a table of selenese commands" do
+    @test.table.should == [
+      ["open", "/"],
+      ["assertTextPresent", "Google"],
+      ["assertTextNotPresent", "Bing"],
+      ["type", "q", "wikipedia"],
+      ["keyPress", "q", "\\13"],
+      ["waitForElementPresent", "css=a.l"],
+      ["verifyTextPresent", "Wikipedia, the free encyclopedia"],
+      ["assertElementPresent", "link=Wikipedia, the free encyclopedia"]
+    ]
+  end
+end

data/spec/rubidium_spec.rb ADDED

@@ -0,0 +1,22 @@
+require File.join(File.dirname(__FILE__), 'spec_helper.rb')
+describe "spec writer" do
+  describe "convert a test case" do
+    before do
+      @test_case   = Rubidium::TestCase.new(f('examples/google.com/sanityTest.html'))
+      @writer      = Rubidium::SpecWriter.new(f('tmp/tests'))
+    end
+    it "generate a spec file" do
+      @test_case.should be_kind_of Rubidium::TestCase
+      @writer.write!(@test_case)
+    end
+  end
+  describe "convert a directory" do
+    it "convert test suites" do
+      converter = Rubidium::Converter.new f('examples/')
+      converter.write! f('tmp/suites')
+    end
+  end
+end

data/spec/spec_helper.rb ADDED

@@ -0,0 +1,8 @@
+require File.join(File.dirname(__FILE__), '..', 'init')
+Spec::Runner.configure do |config|
+  # config.include CustomMatchers
+  # config.before(:all) do
+  # end
+end

data/templates/rakefile.rb.erb ADDED

@@ -0,0 +1,56 @@
+require <%= File.expand_path(f 'init').inspect %>
+require "rake"
+require "spec/rake/spectask"
+require "selenium/rake/tasks"
+require "deep_test/rake_tasks"
+# Make sure we pick up the reporter from the appropriate selenium-client
+# install as RSpec runner --require does not discriminate between multiple
+# selenium-client gems.
+gem_executable = Config::CONFIG["host_os"] =~ /mswin/ ? "gem.bat" : "gem"
+report_formatter_path = `#{gem_executable} which -q "selenium/rspec/reporting/selenium_test_report_formatter"`.chomp
+report_formatter_path.gsub! /selenium-client-\d+\.\d+.\d+/, "selenium-client-1.2.7"
+#
+# Recommended way to run tests in parallel and leverage Selenium Grid.
+#
+desc("Run all tests in parallel using DeepTest.")
+Spec::Rake::SpecTask.new("tests:run_in_parallel") do |t|
+  t.spec_files = FileList['./**/*_spec.rb']
+  t.deep_test :number_of_workers => 6,
+              :timeout_in_seconds => 300
+  t.spec_opts << '--color'
+  t.spec_opts << "--require 'rubygems,#{report_formatter_path}'"
+  t.spec_opts << "--format=Selenium::RSpec::SeleniumTestReportFormatter:./tmp/test_report.html"
+  t.spec_opts << "--format=progress"
+end
+task :'tests:run_in_parallel' => :create_report_dir
+#
+# Running tests in sequence (without taking advantage of Selenium Grid),
+# useful to troubleshoot problems with the parallel run.
+#
+desc "Run all behaviors in sequence"
+Spec::Rake::SpecTask.new('tests:run_in_sequence') do |t|
+  t.pattern = "./**/*_spec.rb"
+  t.spec_opts << '--color'
+  t.spec_opts << "--require 'rubygems,#{report_formatter_path}'"
+  t.spec_opts << "--format=Selenium::RSpec::SeleniumTestReportFormatter:./tmp/test_report.html"
+  t.spec_opts << "--format=progress"
+  t.fail_on_error = true
+end
+task :'tests:run_in_sequence' => :create_report_dir
+task :create_report_dir do
+  rm_f File.expand_path(File.dirname(__FILE__) + "/tmp/rspec_report")
+  mkdir_p File.expand_path(File.dirname(__FILE__) + "/tmp/rspec_report")
+  ENV['SELENIUM_TEST_REPORT_FILE'] = "./tmp/test_report.html" # Workaround for DeepTest reports
+end
+task :p => :'tests:run_in_parallel'
+task :s => :'tests:run_in_sequence'
+task :default => :s

data/templates/spec.rb.erb ADDED

@@ -0,0 +1,23 @@
+# this is a selenium test case generated by Rubidium.
+# do not edit this file directly.
+require File.join(File.dirname(__FILE__), '../spec_helper')
+describe "<%= @test_case && @test_suite.name || @test_case.name %>" do
+  before :each do
+    create_selenium_driver({ :application_url => <%= @application_url.inspect %> })
+    start_new_browser_session
+    @verification_errors = []
+  end
+  it "<%= @test_case.name %>" do
+    <%= @test_case.commands.join("\n    ") %>
+  end
+  after :each do
+    @selenium_driver.stop
+    @verification_errors.should == []
+  end
+end

data/templates/spec_helper.rb.erb ADDED

@@ -0,0 +1,100 @@
+# this is the helper
+require <%= File.expand_path(f 'init').inspect %>
+require "rake"
+require 'spec/rake/spectask'
+require "selenium/rake/tasks"
+require "selenium/client"
+require "selenium/rspec/spec_helper"
+require "deep_test/rake_tasks"
+module SeleniumTestHelper
+  def wait_for(params={})
+    timeout = params[:timeout] || 5
+    message = params[:message] || "Timeout exceeded"
+    begin_time = Time.now
+    while (Time.now - begin_time) < timeout
+      value = nil
+      begin
+        value = yield
+      rescue Exception => e
+        unless is_ignorable_wait_for_exception?(e)
+          raise e
+        end
+      end
+      return value if value
+      sleep 0.25
+    end
+    raise Webrat::TimeoutError.new(message + " (after #{timeout} sec)")
+    true
+  end
+  protected
+  def is_ignorable_wait_for_exception?(exception) #:nodoc:
+    if defined?(::Spec::Expectations::ExpectationNotMetError)
+      return true if exception.class == ::Spec::Expectations::ExpectationNotMetError
+    end
+    return [::Selenium::CommandError].include?(exception.class)
+  end
+  def start_new_browser_session
+    @selenium_driver.start_new_browser_session
+    @selenium_driver.set_context "Starting example '#{self.description}'"
+  end
+  def selenium_driver
+    @selenium_driver
+  end
+  def selenium
+    @selenium_driver
+  end
+  def create_selenium_driver(options={})
+    options = {
+      "grid_host" => ( ENV['SELENIUM_RC_HOST']          || 'localhost'),
+      "grid_port" => ( ENV['SELENIUM_RC_PORT']          || '4444'),
+      "browser"   => ( ENV['SELENIUM_RC_BROWSER']       || '*firefox'),
+      "timeout"   => ( ENV['SELENIUM_RC_TIMEOUT']       || '10000'),
+      "app_host"  => ( ENV['SELENIUM_APPLICATION_HOST'] || 'localhost'),
+      "app_port"  => ( ENV['SELENIUM_APPLICATION_PORT'] || '4000'),
+    }.merge(options)
+    options['application_url'] ||= "http://#{options['app_host']}:#{options['app_port']}"
+    @selenium_driver = Selenium::Client::Driver.new(
+      options['grid_host'],
+      options['grid_port'],
+      options['browser'],
+      options['application_url'],
+      options['timeout'].to_i
+    )
+  end
+end
+Spec::Runner.configure do |config|
+  config.include SeleniumTestHelper
+  config.before(:each) do
+    create_selenium_driver
+    start_new_browser_session
+    @verification_errors = []
+  end
+  # The system capture need to happen BEFORE the closing the Selenium session
+  config.append_after(:each) do
+    @selenium_driver.close_current_browser_session
+  end
+end

data/todo.org ADDED

File without changes

metadata ADDED

@@ -0,0 +1,152 @@
+--- !ruby/object:Gem::Specification
+name: rubidium
+version: !ruby/object:Gem::Version
+  version: 0.0.0
+platform: ruby
+authors:
+- davidlee
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2009-11-11 00:00:00 +11:00
+default_executable: rubidium
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  type: :development
+  version_requirement:
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: "0"
+    version:
+- !ruby/object:Gem::Dependency
+  name: rake
+  type: :runtime
+  version_requirement:
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+    version:
+- !ruby/object:Gem::Dependency
+  name: selenium-client
+  type: :runtime
+  version_requirement:
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "="
+      - !ruby/object:Gem::Version
+        version: 1.2.7
+    version:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  type: :runtime
+  version_requirement:
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.0
+    version:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  type: :runtime
+  version_requirement:
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "="
+      - !ruby/object:Gem::Version
+        version: 1.1.8
+    version:
+- !ruby/object:Gem::Dependency
+  name: deep_test
+  type: :runtime
+  version_requirement:
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "="
+      - !ruby/object:Gem::Version
+        version: 1.2.2
+    version:
+- !ruby/object:Gem::Dependency
+  name: ruby-debug
+  type: :runtime
+  version_requirement:
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: "0"
+    version:
+description: convert Selenium tests to ruby/rspec for running against a Grid. Performs much better translation than the Selenium IDE, and a harness for running the resulting specs.
+email: david@davelee.com.au
+executables:
+- rubidium
+extensions: []
+extra_rdoc_files:
+- LICENSE
+- README
+- README.rdoc
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README
+- README.rdoc
+- VERSION
+- bin/rubidium
+- examples/google.com/googleSuite.html
+- examples/google.com/sanityTest.html
+- init.rb
+- lib/rubidium.rb
+- lib/rubidium/converter.rb
+- lib/rubidium/spec_writer.rb
+- lib/rubidium/test_case.rb
+- lib/rubidium/test_suite.rb
+- lib/rubidium/translator.rb
+- rakefile.rb
+- rubidium.gemspec
+- spec/rubidium/google.com/sanity_test_spec.rb
+- spec/rubidium_spec.rb
+- spec/spec_helper.rb
+- templates/rakefile.rb.erb
+- templates/spec.rb.erb
+- templates/spec_helper.rb.erb
+- todo.org
+has_rdoc: true
+homepage: http://github.com/incite/rubidium
+licenses: []
+post_install_message:
+rdoc_options:
+- --charset=UTF-8
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: "0"
+  version:
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: "0"
+  version:
+requirements: []
+rubyforge_project:
+rubygems_version: 1.3.5
+signing_key:
+specification_version: 3
+summary: convert Selenium tests to ruby/rspec for running against a Grid
+test_files:
+- spec/rubidium/google.com/sanity_test_spec.rb
+- spec/rubidium_spec.rb
+- spec/spec_helper.rb