appium_lib_core 1.7.0 → 1.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ae3ab4209d2a044887cda376b71c5a61a5e525d7
-  data.tar.gz: 16dacc763beec91077e7fdc76806c6d775002966
+  metadata.gz: 186c66ad7d2bd85ada277634f906739683741bca
+  data.tar.gz: 20c05598f4aa22bdbeccfd9ba57c032383a34b53
 SHA512:
-  metadata.gz: 74c62e4e29d2c3b6428a8f6891f209f780b73b2d5cd491e85bb74dd057de9a786f38933ff81c57a44a81bc02f6f7e76a8e127af2ef59990d793babdbef903d3b
-  data.tar.gz: 819194531cf4631149199061461ddf41f7be0eec4dba95cc7573f2ad75de6791c5d490c8e08226e9df3ee6e23e9663e0d8913e9012c9fe831513ef50673ff92a
+  metadata.gz: 81483bed8fb09ad7e9cb5177593270de7eea8593ff83beee3c94e2d69bb9ca09805d9ce312751ac95fef2cb42f07910b6add32d07af896e35d501d2d44b2675f
+  data.tar.gz: 9f26c27dcb556240802069c9728f12c07d119fee0f4e46b5332074faa6946b330412ed5071e8b65a6f0b41273ff36c5654df855c5eea3b8746ed75e5df03737c

data/CHANGELOG.md

@@ -8,6 +8,15 @@ All notable changes to this project will be documented in this file.
 
 ### Deprecations
 
+## [1.7.1] - 2018-06-15
+### Enhancements
+- Add a `format` argument for `device_time` [#94](https://github.com/appium/ruby_lib_core/pull/94)
+
+### Bug fixes
+- Return empty array `[]` for find_elements
+
+### Deprecations
+
 ## [1.7.0] - 2018-05-28
 ### Enhancements
 - Has one **Breaking Change**

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

@@ -40,7 +40,7 @@ module Appium
         #
         # Find all elements matching the given arguments
         #
-        # @see SearchContext#find_element
+        # @see SearchContext#find_elements
         #
         def find_elements(*args)
           how, what = extract_args(args)
@@ -48,7 +48,7 @@ module Appium
           begin
             bridge.find_elements_by by, what.to_s, ref
           rescue Selenium::WebDriver::Error::TimeOutError
-            raise Selenium::WebDriver::Error::NoSuchElementError
+            []
           end
         end
 

data/lib/appium_lib_core/device.rb

@@ -80,11 +80,15 @@ module Appium
       # @!method device_time
       #   Get the time on the device
       #
-      # @return [String]
+      # @param [String] format The set of format specifiers. Read https://momentjs.com/docs/ to get the full list of supported
+      #                        datetime format specifiers. The default format is `YYYY-MM-DDTHH:mm:ssZ`,
+      #                        which complies to ISO-8601
+      # @return [String] Formatted datetime string or the raw command output if formatting fails
       #
       # @example
       #
-      #   @driver.device_time
+      #   @driver.device_time #=> "2018-06-12T11:13:31+02:00"
+      #   @driver.device_time "YYYY-MM-DD" #=> "2018-06-12"
       #
 
       ####
@@ -277,7 +281,21 @@ module Appium
 
       # @!method push_file(path, filedata)
       # Place a file in a specific location on the device.
+      # On iOS, the server should have ifuse libraries installed and configured properly for this feature to work on real devices.
+      # On Android, the application under test should be built with debuggable flag enabled in order to get access to
+      # its container on the internal file system.
+      #
+      # @see https://github.com/libimobiledevice/ifuse iFuse GitHub page6
+      # @see https://github.com/osxfuse/osxfuse/wiki/FAQ osxFuse FAQ
+      # @see https://developer.android.com/studio/debug/ 'Debug Your App' developer article
+      #
       # @param [String] path The absolute path on the device to store data at.
+      #                      If the path starts with application id prefix, then the file will be pushed to
+      #                      the root of the corresponding application container.
+
+      # @param [String] path Either an absolute path OR, for iOS devices, a path relative to the app, as described.
+      #                      If the path starts with application id prefix, then the file will be pushed to the root of
+      #                      the corresponding application container.
       # @param [String] filedata Raw file data to be sent to the device. Converted to base64 in the method.
       #
       # @example
@@ -286,9 +304,22 @@ module Appium
       #
 
       # @!method pull_file(path)
-      # Retrieve a file from the device.  This can retrieve an absolute path or
-      # a path relative to the installed app (iOS only).
+      # Pull a file from the simulator/device.
+      # On iOS the server should have ifuse
+      # libraries installed and configured properly for this feature to work on real devices.
+      # On Android the application under test should be built with debuggable flag enabled in order to get access
+      # to its container on the internal file system.
+      #
+      # @see https://github.com/libimobiledevice/ifuse iFuse GitHub page6
+      # @see https://github.com/osxfuse/osxfuse/wiki/FAQ osxFuse FAQ
+      # @see https://developer.android.com/studio/debug/ 'Debug Your App' developer article
+      #
       # @param [String] path Either an absolute path OR, for iOS devices, a path relative to the app, as described.
+      #                      If the path starts with application id prefix, then the file will be pulled from the root
+      #                      of the corresponding application container.
+      #                      Otherwise the root folder is considered as / on Android and on iOS it is a media folder root
+      #                      (real devices only).
+      # @return [Base64-decoded] Base64 decoded data
       #
       # @example
       #
@@ -297,8 +328,22 @@ module Appium
       #
 
       # @!method pull_folder(path)
-      # Retrieve a folder from the device.
-      # @param [String] path absolute path to the folder
+      # Pull a folder content from the simulator/device.
+      # On iOS the server should have ifuse libraries installed and configured properly for this feature to work on real devices.
+      # On Android the application under test should be built with debuggable flag enabled in order to get access to its container
+      # on the internal file system.
+      #
+      # @see https://github.com/libimobiledevice/ifuse iFuse GitHub page6
+      # @see https://github.com/osxfuse/osxfuse/wiki/FAQ osxFuse FAQ
+      # @see https://developer.android.com/studio/debug/ 'Debug Your App' developer article
+      #
+      # @param [String] path Absolute path to the folder.
+      #                      If the path starts with <em>@applicationId/</em> prefix, then the folder will be pulled
+      #                      from the root of the corresponding application container.
+      #                      Otherwise the root folder is considered as / on Android and on iOS it is a media folder root
+      #                      (real devices only).
+      #
+      # @return [Base64-decoded] Base64 decoded data which is zip archived
       #
       # @example
       #
@@ -482,8 +527,10 @@ module Appium
           end
 
           add_endpoint_method(:device_time) do
-            def device_time
-              execute :device_time
+            def device_time(format = nil)
+              arg = {}
+              arg[:format] = format unless format.nil?
+              execute :device_time, {}, arg
             end
           end
 

data/lib/appium_lib_core/version.rb

@@ -1,6 +1,6 @@
 module Appium
   module Core
-    VERSION = '1.7.0'.freeze unless defined? ::Appium::Core::VERSION
-    DATE    = '2018-05-28'.freeze unless defined? ::Appium::Core::DATE
+    VERSION = '1.7.1'.freeze unless defined? ::Appium::Core::VERSION
+    DATE    = '2018-06-15'.freeze unless defined? ::Appium::Core::DATE
   end
 end

data/release_notes.md

@@ -1,3 +1,12 @@
+#### v1.7.1 2018-06-15
+
+- [84febaf](https://github.com/appium/ruby_lib_core/commit/84febaf3a5b4dff0084455556d3ffe1293b64471) Release 1.7.1
+- [6d00f73](https://github.com/appium/ruby_lib_core/commit/6d00f739e93954508c34016732907e8629ffaaf5) Update search_context.rb
+- [f40cded](https://github.com/appium/ruby_lib_core/commit/f40cdede589bf32abd78ab4e3d8c0240dfad0865) add date format for Android (#94)
+- [afc3878](https://github.com/appium/ruby_lib_core/commit/afc3878c39564317cc5f5c3057dd6375ec8772f6) appended docstring for file management (#93)
+- [2f53204](https://github.com/appium/ruby_lib_core/commit/2f5320413437c77cef233c7941d3419ab674bd5c) replace name with text
+
+
 #### v1.7.0 2018-05-28
 
 - [619b964](https://github.com/appium/ruby_lib_core/commit/619b96483dc4bce50295ae831e445053e3d9f1d9) Release 1.7.0

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appium_lib_core
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 1.7.1
 platform: ruby
 authors:
 - Kazuaki MATSUO
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-05-27 00:00:00.000000000 Z
+date: 2018-06-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver