seleniumbase 4.26.1__tar.gz → 4.26.2__tar.gz

{seleniumbase-4.26.1 → seleniumbase-4.26.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: seleniumbase
-Version: 4.26.1
+Version: 4.26.2
 Summary: A complete web automation framework for end-to-end testing.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz

{seleniumbase-4.26.1 → seleniumbase-4.26.2}/help_docs/method_summary.md

@@ -294,6 +294,7 @@ self.get_new_driver(
     enable_3d_apis=None,
     swiftshader=None,
     ad_block_on=None,
+    host_resolver_rules=None,
     block_images=None,
     do_not_track=None,
     chromium_arg=None,
@@ -302,6 +303,7 @@ self.get_new_driver(
     user_data_dir=None,
     extension_zip=None,
     extension_dir=None,
+    disable_features=None,
     binary_location=None,
     driver_version=None,
     page_load_strategy=None,
@@ -938,7 +940,7 @@ self._print(TEXT)  # Calls Python's print() / Allows for translations
 
 ############
 
-# "driver"-specific methods added by SeleniumBase
+# "driver"-specific methods added (or modified) by SeleniumBase
 
 driver.default_get(url)  # Because driver.get(url) works differently in UC Mode
 
@@ -970,6 +972,10 @@ driver.assert_text(text, selector)
 
 driver.assert_exact_text(text, selector)
 
+driver.find_element(selector)
+
+driver.find_elements(selector)
+
 driver.wait_for_element(selector)
 
 driver.wait_for_element_visible(selector)
@@ -1028,25 +1034,25 @@ driver.switch_to_frame(frame)
 
 ############
 
-# "driver"-specific methods added by SeleniumBase for UC Mode: "--uc" / uc=True
+# "driver"-specific methods added (or modified) by SeleniumBase for UC Mode:
+
+driver.get(url)  # If UC Mode and site detects bots, then uc_open_with_tab(url)
 
-driver.uc_open(url)
+driver.uc_open(url)  # (Open in same tab with default reconnect_time)
 
-driver.uc_open_with_tab(url)
+driver.uc_open_with_tab(url)  # (New tab with default reconnect_time)
 
-driver.uc_open_with_reconnect(url, reconnect_time=None)
+driver.uc_open_with_reconnect(url, reconnect_time=None)  # (New tab)
 
-driver.reconnect(timeout)
+driver.reconnect(timeout)  # disconnect() + sleep(timeout) + connect()
 
-driver.disconnect()
+driver.disconnect()  # Stops the webdriver service to prevent detection
 
-driver.connect()
+driver.connect()  # Starts the webdriver service to allow actions again
 
-driver.uc_click(
-    selector, by="css selector",
-    timeout=settings.SMALL_TIMEOUT, reconnect_time=None)
+driver.uc_click(selector)  # A stealthy click for evading bot-detection
 
-driver.uc_switch_to_frame(frame, reconnect_time=None)
+driver.uc_switch_to_frame(frame)  # switch_to_frame() in a stealthy way
 ```
 
 --------

{seleniumbase-4.26.1 → seleniumbase-4.26.2}/seleniumbase/__version__.py

@@ -1,2 +1,2 @@
 # seleniumbase package
-__version__ = "4.26.1"
+__version__ = "4.26.2"

{seleniumbase-4.26.1 → seleniumbase-4.26.2}/seleniumbase/plugins/driver_manager.py

@@ -328,6 +328,12 @@ def Driver(
     ):
         recorder_mode = True
         recorder_ext = True
+    if headed is None:
+        # Override the default headless mode on Linux if set.
+        if "--gui" in sys_argv or "--headed" in sys_argv:
+            headed = True
+        else:
+            headed = False
     if (
         shared_utils.is_linux()
         and not headed
@@ -434,6 +440,13 @@ def Driver(
             disable_js = False
     if pls is not None and page_load_strategy is None:
         page_load_strategy = pls
+    if not page_load_strategy and "--pls=" in arg_join:
+        if "--pls=none" in sys_argv or '--pls="none"' in sys_argv:
+            page_load_strategy = "none"
+        elif "--pls=eager" in sys_argv or '--pls="eager"' in sys_argv:
+            page_load_strategy = "eager"
+        elif "--pls=normal" in sys_argv or '--pls="normal"' in sys_argv:
+            page_load_strategy = "normal"
     if page_load_strategy is not None:
         if page_load_strategy.lower() not in ["normal", "eager", "none"]:
             raise Exception(

{seleniumbase-4.26.1 → seleniumbase-4.26.2}/seleniumbase/plugins/sb_manager.py

@@ -378,9 +378,20 @@ def SB(
             record_sleep = True
         else:
             record_sleep = False
+    if xvfb is None:
+        if "--xvfb" in sys_argv:
+            xvfb = True
+        else:
+            xvfb = False
     if not shared_utils.is_linux():
         # The Xvfb virtual display server is for Linux OS Only!
         xvfb = False
+    if headed is None:
+        # Override the default headless mode on Linux if set.
+        if "--gui" in sys_argv or "--headed" in sys_argv:
+            headed = True
+        else:
+            headed = False
     if (
         shared_utils.is_linux()
         and not headed
@@ -532,6 +543,13 @@ def SB(
         _disable_beforeunload = True
     if pls is not None and page_load_strategy is None:
         page_load_strategy = pls
+    if not page_load_strategy and "--pls=" in arg_join:
+        if "--pls=none" in sys_argv or '--pls="none"' in sys_argv:
+            page_load_strategy = "none"
+        elif "--pls=eager" in sys_argv or '--pls="eager"' in sys_argv:
+            page_load_strategy = "eager"
+        elif "--pls=normal" in sys_argv or '--pls="normal"' in sys_argv:
+            page_load_strategy = "normal"
     if page_load_strategy is not None:
         if page_load_strategy.lower() not in ["normal", "eager", "none"]:
             raise Exception(

{seleniumbase-4.26.1 → seleniumbase-4.26.2}/seleniumbase.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: seleniumbase
-Version: 4.26.1
+Version: 4.26.2
 Summary: A complete web automation framework for end-to-end testing.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz