appium_lib 9.7.5 → 9.8.1

data/lib/appium_lib/core/ios.rb

@@ -1,7 +0,0 @@
-# loaded in common/driver.rb
-require_relative 'ios/search_context'
-require_relative 'ios/device'
-require_relative 'ios/touch'
-
-require_relative 'ios/uiautomation/patch'
-require_relative 'ios/uiautomation/bridge'

data/lib/appium_lib/core/ios/device.rb

@@ -1,44 +0,0 @@
-module Appium
-  module Ios
-    module Device
-      extend Forwardable
-
-      # @!method touch_id
-      #   iOS only;  Simulate Touch ID with either valid (match == true) or invalid (match == false) fingerprint.
-      #   @param [Boolean] match fingerprint validity
-      #     Defaults to true.
-      #   ```ruby
-      #   touch_id true #=> Simulate valid fingerprint
-      #   touch_id false #=> Simulate invalid fingerprint
-      #   ```
-
-      # @!method toggle_touch_id_enrollment
-      #   iOS Simulator only:  Toggle touch id enrollment on an iOS Simulator.
-      #   @param [Boolean] enabled Enable toggle touch id enrollment. Set true by default.
-      #   ```ruby
-      #   toggle_touch_id_enrollment       #=> Enable toggle enrolled
-      #   toggle_touch_id_enrollment true  #=> Enable toggle enrolled
-      #   toggle_touch_id_enrollment false #=> Disable toggle enrolled
-      #   ```
-      # toggle_touch_id_enrollment
-      class << self
-        def extended(_mod)
-          ::Appium::Core::Device.extend_webdriver_with_forwardable
-
-          # TODO: TEST ME
-          ::Appium::Core::Device.add_endpoint_method(:touch_id) do
-            def touch_id(match = true)
-              execute :touch_id, {}, match: match
-            end
-          end
-
-          ::Appium::Core::Device.add_endpoint_method(:toggle_touch_id_enrollment) do
-            def toggle_touch_id_enrollment(enabled = true)
-              execute :toggle_touch_id_enrollment, {}, enabled: enabled
-            end
-          end
-        end
-      end
-    end # module Device
-  end # module iOS
-end # module Appium

data/lib/appium_lib/core/ios/search_context.rb

@@ -1,27 +0,0 @@
-module Appium
-  module Core
-    module Ios
-      module SearchContext
-        # @!method uiautomation_find
-        #   find_element/s can be used with a [UIAutomation command](https://developer.apple.com/library/ios/documentation/ToolsLanguages/Reference/UIAWindowClassReference/UIAWindow/UIAWindow.html#//apple_ref/doc/uid/TP40009930).
-        #
-        #   ```ruby
-        #    find_elements :uiautomation, 'elements()
-        #   ```
-        #
-        # @!method ios_predicate_string_find
-        #   find_element/s can be used with a [Predicates](https://developer.apple.com/library/content/documentation/Cocoa/Conceptual/Predicates/AdditionalChapters/Introduction.html)
-        #
-        #   ```ruby
-        #    find_elements :predicate, "isWDVisible == 1"
-        #    find_elements :predicate, 'wdName == "Buttons"'
-        #    find_elements :predicate, 'wdValue == "SearchBar" AND isWDDivisible == 1'
-        #   ```
-        def self.extend
-          ::Appium::Core::Base::SearchContext.add_finders(uiautomation: '-ios uiautomation')
-          ::Appium::Core::Base::SearchContext.add_finders(predicate: '-ios predicate string')
-        end
-      end # class << self
-    end # module Ios
-  end # module Core
-end # module Appium

data/lib/appium_lib/core/ios/touch.rb

@@ -1,16 +0,0 @@
-module Appium
-  module Core
-    module Ios
-      module Touch
-        def self.extend_touch_actions
-          ::Appium::Core::TouchAction.class_eval do
-            def swipe_coordinates(start_x: 0, start_y: 0, offset_x: 0, offset_y: 0)
-              Appium::Logger.info "start_x: #{start_x}, start_y: #{start_y}, offset_x: #{offset_x}, offset_y: #{offset_y}"
-              { offset_x: offset_x, offset_y: offset_y }
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/appium_lib/core/ios/uiautomation/bridge.rb

@@ -1,20 +0,0 @@
-require_relative '../../ios'
-
-module Appium
-  module Core
-    module Ios
-      module Uiautomation
-        module Bridge
-          def self.for(target)
-            Core::Ios::SearchContext.extend
-            target.extend Appium::Ios::Device
-
-            Core::Ios::Uiautomation.patch_webdriver_element
-
-            Core::Ios::Touch.extend_touch_actions
-          end
-        end
-      end
-    end
-  end
-end

data/lib/appium_lib/core/ios/uiautomation/patch.rb

@@ -1,20 +0,0 @@
-module Appium
-  module Core
-    module Ios
-      module Uiautomation
-        # @private
-        # class_eval inside a method because class Selenium::WebDriver::Element
-        # will trigger as soon as the file is required. in contrast a method
-        # will trigger only when invoked.
-        def self.patch_webdriver_element
-          ::Selenium::WebDriver::Element.class_eval do
-            # Cross platform way of entering text into a textfield
-            def type(text, driver = $driver)
-              driver.execute_script %(au.getElement('#{ref}').setValue('#{text}');)
-            end # def type
-          end # Selenium::WebDriver::Element.class_eval
-        end # def patch_webdriver_element
-      end # module Uiautomation
-    end # module Ios
-  end # module Core
-end # module Appium

data/lib/appium_lib/core/ios/xcuitest/bridge.rb

@@ -1,20 +0,0 @@
-require_relative '../../ios_xcuitest'
-
-module Appium
-  module Core
-    module Ios
-      module Xcuitest
-        module Bridge
-          def self.for(target)
-            Core::Ios::SearchContext.extend
-            Core::Ios::Xcuitest::SearchContext.extend
-            target.extend Appium::Ios::Device
-            target.extend Appium::Ios::Xcuitest::Device
-
-            Core::Ios::Touch.extend_touch_actions
-          end
-        end
-      end
-    end
-  end
-end

data/lib/appium_lib/core/ios/xcuitest/device.rb

@@ -1,59 +0,0 @@
-module Appium
-  module Ios
-    module Xcuitest
-      module Device
-        extend Forwardable
-
-        # @!method hide_keyboard
-        #   Hide the onscreen keyboard
-        #   @param [String] close_key The name of the key which closes the keyboard.
-        #   @param [Symbol] strategy The symbol of the strategy which closes the keyboard.
-        #     XCUITest ignore this argument.
-        #     Default for iOS is `:pressKey`. Default for Android is `:tapOutside`.
-        #  ```ruby
-        #  hide_keyboard # Close a keyboard with the 'Done' button
-        #  hide_keyboard('Finished') # Close a keyboard with the 'Finished' button
-        #  ```
-
-        # @!method background_app
-        #  Backgrounds the app for a set number of seconds.
-        #  This is a blocking application
-        # @param [Integer] seconds How many seconds to background the app for.
-        #
-        #   ```ruby
-        #   background_app
-        #   background_app(5)
-        #   background_app(-1) #=> the app never come back. https://github.com/appium/appium/issues/7741
-        #   ```
-
-        class << self
-          def extended(_mod)
-            ::Appium::Core::Device.extend_webdriver_with_forwardable
-
-            # Override
-            ::Appium::Core::Device.add_endpoint_method(:hide_keyboard) do
-              def hide_keyboard(close_key = nil, strategy = nil)
-                option = {}
-
-                option[:key] = close_key if close_key
-                option[:strategy] = strategy if strategy
-
-                execute :hide_keyboard, {}, option
-              end
-            end
-
-            # Override
-            ::Appium::Core::Device.add_endpoint_method(:background_app) do
-              def background_app(duration = 0)
-                # https://github.com/appium/ruby_lib/issues/500, https://github.com/appium/appium/issues/7741
-                # `execute :background_app, {}, seconds: { timeout: duration_milli_sec }` works over Appium 1.6.4
-                duration_milli_sec = duration.nil? ? nil : duration * 1000
-                execute :background_app, {}, seconds: { timeout: duration_milli_sec }
-              end
-            end
-          end
-        end # class << self
-      end # module Device
-    end # module Xcuitest
-  end # module Ios
-end # module Appium

data/lib/appium_lib/core/ios/xcuitest/search_context.rb

@@ -1,40 +0,0 @@
-module Appium
-  module Core
-    module Ios
-      module Xcuitest
-        module SearchContext
-          # @!method ios_class_chain_find
-          #   Only for XCUITest(WebDriverAgent)
-          #   find_element/s can be used with a [class chain]( https://github.com/facebook/WebDriverAgent/wiki/Queries)
-          #
-          # @example
-          #
-          #   # select the third child button of the first child window element
-          #   find_elements :class_chain, 'XCUIElementTypeWindow/XCUIElementTypeButton[3]'
-          #
-          #   # select all the children windows
-          #   find_elements :class_chain, 'XCUIElementTypeWindow'
-          #
-          #   # select the second last child of the second child window
-          #   find_elements :class_chain, 'XCUIElementTypeWindow[2]/XCUIElementTypeAny[-2]'
-          #
-          #   # matching predicate. <code>`</code> is the mark.
-          #   find_elements :class_chain, 'XCUIElementTypeWindow[`visible = 1][`name = \"bla\"`]'
-          #
-          #   # containing predicate. `$` is the mark.
-          #   # Require appium-xcuitest-driver 2.54.0+
-          #   # PR: https://github.com/facebook/WebDriverAgent/pull/707/files
-          #   find_elements :class_chain, 'XCUIElementTypeWindow[$name = \"bla$$$bla\"$]'
-          #   e = find_element :class_chain, "**/XCUIElementTypeWindow[$name == 'Buttons'$]"
-          #   e.tag_name #=> "XCUIElementTypeWindow"
-          #   e = find_element :class_chain, "**/XCUIElementTypeStaticText[$name == 'Buttons'$]"
-          #   e.tag_name #=> "XCUIElementTypeStaticText"
-          #
-          def self.extend
-            ::Appium::Core::Base::SearchContext.add_finders(class_chain: '-ios class chain')
-          end
-        end
-      end # class << self
-    end # module Ios
-  end # module Core
-end # module Appium

data/lib/appium_lib/core/ios_xcuitest.rb

@@ -1,8 +0,0 @@
-# loaded in common/driver.rb
-require_relative 'ios/search_context'
-require_relative 'ios/device'
-require_relative 'ios/touch'
-
-require_relative 'ios/xcuitest/search_context'
-require_relative 'ios/xcuitest/device'
-require_relative 'ios/xcuitest/bridge'

data/lib/appium_lib/core/patch.rb

@@ -1,56 +0,0 @@
-require_relative '../version'
-
-module Appium
-  module Core
-    # Implement useful features for element.
-    class Selenium::WebDriver::Element # rubocop:disable Style/ClassAndModuleChildren
-      # Note: For testing .text should be used over value, and name.
-
-      # Returns the value attribute
-      #
-      # Fixes NoMethodError: undefined method `value' for Selenium::WebDriver::Element
-      def value
-        attribute :value
-      end
-
-      # Returns the name attribute
-      #
-      # Fixes NoMethodError: undefined method `name' for Selenium::WebDriver::Element
-      def name
-        attribute :name
-      end
-
-      # Enable access to iOS accessibility label
-      # accessibility identifier is supported as 'name'
-      def label
-        attribute :label
-      end
-
-      # Alias for type
-      alias type send_keys
-
-      # For use with mobile tap.
-      #
-      # ```ruby
-      # execute_script 'mobile: tap', :x => 0.0, :y => 0.98
-      # ```
-      #
-      # @return [OpenStruct] the relative x, y in a struct. ex: { x: 0.50, y: 0.20 }
-      def location_rel(driver = $driver)
-        rect   = self.rect
-        location_x = rect.x.to_f
-        location_y = rect.y.to_f
-
-        size_width  = rect.width.to_f
-        size_height = rect.height.to_f
-
-        center_x = location_x + (size_width / 2.0)
-        center_y = location_y + (size_height / 2.0)
-
-        w = driver.window_size
-        OpenStruct.new(x: "#{center_x} / #{w.width.to_f}",
-                       y: "#{center_y} / #{w.height.to_f}")
-      end
-    end
-  end # module Core
-end # module Appium