appium_lib 9.14.1 → 9.14.2

data/lib/appium_lib/driver.rb

@@ -631,6 +631,43 @@ module Appium
       @driver.find_element(*args)
     end
 
+    # Return ImageElement if current view has a partial image
+    #
+    # @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
+    #
+    # @example
+    #
+    #     @driver.find_element_by_image './test/functional/data/test_element_image.png'
+    #
+    DEFAULT_MATCH_THRESHOLD = 0.5
+    def find_element_by_image(png_img_path, match_threshold: DEFAULT_MATCH_THRESHOLD, visualize: false)
+      @driver.find_element_by_image(png_img_path, match_threshold: match_threshold, visualize: visualize)
+    end
+
+    # Return ImageElement if current view has partial images
+    #
+    # @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.
+    #
+    # @return [[::Appium::Core::ImageElement]]
+    # @return [::Appium::Core::Error::CoreError]
+    #
+    # @example
+    #
+    #     @driver.find_elements_by_image ['./test/functional/data/test_element_image.png']
+    #
+    def find_elements_by_image(png_img_paths, match_threshold: DEFAULT_MATCH_THRESHOLD, visualize: false)
+      @driver.find_elements_by_image(png_img_paths, match_threshold: match_threshold, visualize: visualize)
+    end
+
     # Calls @driver.set_location
     #
     # @note This method does not work on real devices.

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

@@ -14,6 +14,7 @@ module Appium
           target.extend Appium::Ios::Xcuitest::MultiAppHandler
           target.extend Appium::Ios::Xcuitest::Element
           target.extend Appium::Ios::Xcuitest::Command
+          target.extend Appium::Ios::Xcuitest::GetContext
         end
       end
     end

data/lib/appium_lib/ios/xcuitest/command.rb

@@ -2,6 +2,7 @@ require_relative 'command/pasteboard'
 require_relative 'command/gestures'
 require_relative 'command/source'
 require_relative 'command/multi_app_handler'
+require_relative 'command/get_context'
 
 module Appium
   module Ios

data/lib/appium_lib/ios/xcuitest/command/certificate.rb

@@ -0,0 +1,26 @@
+require 'base64'
+
+module Appium
+  module Ios
+    module Xcuitest
+      module Certificate
+        # Generates Apple's over-the-air configuration profile for certificate deployment
+        # based on the given PEM certificate content.
+        # https://developer.apple.com/library/content/documentation/NetworkingInternet/Conceptual/iPhoneOTAConfiguration/Introduction/Introduction.html
+        # https://github.com/appium/appium-xcuitest-driver/pull/652
+        #
+        # @param [string] cer_file The content of the certificate file.
+        #
+        # @example
+        #
+        #     install_certificate cer_file: "path/to/cert.cer"
+        #
+        def install_certificate(cer_file:)
+          args = { content: Base64.encode64(cer_file) }
+
+          @driver.execute_script 'mobile: installCertificate', args
+        end
+      end
+    end # module Xcuitest
+  end # module Ios
+end # module Appium

data/lib/appium_lib/ios/xcuitest/command/get_context.rb

@@ -0,0 +1,20 @@
+module Appium
+  module Ios
+    module Xcuitest
+      # Get the contexts available, with information about the url and title of each webview
+      module GetContext
+        #
+        # Get contexts
+        #
+        # @example
+        #
+        #     xcuitest_get_contexts #=> [{ 'id' => 'NATIVE_APP' },
+        #                       # { 'id' => 'WEBVIEW_41467.1', 'title' => 'Apple', 'url' => 'https://www.apple.com/' }]
+        #
+        def xcuitest_get_contexts
+          @driver.execute_script 'mobile: getContexts', {}
+        end
+      end # module GetContext
+    end # module Xcuitest
+  end # module Ios
+end # module Appium

data/lib/appium_lib/version.rb

@@ -1,5 +1,5 @@
 module Appium
   # Version and Date are defined on the 'Appium' module, not 'Appium::Common'
-  VERSION = '9.14.1'.freeze unless defined? ::Appium::VERSION
-  DATE    = '2018-05-31'.freeze unless defined? ::Appium::DATE
+  VERSION = '9.14.2'.freeze unless defined? ::Appium::VERSION
+  DATE    = '2018-06-25'.freeze unless defined? ::Appium::DATE
 end

data/readme.md

@@ -1,7 +1,6 @@
 # appium_lib
 
 [![Gem Version](https://badge.fury.io/rb/appium_lib.svg)](http://badge.fury.io/rb/appium_lib)
-[![Dependency Status](https://gemnasium.com/appium/ruby_lib.svg)](https://gemnasium.com/appium/ruby_lib)
 [![Travis Master](https://travis-ci.org/appium/ruby_lib.svg?branch=master)](https://travis-ci.org/appium/ruby_lib/builds)
 
 [![Downloads](https://img.shields.io/gem/dt/appium_lib.svg)](https://rubygems.org/gems/appium_lib)
@@ -55,7 +54,7 @@ gem install --no-rdoc --no-ri appium_lib
 
 # Documentation
 
-- [Installing Appium on OS X](https://github.com/appium/ruby_console/blob/master/osx.md)
+- [Getting started](https://github.com/appium/appium/blob/master/docs/en/about-appium/getting-started.md)
 - [Overview](https://github.com/appium/ruby_lib/blob/master/docs/docs.md)
 - [Ruby Android methods](https://github.com/appium/ruby_lib/blob/master/docs/android_docs.md)
 - [Ruby iOS methods](https://github.com/appium/ruby_lib/blob/master/docs/ios_docs.md)

data/release_notes.md

@@ -1,3 +1,9 @@
+#### v9.14.1 2018-05-31
+
+- [cc322d6](https://github.com/appium/ruby_lib/commit/cc322d6a36ad85014b3eed1cdec4481f07b6a95d) [Release 9 14 1 (#787)](https://github.com/appium/ruby_lib/issues/787)
+- [b2772d9](https://github.com/appium/ruby_lib/commit/b2772d952117a9e5d760904ddbfaf5828e8d44cf) [Fix an initialisation error (#786)](https://github.com/appium/ruby_lib/issues/786)
+
+
 #### v9.14.0 2018-05-28
 
 - [d60947d](https://github.com/appium/ruby_lib/commit/d60947df856da65dd31fcdbc34d71719a75d9003) [Release 9 14 0 (#783)](https://github.com/appium/ruby_lib/issues/783)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appium_lib
 version: !ruby/object:Gem::Version
-  version: 9.14.1
+  version: 9.14.2
 platform: ruby
 authors:
 - code@bootstraponline.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-05-31 00:00:00.000000000 Z
+date: 2018-06-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: appium_lib_core
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.7.0
+        version: 1.7.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.7.0
+        version: 1.7.2
 - !ruby/object:Gem::Dependency
   name: tomlrb
   requirement: !ruby/object:Gem::Requirement
@@ -257,7 +257,9 @@ files:
 - lib/appium_lib/ios/xcuitest.rb
 - lib/appium_lib/ios/xcuitest/bridge.rb
 - lib/appium_lib/ios/xcuitest/command.rb
+- lib/appium_lib/ios/xcuitest/command/certificate.rb
 - lib/appium_lib/ios/xcuitest/command/gestures.rb
+- lib/appium_lib/ios/xcuitest/command/get_context.rb
 - lib/appium_lib/ios/xcuitest/command/multi_app_handler.rb
 - lib/appium_lib/ios/xcuitest/command/pasteboard.rb
 - lib/appium_lib/ios/xcuitest/command/source.rb