selenium-webdriver 4.0.0.alpha5 → 4.0.0.beta3

data/lib/selenium/webdriver/safari/{bridge.rb → features.rb}

@@ -20,17 +20,17 @@
 module Selenium
   module WebDriver
     module Safari
-      module Bridge
+      module Features
 
         # https://developer.apple.com/library/content/documentation/NetworkingInternetWeb/Conceptual/WebDriverEndpointDoc/Commands/Commands.html
-        COMMANDS = {
+        SAFARI_COMMANDS = {
           get_permissions: [:get, 'session/:session_id/apple/permissions'],
           set_permissions: [:post, 'session/:session_id/apple/permissions'],
           attach_debugger: [:post, 'session/:session_id/apple/attach_debugger']
         }.freeze
 
         def commands(command)
-          COMMANDS[command] || super
+          SAFARI_COMMANDS[command] || self.class::COMMANDS[command]
         end
 
         def permissions

data/lib/selenium/webdriver/safari/options.rb

@@ -26,40 +26,8 @@ module Selenium
         # @see https://developer.apple.com/documentation/webkit/about_webdriver_for_safari
         CAPABILITIES = {automatic_inspection: 'safari:automaticInspection',
                         automatic_profiling: 'safari:automaticProfiling'}.freeze
+        BROWSER = 'safari'
 
-        CAPABILITIES.each_key do |key|
-          define_method key do
-            @options[key]
-          end
-
-          define_method "#{key}=" do |value|
-            @options[key] = value
-          end
-        end
-
-        #
-        # Create a new Options instance for W3C-capable versions of Safari.
-        #
-        # @example
-        #   options = Selenium::WebDriver::Safari::Options.new(automatic_inspection: true)
-        #   driver = Selenium::WebDriver.for :safari, options: options
-        #
-        # @param [Hash] opts the pre-defined options to create the Safari::Options with
-        # @option opts [Boolean] :automatic_inspection Preloads Web Inspector and JavaScript debugger. Default is false
-        # @option opts [Boolean] :automatic_profiling Preloads Web Inspector and starts a timeline recording. Default is false
-        #
-
-        def initialize(**opts)
-          super
-        end
-
-        #
-        # @api private
-        #
-
-        def as_json(*)
-          generate_as_json(super)
-        end
       end # Options
     end # Safari
   end # WebDriver

data/lib/selenium/webdriver/support/block_event_listener.rb

@@ -25,7 +25,7 @@ module Selenium
           @callback = callback
         end
 
-        def method_missing(meth, *args) # rubocop:disable Style/MethodMissingSuper, Style/MissingRespondToMissing
+        def method_missing(meth, *args) # rubocop:disable Style/MissingRespondToMissing
           @callback.call meth, *args
         end
       end # BlockEventListener

data/lib/selenium/webdriver/support/color.rb

@@ -72,7 +72,7 @@ module Selenium
           end
         end
 
-        def self.from_hsl(h, s, l, a) # rubocop:disable Naming/UncommunicativeMethodParamName
+        def self.from_hsl(h, s, l, a) # rubocop:disable Naming/MethodParameterName
           h = Float(h) / 360
           s = Float(s) / 100
           l = Float(l) / 100
@@ -138,7 +138,7 @@ module Selenium
         end
 
         def hex
-          format '#%02x%02x%02x', red, green, blue
+          format '#%<red>02x%<green>02x%<blue>02x', red: red, green: green, blue: blue
         end
       end # Color
     end # Support

data/lib/selenium/webdriver/support/event_firing_bridge.rb

@@ -120,7 +120,7 @@ module Selenium
           returned
         end
 
-        def method_missing(meth, *args, &blk) # rubocop:disable Style/MethodMissingSuper, Style/MissingRespondToMissing
+        def method_missing(meth, *args, &blk) # rubocop:disable Style/MissingRespondToMissing
           @delegate.__send__(meth, *args, &blk)
         end
       end # EventFiringBridge

data/lib/selenium/webdriver/support/guards.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+require_relative 'guards/guard_condition'
+require_relative 'guards/guard'
+
+module Selenium
+  module WebDriver
+    module Support
+      class Guards
+        GUARD_TYPES = %i[except only exclude exclusive].freeze
+
+        attr_reader :messages
+        attr_accessor :bug_tracker
+
+        def initialize(example, bug_tracker: '', conditions: nil)
+          @example = example
+          @bug_tracker = bug_tracker
+          @guard_conditions = conditions || []
+          @guards = collect_example_guards
+          @messages = {}
+        end
+
+        def add_condition(name, condition = nil, &blk)
+          @guard_conditions << GuardCondition.new(name, condition, &blk)
+        end
+
+        def add_message(name, message)
+          @messages[name] = message
+        end
+
+        def disposition
+          if !skipping_guard.nil?
+            [:skip, skipping_guard.message]
+          elsif !pending_guard.nil? && ENV['SKIP_PENDING']
+            [:skip, pending_guard.message]
+          elsif !pending_guard.nil?
+            [:pending, pending_guard.message]
+          end
+        end
+
+        def satisfied?(guard)
+          @guard_conditions.all? { |condition| condition.satisfied?(guard) }
+        end
+
+        private
+
+        def collect_example_guards
+          guards = []
+
+          GUARD_TYPES.each do |guard_type|
+            example_group = @example.metadata[:example_group]
+            example_guards = [@example.metadata[guard_type], example_group[guard_type]]
+            while example_group[:parent_example_group]
+              example_group = example_group[:parent_example_group]
+              example_guards << example_group[guard_type]
+            end
+
+            example_guards.flatten.uniq.compact.each do |example_guard|
+              guards << Guard.new(example_guard, guard_type, self)
+            end
+          end
+
+          guards
+        end
+
+        def skipping_guard
+          @guards.select(&:exclusive?).find { |guard| !satisfied?(guard) } ||
+            @guards.select(&:exclude?).find { |guard| satisfied?(guard) }
+        end
+
+        def pending_guard
+          @guards.select(&:except?).find { |guard| satisfied?(guard) } ||
+            @guards.select(&:only?).find { |guard| !satisfied?(guard) }
+        end
+      end # Guards
+    end # Support
+  end # WebDriver
+end # Selenium

data/lib/selenium/webdriver/support/guards/guard.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+module Selenium
+  module WebDriver
+    module Support
+      class Guards
+
+        #
+        # Guard derived from RSpec example metadata.
+        # @api private
+        #
+
+        class Guard
+
+          attr_reader :guarded, :type, :messages, :reason
+
+          def initialize(guarded, type, guards = nil)
+            @guarded = guarded
+            @tracker = guards&.bug_tracker || ''
+            @messages = guards&.messages || {}
+            @messages[:unknown] = 'TODO: Investigate why this is failing and file a bug report'
+            @type = type
+
+            @reason = @guarded.delete(:reason)
+          end
+
+          def message
+            details = case @reason
+                      when Integer
+                        "Bug Filed: #{@tracker}/#{@reason}"
+                      when Symbol
+                        @messages[@reason]
+                      when String
+                        @reason
+                      else
+                        'no reason given'
+                      end
+
+            case @type
+            when :exclude
+              "Test not guarded because it breaks test run; #{details}"
+            when :exclusive
+              "Test does not apply to this configuration; #{details}"
+            else
+              "Test guarded; #{details}"
+            end
+          end
+
+          # Bug is present on all configurations specified
+          def except?
+            @type == :except
+          end
+
+          # Bug is present on all configurations not specified
+          def only?
+            @type == :only
+          end
+
+          # Bug is present on all configurations specified, but test can not be run because it breaks other tests
+          def exclude?
+            @type == :exclude
+          end
+
+          # Test only applies to configurations specified
+          def exclusive?
+            @type == :exclusive
+          end
+        end # Guard
+      end # Guards
+    end # Support
+  end # WebDriver
+end # Selenium

data/lib/selenium/webdriver/support/guards/guard_condition.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+module Selenium
+  module WebDriver
+    module Support
+      class Guards
+
+        #
+        # Guard derived from RSpec example metadata.
+        # @api private
+        #
+
+        class GuardCondition
+          attr_accessor :name, :execution
+
+          def initialize(name, condition = nil, &blk)
+            @name = name
+            @execution = if block_given?
+                           proc(&blk)
+                         else
+                           proc { |guarded| guarded.include?(condition) }
+                         end
+          end
+
+          def satisfied?(guard)
+            list = Array(guard.guarded[@name])
+
+            list.empty? || @execution.call(list)
+          end
+
+        end # GuardCondition
+      end # Guards
+    end # Support
+  end # WebDriver
+end # Selenium

data/lib/selenium/webdriver/support/select.rb

@@ -31,7 +31,7 @@ module Selenium
           raise ArgumentError, "unexpected tag name #{tag_name.inspect}" unless tag_name.casecmp('select').zero?
 
           @element = element
-          @multi = ![nil, 'false'].include?(element.attribute(:multiple))
+          @multi = ![nil, 'false'].include?(element.dom_attribute(:multiple))
         end
 
         #
@@ -258,7 +258,7 @@ module Selenium
         end
 
         def find_by_index(index)
-          options.select { |option| option.attribute(:index) == index.to_s }
+          options.select { |option| option.dom_attribute(:index) == index.to_s }
         end
 
         def find_by_value(value)

data/lib/selenium/webdriver/version.rb

@@ -19,6 +19,6 @@
 
 module Selenium
   module WebDriver
-    VERSION = '4.0.0.alpha5'
+    VERSION = '4.0.0.beta3'
   end # WebDriver
 end # Selenium

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: selenium-webdriver
 version: !ruby/object:Gem::Version
-  version: 4.0.0.alpha5
+  version: 4.0.0.beta3
 platform: ruby
 authors:
 - Alex Rodionov
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-03-18 00:00:00.000000000 Z
+date: 2021-04-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
@@ -20,7 +20,7 @@ dependencies:
         version: '0.5'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '5.0'
   name: childprocess
   prerelease: false
   type: :runtime
@@ -31,7 +31,21 @@ dependencies:
         version: '0.5'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  name: rexml
+  prerelease: false
+  type: :runtime
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
     requirements:
@@ -121,7 +135,7 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.73.0
+        version: 1.8.0
   name: rubocop
   prerelease: false
   type: :development
@@ -129,7 +143,7 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.73.0
+        version: 1.8.0
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
     requirements:
@@ -172,6 +186,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.5'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  name: webrick
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
     requirements:
@@ -186,9 +214,10 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.9.11
-description: WebDriver is a tool for writing automated tests of websites. It aims
-  to mimic the behaviour of a real user, and as such interacts with the HTML of the
-  application.
+description: |2
+      Selenium implements the W3C WebDriver protocol to automate popular browsers.
+      It aims to mimic the behaviour of a real user as it interacts with the application's HTML.
+      It's primarily intended for web application testing, but any web-based task can automated.
 email:
 - p0deje@gmail.com
 - titusfortner@gmail.com
@@ -197,20 +226,18 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- CHANGES
-- Gemfile
-- LICENSE
-- README.md
 - lib/selenium-webdriver.rb
+- lib/selenium/devtools.rb
 - lib/selenium/server.rb
 - lib/selenium/webdriver.rb
 - lib/selenium/webdriver/atoms.rb
 - lib/selenium/webdriver/atoms/findElements.js
 - lib/selenium/webdriver/atoms/getAttribute.js
 - lib/selenium/webdriver/atoms/isDisplayed.js
+- lib/selenium/webdriver/atoms/mutationListener.js
 - lib/selenium/webdriver/chrome.rb
-- lib/selenium/webdriver/chrome/bridge.rb
 - lib/selenium/webdriver/chrome/driver.rb
+- lib/selenium/webdriver/chrome/features.rb
 - lib/selenium/webdriver/chrome/options.rb
 - lib/selenium/webdriver/chrome/profile.rb
 - lib/selenium/webdriver/chrome/service.rb
@@ -220,17 +247,20 @@ files:
 - lib/selenium/webdriver/common/driver.rb
 - lib/selenium/webdriver/common/driver_extensions/downloads_files.rb
 - lib/selenium/webdriver/common/driver_extensions/has_addons.rb
+- lib/selenium/webdriver/common/driver_extensions/has_authentication.rb
 - lib/selenium/webdriver/common/driver_extensions/has_debugger.rb
 - lib/selenium/webdriver/common/driver_extensions/has_devtools.rb
 - lib/selenium/webdriver/common/driver_extensions/has_location.rb
+- lib/selenium/webdriver/common/driver_extensions/has_log_events.rb
+- lib/selenium/webdriver/common/driver_extensions/has_logs.rb
 - lib/selenium/webdriver/common/driver_extensions/has_network_conditions.rb
 - lib/selenium/webdriver/common/driver_extensions/has_network_connection.rb
+- lib/selenium/webdriver/common/driver_extensions/has_network_interception.rb
 - lib/selenium/webdriver/common/driver_extensions/has_permissions.rb
 - lib/selenium/webdriver/common/driver_extensions/has_remote_status.rb
 - lib/selenium/webdriver/common/driver_extensions/has_session_id.rb
 - lib/selenium/webdriver/common/driver_extensions/has_web_storage.rb
-- lib/selenium/webdriver/common/driver_extensions/rotatable.rb
-- lib/selenium/webdriver/common/driver_extensions/takes_screenshot.rb
+- lib/selenium/webdriver/common/driver_extensions/prints_page.rb
 - lib/selenium/webdriver/common/driver_extensions/uploads_files.rb
 - lib/selenium/webdriver/common/element.rb
 - lib/selenium/webdriver/common/error.rb
@@ -259,26 +289,30 @@ files:
 - lib/selenium/webdriver/common/proxy.rb
 - lib/selenium/webdriver/common/search_context.rb
 - lib/selenium/webdriver/common/service.rb
+- lib/selenium/webdriver/common/service_manager.rb
 - lib/selenium/webdriver/common/socket_lock.rb
 - lib/selenium/webdriver/common/socket_poller.rb
+- lib/selenium/webdriver/common/takes_screenshot.rb
 - lib/selenium/webdriver/common/target_locator.rb
 - lib/selenium/webdriver/common/timeouts.rb
 - lib/selenium/webdriver/common/wait.rb
 - lib/selenium/webdriver/common/window.rb
 - lib/selenium/webdriver/common/zipper.rb
+- lib/selenium/webdriver/devtools.rb
+- lib/selenium/webdriver/devtools/console_event.rb
+- lib/selenium/webdriver/devtools/exception_event.rb
+- lib/selenium/webdriver/devtools/mutation_event.rb
+- lib/selenium/webdriver/devtools/request.rb
 - lib/selenium/webdriver/edge.rb
-- lib/selenium/webdriver/edge_chrome/bridge.rb
-- lib/selenium/webdriver/edge_chrome/driver.rb
-- lib/selenium/webdriver/edge_chrome/options.rb
-- lib/selenium/webdriver/edge_chrome/profile.rb
-- lib/selenium/webdriver/edge_chrome/service.rb
-- lib/selenium/webdriver/edge_html/driver.rb
-- lib/selenium/webdriver/edge_html/options.rb
-- lib/selenium/webdriver/edge_html/service.rb
+- lib/selenium/webdriver/edge/driver.rb
+- lib/selenium/webdriver/edge/features.rb
+- lib/selenium/webdriver/edge/options.rb
+- lib/selenium/webdriver/edge/profile.rb
+- lib/selenium/webdriver/edge/service.rb
 - lib/selenium/webdriver/firefox.rb
-- lib/selenium/webdriver/firefox/bridge.rb
 - lib/selenium/webdriver/firefox/driver.rb
 - lib/selenium/webdriver/firefox/extension.rb
+- lib/selenium/webdriver/firefox/features.rb
 - lib/selenium/webdriver/firefox/options.rb
 - lib/selenium/webdriver/firefox/profile.rb
 - lib/selenium/webdriver/firefox/profiles_ini.rb
@@ -299,8 +333,8 @@ files:
 - lib/selenium/webdriver/remote/response.rb
 - lib/selenium/webdriver/remote/server_error.rb
 - lib/selenium/webdriver/safari.rb
-- lib/selenium/webdriver/safari/bridge.rb
 - lib/selenium/webdriver/safari/driver.rb
+- lib/selenium/webdriver/safari/features.rb
 - lib/selenium/webdriver/safari/options.rb
 - lib/selenium/webdriver/safari/service.rb
 - lib/selenium/webdriver/support.rb
@@ -309,16 +343,18 @@ files:
 - lib/selenium/webdriver/support/color.rb
 - lib/selenium/webdriver/support/escaper.rb
 - lib/selenium/webdriver/support/event_firing_bridge.rb
+- lib/selenium/webdriver/support/guards.rb
+- lib/selenium/webdriver/support/guards/guard.rb
+- lib/selenium/webdriver/support/guards/guard_condition.rb
 - lib/selenium/webdriver/support/relative_locator.rb
 - lib/selenium/webdriver/support/select.rb
 - lib/selenium/webdriver/version.rb
-- selenium-webdriver.gemspec
-homepage: https://github.com/SeleniumHQ/selenium
+homepage: https://selenium.dev
 licenses:
 - Apache-2.0
 metadata:
-  changelog_uri: https://github.com/SeleniumHQ/selenium/blob/master/rb/CHANGES
-  source_code_uri: https://github.com/SeleniumHQ/selenium/tree/master/rb
+  changelog_uri: https://github.com/SeleniumHQ/selenium/blob/trunk/rb/CHANGES
+  source_code_uri: https://github.com/SeleniumHQ/selenium/tree/trunk/rb
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -327,7 +363,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.4'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">"
@@ -338,5 +374,6 @@ rubyforge_project:
 rubygems_version: 2.7.9
 signing_key:
 specification_version: 4
-summary: The next generation developer focused tool for automated testing of webapps
+summary: Selenium is a browser automation tool for automated testing of webapps and
+  more
 test_files: []