safariwatir 0.3.3 → 0.3.7

data/README.rdoc

@@ -0,0 +1,50 @@
+"There's something eerily tingly about seeing a browser run by itself."
+http://twitter.com/swombat/status/1280692921
+
+= SafariWatir
+
+* http://github.com/redsquirrel/safariwatir
+* http://safariwatir.rubyforge.org
+* http://rubyforge.org/mailman/listinfo/safariwatir-general
+* http://twitter.com/SafariWatir
+
+== DESCRIPTION:
+
+We are putting Watir on Safari.
+The original Watir (Web Application Testing in Ruby) project supports only IE on Windows.
+This project aims at adding Watir support for Safari on the Mac.
+
+== Requirements
+
+Mac OS X running Safari. Some features require you to turn on "Enable access for assistive devices" in System Preferences > Universal Access.
+
+
+== SYNOPSIS:
+
+  require 'rubygems'
+  require 'safariwatir'
+
+  browser = Watir::Safari.new
+  browser.goto("http://google.com")
+  browser.text_field(:name, "q").set("obtiva")
+  browser.button(:name, "btnI").click
+  puts "FAILURE" unless browser.contains_text("software")
+
+== INSTALL:
+
+  [sudo] gem install safariwatir
+
+ or
+
+  git clone git://github.com/redsquirrel/safariwatir.git
+  cd safariwatir
+  rake install
+
+== RUNNING SAFARIWATIR AGAINST WATIR'S CORE TESTS
+
+  # First, install the SafariWatir gem (see above)
+  svn checkout https://svn.openqa.org/svn/watir/trunk
+  cd trunk/watir
+  cp unittests/options.yml.example unittests/options.yml
+  # Edit unittests/options.yml and set browser: safari
+  ruby unittests/core_tests.rb

data/Rakefile

@@ -0,0 +1,13 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new('safariwatir', '0.3.5') do | config |
+  config.summary = %q{Automated testing tool for web applications.}
+  config.description = %q{WATIR stands for "Web Application Testing in Ruby".  See WATIR project for more information.  This is a Safari-version of the original IE-only WATIR.}
+  config.url = 'http://safariwatir.rubyforge.org/'
+  config.author = 'Dave Hoover'
+  config.email = 'dave@obtiva.com'
+  config.ignore_pattern = ['tmp/*', 'script/*']
+  config.development_dependencies = ["rb-appscript"]
+end

data/{safariwatir.rb → lib/safariwatir.rb}

@@ -35,8 +35,8 @@ module Watir
     
     def speed=(how_fast)
       case how_fast
-      when :fast : set_fast_speed
-      when :slow : set_slow_speed
+      when :fast then set_fast_speed
+      when :slow then set_slow_speed
       else
         raise ArgumentError, "Invalid speed: #{how_fast}"
       end
@@ -119,6 +119,10 @@ module Watir
         self.class.name.split("::").last
       end
 
+      def attr name
+        @scripter.get_attribute(name, self)
+      end
+
       def operate(&block)
         scripter_suffix = OPERATIONS[how]
         if scripter_suffix.kind_of? Hash
@@ -132,14 +136,19 @@ module Watir
 
       OPERATIONS = {
         :id => "by_id",
+        :alt => "by_alt",
+        :action => "by_action",
         :index => "by_index",
         :class => "by_class",
         :name => "by_name",
-        :text => { "Link" => "on_link", "Label" => "by_text" },
+        :text => { "Link" => "on_link",
+                   "Label" => "by_text",
+                   "Span"  => "by_text" },
         :url => "on_link",
         :value => "by_input_value",
         :caption => "by_input_value",
         :src => "by_src",
+        :xpath => "by_xpath",
       }
     end
 
@@ -159,6 +168,10 @@ module Watir
       def speak
         @scripter.speak_value_of(self)
       end
+      
+      def enabled?
+        !@scripter.element_disabled?(self)
+      end
 
       def tag; "INPUT"; end
 
@@ -214,6 +227,10 @@ module Watir
     class Div < ContentElement
       def tag; "DIV"; end
     end
+    
+    class P < ContentElement
+      def tag; "P"; end
+    end
 
     class Label < ContentElement
       def tag; "LABEL"; end
@@ -226,6 +243,12 @@ module Watir
         end
       end
 
+      def click_jquery
+        @scripter.highlight(self) do
+          click_link_jquery
+        end
+      end
+
       def tag; "A"; end
     end
 
@@ -399,6 +422,13 @@ module Watir
     class Password < TextField
     end
 
+    class Ul < ContentElement
+      def tag; "UL"; end
+    end
+    
+    class Li < ContentElement
+      def tag; "LI"; end
+    end
 
     # Elements
     
@@ -417,6 +447,10 @@ module Watir
     def div(how, what)
       Div.new(scripter, how, what)
     end
+    
+    def p(how, what)
+      P.new(scripter, how, what)
+    end
 
     def form(how, what)
       Form.new(scripter, how, what)
@@ -433,6 +467,10 @@ module Watir
     def label(how, what)
       Label.new(scripter, how, what)
     end
+
+    def li(how, what)
+      Li.new(scripter, how, what)
+    end
     
     def link(how, what)
       Link.new(scripter, how, what)
@@ -465,12 +503,16 @@ module Watir
     def text_field(how, what)
       TextField.new(scripter, how, what)
     end
+
+    def ul(how, what)
+      Ul.new(scripter, how, what)
+    end
     
     def contains_text(what)
       case what
-      when Regexp:
+      when Regexp
         text =~ what
-      when String:
+      when String
         text.index(what)
       else
         raise MissingWayOfFindingObjectException
@@ -489,11 +531,21 @@ module Watir
     end
     
     def initialize
-      @scripter = AppleScripter.new
+      @scripter = AppleScripter.new(JavaScripter.new)
       @scripter.ensure_window_ready
       set_slow_speed
     end
     
+    # URL of page
+    def url
+      scripter.url
+    end
+    
+    # Hide's Safari
+    def hide
+      scripter.hide
+    end
+    
     def close
       scripter.close
     end
@@ -501,7 +553,7 @@ module Watir
     def quit
       scripter.quit
     end
-
+    
     def alert
       AlertWindow.new(scripter)
     end
@@ -517,5 +569,21 @@ module Watir
     def goto(url)
       scripter.navigate_to(url)
     end
+    
+    # Reloads the page
+    def reload
+      scripter.reload
+    end
+    alias :refresh :reload
   end # class Safari
+
+  
+  class WebKit < Safari
+    def initialize
+      @scripter = AppleScripter.new(JavaScripter.new, :appname => "WebKit")
+      @scripter.ensure_window_ready
+      set_slow_speed
+    end
+  end # class WebKit
+    
 end

data/{safariwatir → lib/safariwatir}/scripter.rb

@@ -2,7 +2,7 @@ require File.dirname(__FILE__) + '/core_ext'
 require File.dirname(__FILE__) + '/../watir/exceptions'
 require 'appscript'
 
-module Watir
+module Watir # :nodoc:
   ELEMENT_NOT_FOUND = "__safari_watir_element_unfound__"
   FRAME_NOT_FOUND = "__safari_watir_frame_unfound__"
   NO_RESPONSE = "__safari_watir_no_response__"
@@ -16,7 +16,7 @@ function dispatchOnChange(element) {
   element.dispatchEvent(event);
 }|
 
-  class JavaScripter    
+  class JavaScripter # :nodoc:
     def operate(locator, operation)
 %|#{locator}
 if (element) {
@@ -45,13 +45,13 @@ if (element) {
 
       finder = 
       case cell.row.how
-      when :id:
+      when :id
         %|getElementById('#{cell.row.what}')|
-      when :index:
+      when :index
         case cell.row.table.how
         when :id
           %|getElementById('#{cell.row.table.what}').rows[#{cell.row.what-1}]|
-        when :index:
+        when :index
           %|getElementsByTagName('TABLE')[#{cell.row.table.what-1}].rows[#{cell.row.what-1}]|
         else
           raise MissingWayOfFindingObjectException, "Table element does not support #{cell.row.table.how}"
@@ -64,7 +64,7 @@ if (element) {
     end
   end
 
-  class FrameJavaScripter < JavaScripter
+  class FrameJavaScripter < JavaScripter # :nodoc:
     def initialize(frame)
       @page_container = "parent.#{frame.name}"
     end
@@ -77,7 +77,7 @@ if (element) {
     end
   end
 
-  class TableJavaScripter < JavaScripter
+  class TableJavaScripter < JavaScripter # :nodoc:
     def_init :cell
     
     def wrap(script)
@@ -86,7 +86,7 @@ if (element) {
     end
   end
   
-  class AppleScripter
+  class AppleScripter # :nodoc:
     include Watir::Exception
     
     attr_reader :js
@@ -95,9 +95,10 @@ if (element) {
     
     TIMEOUT = 10
 
-    def initialize(scripter = JavaScripter.new)
+    def initialize(scripter = JavaScripter.new, opts={})
       @js = scripter
-      @app = Appscript.app("Safari")
+      @appname = opts[:appname] || "Safari"
+      @app = Appscript.app(@appname)
       @document = @app.documents[1]
     end
               
@@ -106,7 +107,23 @@ if (element) {
       @app.make(:new => :document) if @app.documents.get.size == 0
       @document = @app.documents[1]
     end
-
+    
+    def url
+        @document.URL.get
+    end
+    
+    def hide
+      # because applescript is stupid and annoying you have
+      # to get all the processes from System Events, grab
+      # the right one for this instance and then set visible
+      # of it to false.
+      se = Appscript.app("System Events")
+      safari = se.processes.get.select do |app|
+        app.name.get == @appname
+      end.first
+      safari.visible.set(false)
+    end
+    
     def close
       @app.quit
     end
@@ -116,6 +133,10 @@ if (element) {
         @document.URL.set(url)
       end
     end
+    
+    def reload
+      execute(%|window.location.reload()|)
+    end
 
     def get_text_for(element = @element)
       execute(element.operate { %|return element.innerText| }, element)
@@ -136,6 +157,11 @@ if (element == undefined) {
     def get_value_for(element = @element)
       execute(element.operate { %|return element.value;| }, element)
     end
+
+    def get_attribute(name, element = @element)
+      execute(element.operate { %|return element.getAttribute('#{name}')| }, element)
+    end
+    
       
     def document_text
       execute(%|return document.getElementsByTagName('BODY').item(0).innerText;|)
@@ -181,7 +207,7 @@ element.style.backgroundColor = 'yellow';|
     def select_option(element = @element)
       execute(element.operate do
 %|var selected = -1;
-var previous_selection = 0;
+var previous_selection = -2;
 for (var i = 0; i < element.options.length; i++) {
   if (element.options[i].selected) {
     previous_selection = i;
@@ -307,13 +333,23 @@ if (element.onclick) {
       end
     end
 
+    def click_link_jquery(element = @element)      
+      click = %/
+$(element).trigger('click');
+/
+      page_load do
+        execute(js.operate(find_link(element), click))
+      end
+    end
+
     def operate_on_link(element)
       js.operate(find_link(element), yield)
     end
 
+    # This needs to take XPath into account now?
     def find_link(element)
       case element.how
-      when :index:
+      when :index
 %|var element = document.getElementsByTagName('A')[#{element.what-1}];|
       else
 %|var element = undefined;
@@ -330,9 +366,9 @@ for (var i = 0; i < document.links.length; i++) {
     def handle_match(element, how = nil)
       how = {:text => "text", :url => "href"}[element.how] unless how
       case element.what
-        when Regexp:
+        when Regexp
           %|#{how}.match(/#{element.what.source}/#{element.what.casefold? ? "i":nil})|          
-        when String:
+        when String
           %|#{how} == '#{element.what}'|
         else
           raise RuntimeError, "Unable to locate #{element.name} with #{element.how}"
@@ -344,6 +380,10 @@ for (var i = 0; i < document.links.length; i++) {
     def checkbox_is_checked?(element = @element)
       execute(element.operate { %|return element.checked;| }, element)
     end
+    
+    def element_disabled?(element = @element)      
+      execute(element.operate { %|return element.disabled;| }, element)
+    end
   
     def operate_by_input_value(element)
       js.operate(%|
@@ -399,10 +439,25 @@ var element = elements[0];|, yield)
       operate_by(element, 'src', &block)
     end
 
+    def operate_by_alt(element, &block)
+      operate_by(element, 'alt', &block)
+    end
+
+    def operate_by_action(element, &block)
+      operate_by(element, 'action', &block)
+    end
+
     def operate_by_text(element, &block)
       operate_by(element, 'innerText', &block)
     end
 
+    def operate_by_xpath(element)
+      js.operate(%|
+var result = document.evaluate('#{element.what}', document.documentElement, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null);
+var element = result ? result.singleNodeValue : null;
+|, yield)
+    end
+
     def operate_by(element, attribute)
       js.operate(%|var elements = document.getElementsByTagName('#{element.tag}');
 var element = undefined;
@@ -490,13 +545,13 @@ SCRIPT`
     def execute(script, element = nil)
       response = eval_js(script)
       case response
-        when NO_RESPONSE:
+        when NO_RESPONSE
           nil
-        when ELEMENT_NOT_FOUND:
+        when ELEMENT_NOT_FOUND
           raise UnknownObjectException, "Unable to locate #{element.name} element with #{element.how} of #{element.what}" 
-        when TABLE_CELL_NOT_FOUND:
+        when TABLE_CELL_NOT_FOUND
           raise UnknownCellException, "Unable to locate a table cell with #{element.how} of #{element.what}"
-        when FRAME_NOT_FOUND:
+        when FRAME_NOT_FOUND
           raise UnknownFrameException, "Unable to locate a frame with name #{element.name}" 
         else
           response
@@ -561,4 +616,4 @@ return "#{no_redirect_flag}"|)
       @app.do_JavaScript(js.wrap(script), :in => @document)      
     end
   end # class AppleScripter
-end
+end

data/safariwatir.gemspec

@@ -0,0 +1,31 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{safariwatir}
+  s.version = "0.3.7"
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Dave Hoover", "Tom Copeland"]
+  s.date = %q{2009-10-20}
+  s.description = %q{WATIR stands for "Web Application Testing in Ruby".  See WATIR project for more information.  This is a Safari-version of the original IE-only WATIR.}
+  s.email = %q{dave@obtiva.com}
+  s.extra_rdoc_files = ["lib/safariwatir/core_ext.rb", "lib/safariwatir/scripter.rb", "lib/safariwatir.rb", "lib/watir/exceptions.rb", "README.rdoc"]
+  s.files = ["lib/safariwatir/core_ext.rb", "lib/safariwatir/scripter.rb", "lib/safariwatir.rb", "lib/watir/exceptions.rb", "Rakefile", "README.rdoc", "safariwatir.gemspec", "safariwatir_example.rb"]
+  s.has_rdoc = true
+  s.homepage = %q{http://safariwatir.rubyforge.org/}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Safariwatir", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{safariwatir}
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{Automated testing tool for web applications.}
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rb-appscript>, [">= 0"])
+    else
+      s.add_dependency(%q<rb-appscript>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rb-appscript>, [">= 0"])
+  end
+end

metadata

@@ -1,19 +1,21 @@
 --- !ruby/object:Gem::Specification 
 name: safariwatir
 version: !ruby/object:Gem::Version 
-  version: 0.3.3
+  version: 0.3.7
 platform: ruby
 authors: 
 - Dave Hoover
+- Tom Copeland
 autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2008-10-31 00:00:00 -05:00
+date: 2009-10-20 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: rb-appscript
+  type: :development
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
@@ -27,21 +29,35 @@ executables: []
 
 extensions: []
 
-extra_rdoc_files: []
-
+extra_rdoc_files: 
+- lib/safariwatir/core_ext.rb
+- lib/safariwatir/scripter.rb
+- lib/safariwatir.rb
+- lib/watir/exceptions.rb
+- README.rdoc
 files: 
-- safariwatir.rb
-- safariwatir_script.rb
-- safariwatir/core_ext.rb
-- safariwatir/scripter.rb
-- watir/exceptions.rb
+- lib/safariwatir/core_ext.rb
+- lib/safariwatir/scripter.rb
+- lib/safariwatir.rb
+- lib/watir/exceptions.rb
+- Rakefile
+- README.rdoc
+- safariwatir.gemspec
+- safariwatir_example.rb
 has_rdoc: true
 homepage: http://safariwatir.rubyforge.org/
-post_install_message: 
-rdoc_options: []
+licenses: []
 
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Safariwatir
+- --main
+- README.rdoc
 require_paths: 
-- .
+- lib
 required_ruby_version: !ruby/object:Gem::Requirement 
   requirements: 
   - - ">="
@@ -52,13 +68,12 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      version: "0"
+      version: "1.2"
   version: 
-requirements: 
-- Mac OS X running Safari
-- Some features require you to turn on "Enable access for assistive devices" in System Preferences > Universal Access
+requirements: []
+
 rubyforge_project: safariwatir
-rubygems_version: 1.1.1
+rubygems_version: 1.3.4
 signing_key: 
 specification_version: 2
 summary: Automated testing tool for web applications.