seleniumbase 4.30.8__tar.gz → 4.31.1__tar.gz

{seleniumbase-4.30.8 → seleniumbase-4.31.1}/PKG-INFO

@@ -1,18 +1,20 @@
 Metadata-Version: 2.1
 Name: seleniumbase
-Version: 4.30.8
+Version: 4.31.1
 Summary: A complete web automation framework for end-to-end testing.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz
 Author-email: mdmintz@gmail.com
 Maintainer: Michael Mintz
 License: MIT
+Project-URL: Homepage, https://github.com/seleniumbase/SeleniumBase
 Project-URL: Changelog, https://github.com/seleniumbase/SeleniumBase/releases
 Project-URL: Download, https://pypi.org/project/seleniumbase/#files
-Project-URL: Gitter, https://gitter.im/seleniumbase/SeleniumBase
 Project-URL: Blog, https://seleniumbase.com/
+Project-URL: Discord, https://discord.gg/EdhQTn3EyE
 Project-URL: PyPI, https://pypi.org/project/seleniumbase/
 Project-URL: Source, https://github.com/seleniumbase/SeleniumBase
+Project-URL: Repository, https://github.com/seleniumbase/SeleniumBase
 Project-URL: Documentation, https://seleniumbase.io/
 Keywords: pytest,selenium,framework,automation,browser,testing,webdriver,seleniumbase,sbase,crawling,scraping
 Platform: Windows
@@ -32,7 +34,6 @@ Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
@@ -55,83 +56,65 @@ Classifier: Topic :: Software Development :: Testing
 Classifier: Topic :: Software Development :: Testing :: Acceptance
 Classifier: Topic :: Software Development :: Testing :: Traffic Generation
 Classifier: Topic :: Utilities
-Requires-Python: >=3.7
+Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: pip>=24.0; python_version < "3.8"
-Requires-Dist: pip>=24.1.2; python_version >= "3.8"
-Requires-Dist: packaging>=24.0; python_version < "3.8"
-Requires-Dist: packaging>=24.1; python_version >= "3.8"
-Requires-Dist: setuptools>=68.0.0; python_version < "3.8"
-Requires-Dist: setuptools~=70.2; python_version >= "3.8" and python_version < "3.10"
+Requires-Dist: pip>=24.1.2
+Requires-Dist: packaging>=24.1
+Requires-Dist: setuptools~=70.2; python_version < "3.10"
 Requires-Dist: setuptools>=70.2.0; python_version >= "3.10"
-Requires-Dist: wheel>=0.42.0; python_version < "3.8"
-Requires-Dist: wheel>=0.44.0; python_version >= "3.8"
+Requires-Dist: wheel>=0.44.0
 Requires-Dist: attrs>=24.2.0
 Requires-Dist: certifi>=2024.8.30
 Requires-Dist: exceptiongroup>=1.2.2
-Requires-Dist: filelock>=3.12.2; python_version < "3.8"
-Requires-Dist: filelock>=3.16.0; python_version >= "3.8"
-Requires-Dist: platformdirs>=4.0.0; python_version < "3.8"
-Requires-Dist: platformdirs>=4.3.2; python_version >= "3.8"
-Requires-Dist: typing-extensions>=4.12.2; python_version >= "3.8"
+Requires-Dist: filelock>=3.16.1
+Requires-Dist: fasteners>=0.19
+Requires-Dist: pynose>=1.5.3
+Requires-Dist: platformdirs>=4.3.6
+Requires-Dist: typing-extensions>=4.12.2
+Requires-Dist: sbvirtualdisplay>=1.3.0
+Requires-Dist: six>=1.16.0
 Requires-Dist: parse>=1.20.2
 Requires-Dist: parse-type>=0.6.3
-Requires-Dist: pyyaml==6.0.1; python_version < "3.8"
-Requires-Dist: pyyaml>=6.0.2; python_version >= "3.8"
-Requires-Dist: six==1.16.0
-Requires-Dist: idna==3.8
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: pygments>=2.18.0
+Requires-Dist: pyreadline3>=3.5.3; platform_system == "Windows"
+Requires-Dist: tabcompleter>=1.3.3
+Requires-Dist: pdbp>=1.5.4
+Requires-Dist: idna==3.10
 Requires-Dist: chardet==5.2.0
 Requires-Dist: charset-normalizer==3.3.2
 Requires-Dist: urllib3<2,>=1.26.20; python_version < "3.10"
 Requires-Dist: urllib3<2.3.0,>=1.26.20; python_version >= "3.10"
 Requires-Dist: requests==2.31.0
-Requires-Dist: pynose==1.5.2
 Requires-Dist: sniffio==1.3.1
 Requires-Dist: h11==0.14.0
 Requires-Dist: outcome==1.3.0.post0
-Requires-Dist: trio==0.22.2; python_version < "3.8"
-Requires-Dist: trio==0.26.2; python_version >= "3.8"
+Requires-Dist: trio==0.26.2
 Requires-Dist: trio-websocket==0.11.1
 Requires-Dist: wsproto==1.2.0
-Requires-Dist: websocket-client==1.8.0; python_version >= "3.8"
-Requires-Dist: selenium==4.11.2; python_version < "3.8"
-Requires-Dist: selenium==4.24.0; python_version >= "3.8"
+Requires-Dist: websocket-client==1.8.0
+Requires-Dist: selenium==4.25.0
 Requires-Dist: cssselect==1.2.0
 Requires-Dist: sortedcontainers==2.4.0
-Requires-Dist: fasteners==0.19
-Requires-Dist: execnet==2.0.2; python_version < "3.8"
-Requires-Dist: execnet==2.1.1; python_version >= "3.8"
+Requires-Dist: execnet==2.1.1
 Requires-Dist: iniconfig==2.0.0
-Requires-Dist: pluggy==1.2.0; python_version < "3.8"
-Requires-Dist: pluggy==1.5.0; python_version >= "3.8"
+Requires-Dist: pluggy==1.5.0
 Requires-Dist: py==1.11.0
-Requires-Dist: pytest==7.4.4; python_version < "3.8"
-Requires-Dist: pytest==8.3.3; python_version >= "3.8"
+Requires-Dist: pytest==8.3.3
 Requires-Dist: pytest-html==2.0.1
-Requires-Dist: pytest-metadata==3.0.0; python_version < "3.8"
-Requires-Dist: pytest-metadata==3.1.1; python_version >= "3.8"
+Requires-Dist: pytest-metadata==3.1.1
 Requires-Dist: pytest-ordering==0.6
-Requires-Dist: pytest-rerunfailures==13.0; python_version < "3.8"
-Requires-Dist: pytest-rerunfailures==14.0; python_version >= "3.8"
-Requires-Dist: pytest-xdist==3.5.0; python_version < "3.8"
-Requires-Dist: pytest-xdist==3.6.1; python_version >= "3.8"
+Requires-Dist: pytest-rerunfailures==14.0
+Requires-Dist: pytest-xdist==3.6.1
 Requires-Dist: parameterized==0.9.0
-Requires-Dist: sbvirtualdisplay==1.3.0
 Requires-Dist: behave==1.2.6
-Requires-Dist: soupsieve==2.4.1; python_version < "3.8"
-Requires-Dist: soupsieve==2.6; python_version >= "3.8"
+Requires-Dist: soupsieve==2.6
 Requires-Dist: beautifulsoup4==4.12.3
-Requires-Dist: pygments==2.17.2; python_version < "3.8"
-Requires-Dist: pygments==2.18.0; python_version >= "3.8"
-Requires-Dist: pyreadline3==3.4.1; platform_system == "Windows"
-Requires-Dist: tabcompleter==1.3.3
-Requires-Dist: pdbp==1.5.4
-Requires-Dist: colorama==0.4.6
 Requires-Dist: pyotp==2.9.0
 Requires-Dist: python-xlib==0.33; platform_system == "Linux"
-Requires-Dist: markdown-it-py==2.2.0; python_version < "3.8"
-Requires-Dist: markdown-it-py==3.0.0; python_version >= "3.8"
+Requires-Dist: markdown-it-py==3.0.0
 Requires-Dist: mdurl==0.1.2
 Requires-Dist: rich==13.8.1
 Provides-Extra: allure
@@ -139,10 +122,8 @@ Requires-Dist: allure-pytest>=2.13.5; extra == "allure"
 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.2.7; python_version < "3.8" and extra == "coverage"
-Requires-Dist: coverage>=7.6.1; python_version >= "3.8" and extra == "coverage"
-Requires-Dist: pytest-cov==4.1.0; python_version < "3.8" and extra == "coverage"
-Requires-Dist: pytest-cov>=5.0.0; python_version >= "3.8" and extra == "coverage"
+Requires-Dist: coverage>=7.6.1; extra == "coverage"
+Requires-Dist: pytest-cov>=5.0.0; extra == "coverage"
 Provides-Extra: flake8
 Requires-Dist: flake8==5.0.4; python_version < "3.9" and extra == "flake8"
 Requires-Dist: flake8==7.1.1; python_version >= "3.9" and extra == "flake8"
@@ -155,16 +136,13 @@ Provides-Extra: ipdb
 Requires-Dist: ipdb==0.13.13; extra == "ipdb"
 Requires-Dist: ipython==7.34.0; extra == "ipdb"
 Provides-Extra: pdfminer
-Requires-Dist: pdfminer.six==20221105; python_version < "3.8" and extra == "pdfminer"
-Requires-Dist: pdfminer.six==20240706; python_version >= "3.8" and extra == "pdfminer"
+Requires-Dist: pdfminer.six==20240706; extra == "pdfminer"
 Requires-Dist: cryptography==39.0.2; python_version < "3.9" and extra == "pdfminer"
 Requires-Dist: cryptography==43.0.1; python_version >= "3.9" and extra == "pdfminer"
-Requires-Dist: cffi==1.15.1; python_version < "3.8" and extra == "pdfminer"
-Requires-Dist: cffi==1.17.1; python_version >= "3.8" and extra == "pdfminer"
+Requires-Dist: cffi==1.17.1; extra == "pdfminer"
 Requires-Dist: pycparser==2.22; extra == "pdfminer"
 Provides-Extra: pillow
-Requires-Dist: Pillow==9.5.0; python_version < "3.8" and extra == "pillow"
-Requires-Dist: Pillow>=10.4.0; python_version >= "3.8" and extra == "pillow"
+Requires-Dist: Pillow>=10.4.0; 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
@@ -185,12 +163,17 @@ Requires-Dist: h2==4.1.0; extra == "selenium-wire"
 Requires-Dist: hpack==4.0.0; extra == "selenium-wire"
 Requires-Dist: hyperframe==6.0.1; extra == "selenium-wire"
 Requires-Dist: kaitaistruct==0.10; extra == "selenium-wire"
-Requires-Dist: pyasn1==0.5.1; python_version < "3.8" and extra == "selenium-wire"
-Requires-Dist: pyasn1==0.6.1; python_version >= "3.8" and extra == "selenium-wire"
+Requires-Dist: pyasn1==0.6.1; extra == "selenium-wire"
 Requires-Dist: zstandard==0.23.0; extra == "selenium-wire"
 
 <!-- SeleniumBase Docs -->
 
+<meta property="og:site_name" content="SeleniumBase">
+<meta property="og:title" content="SeleniumBase: Python Web Automation and E2E Testing" />
+<meta property="og:description" content="Fast, easy, and reliable Web/UI testing with Python." />
+<meta property="og:keywords" content="Python, pytest, selenium, webdriver, testing, automation, seleniumbase, framework, dashboard, recorder, reports, screenshots">
+<meta property="og:image" content="https://seleniumbase.github.io/cdn/img/mac_sb_logo_5b.png" />
+<link rel="icon" href="https://seleniumbase.github.io/img/logo7.png" />
 
 <h1>SeleniumBase</h1>
 
