seleniumbase 4.57.0__tar.gz → 4.57.1__tar.gz

{seleniumbase-4.57.0/seleniumbase.egg-info → seleniumbase-4.57.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: seleniumbase
-Version: 4.57.0
+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
@@ -68,7 +68,7 @@ Requires-Dist: exceptiongroup>=1.3.1
 Requires-Dist: websockets~=16.1.1; python_version == "3.10"
 Requires-Dist: websockets>=17.4; python_version >= "3.11"
 Requires-Dist: filelock==4.1.0; python_version == "3.10"
-Requires-Dist: filelock>=4.2.7; 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
@@ -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"
@@ -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">APIs for Web Scraping, Browser Automation, and E2E 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> bypasses bot-detection and <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/ReadMe.md">makes <span translate="no">Playwright</span> stealthy</a>.
+🧪 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>" run with <code><b>pytest</b></code>. Other scripts run directly with raw <code><b>python</b></code> (and 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.57.0 → seleniumbase-4.57.1}/README.md

@@ -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">APIs for Web Scraping, Browser Automation, and E2E 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> bypasses bot-detection and <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/ReadMe.md">makes <span translate="no">Playwright</span> stealthy</a>.
+🧪 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>" run with <code><b>pytest</b></code>. Other scripts run directly with raw <code><b>python</b></code> (and 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.57.0 → seleniumbase-4.57.1}/requirements.txt

@@ -8,7 +8,7 @@ exceptiongroup>=1.3.1
 websockets~=16.1.1;python_version=="3.10"
 websockets>=17.4;python_version>="3.11"
 filelock==4.1.0;python_version=="3.10"
-filelock>=4.2.7;python_version>="3.11"
+filelock>=4.2.9;python_version>="3.11"
 fasteners>=0.20
 mycdp>=1.4.0
 pynose>=1.5.5
@@ -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.57.0 → seleniumbase-4.57.1}/seleniumbase/__version__.py

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

{seleniumbase-4.57.0 → seleniumbase-4.57.1}/seleniumbase/console_scripts/run.py

@@ -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.57.0 → seleniumbase-4.57.1}/seleniumbase/console_scripts/sb_install.py

@@ -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.57.0 → seleniumbase-4.57.1}/seleniumbase/fixtures/shared_utils.py

@@ -79,13 +79,11 @@ def get_mfa_code(totp_key=None):
 
 def is_arm_linux():
     """Returns True if machine is ARM Linux.
-    This will be useful once Google adds
-    support for ARM Linux ChromeDriver.
     (Raspberry Pi uses ARM architecture.)"""
-    return (
-        platform.system() == "Linux"
-        and platform.machine() == "aarch64"
+    is_linux = (
+        platform.system() == "Linux" or "linux" in sys.platform
     )
+    return is_linux and (platform.machine().lower() in ("aarch64", "arm64"))
 
 
 def is_arm_mac():