browserstack-webdriver 0.0.1

data/lib/selenium/webdriver/ie/server.rb

@@ -0,0 +1,86 @@
+module Selenium
+  module WebDriver
+    module IE
+      class Server
+
+        STOP_TIMEOUT = 5
+
+        def self.get
+          binary = IE.driver_path || Platform.find_binary("IEDriverServer")
+          if binary
+            new(binary)
+          else
+            raise Error::WebDriverError,
+              "Unable to find standalone executable. Please download the IEDriverServer from http://code.google.com/p/selenium/downloads/list and place the executable on your PATH."
+          end
+        end
+
+        attr_accessor :log_level, :log_file
+
+        def initialize(binary_path, opts = {})
+          Platform.assert_executable binary_path
+
+          @binary_path = binary_path
+          @process = nil
+
+          opts = opts.dup
+          @log_level   = opts.delete(:log_level)
+          @log_file    = opts.delete(:log_file)
+
+          unless opts.empty?
+            raise ArgumentError, "invalid option#{'s' if opts.size != 1}: #{opts.inspect}"
+          end
+
+        end
+
+        def start(port, timeout)
+          return @port if running?
+
+          @port = port
+
+          @process = ChildProcess.new(@binary_path, *server_args)
+          @process.io.inherit! if $DEBUG
+          @process.start
+
+          unless SocketPoller.new(Platform.localhost, @port, timeout).connected?
+            raise Error::WebDriverError, "unable to connect to IE server within #{timeout} seconds"
+          end
+
+          Platform.exit_hook { stop }
+
+          @port
+        end
+
+        def stop
+          if running?
+            @process.stop STOP_TIMEOUT
+          end
+        end
+
+        def port
+          @port
+        end
+
+        def uri
+          "http://#{Platform.localhost}:#{port}"
+        end
+
+        def running?
+          @process && @process.alive?
+        end
+
+        private
+
+        def server_args
+          args = ["--port=#{@port}"]
+
+          args << "--log-level=#{@log_level.to_s.upcase}" if @log_level
+          args << "--log-file=#{@log_file}" if @log_file
+
+          args
+        end
+
+      end
+    end
+  end
+end

data/lib/selenium/webdriver/iphone.rb

@@ -0,0 +1,9 @@
+module Selenium
+  module WebDriver
+    module IPhone
+
+    end # IPhone
+  end # WebDriver
+end # Selenium
+
+require 'selenium/webdriver/iphone/bridge'

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

@@ -0,0 +1,45 @@
+module Selenium
+  module WebDriver
+    module IPhone
+      #
+      # @api private
+      #
+
+      class Bridge < Remote::Bridge
+
+        DEFAULT_URL = "http://#{Platform.localhost}:3001/wd/hub/"
+
+        def initialize(opts = {})
+          warn 'The iPhone driver is reprecated - please use http://appium.io/ or http://ios-driver.github.io/ios-driver/ instead'
+
+          remote_opts = {
+            :url                  => opts.fetch(:url, DEFAULT_URL),
+            :desired_capabilities => opts.fetch(:desired_capabilities, capabilities),
+          }
+
+          remote_opts[:http_client] = opts[:http_client] if opts.has_key?(:http_client)
+
+          super remote_opts
+        end
+
+        def browser
+          :iphone
+        end
+
+        def driver_extensions
+          [
+            DriverExtensions::TakesScreenshot,
+            DriverExtensions::HasInputDevices,
+            DriverExtensions::HasWebStorage,
+            DriverExtensions::HasLocation
+          ]
+        end
+
+        def capabilities
+          @capabilities ||= Remote::Capabilities.iphone
+        end
+
+      end # Bridge
+    end # IPhone
+  end # WebDriver
+end # Selenium

data/lib/selenium/webdriver/opera.rb

@@ -0,0 +1,24 @@
+require 'selenium/server'
+require 'selenium/webdriver/opera/service'
+require 'selenium/webdriver/opera/bridge'
+
+module Selenium
+  module WebDriver
+
+    module Opera
+      def self.driver_path=(path)
+        Service.selenium_server_jar = path
+      end
+
+      def self.path=(path)
+        Platform.assert_executable path
+        @path = path
+      end
+
+      def self.path
+        @path ||= nil
+      end
+    end
+
+  end
+end

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

@@ -0,0 +1,112 @@
+module Selenium
+  module WebDriver
+    module Opera
+
+      #
+      # @api private
+      #
+
+      LOGGING_LEVELS = [:severe, :warning, :info, :config, :fine, :finer, :finest, :all]
+
+      class Bridge < Remote::Bridge
+
+        def initialize(opts = {})
+          @service = Service.default_service :log => (opts[:logging_level] ? true : false)
+
+          http_client = opts.delete(:http_client)
+          caps        = create_capabilities(opts)
+
+          @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::HasInputDevices,
+            DriverExtensions::TakesScreenshot
+          ]
+        end
+
+        def capabilities
+          @capabilities ||= Remote::Capabilities.opera
+        end
+
+        def quit
+          super
+        ensure
+          @service.stop
+        end
+
+      private
+
+        def create_capabilities(opts)
+          original_opts = opts.dup
+
+          arguments     = opts.delete(:arguments)
+          logging_level = opts.delete(:logging_level)
+          logging_file  = opts.delete(:logging_file)
+          host          = opts.delete(:host)
+          port          = opts.delete(:port)
+          launcher      = opts.delete(:launcher)
+          profile       = opts.delete(:profile)
+          idle          = opts.delete(:idle)
+          display       = opts.delete(:display)
+          autostart     = opts.delete(:autostart)
+          no_restart    = opts.delete(:no_restart)
+          no_quit       = opts.delete(:no_quit)
+          product       = opts.delete(:product)
+          caps          = opts.delete(:desired_capabilities) { Remote::Capabilities.opera }
+
+          unless opts.empty?
+            raise ArgumentError, "unknown option#{'s' if opts.size != 1}: #{opts.inspect}"
+          end
+
+          if arguments
+            unless arguments.kind_of? Array
+              raise ArgumentError, ':arguments must be an Array of Strings'
+            end
+
+            caps.merge! 'opera.arguments' => arguments.join(' ')
+          end
+
+          if logging_level
+            unless LOGGING_LEVELS.include?(logging_level)
+              raise ArgumentError,
+                "unknown logging level #{logging_level.inspect}, available levels: #{LOGGING_LEVELS.inspect}"
+            end
+
+            caps.merge! 'opera.logging.level' => logging_level.to_s.upcase
+          end
+
+          caps.merge! 'opera.logging.file' => logging_file if logging_file
+          caps.merge! 'opera.binary'       => Opera.path if Opera.path
+          caps.merge! 'opera.host'         => host if host
+          caps.merge! 'opera.port'         => port.to_i if port
+          caps.merge! 'opera.launcher'     => launcher if launcher
+          caps.merge! 'opera.profile'      => profile if original_opts.has_key?(:profile)
+          caps.merge! 'opera.idle'         => !!idle unless idle.nil?
+          caps.merge! 'opera.display'      => display.to_i if display
+          caps.merge! 'opera.autostart'    => !!autostart unless autostart.nil?
+          caps.merge! 'opera.no_restart'   => !!no_restart unless no_restart.nil?
+          caps.merge! 'opera.no_quit'      => !!no_quit unless no_quit.nil?
+          caps.merge! 'opera.product'      => product if product
+
+          caps
+        end
+
+      end
+    end
+  end
+end

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

@@ -0,0 +1,49 @@
+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(opts = {})
+          new selenium_server_jar, opts
+        end
+
+        def initialize(jar, opts = {})
+          opts.merge! :background => true, :port => PortProber.above(4444)
+          opts.merge! :log => !!$DEBUG if $DEBUG
+          @server = Selenium::Server.new File.expand_path(jar), opts
+        end
+
+        def uri
+          @server.webdriver_url
+        end
+
+        def start
+          @server.start
+          Platform.exit_hook { stop }  # make sure we don't leave the server running
+        end
+
+        def stop
+          @server.stop
+        end
+      end
+
+    end
+  end
+end

data/lib/selenium/webdriver/phantomjs.rb

@@ -0,0 +1,22 @@
+require 'net/http'
+
+require 'selenium/webdriver/phantomjs/service'
+require 'selenium/webdriver/phantomjs/bridge'
+
+module Selenium
+  module WebDriver
+
+    module PhantomJS
+
+      def self.path=(path)
+        Platform.assert_executable path
+        @path = path
+      end
+
+      def self.path
+        @path ||= Platform.find_binary("phantomjs")
+      end
+
+    end
+  end
+end

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

@@ -0,0 +1,59 @@
+module Selenium
+  module WebDriver
+    module PhantomJS
+
+
+      # @api private
+      class Bridge < Remote::Bridge
+
+        def initialize(opts = {})
+          http_client = opts.delete(:http_client)
+          caps        = opts.delete(:desired_capabilities) { Remote::Capabilities.phantomjs }
+
+          if opts.has_key?(:url)
+            url = opts.delete(:url)
+          else
+            args = opts.delete(:args) || caps['phantomjs.cli.args']
+            port = opts.delete(:port)
+
+            @service = Service.default_service(port)
+            @service.start(args)
+
+            url = @service.uri
+          end
+
+          remote_opts = {
+            :url                  => url,
+            :desired_capabilities => caps
+          }
+
+          remote_opts.merge!(:http_client => http_client) if http_client
+
+          super(remote_opts)
+        end
+
+        def browser
+          :phantomjs
+        end
+
+        def driver_extensions
+          [
+            DriverExtensions::TakesScreenshot,
+            DriverExtensions::HasInputDevices
+          ]
+        end
+
+        def capabilities
+          @capabilities ||= Remote::Capabilities.phantomjs
+        end
+
+        def quit
+          super
+        ensure
+          @service.stop if @service
+        end
+
+      end # Bridge
+    end # PhantomJS
+  end # WebDriver
+end # Selenium

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

@@ -0,0 +1,90 @@
+module Selenium
+  module WebDriver
+    module PhantomJS
+
+      #
+      # @api private
+      #
+
+      class Service
+        START_TIMEOUT = 20
+        STOP_TIMEOUT  = 5
+        DEFAULT_PORT  = 8910
+        MISSING_TEXT  = "Unable to find phantomjs executable."
+
+        attr_reader :uri
+
+        def self.executable_path
+          @executable_path ||= (
+            path = PhantomJS.path
+            path or raise Error::WebDriverError, MISSING_TEXT
+            Platform.assert_executable path
+
+            path
+          )
+        end
+
+        def self.default_service(port = nil)
+          new executable_path, port || PortProber.above(DEFAULT_PORT)
+        end
+
+        def initialize(executable_path, port)
+          @uri        = URI.parse "http://#{Platform.localhost}:#{port}"
+          @executable = executable_path
+        end
+
+        def start(args = [])
+          if @process && @process.alive?
+            raise "already started: #{@uri.inspect} #{@executable.inspect}"
+          end
+
+          @process = create_process(args)
+          @process.start
+
+          socket_poller = SocketPoller.new Platform.localhost, @uri.port, START_TIMEOUT
+
+          unless socket_poller.connected?
+            raise Error::WebDriverError, "unable to connect to phantomjs @ #{@uri} after #{START_TIMEOUT} seconds"
+          end
+
+          Platform.exit_hook { stop } # make sure we don't leave the server running
+        end
+
+        def stop
+          return if @process.nil? || @process.exited?
+
+          Net::HTTP.start(uri.host, uri.port) do |http|
+            http.open_timeout = STOP_TIMEOUT / 2
+            http.read_timeout = STOP_TIMEOUT / 2
+
+            http.get("/shutdown")
+          end
+
+          @process.poll_for_exit STOP_TIMEOUT
+        rescue ChildProcess::TimeoutError
+          # ok, force quit
+          @process.stop STOP_TIMEOUT
+
+          if Platform.jruby? && !$DEBUG
+            @process.io.close rescue nil
+          end
+        end
+
+        def create_process(args)
+          server_command = [@executable, "--webdriver=#{@uri.port}", *args]
+          process = ChildProcess.build(*server_command.compact)
+
+          if $DEBUG == true
+            process.io.inherit!
+          elsif Platform.jruby?
+            # apparently we need to read the output for phantomjs to work on jruby
+            process.io.stdout = process.io.stderr = File.new(Platform.null_device, 'w')
+          end
+
+          process
+        end
+
+      end # Service
+    end # PhantomJS
+  end # WebDriver
+end # Service