seleniumbase 4.33.9__tar.gz → 4.33.11__tar.gz

{seleniumbase-4.33.9/seleniumbase.egg-info → seleniumbase-4.33.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: seleniumbase
-Version: 4.33.9
+Version: 4.33.11
 Summary: A complete web automation framework for end-to-end testing.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz
@@ -65,7 +65,7 @@ Requires-Dist: setuptools~=70.2; python_version < "3.10"
 Requires-Dist: setuptools>=75.6.0; python_version >= "3.10"
 Requires-Dist: wheel>=0.45.1
 Requires-Dist: attrs>=24.2.0
-Requires-Dist: certifi>=2024.8.30
+Requires-Dist: certifi>=2024.12.14
 Requires-Dist: exceptiongroup>=1.2.2
 Requires-Dist: websockets~=13.1; python_version < "3.9"
 Requires-Dist: websockets>=14.1; python_version >= "3.9"
@@ -236,21 +236,60 @@ Requires-Dist: zstandard==0.23.0; extra == "selenium-wire"
 
 📚 Learn from [**over 200 examples** in the **SeleniumBase/examples/** folder](https://github.com/seleniumbase/SeleniumBase/tree/master/examples).
 
-👤 Note that <span translate="no">SeleniumBase</span> <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md"><b>UC Mode</b> (Stealth Mode) has its own ReadMe</a>.
+🐙 Note that <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md"><b>UC Mode</b></a> and <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md"><b>CDP Mode</b></a> (Stealth Mode) have separate docs</a>.
 
-🐙 Also note that Seleniumbase <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md"><b>CDP Mode</b> has its own separate ReadMe</a>.
+ℹ️ 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).
 
-ℹ️ Scripts can be called via <code translate="no"><b>python</b></code>, although some <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/syntax_formats.md">Syntax Formats</a> 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).
+--------
 
-<p align="left">📗 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py">my_first_test.py</a>, which tests login, shopping, and checkout:</p>
+<p align="left">📗 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_google.py">raw_google.py</a>, which performs a Google search:</p>
 
-```bash
-pytest my_first_test.py
+```python
+from seleniumbase import SB
+
+with SB(test=True, ad_block=True, locale_code="en") as sb:
+    sb.open("https://google.com/ncr")
+    sb.type('[title="Search"]', "SeleniumBase GitHub page\n")
+    sb.click('[href*="github.com/seleniumbase/SeleniumBase"]')
+    sb.save_screenshot_to_logs()  # (See ./latest_logs folder)
+    print(sb.get_page_title())
 ```
 
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py"><img src="https://seleniumbase.github.io/cdn/gif/fast_swag_2.gif" alt="SeleniumBase Test" title="SeleniumBase Test" width="520" /></a>
+> `python raw_google.py`
 
-> ``pytest`` uses ``--chrome`` by default unless set differently.
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_google.py"><img src="https://seleniumbase.github.io/cdn/gif/google_search.gif" alt="SeleniumBase Test" title="SeleniumBase Test" width="480" /></a>
+
+--------
+
+<p align="left">📗 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_get_swag.py">test_get_swag.py</a>, which tests a fake shopping site:</p>
+
+```python
+from seleniumbase import BaseCase
+BaseCase.main(__name__, __file__)  # Call pytest
+
+class MyTestClass(BaseCase):
+    def test_swag_labs(self):
+        self.open("https://www.saucedemo.com")
+        self.type("#user-name", "standard_user")
+        self.type("#password", "secret_sauce\n")
+        self.assert_element("div.inventory_list")
+        self.click('button[name*="backpack"]')
+        self.click("#shopping_cart_container a")
+        self.assert_text("Backpack", "div.cart_item")
+        self.click("button#checkout")
+        self.type("input#first-name", "SeleniumBase")
+        self.type("input#last-name", "Automation")
+        self.type("input#postal-code", "77123")
+        self.click("input#continue")
+        self.click("button#finish")
+        self.assert_text("Thank you for your order!")
+```
+
+> `pytest test_get_swag.py`
+
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_get_swag.py"><img src="https://seleniumbase.github.io/cdn/gif/fast_swag_2.gif" alt="SeleniumBase Test" title="SeleniumBase Test" width="520" /></a>
+
+> (The default browser is ``--chrome`` if not set.)
 
 --------
 
@@ -344,7 +383,7 @@ With raw Selenium, that requires more code:<br />
 
 <p>📚 <b>Learn about different ways of writing tests:</b></p>
 
-<p align="left">📘📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_simple_login.py">test_simple_login.py</a>, which uses <code translate="no"><a href="https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/fixtures/base_case.py">BaseCase</a></code> class inheritance, and runs with <a href="https://docs.pytest.org/en/latest/how-to/usage.html">pytest</a> or <a href="https://github.com/mdmintz/pynose">pynose</a>. (Use <code translate="no">self.driver</code> to access Selenium's raw <code translate="no">driver</code>.)</p>
+<p align="left">📗📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_simple_login.py">test_simple_login.py</a>, which uses <code translate="no"><a href="https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/fixtures/base_case.py">BaseCase</a></code> class inheritance, and runs with <a href="https://docs.pytest.org/en/latest/how-to/usage.html">pytest</a> or <a href="https://github.com/mdmintz/pynose">pynose</a>. (Use <code translate="no">self.driver</code> to access Selenium's raw <code translate="no">driver</code>.)</p>
 
 ```python
 from seleniumbase import BaseCase
@@ -363,22 +402,7 @@ class TestSimpleLogin(BaseCase):
         self.assert_text("signed out", "#top_message")
 ```
 
-<p align="left">📗📝 Here's a test from <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/sb_fixture_tests.py">sb_fixture_tests.py</a>, which uses the <b><code translate="no">sb</code></b> <code translate="no">pytest</code> fixture. Runs with <a href="https://docs.pytest.org/en/latest/how-to/usage.html">pytest</a>. (Use <code translate="no">sb.driver</code> to access Selenium's raw <code translate="no">driver</code>.)</p>
-
-```python
-def test_sb_fixture_with_no_class(sb):
-    sb.open("seleniumbase.io/simple/login")
-    sb.type("#username", "demo_user")
-    sb.type("#password", "secret_pass")
-    sb.click('a:contains("Sign in")')
-    sb.assert_exact_text("Welcome!", "h1")
-    sb.assert_element("img#image1")
-    sb.highlight("#image1")
-    sb.click_link("Sign out")
-    sb.assert_text("signed out", "#top_message")
-```
-
-<p align="left">📙📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_login_sb.py">raw_login_sb.py</a>, which uses the <b><code translate="no">SB</code></b> Context Manager. Runs with pure <code translate="no">python</code>. (Use <code translate="no">sb.driver</code> to access Selenium's raw <code translate="no">driver</code>.)</p>
+<p align="left">📘📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_login_sb.py">raw_login_sb.py</a>, which uses the <b><code translate="no">SB</code></b> Context Manager. Runs with pure <code translate="no">python</code>. (Use <code translate="no">sb.driver</code> to access Selenium's raw <code translate="no">driver</code>.)</p>
 
 ```python
 from seleniumbase import SB
@@ -395,24 +419,7 @@ with SB() as sb:
     sb.assert_text("signed out", "#top_message")
 ```
 
-<p align="left">📔📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_login_context.py">raw_login_context.py</a>, which uses the <b><code translate="no">DriverContext</code></b> Manager. Runs with pure <code translate="no">python</code>. (The <code translate="no">driver</code> is an improved version of Selenium's raw <code translate="no">driver</code>, with more methods.)</p>
-
-```python
-from seleniumbase import DriverContext
-
-with DriverContext() as driver:
-    driver.open("seleniumbase.io/simple/login")
-    driver.type("#username", "demo_user")
-    driver.type("#password", "secret_pass")
-    driver.click('a:contains("Sign in")')
-    driver.assert_exact_text("Welcome!", "h1")
-    driver.assert_element("img#image1")
-    driver.highlight("#image1")
-    driver.click_link("Sign out")
-    driver.assert_text("signed out", "#top_message")
-```
-
-<p align="left">📔📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_login_driver.py">raw_login_driver.py</a>, which uses the <b><code translate="no">Driver</code></b> Manager. Runs with pure <code translate="no">python</code>. (The <code>driver</code> is an improved version of Selenium's raw <code translate="no">driver</code>, with more methods.)</p>
+<p align="left">📙📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_login_driver.py">raw_login_driver.py</a>, which uses the <b><code translate="no">Driver</code></b> Manager. Runs with pure <code translate="no">python</code>. (The <code>driver</code> is an improved version of Selenium's raw <code translate="no">driver</code>, with more methods.)</p>
 
 ```python
 from seleniumbase import Driver
@@ -432,23 +439,6 @@ finally:
     driver.quit()
 ```
 
-<p align="left">📕📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/behave_bdd/features/login_app.feature">login_app.feature</a>, which uses <a translate="no" href="https://behave.readthedocs.io/en/stable/gherkin.html#features" target="_blank">behave-BDD Gherkin</a> syntax. Runs with <code translate="no">behave</code>. (<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/behave_bdd/ReadMe.md">Learn about the <b>SeleniumBase behave-BDD</b> integration</a>)</p>
-
-```gherkin
-Feature: SeleniumBase scenarios for the Simple App
-
-  Scenario: Verify the Simple App (Login / Logout)
-    Given Open "seleniumbase.io/simple/login"
-    And Type "demo_user" into "#username"
-    And Type "secret_pass" into "#password"
-    And Click 'a:contains("Sign in")'
-    And Assert exact text "Welcome!" in "h1"
-    And Assert element "img#image1"
-    And Highlight "#image1"
-    And Click link "Sign out"
-    And Assert text "signed out" in "#top_message"
-```
-
 --------
 
 <a id="python_installation"></a>
@@ -547,20 +537,21 @@ pip install -e .
 <summary> ▶️ Here's sample output from a chromedriver download. (<b>click to expand</b>)</summary>
 
 ```bash
-*** chromedriver to download = 121.0.6167.85 (Latest Stable) 
+*** chromedriver to download = 131.0.6778.108 (Latest Stable) 
 
 Downloading chromedriver-mac-arm64.zip from:
-https://storage.googleapis.com/chrome-for-testing-public/121.0.6167.85/mac-arm64/chromedriver-mac-arm64.zip ...
+https://storage.googleapis.com/chrome-for-testing-public/131.0.6778.108/mac-arm64/chromedriver-mac-arm64.zip ...
 Download Complete!
 
 Extracting ['chromedriver'] from chromedriver-mac-arm64.zip ...
 Unzip Complete!
 
 The file [chromedriver] was saved to:
-/Users/michael/github/SeleniumBase/seleniumbase/drivers/chromedriver
+~/github/SeleniumBase/seleniumbase/drivers/
+chromedriver
 
-Making [chromedriver 121.0.6167.85] executable ...
-[chromedriver 121.0.6167.85] is now ready for use!
+Making [chromedriver 131.0.6778.108] executable ...
+[chromedriver 131.0.6778.108] is now ready for use!
 ```
 
 </details>
@@ -580,7 +571,7 @@ pytest my_first_test.py
 
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py"><img src="https://seleniumbase.github.io/cdn/gif/fast_swag_2.gif" alt="SeleniumBase Test" title="SeleniumBase Test" width="520" /></a>
 
-<p align="left"><b>Here's the code for <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py">my_first_test.py</a>:</b></p>
+<p align="left"><b>Here's the full code for <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py">my_first_test.py</a>:</b></p>
 
 ```python
 from seleniumbase import BaseCase

{seleniumbase-4.33.9 → seleniumbase-4.33.11}/README.md

@@ -60,21 +60,60 @@
 
 📚 Learn from [**over 200 examples** in the **SeleniumBase/examples/** folder](https://github.com/seleniumbase/SeleniumBase/tree/master/examples).
 
-👤 Note that <span translate="no">SeleniumBase</span> <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md"><b>UC Mode</b> (Stealth Mode) has its own ReadMe</a>.
+🐙 Note that <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md"><b>UC Mode</b></a> and <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md"><b>CDP Mode</b></a> (Stealth Mode) have separate docs</a>.
 
-🐙 Also note that Seleniumbase <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md"><b>CDP Mode</b> has its own separate ReadMe</a>.
+ℹ️ 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).
 
-ℹ️ Scripts can be called via <code translate="no"><b>python</b></code>, although some <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/syntax_formats.md">Syntax Formats</a> 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).
+--------
 
-<p align="left">📗 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py">my_first_test.py</a>, which tests login, shopping, and checkout:</p>
+<p align="left">📗 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_google.py">raw_google.py</a>, which performs a Google search:</p>
 
-```bash
-pytest my_first_test.py
+```python
+from seleniumbase import SB
+
+with SB(test=True, ad_block=True, locale_code="en") as sb:
+    sb.open("https://google.com/ncr")
+    sb.type('[title="Search"]', "SeleniumBase GitHub page\n")
+    sb.click('[href*="github.com/seleniumbase/SeleniumBase"]')
+    sb.save_screenshot_to_logs()  # (See ./latest_logs folder)
+    print(sb.get_page_title())
 ```
 
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py"><img src="https://seleniumbase.github.io/cdn/gif/fast_swag_2.gif" alt="SeleniumBase Test" title="SeleniumBase Test" width="520" /></a>
+> `python raw_google.py`
 
-> ``pytest`` uses ``--chrome`` by default unless set differently.
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_google.py"><img src="https://seleniumbase.github.io/cdn/gif/google_search.gif" alt="SeleniumBase Test" title="SeleniumBase Test" width="480" /></a>
+
+--------
+
+<p align="left">📗 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_get_swag.py">test_get_swag.py</a>, which tests a fake shopping site:</p>
+
+```python
+from seleniumbase import BaseCase
+BaseCase.main(__name__, __file__)  # Call pytest
+
+class MyTestClass(BaseCase):
+    def test_swag_labs(self):
+        self.open("https://www.saucedemo.com")
+        self.type("#user-name", "standard_user")
+        self.type("#password", "secret_sauce\n")
+        self.assert_element("div.inventory_list")
+        self.click('button[name*="backpack"]')
+        self.click("#shopping_cart_container a")
+        self.assert_text("Backpack", "div.cart_item")
+        self.click("button#checkout")
+        self.type("input#first-name", "SeleniumBase")
+        self.type("input#last-name", "Automation")
+        self.type("input#postal-code", "77123")
+        self.click("input#continue")
+        self.click("button#finish")
+        self.assert_text("Thank you for your order!")
+```
+
+> `pytest test_get_swag.py`
+
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_get_swag.py"><img src="https://seleniumbase.github.io/cdn/gif/fast_swag_2.gif" alt="SeleniumBase Test" title="SeleniumBase Test" width="520" /></a>
+
+> (The default browser is ``--chrome`` if not set.)
 
 --------
 
@@ -168,7 +207,7 @@ With raw Selenium, that requires more code:<br />
 
 <p>📚 <b>Learn about different ways of writing tests:</b></p>
 
-<p align="left">📘📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_simple_login.py">test_simple_login.py</a>, which uses <code translate="no"><a href="https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/fixtures/base_case.py">BaseCase</a></code> class inheritance, and runs with <a href="https://docs.pytest.org/en/latest/how-to/usage.html">pytest</a> or <a href="https://github.com/mdmintz/pynose">pynose</a>. (Use <code translate="no">self.driver</code> to access Selenium's raw <code translate="no">driver</code>.)</p>
+<p align="left">📗📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_simple_login.py">test_simple_login.py</a>, which uses <code translate="no"><a href="https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/fixtures/base_case.py">BaseCase</a></code> class inheritance, and runs with <a href="https://docs.pytest.org/en/latest/how-to/usage.html">pytest</a> or <a href="https://github.com/mdmintz/pynose">pynose</a>. (Use <code translate="no">self.driver</code> to access Selenium's raw <code translate="no">driver</code>.)</p>
 
 ```python
 from seleniumbase import BaseCase
@@ -187,22 +226,7 @@ class TestSimpleLogin(BaseCase):
         self.assert_text("signed out", "#top_message")
 ```
 
-<p align="left">📗📝 Here's a test from <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/sb_fixture_tests.py">sb_fixture_tests.py</a>, which uses the <b><code translate="no">sb</code></b> <code translate="no">pytest</code> fixture. Runs with <a href="https://docs.pytest.org/en/latest/how-to/usage.html">pytest</a>. (Use <code translate="no">sb.driver</code> to access Selenium's raw <code translate="no">driver</code>.)</p>
-
-```python
-def test_sb_fixture_with_no_class(sb):
-    sb.open("seleniumbase.io/simple/login")
-    sb.type("#username", "demo_user")
-    sb.type("#password", "secret_pass")
-    sb.click('a:contains("Sign in")')
-    sb.assert_exact_text("Welcome!", "h1")
-    sb.assert_element("img#image1")
-    sb.highlight("#image1")
-    sb.click_link("Sign out")
-    sb.assert_text("signed out", "#top_message")
-```
-
-<p align="left">📙📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_login_sb.py">raw_login_sb.py</a>, which uses the <b><code translate="no">SB</code></b> Context Manager. Runs with pure <code translate="no">python</code>. (Use <code translate="no">sb.driver</code> to access Selenium's raw <code translate="no">driver</code>.)</p>
+<p align="left">📘📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_login_sb.py">raw_login_sb.py</a>, which uses the <b><code translate="no">SB</code></b> Context Manager. Runs with pure <code translate="no">python</code>. (Use <code translate="no">sb.driver</code> to access Selenium's raw <code translate="no">driver</code>.)</p>
 
 ```python
 from seleniumbase import SB
@@ -219,24 +243,7 @@ with SB() as sb:
     sb.assert_text("signed out", "#top_message")
 ```
 
-<p align="left">📔📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_login_context.py">raw_login_context.py</a>, which uses the <b><code translate="no">DriverContext</code></b> Manager. Runs with pure <code translate="no">python</code>. (The <code translate="no">driver</code> is an improved version of Selenium's raw <code translate="no">driver</code>, with more methods.)</p>
-
-```python
-from seleniumbase import DriverContext
-
-with DriverContext() as driver:
-    driver.open("seleniumbase.io/simple/login")
-    driver.type("#username", "demo_user")
-    driver.type("#password", "secret_pass")
-    driver.click('a:contains("Sign in")')
-    driver.assert_exact_text("Welcome!", "h1")
-    driver.assert_element("img#image1")
-    driver.highlight("#image1")
-    driver.click_link("Sign out")
-    driver.assert_text("signed out", "#top_message")
-```
-
-<p align="left">📔📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_login_driver.py">raw_login_driver.py</a>, which uses the <b><code translate="no">Driver</code></b> Manager. Runs with pure <code translate="no">python</code>. (The <code>driver</code> is an improved version of Selenium's raw <code translate="no">driver</code>, with more methods.)</p>
+<p align="left">📙📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_login_driver.py">raw_login_driver.py</a>, which uses the <b><code translate="no">Driver</code></b> Manager. Runs with pure <code translate="no">python</code>. (The <code>driver</code> is an improved version of Selenium's raw <code translate="no">driver</code>, with more methods.)</p>
 
 ```python
 from seleniumbase import Driver
@@ -256,23 +263,6 @@ finally:
     driver.quit()
 ```
 
-<p align="left">📕📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/behave_bdd/features/login_app.feature">login_app.feature</a>, which uses <a translate="no" href="https://behave.readthedocs.io/en/stable/gherkin.html#features" target="_blank">behave-BDD Gherkin</a> syntax. Runs with <code translate="no">behave</code>. (<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/behave_bdd/ReadMe.md">Learn about the <b>SeleniumBase behave-BDD</b> integration</a>)</p>
-
-```gherkin
-Feature: SeleniumBase scenarios for the Simple App
-
-  Scenario: Verify the Simple App (Login / Logout)
-    Given Open "seleniumbase.io/simple/login"
-    And Type "demo_user" into "#username"
-    And Type "secret_pass" into "#password"
-    And Click 'a:contains("Sign in")'
-    And Assert exact text "Welcome!" in "h1"
-    And Assert element "img#image1"
-    And Highlight "#image1"
-    And Click link "Sign out"
-    And Assert text "signed out" in "#top_message"
-```
-
 --------
 
 <a id="python_installation"></a>
@@ -371,20 +361,21 @@ pip install -e .
 <summary> ▶️ Here's sample output from a chromedriver download. (<b>click to expand</b>)</summary>
 
 ```bash
-*** chromedriver to download = 121.0.6167.85 (Latest Stable) 
+*** chromedriver to download = 131.0.6778.108 (Latest Stable) 
 
 Downloading chromedriver-mac-arm64.zip from:
-https://storage.googleapis.com/chrome-for-testing-public/121.0.6167.85/mac-arm64/chromedriver-mac-arm64.zip ...
+https://storage.googleapis.com/chrome-for-testing-public/131.0.6778.108/mac-arm64/chromedriver-mac-arm64.zip ...
 Download Complete!
 
 Extracting ['chromedriver'] from chromedriver-mac-arm64.zip ...
 Unzip Complete!
 
 The file [chromedriver] was saved to:
-/Users/michael/github/SeleniumBase/seleniumbase/drivers/chromedriver
+~/github/SeleniumBase/seleniumbase/drivers/
+chromedriver
 
-Making [chromedriver 121.0.6167.85] executable ...
-[chromedriver 121.0.6167.85] is now ready for use!
+Making [chromedriver 131.0.6778.108] executable ...
+[chromedriver 131.0.6778.108] is now ready for use!
 ```
 
 </details>
@@ -404,7 +395,7 @@ pytest my_first_test.py
 
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py"><img src="https://seleniumbase.github.io/cdn/gif/fast_swag_2.gif" alt="SeleniumBase Test" title="SeleniumBase Test" width="520" /></a>
 
-<p align="left"><b>Here's the code for <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py">my_first_test.py</a>:</b></p>
+<p align="left"><b>Here's the full code for <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py">my_first_test.py</a>:</b></p>
 
 ```python
 from seleniumbase import BaseCase

{seleniumbase-4.33.9 → seleniumbase-4.33.11}/examples/presenter/uc_presentation_3.py

@@ -456,7 +456,7 @@ class UCPresentationClass(BaseCase):
             "<hr /><h6><br /></h6>"
             "<p><mk-1>"
             "There are different ways of stucturing SeleniumBase scripts."
-            ' (Internally called: "The 23 Syntax Formats")'
+            ' (Internally called: "The 25 Syntax Formats")'
             "</mk-1><br /><br /><mk-2>"
             'Most examples use Syntax Format 1: "BaseCase direct class'
             ' inheritance", which uses the "pytest" test runner.'

{seleniumbase-4.33.9 → seleniumbase-4.33.11}/examples/test_download_files.py

@@ -31,7 +31,7 @@ class DownloadTests(BaseCase):
         self.assert_text("Download files", "a#files-tab")
         pkg_header = self.get_text("h1.package-header__name").strip()
         pkg_name = pkg_header.replace(" ", "-")
-        whl_file = pkg_name + "-py2.py3-none-any.whl"
+        whl_file = pkg_name + "-py3-none-any.whl"
         tar_gz_file = pkg_name + ".tar.gz"
 
         # Click the links to download the files into: "./downloaded_files/"

{seleniumbase-4.33.9 → seleniumbase-4.33.11}/examples/translations/italian_test_1.py

@@ -8,12 +8,12 @@ class MiaClasseDiTest(CasoDiProva):
         self.apri("https://it.wikipedia.org/wiki/")
         self.verificare_testo("Wikipedia")
         self.verificare_elemento('a[title="Lingua italiana"]')
-        self.digitare("#searchInput", "Pizza")
-        self.fare_clic("#searchButton")
+        self.digitare('input[name="search"]', "Pizza")
+        self.fare_clic("#searchform button")
         self.verificare_testo("Pizza", "#firstHeading")
         self.verificare_elemento('figure img[src*="pizza"]')
-        self.digitare("#searchInput", "Colosseo")
-        self.fare_clic("#searchButton")
+        self.digitare('input[name="search"]', "Colosseo")
+        self.fare_clic("#searchform button")
         self.verificare_testo("Colosseo", "#firstHeading")
         self.verificare_elemento('figure img[src*="Colosseo"]')
         self.indietro()

{seleniumbase-4.33.9 → seleniumbase-4.33.11}/requirements.txt

@@ -4,7 +4,7 @@ setuptools~=70.2;python_version<"3.10"
 setuptools>=75.6.0;python_version>="3.10"
 wheel>=0.45.1
 attrs>=24.2.0
-certifi>=2024.8.30
+certifi>=2024.12.14
 exceptiongroup>=1.2.2
 websockets~=13.1;python_version<"3.9"
 websockets>=14.1;python_version>="3.9"

seleniumbase-4.33.11/seleniumbase/__version__.py

@@ -0,0 +1,2 @@
+# seleniumbase package
+__version__ = "4.33.11"

{seleniumbase-4.33.9 → seleniumbase-4.33.11}/seleniumbase/core/browser_launcher.py

@@ -2407,8 +2407,6 @@ def _set_firefox_options(
     options.set_preference("dom.webnotifications.enabled", False)
     options.set_preference("dom.disable_beforeunload", True)
     options.set_preference("browser.contentblocking.database.enabled", True)
-    options.set_preference("extensions.allowPrivateBrowsingByDefault", True)
-    options.set_preference("extensions.PrivateBrowsing.notification", False)
     options.set_preference("extensions.systemAddon.update.enabled", False)
     options.set_preference("extensions.update.autoUpdateDefault", False)
     options.set_preference("extensions.update.enabled", False)

{seleniumbase-4.33.9 → seleniumbase-4.33.11}/seleniumbase/core/sb_cdp.py

@@ -519,7 +519,20 @@ class CDPMethods():
         try:
             return element.get_js_attributes()[attribute]
         except Exception:
-            return None
+            if not attribute:
+                raise
+            try:
+                attribute_str = element.get_js_attributes()
+                locate = ' %s="' % attribute
+                if locate in attribute_str.outerHTML:
+                    outer_html = attribute_str.outerHTML
+                    attr_start = outer_html.find(locate) + len(locate)
+                    attr_end = outer_html.find('"', attr_start)
+                    value = outer_html[attr_start:attr_end]
+                    return value
+            except Exception:
+                pass
+        return None
 
     def __get_x_scroll_offset(self):
         x_scroll_offset = self.loop.run_until_complete(
@@ -620,11 +633,12 @@ class CDPMethods():
 
     def click_if_visible(self, selector):
         if self.is_element_visible(selector):
-            element = self.find_element(selector)
-            element.scroll_into_view()
-            element.click()
-            self.__slow_mode_pause_if_set()
-            self.loop.run_until_complete(self.page.wait())
+            with suppress(Exception):
+                element = self.find_element(selector, timeout=0)
+                element.scroll_into_view()
+                element.click()
+                self.__slow_mode_pause_if_set()
+                self.loop.run_until_complete(self.page.wait())
 
     def click_visible_elements(self, selector, limit=0):
         """Finds all matching page elements and clicks visible ones in order.
@@ -1094,7 +1108,14 @@ class CDPMethods():
         )
 
     def get_element_attribute(self, selector, attribute):
-        return self.get_element_attributes(selector)[attribute]
+        attributes = self.get_element_attributes(selector)
+        with suppress(Exception):
+            return attributes[attribute]
+        locate = ' %s="' % attribute
+        value = self.get_attribute(selector, attribute)
+        if not value and locate not in attributes:
+            raise KeyError(attribute)
+        return value
 
     def get_attribute(self, selector, attribute):
         return self.find_element(selector).get_attribute(attribute)

{seleniumbase-4.33.9 → seleniumbase-4.33.11}/seleniumbase/fixtures/base_case.py

@@ -3416,6 +3416,14 @@ class BaseCase(unittest.TestCase):
             self.activate_jquery()
         return self.driver.execute_script(script, *args, **kwargs)
 
+    def get_element_at_x_y(self, x, y):
+        """Return element at current window's x,y coordinates."""
+        self.__check_scope()
+        self._check_browser()
+        return self.execute_script(
+            "return document.elementFromPoint(%s, %s);" % (x, y)
+        )
+
     def get_gui_element_rect(self, selector, by="css selector"):
         """Very similar to element.rect, but the x, y coordinates are
         relative to the entire screen, rather than the browser window.

{seleniumbase-4.33.9 → seleniumbase-4.33.11}/seleniumbase/undetected/cdp_driver/_contradict.py

@@ -31,12 +31,12 @@ class ContraDict(dict):
 
     def __init__(self, *args, **kwargs):
         super().__init__()
-        silent = kwargs.pop("silent", False)
+        # silent = kwargs.pop("silent", False)
         _ = dict(*args, **kwargs)
 
         super().__setattr__("__dict__", self)
         for k, v in _.items():
-            _check_key(k, self, False, silent)
+            _check_key(k, self, False, True)
             super().__setitem__(k, _wrap(self.__class__, v))
 
     def __setitem__(self, key, value):
@@ -90,7 +90,7 @@ _warning_names_message = """\n\
 
 
 def _check_key(
-    key: str, mapping: _Mapping, boolean: bool = False, silent=False
+    key: str, mapping: _Mapping, boolean: bool = False, silent=True
 ):
     """Checks `key` and warns if needed.
     :param key:

{seleniumbase-4.33.9 → seleniumbase-4.33.11}/seleniumbase/undetected/cdp_driver/browser.py

@@ -10,6 +10,7 @@ import pathlib
 import pickle
 import re
 import shutil
+import time
 import urllib.parse
 import urllib.request
 import warnings
@@ -30,8 +31,6 @@ def get_registered_instances():
 
 
 def deconstruct_browser():
-    import time
-
     for _ in __registered__instances__:
         if not _.stopped:
             _.stop()
@@ -117,8 +116,13 @@ class Browser:
                 port=port,
                 **kwargs,
             )
-        instance = cls(config)
-        await instance.start()
+        try:
+            instance = cls(config)
+            await instance.start()
+        except Exception:
+            time.sleep(0.15)
+            instance = cls(config)
+            await instance.start()
         return instance
 
     def __init__(self, config: Config, **kwargs):
@@ -379,8 +383,6 @@ class Browser:
                     --------------------------------
                     Failed to connect to the browser
                     --------------------------------
-                    Possibly because you are running as "root".
-                    If so, you may need to use no_sandbox=True.
                     """
                 )
             )

{seleniumbase-4.33.9 → seleniumbase-4.33.11}/seleniumbase/undetected/cdp_driver/element.py

@@ -438,12 +438,15 @@ class Element:
                 )
             )
         )
-        if result and result[0]:
-            if return_by_value:
-                return result[0].value
-            return result[0]
-        elif result[1]:
-            return result[1]
+        try:
+            if result and result[0]:
+                if return_by_value:
+                    return result[0].value
+                return result[0]
+            elif result[1]:
+                return result[1]
+        except Exception:
+            return self
 
     async def get_position_async(self, abs=False) -> Position:
         if not self.parent or not self.object_id: