seleniumbase 4.47.5__tar.gz → 4.47.6__tar.gz

{seleniumbase-4.47.5/seleniumbase.egg-info → seleniumbase-4.47.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: seleniumbase
-Version: 4.47.5
+Version: 4.47.6
 Summary: A complete web automation framework for end-to-end testing.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz
@@ -262,9 +262,9 @@ Dynamic: summary
 
 --------
 
-<p align="left">📓 Here's the stealthy architecture overview:</p>
+<h3 align="left">⚙️ Stealthy architecture flowchart:</h3>
 
-<img src="https://seleniumbase.github.io/other/sb_stealth.png" width="596" alt="Stealthy architecture overview" />
+<img src="https://seleniumbase.github.io/other/sb_stealth.png" width="596" alt="Stealthy architecture flowchart" />
 
 (For maximum stealth, use <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md">CDP Mode</a>, which includes <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/ReadMe.md">Stealthy Playwright Mode</a>)
 
@@ -280,6 +280,7 @@ sb = sb_cdp.Chrome(url)
 elements = sb.find_elements("span.titleline > a")
 for element in elements:
     print("* " + element.text)
+sb.driver.stop()
 ```
 
 --------
@@ -691,6 +692,7 @@ class MyTestClass(BaseCase):
 
 ```python
 self.open(url)  # Navigate the browser window to the URL.
+self.activate_cdp_mode()  # Activate CDP Mode from UC Mode.
 self.type(selector, text)  # Update the field with the text.
 self.click(selector)  # Click the element with the selector.
 self.click_link(link_text)  # Click the link containing text.
@@ -779,7 +781,7 @@ pytest [FILE_NAME.py]::[CLASS_NAME]::[METHOD_NAME]
 pynose [FILE_NAME.py]:[CLASS_NAME].[METHOD_NAME]
 ```
 
-<p>✅ No More Flaky Tests! SeleniumBase methods automatically wait for page elements to finish loading before interacting with them (<i>up to a timeout limit</i>). This means <b>you no longer need random <span><code translate="no">time.sleep()</code></span> statements</b> in your scripts.</p>
+<p>✅ No More Flaky Tests! SeleniumBase methods automatically wait for page elements to finish loading before interacting with them (<i>up to a timeout limit</i>).</p>
 <img src="https://img.shields.io/badge/Flaky%20Tests%3F-%20NO%21-11BBDD.svg" alt="NO MORE FLAKY TESTS!" />
 
 ✅ SeleniumBase supports all major browsers and operating systems:

{seleniumbase-4.47.5 → seleniumbase-4.47.6}/README.md

@@ -62,9 +62,9 @@
 
 --------
 
-<p align="left">📓 Here's the stealthy architecture overview:</p>
+<h3 align="left">⚙️ Stealthy architecture flowchart:</h3>
 
-<img src="https://seleniumbase.github.io/other/sb_stealth.png" width="596" alt="Stealthy architecture overview" />
+<img src="https://seleniumbase.github.io/other/sb_stealth.png" width="596" alt="Stealthy architecture flowchart" />
 
 (For maximum stealth, use <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md">CDP Mode</a>, which includes <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/ReadMe.md">Stealthy Playwright Mode</a>)
 
@@ -80,6 +80,7 @@ sb = sb_cdp.Chrome(url)
 elements = sb.find_elements("span.titleline > a")
 for element in elements:
     print("* " + element.text)
+sb.driver.stop()
 ```
 
 --------
@@ -491,6 +492,7 @@ class MyTestClass(BaseCase):
 
 ```python
 self.open(url)  # Navigate the browser window to the URL.
+self.activate_cdp_mode()  # Activate CDP Mode from UC Mode.
 self.type(selector, text)  # Update the field with the text.
 self.click(selector)  # Click the element with the selector.
 self.click_link(link_text)  # Click the link containing text.
@@ -579,7 +581,7 @@ pytest [FILE_NAME.py]::[CLASS_NAME]::[METHOD_NAME]
 pynose [FILE_NAME.py]:[CLASS_NAME].[METHOD_NAME]
 ```
 
-<p>✅ No More Flaky Tests! SeleniumBase methods automatically wait for page elements to finish loading before interacting with them (<i>up to a timeout limit</i>). This means <b>you no longer need random <span><code translate="no">time.sleep()</code></span> statements</b> in your scripts.</p>
+<p>✅ No More Flaky Tests! SeleniumBase methods automatically wait for page elements to finish loading before interacting with them (<i>up to a timeout limit</i>).</p>
 <img src="https://img.shields.io/badge/Flaky%20Tests%3F-%20NO%21-11BBDD.svg" alt="NO MORE FLAKY TESTS!" />
 
 ✅ SeleniumBase supports all major browsers and operating systems:

{seleniumbase-4.47.5 → seleniumbase-4.47.6}/seleniumbase/__version__.py

@@ -1,2 +1,2 @@
 # seleniumbase package
-__version__ = "4.47.5"
+__version__ = "4.47.6"

{seleniumbase-4.47.5 → seleniumbase-4.47.6}/seleniumbase/core/sb_cdp.py

@@ -429,7 +429,7 @@ class CDPMethods():
                     visible_elements.append(element)
         return visible_elements
 
-    def click_nth_element(self, selector, number):
+    def click_nth_element(self, selector, number, scroll=True):
         elements = self.select_all(selector)
         if len(elements) < number:
             raise Exception(
@@ -440,10 +440,11 @@ class CDPMethods():
         if number < 0:
             number = 0
         element = elements[number]
-        element.scroll_into_view()
+        if scroll:
+            element.scroll_into_view()
         element.click()
 
-    def click_nth_visible_element(self, selector, number):
+    def click_nth_visible_element(self, selector, number, scroll=True):
         """Finds all matching page elements and clicks the nth visible one.
         Example: self.click_nth_visible_element('[type="checkbox"]', 5)
                 (Clicks the 5th visible checkbox on the page.)"""
@@ -457,7 +458,8 @@ class CDPMethods():
         if number < 0:
             number = 0
         element = elements[number]
-        element.scroll_into_view()
+        if scroll:
+            element.scroll_into_view()
         element.click()
 
     def click_link(self, link_text):
@@ -793,12 +795,13 @@ class CDPMethods():
         js_code = js_code.replace("return getBestSelector", "getBestSelector")
         return self.loop.run_until_complete(self.page.evaluate(js_code))
 
-    def click(self, selector, timeout=None):
+    def click(self, selector, timeout=None, scroll=True):
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         self.__slow_mode_pause_if_set()
         element = self.find_element(selector, timeout=timeout)
-        element.scroll_into_view()
+        if scroll:
+            element.scroll_into_view()
         tag_name = element.tag_name
         if tag_name:
             tag_name = tag_name.lower().strip()
@@ -824,10 +827,10 @@ class CDPMethods():
         self.__slow_mode_pause_if_set()
         self.loop.run_until_complete(self.page.wait(0.2))
 
-    def click_if_visible(self, selector, timeout=0):
+    def click_if_visible(self, selector, timeout=0, scroll=True):
         if self.is_element_visible(selector):
             with suppress(Exception):
-                self.click(selector, timeout=1)
+                self.click(selector, timeout=1, scroll=scroll)
         elif timeout == 0:
             return
         else:
@@ -836,7 +839,7 @@ class CDPMethods():
                 if self.is_element_visible(selector):
                     self.click(selector, timeout=1)
 
-    def click_visible_elements(self, selector, limit=0):
+    def click_visible_elements(self, selector, limit=0, scroll=True):
         """Finds all matching page elements and clicks visible ones in order.
         If a click reloads or opens a new page, the clicking will stop.
         If no matching elements appear, an Exception will be raised.
@@ -859,7 +862,8 @@ class CDPMethods():
                 except Exception:
                     continue
                 if (width != 0 or height != 0):
-                    element.scroll_into_view()
+                    if scroll:
+                        element.scroll_into_view()
                     element.click()
                     click_count += 1
                     time.sleep(0.044)
@@ -868,13 +872,14 @@ class CDPMethods():
             except Exception:
                 break
 
-    def mouse_click(self, selector, timeout=None):
+    def mouse_click(self, selector, timeout=None, scroll=True):
         """(Attempt simulating a mouse click)"""
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         self.__slow_mode_pause_if_set()
         element = self.find_element(selector, timeout=timeout)
-        element.scroll_into_view()
+        if scroll:
+            element.scroll_into_view()
         element.mouse_click()
         self.__slow_mode_pause_if_set()
         self.loop.run_until_complete(self.page.wait(0.2))
@@ -1970,9 +1975,10 @@ class CDPMethods():
             py = element_rect["y"]
             self.gui_click_x_y(px + x, py + y, timeframe=timeframe)
 
-    def click_with_offset(self, selector, x, y, center=False):
+    def click_with_offset(self, selector, x, y, center=False, scroll=True):
         element = self.find_element(selector)
-        element.scroll_into_view()
+        if scroll:
+            element.scroll_into_view()
         if "--debug" in sys.argv:
             displayed_selector = "`%s`" % selector
             if '"' not in selector:

{seleniumbase-4.47.5 → seleniumbase-4.47.6}/seleniumbase/fixtures/base_case.py

@@ -411,7 +411,7 @@ class BaseCase(unittest.TestCase):
         original_by = by
         selector, by = self.__recalculate_selector(selector, by)
         if self.__is_cdp_swap_needed():
-            self.cdp.click(selector, timeout=timeout)
+            self.cdp.click(selector, timeout=timeout, scroll=scroll)
             return
         if delay and (type(delay) in [int, float]) and delay > 0:
             time.sleep(delay)
@@ -2254,7 +2254,7 @@ class BaseCase(unittest.TestCase):
         )
 
     def click_visible_elements(
-        self, selector, by="css selector", limit=0, timeout=None
+        self, selector, by="css selector", limit=0, timeout=None, scroll=True
     ):
         """Finds all matching page elements and clicks visible ones in order.
         If a click reloads or opens a new page, the clicking will stop.
@@ -2270,7 +2270,7 @@ class BaseCase(unittest.TestCase):
             timeout = self.__get_new_timeout(timeout)
         selector, by = self.__recalculate_selector(selector, by)
         if self.__is_cdp_swap_needed():
-            self.cdp.click_visible_elements(selector, limit)
+            self.cdp.click_visible_elements(selector, limit, scroll=scroll)
             return
         self.wait_for_ready_state_complete()
         if self.__needs_minimum_wait():
@@ -2297,7 +2297,8 @@ class BaseCase(unittest.TestCase):
                 return
             try:
                 if element.is_displayed():
-                    self.__scroll_to_element(element)
+                    if scroll:
+                        self.__scroll_to_element(element)
                     if self.browser == "safari":
                         self.execute_script("arguments[0].click();", element)
                     else:
@@ -2311,7 +2312,8 @@ class BaseCase(unittest.TestCase):
                 time.sleep(0.12)
                 try:
                     if element.is_displayed():
-                        self.__scroll_to_element(element)
+                        if scroll:
+                            self.__scroll_to_element(element)
                         if self.browser == "safari":
                             self.execute_script(
                                 "arguments[0].click();", element
@@ -2348,7 +2350,7 @@ class BaseCase(unittest.TestCase):
             self.__switch_to_newest_window_if_not_blank()
 
     def click_nth_visible_element(
-        self, selector, number, by="css selector", timeout=None
+        self, selector, number, by="css selector", timeout=None, scroll=True
     ):
         """Finds all matching page elements and clicks the nth visible one.
         Example: self.click_nth_visible_element('[type="checkbox"]', 5)
@@ -2360,7 +2362,7 @@ class BaseCase(unittest.TestCase):
             timeout = self.__get_new_timeout(timeout)
         selector, by = self.__recalculate_selector(selector, by)
         if self.__is_cdp_swap_needed():
-            self.cdp.click_nth_visible_element(selector, number)
+            self.cdp.click_nth_visible_element(selector, number, scroll=scroll)
             return
         self.wait_for_ready_state_complete()
         self.wait_for_element_present(selector, by=by, timeout=timeout)
@@ -2379,7 +2381,8 @@ class BaseCase(unittest.TestCase):
             pre_action_url = self.driver.current_url
         pre_window_count = len(self.driver.window_handles)
         try:
-            self.__scroll_to_element(element)
+            if scroll:
+                self.__scroll_to_element(element)
             self.__element_click(element)
         except (Stale_Exception, ENI_Exception, ECI_Exception):
             time.sleep(0.12)
@@ -2409,18 +2412,20 @@ class BaseCase(unittest.TestCase):
         ):
             self.__switch_to_newest_window_if_not_blank()
 
-    def click_if_visible(self, selector, by="css selector", timeout=0):
+    def click_if_visible(
+        self, selector, by="css selector", timeout=0, scroll=True
+    ):
         """If the page selector exists and is visible, clicks on the element.
         This method only clicks on the first matching element found.
         Use click_visible_elements() to click all matching elements.
         If a "timeout" is provided, waits that long for the element
         to appear before giving up and returning without a click()."""
         if self.__is_cdp_swap_needed():
-            self.cdp.click_if_visible(selector, timeout=timeout)
+            self.cdp.click_if_visible(selector, timeout=timeout, scroll=scroll)
             return
         self.wait_for_ready_state_complete()
         if self.is_element_visible(selector, by=by):
-            self.click(selector, by=by)
+            self.click(selector, by=by, scroll=scroll)
         elif timeout > 0:
             with suppress(Exception):
                 self.wait_for_element_visible(
@@ -2428,7 +2433,7 @@ class BaseCase(unittest.TestCase):
                 )
                 self.sleep(0.2)
             if self.is_element_visible(selector, by=by):
-                self.click(selector, by=by)
+                self.click(selector, by=by, scroll=scroll)
 
     def click_active_element(self):
         if self.__is_cdp_swap_needed():
@@ -2484,6 +2489,7 @@ class BaseCase(unittest.TestCase):
         mark=None,
         timeout=None,
         center=None,
+        scroll=True,
     ):
         """Click an element at an {X,Y}-offset location.
         {0,0} is the top-left corner of the element.
@@ -2500,6 +2506,7 @@ class BaseCase(unittest.TestCase):
             mark=mark,
             timeout=timeout,
             center=center,
+            scroll=scroll,
         )
 
     def double_click_with_offset(
@@ -2511,6 +2518,7 @@ class BaseCase(unittest.TestCase):
         mark=None,
         timeout=None,
         center=None,
+        scroll=True,
     ):
         """Double click an element at an {X,Y}-offset location.
         {0,0} is the top-left corner of the element.
@@ -2527,6 +2535,7 @@ class BaseCase(unittest.TestCase):
             mark=mark,
             timeout=timeout,
             center=center,
+            scroll=scroll,
         )
 
     def is_checked(self, selector, by="css selector", timeout=None):
@@ -14043,9 +14052,12 @@ class BaseCase(unittest.TestCase):
         mark=None,
         timeout=None,
         center=None,
+        scroll=True,
     ):
         if self.__is_cdp_swap_needed():
-            self.cdp.click_with_offset(selector, x, y, center=center)
+            self.cdp.click_with_offset(
+                selector, x, y, center=center, scroll=scroll
+            )
             return
         self.wait_for_ready_state_complete()
         if self.__needs_minimum_wait():
@@ -14061,9 +14073,13 @@ class BaseCase(unittest.TestCase):
         if self.demo_mode:
             self.__highlight(selector, by=by, loops=1)
         elif self.slow_mode:
-            self.__slow_scroll_to_element(element)
+            if scroll:
+                self.__slow_scroll_to_element(element)
+            else:
+                self.sleep(0.2)
         else:
-            self.__scroll_to_element(element, selector, by)
+            if scroll:
+                self.__scroll_to_element(element, selector, by)
         self.wait_for_ready_state_complete()
         if self.__needs_minimum_wait():
             time.sleep(0.03)

{seleniumbase-4.47.5 → seleniumbase-4.47.6}/seleniumbase/undetected/cdp_driver/tab.py

@@ -1629,11 +1629,17 @@ class Tab(Connection):
                     await element.click_async()
 
     async def click_with_offset(self, selector, x, y, center=False, timeout=5):
+        """Click an element at an {X,Y}-offset location.
+        {0,0} is the top-left corner of the element.
+        This method is used to click on CAPTCHAs."""
         element = await self.find(selector, timeout=timeout)
         await element.scroll_into_view_async()
         await element.mouse_click_with_offset_async(x=x, y=y, center=center)
 
     async def solve_captcha(self):
+        """This method does a few things to click a CAPTCHA:
+        1. Checks to see if a CAPTCHA is on the current page.
+        2. If found, calls `click_with_offset(*)` to click it."""
         await self.sleep(0.11)
         source = await self.get_html()
         if await self.__on_a_cf_turnstile_page(source):

{seleniumbase-4.47.5 → seleniumbase-4.47.6/seleniumbase.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: seleniumbase
-Version: 4.47.5
+Version: 4.47.6
 Summary: A complete web automation framework for end-to-end testing.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz
@@ -262,9 +262,9 @@ Dynamic: summary
 
 --------
 
-<p align="left">📓 Here's the stealthy architecture overview:</p>
+<h3 align="left">⚙️ Stealthy architecture flowchart:</h3>
 
-<img src="https://seleniumbase.github.io/other/sb_stealth.png" width="596" alt="Stealthy architecture overview" />
+<img src="https://seleniumbase.github.io/other/sb_stealth.png" width="596" alt="Stealthy architecture flowchart" />
 
 (For maximum stealth, use <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md">CDP Mode</a>, which includes <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/ReadMe.md">Stealthy Playwright Mode</a>)
 
@@ -280,6 +280,7 @@ sb = sb_cdp.Chrome(url)
 elements = sb.find_elements("span.titleline > a")
 for element in elements:
     print("* " + element.text)
+sb.driver.stop()
 ```
 
 --------
@@ -691,6 +692,7 @@ class MyTestClass(BaseCase):
 
 ```python
 self.open(url)  # Navigate the browser window to the URL.
+self.activate_cdp_mode()  # Activate CDP Mode from UC Mode.
 self.type(selector, text)  # Update the field with the text.
 self.click(selector)  # Click the element with the selector.
 self.click_link(link_text)  # Click the link containing text.
@@ -779,7 +781,7 @@ pytest [FILE_NAME.py]::[CLASS_NAME]::[METHOD_NAME]
 pynose [FILE_NAME.py]:[CLASS_NAME].[METHOD_NAME]
 ```
 
-<p>✅ No More Flaky Tests! SeleniumBase methods automatically wait for page elements to finish loading before interacting with them (<i>up to a timeout limit</i>). This means <b>you no longer need random <span><code translate="no">time.sleep()</code></span> statements</b> in your scripts.</p>
+<p>✅ No More Flaky Tests! SeleniumBase methods automatically wait for page elements to finish loading before interacting with them (<i>up to a timeout limit</i>).</p>
 <img src="https://img.shields.io/badge/Flaky%20Tests%3F-%20NO%21-11BBDD.svg" alt="NO MORE FLAKY TESTS!" />
 
 ✅ SeleniumBase supports all major browsers and operating systems: