seleniumbase 4.42.4__tar.gz → 4.42.6__tar.gz

{seleniumbase-4.42.4/seleniumbase.egg-info → seleniumbase-4.42.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: seleniumbase
-Version: 4.42.4
+Version: 4.42.6
 Summary: A complete web automation framework for end-to-end testing.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz
@@ -75,7 +75,7 @@ Requires-Dist: filelock~=3.16.1; python_version < "3.9"
 Requires-Dist: filelock~=3.19.1; python_version >= "3.9" and python_version < "3.10"
 Requires-Dist: filelock>=3.20.0; python_version >= "3.10"
 Requires-Dist: fasteners>=0.20
-Requires-Dist: mycdp>=1.2.0
+Requires-Dist: mycdp>=1.2.1
 Requires-Dist: pynose>=1.5.5
 Requires-Dist: platformdirs~=4.3.6; python_version < "3.9"
 Requires-Dist: platformdirs~=4.4.0; python_version >= "3.9" and python_version < "3.10"
@@ -95,9 +95,9 @@ Requires-Dist: pygments>=2.19.2
 Requires-Dist: pyreadline3>=3.5.4; platform_system == "Windows"
 Requires-Dist: tabcompleter>=1.4.0
 Requires-Dist: pdbp>=1.7.1
-Requires-Dist: idna==3.10
+Requires-Dist: idna>=3.11
 Requires-Dist: chardet==5.2.0
-Requires-Dist: charset-normalizer<4,>=3.4.3
+Requires-Dist: charset-normalizer<4,>=3.4.4
 Requires-Dist: urllib3<2,>=1.26.20; python_version < "3.10"
 Requires-Dist: urllib3<2.6.0,>=1.26.20; python_version >= "3.10"
 Requires-Dist: requests==2.32.4; python_version < "3.9"
@@ -127,7 +127,8 @@ Requires-Dist: pytest-html==4.0.2
 Requires-Dist: pytest-metadata==3.1.1
 Requires-Dist: pytest-ordering==0.6
 Requires-Dist: pytest-rerunfailures==14.0; python_version < "3.9"
-Requires-Dist: pytest-rerunfailures==16.0.1; python_version >= "3.9"
+Requires-Dist: pytest-rerunfailures==16.0.1; python_version >= "3.9" and python_version < "3.10"
+Requires-Dist: pytest-rerunfailures==16.1; python_version >= "3.10"
 Requires-Dist: pytest-xdist==3.6.1; python_version < "3.9"
 Requires-Dist: pytest-xdist==3.8.0; python_version >= "3.9"
 Requires-Dist: parameterized==0.9.0
@@ -148,7 +149,8 @@ Requires-Dist: allure-python-commons>=2.13.5; extra == "allure"
 Requires-Dist: allure-behave>=2.13.5; extra == "allure"
 Provides-Extra: coverage
 Requires-Dist: coverage>=7.6.1; python_version < "3.9" and extra == "coverage"
-Requires-Dist: coverage>=7.10.7; python_version >= "3.9" and extra == "coverage"
+Requires-Dist: coverage>=7.10.7; (python_version >= "3.9" and python_version < "3.10") and extra == "coverage"
+Requires-Dist: coverage>=7.11.0; python_version >= "3.10" and extra == "coverage"
 Requires-Dist: pytest-cov>=5.0.0; python_version < "3.9" and extra == "coverage"
 Requires-Dist: pytest-cov>=7.0.0; python_version >= "3.9" and extra == "coverage"
 Provides-Extra: flake8
@@ -176,7 +178,8 @@ Requires-Dist: pycparser==2.22; python_version < "3.9" and extra == "pdfminer"
 Requires-Dist: pycparser==2.23; python_version >= "3.9" and extra == "pdfminer"
 Provides-Extra: pillow
 Requires-Dist: Pillow>=10.4.0; python_version < "3.9" and extra == "pillow"
-Requires-Dist: Pillow>=11.3.0; python_version >= "3.9" and extra == "pillow"
+Requires-Dist: Pillow>=11.3.0; (python_version >= "3.9" and python_version < "3.10") and extra == "pillow"
+Requires-Dist: Pillow>=12.0.0; python_version >= "3.10" and extra == "pillow"
 Provides-Extra: pip-system-certs
 Requires-Dist: pip-system-certs==4.0; platform_system == "Windows" and extra == "pip-system-certs"
 Provides-Extra: proxy
@@ -268,13 +271,13 @@ Dynamic: summary
 <br />
 </p>
 
-<p>SeleniumBase is the professional toolkit for web automation activities. Built for testing websites, bypassing CAPTCHAs, enhancing productivity, completing tasks, and scaling your business.</p>
+<p>SeleniumBase is used for automating browsers, testing websites, scraping data, and bypassing CAPTCHAs.</p>
 
 --------
 
 📚 Learn from [**over 200 examples** in the **SeleniumBase/examples/** folder](https://github.com/seleniumbase/SeleniumBase/tree/master/examples).
 
-🐙 Note that <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md"><b>UC Mode</b></a> / <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md"><b>CDP Mode</b></a> (Stealth Mode) have their own ReadMe files.
+🐙 Stealth modes: <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md"><b>UC Mode</b></a> and <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md"><b>CDP Mode</b></a> help you evade bot-detection.
 
 ℹ️ Most scripts run with raw <code translate="no"><b>python</b></code>, although some scripts use <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/syntax_formats.md">Syntax Formats</a> that expect <a href="https://docs.pytest.org/en/latest/how-to/usage.html" translate="no"><b>pytest</b></a> (a Python unit-testing framework included with SeleniumBase that can discover, collect, and run tests automatically).
 

{seleniumbase-4.42.4 → seleniumbase-4.42.6}/README.md

@@ -53,13 +53,13 @@
 <br />
 </p>
 
-<p>SeleniumBase is the professional toolkit for web automation activities. Built for testing websites, bypassing CAPTCHAs, enhancing productivity, completing tasks, and scaling your business.</p>
+<p>SeleniumBase is used for automating browsers, testing websites, scraping data, and bypassing CAPTCHAs.</p>
 
 --------
 
 📚 Learn from [**over 200 examples** in the **SeleniumBase/examples/** folder](https://github.com/seleniumbase/SeleniumBase/tree/master/examples).
 
-🐙 Note that <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md"><b>UC Mode</b></a> / <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md"><b>CDP Mode</b></a> (Stealth Mode) have their own ReadMe files.
+🐙 Stealth modes: <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md"><b>UC Mode</b></a> and <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md"><b>CDP Mode</b></a> help you evade bot-detection.
 
 ℹ️ Most scripts run with raw <code translate="no"><b>python</b></code>, although some scripts use <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/syntax_formats.md">Syntax Formats</a> that expect <a href="https://docs.pytest.org/en/latest/how-to/usage.html" translate="no"><b>pytest</b></a> (a Python unit-testing framework included with SeleniumBase that can discover, collect, and run tests automatically).
 

{seleniumbase-4.42.4 → seleniumbase-4.42.6}/requirements.txt

@@ -14,7 +14,7 @@ filelock~=3.16.1;python_version<"3.9"
 filelock~=3.19.1;python_version>="3.9" and python_version<"3.10"
 filelock>=3.20.0;python_version>="3.10"
 fasteners>=0.20
-mycdp>=1.2.0
+mycdp>=1.2.1
 pynose>=1.5.5
 platformdirs~=4.3.6;python_version<"3.9"
 platformdirs~=4.4.0;python_version>="3.9" and python_version<"3.10"
@@ -34,9 +34,9 @@ pygments>=2.19.2
 pyreadline3>=3.5.4;platform_system=="Windows"
 tabcompleter>=1.4.0
 pdbp>=1.7.1
-idna==3.10
+idna>=3.11
 chardet==5.2.0
-charset-normalizer>=3.4.3,<4
+charset-normalizer>=3.4.4,<4
 urllib3>=1.26.20,<2;python_version<"3.10"
 urllib3>=1.26.20,<2.6.0;python_version>="3.10"
 requests==2.32.4;python_version<"3.9"
@@ -66,7 +66,8 @@ pytest-html==4.0.2
 pytest-metadata==3.1.1
 pytest-ordering==0.6
 pytest-rerunfailures==14.0;python_version<"3.9"
-pytest-rerunfailures==16.0.1;python_version>="3.9"
+pytest-rerunfailures==16.0.1;python_version>="3.9" and python_version<"3.10"
+pytest-rerunfailures==16.1;python_version>="3.10"
 pytest-xdist==3.6.1;python_version<"3.9"
 pytest-xdist==3.8.0;python_version>="3.9"
 parameterized==0.9.0
@@ -86,7 +87,8 @@ rich>=14.2.0,<15
 # ("pip install -r requirements.txt" also installs this, but "pip install -e ." won't.)
 
 coverage>=7.6.1;python_version<"3.9"
-coverage>=7.10.7;python_version>="3.9"
+coverage>=7.10.7;python_version>="3.9" and python_version<"3.10"
+coverage>=7.11.0;python_version>="3.10"
 pytest-cov>=5.0.0;python_version<"3.9"
 pytest-cov>=7.0.0;python_version>="3.9"
 flake8==5.0.4;python_version<"3.9"

{seleniumbase-4.42.4 → seleniumbase-4.42.6}/seleniumbase/__version__.py

@@ -1,2 +1,2 @@
 # seleniumbase package
-__version__ = "4.42.4"
+__version__ = "4.42.6"

{seleniumbase-4.42.4 → seleniumbase-4.42.6}/seleniumbase/core/browser_launcher.py

@@ -756,12 +756,16 @@ def uc_open_with_cdp_mode(driver, url=None, **kwargs):
     cdp.set_value = CDPM.set_value
     cdp.submit = CDPM.submit
     cdp.evaluate = CDPM.evaluate
+    cdp.execute_script = CDPM.execute_script
     cdp.js_dumps = CDPM.js_dumps
     cdp.maximize = CDPM.maximize
     cdp.minimize = CDPM.minimize
     cdp.medimize = CDPM.medimize
     cdp.set_window_rect = CDPM.set_window_rect
     cdp.reset_window_size = CDPM.reset_window_size
+    cdp.activate_messenger = CDPM.activate_messenger
+    cdp.set_messenger_theme = CDPM.set_messenger_theme
+    cdp.post_message = CDPM.post_message
     cdp.set_locale = CDPM.set_locale
     cdp.set_local_storage_item = CDPM.set_local_storage_item
     cdp.set_session_storage_item = CDPM.set_session_storage_item
@@ -877,6 +881,8 @@ def uc_open_with_cdp_mode(driver, url=None, **kwargs):
     cdp.scroll_to_bottom = CDPM.scroll_to_bottom
     cdp.scroll_up = CDPM.scroll_up
     cdp.scroll_down = CDPM.scroll_down
+    cdp.save_page_source = CDPM.save_page_source
+    cdp.save_as_html = CDPM.save_as_html
     cdp.save_screenshot = CDPM.save_screenshot
     cdp.print_to_pdf = CDPM.print_to_pdf
     cdp.save_as_pdf = CDPM.save_as_pdf
@@ -979,17 +985,15 @@ def __install_pyautogui_if_missing():
         import pyautogui
         with suppress(Exception):
             use_pyautogui_ver = constants.PyAutoGUI.VER
-            if pyautogui.__version__ != use_pyautogui_ver:
-                del pyautogui
-                shared_utils.pip_install(
-                    "pyautogui", version=use_pyautogui_ver
-                )
+            u_pv = shared_utils.make_version_tuple(use_pyautogui_ver)
+            pv = shared_utils.make_version_tuple(pyautogui.__version__)
+            if pv < u_pv:
+                del pyautogui  # To get newer ver
+                shared_utils.pip_install("pyautogui", version="Latest")
                 import pyautogui
     except Exception:
         print("\nPyAutoGUI required! Installing now...")
-        shared_utils.pip_install(
-            "pyautogui", version=constants.PyAutoGUI.VER
-        )
+        shared_utils.pip_install("pyautogui", version="Latest")
         try:
             import pyautogui
         except Exception:

{seleniumbase-4.42.4 → seleniumbase-4.42.6}/seleniumbase/core/sb_cdp.py

@@ -912,6 +912,12 @@ class CDPMethods():
         element.scroll_into_view()
         if text.endswith("\n") or text.endswith("\r"):
             text = text[:-1] + "\r\n"
+        elif (
+            element.tag_name == "textarea"
+            and "\n" in text
+            and "\r" not in text
+        ):
+            text = text.replace("\n", "\r")
         element.send_keys(text)
         self.__slow_mode_pause_if_set()
         self.loop.run_until_complete(self.page.sleep(0.025))
@@ -927,6 +933,12 @@ class CDPMethods():
         if text.endswith("\n") or text.endswith("\r"):
             submit = True
             text = text[:-1]
+        elif (
+            element.tag_name == "textarea"
+            and "\n" in text
+            and "\r" not in text
+        ):
+            text = text.replace("\n", "\r")
         for key in text:
             element.send_keys(key)
             time.sleep(0.044)
@@ -947,6 +959,12 @@ class CDPMethods():
             element.clear_input()
         if text.endswith("\n") or text.endswith("\r"):
             text = text[:-1] + "\r\n"
+        elif (
+            element.tag_name == "textarea"
+            and "\n" in text
+            and "\r" not in text
+        ):
+            text = text.replace("\n", "\r")
         element.send_keys(text)
         self.__slow_mode_pause_if_set()
         self.loop.run_until_complete(self.page.sleep(0.025))
@@ -1024,6 +1042,9 @@ class CDPMethods():
             ).strip()
         return self.loop.run_until_complete(self.page.evaluate(expression))
 
+    def execute_script(self, expression):
+        return self.evaluate(expression)
+
     def js_dumps(self, obj_name):
         """Similar to evaluate(), but for dictionary results."""
         if obj_name.startswith("return "):
@@ -1407,6 +1428,64 @@ class CDPMethods():
         mfa_code = self.get_mfa_code(totp_key)
         self.type(selector, mfa_code + "\n", timeout=timeout)
 
+    def activate_messenger(self):
+        js_utils.activate_messenger(self)
+        self.__add_light_pause()
+
+    def set_messenger_theme(
+        self, theme="default", location="default", max_messages="default"
+    ):
+        """Sets a theme for posting messages.
+        Themes: ["flat", "future", "block", "air", "ice"]
+        Locations: ["top_left", "top_center", "top_right",
+                    "bottom_left", "bottom_center", "bottom_right"]
+        max_messages: The limit of concurrent messages to display."""
+        if not theme:
+            theme = "default"  # "flat"
+        if not location:
+            location = "default"  # "bottom_right"
+        if not max_messages:
+            max_messages = "default"  # "8"
+        else:
+            max_messages = str(max_messages)  # Value must be in string format
+        js_utils.set_messenger_theme(
+            self,
+            theme=theme,
+            location=location,
+            max_messages=max_messages,
+        )
+        self.__add_light_pause()
+
+    def post_message(self, message, duration=None, pause=True, style="info"):
+        """Post a message on the screen with Messenger.
+        Arguments:
+            message: The message to display.
+            duration: The time until the message vanishes. (Default: 2.55s)
+            pause: If True, the program waits until the message completes.
+            style: "info", "success", or "error"."""
+        driver = self.driver
+        if hasattr(driver, "cdp_base"):
+            driver = driver.cdp_base
+        if style not in ["info", "success", "error"]:
+            style = "info"
+        if not duration:
+            duration = settings.DEFAULT_MESSAGE_DURATION
+        if (
+            (
+                driver.config.headless
+                or (hasattr(sb_config, "xvfb") and sb_config.xvfb)
+            )
+            and float(duration) > 0.75
+        ):
+            duration = 0.75
+        try:
+            js_utils.post_message(self, message, duration, style=style)
+        except Exception:
+            print(" * %s message: %s" % (style.upper(), message))
+        if pause:
+            duration = float(duration) + 0.15
+            time.sleep(float(duration))
+
     def set_locale(self, locale):
         """(Settings will take effect on the next page load)"""
         self.loop.run_until_complete(self.page.set_locale(locale))
@@ -1494,23 +1573,24 @@ class CDPMethods():
                 import pyautogui
                 with suppress(Exception):
                     use_pyautogui_ver = constants.PyAutoGUI.VER
-                    if pyautogui.__version__ != use_pyautogui_ver:
-                        del pyautogui
-                        shared_utils.pip_install(
-                            "pyautogui", version=use_pyautogui_ver
-                        )
+                    u_pv = shared_utils.make_version_tuple(use_pyautogui_ver)
+                    pv = shared_utils.make_version_tuple(pyautogui.__version__)
+                    if pv < u_pv:
+                        del pyautogui  # To get newer ver
+                        shared_utils.pip_install("pyautogui", version="Latest")
                         import pyautogui
             except Exception:
                 print("\nPyAutoGUI required! Installing now...")
-                shared_utils.pip_install(
-                    "pyautogui", version=constants.PyAutoGUI.VER
-                )
+                shared_utils.pip_install("pyautogui", version="Latest")
                 try:
                     import pyautogui
                 except Exception:
                     if (
                         shared_utils.is_linux()
-                        and (not sb_config.headed or sb_config.xvfb)
+                        and (
+                            not sb_config.headed
+                            or (hasattr(sb_config, "xvfb") and sb_config.xvfb)
+                        )
                         and not driver.config.headless
                         and (
                             not hasattr(sb_config, "_virtual_display")
@@ -2611,6 +2691,40 @@ class CDPMethods():
         self.loop.run_until_complete(self.page.scroll_down(amount))
         self.loop.run_until_complete(self.page.wait())
 
+    def save_page_source(self, name, folder=None):
+        import codecs
+        from seleniumbase.core import log_helper
+        if not name.endswith(".html"):
+            name = name + ".html"
+        if folder:
+            abs_path = os.path.abspath(".")
+            file_path = os.path.join(abs_path, folder)
+            if not os.path.exists(file_path):
+                os.makedirs(file_path)
+            html_file_path = os.path.join(file_path, name)
+        else:
+            html_file_path = name
+        page_source = self.get_page_source()
+        last_page = self.get_current_url()
+        meta_charset = '<meta charset="utf-8">'
+        rendered_source = ""
+        if "://" in last_page:
+            base_href_html = log_helper.get_base_href_html(last_page)
+            if ' charset="' not in page_source:
+                rendered_source = "%s\n%s\n%s" % (
+                    base_href_html, meta_charset, page_source
+                )
+            else:
+                rendered_source = "%s\n%s" % (base_href_html, page_source)
+        else:
+            rendered_source = page_source
+        html_file = codecs.open(html_file_path, "w+", "utf-8")
+        html_file.write(rendered_source)
+        html_file.close()
+
+    def save_as_html(self, *args, **kwargs):
+        self.save_page_source(*args, **kwargs)
+
     def save_screenshot(self, name, folder=None, selector=None):
         filename = name
         if folder:

{seleniumbase-4.42.4 → seleniumbase-4.42.6}/seleniumbase/fixtures/base_case.py

@@ -114,9 +114,7 @@ class BaseCase(unittest.TestCase):
         self.driver = None
         self.environment = None
         self.env = None  # Add a shortened version of self.environment
-        self.version_list = [
-            int(i) for i in __version__.split(".") if i.isdigit()
-        ]
+        self.version_list = shared_utils.make_version_list(__version__)
         self.version_tuple = tuple(self.version_list)
         self.version_info = self.version_tuple
         self.time = time.time
@@ -9205,6 +9203,10 @@ class BaseCase(unittest.TestCase):
         """Same as self.switch_to_newest_window()"""
         self.switch_to_newest_window()
 
+    def save_as_html(self, name, folder=None):
+        """Same as self.save_page_source()"""
+        self.save_page_source(name, folder=folder)
+
     def input(
         self, selector, text, by="css selector", timeout=None, retry=False
     ):
@@ -9654,9 +9656,11 @@ class BaseCase(unittest.TestCase):
 
     def activate_messenger(self):
         self.__check_scope()
-        self._check_browser()
+        if not self.__is_cdp_swap_needed():
+            self._check_browser()
         js_utils.activate_messenger(self.driver)
-        self.wait_for_ready_state_complete()
+        if not self.__is_cdp_swap_needed():
+            self.wait_for_ready_state_complete()
 
     def set_messenger_theme(
         self, theme="default", location="default", max_messages="default"
@@ -14485,11 +14489,11 @@ class BaseCase(unittest.TestCase):
                 import pyautogui
                 with suppress(Exception):
                     use_pyautogui_ver = constants.PyAutoGUI.VER
-                    if pyautogui.__version__ != use_pyautogui_ver:
+                    u_pv = shared_utils.make_version_tuple(use_pyautogui_ver)
+                    pv = shared_utils.make_version_tuple(pyautogui.__version__)
+                    if pv < u_pv:
                         del pyautogui  # To get newer ver
-                        shared_utils.pip_install(
-                            "pyautogui", version=use_pyautogui_ver
-                        )
+                        shared_utils.pip_install("pyautogui", version="Latest")
                         import pyautogui
                 pyautogui_is_installed = True
             except Exception:
@@ -14498,9 +14502,7 @@ class BaseCase(unittest.TestCase):
                     "Installing now..."
                 )
                 print("\n" + message)
-                shared_utils.pip_install(
-                    "pyautogui", version=constants.PyAutoGUI.VER
-                )
+                shared_utils.pip_install("pyautogui", version="Latest")
                 import pyautogui
                 pyautogui_is_installed = True
             if (

{seleniumbase-4.42.4 → seleniumbase-4.42.6}/seleniumbase/fixtures/js_utils.py

@@ -29,6 +29,8 @@ def wait_for_ready_state_complete(driver, timeout=settings.LARGE_TIMEOUT):
     If the timeout is exceeded, the test will still continue
       because readyState == "interactive" may be good enough.
     (Previously, tests would fail immediately if exceeding the timeout.)"""
+    if hasattr(driver, "_swap_driver"):
+        return
     if hasattr(settings, "SKIP_JS_WAITS") and settings.SKIP_JS_WAITS:
         return
     start_ms = time.time() * 1000.0
@@ -54,8 +56,12 @@ def wait_for_ready_state_complete(driver, timeout=settings.LARGE_TIMEOUT):
 
 
 def execute_async_script(driver, script, timeout=settings.LARGE_TIMEOUT):
-    driver.set_script_timeout(timeout)
-    return driver.execute_async_script(script)
+    if hasattr(driver, "set_script_timeout"):
+        driver.set_script_timeout(timeout)
+    if hasattr(driver, "execute_async_script"):
+        return driver.execute_async_script(script)
+    else:
+        return None
 
 
 def wait_for_angularjs(driver, timeout=settings.LARGE_TIMEOUT, **kwargs):
@@ -937,7 +943,10 @@ def post_message(driver, message, msg_dur=None, style="info"):
         execute_script(driver, messenger_script)
     except TypeError as e:
         if (
-            shared_utils.is_cdp_swap_needed(driver)
+            (
+                shared_utils.is_cdp_swap_needed(driver)
+                or hasattr(driver, "_swap_driver")
+            )
             and "cannot unpack non-iterable" in str(e)
         ):
             pass

{seleniumbase-4.42.4 → seleniumbase-4.42.6}/seleniumbase/fixtures/shared_utils.py

@@ -18,16 +18,35 @@ def pip_install(package, version=None):
     pip_install_lock = fasteners.InterProcessLock(
         constants.PipInstall.LOCKFILE
     )
+    upgrade_to_latest = False
+    if (
+        version
+        and ("U" in str(version).upper() or "L" in str(version).upper())
+    ):
+        # Upgrade to Latest when specified with "U" or "L"
+        upgrade_to_latest = True
     with pip_install_lock:
         if not version:
             subprocess.check_call(
                 [sys.executable, "-m", "pip", "install", package]
             )
-        else:
+        elif not upgrade_to_latest:
             package_and_version = package + "==" + str(version)
             subprocess.check_call(
                 [sys.executable, "-m", "pip", "install", package_and_version]
             )
+        else:
+            subprocess.check_call(
+                [sys.executable, "-m", "pip", "install", "-U", package]
+            )
+
+
+def make_version_list(version_str):
+    return [int(i) for i in version_str.split(".") if i.isdigit()]
+
+
+def make_version_tuple(version_str):
+    return tuple(make_version_list(version_str))
 
 
 def get_mfa_code(totp_key=None):

{seleniumbase-4.42.4 → seleniumbase-4.42.6}/seleniumbase/undetected/cdp_driver/cdp_util.py

@@ -121,22 +121,26 @@ def __activate_virtual_display_as_needed(
                     import pyautogui
                     with suppress(Exception):
                         use_pyautogui_ver = constants.PyAutoGUI.VER
-                        if pyautogui.__version__ != use_pyautogui_ver:
+                        u_pv = shared_utils.make_version_tuple(
+                            use_pyautogui_ver
+                        )
+                        pv = shared_utils.make_version_tuple(
+                            pyautogui.__version__
+                        )
+                        if pv < u_pv:
                             del pyautogui  # To get newer ver
                             shared_utils.pip_install(
-                                "pyautogui", version=use_pyautogui_ver
+                                "pyautogui", version="Latest"
                             )
                             import pyautogui
                     pyautogui_is_installed = True
                 except Exception:
                     message = (
-                        "PyAutoGUI is required for UC Mode on Linux! "
+                        "PyAutoGUI is required for CDP Mode on Linux! "
                         "Installing now..."
                     )
                     print("\n" + message)
-                    shared_utils.pip_install(
-                        "pyautogui", version=constants.PyAutoGUI.VER
-                    )
+                    shared_utils.pip_install("pyautogui", version="Latest")
                     import pyautogui
                     pyautogui_is_installed = True
                 if (
@@ -335,6 +339,8 @@ async def start(
             xvfb = True
         else:
             xvfb = False
+    if not hasattr(sb_config, "xvfb"):
+        sb_config.xvfb = xvfb
     if incognito is None:
         if "--incognito" in sys_argv:
             incognito = True
@@ -687,7 +693,10 @@ def start_sync(*args, **kwargs) -> Browser:
 
 
 async def create_from_driver(driver) -> Browser:
-    """Create a Browser instance from a running driver instance."""
+    """Create a CDP Browser instance from a running UC driver.
+    This method is DEPRECATED in favor of activate_cdp_mode(),
+     which includes the option of switching between the modes,
+     and also properly handles configuration based on options."""
     from .config import Config
 
     conf = Config()

{seleniumbase-4.42.4 → seleniumbase-4.42.6}/seleniumbase/undetected/cdp_driver/config.py

@@ -202,6 +202,7 @@ class Config:
             "InsecureDownloadWarnings,DownloadBubble,DownloadBubbleV2,"
             "OptimizationTargetPrediction,OptimizationGuideModelDownloading,"
             "SidePanelPinning,UserAgentClientHint,PrivacySandboxSettings4,"
+            "OptimizationHintsFetching,InterestFeedContentSuggestions,"
             "DisableLoadExtensionCommandLineSwitch"
         ]
         if self.proxy:

{seleniumbase-4.42.4 → seleniumbase-4.42.6/seleniumbase.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: seleniumbase
-Version: 4.42.4
+Version: 4.42.6
 Summary: A complete web automation framework for end-to-end testing.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz
@@ -75,7 +75,7 @@ Requires-Dist: filelock~=3.16.1; python_version < "3.9"
 Requires-Dist: filelock~=3.19.1; python_version >= "3.9" and python_version < "3.10"
 Requires-Dist: filelock>=3.20.0; python_version >= "3.10"
 Requires-Dist: fasteners>=0.20
-Requires-Dist: mycdp>=1.2.0
+Requires-Dist: mycdp>=1.2.1
 Requires-Dist: pynose>=1.5.5
 Requires-Dist: platformdirs~=4.3.6; python_version < "3.9"
 Requires-Dist: platformdirs~=4.4.0; python_version >= "3.9" and python_version < "3.10"
@@ -95,9 +95,9 @@ Requires-Dist: pygments>=2.19.2
 Requires-Dist: pyreadline3>=3.5.4; platform_system == "Windows"
 Requires-Dist: tabcompleter>=1.4.0
 Requires-Dist: pdbp>=1.7.1
-Requires-Dist: idna==3.10
+Requires-Dist: idna>=3.11
 Requires-Dist: chardet==5.2.0
-Requires-Dist: charset-normalizer<4,>=3.4.3
+Requires-Dist: charset-normalizer<4,>=3.4.4
 Requires-Dist: urllib3<2,>=1.26.20; python_version < "3.10"
 Requires-Dist: urllib3<2.6.0,>=1.26.20; python_version >= "3.10"
 Requires-Dist: requests==2.32.4; python_version < "3.9"
@@ -127,7 +127,8 @@ Requires-Dist: pytest-html==4.0.2
 Requires-Dist: pytest-metadata==3.1.1
 Requires-Dist: pytest-ordering==0.6
 Requires-Dist: pytest-rerunfailures==14.0; python_version < "3.9"
-Requires-Dist: pytest-rerunfailures==16.0.1; python_version >= "3.9"
+Requires-Dist: pytest-rerunfailures==16.0.1; python_version >= "3.9" and python_version < "3.10"
+Requires-Dist: pytest-rerunfailures==16.1; python_version >= "3.10"
 Requires-Dist: pytest-xdist==3.6.1; python_version < "3.9"
 Requires-Dist: pytest-xdist==3.8.0; python_version >= "3.9"
 Requires-Dist: parameterized==0.9.0
@@ -148,7 +149,8 @@ Requires-Dist: allure-python-commons>=2.13.5; extra == "allure"
 Requires-Dist: allure-behave>=2.13.5; extra == "allure"
 Provides-Extra: coverage
 Requires-Dist: coverage>=7.6.1; python_version < "3.9" and extra == "coverage"
-Requires-Dist: coverage>=7.10.7; python_version >= "3.9" and extra == "coverage"
+Requires-Dist: coverage>=7.10.7; (python_version >= "3.9" and python_version < "3.10") and extra == "coverage"
+Requires-Dist: coverage>=7.11.0; python_version >= "3.10" and extra == "coverage"
 Requires-Dist: pytest-cov>=5.0.0; python_version < "3.9" and extra == "coverage"
 Requires-Dist: pytest-cov>=7.0.0; python_version >= "3.9" and extra == "coverage"
 Provides-Extra: flake8
@@ -176,7 +178,8 @@ Requires-Dist: pycparser==2.22; python_version < "3.9" and extra == "pdfminer"
 Requires-Dist: pycparser==2.23; python_version >= "3.9" and extra == "pdfminer"
 Provides-Extra: pillow
 Requires-Dist: Pillow>=10.4.0; python_version < "3.9" and extra == "pillow"
-Requires-Dist: Pillow>=11.3.0; python_version >= "3.9" and extra == "pillow"
+Requires-Dist: Pillow>=11.3.0; (python_version >= "3.9" and python_version < "3.10") and extra == "pillow"
+Requires-Dist: Pillow>=12.0.0; python_version >= "3.10" and extra == "pillow"
 Provides-Extra: pip-system-certs
 Requires-Dist: pip-system-certs==4.0; platform_system == "Windows" and extra == "pip-system-certs"
 Provides-Extra: proxy
@@ -268,13 +271,13 @@ Dynamic: summary
 <br />
 </p>
 
-<p>SeleniumBase is the professional toolkit for web automation activities. Built for testing websites, bypassing CAPTCHAs, enhancing productivity, completing tasks, and scaling your business.</p>
+<p>SeleniumBase is used for automating browsers, testing websites, scraping data, and bypassing CAPTCHAs.</p>
 
 --------
 
 📚 Learn from [**over 200 examples** in the **SeleniumBase/examples/** folder](https://github.com/seleniumbase/SeleniumBase/tree/master/examples).
 
-🐙 Note that <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md"><b>UC Mode</b></a> / <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md"><b>CDP Mode</b></a> (Stealth Mode) have their own ReadMe files.
+🐙 Stealth modes: <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md"><b>UC Mode</b></a> and <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md"><b>CDP Mode</b></a> help you evade bot-detection.
 
 ℹ️ Most scripts run with raw <code translate="no"><b>python</b></code>, although some scripts use <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/syntax_formats.md">Syntax Formats</a> that expect <a href="https://docs.pytest.org/en/latest/how-to/usage.html" translate="no"><b>pytest</b></a> (a Python unit-testing framework included with SeleniumBase that can discover, collect, and run tests automatically).