seleniumbase 4.26.1__tar.gz → 4.26.3__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: seleniumbase
-Version: 4.26.1
+Version: 4.26.3
 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.3}/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,
@@ -384,6 +386,8 @@ self.highlight_if_visible(selector, by="css selector", loops=4, scroll=True)
 
 self.highlight(selector, by="css selector", loops=4, scroll=True, timeout=None)
 
+self.highlight_elements(selector, by="css selector", loops=4, scroll=True, limit=0)
+
 self.press_up_arrow(selector="html", times=1, by="css selector")
 
 self.press_down_arrow(selector="html", times=1, by="css selector")
@@ -938,7 +942,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 +974,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 +1036,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.3}/mkdocs_build/requirements.txt

@@ -20,7 +20,7 @@ lxml==5.2.1
 pyquery==2.0.0
 readtime==3.0.0
 mkdocs==1.6.0
-mkdocs-material==9.5.20
+mkdocs-material==9.5.21
 mkdocs-exclude-search==0.6.6
 mkdocs-simple-hooks==0.1.5
 mkdocs-material-extensions==1.3.1

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

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

{seleniumbase-4.26.1 → seleniumbase-4.26.3}/seleniumbase/fixtures/base_case.py

@@ -60,6 +60,7 @@ from selenium.common.exceptions import (
 from selenium.webdriver.common.by import By
 from selenium.webdriver.common.keys import Keys
 from selenium.webdriver.remote.remote_connection import LOGGER
+from selenium.webdriver.remote.webelement import WebElement
 from seleniumbase import config as sb_config
 from seleniumbase.__version__ import __version__
 from seleniumbase.common import decorators
@@ -5645,6 +5646,40 @@ class BaseCase(unittest.TestCase):
         if self.is_element_visible(selector, by=by):
             self.__highlight(selector, by=by, loops=loops, scroll=scroll)
 
+    def __highlight_element(self, element, loops=None, scroll=True):
+        self.__check_scope()
+        if not loops:
+            loops = settings.HIGHLIGHTS
+        if scroll and self.browser != "safari":
+            try:
+                self.__slow_scroll_to_element(element)
+            except Exception:
+                pass
+        if self.highlights:
+            loops = self.highlights
+        if self.browser == "ie":
+            loops = 1  # Override previous setting because IE is slow
+        loops = int(loops)
+        if self.headless or self.headless2 or self.xvfb:
+            # Headless modes have less need for highlighting elements.
+            # However, highlight() may be used as a sleep alternative.
+            loops = int(math.ceil(loops * 0.5))
+        o_bs = ""  # original_box_shadow
+        try:
+            style = element.get_attribute("style")
+        except Exception:
+            self.wait_for_ready_state_complete()
+            time.sleep(0.12)
+            style = element.get_attribute("style")
+        if style:
+            if "box-shadow: " in style:
+                box_start = style.find("box-shadow: ")
+                box_end = style.find(";", box_start) + 1
+                original_box_shadow = style[box_start:box_end]
+                o_bs = original_box_shadow
+        self.__highlight_element_with_js(element, loops, o_bs)
+        time.sleep(0.065)
+
     def __highlight(
         self, selector, by="css selector", loops=None, scroll=True
     ):
@@ -5733,13 +5768,16 @@ class BaseCase(unittest.TestCase):
     ):
         """This method uses fancy JavaScript to highlight an element.
         @Params
-        selector - the selector of the element to find
+        selector - the selector of the element to find (Accepts WebElement)
         by - the type of selector to search by (Default: CSS)
         loops - # of times to repeat the highlight animation
                 (Default: 4. Each loop lasts for about 0.2s)
         scroll - the option to scroll to the element first (Default: True)
         timeout - the time to wait for the element to appear """
         self.__check_scope()
+        if isinstance(selector, WebElement):
+            self.__highlight_element(selector, loops=loops, scroll=scroll)
+            return
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         self.wait_for_element_visible(selector, by=by, timeout=timeout)
@@ -5751,6 +5789,31 @@ class BaseCase(unittest.TestCase):
                 action = ["hi_li", selector, origin, time_stamp]
                 self.__extra_actions.append(action)
 
+    def highlight_elements(
+        self,
+        selector,
+        by="css selector",
+        loops=None,
+        scroll=True,
+        limit=0,
+    ):
+        if not limit:
+            limit = 0  # 0 means no limit
+        limit = int(limit)
+        count = 0
+        elements = self.find_elements(selector, by=by)
+        for element in elements:
+            try:
+                if element.is_displayed():
+                    self.__highlight_element(
+                        element, loops=loops, scroll=scroll
+                    )
+                    count += 1
+            except Exception:
+                pass
+            if limit > 0 and count >= limit:
+                break
+
     def press_up_arrow(self, selector="html", times=1, by="css selector"):
         """Simulates pressing the UP Arrow on the keyboard.
         By default, "html" will be used as the CSS Selector target.

{seleniumbase-4.26.1 → seleniumbase-4.26.3}/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.3}/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.3}/seleniumbase.egg-info/PKG-INFO

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