PyPI - seleniumbase - Versions diffs - 4.56.5__tar.gz → 4.57.1__tar.gz - Mend

seleniumbase 4.56.5tar.gz → 4.57.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.56.5/seleniumbase.egg-info → seleniumbase-4.57.1}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: seleniumbase
-Version: 4.56.5
+Version: 4.57.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
@@ -58,7 +58,7 @@ Classifier: Topic :: Utilities
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: pip>=26.2.2
+Requires-Dist: pip>=26.3
 Requires-Dist: packaging>=26.3
 Requires-Dist: setuptools>=84.2.1
 Requires-Dist: wheel>=0.48.0
@@ -66,9 +66,9 @@ Requires-Dist: attrs>=26.1.0
 Requires-Dist: certifi>=2026.10.23
 Requires-Dist: exceptiongroup>=1.3.1
 Requires-Dist: websockets~=16.1.1; python_version == "3.10"
-Requires-Dist: websockets>=17.3; python_version >= "3.11"
+Requires-Dist: websockets>=17.4; python_version >= "3.11"
 Requires-Dist: filelock==4.1.0; python_version == "3.10"
-Requires-Dist: filelock>=4.2.4; python_version >= "3.11"
+Requires-Dist: filelock>=4.2.9; python_version >= "3.11"
 Requires-Dist: fasteners>=0.20
 Requires-Dist: mycdp>=1.4.0
 Requires-Dist: pynose>=1.5.5
@@ -93,11 +93,11 @@ Requires-Dist: requests~=2.34.2
 Requires-Dist: sniffio==1.3.1
 Requires-Dist: h11==0.16.0
 Requires-Dist: outcome==1.3.0.post0
-Requires-Dist: trio<1,>=0.34.0
+Requires-Dist: trio<1,>=0.35.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.51.0
+Requires-Dist: selenium==4.52.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
@@ -116,7 +116,7 @@ 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; python_version < "3.11.5"
-Requires-Dist: soupsieve~=3.0.4; python_version >= "3.11.5"
+Requires-Dist: soupsieve~=4.0.1; 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"
@@ -130,7 +130,7 @@ Requires-Dist: allure-python-commons>=2.16.0; extra == "allure"
 Requires-Dist: allure-behave>=2.16.0; extra == "allure"
 Provides-Extra: coverage
 Requires-Dist: coverage>=7.16.2; python_version == "3.10" and extra == "coverage"
-Requires-Dist: coverage>=7.17.0; python_version >= "3.11" and extra == "coverage"
+Requires-Dist: coverage>=7.17.2; python_version >= "3.11" and extra == "coverage"
 Requires-Dist: pytest-cov>=7.1.0; extra == "coverage"
 Provides-Extra: flake8
 Requires-Dist: flake8==7.4.1; python_version == "3.10" and extra == "flake8"
@@ -164,7 +164,7 @@ Requires-Dist: pyee>=14.0.0; python_version >= "3.12" and extra == "playwright"
 Provides-Extra: pyautogui
 Requires-Dist: PyAutoGUI>=0.9.54; platform_system != "Linux" and extra == "pyautogui"
 Provides-Extra: uv
-Requires-Dist: uv>=0.13.6; extra == "uv"
+Requires-Dist: uv>=0.13.7; extra == "uv"
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -189,37 +189,31 @@ 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" />
-<h1 align="center">📊 SeleniumBase</h1>
+<h1 align="center"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/super_logo_sb3.png" title="SeleniumBase" width="520" style="max-width: 100% !important; height: auto !important;" /></a></h1>
-<h3 align="center">One framework for browser automation, web scraping, and testing.<br /></h3>
-<p align="center"><b align="center">Includes stealth options for bypassing bot-detection and CAPTCHAs.<br /></b></p>
+<h3 align="center">Browser Automation, Web Scraping, and End-to-End Testing.<br /></h3>
 <p align="center">
 <a href="https://pypi.python.org/pypi/seleniumbase" target="_blank" rel="noopener"><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" rel="noopener"><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" target="_blank" rel="noopener"><img src="https://img.shields.io/badge/docs-seleniumbase.io-11BBAA.svg?style=flat-square" alt="SeleniumBase Docs" height="20" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/LICENSE" target="_blank" rel="noopener"><img src="https://img.shields.io/badge/license-MIT-33A6C6.svg?style=flat-square" title="SeleniumBase" height="20" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/tree/master/mcp_servers" target="_blank" rel="noopener"><img src="https://img.shields.io/badge/MCP-tool_info-7C6EE5?style=flat-square" height="20" /></a> <a href="https://pepy.tech/projects/seleniumbase?timeRange=threeMonths&category=version&includeCIDownloads=true&granularity=daily&viewType=line&versions=*" target="_blank" rel="noopener"><img src="https://static.pepy.tech/badge/seleniumbase" alt="SeleniumBase PyPI downloads" height="20" /></a><br />
 <a href="https://www.youtube.com/playlist?list=PLp9uKicxkBc5UIlGi2BuE3aWC7JyXpD3m" target="_blank" rel="noopener"><img src="https://img.shields.io/badge/docs-📺-D844E8.svg?style=flat-square&logo=YouTube&logoColor=white&label=YouTube" alt="YouTube Channel" height="20" /></a> <a href="https://www.facebook.com/SeleniumBase/" target="_blank" rel="noopener"> <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" rel="noopener"><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> <a href="https://discord.gg/EdhQTn3EyE" target="_blank" rel="noopener"><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://github.com/seleniumbase/SeleniumBase" target="_blank" rel="noopener"><img src="https://badgen.net/github/stars/seleniumbase/SeleniumBase" title="Stars" height="20" /></a>
 </p>
-<p align="center">
-<a href="https://trendshift.io/repositories/12493?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-12493" target="_blank" rel="noopener"><img src="https://trendshift.io/api/badge/repositories/12493" alt="seleniumbase%2SeleniumBase | Trendshift" width="250" height="55"/></a>
-</p>
 <p align="center">
 <a href="#python_installation">🚀 Start</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/features_list.md">🏰 Features</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/customizing_test_runs.md">🎛️ Options</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/ReadMe.md">📚 Examples</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/console_scripts/ReadMe.md">💻 Scripts</a> |
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/locale_codes.md">🗾 Locale</a>
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/locale_codes.md">🗾 Locales</a>
 <br />
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/method_summary.md">📗 API</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/cdp_mode_methods.md">📘 Stealth API</a> |
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/syntax_formats.md"> 🔠 DesignPatterns</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/syntax_formats.md"> 🔠 Syntax Formats</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/recorder_mode.md">🔴 Recorder</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/example_logs/ReadMe.md">📊 Dashboard</a>
 <br />
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/commander.md">🎖️ GUI</a> |
-<a href="https://seleniumbase.io/demo_page">📰 TestPage</a> |
+<a href="https://seleniumbase.io/demo_page">📰 Test Page</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md">👤 UC Mode</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md">🐙 CDP Mode</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/chart_maker/ReadMe.md">📶 Charts</a> |
@@ -232,7 +226,7 @@ Dynamic: summary
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/tour_examples/ReadMe.md">🚎 Tours</a>
 <br />
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/mcp_servers/">🤖 MCP</a> |
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/js_package_manager.md">🟨 JS Mgr</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/js_package_manager.md">🟨 JS Tools</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/translations.md">🌏 Translator</a> |
 <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> |
@@ -241,51 +235,38 @@ Dynamic: summary
 --------
-🥷 <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md"><a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md"><b>CDP Mode</b></a> makes browser automation undetectable to anti-bot services and <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/ReadMe.md">adds <b>stealth</b> to stock <span translate="no">Playwright</span></a>. Also includes code for bypassing CAPTCHAs.
+🧪 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/).
-📚 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.)
+> [!NOTE]
+> Examples that start with `test` run with **`pytest`**.<br />
+> Other examples run directly with raw **`python`**.
 --------
-📝 [This example](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_cdp_mode.py) uses <b><code translate="no">seleniumbase</code></b> <b><code translate="no">sb_cdp</code></b> (*[Pure CDP Mode](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md#Pure_CDP_Mode)*):<br  /><em>(It bypasses BrowserScan, Sannysoft, and Cloudflare bot-detection)</em>
+📝 [This example](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_cdp_mode.py) uses <b><code translate="no">seleniumbase</code></b> <b><code translate="no">sb_cdp</code></b> (*[Pure CDP Mode](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md#Pure_CDP_Mode)*):<br  /><em>(It shows some basic methods and bypasses a Cloudflare Turnstile)</em>
 ```python
 from seleniumbase import sb_cdp
-sb = sb_cdp.Chrome()  # Launch a stealth browser
-sb.goto("https://browserscan.net/bot-detection")
-sb.assert_element('strong:contains("Normal")')
-sb.sleep(1)
-sb.goto("https://bot.sannysoft.com/")
-sb.assert_element(".passed")
-sb.assert_element_not_visible(".failed")
-sb.sleep(1)
+sb = sb_cdp.Chrome()  # Launches a stealth browser
 sb.goto("https://www.planetminecraft.com/account")
-sb.type('[name="email"]', "Name123")
+sb.type('[name="email"]', "Test123")
 sb.type('[name="password"]', "Pass")
-sb.click("input#autologin")
-sb.solve_captcha()  # Works on different CAPTCHAs
+sb.click("input#autologin")  # Unchecks a checkbox
+sb.solve_captcha()  # (as backup if not automatic)
 sb.assert_element('input[name="login"]')
 sb.assert_element_not_visible("input[disabled]")
-sb.sleep(1)
-sb.quit()  # Quit browser before end-of-program
+sb.sleep(1)  # (only to slow down the live demo)
+sb.quit()  # (otherwise quits automatically at end)
 ```
-<p align="center">
-<img src="https://seleniumbase.github.io/cdn/img/results_normal.jpg" width="520" style="max-width: 100% !important; height: auto !important;" alt="BrowserScan Test Results: Normal" />
-<br /><em>(All BrowserScan bot-detection tests passed successfully)</em>
-</p>
-<p align="center">
-<img src="https://seleniumbase.github.io/other/sannysoft_success.jpg" width="428" style="max-width: 100% !important; height: auto !important;" alt="All Sannysoft tests passed successfully" />
-<br /><em>(All Sannysoft bot-detection tests passed successfully)</em>
-</p>
-<p align="center">
-<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" />
-<br /><em>(Cloudflare Turnstile bypassed successfully on Planet Minecraft)</em>
+<p align="left">
+<img src="https://seleniumbase.github.io/other/pmc_captcha_3.png" width="542" style="max-width: 100% !important; height: auto !important;" alt="Cloudflare Turnstile bypassed successfully" />
+<br /><em>(Note that the click action only unchecked the "Stay signed in" checkbox.)</em>
 </p>
 --------
@@ -296,7 +277,7 @@ sb.quit()  # Quit browser before end-of-program
 --------
-<p align="left">📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_cdp_yc_news.py" target="_blank" rel="noopener">This script</a> scrapes Hacker News listings:</p>
+<p align="left">📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_cdp_yc_news.py" target="_blank" rel="noopener">This script</a> searches Hacker News via Algolia. Then prints items and saves to PDF:</p>
 ```python
 from seleniumbase import sb_cdp
@@ -305,7 +286,9 @@ sb = sb_cdp.Chrome(fast=True)
 sb.goto("https://hn.algolia.com/?query=seleniumbase")
 elements = sb.find_elements("div.Story_title > a")
 for element in elements:
-    print("* " + element.text)
+    print("--> " + element.text)
+sb.save_as_pdf("sb_news.pdf", folder="./downloaded_files/")
+print("*** PDF saved to: ./downloaded_files/sb_news.pdf")
 ```
 ```
@@ -313,7 +296,7 @@ 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;"/>
+<img src="https://seleniumbase.github.io/other/yc_news_results_2.png" alt="SeleniumBase" width="510" style="max-width: 100% !important; height: auto !important;"/>
 </p>
 --------
@@ -342,14 +325,6 @@ python raw_gitlab.py
 --------
-🧪 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>

{seleniumbase-4.56.5 → seleniumbase-4.57.1}/README.md RENAMED Viewed

@@ -8,37 +8,31 @@
 <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 align="center">📊 SeleniumBase</h1>
+<h1 align="center"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/super_logo_sb3.png" title="SeleniumBase" width="520" style="max-width: 100% !important; height: auto !important;" /></a></h1>
-<h3 align="center">One framework for browser automation, web scraping, and testing.<br /></h3>
-<p align="center"><b align="center">Includes stealth options for bypassing bot-detection and CAPTCHAs.<br /></b></p>
+<h3 align="center">Browser Automation, Web Scraping, and End-to-End Testing.<br /></h3>
 <p align="center">
 <a href="https://pypi.python.org/pypi/seleniumbase" target="_blank" rel="noopener"><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" rel="noopener"><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" target="_blank" rel="noopener"><img src="https://img.shields.io/badge/docs-seleniumbase.io-11BBAA.svg?style=flat-square" alt="SeleniumBase Docs" height="20" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/LICENSE" target="_blank" rel="noopener"><img src="https://img.shields.io/badge/license-MIT-33A6C6.svg?style=flat-square" title="SeleniumBase" height="20" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/tree/master/mcp_servers" target="_blank" rel="noopener"><img src="https://img.shields.io/badge/MCP-tool_info-7C6EE5?style=flat-square" height="20" /></a> <a href="https://pepy.tech/projects/seleniumbase?timeRange=threeMonths&category=version&includeCIDownloads=true&granularity=daily&viewType=line&versions=*" target="_blank" rel="noopener"><img src="https://static.pepy.tech/badge/seleniumbase" alt="SeleniumBase PyPI downloads" height="20" /></a><br />
 <a href="https://www.youtube.com/playlist?list=PLp9uKicxkBc5UIlGi2BuE3aWC7JyXpD3m" target="_blank" rel="noopener"><img src="https://img.shields.io/badge/docs-📺-D844E8.svg?style=flat-square&logo=YouTube&logoColor=white&label=YouTube" alt="YouTube Channel" height="20" /></a> <a href="https://www.facebook.com/SeleniumBase/" target="_blank" rel="noopener"> <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" rel="noopener"><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> <a href="https://discord.gg/EdhQTn3EyE" target="_blank" rel="noopener"><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://github.com/seleniumbase/SeleniumBase" target="_blank" rel="noopener"><img src="https://badgen.net/github/stars/seleniumbase/SeleniumBase" title="Stars" height="20" /></a>
 </p>
-<p align="center">
-<a href="https://trendshift.io/repositories/12493?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-12493" target="_blank" rel="noopener"><img src="https://trendshift.io/api/badge/repositories/12493" alt="seleniumbase%2SeleniumBase | Trendshift" width="250" height="55"/></a>
-</p>
 <p align="center">
 <a href="#python_installation">🚀 Start</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/features_list.md">🏰 Features</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/customizing_test_runs.md">🎛️ Options</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/ReadMe.md">📚 Examples</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/console_scripts/ReadMe.md">💻 Scripts</a> |
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/locale_codes.md">🗾 Locale</a>
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/locale_codes.md">🗾 Locales</a>
 <br />
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/method_summary.md">📗 API</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/cdp_mode_methods.md">📘 Stealth API</a> |
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/syntax_formats.md"> 🔠 DesignPatterns</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/syntax_formats.md"> 🔠 Syntax Formats</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/recorder_mode.md">🔴 Recorder</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/example_logs/ReadMe.md">📊 Dashboard</a>
 <br />
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/commander.md">🎖️ GUI</a> |
-<a href="https://seleniumbase.io/demo_page">📰 TestPage</a> |
+<a href="https://seleniumbase.io/demo_page">📰 Test Page</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md">👤 UC Mode</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md">🐙 CDP Mode</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/chart_maker/ReadMe.md">📶 Charts</a> |
@@ -51,7 +45,7 @@
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/tour_examples/ReadMe.md">🚎 Tours</a>
 <br />
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/mcp_servers/">🤖 MCP</a> |
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/js_package_manager.md">🟨 JS Mgr</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/js_package_manager.md">🟨 JS Tools</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/translations.md">🌏 Translator</a> |
 <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> |
@@ -60,51 +54,38 @@
 --------
-🥷 <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md"><a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md"><b>CDP Mode</b></a> makes browser automation undetectable to anti-bot services and <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/ReadMe.md">adds <b>stealth</b> to stock <span translate="no">Playwright</span></a>. Also includes code for bypassing CAPTCHAs.
+🧪 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/).
-📚 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.)
+> [!NOTE]
+> Examples that start with `test` run with **`pytest`**.<br />
+> Other examples run directly with raw **`python`**.
 --------
-📝 [This example](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_cdp_mode.py) uses <b><code translate="no">seleniumbase</code></b> <b><code translate="no">sb_cdp</code></b> (*[Pure CDP Mode](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md#Pure_CDP_Mode)*):<br  /><em>(It bypasses BrowserScan, Sannysoft, and Cloudflare bot-detection)</em>
+📝 [This example](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_cdp_mode.py) uses <b><code translate="no">seleniumbase</code></b> <b><code translate="no">sb_cdp</code></b> (*[Pure CDP Mode](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md#Pure_CDP_Mode)*):<br  /><em>(It shows some basic methods and bypasses a Cloudflare Turnstile)</em>
 ```python
 from seleniumbase import sb_cdp
-sb = sb_cdp.Chrome()  # Launch a stealth browser
-sb.goto("https://browserscan.net/bot-detection")
-sb.assert_element('strong:contains("Normal")')
-sb.sleep(1)
-sb.goto("https://bot.sannysoft.com/")
-sb.assert_element(".passed")
-sb.assert_element_not_visible(".failed")
-sb.sleep(1)
+sb = sb_cdp.Chrome()  # Launches a stealth browser
 sb.goto("https://www.planetminecraft.com/account")
-sb.type('[name="email"]', "Name123")
+sb.type('[name="email"]', "Test123")
 sb.type('[name="password"]', "Pass")
-sb.click("input#autologin")
-sb.solve_captcha()  # Works on different CAPTCHAs
+sb.click("input#autologin")  # Unchecks a checkbox
+sb.solve_captcha()  # (as backup if not automatic)
 sb.assert_element('input[name="login"]')
 sb.assert_element_not_visible("input[disabled]")
-sb.sleep(1)
-sb.quit()  # Quit browser before end-of-program
+sb.sleep(1)  # (only to slow down the live demo)
+sb.quit()  # (otherwise quits automatically at end)
 ```
-<p align="center">
-<img src="https://seleniumbase.github.io/cdn/img/results_normal.jpg" width="520" style="max-width: 100% !important; height: auto !important;" alt="BrowserScan Test Results: Normal" />
-<br /><em>(All BrowserScan bot-detection tests passed successfully)</em>
-</p>
-<p align="center">
-<img src="https://seleniumbase.github.io/other/sannysoft_success.jpg" width="428" style="max-width: 100% !important; height: auto !important;" alt="All Sannysoft tests passed successfully" />
-<br /><em>(All Sannysoft bot-detection tests passed successfully)</em>
-</p>
-<p align="center">
-<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" />
-<br /><em>(Cloudflare Turnstile bypassed successfully on Planet Minecraft)</em>
+<p align="left">
+<img src="https://seleniumbase.github.io/other/pmc_captcha_3.png" width="542" style="max-width: 100% !important; height: auto !important;" alt="Cloudflare Turnstile bypassed successfully" />
+<br /><em>(Note that the click action only unchecked the "Stay signed in" checkbox.)</em>
 </p>
 --------
@@ -115,7 +96,7 @@ sb.quit()  # Quit browser before end-of-program
 --------
-<p align="left">📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_cdp_yc_news.py" target="_blank" rel="noopener">This script</a> scrapes Hacker News listings:</p>
+<p align="left">📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_cdp_yc_news.py" target="_blank" rel="noopener">This script</a> searches Hacker News via Algolia. Then prints items and saves to PDF:</p>
 ```python
 from seleniumbase import sb_cdp
@@ -124,7 +105,9 @@ sb = sb_cdp.Chrome(fast=True)
 sb.goto("https://hn.algolia.com/?query=seleniumbase")
 elements = sb.find_elements("div.Story_title > a")
 for element in elements:
-    print("* " + element.text)
+    print("--> " + element.text)
+sb.save_as_pdf("sb_news.pdf", folder="./downloaded_files/")
+print("*** PDF saved to: ./downloaded_files/sb_news.pdf")
 ```
 ```
@@ -132,7 +115,7 @@ 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;"/>
+<img src="https://seleniumbase.github.io/other/yc_news_results_2.png" alt="SeleniumBase" width="510" style="max-width: 100% !important; height: auto !important;"/>
 </p>
 --------
@@ -161,14 +144,6 @@ python raw_gitlab.py
 --------
-🧪 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>

{seleniumbase-4.56.5 → seleniumbase-4.57.1}/requirements.txt RENAMED Viewed

@@ -1,4 +1,4 @@
-pip>=26.2.2
+pip>=26.3
 packaging>=26.3
 setuptools>=84.2.1
 wheel>=0.48.0
@@ -6,9 +6,9 @@ attrs>=26.1.0
 certifi>=2026.10.23
 exceptiongroup>=1.3.1
 websockets~=16.1.1;python_version=="3.10"
-websockets>=17.3;python_version>="3.11"
+websockets>=17.4;python_version>="3.11"
 filelock==4.1.0;python_version=="3.10"
-filelock>=4.2.4;python_version>="3.11"
+filelock>=4.2.9;python_version>="3.11"
 fasteners>=0.20
 mycdp>=1.4.0
 pynose>=1.5.5
@@ -33,11 +33,11 @@ requests~=2.34.2
 sniffio==1.3.1
 h11==0.16.0
 outcome==1.3.0.post0
-trio>=0.34.0,<1
+trio>=0.35.0,<1
 trio-websocket~=0.12.2
 wsproto~=1.3.2
 websocket-client~=1.9.2
-selenium==4.51.0
+selenium==4.52.0
 cssselect~=1.5.0;python_version<"3.11"
 cssselect>=1.6.0,<2;python_version>="3.11"
 sortedcontainers==2.4.0
@@ -56,7 +56,7 @@ pytest-xdist==3.8.0
 parameterized==0.9.0
 behave==1.2.6
 soupsieve~=2.10.0;python_version<"3.11.5"
-soupsieve~=3.0.4;python_version>="3.11.5"
+soupsieve~=4.0.1;python_version>="3.11.5"
 beautifulsoup4~=4.15.0
 pyotp~=2.10.0
 python-xlib==0.33;platform_system=="Linux"
@@ -69,7 +69,7 @@ rich>=15.0.0,<16
 # ("pip install -r requirements.txt" also installs this, but "pip install -e ." won't.)
 coverage>=7.16.2;python_version=="3.10"
-coverage>=7.17.0;python_version>="3.11"
+coverage>=7.17.2;python_version>="3.11"
 pytest-cov>=7.1.0
 flake8==7.4.1;python_version=="3.10"
 flake8==7.5.0;python_version>="3.11"

{seleniumbase-4.56.5 → seleniumbase-4.57.1}/seleniumbase/__version__.py RENAMED Viewed

@@ -1,2 +1,2 @@
 # seleniumbase package
-__version__ = "4.56.5"
+__version__ = "4.57.1"

{seleniumbase-4.56.5 → seleniumbase-4.57.1}/seleniumbase/console_scripts/run.py RENAMED Viewed

@@ -152,14 +152,14 @@ def show_install_usage():
     print("    sbase get chromedriver")
     print("    sbase get geckodriver")
     print("    sbase get edgedriver")
-    print("    sbase get chromedriver 149")
-    print("    sbase get chromedriver 149.0.7827.155")
+    print("    sbase get chromedriver 156")
+    print("    sbase get chromedriver 156.0.8078.80")
     print("    sbase get chromedriver stable")
     print("    sbase get chromedriver beta")
     print("    sbase get chromedriver -p")
     print("    sbase get chromium")
     print("    sbase get chromium --revision=1639046")
-    print("    sbase get cft 149")
+    print("    sbase get cft 156")
     print("    sbase get chs")
     print("Output:")
     print("    Downloads driver/binary to seleniumbase/drivers/")

{seleniumbase-4.56.5 → seleniumbase-4.57.1}/seleniumbase/console_scripts/sb_install.py RENAMED Viewed

@@ -19,14 +19,14 @@ Examples:
     sbase get chromedriver
     sbase get geckodriver
     sbase get edgedriver
-    sbase get chromedriver 149
-    sbase get chromedriver 149.0.7827.155
+    sbase get chromedriver 156
+    sbase get chromedriver 156.0.8078.80
     sbase get chromedriver stable
     sbase get chromedriver beta
     sbase get chromedriver -p
     sbase get chromium
     sbase get chromium --revision=1639046
-    sbase get cft 149
+    sbase get cft 156
     sbase get chs
 Output:
     Downloads driver/binary to seleniumbase/drivers/
@@ -72,7 +72,7 @@ DRIVER_DIR_CHROMIUM = os.path.dirname(
 )
 LOCAL_PATH = "/usr/local/bin/"  # On Mac and Linux systems
 DEFAULT_CHROMEDRIVER_VERSION = "114.0.5735.90"  # (If can't find LATEST_STABLE)
-DEFAULT_GECKODRIVER_VERSION = "v0.36.0"
+DEFAULT_GECKODRIVER_VERSION = "v0.37.1"
 DEFAULT_EDGEDRIVER_VERSION = "115.0.1901.183"  # (If can't find LATEST_STABLE)
@@ -96,14 +96,14 @@ def invalid_run_command():
     exp += "    sbase get chromedriver\n"
     exp += "    sbase get geckodriver\n"
     exp += "    sbase get edgedriver\n"
-    exp += "    sbase get chromedriver 149\n"
-    exp += "    sbase get chromedriver 149.0.7827.155\n"
+    exp += "    sbase get chromedriver 156\n"
+    exp += "    sbase get chromedriver 156.0.8078.80\n"
     exp += "    sbase get chromedriver stable\n"
     exp += "    sbase get chromedriver beta\n"
     exp += "    sbase get chromedriver -p\n"
     exp += "    sbase get chromium\n"
     exp += "    sbase get chromium --revision=1639046\n"
-    exp += "    sbase get cft 149\n"
+    exp += "    sbase get cft 156\n"
     exp += "    sbase get chs\n"
     exp += "Output:\n"
     exp += "    Downloads driver/binary to seleniumbase/drivers/\n"
@@ -504,7 +504,10 @@ def main(override=None, intel_for_uc=None, force_uc=None):
             else:
                 file_name = "chromedriver_mac64.zip"
         elif IS_LINUX:
-            file_name = "chromedriver_linux64.zip"
+            if IS_ARM_LINUX:
+                file_name = "chromedriver-linux-arm64.zip"
+            else:
+                file_name = "chromedriver-linux64.zip"
         elif IS_WINDOWS:
             file_name = "chromedriver_win32.zip"  # Works for win32 / win_x64
             if not get_latest and not get_v_latest and num_args < 4:
@@ -596,8 +599,12 @@ def main(override=None, intel_for_uc=None, force_uc=None):
                     platform_code = "mac-x64"
                     file_name = "chromedriver-mac-x64.zip"
             elif IS_LINUX:
-                platform_code = "linux64"
-                file_name = "chromedriver-linux64.zip"
+                if IS_ARM_LINUX:
+                    platform_code = "linux-arm64"
+                    file_name = "chromedriver-linux-arm64.zip"
+                else:
+                    platform_code = "linux64"
+                    file_name = "chromedriver-linux64.zip"
             elif IS_WINDOWS:
                 if "64" in ARCH:
                     platform_code = "win64"
@@ -715,8 +722,12 @@ def main(override=None, intel_for_uc=None, force_uc=None):
                 platform_code = "mac-x64"
                 file_name = "chrome-mac-x64.zip"
         elif IS_LINUX:
-            platform_code = "linux64"
-            file_name = "chrome-linux64.zip"
+            if IS_ARM_LINUX:
+                platform_code = "linux-arm64"
+                file_name = "chrome-linux-arm64.zip"
+            else:
+                platform_code = "linux64"
+                file_name = "chrome-linux64.zip"
         elif IS_WINDOWS:
             if "64" in ARCH:
                 platform_code = "win64"
@@ -824,8 +835,12 @@ def main(override=None, intel_for_uc=None, force_uc=None):
                 platform_code = "mac-x64"
                 file_name = "chrome-headless-shell-mac-x64.zip"
         elif IS_LINUX:
-            platform_code = "linux64"
-            file_name = "chrome-headless-shell-linux64.zip"
+            if IS_ARM_LINUX:
+                platform_code = "linux-arm64"
+                file_name = "chrome-headless-shell-linux-arm64.zip"
+            else:
+                platform_code = "linux64"
+                file_name = "chrome-headless-shell-linux64.zip"
         elif IS_WINDOWS:
             if "64" in ARCH:
                 platform_code = "win64"
@@ -869,7 +884,7 @@ def main(override=None, intel_for_uc=None, force_uc=None):
                 file_name = "geckodriver-%s-macos.tar.gz" % use_version
         elif IS_LINUX:
             if "64" in ARCH:
-                if "aarch64" in platform.processor():
+                if IS_ARM_LINUX:
                     file_name = (
                         "geckodriver-%s-linux-aarch64.tar.gz" % use_version
                     )

{seleniumbase-4.56.5 → seleniumbase-4.57.1}/seleniumbase/core/browser_launcher.py RENAMED Viewed

@@ -2828,7 +2828,6 @@ def _set_chrome_options(
     included_disabled_features.append("NetworkPrediction")
     included_disabled_features.append("WebAuthentication")
     included_disabled_features.append("PasskeyAuth")
-    included_disabled_features.append("MediaRouter")
     included_disabled_features.append("DialMediaRouteProvider")
     included_disabled_features.append("WebRtcHideLocalIpsWithMdns")
     if is_using_uc(undetectable, browser_name):

seleniumbase 4.56.5__tar.gz → 4.57.1__tar.gz

seleniumbase 4.56.5tar.gz → 4.57.1tar.gz