@@ -838,10 +821,12 @@ pytest test_coffee_cart.py --trace
 --sjw  # (Skip JS Waits for readyState to be "complete" or Angular to load.)
 --wfa  # (Wait for AngularJS to be done loading after specific web actions.)
 --pls=PLS  # (Set pageLoadStrategy on Chrome: "normal", "eager", or "none".)
---headless  # (Run tests in headless mode. The default arg on Linux OS.)
---headless2  # (Use the new headless mode, which supports extensions.)
+--headless  # (The default headless mode. Linux uses this mode by default.)
+--headless1  # (Use Chrome's old headless mode. Fast, but has limitations.)
+--headless2  # (Use Chrome's new headless mode, which supports extensions.)
 --headed  # (Run tests in headed/GUI mode on Linux OS, where not default.)
 --xvfb  # (Run tests using the Xvfb virtual display server on Linux OS.)
+--xvfb-metrics=STRING  # (Set Xvfb display size on Linux: "Width,Height".)
 --locale=LOCALE_CODE  # (Set the Language Locale Code for the web browser.)
 --interval=SECONDS  # (The autoplay interval for presentations & tour steps)
 --start-page=URL  # (The starting URL for the web browser when tests begin.)
@@ -886,6 +871,7 @@ pytest test_coffee_cart.py --trace
 --rcs | --reuse-class-session  # (Reuse session for tests in class.)
 --crumbs  # (Delete all cookies between tests reusing a session.)
 --disable-beforeunload  # (Disable the "beforeunload" event on Chrome.)
+--window-position=X,Y  # (Set the browser's starting window position.)
 --window-size=WIDTH,HEIGHT  # (Set the browser's starting window size.)
 --maximize  # (Start tests with the browser window maximized.)
 --screenshot  # (Save a screenshot at the end of each test.)
@@ -1054,7 +1040,7 @@ pytest test_suite.py --dashboard --html=report.html
 
 <img src="https://seleniumbase.github.io/cdn/img/dash_report.jpg" alt="Dashboard Pytest HTML Report" title="Dashboard Pytest HTML Report" width="520" />
 
-If viewing pytest html reports in [Jenkins](https://www.jenkins.io/), you may need to [configure Jenkins settings](https://stackoverflow.com/a/46197356) for the html to render correctly. This is due to [Jenkins CSP changes](https://www.jenkins.io/doc/book/system-administration/security/configuring-content-security-policy/).
+If viewing pytest html reports in [Jenkins](https://www.jenkins.io/), you may need to [configure Jenkins settings](https://stackoverflow.com/a/46197356/7058266) for the html to render correctly. This is due to [Jenkins CSP changes](https://www.jenkins.io/doc/book/system-administration/security/configuring-content-security-policy/).
 
 You can also use ``--junit-xml=report.xml`` to get an xml report instead. Jenkins can use this file to display better reporting for your tests.
 

{seleniumbase-4.30.8 → seleniumbase-4.31.1}/README.md

@@ -653,10 +653,12 @@ pytest test_coffee_cart.py --trace
 --sjw  # (Skip JS Waits for readyState to be "complete" or Angular to load.)
 --wfa  # (Wait for AngularJS to be done loading after specific web actions.)
 --pls=PLS  # (Set pageLoadStrategy on Chrome: "normal", "eager", or "none".)
---headless  # (Run tests in headless mode. The default arg on Linux OS.)
---headless2  # (Use the new headless mode, which supports extensions.)
+--headless  # (The default headless mode. Linux uses this mode by default.)
+--headless1  # (Use Chrome's old headless mode. Fast, but has limitations.)
+--headless2  # (Use Chrome's new headless mode, which supports extensions.)
 --headed  # (Run tests in headed/GUI mode on Linux OS, where not default.)
 --xvfb  # (Run tests using the Xvfb virtual display server on Linux OS.)
+--xvfb-metrics=STRING  # (Set Xvfb display size on Linux: "Width,Height".)
 --locale=LOCALE_CODE  # (Set the Language Locale Code for the web browser.)
 --interval=SECONDS  # (The autoplay interval for presentations & tour steps)
 --start-page=URL  # (The starting URL for the web browser when tests begin.)
@@ -701,6 +703,7 @@ pytest test_coffee_cart.py --trace
 --rcs | --reuse-class-session  # (Reuse session for tests in class.)
 --crumbs  # (Delete all cookies between tests reusing a session.)
 --disable-beforeunload  # (Disable the "beforeunload" event on Chrome.)
+--window-position=X,Y  # (Set the browser's starting window position.)
 --window-size=WIDTH,HEIGHT  # (Set the browser's starting window size.)
 --maximize  # (Start tests with the browser window maximized.)
 --screenshot  # (Save a screenshot at the end of each test.)
@@ -869,7 +872,7 @@ pytest test_suite.py --dashboard --html=report.html
 
 <img src="https://seleniumbase.github.io/cdn/img/dash_report.jpg" alt="Dashboard Pytest HTML Report" title="Dashboard Pytest HTML Report" width="520" />
 
-If viewing pytest html reports in [Jenkins](https://www.jenkins.io/), you may need to [configure Jenkins settings](https://stackoverflow.com/a/46197356) for the html to render correctly. This is due to [Jenkins CSP changes](https://www.jenkins.io/doc/book/system-administration/security/configuring-content-security-policy/).
+If viewing pytest html reports in [Jenkins](https://www.jenkins.io/), you may need to [configure Jenkins settings](https://stackoverflow.com/a/46197356/7058266) for the html to render correctly. This is due to [Jenkins CSP changes](https://www.jenkins.io/doc/book/system-administration/security/configuring-content-security-policy/).
 
 You can also use ``--junit-xml=report.xml`` to get an xml report instead. Jenkins can use this file to display better reporting for your tests.
 

{seleniumbase-4.30.8 → seleniumbase-4.31.1}/examples/custom_settings.py

@@ -64,6 +64,10 @@ DISABLE_CSP_ON_CHROME = False
 # If True and --proxy=IP_ADDRESS:PORT is invalid, then error immediately.
 RAISE_INVALID_PROXY_STRING_EXCEPTION = True
 
+# Default browser coordinates when opening new windows for tests.
+WINDOW_START_X = 20
+WINDOW_START_Y = 54
+
 # Default browser resolutions when opening new windows for tests.
 # (Headless resolutions take priority, and include all browsers.)
 # (Firefox starts maximized by default when running in GUI Mode.)

{seleniumbase-4.30.8 → seleniumbase-4.31.1}/examples/dialog_boxes/dialog_box_tour.py

@@ -108,7 +108,9 @@ class DialogBoxTests(BaseCase):
             self.highlight_type('input[aria-label="Search"]', text + "\n")
         else:
             self.open("https://en.wikipedia.org/wiki/Special:Search")
-            self.highlight_type('input[id*="search"]', text + "\n")
+            self.highlight_type('input[id*="search"]', text)
+            self.sleep(1)
+            self.click("#searchform button")
         self.wait_for_ready_state_complete()
         self.sleep(1)
         self.highlight("body")

{seleniumbase-4.30.8 → seleniumbase-4.31.1}/examples/handle_alert_test.py

@@ -7,6 +7,7 @@ class HandleAlertTests(BaseCase):
         self.open("about:blank")
         self.execute_script('window.alert("ALERT!!!");')
         self.sleep(1)  # Not needed (Lets you see the alert pop up)
+        self.assert_true(self.is_alert_present())
         self.accept_alert()
         self.sleep(1)  # Not needed (Lets you see the alert go away)
         self.execute_script('window.prompt("My Prompt","defaultText");')
@@ -15,6 +16,7 @@ class HandleAlertTests(BaseCase):
         self.assert_equal(alert.text, "My Prompt")  # Not input field
         self.dismiss_alert()
         self.sleep(1)  # Not needed (Lets you see the alert go away)
+        self.assert_false(self.is_alert_present())
         if self.browser == "safari" and self._reuse_session:
             # Alerts can freeze Safari if reusing the browser session
             self.driver.quit()

seleniumbase-4.31.1/examples/offline_examples/test_extended_driver.py

@@ -0,0 +1,61 @@
+import os
+import pytest
+from seleniumbase import BaseCase
+BaseCase.main(__name__, __file__)
+
+
+@pytest.mark.offline  # Can be run with: "pytest -m offline"
+class OfflineTests(BaseCase):
+    def test_extended_driver(self):
+        # Load a local html file into the web browser
+        dir_path = os.path.dirname(os.path.abspath(__file__))
+        file_path = os.path.join(dir_path, "demo_page.html")
+        self.load_html_file(file_path)
+
+        # Get the raw driver
+        driver = self.driver
+
+        # Assert that an element is visible on the page
+        driver.assert_element("tbody#tbodyId")
+
+        # Assert that a text substring appears in an element
+        driver.assert_text("Demo Page", "h1")
+
+        # Type text into various text fields and then assert
+        driver.type("#myTextInput", "This is Automated")
+        driver.type("textarea.area1", "Testing Time!\n")
+        driver.type('[name="preText2"]', "Typing Text!")
+        driver.assert_text("This is Automated", "#myTextInput")
+        driver.assert_text("Testing Time!\n", "textarea.area1")
+        driver.assert_text("Typing Text!", '[name="preText2"]')
+
+        # Hover & click a dropdown element and assert results
+        driver.assert_text("Automation Practice", "h3")
+        driver.js_click("#dropOption2")
+        driver.assert_text("Link Two Selected", "h3")
+
+        # Click a button and then verify the expected results
+        driver.assert_text("This Text is Green", "#pText")
+        driver.click('button:contains("Click Me")')
+        driver.assert_text("This Text is Purple", "#pText")
+
+        # Assert that the given SVG is visible on the page
+        driver.assert_element('svg[name="svgName"]')
+
+        # Assert an element located inside an iframe
+        self.assert_false(driver.is_element_visible("img"))
+        driver.switch_to.frame("myFrame1")
+        self.assert_true(driver.is_element_visible("img"))
+        driver.switch_to.default_content()
+
+        # Assert text located inside an iframe
+        self.assert_false(driver.is_text_visible("iFrame Text"))
+        driver.switch_to.frame("myFrame2")
+        self.assert_true(driver.is_text_visible("iFrame Text"))
+        driver.switch_to.default_content()
+
+        # Assert exact text
+        driver.assert_exact_text("Demo Page", "h1")
+
+        # Highlight a page element (Also asserts visibility)
+        driver.highlight("h2")

seleniumbase-4.31.1/examples/presenter/multi_uc.py

@@ -0,0 +1,24 @@
+"""Part of the UC presentation"""
+import pytest
+from random import randint
+from seleniumbase import BaseCase
+BaseCase.main(__name__, __file__, "--uc", "-n3")
+
+
+@pytest.mark.parametrize("", [[]] * 3)
+def test_multi_threaded(sb):
+    url = "https://gitlab.com/users/sign_in"
+    sb.driver.uc_open_with_reconnect(url, 3)
+    sb.set_window_rect(randint(0, 755), randint(38, 403), 700, 500)
+    try:
+        sb.assert_text("Username", '[for="user_login"]', timeout=3)
+        sb.post_message("SeleniumBase wasn't detected", duration=4)
+        sb._print("\n Success! Website did not detect Selenium! ")
+    except Exception:
+        sb.driver.uc_open_with_reconnect(url, 3)
+        try:
+            sb.assert_text("Username", '[for="user_login"]', timeout=3)
+            sb.post_message("SeleniumBase wasn't detected", duration=4)
+            sb._print("\n Success! Website did not detect Selenium! ")
+        except Exception:
+            sb.fail('Selenium was detected! Try using: "pytest --uc"')