appium_lib_core 1.8.4 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: dcdd560eba95515aba5c80f8fb3970002dafb55d
-  data.tar.gz: 30b34aea4b1ca749039eb25af1f28b1fa95120a9
+  metadata.gz: e54e7cdd9d8e4b055e6163dc93a84773e7485fa1
+  data.tar.gz: dd1e4c1c37c7f16dabf8a9efd1bdf98b0382f20a
 SHA512:
-  metadata.gz: be9a5b0f0a10c636f172cbf94f91e6a22ff96fe02401a531f669c0ce4b9491b2af39f9a06659c514412b52df6610f1f0c58af99b771b88585cfd4c713593e5c8
-  data.tar.gz: afc331fbdeaeaf0f6c3b8e364dfc76eb969e7f38bc050eb8c250e47e87cfa969e031c5ba4d602761a0d6d356e3bab80c33c26e2ce79fc64f962733199d4fafd2
+  metadata.gz: aec282e234f4055fac207057889bb7cfbcd2d3eb3852c50a5b7cb17ed0b8ed78764d28639620d6ff4683446bfe3597597394397e141b6ba5747806e5411bd9af
+  data.tar.gz: 63b10b77c865e4399e617c794f725edd23d559b8f03dfb9377057fef66543efcd83a21073a3951d61410d5f4178747f35f3cec816a58c1df48ffc0e366c2ff72

data/CHANGELOG.md

@@ -8,6 +8,18 @@ All notable changes to this project will be documented in this file.
 
 ### Deprecations
 
+## [1.9.0] - 2018-08-05
+### Enhancements
+- Update documentation about `start_recording_screen`
+- Port `send_keys/type` for active element [#122](https://github.com/appium/ruby_lib_core/pull/122)
+- Support `find_element/s :image, partial_image` [#119](https://github.com/appium/ruby_lib_core/pull/119)
+- Requires `selenium-webdriver 3.14+` because of W3C actions [#115](https://github.com/appium/ruby_lib_core/pull/115)
+
+### Bug fixes
+
+### Deprecations
+- [Internal] Deprecate experimental `ImageElement` in favor of `Element`
+
 ## [1.8.4] - 2018-07-28
 ### Enhancements
 - silence warning for pointeractions [#113](https://github.com/appium/ruby_lib_core/pull/113)

data/appium_lib_core.gemspec

@@ -22,7 +22,7 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_runtime_dependency 'selenium-webdriver', '~> 3.5', '< 3.14'
+  spec.add_runtime_dependency 'selenium-webdriver', '~> 3.14'
   spec.add_runtime_dependency 'faye-websocket', '~> 0.10.0'
 
   spec.add_development_dependency 'bundler', '~> 1.14'

data/lib/appium_lib_core/android.rb

@@ -1,4 +1,3 @@
 # loaded in common/driver.rb
-require_relative 'android/search_context'
 require_relative 'android/device'
 require_relative 'android/uiautomator1/bridge'

data/lib/appium_lib_core/android/device.rb

@@ -202,6 +202,11 @@ module Appium
         #                             use a size supported by your device's Advanced Video Coding (AVC) encoder.
         #                             For example, "1280x720"
         # @param [String] time_limit: Recording time. 180 seconds is by default.
+        #                             Since Appium 1.8.2 the time limit can be up to 1800 seconds (30 minutes).
+        #                             Appium will automatically try to merge the 3-minutes chunks recorded
+        #                             by the screenrecord utility, however, this requires FFMPEG utility
+        #                             to be installed and available in PATH on the server machine. If the utility is not
+        #                             present then the most recent screen recording chunk is going to be returned as the result.
         # @param [String] bit_rate: The video bit rate for the video, in megabits per second.
         #                           4 Mbp/s(4000000) is by default for Android API level below 27. 20 Mb/s(20000000) for API level 27 and above.
         # @param [Boolean] bug_report: Set it to `true` in order to display additional information on the video overlay,

data/lib/appium_lib_core/android/espresso/bridge.rb

@@ -5,7 +5,6 @@ module Appium
         module Bridge
           def self.for(target)
             target.extend Appium::Core::Android::Device
-            Core::Android::SearchContext.extend
           end
         end
       end

data/lib/appium_lib_core/android/uiautomator1/bridge.rb

@@ -5,7 +5,6 @@ module Appium
         module Bridge
           def self.for(target)
             target.extend Appium::Core::Android::Device
-            Core::Android::SearchContext.extend
           end
         end
       end

data/lib/appium_lib_core/android/uiautomator2/bridge.rb

@@ -5,7 +5,6 @@ module Appium
         module Bridge
           def self.for(target)
             target.extend Appium::Core::Android::Device
-            Core::Android::SearchContext.extend
             target.extend Appium::Core::Android::Uiautomator2::Device
           end
         end

data/lib/appium_lib_core/android_espresso.rb

@@ -1,4 +1,3 @@
 # loaded in common/driver.rb
-require_relative 'android/search_context'
 require_relative 'android/device'
 require_relative 'android/espresso/bridge'

data/lib/appium_lib_core/android_uiautomator2.rb

@@ -1,5 +1,4 @@
 # loaded in common/driver.rb
-require_relative 'android/search_context'
 require_relative 'android/device'
 
 require_relative 'android/uiautomator2/bridge'

data/lib/appium_lib_core/common/base/bridge/mjsonwp.rb

@@ -22,70 +22,6 @@ module Appium
             ::Appium::Core::Commands::MJSONWP::COMMANDS[command]
           end
 
-          #
-          # @return [::Appium::Core::ImageElement|nil]
-          # @raise [::Selenium::WebDriver::Error::TimeOutError|::Selenium::WebDriver::Error::WebDriverError]
-          #
-          def find_element_by_image(full_image:, partial_image:, match_threshold: nil, visualize: false)
-            options = {}
-            options[:threshold] = match_threshold unless match_threshold.nil?
-            options[:visualize] = visualize
-
-            params = {}
-            params[:mode] = :matchTemplate
-            params[:firstImage] = full_image
-            params[:secondImage] = partial_image
-            params[:options] = options if options
-
-            result = execute(:compare_images, {}, params)
-            rect = result['rect']
-
-            if rect
-              return ::Appium::Core::ImageElement.new(self,
-                                                      rect['x'],
-                                                      rect['y'],
-                                                      rect['width'],
-                                                      rect['height'],
-                                                      result['visualization'])
-            end
-            nil
-          end
-
-          #
-          # @return [[]|[::Appium::Core::ImageElement]]
-          # @raise [::Selenium::WebDriver::Error::TimeOutError|::Selenium::WebDriver::Error::WebDriverError]
-          #
-          def find_elements_by_image(full_image:, partial_images:, match_threshold: nil, visualize: false)
-            options = {}
-            options[:threshold] = match_threshold unless match_threshold.nil?
-            options[:visualize] = visualize
-
-            params = {}
-            params[:mode] = :matchTemplate
-            params[:firstImage] = full_image
-            params[:options] = options if options
-
-            partial_images.each_with_object([]) do |partial_image, acc|
-              params[:secondImage] = partial_image
-
-              begin
-                result = execute(:compare_images, {}, params)
-                rect = result['rect']
-
-                if result['rect']
-                  acc.push ::Appium::Core::ImageElement.new(self,
-                                                            rect['x'],
-                                                            rect['y'],
-                                                            rect['width'],
-                                                            rect['height'],
-                                                            result['visualization'])
-                end
-              rescue ::Selenium::WebDriver::Error::WebDriverError => e
-                acc if e.message.include?('Cannot find any occurrences')
-              end
-            end
-          end
-
           def take_element_screenshot(element)
             execute :take_element_screenshot, id: element.ref
           end

data/lib/appium_lib_core/common/base/bridge/w3c.rb

@@ -1,18 +1,8 @@
-require 'base64'
-
 module Appium
   module Core
     class Base
       class Bridge
         class W3C < ::Selenium::WebDriver::Remote::W3C::Bridge
-          def self.silence_warnings_redefining(&block)
-            warn_level = $VERBOSE
-            $VERBOSE = nil
-            result = block.call
-            $VERBOSE = warn_level
-            result
-          end
-
           include Device::DeviceLock
           include Device::Keyboard
           include Device::ImeActions
@@ -28,10 +18,6 @@ module Appium
           include Device::Device
           include Device::TouchActions
 
-          # Used for default duration of each touch actions
-          # Override from 250 milliseconds to 50 milliseconds
-          W3C.silence_warnings_redefining { ::Selenium::WebDriver::PointerActions::DEFAULT_MOVE_DURATION = 0.05 }
-
           def commands(command)
             ::Appium::Core::Commands::W3C::COMMANDS[command]
           end
@@ -50,9 +36,13 @@ module Appium
           #     element = @driver.find_element(:id, "some id")
           #     @driver.action.click(element).perform # The `click` is a part of `PointerActions`
           #
-          #     # You can change the kind as the below.
-          #     @driver.action(kind: :mouse).click(element).perform # The `click` is a part of `PointerActions`
-          #
+          def action(async = false)
+            # Used for default duration of each touch actions
+            # Override from 250 milliseconds to 50 milliseconds
+            action_builder = super
+            action_builder.default_move_duration = 0.05
+            action_builder
+          end
 
           # Port from MJSONWP
           def get_timeouts
@@ -64,6 +54,12 @@ module Appium
             ::Selenium::WebDriver::Remote::W3C::Capabilities.json_create execute(:get_capabilities)
           end
 
+          # Port from MJSONWP
+          def send_keys_to_active_element(key)
+            text = ::Selenium::WebDriver::Keys.encode(key).join('')
+            execute :send_keys_to_active_element, {}, { value: text.split(//) }
+          end
+
           # For Appium
           # override
           def page_source
@@ -109,70 +105,6 @@ module Appium
             ids.map { |id| ::Selenium::WebDriver::Element.new self, element_id_from(id) }
           end
 
-          #
-          # @return [::Appium::Core::ImageElement|nil]
-          # @raise [::Selenium::WebDriver::Error::TimeOutError|::Selenium::WebDriver::Error::WebDriverError]
-          #
-          def find_element_by_image(full_image:, partial_image:, match_threshold: nil, visualize: false)
-            options = {}
-            options[:threshold] = match_threshold unless match_threshold.nil?
-            options[:visualize] = visualize
-
-            params = {}
-            params[:mode] = :matchTemplate
-            params[:firstImage] = full_image
-            params[:secondImage] = partial_image
-            params[:options] = options if options
-
-            result = execute(:compare_images, {}, params)
-            rect = result['rect']
-
-            if rect
-              return ::Appium::Core::ImageElement.new(self,
-                                                      rect['x'],
-                                                      rect['y'],
-                                                      rect['width'],
-                                                      rect['height'],
-                                                      result['visualization'])
-            end
-            nil
-          end
-
-          #
-          # @return [[]|[::Appium::Core::ImageElement]]
-          # @raise [::Selenium::WebDriver::Error::TimeOutError|::Selenium::WebDriver::Error::WebDriverError]
-          #
-          def find_elements_by_image(full_image:, partial_images:, match_threshold: nil, visualize: false)
-            options = {}
-            options[:threshold] = match_threshold unless match_threshold.nil?
-            options[:visualize] = visualize
-
-            params = {}
-            params[:mode] = :matchTemplate
-            params[:firstImage] = full_image
-            params[:options] = options if options
-
-            partial_images.each_with_object([]) do |partial_image, acc|
-              params[:secondImage] = partial_image
-
-              begin
-                result = execute(:compare_images, {}, params)
-                rect = result['rect']
-
-                if result['rect']
-                  acc.push ::Appium::Core::ImageElement.new(self,
-                                                            rect['x'],
-                                                            rect['y'],
-                                                            rect['width'],
-                                                            rect['height'],
-                                                            result['visualization'])
-                end
-              rescue ::Selenium::WebDriver::Error::WebDriverError => e
-                acc if e.message.include?('Cannot find any occurrences')
-              end
-            end
-          end
-
           # For Appium
           # override
           # called in `extend DriverExtensions::HasNetworkConnection`

data/lib/appium_lib_core/common/base/driver.rb

@@ -99,6 +99,18 @@ module Appium
           @bridge.is_keyboard_shown
         end
 
+        # Send keys for a current active element
+        # @param [String] key Input text
+        #
+        # @example
+        #
+        #   @driver.send_keys 'happy testing!'
+        #
+        def send_keys(*key)
+          @bridge.send_keys_to_active_element(key)
+        end
+        alias type send_keys
+
         # Get appium Settings for current test session
         #
         # @example
@@ -786,73 +798,47 @@ module Appium
           @bridge.compare_images(mode: mode, first_image: first_image, second_image: second_image, options: options)
         end
 
-        # Return ImageElement if current view has a partial image
+        # @since Appium 1.8.2
+        # Return an element if current view has a partial image. The logic depends on template matching by OpenCV.
+        # @see https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/image-comparison.md
+        # You can handle settings for the comparision following below.
+        # @see https://github.com/appium/appium-base-driver/blob/master/lib/basedriver/device-settings.js#L6
         #
         # @param [String] png_img_path A path to a partial image you'd like to find
-        # @param [Flood] match_threshold At what normalized threshold to reject
-        # @param [Bool] visualize Makes the endpoint to return an image, which contains the visualized result of
-        #                         the corresponding picture matching operation. This option is disabled by default.
         #
-        # @return [::Appium::Core::ImageElement]
-        # @raise [::Appium::Core::Error::NoSuchElementError|::Appium::Core::Error::CoreError] No such element
+        # @return [::Selenium::WebDriver::Element]
         #
         # @example
         #
+        #     @@driver.update_settings({ fixImageFindScreenshotDims: false, fixImageTemplateSize: true,
+        #                                autoUpdateImageElementPosition: true })
         #     e = @@driver.find_element_by_image './test/functional/data/test_element_image.png'
         #
-        def find_element_by_image(png_img_path, match_threshold: DEFAULT_MATCH_THRESHOLD, visualize: false)
-          full_image = @bridge.screenshot
-          partial_image = Base64.encode64 File.read(png_img_path)
-
-          element = begin
-            @bridge.find_element_by_image(full_image: full_image,
-                                          partial_image: partial_image,
-                                          match_threshold: match_threshold,
-                                          visualize: visualize)
-          rescue Selenium::WebDriver::Error::TimeOutError
-            raise ::Appium::Core::Error::NoSuchElementError
-          rescue ::Selenium::WebDriver::Error::WebDriverError => e
-            raise ::Appium::Core::Error::NoSuchElementError if e.message.include?('Cannot find any occurrences')
-            raise ::Appium::Core::Error::CoreError, e.message
-          end
-          raise ::Appium::Core::Error::NoSuchElementError if element.nil?
-
-          element
+        def find_element_by_image(png_img_path)
+          template = Base64.encode64 File.read png_img_path
+          find_element :image, template
         end
 
-        # Return ImageElement if current view has partial images
+        # @since Appium 1.8.2
+        # Return elements if current view has a partial image. The logic depends on template matching by OpenCV.
+        # @see https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/image-comparison.md
+        # You can handle settings for the comparision following below.
+        # @see https://github.com/appium/appium-base-driver/blob/master/lib/basedriver/device-settings.js#L6
         #
-        # @param [[String]] png_img_paths Paths to a partial image you'd like to find
-        # @param [Flood] match_threshold At what normalized threshold to reject
-        # @param [Bool] visualize Makes the endpoint to return an image, which contains the visualized result of
-        #                         the corresponding picture matching operation. This option is disabled by default.
+        # @param [String] png_img_path A path to a partial image you'd like to find
         #
-        # @return [[::Appium::Core::ImageElement]]
-        # @return [::Appium::Core::Error::CoreError]
+        # @return [::Selenium::WebDriver::Element]
         #
         # @example
         #
+        #     @@driver.update_settings({ fixImageFindScreenshotDims: false, fixImageTemplateSize: true,
+        #                                autoUpdateImageElementPosition: true })
         #     e = @@driver.find_elements_by_image ['./test/functional/data/test_element_image.png']
         #     e == [] # if the `e` is empty
         #
-        def find_elements_by_image(png_img_paths, match_threshold: DEFAULT_MATCH_THRESHOLD, visualize: false)
-          full_image = @bridge.screenshot
-
-          partial_images = png_img_paths.map do |png_img_path|
-            Base64.encode64 File.read(png_img_path)
-          end
-
-          begin
-            @bridge.find_elements_by_image(full_image: full_image,
-                                           partial_images: partial_images,
-                                           match_threshold: match_threshold,
-                                           visualize: visualize)
-          rescue Selenium::WebDriver::Error::TimeOutError
-            []
-          rescue ::Selenium::WebDriver::Error::WebDriverError => e
-            return [] if e.message.include?('Cannot find any occurrences')
-            raise ::Appium::Core::Error::CoreError, e.message
-          end
+        def find_elements_by_image(png_img_path)
+          template = Base64.encode64 File.read png_img_path
+          find_elements :image, template
         end
       end # class Driver
     end # class Base

data/lib/appium_lib_core/common/base/search_context.rb

@@ -4,28 +4,85 @@ module Appium
       module SearchContext
         # referenced: ::Selenium::WebDriver::SearchContext
 
-        FINDERS = ::Selenium::WebDriver::SearchContext::FINDERS.merge(accessibility_id: 'accessibility id')
-
-        def self.add_finders(finders)
-          FINDERS.merge!(finders)
-        end
+        FINDERS = ::Selenium::WebDriver::SearchContext::FINDERS.merge(
+          accessibility_id: 'accessibility id',
+          image: '-image',
+          # Android
+          uiautomator: '-android uiautomator',
+          # iOS
+          uiautomation: '-ios uiautomation',
+          predicate: '-ios predicate string',
+          class_chain: '-ios class chain',
+          # Windows
+          windows_uiautomation: '-windows uiautomation',
+          # Tizen
+          tizen_uiautomation: '-tizen uiautomation'
+        )
 
         #
         # Find the first element matching the given arguments
         #
+        # Android can find with uiautomator like a [UISelector](http://developer.android.com/tools/help/uiautomator/UiSelector.html).
+        # iOS can find with a [UIAutomation command](https://developer.apple.com/library/ios/documentation/ToolsLanguages/Reference/UIAWindowClassReference/UIAWindow/UIAWindow.html#//apple_ref/doc/uid/TP40009930).
+        # iOS, only for XCUITest(WebDriverAgent), can find with a [class chain]( https://github.com/facebook/WebDriverAgent/wiki/Queries)
+        #
+        # Find with image.
+        # Return an element if current view has a partial image. The logic depends on template matching by OpenCV.
+        # @see https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/image-comparison.md
+        # You can handle settings for the comparision following below.
+        # @see https://github.com/appium/appium-base-driver/blob/master/lib/basedriver/device-settings.js#L6
+        #
         # @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
         #
-        # @example Find element with accessibility id
-        #    find_elements :accessibility_id, 'Animation'
-        #    find_elements :accessibility_id, 'Animation'
+        # @example Find element with each keys
+        #
+        #     # with accessibility id. All platforms.
+        #     find_elements :accessibility_id, 'Animation'
+        #     find_elements :accessibility_id, 'Animation'
+        #
+        #     # with base64 encoded template image. All platforms.
+        #     find_elements :image, Base64.encode64(File.read(file_path))
+        #
+        #     # For Android
+        #     ## With uiautomator
+        #     find_elements :uiautomator, 'new UiSelector().clickable(true)'
+        #
+        #     # For iOS
+        #     ## With :predicate
+        #     find_elements :predicate, "isWDVisible == 1"
+        #     find_elements :predicate, 'wdName == "Buttons"'
+        #     find_elements :predicate, 'wdValue == "SearchBar" AND isWDDivisible == 1'
+        #
+        #     ## With Class Chain
+        #     ### 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"
+        #
+        #     # For Windows
+        #     find_elements :windows_uiautomation, '....'
+        #
+        #     # For Tizen
+        #     find_elements :tizen_uiautomation, '....'
         #
         def find_element(*args)
           how, what = extract_args(args)
@@ -55,8 +112,7 @@ module Appium
         private
 
         def _set_by_from_finders(how)
-          finders = FINDERS
-          by = finders[how.to_sym]
+          by = FINDERS[how.to_sym]
           raise ArgumentError, "cannot find element by #{how.inspect}" unless by
           by
         end

data/lib/appium_lib_core/common/command/w3c.rb

@@ -9,10 +9,6 @@ module Appium
             status:                    [:get, 'status'.freeze],
             is_element_displayed:      [:get, 'session/:session_id/element/:id/displayed'.freeze],
 
-            # FIXME: remove after apply https://github.com/SeleniumHQ/selenium/pull/5249
-            # The fix will be included in selenium-3.8.2
-            get_page_source:           [:get, 'session/:session_id/source'.freeze],
-
             get_timeouts:              [:get, 'session/:session_id/timeouts'.freeze],
 
             ## Add OSS commands to W3C commands. We can remove them if we would like to remove them from W3C module.
@@ -33,6 +29,8 @@ module Appium
             ime_deactivate:            [:post, 'session/:session_id/ime/deactivate'.freeze],
             ime_activate_engine:       [:post, 'session/:session_id/ime/activate'.freeze],
 
+            send_keys_to_active_element: [:post, 'session/:session_id/keys'.freeze],
+
             ### Logs
             get_available_log_types:   [:get, 'session/:session_id/log/types'.freeze],
             get_log:                   [:post, 'session/:session_id/log'.freeze]

data/lib/appium_lib_core/device.rb

@@ -1,7 +1,3 @@
-require_relative 'element/image'
-
-require 'base64'
-
 module Appium
   module Core
     module Device

data/lib/appium_lib_core/ios.rb

@@ -1,5 +1,4 @@
 # loaded in common/driver.rb
-require_relative 'ios/search_context'
 require_relative 'ios/device'
 
 require_relative 'ios/uiautomation/patch'

data/lib/appium_lib_core/ios/uiautomation/bridge.rb

@@ -4,7 +4,6 @@ module Appium
       module Uiautomation
         module Bridge
           def self.for(target)
-            Core::Ios::SearchContext.extend
             target.extend Appium::Core::Ios::Device
 
             Core::Ios::Uiautomation.patch_webdriver_element

data/lib/appium_lib_core/ios/xcuitest/bridge.rb

@@ -4,8 +4,6 @@ module Appium
       module Xcuitest
         module Bridge
           def self.for(target)
-            Core::Ios::SearchContext.extend
-            Core::Ios::Xcuitest::SearchContext.extend
             target.extend Appium::Core::Ios::Device
             target.extend Appium::Core::Ios::Xcuitest::Device
           end

data/lib/appium_lib_core/ios_xcuitest.rb

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

data/lib/appium_lib_core/version.rb

@@ -1,6 +1,6 @@
 module Appium
   module Core
-    VERSION = '1.8.4'.freeze unless defined? ::Appium::Core::VERSION
-    DATE    = '2018-07-28'.freeze unless defined? ::Appium::Core::DATE
+    VERSION = '1.9.0'.freeze unless defined? ::Appium::Core::VERSION
+    DATE    = '2018-08-05'.freeze unless defined? ::Appium::Core::DATE
   end
 end

data/release_notes.md

@@ -1,3 +1,13 @@
+#### v1.9.0 2018-08-05
+
+- [cc9e378](https://github.com/appium/ruby_lib_core/commit/cc9e378eba22eb448feec764d6227aff1647aaba) Release 1.9.0
+- [7b44bf7](https://github.com/appium/ruby_lib_core/commit/7b44bf70bba97532daabb9b496bbe36618d77593) use default_move_duration (#115)
+- [590e798](https://github.com/appium/ruby_lib_core/commit/590e7981f924524ba40b9d918b41af22cf14cc59) Add image strategy (#119)
+- [24d2a62](https://github.com/appium/ruby_lib_core/commit/24d2a6265bc351e6e2ca3d410c597ad9b744c072) port send keys for an active element (#122)
+- [283059f](https://github.com/appium/ruby_lib_core/commit/283059f971b4a4aeda707de0542c3991accac128) update (#121)
+- [c188829](https://github.com/appium/ruby_lib_core/commit/c1888292bb28fead792824d8bb7b3a0df94ee891) gather search contexts (#118)
+
+
 #### v1.8.4 2018-07-28
 
 - [1775354](https://github.com/appium/ruby_lib_core/commit/1775354f201658243737a0a455fe4123ce2e87a7) Release 1.8.4

metadata

@@ -1,23 +1,20 @@
 --- !ruby/object:Gem::Specification
 name: appium_lib_core
 version: !ruby/object:Gem::Version
-  version: 1.8.4
+  version: 1.9.0
 platform: ruby
 authors:
 - Kazuaki MATSUO
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-07-28 00:00:00.000000000 Z
+date: 2018-08-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.5'
-    - - "<"
       - !ruby/object:Gem::Version
         version: '3.14'
   type: :runtime
@@ -25,9 +22,6 @@ dependencies:
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.5'
-    - - "<"
       - !ruby/object:Gem::Version
         version: '3.14'
 - !ruby/object:Gem::Dependency
@@ -235,7 +229,6 @@ files:
 - lib/appium_lib_core/android/device/performance.rb
 - lib/appium_lib_core/android/device/screen.rb
 - lib/appium_lib_core/android/espresso/bridge.rb
-- lib/appium_lib_core/android/search_context.rb
 - lib/appium_lib_core/android/uiautomator1/bridge.rb
 - lib/appium_lib_core/android/uiautomator2/bridge.rb
 - lib/appium_lib_core/android/uiautomator2/device.rb
@@ -283,11 +276,9 @@ files:
 - lib/appium_lib_core/common/ws/websocket.rb
 - lib/appium_lib_core/device.rb
 - lib/appium_lib_core/driver.rb
-- lib/appium_lib_core/element/image.rb
 - lib/appium_lib_core/ios.rb
 - lib/appium_lib_core/ios/device.rb
 - lib/appium_lib_core/ios/device/clipboard.rb
-- lib/appium_lib_core/ios/search_context.rb
 - lib/appium_lib_core/ios/uiautomation/bridge.rb
 - lib/appium_lib_core/ios/uiautomation/patch.rb
 - lib/appium_lib_core/ios/xcuitest/bridge.rb
@@ -295,7 +286,6 @@ files:
 - lib/appium_lib_core/ios/xcuitest/device/battery.rb
 - lib/appium_lib_core/ios/xcuitest/device/performance.rb
 - lib/appium_lib_core/ios/xcuitest/device/screen.rb
-- lib/appium_lib_core/ios/xcuitest/search_context.rb
 - lib/appium_lib_core/ios_xcuitest.rb
 - lib/appium_lib_core/patch.rb
 - lib/appium_lib_core/version.rb

data/lib/appium_lib_core/android/search_context.rb

@@ -1,18 +0,0 @@
-module Appium
-  module Core
-    module Android
-      module SearchContext
-        # @!method uiautomator_find
-        #   find_element/s can be used with a [UISelector](http://developer.android.com/tools/help/uiautomator/UiSelector.html).
-        #
-        # @example
-        #
-        #   @driver.find_elements :uiautomator, 'new UiSelector().clickable(true)'
-        #
-        def self.extend
-          ::Appium::Core::Base::SearchContext.add_finders(uiautomator: '-android uiautomator')
-        end
-      end # class << self
-    end # module Ios
-  end # module Core
-end # module Appium

data/lib/appium_lib_core/element/image.rb

@@ -1,106 +0,0 @@
-module Appium
-  module Core
-    #
-    # ImageElement is an element for images by `find_element/s_by_image`
-    # Experimental feature
-    #
-    class ImageElement
-      Point     = Struct.new(:x, :y)
-      Dimension = Struct.new(:width, :height)
-      Rectangle = Struct.new(:x, :y, :width, :height)
-
-      # Base64ed format
-      # @example
-      #
-      #     File.write 'result.png', Base64.decode64(e.visual)
-      #
-      attr_reader :visual
-
-      def initialize(bridge, x, y, width, height, visual = nil)
-        @bridge = bridge
-        @visual = visual
-
-        @center_x = x + width / 2
-        @center_y = y + height / 2
-        @x = x
-        @y = y
-        @width = width
-        @height = height
-      end
-
-      #
-      # Click this element.
-      #
-      # @example
-      #
-      #     e = @@driver.find_element_by_image './test/functional/data/test_element_image.png'
-      #     e.click
-      #
-      def click
-        @bridge.action.move_to_location(@center_x, @center_y).click.perform
-      end
-
-      #
-      # Get the location of this element.
-      #
-      # @return [Point]
-      #
-      # @example
-      #
-      #     e = @@driver.find_element_by_image './test/functional/data/test_element_image.png'
-      #     assert_equal [39, 1014], [e.location.x, e.location.y]
-      #
-      def location
-        Point.new @x, @y
-      end
-
-      #
-      # Get the size of this element
-      #
-      # @return [Dimension]
-      #
-      # @example
-      #
-      #     e = @@driver.find_element_by_image './test/functional/data/test_element_image.png'
-      #         assert_equal [326, 62], [e.size.width, e.size.height]
-      #
-      def size
-        Dimension.new @width, @height
-      end
-
-      #
-      # Get the dimensions and coordinates of this element.
-      #
-      # @return [Rectangle]
-      #
-      # @example
-      #
-      #     e = @@driver.find_element_by_image './test/functional/data/test_element_image.png'
-      #         assert_equal([39, 1014, 326, 62], [e.rect.x, e.rect.y, e.rect.width, e.rect.height])
-      #
-      def rect
-        Rectangle.new @x, @y, @width, @height
-      end
-
-      def displayed?
-        true
-      end
-
-      #-------------------------------- sugar  --------------------------------
-
-      def first(full_image:, partial_image:, match_threshold: nil, visualize: false)
-        @bridge.find_element_by_image(full_image: full_image,
-                                      partial_image: partial_image,
-                                      match_threshold: match_threshold,
-                                      visualize: visualize)
-      end
-
-      def all(full_image:, partial_image:, match_threshold: nil, visualize: false)
-        @bridge.find_elements_by_image(full_image: full_image,
-                                       partial_image: partial_image,
-                                       match_threshold: match_threshold,
-                                       visualize: visualize)
-      end
-    end
-  end
-end

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).
-        #
-        # @example
-        #   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)
-        #
-        # @example
-        #  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/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