appium_lib_core 3.2.0 → 3.2.1

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

@@ -30,7 +30,7 @@ module Appium
           # @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`.
+          #   Default for iOS is +:pressKey+. Default for Android is +:tapOutside+.
           #
           # @example
           #
@@ -51,7 +51,7 @@ module Appium
           #
 
           # @since Appium 1.9.1
-          # @!method start_recording_screen(remote_path: nil, user: nil, pass: nil, method: nil, force_restart: nil, video_type: 'mjpeg', video_fps: nil, time_limit: '180', video_quality: 'medium', video_scale: '320:240')
+          # @!method start_recording_screen(remote_path: nil, user: nil, pass: nil, method: nil, force_restart: nil, video_type: 'mjpeg', video_fps: nil, time_limit: '180', video_quality: 'medium', video_scale: nil, video_filters: nil, pixel_format: nil)
           #
           # Record the display of devices running iOS Simulator since Xcode 9 or real devices since iOS 11
           # (ffmpeg utility is required: 'brew install ffmpeg').
@@ -64,30 +64,39 @@ module Appium
           #                             An exception will be thrown if the generated media file is too big to
           #                             fit into the available process memory.
           #                             This option only has an effect if there is screen recording process in progreess
-          #                             and `forceRestart` parameter is not set to `true`.
+          #                             and +forceRestart+ parameter is not set to +true+.
           # @param [String] user The name of the user for the remote authentication.
           # @param [String] pass The password for the remote authentication.
           # @param [String] method The http multipart upload method name. The 'PUT' one is used by default.
           # @param [Boolean] force_restart Whether to try to catch and upload/return the currently running screen recording
-          #                                (`false`, the default setting on server) or ignore the result of it
-          #                                and start a new recording immediately (`true`).
+          #                                (+false+, the default setting on server) or ignore the result of it
+          #                                and start a new recording immediately (+true+).
           # @param [String] video_type The video codec type used for encoding of the be recorded screen capture.
-          #                            Execute `ffmpeg -codecs` in the terminal to see the list of supported video codecs.
+          #                            Execute +ffmpeg -codecs+ in the terminal to see the list of supported video codecs.
           #                            'mjpeg' by default.
           # @param [String] time_limit Recording time. 180 seconds is by default.
           # @param [String] video_quality The video encoding quality (low, medium, high, photo - defaults to medium).
           # @param [String] video_fps The Frames Per Second rate of the recorded video. Change this value if the resulting video
           #                           is too slow or too fast. Defaults to 10. This can decrease the resulting file size.
+          # @param [String] video_filters - @since Appium 1.15.0
+          #                                 The ffmpeg video filters to apply. These filters allow to scale, flip, rotate and do many
+          #                                 other useful transformations on the source video stream. The format of the property
+          #                                 must comply with https://ffmpeg.org/ffmpeg-filters.html
+          #                                 e.g.: "rotate=90"
           # @param [String] video_scale The scaling value to apply. Read https://trac.ffmpeg.org/wiki/Scaling for possible values.
           #                             No scale is applied by default.
-          # @param [String] pixel_format Output pixel format. Run `ffmpeg -pix_fmts` to list possible values.
+          #                             tips: ffmpeg cannot capture video as +libx264+ if the video dimensions is not divisible by 2.
+          #                             Then, you can set this scale as +scale=trunc(iw/2)*2:trunc(ih/2)*2+
+          #                             - https://github.com/appium/appium/issues/12856
+          #                             - https://www.reddit.com/r/linux4noobs/comments/671z6b/width_not_divisible_by_2_error_when_using_ffmpeg/
+          # @param [String] pixel_format Output pixel format. Run +ffmpeg -pix_fmts+ to list possible values.
           #                              For Quicktime compatibility, set to "yuv420p" along with videoType: "libx264".
           #
           # @example
           #
           #    @driver.start_recording_screen
           #    @driver.start_recording_screen video_type: 'mjpeg', time_limit: '260'
-          #    @driver.start_recording_screen video_type: 'libx264', time_limit: '260' # Can get `.mp4` video
+          #    @driver.start_recording_screen video_type: 'libx264', time_limit: '260' # Can get '.mp4' video
           #
 
           # @since Appium 1.3.4
@@ -97,14 +106,14 @@ module Appium
           #
           # @param [Integer|String] timeout The maximum count of milliseconds to record the profiling information.
           # @param [String] profile_name The name of existing performance profile to apply.
-          #                              Execute `instruments -s` to show the list of available profiles.
+          #                              Execute +instruments -s+ to show the list of available profiles.
           #                              Note, that not all profiles are supported on mobile devices.
           # @param [Integer|String] pid The ID of the process to measure the performance for.
-          #                             Set it to `current` in order to measure the performance of
+          #                             Set it to +current+ in order to measure the performance of
           #                             the process, which belongs to the currently active application.
           #                             All processes running on the device are measured if
           #                             pid is unset (the default setting). Setting process ID while
-          #                             device under test is Simulator might require `instruments` to be launched
+          #                             device under test is Simulator might require +instruments+ to be launched
           #                             with sudo privileges, which is not supported and will throw a timeout exception.
           # @return nil
           #
@@ -121,7 +130,7 @@ module Appium
           #
           # @param [String] save_file_path A path to save data as zipped .trace file
           # @param [String] profile_name The name of existing performance profile to apply.
-          #                              Execute `instruments -s` to show the list of available profiles.
+          #                              Execute +instruments -s+ to show the list of available profiles.
           #                              Note, that not all profiles are supported on mobile devices.
           # @param [String] remote_path The path to the remote location, where the resulting zipped .trace file should be uploaded.
           #                             The following protocols are supported: http/https, ftp.
@@ -129,9 +138,9 @@ module Appium
           #                             file should be zipped, encoded as Base64 and passed as the endpount response value.
           #                             An exception will be thrown if the generated file is too big to
           #                             fit into the available process memory.
-          # @param [String] user The name of the user for the remote authentication. Only works if `remotePath` is provided.
-          # @param [String] pass The password for the remote authentication. Only works if `remotePath` is provided.
-          # @param [String] method The http multipart upload method name. Only works if `remotePath` is provided.
+          # @param [String] user The name of the user for the remote authentication. Only works if +remotePath+ is provided.
+          # @param [String] pass The password for the remote authentication. Only works if +remotePath+ is provided.
+          # @param [String] method The http multipart upload method name. Only works if +remotePath+ is provided.
           #
           # @example
           #
@@ -144,11 +153,11 @@ module Appium
           # Get battery information.
           #
           # @return [Hash]  Return battery level and battery state from the target real device. (Simulator has no battery.)
-          #                 https://developer.apple.com/documentation/uikit/uidevice/ 's `batteryLevel` and `batteryState`.
+          #                 https://developer.apple.com/documentation/uikit/uidevice/ 's +batteryLevel+ and +batteryState+.
           #                 Battery level in range [0.0, 1.0], where 1.0 means 100% charge. -1 is returned
           #                 if the actual value cannot be retrieved from the system.
           #                 Battery state. The following symbols are possible
-          #                 `:unplugged, :charging, :full`
+          #                 +:unplugged, :charging, :full+
           #
           # @example
           #
@@ -179,7 +188,7 @@ module Appium
               ::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
+                  # '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

data/lib/appium_lib_core/ios/xcuitest/device/screen.rb

@@ -23,7 +23,7 @@ module Appium
                 # rubocop:disable Metrics/ParameterLists
                 def start_recording_screen(remote_path: nil, user: nil, pass: nil, method: 'PUT', force_restart: nil,
                                            video_type: 'mjpeg', time_limit: '180', video_quality: 'medium',
-                                           video_fps: nil, video_scale: nil, pixel_format: nil)
+                                           video_fps: nil, video_scale: nil, video_filters: nil, pixel_format: nil)
                   option = ::Appium::Core::Base::Device::ScreenRecord.new(
                     remote_path: remote_path, user: user, pass: pass, method: method, force_restart: force_restart
                   ).upload_option
@@ -34,6 +34,7 @@ module Appium
 
                   option[:videoFps] = video_fps unless video_fps.nil?
                   option[:videoScale] = video_scale unless video_scale.nil?
+                  option[:videoFilters] = video_filters unless video_filters.nil?
                   option[:pixelFormat] = pixel_format unless pixel_format.nil?
 
                   execute(:start_recording_screen, {}, { options: option })

data/lib/appium_lib_core/patch.rb

@@ -40,7 +40,7 @@ module Appium
       #
       #   e = @driver.find_element :accessibility_id, 'something'
       #   e.value
-      #   e.resource_id # call `e.attribute "resource-id"`
+      #   e.resource_id # call 'e.attribute "resource-id"'
       #
       def method_missing(method_name, *args, &block)
         ignore_list = [:to_hash]
@@ -56,6 +56,26 @@ module Appium
       # Alias for type
       alias type send_keys
 
+      # Set the value to element directly
+      #
+      # @example
+      #
+      #   @driver.immediate_value 'hello'
+      #
+      def immediate_value(*value)
+        @bridge.set_immediate_value(self, *value)
+      end
+
+      # Replace the value to element directly
+      #
+      # @example
+      #
+      #   @driver.replace_value 'hello'
+      #
+      def replace_value(*value)
+        @bridge.replace_value(self, *value)
+      end
+
       # For use with location_rel.
       #
       # @return [::Selenium::WebDriver::Point] the relative x, y in a struct. ex: { x: 0.50, y: 0.20 }

data/lib/appium_lib_core/version.rb

@@ -14,7 +14,7 @@
 
 module Appium
   module Core
-    VERSION = '3.2.0' unless defined? ::Appium::Core::VERSION
-    DATE    = '2019-06-27' unless defined? ::Appium::Core::DATE
+    VERSION = '3.2.1' unless defined? ::Appium::Core::VERSION
+    DATE    = '2019-07-19' unless defined? ::Appium::Core::DATE
   end
 end

data/release_notes.md

@@ -1,3 +1,20 @@
+#### v3.2.1 2019-07-19
+
+- [e30a905](https://github.com/appium/ruby_lib_core/commit/e30a90549ac9dd6b0019370ce6abb8a08fc88e82) Release 3.2.1
+- [48eaa01](https://github.com/appium/ruby_lib_core/commit/48eaa01c811da8d98ff28a3651d5bed70d310516) Fix check automationName youi (#230)
+- [aa0c180](https://github.com/appium/ruby_lib_core/commit/aa0c180cd4eea29888d4307d74382a240e01f7ca) update azure module
+- [67df100](https://github.com/appium/ruby_lib_core/commit/67df100c694e1a3d05abba2018d8243b94ba5f9e) Add filters for start_recording_screen, ios, tweak yardoc (#229)
+- [2129d17](https://github.com/appium/ruby_lib_core/commit/2129d1780901e9a2cff777e09e0c645e2620e16d) ci: use macOS High Sierra for iOS since it fails on macOS host (#228)
+- [307c25c](https://github.com/appium/ruby_lib_core/commit/307c25cc3286df943d740f6e8a64946ba54f66d9) add a cron schedule
+- [362405b](https://github.com/appium/ruby_lib_core/commit/362405b857fa3f36b9dfe2c745c10cd288ec577f) ci: tweak skip test cases (#226)
+- [80c2c07](https://github.com/appium/ruby_lib_core/commit/80c2c07c3a616c33a6047c87e6b911eaeabc58a0) install opencv4nodejs (#225)
+- [47dfc1a](https://github.com/appium/ruby_lib_core/commit/47dfc1adc5493ef279ac098486bf8f94ec04a56e) add npm list task (#224)
+- [3944039](https://github.com/appium/ruby_lib_core/commit/3944039413c38cda21be8e93d03461aec7f8d2f1) remove cat
+- [2d55315](https://github.com/appium/ruby_lib_core/commit/2d55315d4f2480ac04c9957a26acb090ff2faa15) move cat
+- [1555107](https://github.com/appium/ruby_lib_core/commit/15551077dc739b6d1c0b25cc8918e172c2fcaa2c) add a script to show appium dependencies on azure
+- [3c0b05c](https://github.com/appium/ruby_lib_core/commit/3c0b05c2dd508273126b7c098c77f22f2c7a54c6) move element methods (#223)
+
+
 #### v3.2.0 2019-06-27
 
 - [2f6ca23](https://github.com/appium/ruby_lib_core/commit/2f6ca23847de85fb8134f09da627391b4a66a544) Release 3.2.0

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appium_lib_core
 version: !ruby/object:Gem::Version
-  version: 3.2.0
+  version: 3.2.1
 platform: ruby
 authors:
 - Kazuaki MATSUO
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-06-26 00:00:00.000000000 Z
+date: 2019-07-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver