appium_lib 9.6.0 → 9.6.1

data/docs/ios_xcuitest.md

@@ -112,3 +112,7 @@ xpaths("//some xpaths")
 
 ## Other actions
 Basically, other actions such as `type` are compatible with `automationName = Appium`.
+
+## Pasteboard
+- Simulator only
+    - https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/ios-xctest-pasteboard.md

data/lib/appium_lib/android/uiautomator2.rb

@@ -0,0 +1,10 @@
+require_relative 'uiautomator2/helper'
+require_relative 'uiautomator2/element'
+
+module Appium
+  module Ios
+    module Xcuitest
+      # parent
+    end # module Xcuitest
+  end # module Ios
+end # module Appium

data/lib/appium_lib/android/uiautomator2/element.rb

@@ -0,0 +1,10 @@
+require_relative 'element/button'
+
+module Appium
+  module Android
+    module Uiautomator2
+      module Element
+      end # module Element
+    end # module Uiautomator2
+  end # module Android
+end # module Appium

data/lib/appium_lib/capabilities.rb

@@ -0,0 +1,13 @@
+module Appium
+  class Driver
+    module Capabilities
+      # @param [Hash] opts_caps Capabilities for Appium server. All capability keys are converted to lowerCamelCase when
+      #                         this client sends capabilities to Appium server as JSON format.
+      # @return [::Selenium::WebDriver::Remote::W3C::Capabilities] Return instance of Appium::Driver::Capabilities
+      #                         inherited ::Selenium::WebDriver::Remote::W3C::Capabilities
+      def self.init_caps_for_appium(opts_caps = {})
+        ::Selenium::WebDriver::Remote::W3C::Capabilities.new(opts_caps)
+      end
+    end
+  end
+end

data/lib/appium_lib/common/version.rb

@@ -1,5 +1,5 @@
 module Appium
   # Version and Date are defined on the 'Appium' module, not 'Appium::Common'
-  VERSION = '9.6.0'.freeze unless defined? ::Appium::VERSION
-  DATE    = '2017-08-19'.freeze unless defined? ::Appium::DATE
+  VERSION = '9.6.1'.freeze unless defined? ::Appium::VERSION
+  DATE    = '2017-08-27'.freeze unless defined? ::Appium::DATE
 end

data/lib/appium_lib/driver.rb

@@ -3,6 +3,9 @@ require 'ap'
 require 'selenium-webdriver'
 require 'nokogiri'
 
+# base
+require_relative 'capabilities'
+
 # common
 require_relative 'common/helper'
 require_relative 'common/wait'
@@ -25,16 +28,7 @@ require_relative 'ios/element/textfield'
 require_relative 'ios/element/text'
 require_relative 'ios/mobile_methods'
 
-# ios - xcuitest
-require_relative 'ios/xcuitest/element'
-require_relative 'ios/xcuitest/gestures'
-require_relative 'ios/xcuitest/mobile_methods'
-require_relative 'ios/xcuitest/device'
-require_relative 'ios/xcuitest/helper'
-require_relative 'ios/xcuitest/element/text'
-require_relative 'ios/xcuitest/element/textfield'
-require_relative 'ios/xcuitest/element/generic'
-require_relative 'ios/xcuitest/element/button'
+require_relative 'ios/xcuitest'
 
 # android
 require_relative 'android/helper'
@@ -50,7 +44,7 @@ require_relative 'android/mobile_methods'
 require_relative 'android/device'
 
 # android - uiautomator2
-require_relative 'android/uiautomator2/helper.rb'
+require_relative 'android/uiautomator2'
 
 # device methods
 require_relative 'device/device'
@@ -268,18 +262,6 @@ module Appium
     Gem.loaded_specs['selenium-webdriver'].version >= Gem::Version.new(version)
   end
 
-  class Driver
-    module Capabilities
-      # @param [Hash] opts_caps Capabilities for Appium server. All capability keys are converted to lowerCamelCase when
-      #                         this client sends capabilities to Appium server as JSON format.
-      # @return [::Selenium::WebDriver::Remote::W3C::Capabilities] Return instance of Appium::Driver::Capabilities
-      #                         inherited ::Selenium::WebDriver::Remote::W3C::Capabilities
-      def self.init_caps_for_appium(opts_caps = {})
-        ::Selenium::WebDriver::Remote::W3C::Capabilities.new(opts_caps)
-      end
-    end
-  end
-
   class Driver
     # attr readers are promoted to global scope. To avoid clobbering, they're
     # made available via the driver_attributes method
@@ -387,11 +369,15 @@ module Appium
     # @param opts [Object] A hash containing various options.
     # @param global_driver [Bool] A bool require global driver before initialize.
     # @return [Driver]
-    def initialize(opts = {}, global_driver = true)
-      if global_driver
+    def initialize(opts = {}, global_driver = nil)
+      if global_driver.nil?
         warn '[DEPRECATION] Appium::Driver.new(opts) will not generate global driver by default.' \
                  'If you would like to generate the global driver dy default, ' \
                  'please initialise driver with Appium::Driver.new(opts, true)'
+        global_driver = true # if global_driver is nil, then global_driver must be default value.
+      end
+
+      if global_driver
         $driver.driver_quit if $driver
       end
       raise 'opts must be a hash' unless opts.is_a? Hash
@@ -426,13 +412,16 @@ module Appium
         extend Appium::Android
         extend Appium::Android::Device
         if automation_name_is_uiautomator2?
+          extend Appium::Android::Uiautomator2
           extend Appium::Android::Uiautomator2::Helper
+          extend Appium::Android::Uiautomator2::Element
         end
       else
         extend Appium::Ios
         if automation_name_is_xcuitest?
-          # Override touch actions and patch_webdriver_element
           extend Appium::Ios::Xcuitest
+          extend Appium::Ios::Xcuitest::SearchContext
+          extend Appium::Ios::Xcuitest::Command
           extend Appium::Ios::Xcuitest::Helper
           extend Appium::Ios::Xcuitest::Gesture
           extend Appium::Ios::Xcuitest::Device

data/lib/appium_lib/ios/xcuitest.rb

@@ -0,0 +1,15 @@
+require_relative 'xcuitest/search_context'
+require_relative 'xcuitest/element'
+require_relative 'xcuitest/gestures'
+require_relative 'xcuitest/command'
+require_relative 'xcuitest/device'
+require_relative 'xcuitest/helper'
+require_relative 'xcuitest/element'
+
+module Appium
+  module Ios
+    module Xcuitest
+      # parent
+    end # module Xcuitest
+  end # module Ios
+end # module Appium

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

@@ -0,0 +1,8 @@
+require_relative 'command/pasteboard'
+
+module Appium
+  module Ios
+    module Command
+    end
+  end
+end

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

@@ -0,0 +1,33 @@
+module Appium
+  module Ios
+    module Xcuitest
+      module Command
+        # @param [string] content The content of the pasteboard. The previous content is going to be overridden.
+        #                         The parameter is mandatory
+        # @option opts [string] :encoding Encoding of the given content. UTF-8 by default.
+        #
+        #   ```ruby
+        #   set_pasteboard content: "sample content"
+        #   ```
+        def set_pasteboard(content:, encoding: nil)
+          args = { content: content }
+          args[:encoding] = encoding if encoding
+
+          @driver.execute_script 'mobile: setPasteboard', args
+        end
+
+        # @option opts [string] :encoding Encoding of the received pasteboard content. UTF-8 by default.
+        #
+        #   ```ruby
+        #   get_pasteboard encoding: "shift-jis"
+        #   ```
+        def get_pasteboard(encoding: nil)
+          args = {}
+          args[:encoding] = encoding if encoding
+
+          @driver.execute_script 'mobile: getPasteboard', args
+        end
+      end
+    end # module Xcuitest
+  end # module Ios
+end # module Appium

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

@@ -1,24 +1,31 @@
+require_relative 'element/text'
+require_relative 'element/textfield'
+require_relative 'element/generic'
+require_relative 'element/button'
+
 module Appium
   module Ios
     module Xcuitest
-      # @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 patch_webdriver_element
-        Selenium::WebDriver::Element.class_eval do
-          # Enable access to iOS accessibility label
-          # accessibility identifier is supported as 'name'
-          def label
-            attribute('label')
-          end
+      module Element
+        # @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 patch_webdriver_element
+          Selenium::WebDriver::Element.class_eval do
+            # Enable access to iOS accessibility label
+            # accessibility identifier is supported as 'name'
+            def label
+              attribute('label')
+            end
 
-          # Cross platform way of entering text into a textfield
-          def type(text)
-            send_keys text
-          end # def type
-        end # Selenium::WebDriver::Element.class_eval
-      end # def patch_webdriver_element
+            # Cross platform way of entering text into a textfield
+            def type(text)
+              send_keys text
+            end # def type
+          end # Selenium::WebDriver::Element.class_eval
+        end # def patch_webdriver_element
+      end # module Element
     end # module Xcuitest
   end # module Ios
 end # module Appium

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

@@ -0,0 +1,25 @@
+module Appium
+  module Ios
+    module Xcuitest
+      module SearchContext
+        class << self
+          # @!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)
+          #
+          #   ```ruby
+          #    # 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]'
+          #   ```
+          def extended(_mod)
+            ::Appium::Driver::SearchContext::FINDERS[:class_chain] = '-ios class chain'
+          end
+        end
+      end
+    end # module Xcuitest
+  end # module Ios
+end # module Appium

data/release_notes.md

@@ -1,3 +1,19 @@
+#### v9.6.0 2017-08-20
+
+- [e1a2cd4](https://github.com/appium/ruby_lib/commit/e1a2cd493a370655b390a1d3803a85fbdb5f7f9d) [Release 9 6 0 (#643)](https://github.com/appium/ruby_lib/issues/643)
+- [6c6e916](https://github.com/appium/ruby_lib/commit/6c6e9165998a457188b1e53476c9bdbb18fa2ef7) [refactor: separate uiautomator2 (#642)](https://github.com/appium/ruby_lib/issues/642)
+- [2b1a5ee](https://github.com/appium/ruby_lib/commit/2b1a5eef44be48df5e14dc42000b4a776a2bae5b) [Append documentations (#640)](https://github.com/appium/ruby_lib/issues/640)
+- [6ee404d](https://github.com/appium/ruby_lib/commit/6ee404ddbe932b97d50904a2f273b7404485d79e) [refactor: Separate xcuitest more (#639)](https://github.com/appium/ruby_lib/issues/639)
+- [8a7c386](https://github.com/appium/ruby_lib/commit/8a7c386a51e9f83826e1d5d799cc509cd0c7e3ae) [feature: test code for multiple iOS simulators (#637)](https://github.com/appium/ruby_lib/issues/637)
+- [b7daaac](https://github.com/appium/ruby_lib/commit/b7daaac9b2262c80ee679263a809bd98371b312b) [fix: Fix Android scroll_to and scroll_to_exact (#638)](https://github.com/appium/ruby_lib/issues/638)
+- [65b2c7a](https://github.com/appium/ruby_lib/commit/65b2c7a9edb65e50c61c5e64408e9d7ee36465cf) [refactor: remove unused definition and rename arguments for initilizer (#635)](https://github.com/appium/ruby_lib/issues/635)
+- [35d3b11](https://github.com/appium/ruby_lib/commit/35d3b11dafac3363902fc0352a62d957fd90a947) [Alias `quit_driver` to `driver_quit`. (#634)](https://github.com/appium/ruby_lib/issues/634)
+- [214cf72](https://github.com/appium/ruby_lib/commit/214cf72bd8aefffb974d5757d218a668e14a87c7) [fix: Fix android tests and add broken ime methods (#633)](https://github.com/appium/ruby_lib/issues/633)
+- [aaf307d](https://github.com/appium/ruby_lib/commit/aaf307d9bacc30d5c9edb0507d1541ef626d3308) [refactor: loading xcuitest related methods only for XCUITest case (#631)](https://github.com/appium/ruby_lib/issues/631)
+- [20bc86a](https://github.com/appium/ruby_lib/commit/20bc86a5195ef0f6d51ccba68019c1228cd2a0f1) [add extending bridge commands for W3C (#632)](https://github.com/appium/ruby_lib/issues/632)
+- [6288409](https://github.com/appium/ruby_lib/commit/62884095bd59b420c1eb0d9295e9d3f31ca16195) [refactor: set global driver as arguments (#629)](https://github.com/appium/ruby_lib/issues/629)
+
+
 #### v9.5.0 2017-08-05
 
 - [19177f5](https://github.com/appium/ruby_lib/commit/19177f5348300a0e2e1e0510b99efac2f3067201) [Release 9 5 0 (#628)](https://github.com/appium/ruby_lib/issues/628)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appium_lib
 version: !ruby/object:Gem::Version
-  version: 9.6.0
+  version: 9.6.1
 platform: ruby
 authors:
 - code@bootstraponline.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-08-19 00:00:00.000000000 Z
+date: 2017-08-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
@@ -36,14 +36,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '1.8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '1.8'
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
@@ -263,8 +263,11 @@ files:
 - lib/appium_lib/android/helper.rb
 - lib/appium_lib/android/mobile_methods.rb
 - lib/appium_lib/android/patch.rb
+- lib/appium_lib/android/uiautomator2.rb
+- lib/appium_lib/android/uiautomator2/element.rb
 - lib/appium_lib/android/uiautomator2/element/button.rb
 - lib/appium_lib/android/uiautomator2/helper.rb
+- lib/appium_lib/capabilities.rb
 - lib/appium_lib/common/command.rb
 - lib/appium_lib/common/element/window.rb
 - lib/appium_lib/common/error.rb
@@ -286,6 +289,9 @@ files:
 - lib/appium_lib/ios/helper.rb
 - lib/appium_lib/ios/mobile_methods.rb
 - lib/appium_lib/ios/patch.rb
+- lib/appium_lib/ios/xcuitest.rb
+- lib/appium_lib/ios/xcuitest/command.rb
+- lib/appium_lib/ios/xcuitest/command/pasteboard.rb
 - lib/appium_lib/ios/xcuitest/device.rb
 - lib/appium_lib/ios/xcuitest/element.rb
 - lib/appium_lib/ios/xcuitest/element/button.rb
@@ -294,7 +300,7 @@ files:
 - lib/appium_lib/ios/xcuitest/element/textfield.rb
 - lib/appium_lib/ios/xcuitest/gestures.rb
 - lib/appium_lib/ios/xcuitest/helper.rb
-- lib/appium_lib/ios/xcuitest/mobile_methods.rb
+- lib/appium_lib/ios/xcuitest/search_context.rb
 - lib/appium_lib/logger.rb
 - readme.md
 - release_notes.md

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

@@ -1,23 +0,0 @@
-module Appium
-  module Ios
-    module Xcuitest
-      class << self
-        # @!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)
-        #
-        #   ```ruby
-        #    # 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]'
-        #   ```
-        def extended(_mod)
-          ::Appium::Driver::SearchContext::FINDERS[:class_chain] = '-ios class chain'
-        end
-      end
-    end
-  end # module Ios
-end # module Appium