Add option to choose the Chromium browser binary location

Author: mdmintz

README.md

@@ -524,6 +524,7 @@ pytest my_first_test.py --pdb
 --firefox-pref=SET  # (Set a Firefox preference:value set, comma-separated.)
 --extension-zip=ZIP  # (Load a Chrome Extension .zip|.crx, comma-separated.)
 --extension-dir=DIR  # (Load a Chrome Extension directory, comma-separated.)
+--binary-location=PATH  # (Set path of the Chromium browser binary to use.)
 --sjw  # (Skip JS Waits for readyState to be "complete" or Angular to load.)
 --pls=PLS  # (Set pageLoadStrategy on Chrome: "normal", "eager", or "none".)
 --headless  # (Run tests in headless mode. The default arg on Linux OS.)

examples/raw_parameter_script.py

@@ -102,6 +102,7 @@
     sb.dashboard = False
     sb._dash_initialized = False
     sb.message_duration = None
+    sb.binary_location = None
     sb.enable_3d_apis = False
     sb.block_images = False
     sb.do_not_track = False

help_docs/customizing_test_runs.md

@@ -132,6 +132,7 @@ pytest my_first_test.py --settings-file=custom_settings.py
 --firefox-pref=SET  # (Set a Firefox preference:value set, comma-separated.)
 --extension-zip=ZIP  # (Load a Chrome Extension .zip|.crx, comma-separated.)
 --extension-dir=DIR  # (Load a Chrome Extension directory, comma-separated.)
+--binary-location=PATH  # (Set path of the Chromium browser binary to use.)
 --sjw  # (Skip JS Waits for readyState to be "complete" or Angular to load.)
 --pls=PLS  # (Set pageLoadStrategy on Chrome: "normal", "eager", or "none".)
 --headless  # (Run tests in headless mode. The default arg on Linux OS.)

seleniumbase/behave/behave_sb.py

@@ -38,6 +38,7 @@
 -D firefox-pref=SET  (Set a Firefox preference:value set, comma-separated.)
 -D extension-zip=ZIP  (Load a Chrome Extension .zip|.crx, comma-separated.)
 -D extension-dir=DIR  (Load a Chrome Extension directory, comma-separated.)
+-D binary-location=PATH  (Set path of the Chromium browser binary to use.)
 -D sjw  (Skip JS Waits for readyState to be "complete" or Angular to load.)
 -D pls=PLS  (Set pageLoadStrategy on Chrome: "normal", "eager", or "none".)
 -D headless  (Run tests in headless mode. The default arg on Linux OS.)
@@ -160,6 +161,7 @@ def get_configured_sb(context):
     sb.device_metrics = None
     sb.extension_zip = None
     sb.extension_dir = None
+    sb.binary_location = None
     sb.page_load_strategy = None
     sb.database_env = "test"
     sb.log_path = "latest_logs" + os.sep
@@ -441,6 +443,13 @@ def get_configured_sb(context):
                 extension_dir = sb.extension_dir  # revert to default
             sb.extension_dir = extension_dir
             continue
+        # Handle: -D binary-location=PATH / binary_location=PATH
+        if low_key in ["binary-location", "binary_location"]:
+            binary_location = userdata[key]
+            if binary_location == "true":
+                binary_location = sb.binary_location  # revert to default
+            sb.binary_location = binary_location
+            continue
         # Handle: -D pls=PLS / page-load-strategy=PLS / page_load_strategy=PLS
         if low_key in ["pls", "page-load-strategy", "page_load_strategy"]:
             page_load_strategy = userdata[key].lower()