From b798e601dcb1245f9af3ec5990cf9b7c3b6ba6bb Mon Sep 17 00:00:00 2001
From: Edgars Eglitis <edgars.eglitis@testdevlab.com>
Date: Mon, 3 Jun 2024 12:47:39 +0300
Subject: [PATCH] feat: add update_settings type

---
 README.md          | 29 +++++++++++++++++++----------
 lib/core/device.rb |  7 +++++++
 2 files changed, 26 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index 47b14ef7..e429fce3 100644
--- a/README.md
+++ b/README.md
@@ -327,18 +327,19 @@ Roles are ALWAYS defined at the begining of the cases. You have to write always
 1. [set_orientation](#set_orientation)
 2. [close_app](#close_app)
 3. [launch_app](#launch_app)
-4. [start_record/end_record](#start_record/end_record)
-5. [tap_by_coord](#tap_by_coord)
-6. [press](#press)
-7. [click_and_hold](#click_and_hold)
-8. [swipe_up/swipe_down](#swipe_up/swipe_down)
-9. [swipe_elements](#swipe_elements)
-10. [swipe_coord](#swipe_coord)
-11. [click_coord](#click_coord)
-12. [clipboard](#clipboard)
-13. [terminate_app](#terminate_app)
+4. [terminate_app](#terminate_app)
+5. [start_record/end_record](#start_record/end_record)
+6. [tap_by_coord](#tap_by_coord)
+7. [press](#press)
+8. [click_and_hold](#click_and_hold)
+9. [swipe_up/swipe_down](#swipe_up/swipe_down)
+10. [swipe_elements](#swipe_elements)
+11. [swipe_coord](#swipe_coord)
+12. [click_coord](#click_coord)
+13. [clipboard](#clipboard)
 14. [notifications](#notifications)
 15. [back](#back)
+16. [update_settings](#update_settings)
 
 ## API
 
@@ -823,6 +824,14 @@ Works as pressing the button `back` on the phone to go to the previous screen.
   	- Type: back
       Role: role1 (Optional. if not specified will use the first one defined in the case Roles)
 
+### <a id="update_settings"></a>update_settings
+
+Updates Appium driver settings. The value must be provided as a JSON object. JSON keys can be optionally placed in quotes.
+
+    - Type: update_settings
+      Role: role1 (Optional. if not specified will use the first one defined in the case Roles)
+      Value: { waitForIdleTimeout: 10, 'allowInvisibleElements': true, "elementResponseAttributes": "name" }
+
 ## API
 
 ### <a id="get_call"></a>get_call
diff --git a/lib/core/device.rb b/lib/core/device.rb
index 5fffecbc..5e869187 100644
--- a/lib/core/device.rb
+++ b/lib/core/device.rb
@@ -275,6 +275,13 @@ def terminate_app(action)
     end
   end
 
+  # updates Appium driver settings
+  # Accepts:
+  #   Value
+  def update_settings(action)
+    @driver.update_settings(convert_yaml(action["Value"]))
+  end
+
   # starts recording test execution. Whole desktop is recorded if 'udid' is not
   # set.
   # Accepts: