PyPI - seleniumbase - Versions diffs - 4.55.2__tar.gz → 4.56.1__tar.gz - Mend

seleniumbase 4.55.2tar.gz → 4.56.1tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (164) hide show

{seleniumbase-4.55.2/seleniumbase.egg-info → seleniumbase-4.56.1}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: seleniumbase
-Version: 4.55.2
+Version: 4.56.1
 Summary: SeleniumBase is a framework for web crawling, scraping, and testing. Supports pytest. CDP Mode adds stealth. Includes many tools.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz
@@ -67,7 +67,8 @@ Requires-Dist: certifi>=2026.7.22
 Requires-Dist: exceptiongroup>=1.3.1
 Requires-Dist: websockets~=16.1.1; python_version == "3.10"
 Requires-Dist: websockets>=16.1.1; python_version >= "3.11"
-Requires-Dist: filelock>=4.0.12
+Requires-Dist: filelock==4.1.0; python_version == "3.10"
+Requires-Dist: filelock>=4.1.1; python_version >= "3.11"
 Requires-Dist: fasteners>=0.20
 Requires-Dist: mycdp>=1.4.0
 Requires-Dist: pynose>=1.5.5
@@ -76,7 +77,7 @@ Requires-Dist: sbvirtualdisplay>=1.4.0
 Requires-Dist: MarkupSafe>=3.0.4
 Requires-Dist: Jinja2>=3.1.6
 Requires-Dist: six>=1.17.0
-Requires-Dist: parse>=1.22.2
+Requires-Dist: parse>=1.22.3
 Requires-Dist: parse-type>=0.6.6
 Requires-Dist: colorama>=0.4.6
 Requires-Dist: psutil>=7.2.2
@@ -96,8 +97,9 @@ Requires-Dist: trio<1,>=0.34.0
 Requires-Dist: trio-websocket~=0.12.2
 Requires-Dist: wsproto~=1.3.2
 Requires-Dist: websocket-client~=1.9.2
-Requires-Dist: selenium==4.50.0
-Requires-Dist: cssselect<2,>=1.5.0
+Requires-Dist: selenium==4.51.0
+Requires-Dist: cssselect~=1.5.0; python_version < "3.11"
+Requires-Dist: cssselect<2,>=1.6.0; python_version >= "3.11"
 Requires-Dist: sortedcontainers==2.4.0
 Requires-Dist: execnet==2.1.2
 Requires-Dist: iniconfig~=2.3.1
@@ -112,7 +114,8 @@ Requires-Dist: pytest-rerunfailures==16.7; python_version >= "3.11"
 Requires-Dist: pytest-xdist==3.8.0
 Requires-Dist: parameterized==0.9.0
 Requires-Dist: behave==1.2.6
-Requires-Dist: soupsieve~=2.10.0
+Requires-Dist: soupsieve~=2.10.0; python_version < "3.11.5"
+Requires-Dist: soupsieve~=3.0.3; python_version >= "3.11.5"
 Requires-Dist: beautifulsoup4~=4.15.0
 Requires-Dist: pyotp~=2.10.0
 Requires-Dist: python-xlib==0.33; platform_system == "Linux"
@@ -140,7 +143,7 @@ Provides-Extra: pdfminer
 Requires-Dist: pdfminer.six==20260107; extra == "pdfminer"
 Requires-Dist: cryptography==50.0.2; extra == "pdfminer"
 Requires-Dist: cffi==2.1.1; extra == "pdfminer"
-Requires-Dist: pycparser==3.0; extra == "pdfminer"
+Requires-Dist: pycparser==3.11; extra == "pdfminer"
 Provides-Extra: pillow
 Requires-Dist: Pillow>=12.3.0; extra == "pillow"
 Provides-Extra: pip-system-certs
@@ -154,7 +157,7 @@ Requires-Dist: pyee>=13.0.1; extra == "playwright"
 Provides-Extra: pyautogui
 Requires-Dist: PyAutoGUI>=0.9.54; platform_system != "Linux" and extra == "pyautogui"
 Provides-Extra: uv
-Requires-Dist: uv>=0.12.23; extra == "uv"
+Requires-Dist: uv>=0.13.0; extra == "uv"
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -179,11 +182,13 @@ Dynamic: summary
 <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" />
-<p align="center"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/nice_logo_8t.png" alt="SeleniumBase" width="400" /></a></p>
+<h1 align="center">📊 SeleniumBase</h1>
-<p align="center" class="hero__title"><b>All-in-one Browser Automation Framework:<br />Web Crawling / Testing / Scraping / Stealth</b></p>
+<p><h3 align="center">One framework for browser automation, web scraping, and testing.<br /></h3></p>
-<p align="center"><a href="https://pypi.python.org/pypi/seleniumbase" target="_blank"><img src="https://img.shields.io/pypi/v/seleniumbase.svg?color=3399EE" alt="PyPI version" height="20" /></a> <a href="https://pepy.tech/projects/seleniumbase?timeRange=threeMonths&category=version&includeCIDownloads=true&granularity=daily&viewType=line&versions=*" target="_blank"><img src="https://static.pepy.tech/badge/seleniumbase" alt="SeleniumBase PyPI downloads" height="20" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-22BBCC.svg" title="SeleniumBase" height="20" /></a> <a href="https://seleniumbase.io"><img src="https://img.shields.io/badge/docs-seleniumbase.io-11BBAA.svg" alt="SeleniumBase Docs" height="20" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/actions" target="_blank"><img src="https://github.com/seleniumbase/SeleniumBase/workflows/Tests/badge.svg" alt="SeleniumBase GitHub Actions" height="20" /></a> <a href="https://www.youtube.com/playlist?list=PLp9uKicxkBc5UIlGi2BuE3aWC7JyXpD3m"><img src="https://img.shields.io/badge/docs-📺-F12345.svg?style=flat&logo=YouTube&logoColor=white&label=YouTube" alt="YouTube Channel" height="20" /></a></p>
+<p align="center"><a href="https://pypi.python.org/pypi/seleniumbase" target="_blank"><img src="https://img.shields.io/pypi/v/seleniumbase.svg?style=flat-square&color=3399EE" alt="PyPI version" height="20" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/actions" target="_blank"><img src="https://img.shields.io/github/actions/workflow/status/seleniumbase/SeleniumBase/python-package.yml?branch=master&style=flat-square&label=CI" alt="SeleniumBase GitHub Actions" height="20" /></a> <a href="https://seleniumbase.io"><img src="https://img.shields.io/badge/docs-seleniumbase.io-11BBAA.svg?style=flat-square" alt="SeleniumBase Docs" height="20" /></a> <a href="https://pepy.tech/projects/seleniumbase?timeRange=threeMonths&category=version&includeCIDownloads=true&granularity=daily&viewType=line&versions=*" target="_blank">
+  <img src="https://static.pepy.tech/badge/seleniumbase" alt="SeleniumBase PyPI downloads" height="20" />
+</a> <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-F4C246.svg?style=flat-square" title="SeleniumBase" height="20" /></a><br /><a href="https://www.youtube.com/playlist?list=PLp9uKicxkBc5UIlGi2BuE3aWC7JyXpD3m"><img src="https://img.shields.io/badge/docs-📺-D124D8.svg?style=flat-square&logo=YouTube&logoColor=white&label=YouTube" alt="YouTube Channel" height="20" /></a> <a href="https://discord.gg/EdhQTn3EyE" target="_blank"><img src="https://img.shields.io/discord/727927627830001734?style=flat-square&color=7289DA&label=Discord&logo=discord&logoColor=white" height="20" /></a> <a href="https://www.facebook.com/SeleniumBase/" target="_blank"> <img src="https://img.shields.io/badge/Facebook-4K_followers-1877F2?style=flat-square&logo=facebook&logoColor=white" alt="SeleniumBase Facebook Followers" height="20" /></a> <a href="https://x.com/seleniumbase" target="_blank"><img src="https://img.shields.io/badge/-1K_followers-1DA1F2?style=flat-square&logo=x&logoColor=white&labelColor=555555" alt="SeleniumBase X Followers" height="20" /></a></p>
 <p align="center">
 <a href="#python_installation">🚀 Start</a> |
@@ -218,24 +223,17 @@ Dynamic: summary
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/presenter/ReadMe.md">🎞️ Presenter</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/visual_testing/ReadMe.md">🖼️ Visual</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/case_plans.md">🗂️ CPlans</a>
-<br />
 </p>
 --------
-🥷 Stealth modes: <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md"><b>UC Mode</b></a> / <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md"><b>CDP Mode</b></a> can bypass bot-detection, handle CAPTCHAs, and call methods from the <a href="https://chromedevtools.github.io/devtools-protocol/" translate="no">Chrome Devtools Protocol</a>. CDP Mode includes <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/ReadMe.md"><b><span translate="no">Stealthy Playwright Mode</span></b></a>, which makes Playwright stealthy.
-🧪 End-to-End Testing examples are located in [./examples/](https://github.com/seleniumbase/SeleniumBase/blob/master/examples).
+🥷 <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md"><b>UC Mode</b></a> and the newer <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md"><b>CDP Mode</b></a> makes your automation undetectable to anti-bot services. <b>CDP Mode</b> also <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/ReadMe.md"><span translate="no">adds <b>stealth</b> to stock Playwright</span></a>.
-🐙 CDP Mode (stealth) examples are located in [./examples/cdp_mode/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples/cdp_mode).
-🎭 Stealthy Playwright examples are located in [./examples/cdp_mode/playwright/](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/).
-📚 Examples that have `test_` or  `_test` in the filename are specifically designed to run with `pytest` / `pynose`. Other examples run directly with raw `python` (those files generally start with `raw_` to avoid confusion).
+📚 Example scripts that start or end with "<code>test</code>" are specifically designed to be run with <code><b>pytest</b></code>. Other scripts run directly with raw <code><b>python</b></code>. (Those start with "<code>raw</code>" to avoid confusion.)
 --------
-<b>📝 Here's a Python <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_cdp_planetmc.py" target="_blank">example</a> that uses <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md#-pure-cdp-mode-sb_cdp">Pure CDP Mode</a> (<code>sb_cdp</code>):</b><br />(It navigates to Planet Minecraft where it bypasses the CAPTCHA)
+<b>📝 Here's a <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_cdp_planetmc.py" target="_blank">Python script</a> that uses <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md#-pure-cdp-mode-sb_cdp">Pure CDP Mode</a> (<code>sb_cdp</code>):</b><br />(It performs actions such as typing, clicking, and  bypassing a Cloudflare Turnstile)
 ```python
 from seleniumbase import sb_cdp
@@ -253,7 +251,9 @@ sb.sleep(1.5)
 sb.quit()
 ```
-> `python raw_cdp_planetmc.py`
+```
+python raw_cdp_planetmc.py
+```
 <p align="left">
 <img src="https://seleniumbase.github.io/other/pmc_captcha_2.png" width="530" style="max-width: 100% !important; height: auto !important;" alt="Cloudflare Turnstile bypassed successfully" />
@@ -261,9 +261,11 @@ sb.quit()
 ✅ <b><code>sb.solve_captcha()</code></b> handles CAPTCHAs that aren't bypassed automatically.<br />(If called when there's no CAPTCHA on the page, then nothing happens / no-op.)
+ℹ️ <code>sb.assert_*</code> methods wait up to 7 seconds for the expected condition to occur.
 --------
-<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_cdp_yc_news.py" target="_blank">This example</a> scrapes Hacker News listings:</b></p>
+<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_cdp_yc_news.py" target="_blank">This script</a> scrapes Hacker News listings:</b></p>
 ```python
 from seleniumbase import sb_cdp
@@ -275,7 +277,9 @@ for element in elements:
     print("* " + element.text)
 ```
-> `python raw_cdp_yc_news.py`
+```
+python raw_cdp_yc_news.py
+```
 <p align="left">
 <img src="https://seleniumbase.github.io/other/yc_news_results.png" alt="SeleniumBase" width="510" style="max-width: 100% !important; height: auto !important;"/>
@@ -283,7 +287,7 @@ for element in elements:
 --------
-<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_gitlab.py" target="_blank">This example</a> bypasses Cloudflare's challenge page with UC + CDP Mode:</b></p>
+<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_gitlab.py" target="_blank">This script</a> bypasses Cloudflare's challenge page with UC + CDP Mode:</b></p>
 ```python
 from seleniumbase import SB
@@ -297,7 +301,9 @@ with SB(uc=True, test=True, locale="en") as sb:
     sb.highlight('button:contains("Sign in")')
 ```
-> `python raw_gitlab.py`
+```
+python raw_gitlab.py
+```
 <p align="left">
 <img src="https://seleniumbase.github.io/other/gitlab_bypass_2.png" alt="SeleniumBase" width="420" style="max-width: 100% !important; height: auto !important;"/>
@@ -305,6 +311,14 @@ with SB(uc=True, test=True, locale="en") as sb:
 --------
+🧪 End-to-End Testing examples are located in [./examples/](https://github.com/seleniumbase/SeleniumBase/blob/master/examples).
+🐙 Stealthy CDP Mode examples are located in [./examples/cdp_mode/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples/cdp_mode).
+🎭 Stealthy Playwright examples are located in [./examples/cdp_mode/playwright/](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/).
+--------
 <h3 align="left">🌐 CLI Options for Supported Chromium Browsers</h3>
 <p>💡 You can set which Chromium browser to use via command-line parameters:</p>
@@ -328,13 +342,13 @@ sb = sb_cdp.Chrome(use_chromium=True)
 <h3 align="left">⚙️ Stealthy architecture flowchart:</h3>
-<img src="https://seleniumbase.github.io/other/sb_architecture.png" width="540" style="max-width: 100% !important; height: auto !important;" alt="Stealthy architecture flowchart" />
+<img src="https://seleniumbase.github.io/other/sb_architecture.png" width="530" style="max-width: 100% !important; height: auto !important;" alt="Stealthy architecture flowchart" />
 --------
 <h3>🧪 Comprehensive E2E Testing with <code>pytest</code>:</h3>
-<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_get_swag.py" target="_blank">This example</a> tests an e-commerce site with <code>pytest</code>:</b></p>
+<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_get_swag.py" target="_blank">This script</a> tests an e-commerce site with <code>pytest</code>:</b></p>
 ```python
 from seleniumbase import BaseCase
@@ -358,7 +372,9 @@ class MyTestClass(BaseCase):
         self.assert_text("Thank you for your order!")
 ```
-> `pytest test_get_swag.py`
+```
+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" width="500" style="max-width: 100% !important; height: auto !important;" /></a>
@@ -366,7 +382,31 @@ class MyTestClass(BaseCase):
 --------
-<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_coffee_cart.py" target="_blank">This example</a> tests another e-commerce site with <code>pytest</code>:</b></p>
+<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_coffee_cart.py" target="_blank">This script</a> tests a different e-commerce site with <code>pytest</code>:</b></p>
+```python
+from seleniumbase import BaseCase
+BaseCase.main(__name__, __file__)
+class CoffeeCartTest(BaseCase):
+    def test_coffee_cart(self):
+        self.goto("https://seleniumbase.io/coffee/")
+        self.assert_title("Coffee Cart")
+        self.assert_element('button:contains("Total: $0.00")')
+        self.click('div[data-sb="Cappuccino"]')
+        self.assert_exact_text("cart (1)", 'a[aria-label="Cart page"]')
+        self.click('div[data-sb="Flat-White"]')
+        self.assert_exact_text("cart (2)", 'a[aria-label="Cart page"]')
+        self.click('div[data-sb="Cafe-Latte"]')
+        self.assert_exact_text("cart (3)", 'a[aria-label="Cart page"]')
+        self.click('a[aria-label="Cart page"]')
+        self.assert_exact_text("Total: $53.00", "button.pay")
+        self.click("button.pay")
+        self.type("input#name", "Selenium Coffee")
+        self.type("input#email", "test@test.test")
+        self.click("button#submit-payment")
+        self.assert_text("Thanks for your purchase.", "#app .success")
+```
 ```zsh
 pytest test_coffee_cart.py --demo
@@ -380,7 +420,7 @@ pytest test_coffee_cart.py --demo
 <a id="multiple_examples"></a>
-<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_demo_site.py" target="_blank">This example</a> covers multiple actions with <code>pytest</code>:</b></p>
+<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_demo_site.py" target="_blank">This script</a> covers multiple actions with <code>pytest</code>:</b></p>
 ```zsh
 pytest test_demo_site.py
@@ -390,7 +430,7 @@ pytest test_demo_site.py
 > Easy to type, click, select, toggle, drag & drop, and more.
-📚 For more examples, see the <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/ReadMe.md">SeleniumBase/examples/</a> folder.
+📚 For more scripts, see the <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/ReadMe.md">SeleniumBase/examples/</a> folder.
 --------

{seleniumbase-4.55.2 → seleniumbase-4.56.1}/README.md RENAMED Viewed

@@ -8,11 +8,13 @@
 <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" />
-<p align="center"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/nice_logo_8t.png" alt="SeleniumBase" width="400" /></a></p>
+<h1 align="center">📊 SeleniumBase</h1>
-<p align="center" class="hero__title"><b>All-in-one Browser Automation Framework:<br />Web Crawling / Testing / Scraping / Stealth</b></p>
+<p><h3 align="center">One framework for browser automation, web scraping, and testing.<br /></h3></p>
-<p align="center"><a href="https://pypi.python.org/pypi/seleniumbase" target="_blank"><img src="https://img.shields.io/pypi/v/seleniumbase.svg?color=3399EE" alt="PyPI version" height="20" /></a> <a href="https://pepy.tech/projects/seleniumbase?timeRange=threeMonths&category=version&includeCIDownloads=true&granularity=daily&viewType=line&versions=*" target="_blank"><img src="https://static.pepy.tech/badge/seleniumbase" alt="SeleniumBase PyPI downloads" height="20" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-22BBCC.svg" title="SeleniumBase" height="20" /></a> <a href="https://seleniumbase.io"><img src="https://img.shields.io/badge/docs-seleniumbase.io-11BBAA.svg" alt="SeleniumBase Docs" height="20" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/actions" target="_blank"><img src="https://github.com/seleniumbase/SeleniumBase/workflows/Tests/badge.svg" alt="SeleniumBase GitHub Actions" height="20" /></a> <a href="https://www.youtube.com/playlist?list=PLp9uKicxkBc5UIlGi2BuE3aWC7JyXpD3m"><img src="https://img.shields.io/badge/docs-📺-F12345.svg?style=flat&logo=YouTube&logoColor=white&label=YouTube" alt="YouTube Channel" height="20" /></a></p>
+<p align="center"><a href="https://pypi.python.org/pypi/seleniumbase" target="_blank"><img src="https://img.shields.io/pypi/v/seleniumbase.svg?style=flat-square&color=3399EE" alt="PyPI version" height="20" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/actions" target="_blank"><img src="https://img.shields.io/github/actions/workflow/status/seleniumbase/SeleniumBase/python-package.yml?branch=master&style=flat-square&label=CI" alt="SeleniumBase GitHub Actions" height="20" /></a> <a href="https://seleniumbase.io"><img src="https://img.shields.io/badge/docs-seleniumbase.io-11BBAA.svg?style=flat-square" alt="SeleniumBase Docs" height="20" /></a> <a href="https://pepy.tech/projects/seleniumbase?timeRange=threeMonths&category=version&includeCIDownloads=true&granularity=daily&viewType=line&versions=*" target="_blank">
+  <img src="https://static.pepy.tech/badge/seleniumbase" alt="SeleniumBase PyPI downloads" height="20" />
+</a> <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-F4C246.svg?style=flat-square" title="SeleniumBase" height="20" /></a><br /><a href="https://www.youtube.com/playlist?list=PLp9uKicxkBc5UIlGi2BuE3aWC7JyXpD3m"><img src="https://img.shields.io/badge/docs-📺-D124D8.svg?style=flat-square&logo=YouTube&logoColor=white&label=YouTube" alt="YouTube Channel" height="20" /></a> <a href="https://discord.gg/EdhQTn3EyE" target="_blank"><img src="https://img.shields.io/discord/727927627830001734?style=flat-square&color=7289DA&label=Discord&logo=discord&logoColor=white" height="20" /></a> <a href="https://www.facebook.com/SeleniumBase/" target="_blank"> <img src="https://img.shields.io/badge/Facebook-4K_followers-1877F2?style=flat-square&logo=facebook&logoColor=white" alt="SeleniumBase Facebook Followers" height="20" /></a> <a href="https://x.com/seleniumbase" target="_blank"><img src="https://img.shields.io/badge/-1K_followers-1DA1F2?style=flat-square&logo=x&logoColor=white&labelColor=555555" alt="SeleniumBase X Followers" height="20" /></a></p>
 <p align="center">
 <a href="#python_installation">🚀 Start</a> |
@@ -47,24 +49,17 @@
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/presenter/ReadMe.md">🎞️ Presenter</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/visual_testing/ReadMe.md">🖼️ Visual</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/case_plans.md">🗂️ CPlans</a>
-<br />
 </p>
 --------
-🥷 Stealth modes: <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md"><b>UC Mode</b></a> / <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md"><b>CDP Mode</b></a> can bypass bot-detection, handle CAPTCHAs, and call methods from the <a href="https://chromedevtools.github.io/devtools-protocol/" translate="no">Chrome Devtools Protocol</a>. CDP Mode includes <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/ReadMe.md"><b><span translate="no">Stealthy Playwright Mode</span></b></a>, which makes Playwright stealthy.
-🧪 End-to-End Testing examples are located in [./examples/](https://github.com/seleniumbase/SeleniumBase/blob/master/examples).
+🥷 <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md"><b>UC Mode</b></a> and the newer <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md"><b>CDP Mode</b></a> makes your automation undetectable to anti-bot services. <b>CDP Mode</b> also <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/ReadMe.md"><span translate="no">adds <b>stealth</b> to stock Playwright</span></a>.
-🐙 CDP Mode (stealth) examples are located in [./examples/cdp_mode/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples/cdp_mode).
-🎭 Stealthy Playwright examples are located in [./examples/cdp_mode/playwright/](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/).
-📚 Examples that have `test_` or  `_test` in the filename are specifically designed to run with `pytest` / `pynose`. Other examples run directly with raw `python` (those files generally start with `raw_` to avoid confusion).
+📚 Example scripts that start or end with "<code>test</code>" are specifically designed to be run with <code><b>pytest</b></code>. Other scripts run directly with raw <code><b>python</b></code>. (Those start with "<code>raw</code>" to avoid confusion.)
 --------
-<b>📝 Here's a Python <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_cdp_planetmc.py" target="_blank">example</a> that uses <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md#-pure-cdp-mode-sb_cdp">Pure CDP Mode</a> (<code>sb_cdp</code>):</b><br />(It navigates to Planet Minecraft where it bypasses the CAPTCHA)
+<b>📝 Here's a <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_cdp_planetmc.py" target="_blank">Python script</a> that uses <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md#-pure-cdp-mode-sb_cdp">Pure CDP Mode</a> (<code>sb_cdp</code>):</b><br />(It performs actions such as typing, clicking, and  bypassing a Cloudflare Turnstile)
 ```python
 from seleniumbase import sb_cdp
@@ -82,7 +77,9 @@ sb.sleep(1.5)
 sb.quit()
 ```
-> `python raw_cdp_planetmc.py`
+```
+python raw_cdp_planetmc.py
+```
 <p align="left">
 <img src="https://seleniumbase.github.io/other/pmc_captcha_2.png" width="530" style="max-width: 100% !important; height: auto !important;" alt="Cloudflare Turnstile bypassed successfully" />
@@ -90,9 +87,11 @@ sb.quit()
 ✅ <b><code>sb.solve_captcha()</code></b> handles CAPTCHAs that aren't bypassed automatically.<br />(If called when there's no CAPTCHA on the page, then nothing happens / no-op.)
+ℹ️ <code>sb.assert_*</code> methods wait up to 7 seconds for the expected condition to occur.
 --------
-<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_cdp_yc_news.py" target="_blank">This example</a> scrapes Hacker News listings:</b></p>
+<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_cdp_yc_news.py" target="_blank">This script</a> scrapes Hacker News listings:</b></p>
 ```python
 from seleniumbase import sb_cdp
@@ -104,7 +103,9 @@ for element in elements:
     print("* " + element.text)
 ```
-> `python raw_cdp_yc_news.py`
+```
+python raw_cdp_yc_news.py
+```
 <p align="left">
 <img src="https://seleniumbase.github.io/other/yc_news_results.png" alt="SeleniumBase" width="510" style="max-width: 100% !important; height: auto !important;"/>
@@ -112,7 +113,7 @@ for element in elements:
 --------
-<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_gitlab.py" target="_blank">This example</a> bypasses Cloudflare's challenge page with UC + CDP Mode:</b></p>
+<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_gitlab.py" target="_blank">This script</a> bypasses Cloudflare's challenge page with UC + CDP Mode:</b></p>
 ```python
 from seleniumbase import SB
@@ -126,7 +127,9 @@ with SB(uc=True, test=True, locale="en") as sb:
     sb.highlight('button:contains("Sign in")')
 ```
-> `python raw_gitlab.py`
+```
+python raw_gitlab.py
+```
 <p align="left">
 <img src="https://seleniumbase.github.io/other/gitlab_bypass_2.png" alt="SeleniumBase" width="420" style="max-width: 100% !important; height: auto !important;"/>
@@ -134,6 +137,14 @@ with SB(uc=True, test=True, locale="en") as sb:
 --------
+🧪 End-to-End Testing examples are located in [./examples/](https://github.com/seleniumbase/SeleniumBase/blob/master/examples).
+🐙 Stealthy CDP Mode examples are located in [./examples/cdp_mode/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples/cdp_mode).
+🎭 Stealthy Playwright examples are located in [./examples/cdp_mode/playwright/](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/).
+--------
 <h3 align="left">🌐 CLI Options for Supported Chromium Browsers</h3>
 <p>💡 You can set which Chromium browser to use via command-line parameters:</p>
@@ -157,13 +168,13 @@ sb = sb_cdp.Chrome(use_chromium=True)
 <h3 align="left">⚙️ Stealthy architecture flowchart:</h3>
-<img src="https://seleniumbase.github.io/other/sb_architecture.png" width="540" style="max-width: 100% !important; height: auto !important;" alt="Stealthy architecture flowchart" />
+<img src="https://seleniumbase.github.io/other/sb_architecture.png" width="530" style="max-width: 100% !important; height: auto !important;" alt="Stealthy architecture flowchart" />
 --------
 <h3>🧪 Comprehensive E2E Testing with <code>pytest</code>:</h3>
-<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_get_swag.py" target="_blank">This example</a> tests an e-commerce site with <code>pytest</code>:</b></p>
+<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_get_swag.py" target="_blank">This script</a> tests an e-commerce site with <code>pytest</code>:</b></p>
 ```python
 from seleniumbase import BaseCase
@@ -187,7 +198,9 @@ class MyTestClass(BaseCase):
         self.assert_text("Thank you for your order!")
 ```
-> `pytest test_get_swag.py`
+```
+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" width="500" style="max-width: 100% !important; height: auto !important;" /></a>
@@ -195,7 +208,31 @@ class MyTestClass(BaseCase):
 --------
-<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_coffee_cart.py" target="_blank">This example</a> tests another e-commerce site with <code>pytest</code>:</b></p>
+<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_coffee_cart.py" target="_blank">This script</a> tests a different e-commerce site with <code>pytest</code>:</b></p>
+```python
+from seleniumbase import BaseCase
+BaseCase.main(__name__, __file__)
+class CoffeeCartTest(BaseCase):
+    def test_coffee_cart(self):
+        self.goto("https://seleniumbase.io/coffee/")
+        self.assert_title("Coffee Cart")
+        self.assert_element('button:contains("Total: $0.00")')
+        self.click('div[data-sb="Cappuccino"]')
+        self.assert_exact_text("cart (1)", 'a[aria-label="Cart page"]')
+        self.click('div[data-sb="Flat-White"]')
+        self.assert_exact_text("cart (2)", 'a[aria-label="Cart page"]')
+        self.click('div[data-sb="Cafe-Latte"]')
+        self.assert_exact_text("cart (3)", 'a[aria-label="Cart page"]')
+        self.click('a[aria-label="Cart page"]')
+        self.assert_exact_text("Total: $53.00", "button.pay")
+        self.click("button.pay")
+        self.type("input#name", "Selenium Coffee")
+        self.type("input#email", "test@test.test")
+        self.click("button#submit-payment")
+        self.assert_text("Thanks for your purchase.", "#app .success")
+```
 ```zsh
 pytest test_coffee_cart.py --demo
@@ -209,7 +246,7 @@ pytest test_coffee_cart.py --demo
 <a id="multiple_examples"></a>
-<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_demo_site.py" target="_blank">This example</a> covers multiple actions with <code>pytest</code>:</b></p>
+<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_demo_site.py" target="_blank">This script</a> covers multiple actions with <code>pytest</code>:</b></p>
 ```zsh
 pytest test_demo_site.py
@@ -219,7 +256,7 @@ pytest test_demo_site.py
 > Easy to type, click, select, toggle, drag & drop, and more.
-📚 For more examples, see the <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/ReadMe.md">SeleniumBase/examples/</a> folder.
+📚 For more scripts, see the <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/ReadMe.md">SeleniumBase/examples/</a> folder.
 --------

{seleniumbase-4.55.2 → seleniumbase-4.56.1}/requirements.txt RENAMED Viewed

@@ -7,7 +7,8 @@ certifi>=2026.7.22
 exceptiongroup>=1.3.1
 websockets~=16.1.1;python_version=="3.10"
 websockets>=16.1.1;python_version>="3.11"
-filelock>=4.0.12
+filelock==4.1.0;python_version=="3.10"
+filelock>=4.1.1;python_version>="3.11"
 fasteners>=0.20
 mycdp>=1.4.0
 pynose>=1.5.5
@@ -16,7 +17,7 @@ sbvirtualdisplay>=1.4.0
 MarkupSafe>=3.0.4
 Jinja2>=3.1.6
 six>=1.17.0
-parse>=1.22.2
+parse>=1.22.3
 parse-type>=0.6.6
 colorama>=0.4.6
 psutil>=7.2.2
@@ -36,8 +37,9 @@ trio>=0.34.0,<1
 trio-websocket~=0.12.2
 wsproto~=1.3.2
 websocket-client~=1.9.2
-selenium==4.50.0
-cssselect>=1.5.0,<2
+selenium==4.51.0
+cssselect~=1.5.0;python_version<"3.11"
+cssselect>=1.6.0,<2;python_version>="3.11"
 sortedcontainers==2.4.0
 execnet==2.1.2
 iniconfig~=2.3.1
@@ -52,7 +54,8 @@ pytest-rerunfailures==16.7;python_version>="3.11"
 pytest-xdist==3.8.0
 parameterized==0.9.0
 behave==1.2.6
-soupsieve~=2.10.0
+soupsieve~=2.10.0;python_version<"3.11.5"
+soupsieve~=3.0.3;python_version>="3.11.5"
 beautifulsoup4~=4.15.0
 pyotp~=2.10.0
 python-xlib==0.33;platform_system=="Linux"

{seleniumbase-4.55.2 → seleniumbase-4.56.1}/seleniumbase/__version__.py RENAMED Viewed

@@ -1,2 +1,2 @@
 # seleniumbase package
-__version__ = "4.55.2"
+__version__ = "4.56.1"

seleniumbase 4.55.2__tar.gz → 4.56.1__tar.gz

seleniumbase 4.55.2tar.gz → 4.56.1tar.gz