seleniumbase 4.40.1__py3-none-any.whl → 4.40.3__py3-none-any.whl

sbase/steps.py

@@ -1191,6 +1191,15 @@ def set_attributes(context, selector, attribute, value):
     sb.set_attributes(selector, attribute, value)
 
 
+@step("Save page source to logs")
+@step("Save the page source to the logs")
+@step("User saves page source to logs")
+@step("User saves the page source to the logs")
+def save_page_source_to_logs(context):
+    sb = context.sb
+    sb.save_page_source_to_logs()
+
+
 @step("Activate CDP Mode")
 @step("User activates CDP Mode")
 def activate_cdp_mode(context):

seleniumbase/__version__.py

@@ -1,2 +1,2 @@
 # seleniumbase package
-__version__ = "4.40.1"
+__version__ = "4.40.3"

seleniumbase/behave/behave_helper.py

@@ -522,6 +522,8 @@ def generate_gherkin(srt_actions):
                 )
         elif action[0] == "ss_tl":
             sb_actions.append("Save screenshot to logs")
+        elif action[0] == "spstl":
+            sb_actions.append("Save page source to logs")
         elif action[0] == "sh_fc":
             sb_actions.append("Show file choosers")
         elif action[0] == "pr_da":

seleniumbase/core/recorder_helper.py

@@ -556,6 +556,9 @@ def generate_sbase_code(srt_actions):
         elif action[0] == "ss_tl":
             method = "save_screenshot_to_logs"
             sb_actions.append("self.%s()" % method)
+        elif action[0] == "spstl":
+            method = "save_page_source_to_logs"
+            sb_actions.append("self.%s()" % method)
         elif action[0] == "sh_fc":
             method = "show_file_choosers"
             sb_actions.append("self.%s()" % method)

seleniumbase/fixtures/base_case.py

@@ -132,6 +132,7 @@ class BaseCase(unittest.TestCase):
         self.__called_teardown = False
         self.__start_time_ms = int(time.time() * 1000.0)
         self.__requests_timeout = None
+        self.__page_source_count = 0
         self.__screenshot_count = 0
         self.__logs_data_count = 0
         self.__last_data_file = None
@@ -3590,7 +3591,7 @@ class BaseCase(unittest.TestCase):
         self.set_window_rect(x, y, width, height)
         self.__demo_mode_pause_if_active(tiny=True)
 
-    def switch_to_frame(self, frame="iframe", timeout=None):
+    def switch_to_frame(self, frame="iframe", timeout=None, invisible=False):
         """Wait for an iframe to appear, and switch to it. This should be
         usable as a drop-in replacement for driver.switch_to.frame().
         The iframe identifier can be a selector, an index, an id, a name,
@@ -3598,7 +3599,8 @@ class BaseCase(unittest.TestCase):
         for visible iframes with a string selector.
         @Params
         frame - the frame element, name, id, index, or selector
-        timeout - the time to wait for the alert in seconds """
+        timeout - the time to wait for the alert in seconds
+        invisible - if True, the iframe can be invisible """
         self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
@@ -3648,7 +3650,9 @@ class BaseCase(unittest.TestCase):
             time.sleep(0.035)
             if self.undetectable:
                 time.sleep(0.035)
-        page_actions.switch_to_frame(self.driver, frame, timeout)
+        page_actions.switch_to_frame(
+            self.driver, frame, timeout, invisible=invisible
+        )
         self.wait_for_ready_state_complete()
         if self.__needs_minimum_wait():
             time.sleep(0.015)
@@ -4512,6 +4516,40 @@ class BaseCase(unittest.TestCase):
         sb_config._has_logs = True
         return page_actions.save_screenshot(self.driver, name, test_logpath)
 
+    def save_page_source_to_logs(self, name=None):
+        """Saves the page HTML to the "latest_logs/" folder.
+        Naming is automatic:
+            If NO NAME provided: "_1_source.html", "_2_source.html", etc.
+            If NAME IS provided, then: "_1_name.html", "_2_name.html", etc.
+        (The last_page / failure page_source is always "page_source.html")"""
+        if not self.__is_cdp_swap_needed():
+            self.wait_for_ready_state_complete()
+        test_logpath = os.path.join(self.log_path, self.__get_test_id())
+        self.__create_log_path_as_needed(test_logpath)
+        if name:
+            name = str(name)
+        self.__page_source_count += 1
+        if not name or len(name) == 0:
+            name = "_%s_source.html" % self.__page_source_count
+        else:
+            pre_name = "_%s_" % self.__page_source_count
+            if len(name) >= 4 and name[-4:].lower() == ".html":
+                name = name[:-4]
+                if len(name) == 0:
+                    name = "source"
+            name = "%s%s.html" % (pre_name, name)
+        if self.recorder_mode:
+            url = self.get_current_url()
+            if url and len(url) > 0:
+                if ("http:") in url or ("https:") in url or ("file:") in url:
+                    if self.get_session_storage_item("pause_recorder") == "no":
+                        time_stamp = self.execute_script("return Date.now();")
+                        origin = self.get_origin()
+                        action = ["spstl", "", origin, time_stamp]
+                        self.__extra_actions.append(action)
+        sb_config._has_logs = True
+        return page_actions.save_page_source(self.driver, name, test_logpath)
+
     def save_data_to_logs(self, data, file_name=None):
         """Saves data to the "latest_logs/" data folder of the current test.
         If no file_name, file_name becomes: "data_1.txt", "data_2.txt", etc.
@@ -5470,6 +5508,7 @@ class BaseCase(unittest.TestCase):
         ext_actions.append("s_scr")
         ext_actions.append("ss_tf")
         ext_actions.append("ss_tl")
+        ext_actions.append("spstl")
         ext_actions.append("da_el")
         ext_actions.append("da_ep")
         ext_actions.append("da_te")

seleniumbase/fixtures/page_actions.py

@@ -1572,7 +1572,9 @@ def wait_for_and_switch_to_alert(driver, timeout=settings.LARGE_TIMEOUT):
     timeout_exception(Exception, message)
 
 
-def switch_to_frame(driver, frame, timeout=settings.SMALL_TIMEOUT):
+def switch_to_frame(
+    driver, frame, timeout=settings.SMALL_TIMEOUT, invisible=False
+):
     """
     Wait for an iframe to appear, and switch to it. This should be
     usable as a drop-in replacement for driver.switch_to.frame().
@@ -1580,6 +1582,7 @@ def switch_to_frame(driver, frame, timeout=settings.SMALL_TIMEOUT):
     driver - the webdriver object (required)
     frame - the frame element, name, id, index, or selector
     timeout - the time to wait for the alert in seconds
+    invisible - if True, the iframe can be invisible
     """
     _reconnect_if_disconnected(driver)
     start_ms = time.time() * 1000.0
@@ -1596,7 +1599,10 @@ def switch_to_frame(driver, frame, timeout=settings.SMALL_TIMEOUT):
                     by = "xpath"
                 else:
                     by = "css selector"
-                if is_element_visible(driver, frame, by=by):
+                if (
+                    is_element_visible(driver, frame, by=by)
+                    or (invisible and is_element_present(driver, frame, by=by))
+                ):
                     with suppress(Exception):
                         element = driver.find_element(by=by, value=frame)
                         driver.switch_to.frame(element)
@@ -1608,8 +1614,12 @@ def switch_to_frame(driver, frame, timeout=settings.SMALL_TIMEOUT):
     plural = "s"
     if timeout == 1:
         plural = ""
-    message = "Frame {%s} was not visible after %s second%s!" % (
+    presence = "visible"
+    if invisible:
+        presence = "present"
+    message = "Frame {%s} was not %s after %s second%s!" % (
         frame,
+        presence,
         timeout,
         plural,
     )

{seleniumbase-4.40.1.dist-info → seleniumbase-4.40.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: seleniumbase
-Version: 4.40.1
+Version: 4.40.3
 Summary: A complete web automation framework for end-to-end testing.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz
@@ -67,7 +67,7 @@ Requires-Dist: setuptools~=70.2; python_version < "3.10"
 Requires-Dist: setuptools>=80.9.0; python_version >= "3.10"
 Requires-Dist: wheel>=0.45.1
 Requires-Dist: attrs>=25.3.0
-Requires-Dist: certifi>=2025.6.15
+Requires-Dist: certifi>=2025.7.9
 Requires-Dist: exceptiongroup>=1.3.0
 Requires-Dist: websockets~=13.1; python_version < "3.9"
 Requires-Dist: websockets>=15.0.1; python_version >= "3.9"
@@ -108,7 +108,7 @@ Requires-Dist: wsproto==1.2.0
 Requires-Dist: websocket-client==1.8.0
 Requires-Dist: selenium==4.27.1; python_version < "3.9"
 Requires-Dist: selenium==4.32.0; python_version >= "3.9" and python_version < "3.10"
-Requires-Dist: selenium==4.34.1; python_version >= "3.10"
+Requires-Dist: selenium==4.34.2; python_version >= "3.10"
 Requires-Dist: cssselect==1.2.0; python_version < "3.9"
 Requires-Dist: cssselect==1.3.0; python_version >= "3.9"
 Requires-Dist: sortedcontainers==2.4.0

{seleniumbase-4.40.1.dist-info → seleniumbase-4.40.3.dist-info}/RECORD

@@ -1,11 +1,11 @@
 sbase/__init__.py,sha256=02izDj786GVBT0bpSq2Q2O8uwSxtyT09pnobZz91ML8,605
 sbase/__main__.py,sha256=G0bVB1-DM4PGwQ1KyOupaWCs4ePbChZNNWuX2htim5U,647
-sbase/steps.py,sha256=_WvAjydKqZfTdnZW9LPKkRty-g-lfdUPmLqnZj6ulcs,43013
+sbase/steps.py,sha256=EdJyNVJ1yxoHsc7qp8kzx0EESIkOh_033yLCvmaPcs4,43281
 seleniumbase/__init__.py,sha256=JFEY9P5QJqsa1M6ghzLMH2eIPQyh85iglCaQwg8Y8z4,2498
 seleniumbase/__main__.py,sha256=dn1p6dgCchmcH1zzTzzQvFwwdQQqnTGH6ULV9m4hv24,654
-seleniumbase/__version__.py,sha256=-yI_EbTAoSA-4bx2PJ3MMzIxhYRoE314euG41GQuyRg,46
+seleniumbase/__version__.py,sha256=6jQcUCtLJbgco1ARBRYHuIHXig8TBijTdYXDGLd4ERA,46
 seleniumbase/behave/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-seleniumbase/behave/behave_helper.py,sha256=elkl8P9eLulRAioLstE9baYNM9N_PHBmAOcajX-pH_Y,24198
+seleniumbase/behave/behave_helper.py,sha256=f4CdiSSYM3gMAicSKWJInkVGFwpGXtHMD8fikTehopQ,24291
 seleniumbase/behave/behave_sb.py,sha256=guLihFsr1uJ4v2AR3r3Vy_BTeHrHwy2JEJxhp-MVnZA,59872
 seleniumbase/behave/steps.py,sha256=8-N-NB2tnDsxaP4LSg-uSBgbwZYMS6ZEL1oggO1PCoU,390
 seleniumbase/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -47,7 +47,7 @@ seleniumbase/core/jqc_helper.py,sha256=2DDQr9Q2jSSZqFzX588jLlUM9oJvyrRWq2aORSIPU
 seleniumbase/core/log_helper.py,sha256=JvB3FyOJJkVAP5RZXUuap468LIacqlO1UsqtEAVTfG4,23612
 seleniumbase/core/mysql.py,sha256=X1McqBWCzN9DndyBbNrVg9_kvtaByVhodiXYkGbn36A,3955
 seleniumbase/core/proxy_helper.py,sha256=pZ1NboNfziHU3vWZLOZLX-qkfM3oKSnpc3omQf9EUQQ,8809
-seleniumbase/core/recorder_helper.py,sha256=fNGjbapXmEsht54x1o6Igk198QdnPxDDnjUOzQxNhNQ,25055
+seleniumbase/core/recorder_helper.py,sha256=OBqNiCC_11ctpsD72KV4YUaKovmSpvs14HP1gwFesBA,25190
 seleniumbase/core/report_helper.py,sha256=AIl6Qava2yW1uSzbLpJBlPlYDz0KE-rVhogh8hsGWBo,12201
 seleniumbase/core/s3_manager.py,sha256=z_4qx2jI_gtK5r3niGXgEOBpfMUicUCOciowai50MP4,3529
 seleniumbase/core/sb_cdp.py,sha256=2KYfNQQBjUa_o2oMaGlzmHpGuvz-SJ9baGfxVyjOCSM,94104
@@ -67,12 +67,12 @@ seleniumbase/extensions/disable_csp.zip,sha256=5RvomXnm2PdivUVcxTV6jfvD8WhTEsQYH
 seleniumbase/extensions/recorder.zip,sha256=JEE_FVEvlS63cFQbVLEroIyPSS91nWCDL0MhjVrmIpk,11813
 seleniumbase/extensions/sbase_ext.zip,sha256=3s1N8zrVaMz8RQEOIoBzC3KDjtmHwVZRvVsX25Odr_s,8175
 seleniumbase/fixtures/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-seleniumbase/fixtures/base_case.py,sha256=ub5qfdUW046h1p24C3JVWtf7wQPLfHscD39HuHez0ys,735066
+seleniumbase/fixtures/base_case.py,sha256=V2qjsxtpJhKqmtAN6QhIKlAZMRIyDcI1thF0bcxYtuE,736960
 seleniumbase/fixtures/constants.py,sha256=WMrItuNyKq3XVJ64NluLIRc4gJCxDw8K8qXED0b9S2w,13752
 seleniumbase/fixtures/css_to_xpath.py,sha256=9ouDB1xl4MJ2os6JOgTIAyHKOQfuxtxvXC3O5hSnEKA,1954
 seleniumbase/fixtures/errors.py,sha256=KyxuEVx_e3MPhVrJfNIa_3ltMpbCFxfy_jxK8RFNTns,555
 seleniumbase/fixtures/js_utils.py,sha256=Ykt019DFP8S27o8Kai_ihT01qQWo3RqHUeljqOEUdFU,52247
-seleniumbase/fixtures/page_actions.py,sha256=55FUYDkgdIjMOo54oCf3BXr0ZpVX48tAteWfM0GcX4o,72114
+seleniumbase/fixtures/page_actions.py,sha256=pFhFMc0EZ9kdWR68t669aW7bRuH2hSVZuC1iI_4XVHE,72395
 seleniumbase/fixtures/page_utils.py,sha256=H1iV8f9vDyEy87DBntyiBXC_tg8HskcebUOAJVn0hxE,12160
 seleniumbase/fixtures/shared_utils.py,sha256=G6CsE-Adt-GfuZF-71jXWKSIQW7YZPx8FIM24pVd_yI,8368
 seleniumbase/fixtures/unittest_helper.py,sha256=sfZ92rZeBAn_sF_yQ3I6_I7h3lyU5-cV_UMegBNoEm8,1294
@@ -137,9 +137,9 @@ seleniumbase/utilities/selenium_grid/start-grid-hub.bat,sha256=Ftq-GrAKRYH2ssDPr
 seleniumbase/utilities/selenium_grid/start-grid-hub.sh,sha256=KADv0RUHONLL2_I443QFK8PryBpDmKn5Gy0s4o0vDSM,106
 seleniumbase/utilities/selenium_ide/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 seleniumbase/utilities/selenium_ide/convert_ide.py,sha256=pZFnqEJQEKZPyNFjkLD29s2HPQgCrWW9XJWpCPhWOoM,31691
-seleniumbase-4.40.1.dist-info/licenses/LICENSE,sha256=BRblZsX7HyPUjQmYTiyWr_e9tzWvmR3R4SFclM2R3W0,1085
-seleniumbase-4.40.1.dist-info/METADATA,sha256=uBB3zk9j5RzNQikjWZtVebswfSe5W1SYxsegKY9TBaA,87295
-seleniumbase-4.40.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-seleniumbase-4.40.1.dist-info/entry_points.txt,sha256=CNrh2EKNaHYEhO6pP1RJyVLB99LkDDYX7TnUK8xfjqk,623
-seleniumbase-4.40.1.dist-info/top_level.txt,sha256=4N97aBOQ8ETCnDnokBsWb07lJfTaq3C1ZzYRxvLMxqU,19
-seleniumbase-4.40.1.dist-info/RECORD,,
+seleniumbase-4.40.3.dist-info/licenses/LICENSE,sha256=BRblZsX7HyPUjQmYTiyWr_e9tzWvmR3R4SFclM2R3W0,1085
+seleniumbase-4.40.3.dist-info/METADATA,sha256=ZcQxnIRpNtv7tX84C27E3W22hNtRZ6HKGLuig4S71N8,87294
+seleniumbase-4.40.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+seleniumbase-4.40.3.dist-info/entry_points.txt,sha256=CNrh2EKNaHYEhO6pP1RJyVLB99LkDDYX7TnUK8xfjqk,623
+seleniumbase-4.40.3.dist-info/top_level.txt,sha256=4N97aBOQ8ETCnDnokBsWb07lJfTaq3C1ZzYRxvLMxqU,19
+seleniumbase-4.40.3.dist-info/RECORD,,