selenium-webdriver 0.2.2 → 2.0.0

data/CHANGES

@@ -1,4 +1,14 @@
-0.2.2 (???)
+2.0.0 (2011-07-08)
+==================
+
+* Remove deprecated methods Element#{toggle,select,drag_and_drop_*,value}.
+* Add ability to pass :verbose, :native_events to the Chrome driver.
+* Synthetic mouse implementation for Firefox - improves drag and drop support platforms without native events.
+* Added Selenium::WebDriver::Opera (requires the remote server).
+* Fix for locating Firefox on 64-bit Windows when missing from the registry.
+* Fix native events on Firefox 4, 5.
+
+0.2.2 (2011-06-22)
 ==================
 
 * Deprecate Element#{toggle,select,drag_and_drop_*}

data/lib/selenium/webdriver.rb

@@ -39,6 +39,7 @@ module Selenium
     autoload :IPhone,  'selenium/webdriver/iphone'
     autoload :Remote,  'selenium/webdriver/remote'
     autoload :Firefox, 'selenium/webdriver/firefox'
+    autoload :Opera,   'selenium/webdriver/opera'
 
     # @api private
 
@@ -49,7 +50,7 @@ module Selenium
     #
     # Create a new Driver instance with the correct bridge for the given browser
     #
-    # @param browser [:ie, :internet_explorer, :remote, :chrome, :firefox, :ff, :android, :iphone]
+    # @param browser [:ie, :internet_explorer, :remote, :chrome, :firefox, :ff, :android, :iphone, :opera]
     #   the driver type to use
     # @param *rest
     #   arguments passed to Bridge.new
@@ -62,6 +63,7 @@ module Selenium
     # @see Selenium::WebDriver::Chrome::Bridge
     # @see Selenium::WebDriver::Android::Bridge
     # @see Selenium::WebDriver::IPhone::Bridge
+    # @see Selenium::WebDriver::Opera::Bridge
     #
     # @example
     #

data/lib/selenium/webdriver/chrome/bridge.rb

@@ -6,8 +6,10 @@ module Selenium
       class Bridge < Remote::Bridge
 
         def initialize(opts = {})
-          http_client = opts.delete(:http_client)
-          switches    = opts.delete(:switches)
+          http_client   = opts.delete(:http_client)
+          switches      = opts.delete(:switches)
+          native_events = opts.delete(:native_events)
+          verbose       = opts.delete(:verbose)
 
           unless opts.empty?
             raise ArgumentError, "unknown option#{'s' if opts.size != 1}: #{opts.inspect}"
@@ -23,9 +25,9 @@ module Selenium
             caps.merge! 'chrome.switches' => switches.map { |e| e.to_s }
           end
 
-          if Chrome.path
-            caps.merge! 'chrome.binary' => Chrome.path
-          end
+          caps.merge! 'chrome.binary'       => Chrome.path if Chrome.path
+          caps.merge! 'chrome.nativeEvents' => true if native_events
+          caps.merge! 'chrome.verbose'      => true if verbose
 
           @service = Service.default_service
           @service.start

data/lib/selenium/webdriver/chrome/service.rb

@@ -9,7 +9,7 @@ module Selenium
       class Service
         START_TIMEOUT = 20
         STOP_TIMEOUT  = 5
-        MISSING_TEXT  = "Unable to find the chromedriver executable. Please download the server from http://code.google.com/p/selenium/downloads/list and place it somewhere on your PATH. More info at http://code.google.com/p/selenium/wiki/ChromeDriver."
+        MISSING_TEXT  = "Unable to find the chromedriver executable. Please download the server from http://code.google.com/p/chromium/downloads/list and place it somewhere on your PATH. More info at http://code.google.com/p/selenium/wiki/ChromeDriver."
 
         attr_reader :uri
 

data/lib/selenium/webdriver/common/driver.rb

@@ -35,6 +35,8 @@ module Selenium
                      Android::Bridge.new(*args)
                    when :iphone
                      IPhone::Bridge.new(*args)
+                   when :opera
+                     Opera::Bridge.new(*args)
                    else
                      raise ArgumentError, "unknown driver: #{browser.inspect}"
                    end

data/lib/selenium/webdriver/common/element.rb

@@ -46,17 +46,6 @@ module Selenium
         bridge.getElementTagName @id
       end
 
-      #
-      # Get the value of this element
-      #
-      # @return [String]
-      #
-
-      def value
-        warn "#{self.class}#value is deprecated, please use #{self.class}#attribute('value')"
-        bridge.getElementValue @id
-      end
-
       #
       # Get the value of a the given attribute of the element. Will return the current value, even if
       # this has been modified after the page has been loaded. More exactly, this method will return
@@ -168,28 +157,6 @@ module Selenium
         bridge.isElementDisplayed @id
       end
 
-      #
-      # Select this element
-      #
-
-      def select
-        warn "#{self.class}#select is deprecated. Please use #{self.class}#click and determine the current state with #{self.class}#selected?"
-
-        unless displayed?
-          raise Error::ElementNotDisplayedError, "you may not select an element that is not displayed"
-        end
-
-        unless enabled?
-          raise Error::InvalidElementStateError, "cannot select a disabled element"
-        end
-
-        unless selectable?
-          raise Error::InvalidElementStateError, "you may only select options, radios or checkboxes"
-        end
-
-        click unless selected?
-      end
-
       #
       # Submit this element
       #
@@ -198,15 +165,6 @@ module Selenium
         bridge.submitElement @id
       end
 
-      #
-      # Toggle this element
-      #
-
-      def toggle
-        warn "#{self.class}#toggle is deprecated. Please use #{self.class}#click and determine the current state with #{self.class}#selected?"
-        bridge.toggleElement @id
-      end
-
       #
       # Get the value of the given CSS property
       #
@@ -245,36 +203,6 @@ module Selenium
         bridge.getElementSize @id
       end
 
-      #
-      # Drag and drop this element
-      #
-      # @param [Integer] right_by
-      #   number of pixels to drag right
-      # @param [Integer] down_by
-      #   number of pixels to drag down
-      #
-
-      def drag_and_drop_by(right_by, down_by)
-        warn "#{self.class}#drag_and_drop_{by,on} is deprecated. Please use Selenium::WebDriver::Driver#action (and Selenium::WebDriver::ActionBuilder) instead."
-        bridge.dragElement @id, right_by, down_by
-      end
-
-      #
-      # Drag and drop this element on the given element
-      #
-      # @param [WebDriver::Element] other
-      #
-
-      def drag_and_drop_on(other)
-        current_location = location()
-        destination      = other.location
-
-        right = destination.x - current_location.x
-        down  = destination.y - current_location.y
-
-        drag_and_drop_by right, down
-      end
-
       #-------------------------------- sugar  --------------------------------
 
       #

data/lib/selenium/webdriver/common/platform.rb

@@ -103,10 +103,14 @@ module Selenium
         File.chmod 0766, file
       end
 
-      def assert_executable(path)
+      def assert_file(path)
         unless File.file? path
           raise Error::WebDriverError, "not a file: #{path.inspect}"
         end
+      end
+
+      def assert_executable(path)
+        assert_file(path)
 
         unless File.executable? path
           raise Error::WebDriverError, "not executable: #{path.inspect}"
@@ -131,7 +135,7 @@ module Selenium
         info = Socket.getaddrinfo "localhost", 80, Socket::AF_INET, Socket::SOCK_STREAM
 
         if info.empty?
-          raise Error::WebDriverError, "unable to translate 'localhost' for TCP+IPv6"
+          raise Error::WebDriverError, "unable to translate 'localhost' for TCP + IPv4"
         end
 
         info[0][3]

data/lib/selenium/webdriver/firefox/binary.rb

@@ -148,8 +148,10 @@ module Selenium
           end
 
           def likely_windows_path
-            path = "#{ ENV['PROGRAMFILES'] || "\\Program Files" }\\Mozilla Firefox\\firefox.exe"
-            path if File.executable?(path)
+            [
+              "#{ ENV['PROGRAMFILES'] || "\\Program Files" }\\Mozilla Firefox\\firefox.exe",
+              "#{ ENV['ProgramFiles(x86)'] || "\\Program Files (x86)" }\\Mozilla Firefox\\firefox.exe"
+            ].find { |path| File.executable?(path) }
           end
         end # class << self
 

data/lib/selenium/webdriver/opera.rb

@@ -0,0 +1,12 @@
+require 'selenium/server'
+require 'selenium/webdriver/opera/service'
+require 'selenium/webdriver/opera/bridge'
+
+module Selenium
+  module WebDriver
+
+    module Opera
+    end
+
+  end
+end

data/lib/selenium/webdriver/opera/bridge.rb

@@ -0,0 +1,54 @@
+module Selenium
+  module WebDriver
+    module Opera
+
+      #
+      # @api private
+      #
+
+      class Bridge < Remote::Bridge
+
+        def initialize(opts = {})
+          http_client = opts.delete(:http_client)
+
+          unless opts.empty?
+            raise ArgumentError, "unknown option#{'s' if opts.size != 1}: #{opts.inspect}"
+          end
+
+          caps = Remote::Capabilities.opera
+
+          @service = Service.default_service
+          @service.start
+
+          remote_opts = {
+            :url => @service.uri,
+            :desired_capabilities => caps
+          }
+
+          remote_opts.merge!(:http_client => http_client) if http_client
+
+          super(remote_opts)
+        end
+
+        def browser
+          :opera
+        end
+
+        def driver_extensions
+          [DriverExtensions::TakesScreenshot]
+        end
+
+        def capabilities
+          @capabilities ||= Remote::Capabilities.opera
+        end
+
+        def quit
+          super
+        ensure
+          @service.stop
+        end
+
+      end
+    end
+  end
+end

data/lib/selenium/webdriver/opera/service.rb

@@ -0,0 +1,48 @@
+module Selenium
+  module WebDriver
+    module Opera
+
+      #
+      # @api private
+      #
+
+      class Service
+        MISSING_TEXT = 'Unable to find the Selenium server jar.  Please download the standalone server from http://code.google.com/p/selenium/downloads/list and set the SELENIUM_SERVER_JAR environmental variable to its location.  More info at http://code.google.com/p/selenium/wiki/OperaDriver.'
+
+        def self.selenium_server_jar
+          @selenium_server_jar ||= (
+            ENV['SELENIUM_SERVER_JAR'] or raise Error::WebDriverError, MISSING_TEXT
+          )
+        end
+
+        def self.selenium_server_jar=(path)
+          Platform.assert_file path
+          @selenium_server_jar = path
+        end
+
+        def self.default_service
+          new selenium_server_jar
+        end
+
+        def initialize(jar, opts = {})
+          opts.merge! :background => true, :port => PortProber.random, :log => !!$DEBUG
+          @server = Selenium::Server.new File.expand_path(jar), opts
+        end
+
+        def uri
+          @server.webdriver_url
+        end
+
+        def start
+          @server.start
+          at_exit { stop }  # make sure we don't leave the server running
+        end
+
+        def stop
+          @server.stop
+        end
+      end
+
+    end
+  end
+end

data/lib/selenium/webdriver/remote/bridge.rb

@@ -390,10 +390,6 @@ module Selenium
           execute :submitElement, :id => element
         end
 
-        def toggleElement(element)
-          execute :toggleElement, :id => element
-        end
-
         def setElementSelected(element)
           execute :setElementSelected, :id => element
         end

data/lib/selenium/webdriver/remote/capabilities.rb

@@ -93,8 +93,10 @@ module Selenium
 
           def opera(opts = {})
             new({
-              :browser_name       => "opera",
-              :javascript_enabled => true
+              :browser_name          => "opera",
+              :javascript_enabled    => true,
+              :takes_screenshot      => true,
+              :css_selectors_enabled => true,
             }.merge(opts))
           end
 
@@ -228,4 +230,4 @@ module Selenium
       end # Capabilities
     end # Remote
   end # WebDriver
-end # Selenium
+end # Selenium

data/lib/selenium/webdriver/remote/commands.rb

@@ -46,7 +46,6 @@ class Selenium::WebDriver::Remote::Bridge
   command :clearElement,                           :post,    "session/:session_id/element/:id/clear"
   command :isElementSelected,                      :get,     "session/:session_id/element/:id/selected"
   command :setElementSelected,                     :post,    "session/:session_id/element/:id/selected"
-  command :toggleElement,                          :post,    "session/:session_id/element/:id/toggle"
   command :isElementEnabled,                       :get,     "session/:session_id/element/:id/enabled"
   command :getElementAttribute,                    :get,     "session/:session_id/element/:id/attribute/:name"
   command :elementEquals,                          :get,     "session/:session_id/element/:id/equals/:other"

data/lib/selenium/webdriver/remote/http/common.rb

@@ -7,12 +7,6 @@ module Selenium
           CONTENT_TYPE    = "application/json"
           DEFAULT_HEADERS = { "Accept" => CONTENT_TYPE }
 
-          # deprecated.
-          def self.timeout=(timeout)
-            raise Error::WebDriverError,
-              "Configuration of HTTP timeouts has changed. See http://code.google.com/p/selenium/wiki/RubyBindings for updated intructions."
-          end
-
           attr_accessor :timeout
           attr_writer :server_url
 

metadata

@@ -2,7 +2,7 @@
 name: selenium-webdriver
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.2.2
+  version: 2.0.0
 platform: ruby
 authors: 
   - Jari Bakken
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-06-22 00:00:00 +02:00
+date: 2011-07-08 00:00:00 +02:00
 default_executable: 
 dependencies: 
   - !ruby/object:Gem::Dependency 
@@ -122,6 +122,7 @@ files:
   - lib/selenium/webdriver/firefox.rb
   - lib/selenium/webdriver/ie.rb
   - lib/selenium/webdriver/iphone.rb
+  - lib/selenium/webdriver/opera.rb
   - lib/selenium/webdriver/remote.rb
   - lib/selenium/webdriver/android/bridge.rb
   - lib/selenium/webdriver/chrome/bridge.rb
@@ -168,6 +169,8 @@ files:
   - lib/selenium/webdriver/ie/native/win32/IEDriver.dll
   - lib/selenium/webdriver/ie/native/x64/IEDriver.dll
   - lib/selenium/webdriver/iphone/bridge.rb
+  - lib/selenium/webdriver/opera/bridge.rb
+  - lib/selenium/webdriver/opera/service.rb
   - lib/selenium/webdriver/remote/bridge.rb
   - lib/selenium/webdriver/remote/capabilities.rb
   - lib/selenium/webdriver/remote/commands.rb