ayanko-watir-webdriver 0.1.1.1

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,5 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg

data/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "spec/watirspec"]
+	path = spec/watirspec
+	url = git://github.com/jarib/watirspec.git

data/Gemfile

@@ -0,0 +1,4 @@
+source :rubygems
+
+gem "jeweler"
+gemspec

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009-2010 Jari Bakken
+
+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.rdoc

@@ -0,0 +1,55 @@
+= watir-webdriver
+
+Watir implementation built on WebDriver's Ruby bindings.
+See http://rubyforge.org/pipermail/wtr-development/2009-October/001313.html.
+
+= API docs
+
+http://jarib.github.com/watir-webdriver/doc/
+
+= Example
+
+  require 'watir-webdriver'
+
+  browser = Watir::Browser.new :firefox
+  browser.goto "http://google.com"
+  browser.text_field(:name => 'q').set("WebDriver rocks!")
+  browser.button(:name => 'btnG').click
+  puts browser.url
+  browser.close
+
+= Description
+
+The file in lib/watir/elements/generated.rb is autogenerated from the HTML5 spec. This is done by extracting the IDL parts from the spec and processing them with the WebIDL gem (link below).
+
+= Specs
+
+watir-webdriver uses the watir2 branch of watirspec for testing. After cloning, you should fetch the submodule:
+
+  git submodule init && git submodule update
+
+Specs specific to watir-webdriver are found in spec/*_spec.rb, with watirspec in spec/watirspec.
+
+= See also
+
+* http://github.com/jarib/webidl
+* http://github.com/jarib/watirspec/tree/watir2
+* http://selenium.googlecode.com
+
+= Dependencies
+
+* selenium-webdriver
+
+== 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-2010 Jari Bakken. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,139 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name        = "watir-webdriver"
+    gem.summary     = %Q{Watir on WebDriver}
+    gem.description = %Q{WebDriver-backed Watir}
+    gem.email       = "jari.bakken@gmail.com"
+    gem.homepage    = "http://github.com/jarib/watir-webdriver"
+    gem.authors     = ["Jari Bakken"]
+
+    gem.add_dependency "selenium-webdriver", '0.0.29'
+
+    gem.add_development_dependency "rspec", "~> 2.0.0"
+    gem.add_development_dependency "yard", "~> 0.6"
+    gem.add_development_dependency "webidl", ">= 0.0.6"
+    gem.add_development_dependency "sinatra", "~> 1.0"
+    gem.add_development_dependency "nokogiri"
+    gem.add_development_dependency "activesupport", "~> 2.3.5" # for pluralization during code generation
+  end
+
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.ruby_opts = "-I lib:spec"
+  spec.pattern   = 'spec/**/*_spec.rb'
+end
+
+namespace :spec do
+  RSpec::Core::RakeTask.new(:rcov) do |spec|
+    spec.ruby_opts = "-I lib:spec"
+    spec.pattern   = 'spec/**/*_spec.rb'
+    spec.rcov      = true
+    spec.rcov_opts = %w[--exclude spec,ruby-debug,/Library/Ruby,.gem --include lib/watir-webdriver]
+  end
+
+  desc 'Run specs for CI'
+  RSpec::Core::RakeTask.new(:ci) do |spec|
+    spec.ruby_opts  = "-I lib:spec"
+    spec.pattern    = 'spec/**/*_spec.rb'
+    spec.rspec_opts = ["--format", "html:results/#{RUBY_PLATFORM}/#{ENV['WATIR_WEBDRIVER_BROWSER'] || 'firefox'}/spec-results.html",
+                      "--format", "progress",
+                      "--backtrace"]
+    spec.rcov       = true
+    spec.rcov_opts  = %w[--exclude spec,ruby-debug,/Library/Ruby,.gem --include lib/watir-webdriver]
+  end
+end
+
+task :spec => :check_dependencies
+
+task :lib do
+  $LOAD_PATH.unshift(File.expand_path("lib", File.dirname(__FILE__)))
+end
+
+namespace :html5 do
+  SPEC_URI  = "http://www.whatwg.org/specs/web-apps/current-work/"
+  SPEC_PATH = "support/html5.html"
+
+  task :html_lib => :lib do
+    require 'watir-webdriver/html'
+  end
+
+  desc "Download the HTML5 spec from #{SPEC_URI}"
+  task :download do
+    require "open-uri"
+    mv SPEC_PATH, "#{SPEC_PATH}.old" if File.exist?(SPEC_PATH)
+    downloaded_bytes = 0
+
+    File.open(SPEC_PATH, "w") do |io|
+      io << "<!--  downloaded from #{SPEC_URI} on #{Time.now} -->\n"
+      io << data = open(SPEC_URI).read
+      downloaded_bytes = data.bytesize
+    end
+
+    puts "#{SPEC_URI} => #{SPEC_PATH} (#{downloaded_bytes} bytes)"
+  end
+
+  desc "Print IDL parts from #{SPEC_URI}"
+  task :print => :html_lib do
+    extractor = Watir::HTML::SpecExtractor.new(SPEC_PATH)
+
+    extractor.process.each do |tag_name, interface_definitions|
+      puts "#{tag_name.ljust(10)} => #{interface_definitions.map { |e| e.name }}"
+    end
+
+    extractor.print_hierarchy
+
+    unless extractor.errors.empty?
+      puts "\n\n<======================= ERRORS =======================>\n\n"
+      puts extractor.errors.join("\n" + "="*80 + "\n")
+    end
+  end
+
+  desc 'Re-enerate the base Watir element classes from the spec '
+  task :generate => :html_lib do
+    old_file = "lib/watir-webdriver/elements/generated.rb"
+    generator = Watir::HTML::Generator.new
+
+    File.open("#{old_file}.new", "w") do |file|
+      generator.generate(SPEC_PATH, file)
+    end
+
+    if File.exist?(old_file)
+      system "diff -Naut #{old_file} #{old_file}.new | less"
+    end
+  end
+
+  desc 'Move generated.rb.new to generated.rb'
+  task :overwrite do
+    file = "lib/watir-webdriver/elements/generated.rb"
+    mv "#{file}.new", file
+  end
+
+  desc 'download spec -> generate -> generated.rb'
+  task :update => [:download, :generate, :overwrite]
+end # html5
+
+task :default => :spec
+
+begin
+  require 'yard'
+  Rake::Task[:lib].invoke
+  require "yard/handlers/watir"
+  YARD::Rake::YardocTask.new do |task|
+    task.options = %w[--debug] # this is pretty slow, so nice with some output
+  end
+rescue LoadError
+  task :yard do
+    abort "YARD is not available. In order to run yardoc, you must: sudo gem install yard"
+  end
+end
+
+load "spec/watirspec/watirspec.rake" if File.exist?("spec/watirspec/watirspec.rake")

data/VERSION

@@ -0,0 +1 @@
+0.1.1

data/lib/watir-webdriver.rb

@@ -0,0 +1,71 @@
+# encoding: utf-8
+require "selenium-webdriver"
+require "json"
+
+require "watir-webdriver/core_ext/string"
+require "watir-webdriver/exception"
+require "watir-webdriver/xpath_support"
+require "watir-webdriver/window_switching"
+require "watir-webdriver/container"
+require "watir-webdriver/locators/element_locator"
+require "watir-webdriver/locators/button_locator"
+require "watir-webdriver/locators/text_field_locator"
+require "watir-webdriver/locators/child_row_locator"
+require "watir-webdriver/locators/child_cell_locator"
+require "watir-webdriver/browser"
+
+module Watir
+  include Selenium
+
+  class << self
+    def tag_to_class
+      @tag_to_class ||= {}
+    end
+
+    def element_class_for(tag_name)
+      tag_to_class[tag_name.to_sym] || HTMLElement
+    end
+  end
+
+end
+
+require "watir-webdriver/attribute_helper"
+require "watir-webdriver/row_container"
+require "watir-webdriver/cell_container"
+require "watir-webdriver/element_collection"
+require "watir-webdriver/elements/element"
+require "watir-webdriver/elements/generated"
+require "watir-webdriver/elements/frame"
+require "watir-webdriver/elements/input"
+require "watir-webdriver/elements/button"
+require "watir-webdriver/elements/checkbox"
+require "watir-webdriver/elements/file_field"
+require "watir-webdriver/elements/image"
+require "watir-webdriver/elements/link"
+require "watir-webdriver/elements/font"
+require "watir-webdriver/elements/radio"
+require "watir-webdriver/elements/text_field"
+require "watir-webdriver/elements/hidden"
+require "watir-webdriver/elements/select"
+require "watir-webdriver/elements/form"
+require "watir-webdriver/elements/option"
+require "watir-webdriver/elements/table"
+require "watir-webdriver/elements/table_row"
+require "watir-webdriver/elements/table_cell"
+require "watir-webdriver/elements/table_section"
+
+Watir.tag_to_class.freeze
+
+module Watir
+  module Container
+
+  end # Container
+end # Watir
+
+
+# undefine deprecated methods to use them for Element attributes
+class Object
+  undef_method :id if method_defined? "id"
+  undef_method :type if method_defined? "type"
+end
+

data/lib/watir-webdriver/attribute_helper.rb

@@ -0,0 +1,128 @@
+module Watir
+
+  #
+  # @private
+  #
+  # Extended by Element, provides methods for defining attributes on the element classes.
+  #
+
+  module AttributeHelper
+
+    IGNORED_ATTRIBUTES = [:text, :hash]
+
+    def typed_attributes
+      @typed_attributes ||= Hash.new { |hash, type| hash[type] = []  }
+    end
+
+    def attribute_list
+      @attribute_list ||= (
+        list = typed_attributes.values.flatten
+        list += ancestors[1..-1].map do |e|
+          e.attribute_list if e.respond_to?(:attribute_list)
+        end.compact.flatten
+      ).uniq
+    end
+
+    def attributes(attribute_map = nil)
+      attribute_map or return attribute_list
+
+      add_attributes attribute_map
+
+      attribute_map.each do |type, attribs|
+        attribs.each do |name|
+          # we don't want to override methods like :text or :hash
+          next if IGNORED_ATTRIBUTES.include?(name)
+          define_attribute(type, name)
+        end
+      end
+    end
+
+    private
+
+    def define_attribute(type, name)
+      method_name    = method_name_for(type, name)
+      attribute_name = attribute_for_method(name)
+
+      (@attributes ||= []) << attribute_name
+
+      case type
+      when :string
+        define_string_attribute(method_name, attribute_name)
+      when :bool
+        define_boolean_attribute(method_name, attribute_name)
+      when :int
+        define_int_attribute(method_name, attribute_name)
+      else
+        # $stderr.puts "treating #{type.inspect} as string for now"
+      end
+    end
+
+    def define_string_attribute(mname, aname)
+      define_method mname do
+        assert_exists
+        @element.attribute(aname).to_s
+      end
+    end
+
+    def define_boolean_attribute(mname, aname)
+      define_method mname do
+        assert_exists
+        @element.attribute(aname) == "true"
+      end
+    end
+
+    def define_int_attribute(mname, aname)
+      define_method mname do
+        assert_exists
+        value = @element.attribute(aname)
+        value && Integer(value)
+      end
+    end
+
+    def add_attributes(attributes)
+      attributes.each do |type, attr_list|
+        typed_attributes[type] += attr_list
+      end
+    end
+
+    def method_name_for(type, attribute)
+      # http://github.com/jarib/watir-webdriver/issues/issue/26
+      name = case attribute
+             when :html_for
+               'for'
+             when :col_span
+               'colspan'
+             when :row_span
+               'rowspan'
+             else
+               attribute.to_s
+             end
+
+      name << "?" if type == :bool
+
+      name
+    end
+
+    def attribute_for_method(method)
+      # http://github.com/jarib/watir-webdriver/issues/issue/26
+
+      case method.to_sym
+      when :class_name
+        'class'
+      when :html_for
+        'for'
+      when :read_only
+        'readonly'
+      when :http_equiv
+        'http-equiv'
+      when :col_span
+        'colspan'
+      when :row_span
+        'rowspan'
+      else
+        method.to_s
+      end
+    end
+
+  end # AttributeHelper
+end # Watir

data/lib/watir-webdriver/browser.rb

@@ -0,0 +1,164 @@
+# encoding: utf-8
+module Watir
+
+  #
+  # The main class through which you control the browser.
+  #
+
+  class Browser
+    include Container
+    include WindowSwitching
+
+    attr_reader :driver
+    alias_method :wd, :driver # ensures duck typing with Watir::Element
+
+    class << self
+      def start(url, browser = :firefox)
+        b = new(browser)
+        b.goto url
+
+        b
+      end
+    end
+
+    #
+    # Create a Watir::Browser instance
+    #
+    # @param [:firefox, :ie, :chrome, :remote, Selenium::WebDriver] browser
+    # @param args Passed to the underlying driver
+    #
+
+    def initialize(browser = :firefox, *args)
+      case browser
+      when Symbol, String
+        @driver = Selenium::WebDriver.for browser.to_sym, *args
+      when Selenium::WebDriver::Driver
+        @driver = browser
+      else
+        raise ArgumentError, "expected Symbol or Selenium::WebDriver::Driver, got #{browser.class}"
+      end
+
+      @error_checkers = []
+      @current_frame  = nil
+      @closed         = false
+    end
+
+    def inspect
+      '#<%s:0x%x url=%s title=%s>' % [self.class, hash*2, url.inspect, title.inspect]
+    end
+
+    #
+    # Goto the given URL
+    #
+    # @param [String] uri The url.
+    # @return [String] The url you end up at.
+    #
+
+    def goto(uri)
+      uri = "http://#{uri}" unless uri.include?("://")
+
+      @driver.navigate.to uri
+      run_checkers
+
+      url
+    end
+
+    def back
+      @driver.navigate.back
+    end
+
+    def forward
+      @driver.navigate.forward
+    end
+
+    def url
+      @driver.current_url
+    end
+
+    def title
+      @driver.title
+    end
+
+    def close
+      return if @closed
+      @driver.quit
+      @closed = true
+    end
+    alias_method :quit, :close # TODO: close vs quit
+
+    def clear_cookies
+      @driver.manage.delete_all_cookies
+    end
+
+    def text
+      @driver.find_element(:tag_name, "body").text
+    end
+
+    def html
+      # use body.html instead?
+      @driver.page_source
+    end
+
+    def refresh
+      @driver.navigate.refresh
+      run_checkers
+    end
+
+    def status
+      execute_script "return window.status;"
+    end
+
+    def execute_script(script, *args)
+      args.map! { |e| e.kind_of?(Watir::Element) ? e.element : e }
+      returned = @driver.execute_script(script, *args)
+
+      if returned.kind_of? WebDriver::Element
+        Watir.element_class_for(returned.tag_name).new(self, :element => returned)
+      else
+        returned
+      end
+    end
+
+    def add_checker(checker = nil, &block)
+      if block_given?
+        @error_checkers << block
+      elsif Proc === checker
+        @error_checkers << checker
+      else
+        raise ArgumentError, "argument must be a Proc or block"
+      end
+    end
+
+    def disable_checker(checker)
+      @error_checkers.delete(checker)
+    end
+
+    def run_checkers
+      @error_checkers.each { |e| e[self] }
+    end
+
+    #
+    # Protocol shared with Watir::Element
+    #
+    # @api private
+    #
+
+    def assert_exists
+      if @closed
+        raise Error, "browser was closed"
+      else
+        driver.switch_to.default_content
+        true
+      end
+    end
+
+    def exist?
+      not @closed
+    end
+
+    def browser
+      self
+    end
+
+  end # Browser
+end # Watir