tdiary 5.2.1 → 5.2.2

data/vendor/bundle/ruby/3.1.0/gems/selenium-webdriver-4.2.0/lib/selenium/webdriver/common/platform.rb

@@ -0,0 +1,227 @@
+# 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 'rbconfig'
+require 'socket'
+
+module Selenium
+  module WebDriver
+    # @api private
+    module Platform
+      module_function
+
+      def home
+        @home ||= Dir.home
+      end
+
+      def engine
+        @engine ||= RUBY_ENGINE.to_sym
+      end
+
+      def os
+        host_os = RbConfig::CONFIG['host_os']
+        @os ||= case host_os
+                when /mswin|msys|mingw|cygwin|bccwin|wince|emc/
+                  :windows
+                when /darwin|mac os/
+                  :macosx
+                when /linux/
+                  :linux
+                when /solaris|bsd/
+                  :unix
+                else
+                  raise Error::WebDriverError, "unknown os: #{host_os.inspect}"
+                end
+      end
+
+      def ci
+        if ENV['TRAVIS']
+          :travis
+        elsif ENV['JENKINS']
+          :jenkins
+        elsif ENV['APPVEYOR']
+          :appveyor
+        elsif ENV['GITHUB_ACTIONS']
+          :github
+        end
+      end
+
+      def bitsize
+        @bitsize ||= if defined?(FFI::Platform::ADDRESS_SIZE)
+                       FFI::Platform::ADDRESS_SIZE
+                     elsif defined?(FFI)
+                       FFI.type_size(:pointer) == 4 ? 32 : 64
+                     elsif jruby?
+                       Integer(ENV_JAVA['sun.arch.data.model'])
+                     else
+                       1.size == 4 ? 32 : 64
+                     end
+      end
+
+      def jruby?
+        engine == :jruby
+      end
+
+      def ruby_version
+        RUBY_VERSION
+      end
+
+      def windows?
+        os == :windows
+      end
+
+      def mac?
+        os == :macosx
+      end
+
+      def linux?
+        os == :linux
+      end
+
+      def wsl?
+        return false unless linux?
+
+        File.read('/proc/version').downcase.include?('microsoft')
+      rescue Errno::EACCES
+        # the file cannot be accessed on Linux on DeX
+        false
+      end
+
+      def cygwin?
+        RUBY_PLATFORM.include?('cygwin')
+        !Regexp.last_match.nil?
+      end
+
+      def null_device
+        File::NULL
+      end
+
+      def wrap_in_quotes_if_necessary(str)
+        windows? && !cygwin? ? %("#{str}") : str
+      end
+
+      def cygwin_path(path, **opts)
+        flags = []
+        opts.each { |k, v| flags << "--#{k}" if v }
+
+        `cygpath #{flags.join ' '} "#{path}"`.strip
+      end
+
+      def unix_path(path)
+        path.tr(File::ALT_SEPARATOR, File::SEPARATOR)
+      end
+
+      def windows_path(path)
+        path.tr(File::SEPARATOR, File::ALT_SEPARATOR)
+      end
+
+      def make_writable(file)
+        File.chmod 0o766, file
+      end
+
+      def assert_file(path)
+        return if File.file? path
+
+        raise Error::WebDriverError, "not a file: #{path.inspect}"
+      end
+
+      def assert_executable(path)
+        assert_file(path)
+
+        return if File.executable? path
+
+        raise Error::WebDriverError, "not executable: #{path.inspect}"
+      end
+
+      def exit_hook
+        pid = Process.pid
+
+        at_exit { yield if Process.pid == pid }
+      end
+
+      def find_binary(*binary_names)
+        paths = ENV['PATH'].split(File::PATH_SEPARATOR)
+
+        if windows?
+          binary_names.map! { |n| "#{n}.exe" }
+          binary_names.dup.each { |n| binary_names << n.gsub('exe', 'bat') }
+        end
+
+        binary_names.each do |binary_name|
+          paths.each do |path|
+            full_path = File.join(path, binary_name)
+            full_path = unix_path(full_path) if windows?
+            exe = Dir.glob(full_path).find { |f| File.executable?(f) }
+            return exe if exe
+          end
+        end
+
+        nil
+      end
+
+      def find_in_program_files(*binary_names)
+        paths = [
+          ENV.fetch('PROGRAMFILES', '\\Program Files'),
+          ENV.fetch('ProgramFiles(x86)', '\\Program Files (x86)'),
+          ENV.fetch('ProgramW6432', '\\Program Files')
+        ]
+
+        paths.each do |root|
+          binary_names.each do |name|
+            exe = File.join(root, name)
+            return exe if File.executable?(exe)
+          end
+        end
+
+        nil
+      end
+
+      def localhost
+        info = Socket.getaddrinfo 'localhost', 80, Socket::AF_INET, Socket::SOCK_STREAM
+
+        return info[0][3] unless info.empty?
+
+        raise Error::WebDriverError, "unable to translate 'localhost' for TCP + IPv4"
+      end
+
+      def ip
+        orig = Socket.do_not_reverse_lookup
+        Socket.do_not_reverse_lookup = true
+
+        begin
+          UDPSocket.open do |s|
+            s.connect '8.8.8.8', 53
+            return s.addr.last
+          end
+        ensure
+          Socket.do_not_reverse_lookup = orig
+        end
+      rescue Errno::ENETUNREACH, Errno::EHOSTUNREACH
+        # no external ip
+      end
+
+      def interfaces
+        interfaces = Socket.getaddrinfo('localhost', 8080).map { |e| e[3] }
+        interfaces += ['0.0.0.0', Platform.ip]
+
+        interfaces.compact.uniq
+      end
+    end # Platform
+  end # WebDriver
+end # Selenium

data/vendor/bundle/ruby/3.1.0/gems/selenium-webdriver-4.2.0/lib/selenium/webdriver/common/search_context.rb

@@ -0,0 +1,106 @@
+# 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 SearchContext
+      # @api private
+      FINDERS = {
+        class: 'class name',
+        class_name: 'class name',
+        css: 'css selector',
+        id: 'id',
+        link: 'link text',
+        link_text: 'link text',
+        name: 'name',
+        partial_link_text: 'partial link text',
+        relative: 'relative',
+        tag_name: 'tag name',
+        xpath: 'xpath'
+      }.freeze
+
+      #
+      # Find the first element matching the given arguments
+      #
+      # When using Element#find_element with :xpath, be aware that webdriver
+      # follows standard conventions: a search prefixed with "//" will search
+      # the entire document, not just the children of this current node. Use
+      # ".//" to limit your search to the children of the receiving Element.
+      #
+      # @overload find_element(how, what)
+      #   @param [Symbol, String] how The method to find the element by
+      #   @param [String] what The locator to use
+      # @overload find_element(opts)
+      #   @param [Hash] opts Find options
+      #   @option opts [Symbol] :how Key named after the method to find the element by, containing the locator
+      # @return [Element]
+      #
+      # @raise [Error::NoSuchElementError] if the element doesn't exist
+      #
+
+      def find_element(*args)
+        how, what = extract_args(args)
+
+        by = FINDERS[how.to_sym]
+        raise ArgumentError, "cannot find element by #{how.inspect}" unless by
+
+        bridge.find_element_by by, what, ref
+      end
+
+      #
+      # Find all elements matching the given arguments
+      #
+      # @see SearchContext#find_element
+      #
+
+      def find_elements(*args)
+        how, what = extract_args(args)
+
+        by = FINDERS[how.to_sym]
+        raise ArgumentError, "cannot find elements by #{how.inspect}" unless by
+
+        bridge.find_elements_by by, what, ref
+      end
+
+      private
+
+      def extract_args(args)
+        case args.size
+        when 2
+          args
+        when 1
+          arg = args.first
+
+          unless arg.respond_to?(:shift)
+            raise ArgumentError,
+                  "expected #{arg.inspect}:#{arg.class} to respond to #shift"
+          end
+
+          # this will be a single-entry hash, so use #shift over #first or #[]
+          arr = arg.dup.shift
+          raise ArgumentError, "expected #{arr.inspect} to have 2 elements" unless arr.size == 2
+
+          arr
+        else
+          raise ArgumentError, "wrong number of arguments (#{args.size} for 2)"
+        end
+      end
+    end # SearchContext
+  end # WebDriver
+end # Selenium

data/vendor/bundle/ruby/3.1.0/gems/selenium-webdriver-4.2.0/lib/selenium/webdriver/common/service_manager.rb

@@ -0,0 +1,150 @@
+# 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
+    #
+    # Base class implementing default behavior of service_manager object,
+    # responsible for starting and stopping driver implementations.
+    #
+    # @api private
+    #
+    class ServiceManager
+      START_TIMEOUT = 20
+      SOCKET_LOCK_TIMEOUT = 45
+      STOP_TIMEOUT = 20
+
+      #
+      # End users should use a class method for the desired driver, rather than using this directly.
+      #
+      # @api private
+      #
+
+      def initialize(config)
+        @executable_path = config.executable_path
+        @host = Platform.localhost
+        @port = config.port
+        @extra_args = config.extra_args
+        @shutdown_supported = config.shutdown_supported
+
+        raise Error::WebDriverError, "invalid port: #{@port}" if @port < 1
+      end
+
+      def start
+        raise "already started: #{uri.inspect} #{@executable_path.inspect}" if process_running?
+
+        Platform.exit_hook { stop } # make sure we don't leave the server running
+
+        socket_lock.locked do
+          find_free_port
+          start_process
+          connect_until_stable
+        end
+      end
+
+      def stop
+        return unless @shutdown_supported
+        return if process_exited?
+
+        stop_server
+        @process.poll_for_exit STOP_TIMEOUT
+      rescue ChildProcess::TimeoutError
+        nil # noop
+      ensure
+        stop_process
+      end
+
+      def uri
+        @uri ||= URI.parse("http://#{@host}:#{@port}")
+      end
+
+      private
+
+      def build_process(*command)
+        WebDriver.logger.debug("Executing Process #{command}")
+        @process = ChildProcess.build(*command)
+        if WebDriver.logger.debug?
+          @process.io.stdout = @process.io.stderr = WebDriver.logger.io
+        elsif Platform.jruby?
+          # Apparently we need to read the output of drivers on JRuby.
+          @process.io.stdout = @process.io.stderr = File.new(Platform.null_device, 'w')
+        end
+
+        @process
+      end
+
+      def connect_to_server
+        Net::HTTP.start(@host, @port) do |http|
+          http.open_timeout = STOP_TIMEOUT / 2
+          http.read_timeout = STOP_TIMEOUT / 2
+
+          yield http
+        end
+      end
+
+      def find_free_port
+        @port = PortProber.above(@port)
+      end
+
+      def start_process
+        @process = build_process(@executable_path, "--port=#{@port}", *@extra_args)
+        # NOTE: this is a bug only in Windows 7
+        @process.leader = true unless Platform.windows?
+        @process.start
+      end
+
+      def stop_process
+        return if process_exited?
+
+        @process.stop STOP_TIMEOUT
+        @process.io.stdout.close if Platform.jruby? && !WebDriver.logger.debug?
+      end
+
+      def stop_server
+        connect_to_server do |http|
+          headers = WebDriver::Remote::Http::Common::DEFAULT_HEADERS.dup
+          http.get('/shutdown', headers)
+        end
+      end
+
+      def process_running?
+        defined?(@process) && @process&.alive?
+      end
+
+      def process_exited?
+        @process.nil? || @process.exited?
+      end
+
+      def connect_until_stable
+        socket_poller = SocketPoller.new @host, @port, START_TIMEOUT
+        return if socket_poller.connected?
+
+        raise Error::WebDriverError, cannot_connect_error_text
+      end
+
+      def cannot_connect_error_text
+        "unable to connect to #{@executable_path} #{@host}:#{@port}"
+      end
+
+      def socket_lock
+        @socket_lock ||= SocketLock.new(@port - 1, SOCKET_LOCK_TIMEOUT)
+      end
+    end # Service
+  end # WebDriver
+end # Selenium

data/vendor/bundle/ruby/3.1.0/gems/selenium-webdriver-4.2.0/lib/selenium/webdriver/common/shadow_root.rb

@@ -0,0 +1,87 @@
+# 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
+    class ShadowRoot
+      ROOT_KEY = 'shadow-6066-11e4-a52e-4f735466cecf'
+
+      include SearchContext
+
+      #
+      # Creates a new shadow root
+      #
+      # @api private
+      #
+
+      def initialize(bridge, id)
+        @bridge = bridge
+        @id = id
+      end
+
+      def inspect
+        format '#<%<class>s:0x%<hash>x id=%<id>s>', class: self.class, hash: hash * 2, id: @id.inspect
+      end
+
+      def ==(other)
+        other.is_a?(self.class) && ref == other.ref
+      end
+      alias_method :eql?, :==
+
+      def hash
+        [@id, @bridge].hash
+      end
+
+      #
+      # @api private
+      # @see SearchContext
+      #
+
+      def ref
+        [:shadow_root, @id]
+      end
+
+      #
+      # Convert to a ShadowRoot JSON Object for transmission over the wire.
+      # @see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#basic-terms-and-concepts
+      #
+      # @api private
+      #
+
+      def to_json(*)
+        JSON.generate as_json
+      end
+
+      #
+      # For Rails 3 - http://jonathanjulian.com/2010/04/rails-to_json-or-as_json/
+      #
+      # @api private
+      #
+
+      def as_json(*)
+        {ROOT_KEY => @id}
+      end
+
+      private
+
+      attr_reader :bridge
+
+    end # ShadowRoot
+  end # WebDriver
+end # Selenium

data/vendor/bundle/ruby/3.1.0/gems/selenium-webdriver-4.2.0/lib/selenium/webdriver/common/socket_poller.rb

@@ -0,0 +1,126 @@
+# 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 'selenium/webdriver/common/platform'
+require 'socket'
+
+module Selenium
+  module WebDriver
+    class SocketPoller
+      def initialize(host, port, timeout = 0, interval = 0.25)
+        @host     = host
+        @port     = Integer(port)
+        @timeout  = Float(timeout)
+        @interval = interval
+      end
+
+      #
+      # Returns true if the server is listening within the given timeout,
+      # false otherwise.
+      #
+      # @return [Boolean]
+      #
+
+      def connected?
+        with_timeout { listening? }
+      end
+
+      #
+      # Returns true if the server has stopped listening within the given timeout,
+      # false otherwise.
+      #
+      # @return [Boolean]
+      #
+
+      def closed?
+        with_timeout { !listening? }
+      end
+
+      private
+
+      CONNECT_TIMEOUT = 5
+
+      NOT_CONNECTED_ERRORS = [Errno::ECONNREFUSED, Errno::ENOTCONN, SocketError].tap { |arr|
+        arr << Errno::EPERM if Platform.cygwin?
+      }.freeze
+
+      CONNECTED_ERRORS = [Errno::EISCONN].tap { |arr|
+        arr << Errno::EINVAL if Platform.windows?
+        arr << Errno::EALREADY if Platform.wsl?
+      }.freeze
+
+      if Platform.jruby?
+        # we use a plain TCPSocket here since JRuby has issues closing socket
+        # see https://github.com/jruby/jruby/issues/5709
+        def listening?
+          TCPSocket.new(@host, @port).close
+          true
+        rescue *NOT_CONNECTED_ERRORS
+          false
+        end
+      else
+        def listening?
+          addr     = Socket.getaddrinfo(@host, @port, Socket::AF_INET, Socket::SOCK_STREAM)
+          sock     = Socket.new(Socket::AF_INET, Socket::SOCK_STREAM, 0)
+          sockaddr = Socket.pack_sockaddr_in(@port, addr[0][3])
+
+          begin
+            sock.connect_nonblock sockaddr
+          rescue Errno::EINPROGRESS
+            retry if socket_writable?(sock) && conn_completed?(sock)
+            raise Errno::ECONNREFUSED
+          rescue *CONNECTED_ERRORS
+            # yay!
+          end
+
+          sock.close
+          true
+        rescue *NOT_CONNECTED_ERRORS
+          sock&.close
+          WebDriver.logger.debug("polling for socket on #{[@host, @port].inspect}")
+          false
+        end
+      end
+
+      def socket_writable?(sock)
+        sock.wait_writable(CONNECT_TIMEOUT)
+      end
+
+      def conn_completed?(sock)
+        sock.getsockopt(Socket::SOL_SOCKET, Socket::SO_ERROR).int.zero?
+      end
+
+      def with_timeout
+        max_time = current_time + @timeout
+
+        until current_time > max_time
+          return true if yield
+
+          sleep @interval
+        end
+
+        false
+      end
+
+      def current_time
+        Process.clock_gettime(Process::CLOCK_MONOTONIC)
+      end
+    end # SocketPoller
+  end # WebDriver
+end # Selenium