appium_lib_core 4.1.0 → 9.1.0

data/CHANGELOG.md

@@ -5,68 +5,381 @@ Read `release_notes.md` for commit level details.
 ## [Unreleased]
 
 ### Enhancements
-- Ruby 3.0 support
 
 ### Bug fixes
 
 ### Deprecations
 
-## [4.1.0] - 2020-12-25
+## [9.1.0] - 2024-05-18
 
 ### Enhancements
-- Ruby 3.0 support
+- Require Selenium 4.21.0+
+- Simplify internal code with Selenium 4.21.0. Now it requires selenium webdriver v4.21.0.
+
+## [9.0.0] - 2024-05-14
+
+### Deprecations
+- Stop converting snake cases to camel case for symbols in capabilities
+    - Please define camel/snake cases in capabilities as-is for the WebDriver capabilities
+- Stop implicit symbolizing capabilities
+    - Historically ruby_lib/ruby_lib_core symbolized capabilities keys from string internally.
+    - `Appium.symbolize_keys` to build symbolized capabilities if issues occurred by this change.
+
+## [8.0.2] - 2024-04-26
+
+### Enhancements
+- Bump thor for publishment module
+
+## [8.0.1] - 2024-03-26
 
 ### Bug fixes
+- Do not ignore an empty string/nil values as caps
+
+
+## [8.0.0] - 2024-03-08
 
 ### Deprecations
+- Removed deprecated methods
+    - `launch_app`, `close_app` and `reset`
+        - Please use `activate_app`, `terminate_app`, or launch/activate/terminate commands by `mobile:` command
+    - `TouchAction`, `MultiTouch`
+        - Please refer to W3C WebDriver actions
+        - https://www.rubydoc.info/gems/appium_lib_core/Appium/Core/Base/Bridge#action-instance_method
+    - `immediate_value` and `replace_value`
+    - `end_coverage`
+    - `sessions` and `session_capabilities` since they are not W3C WebDriver spec and already removed from the dependent selenium clients.
+        - To get events info, please use `driver.logs.events` instead
+    - `switch_to_default_context`
+        - Please set proper context instead
 
-## [4.0.0] - 2020-12-19
+## [7.5.0] - 2024-02-21
+- Remove upper limitation in `selenium-webdriver`
+    - Users can control the version in their Gemfile
+    - ruby_lib_core will fix when the future release requires changes
 
-Supported Ruby version is 2.4+
+## [7.4.0] - 2024-01-23
 
-### Enhancements
+### Enhancement
+- Bump `selenium-webdriver` max
+
+### Deprecatioons
+- Removed deprecated `core#platform_version` and `core#write_session_id`
+    - Please refer to the capabilities' value and `driver.session_id`
+
+## [7.3.2] - 2023-11-08
 
 ### Bug fixes
+- Fix default value fo set context
+
+## [7.3.1] - 2023-11-04
+### Enhancements
+- Bump `selenium-webdriver` max
+
+## [7.3.0] - 2023-10-17
 
 ### Deprecations
-- No longer work with `forceMjsonwp` capability to force the session MJSONWP
+- Add deprecation marks that will be removed from Appium or this library to move to extension commands such as `mobile:`
+    - https://github.com/appium/ruby_lib_core/pull/504
 
-## [3.11.1] - 2020-11-20
+## [7.2.0] - 2023-10-13
 
 ### Enhancements
+- Append `selenium-webdriver` `4.12` support
 
-### Bug fixes
-- Fix `install_app` to be able to set no args for options
+## [7.1.1] - 2023-10-01
 
 ### Deprecations
 
-## [3.11.0] - 2020-08-01
+- Add deprecation marks in `immediate_value` and `replace_value`
+
+## [7.1.0] - 2023-08-15
 
 ### Enhancements
-- Security update [GHSA-2v5c-755p-p4gv](https://github.com/advisories/GHSA-2v5c-755p-p4gv)
-    - Affects only _::Appium::Core::WebSocket_
+- Append `selenium-webdriver` `4.11` support
+
+## [7.0.0] - 2023-06-17
+
+### Deprecations
+
+- Drop Ruby 2.7 support
+
+## [6.5.0] - 2023-06-11
+
+### Enhancements
+- Append `selenium-webdriver` `4.10` support
+
+## [6.4.2] - 2023-06-07
+
+### Enhancements
+- Simplify internal http client implementation a bit
+
+## [6.4.1] - 2023-05-13
 
 ### Bug fixes
+- Fixed `driver.execute_cdp` command error in a chrome session
+
+## [6.4.0] - 2023-04-30
+
+### Enhancements
+- Append `selenium-webdriver` `4.9` support
+
+## [6.3.0] - 2023-03-14
+
+### Enhancements
+- Support custom listener
+    - e.g. A listener named `CustomListener` which inherits `::Selenium::WebDriver::Support::AbstractEventListener` can set as `appium_lib: { listener: CustomListener.new}` capability
+
+## [6.2.1] - 2023-03-09
+
+### Enhancements
+- Add `uia_device_orientation_landscaperight` and `uia_device_orientation_portrait_upsidedown` symbols in the `drivede.rotation=`
+- Add `drivede.orientation=` as a syntax sugar of `drivede.rotation=`
+
+
+## [6.2.0] - 2023-01-26
+
+### Enhancements
+
+- Append `selenium-webdriver` `4.8` support
+- Add `::Appium::Location` since `::Selenium::WebDriver::Location` no longer exists
 
 ### Deprecations
 
-## [3.10.1] - 2020-06-29
+- `::Selenium::WebDriver::Location` is deprecated in favor of `::Appium::Location` in Appium Ruby binding
+
+
+## [6.1.0] - 2023-01-18
+
+### Bug fixes
+- `Element#immediate_value` sends `text` as the request body
+
+## [6.0.0] - 2022-12-25
+- Remove iOS/UiAutomation classes
+    - The version may work for iOS 8. XCUITest driver will be the default behavior for iOS.
+
+## [5.8.0] - 2022-12-11
+
+### Enhancements
+- Add `::Appium::Core::Driver#attach_to` to generate a driver instance which has the given session id.
+    - The primary usage is for debugging to attach to an existing session.
+
+## [5.7.0] - 2022-12-02
 
 ### Enhancements
+- Allow selenium webdriver version 4.7 [#423](https://github.com/appium/ruby_lib_core/pull/423)
+
+## [5.6.0] - 2022-11-08
+
+### Enhancements
+- Append `selenium-webdriver` `4.6` support
+
+## [5.5.2] - 2022-10-11
 
 ### Bug fixes
-- Fix duplication warning of `execute_cdp`
+- Fix wrong deprecation message
+
+## [5.5.1] - 2022-10-10
+
+### Bug fixes
+- Keep converting String to Symbol for `capabilities`, `caps` and `appium_lib` for the backward compatibility
+- Wrong `automationName` and `platformName` detection in this library before starting a session
 
 ### Deprecations
+- Converting `capabilities`, `caps` and `appium_lib` from String to Symbol
+    - They are expected to be Symbol. Nothing affects existing users who already give the above keys as Symbol for `Appium::Core.for`.
 
-## [3.10.0] - 2020-06-09
+## [5.5.0] - 2022-10-09
+
+### Bug fixes
+- Removed forcefully converting keys of capabilities into symbol, which caused unexpected capabilities format issue [ruby_lib/945](https://github.com/appium/ruby_lib/issues/945)
+
+## [5.4.0] - 2022-10-01
 
 ### Enhancements
-- Remove deprecated `Selenium::WebDriver::Error::TimeOutError`
+- Append `selnium-webdriver` `4.5` support
+
+## [5.3.0] - 2022-08-10
+
+### Enhancements
+
+- Allow selenium webdriver version 4.4 [#404](https://github.com/appium/ruby_lib_core/pull/404)
+
+## [5.2.2] - 2022-06-26
+
+### Enhancements
+- Relax the selenium webdriver version restriction of `4.2.0`
+
+### Bug fixes
+- Remove undefined module in selenium webdriver version `4.3.0`
+
+## [5.2.1] - 2022-06-24
+
+### Bug fixes
+- Restrict the selenium webdriver version to `4.2.0`
+
+## [5.2.0] - 2022-06-19
+
+### Enhancements
+
+- Update base Selenium Ruby client to `4.2+`
+  - Please call `key_action` or set `[::Selenium::WebDriver::Interactions.key('keyboard')]` as the deviecs parameter to build `driver.send_keys().perform` W3C action.
+    - `driver.key_action.send_keys('xxx').perform` instead of `driver.action.send_keys('xxx').perform`, or `driver.action(devices: [::Selenium::WebDriver::Interactions.key('keyboard')]).send_keys('xxx').perform`.
+    - [This PR change](https://github.com/appium/ruby_lib_core/pull/381/files) will help to update your some actions.
+
+## [5.1.2] - 2022-06-02
+
+### Enhancements
+
+- Limit selenium webdriver version less than `4.2`
+
+## [5.1.1] - 2022-04-18
+
+### Enhancements
+
+- Remove unneccessry files from gem package to reduce the size.
+
+## [5.1.0] - 2021-12-25
+
+### Enhancements
+- Make default pointerType `touch` for the pointer in W3C actions instead of `mouse` for Appium
+    - This change should not affect W3C actions
+
+## [5.0.3] - 2021-12-13
+
+### Enhancements
+- Can add more arguments in `install_app`
+    - e.g. Add `timeoutMs` for XCUITest driver as `@driver.install_app("/path/to/test.ipa", timeoutMs: 20000)`
+
+### Bug fixes
+- (internal) Allow to access to `bridge` attribute in `driver` instance for appium_flutter_finder
+
+## [5.0.2] - 2021-12-01
 
 ### Bug fixes
+- (internal) Fix firstMatch format in a new session creation
+
+## [5.0.1] - 2021-11-23
+
+### Enhancements
+- Relaxed version restriction of selenium-webdriver
+
+## [5.0.0] - 2021-11-05
+
+### Enhancements
+
+- Update base selenium webdriver version to `v4`
+  - Base Selenium Ruby binding is now v4
+  - Support only W3C WebDriver spec (and a few Appium specific commands)
+  - Support Ruby 2.6+
+- Add `driver#wait`, `driver#wait_until`, `driver#wait_true`, `driver#wait_until_true` syntaxes
+  - Can give `driver` instance as its block variable
+- `element.id` returns the element id instead of `element.ref`.
+  - `element.ref` now returns an array.
+- Removed `desired_capabilities` as capabilities for `Appium::Core#for`. Please use `capabilities` key name instead.
+  - e.g. `Appium::Core.for capabilities: {...}` instead of `Appium::Core.for desired_capabilities: {...}`
+- Removed methods that had _Deprecated_ mark
+  - Removed `driver#screenshot`. Please use `driver#save_screenshot` instead
+  - Removed `driver#send_keys` to send keys to an active element. Please use `driver.action.send_keys('happy testing').perform` instead
+  - Removed `forceMjsonwp` to send only MJSONWP capabilities since Selenium cleint v4 no longer supports MJSONWP
+- No longer set default `timeouts` as `0`
+  - ruby_lib_core calls `/timeouts` endpoint only when `appium_lib: { wait: 5 }` is provided explicitly
+- Raises `::Appium::Core::Error::ArgumentError` instead of `ArgumentError` for this library specific argument errors
+- Removed Selendroid related methods
 
 ### Deprecations
+- `Appium::Core::TouchAction` and `Appium::Core::MultiTouch` are deprecated
+    - Please use W3C actions instead http://appium.io/docs/en/commands/interactions/actions/
+    - More working examples:
+        - [test/functional/android/webdriver/w3c_actions_test.rb](test/functional/android/webdriver/w3c_actions_test.rb)
+        - [test/functional/ios/webdriver/w3c_actions_test.rb](test/functional/ios/webdriver/w3c_actions_test.rb)
+        - [test/functional/common_w3c_actions.rb](test/functional/common_w3c_actions.rb)
+        - https://www.selenium.dev/documentation/support_packages/mouse_and_keyboard_actions_in_detail/
+        - https://www.youtube.com/watch?v=oAJ7jwMNFVU
+        - https://appiumpro.com/editions/30-ios-specific-touch-action-methods
+        - https://appiumpro.com/editions/29-automating-complex-gestures-with-the-w3c-actions-api
+- `launch_app`, `close_app` and `reset`. Please read [issues#15807](https://github.com/appium/appium/issues/15807) for more details.
+    - `activate_app` or a new session request can be alternatives of `launch_app`
+    - `terminate_app` or close the session request can be alternatives of `close_app`
+    - Close current session and creating a new session, or `terminate_app` and `launch_app` can be alternatives of `reset`
+
+## [4.7.1] - 2021-09-26
+
+### Enhancements
+- Allow to override an existing method by `Appium::Core::Base::Driver#add_command` since Appium drivers/plugins allow to override them
+
+## [4.7.0] - 2021-07-17
+
+### Enhancements
+- Add `satellites` option in `Appium::Core::Base::Driver#set_location`
+
+## [4.6.0] - 2021-06-03
+
+### Enhancements
+- Add `Appium::Core::Base::Driver#add_command` to allow you to add your own command
+
+## [4.5.0] - 2021-03-14
+
+### Enhancements
+- Add `speed` argument for `Appium::Core::Base::Driver#set_location` since Appium 1.21.0
+- Add `multiple` and `match_neighbour_threshold` arguments for `Appium::Core::Base::Driver#find_image_occurrence`
+
+## [4.4.1(4.4.0)] - 2021-02-15(2021-02-13)
+
+### Enhancements
+- Returns `{}` any errors in `Core#appium_server_version` to prevent errors in some cases
+
+## [4.3.1(4.3.0)] - 2021-02-07(2021-02-05)
+
+### Enhancements
+- Add `start_recording_screen` for Mac2 driver
+
+## [4.2.1] - 2021-01-10
+
+### Enhancements
+- Refactor routable
+
+## [4.2.0] - 2021-01-02
+
+### Enhancements
+- Add  `Element#screenshot`, `Element#screenshot_as` and `Element#save_screenshot` in Element module
+    - `Element#screenshot_as` and `Element#save_screenshot` are same as `Driver#element_screenshot_as` and `Driver#save_element_screenshot`
+    - `Element#screenshot` is same as `Element#screenshot_as(:base64)`
+
+## [4.1.1] - 2020-12-25
+
+### Enhancements
+- Ruby 3.0 support
+    - Arguments in `@driver.execute_cdp`
+        - It should be like `@driver.execute_cdp 'Page.captureScreenshot', quality: 50, format: 'jpeg'` as keyword arguments
+          instead of `@driver.execute_cdp 'Page.captureScreenshot', { quality: 50, format: 'jpeg' }` in Ruby 3
+
+## [4.0.0] - 2020-12-19
+
+Supported Ruby version is 2.4+
+
+### Deprecations
+- No longer work with `forceMjsonwp` capability to force the session MJSONWP
+
+## [3.11.1] - 2020-11-20
+
+### Bug fixes
+- Fix `install_app` to be able to set no args for options
+
+## [3.11.0] - 2020-08-01
+
+### Enhancements
+- Security update [GHSA-2v5c-755p-p4gv](https://github.com/advisories/GHSA-2v5c-755p-p4gv)
+    - Affects only _::Appium::Core::WebSocket_
+
+## [3.10.1] - 2020-06-29
+
+### Bug fixes
+- Fix duplication warning of `execute_cdp`
+
+## [3.10.0] - 2020-06-09
+
+### Enhancements
+- Remove deprecated `Selenium::WebDriver::Error::TimeOutError`
 
 ## [3.9.0] - 2020-05-31
 
@@ -86,10 +399,6 @@ Supported Ruby version is 2.4+
     @driver = Appium::Core.for(opts).start_driver
     ```
 
-### Bug fixes
-
-### Deprecations
-
 ## [3.8.0] - 2020-05-17
 
 ### Enhancements
@@ -99,8 +408,6 @@ Supported Ruby version is 2.4+
 ### Bug fixes
 - Fix `x-idempotency-key` header to add it only in new session request (https://github.com/appium/ruby_lib_core/issues/262)
 
-### Deprecations
-
 ## [3.7.0] - 2020-04-18
 
 ### Enhancements
@@ -109,76 +416,44 @@ Supported Ruby version is 2.4+
 - Add chrome devtools endpoint which is available chrome module in Selenium Ruby binding
     - https://github.com/appium/appium-base-driver/pull/405
 
-### Bug fixes
-
-### Deprecations
-
 ## [3.6.1, 3.6.0] - 2020-03-15
 
 ### Enhancements
 - Add screen record feature for Windows driver (https://github.com/appium/appium-windows-driver/pull/66)
     - `#start_recording_screen`, `#stop_recording_screen`
 
-### Bug fixes
-
-### Deprecations
-
 ## [3.5.0] - 2020-01-11
 
 ### Enhancements
 - Add `:viewmatcher` selector like `@driver.find_elements :view_matcher, { name: 'withText', args: %w(Accessibility), class: 'androidx.test.espresso.matcher.ViewMatchers' }`
 
-### Bug fixes
-
-### Deprecations
-
 ## [3.4.2] - 2019-12-29
 
 ### Enhancements
 - Add `attr_reader :bridge` for flutter driver not to use `send`
    - https://github.com/truongsinh/appium-flutter-driver/pull/35
 
-### Bug fixes
-
-### Deprecations
-
 ## [3.4.0, 3.4.1] - 2019-12-26, 2019-12-27
 
 ### Enhancements
 - Fix Ruby 2.7 warnings
 
-### Bug fixes
-
-### Deprecations
-
 ## [3.3.0] - 2019-11-08
 
 ### Enhancements
 - Add `Logs#event` to post a custom log by `@driver.logs.event vendor: 'appium', event: 'funEvent'`
 - Add `Logs#events` to get events by `@driver.logs.events`. It is equal to  `@driver.session_capabilities['events']`
 
-### Bug fixes
-
-### Deprecations
-
 ## [3.2.3] - 2019-09-30
 
 ### Enhancements
 - Add `system_bars` as an alias to `get_system_bars`
 
-### Bug fixes
-
-### Deprecations
-
 ## [3.2.2] - 2019-08-04
 
-### Enhancements
-
 ### Bug fixes
 - Fixed parameters of `remove_app`
 
-### Deprecations
-
 ## [3.2.1] - 2019-07-19
 
 ### Enhancements
@@ -200,39 +475,23 @@ Supported Ruby version is 2.4+
 - Add `execute_driver` to run a batch script
     - It requires Appium version which has `execute_driver` support
 
-### Bug fixes
-
-### Deprecations
-
 ## [3.1.3] - 2019-06-18
 
 ### Enhancements
 - Add arguments for `start_activity`
     - `intentAction`, `intentCategory`, `intentFlags`, `dontStopAppOnReset`
 
-### Bug fixes
-
-### Deprecations
-
 ## [3.1.2] - 2019-05-10
 
 ### Enhancements
 - Add `sessions` command to get all available sessions on the Appium server
 - [internal] Tweak error messages in emulator module
 
-### Bug fixes
-
-### Deprecations
-
 ## [3.1.1] - 2019-04-26
 
 ### Enhancements
 - [internal] Catch `Selenium::WebDriver::Error::TimeoutError` which will be used instead of `Selenium::WebDriver::Error::TimeOutError`
 
-### Bug fixes
-
-### Deprecations
-
 ## [3.1.0] - 2019-03-31
 
 ### Enhancements
@@ -240,28 +499,16 @@ Supported Ruby version is 2.4+
     - `platformName: :tvos, automationName: :xcuitest` can work for iOS tvOS
     - It requires Appium 1.13
 
-### Bug fixes
-
-### Deprecations
-
 ## [3.0.4] - 2019-03-24
 
 ### Enhancements
 - Add `pixelFormat` argument in screen record for iOS
 
-### Bug fixes
-
-### Deprecations
-
 ## [3.0.3] - 2019-03-11
 
 ### Enhancements
 - [internal] Bump Rubocop target Ruby version to Ruby 2.3
 
-### Bug fixes
-
-### Deprecations
-
 ## [3.0.2] - 2019-03-07
 
 ### Enhancements
@@ -271,17 +518,11 @@ Supported Ruby version is 2.4+
 - [internal] Fixed typo in `Emulator#gsm_signal` [#196](https://github.com/appium/ruby_lib_core/pull/196)
     - Thanks [khanhdodang](https://github.com/khanhdodang)
 
-### Deprecations
-
 ## [3.0.1] - 2019-02-25
 
 ### Enhancements
 - Add `:data_matcher` find_element/s attribute [appium-espresso-driver#386](https://github.com/appium/appium-espresso-driver/pull/386)
 
-### Bug fixes
-
-### Deprecations
-
 ## [3.0.0] - 2019-02-06
 
 This release has a breaking change about an implicit wait.
@@ -307,8 +548,6 @@ The behaviour follows the default spec in WebDriver.
 ### Bug fixes
 - Fix potential override of `AppManagement#background_app` [#188](https://github.com/appium/ruby_lib_core/pull/188)
 
-### Deprecations
-
 ## [2.3.4] - 2019-01-31
 ### Enhancements
 - Add 3D touch option for `TouchAction#press` [appium/WebDriverAgent#79](https://github.com/appium/WebDriverAgent/pull/79)
@@ -317,16 +556,10 @@ The behaviour follows the default spec in WebDriver.
 ### Bug fixes
 - Stop sending blank value in `start_activity`
 
-### Deprecations
-
 ## [2.3.3] - 2019-01-22
-### Enhancements
-
 ### Bug fixes
 - Add `*args, &block` in method missing in `Selenium::WebDriver::Element` [#184](https://github.com/appium/ruby_lib_core/pull/184)
 
-### Deprecations
-
 ## [2.3.2] - 2019-01-20
 ### Enhancements
 - Add alias for some method calls
@@ -337,18 +570,12 @@ The behaviour follows the default spec in WebDriver.
 ### Bug fixes
 -  `ServerError` inherits `CoreError` in order to handle it as an exception
 
-### Deprecations
-
 ## [2.3.1] - 2019-01-13
 ### Enhancements
 - `set_network_connection` accepts keys as same as `network_connection_type` in addition to numbers
     - `{ :airplane_mode: 1, wifi: 2, data: 4, all: 6, none: 0 }`
     - Read [documentation](https://www.rubydoc.info/github/appium/ruby_lib_core/master/Appium/Core/Android/Device#set_network_connection-instance_method) more
 
-### Bug fixes
-
-### Deprecations
-
 ## [2.3.0] - 2019-01-07
 ### Enhancements
 - Use `Base64.strict_encode64` when this client sends `Base64` encoded data to server
@@ -356,33 +583,19 @@ The behaviour follows the default spec in WebDriver.
     - Continues to decode base 64 data following `decode64` to accept RFC 2045 format
 - Add `query_app_state` as an alias of `app_state` to get application status
 
-### Bug fixes
-
-### Deprecations
-
 ## [2.2.2] - 2018-12-22
 ### Enhancements
 - Append `appium` in header: `appium/ruby_lib_core/2.2.1 (selenium/3.141.0 (ruby macosx))`
 
-### Bug fixes
-
-### Deprecations
-
 ## [2.2.1] - 2018-12-08
-### Enhancements
-
 ### Bug fixes
 - Reduce warnings for method definitions
 
-### Deprecations
-
 ## [2.2.0] - 2018-12-01
 ### Enhancements
 - Add `::Appium::Core::Base.platform` to call `::Selenium::WebDriver::Platform`
     - Can identify platform using `::Appium::Core::Base.platform.windows?` for example
 
-### Bug fixes
-
 ### Deprecations
 - `:offset_x` and `:offset_y` in `TouchAction#swipe` is deprecated in favor of `:end_x` and `:end_y`
 
@@ -401,10 +614,6 @@ The behaviour follows the default spec in WebDriver.
 - Update `start_recording_screen` for iOS, Appium 1.10.0
     - Add `:video_scale` and update `:video_type`
 
-### Bug fixes
-
-### Deprecations
-
 ## [2.1.0] - 2018-11-14
 ### Enhancements
 - Support below style _1_, has _url_ parameter, in addition to style _2_
@@ -417,27 +626,15 @@ The behaviour follows the default spec in WebDriver.
     ```
 - Add `:video_fps` param for screen recording in iOS(XCUITest) to sync with Appium 1.10.0
 
-### Bug fixes
-
-### Deprecations
-
 ## [2.0.6] - 2018-11-08
 ### Enhancements
 - Allow selenium update following Pi versioning like 3.141.0
 - [internal] Update dev libraries
 
-### Bug fixes
-
-### Deprecations
-
 ## [2.0.5] - 2018-10-30
 ### Enhancements
 - [internal] No longer send `strategy: :tapOutside` as default value in Android
 
-### Bug fixes
-
-### Deprecations
-
 ## [2.0.4] - 2018-10-19
 ### Enhancements
 - Add custom locator in the future work: [element-finding-plugins](https://github.com/appium/appium/blob/master/docs/en/advanced-concepts/element-finding-plugins.md)
@@ -447,27 +644,15 @@ The behaviour follows the default spec in WebDriver.
 
     ```
 
-### Bug fixes
-
-### Deprecations
-
 ## [2.0.3] - 2018-10-11
 ### Enhancements
 - Set `'selenium-webdriver', '~> 3.14.1'`
 
-### Bug fixes
-
-### Deprecations
-
 ## [2.0.2] - 2018-10-02
 ### Enhancements
 - Add finger print feature for Android emulators [#13](https://github.com/appium/ruby_lib_core/issues/13)
 - Add `keyboard_shown?` and `context=` as aliases of `is_keyboard_shown` and `set_contex`
 
-### Bug fixes
-
-### Deprecations
-
 ## [2.0.1] - 2018-09-01
 ### Enhancements
 - Add `Appium::Core::Base::Driver#perform_actions` to send multiple actions. See `test_multiple_actions` as an example.
@@ -475,8 +660,6 @@ The behaviour follows the default spec in WebDriver.
 ### Bug fixes
 - Fix desired capability for W3C protocol under selenium grid environment [#137](https://github.com/appium/ruby_lib_core/issues/137)
 
-### Deprecations
-
 ## [2.0.0] - 2018-08-25
 
 This release has a breaking change for creating core. Thus, I've bumped the major version.
@@ -484,20 +667,14 @@ This release has a breaking change for creating core. Thus, I've bumped the majo
 ### Enhancements
 - use `autoload` to load Android/iOS modules
 
-### Bug fixes
-
 ### Deprecations
 - `@core = Appium::Core.for(self, opts)` is deprecated in favor of `@core = Appium::Core.for(opts)`
     - Call `extend Appium::Core::Device` if you'd like to extend methods defined in `Appium::Core`
         - Read [#816](https://github.com/appium/ruby_lib/pull/816) as an example
 
 ## [1.9.2] - 2018-08-23
-### Enhancements
-
 ### Bug fixes
-- fix unexpedted method missing against `:to_hash` in Element
-
-### Deprecations
+- fix unexpected method missing against `:to_hash` in Element
 
 ## [1.9.1] - 2018-08-20
 ### Enhancements
@@ -507,8 +684,6 @@ This release has a breaking change for creating core. Thus, I've bumped the majo
 ### Bug fixes
 - [internal] Fix raising error in `set_implicit_wait_by_default` [#130](https://github.com/appium/ruby_lib_core/issues/130)
 
-### Deprecations
-
 ## [1.9.0] - 2018-08-05
 ### Enhancements
 - Update documentation about `start_recording_screen`
@@ -516,8 +691,6 @@ This release has a breaking change for creating core. Thus, I've bumped the majo
 - 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`
 
@@ -527,10 +700,6 @@ This release has a breaking change for creating core. Thus, I've bumped the majo
 - Use method missing to get attributes like `e.resource_id` instead of `e.attribute 'resource-id'` [#116](https://github.com/appium/ruby_lib_core/pull/116)
 - Set `'~> 3.5', '< 3.14'`
 
-### Bug fixes
-
-### Deprecations
-
 ## [1.8.3] - 2018-07-20
 ### Enhancements
 - Relax the logic of `:app` capability
@@ -538,11 +707,7 @@ This release has a breaking change for creating core. Thus, I've bumped the majo
 ### Bug fixes
 - Fix `within_context`
 
-### Deprecations
-
 ## [1.8.2] - 2018-07-17
-### Enhancements
-
 ### Bug fixes
 - Available packages over HTTP [#106](https://github.com/appium/ruby_lib_core/issues/106)
 
@@ -550,23 +715,15 @@ This release has a breaking change for creating core. Thus, I've bumped the majo
 - Remove warning of camelCase capability for W3C format
 
 ## [1.8.1] - 2018-07-13
-### Enhancements
-
 ### Bug fixes
 - Fix including search context in `::Selenium::WebDriver::Elemenet`
     - `include ::Appium::Core::Base::SearchContext` instead of `::Selenium::WebDriver::SearchContext`
 
-### Deprecations
-
 ## [1.8.0] - 2018-07-07
 ### Enhancements
 - Add Tizen case
 - [Internal] reduce method definition by `add_endpoint_method`
 
-### Bug fixes
-
-### Deprecations
-
 ## [1.7.2] - 2018-06-23
 ### Enhancements
 - Add `find_element_by_image` and `find_elements_by_image` to handle `ImageElement`
@@ -575,10 +732,6 @@ This release has a breaking change for creating core. Thus, I've bumped the majo
    - Experimental feature
 - [Internal] Define screenshot methods in appium_lib_core instead of Selenium's one
 
-### Bug fixes
-
-### 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)
@@ -586,8 +739,6 @@ This release has a breaking change for creating core. Thus, I've bumped the majo
 ### Bug fixes
 - Return empty array `[]` for find_elements
 
-### Deprecations
-
 ## [1.7.0] - 2018-05-28
 ### Enhancements
 - Has one **Breaking Change**
@@ -600,10 +751,6 @@ This release has a breaking change for creating core. Thus, I've bumped the majo
 - [Internal] Change directory and file structure
 - [Internal] Set default content-type
 
-### Bug fixes
-
-### Deprecations
-
 ## [1.6.0] - 2018-05-08
 ### Enhancements
 - **Breaking Change**
@@ -615,36 +762,22 @@ This release has a breaking change for creating core. Thus, I've bumped the majo
 - add `battery_info` to get battery information
 - add `is_keyboard_shown` for iOS ( see also https://github.com/appium/appium-xcuitest-driver/pull/664/files )
 
-### Bug fixes
-
-### Deprecations
-
 ## [1.5.1] - 2018-04-25
-### Enhancements
-
 ### Bug fixes
 - Revert timeout logic in `1.4.1`
 
-### Deprecations
-
 ## [1.5.0] - 2018-04-25
 ### Enhancements
 - [internal] Remove hot fix for XCUITest action
 
-### Bug fixes
-
 ### Deprecations
 - Changed the name of arguments
     - `swipe(start_x:, start_y:, end_x:, end_y:)` instead of `swipe(start_x:, start_y:, offset_x:, offset_y:)`
 
 ## [1.4.2] - 2018-04-22
-### Enhancements
-
 ### Bug fixes
 - Revert `delegate_from_appium_driver` for `ruby_lib` compatibility
 
-### Deprecations
-
 ## [1.4.1] - 2018-04-22
 ### Enhancements
 - add base image comparison
@@ -653,54 +786,30 @@ This release has a breaking change for creating core. Thus, I've bumped the majo
     - Raise `::Appium::Core::Wait::TimeoutError` instead of `::Selenium::WebDriver::Error::TimeOutError`
 - [internal] Separate mjsonwp commands module and w3c commands module from one command module
 
-### Bug fixes
-
-### Deprecations
-
 ## [1.4.0] - 2018-04-15
 ### Enhancements
 - Add a support for WebSocket client based on Faye::WebSocket::Client [#74](https://github.com/appium/ruby_lib_core/pull/74)
 
-### Bug fixes
-
-### Deprecations
-
 ## [1.3.8] - 2018-04-12
 ### Enhancements
 - Make no-argument commands friendly for IDE
 
-### Bug fixes
-
-### Deprecations
-
 ## [1.3.7] - 2018-04-02
 ### Enhancements
 - Only for `ruby_lib_core` internal process
     - Remove `touch` action by default and following `selenium-webdriver` in W3C action.
         - Since XCUITest and UA2 drivers force handling the pointer as `touch`.
 
-### Bug fixes
-
-### Deprecations
-
 ## [1.3.6] - 2018-04-01
 ### Enhancements
 - Be able to change `kind` in W3C touch action.
     - Read: https://github.com/appium/ruby_lib_core/blob/master/lib/appium_lib_core/common/base/bridge/w3c.rb#L29
 
-### Bug fixes
-
-### Deprecations
-
 ## [1.3.5] - 2018-03-30
 ### Enhancements
 - Add a `bug_report` option in `start_recording_screen`, Android
 - Add clipboard apis [#69](https://github.com/appium/ruby_lib_core/pull/69)
 
-### Bug fixes
-
-### Deprecations
-
 ## [1.3.4] - 2018-03-21
 ### Enhancements
 - Add `save_viewport_screenshot` which get screenshot except for status bar.
@@ -710,16 +819,10 @@ This release has a breaking change for creating core. Thus, I've bumped the majo
 ### Bug fixes
 - Fix _create_session attempt to throw non-existent error type Appium::Core::Error::WebDriverError_ [#66](https://github.com/appium/ruby_lib_core/issues/66)
 
-### Deprecations
-
 ## [1.3.3] - 2018-03-03
 ### Enhancements
 - add `session_capabilities`: https://appium.io/docs/en/commands/session/get/
 
-### Bug fixes
-
-### Deprecations
-
 ## [1.3.2] - 2018-02-18
 ### Enhancements
 - Add Android emulator commands
@@ -727,10 +830,6 @@ This release has a breaking change for creating core. Thus, I've bumped the majo
 - Add toggles
     - `toggle_location_services`, `toggle_wifi`, `toggle_data`
 
-### Bug fixes
-
-### Deprecations
-
 ## [1.3.1] - 2018-02-14
 ### Enhancements
 - add some app management commands [#58](https://github.com/appium/ruby_lib_core/pull/58)
@@ -752,10 +851,6 @@ This release has a breaking change for creating core. Thus, I've bumped the majo
               .perform
             ```
 
-### Bug fixes
-
-### Deprecations
-
 ## [1.3.0] - 2018-01-28
 ### Enhancements
 - `start_recording_screen`/`stop_recording_screen` support iOS from `Appium 1.8.0` [#48](https://github.com/appium/ruby_lib_core/issues/48)
@@ -763,10 +858,6 @@ This release has a breaking change for creating core. Thus, I've bumped the majo
         - `start_recording_screen`
             - The argument, `file_path`, was removed.
 
-### Bug fixes
-
-### Deprecations
-
 ## [1.2.7] - 2018-01-25
 ### Enhancements
 - Print warning messages to use camelCase if capability key names are snake_case
@@ -775,8 +866,6 @@ This release has a breaking change for creating core. Thus, I've bumped the majo
 ### Bug fixes
 - Make `@driver.automation_name` downcase [#50](https://github.com/appium/ruby_lib_core/issues/50)
 
-### Deprecations
-
 ## [1.2.6] - 2018-01-21
 ### Enhancements
 - Add `window_rect`
@@ -784,17 +873,11 @@ This release has a breaking change for creating core. Thus, I've bumped the majo
 ### Bug fixes
 - Make `@driver.automation_name` symbol when someone define the `automationName` with the server argument. [#50](https://github.com/appium/ruby_lib_core/issues/50)
 
-### Deprecations
-
 ## [1.2.5] - 2018-01-13
 ### Enhancements
 - Enhance W3C support
     - Timeout related methods
 
-### Bug fixes
-
-### Deprecations
-
 ## [1.2.4] - 2018-01-03
 ### Enhancements
 - Refactor `create_session` in `Appium::Core::Base::Bridge`
@@ -806,34 +889,18 @@ This release has a breaking change for creating core. Thus, I've bumped the majo
     - Read `lib/appium_lib_core/common/base/w3c_bridge.rb` for more details
 - Can get logs like `driver.logs.available_types` and `driver.logs.get`
 
-### Bug fixes
-
-### Deprecations
-
 ## [1.2.3] - 2017-12-27
-### Enhancements
-
 ### Bug fixes
 - Fix some w3c methods to work with Appium part 2 [#38](https://github.com/appium/ruby_lib_core/pull/38)
 
-### Deprecations
-
 ## [1.2.2] - 2017-12-25
-### Enhancements
-
 ### Bug fixes
 - Fix some w3c methods to work with Appium [#37](https://github.com/appium/ruby_lib_core/pull/37)
 
-### Deprecations
-
 ## [1.2.1] - 2017-12-23
 ### Enhancements
 - override default duration to make some action fast [#36](https://github.com/appium/ruby_lib_core/pull/36)
 
-### Bug fixes
-
-### Deprecations
-
 ## [1.2.0] - 2017-12-23
 ### Enhancements
 - Append `appium:` prefix for capabilities automatically due to W3C format.
@@ -842,10 +909,6 @@ This release has a breaking change for creating core. Thus, I've bumped the majo
     - IME related
     - Touch actions based on W3C spec
 
-### Bug fixes
-
-### Deprecations
-
 ## [1.1.0] - 2017-12-16
 ### Enhancements
 - Add guidelines in `.github`
@@ -854,8 +917,6 @@ This release has a breaking change for creating core. Thus, I've bumped the majo
 ### Bug fixes
 - fix creating sessions [#31](https://github.com/appium/ruby_lib_core/pull/31) for W3C creating sessions
 
-### Deprecations
-
 ## [1.0.0] - 2017-11-12
 
 Initial release