seleniumbase 4.57.1__tar.gz → 4.58.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: seleniumbase
-Version: 4.57.1
+Version: 4.58.0
 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.9; python_version >= "3.11"
+Requires-Dist: filelock>=4.2.10; python_version >= "3.11"
 Requires-Dist: fasteners>=0.20
 Requires-Dist: mycdp>=1.4.0
 Requires-Dist: pynose>=1.5.5
@@ -85,7 +85,7 @@ Requires-Dist: pyyaml>=6.0.3
 Requires-Dist: pygments>=2.20.1
 Requires-Dist: pyreadline3>=3.5.4; platform_system == "Windows"
 Requires-Dist: tabcompleter>=1.4.1
-Requires-Dist: pdbp>=1.8.3
+Requires-Dist: pdbp>=1.9.0
 Requires-Dist: idna>=3.20
 Requires-Dist: charset-normalizer<4,>=3.5.2
 Requires-Dist: urllib3<3,>=2.8.0
@@ -116,12 +116,12 @@ 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~=4.0.1; python_version >= "3.11.5"
+Requires-Dist: soupsieve~=4.1.1; python_version >= "3.11.5"
 Requires-Dist: beautifulsoup4~=4.15.0
-Requires-Dist: pyotp~=2.10.0
+Requires-Dist: pyotp~=2.11.2
 Requires-Dist: python-xlib==0.33; platform_system == "Linux"
 Requires-Dist: PyAutoGUI>=0.9.54; platform_system == "Linux"
-Requires-Dist: markdown-it-py==4.2.0
+Requires-Dist: markdown-it-py==4.3.0
 Requires-Dist: mdurl==0.1.2
 Requires-Dist: rich<16,>=15.0.0
 Provides-Extra: allure
@@ -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.2; python_version >= "3.11" and extra == "coverage"
+Requires-Dist: coverage>=7.17.3; 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"
@@ -157,14 +157,12 @@ Requires-Dist: pip-system-certs>=4.0; platform_system == "Windows" and extra ==
 Provides-Extra: proxy
 Requires-Dist: proxy.py==2.4.3; extra == "proxy"
 Provides-Extra: playwright
-Requires-Dist: playwright>=1.64.1; extra == "playwright"
+Requires-Dist: playwright>=1.65.2; extra == "playwright"
 Requires-Dist: greenlet>=3.5.6; extra == "playwright"
-Requires-Dist: pyee>=13.0.1; python_version < "3.12" and extra == "playwright"
-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.7; extra == "uv"
+Requires-Dist: uv>=0.13.8; extra == "uv"
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -189,13 +187,10 @@ 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"><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">Browser Automation, Web Scraping, and End-to-End Testing.<br /></h3>
+<h3 align="center" class="hero__title"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/nice_logo_8t.png" alt="SeleniumBase" title="SeleniumBase" width="450" /></a><br /><b>A Complete Browser Automation Experience:<br />Web Crawling / Testing / Scraping / Stealth</b></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>
+<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://flat.badgen.net/github/checks/seleniumbase/SeleniumBase/master?label=CI&" alt="CI Status" 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><br /><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> <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://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">
@@ -233,6 +228,27 @@ Dynamic: summary
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/case_plans.md">🗂️ CPlans</a>
 </p>
 
+<h4>SeleniumBase is the professional toolkit for web automation activities. Built for testing websites, bypassing CAPTCHAs, enhancing productivity, completing tasks, and scaling your business.</h4>
+
+--------
+
+📚 Learn from [**over 200 examples** in **SeleniumBase/examples/**](https://github.com/seleniumbase/SeleniumBase/tree/master/examples).
+
+<p align="left"><a href="https://github.com/seleniumbase/SeleniumBase/tree/master/examples" target="_blank" rel="noopener"><img src="https://seleniumbase.github.io/cdn/gif/google_search.gif" alt="SeleniumBase Google Search" title="SeleniumBase Google Search" width="480" /></a></p>
+
+--------
+
+<h3 align="left"><img src="https://seleniumbase.io/img/logo6.png" title="SeleniumBase" width="32" /> SeleniumBase Chromium architecture and modes:</h3>
+
+<img src="https://seleniumbase.github.io/other/sb_architecture.png" width="600" style="max-width: 100% !important; height: auto !important;" alt="Stealthy architecture flowchart" />
+
+> (*Note that "Regular Mode" also supports Safari/WebKit and Firefox/Gecko.*)
+
+<ul>
+<li>🐙 <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md"><b>CDP Mode</b></a> <b>bypasses bot-detection with Chromium-based browsers.</b></li>
+<li>🎭 <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> <b>extends CDP Mode's stealth to Playwright.</b></li>
+</ul>
+
 --------
 
 🧪 End-to-End Testing examples are located in [./examples/](https://github.com/seleniumbase/SeleniumBase/blob/master/examples).
@@ -252,21 +268,21 @@ Dynamic: summary
 ```python
 from seleniumbase import sb_cdp
 
-sb = sb_cdp.Chrome()  # Launches a stealth browser
+sb = sb_cdp.Chrome()  # Launch a stealth browser
 sb.goto("https://www.planetminecraft.com/account")
 sb.type('[name="email"]', "Test123")
 sb.type('[name="password"]', "Pass")
-sb.click("input#autologin")  # Unchecks a checkbox
-sb.solve_captcha()  # (as backup if not automatic)
+sb.click("input#autologin")  # Uncheck a checkbox
+sb.solve_captcha()  # (fallback if not automatic)
 sb.assert_element('input[name="login"]')
 sb.assert_element_not_visible("input[disabled]")
-sb.sleep(1)  # (only to slow down the live demo)
-sb.quit()  # (otherwise quits automatically at end)
+sb.sleep(1)  # (see the live demo more easily)
+sb.quit()
 ```
 
 <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>
+<img src="https://seleniumbase.github.io/other/pmc_captcha_3.png" width="572" style="max-width: 100% !important; height: auto !important;" alt="Cloudflare Turnstile bypassed successfully" />
+<br /><em>(Note: In this example, the click only unchecks the "Stay signed in" checkbox.)</em>
 </p>
 
 --------
@@ -346,12 +362,6 @@ 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="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">📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_get_swag.py" target="_blank" rel="noopener">This script</a> tests an e-commerce site: (Runs with <b><code>pytest</code></b>):</p>
@@ -440,7 +450,7 @@ pytest test_demo_site.py
 
 --------
 
-<p align="left"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/super_logo_sb3.png" alt="SeleniumBase" title="SeleniumBase" width="232" /></a></p>
+<p align="left"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/super_logo_sb3.png" alt="SeleniumBase" title="SeleniumBase" width="248" /></a></p>
 
 <blockquote>
 <p dir="auto"><strong>Explore the README:</strong></p>
@@ -994,6 +1004,7 @@ pytest test_coffee_cart.py --trace
 --rs | --reuse-session  # (Reuse browser session for all tests.)
 --rcs | --reuse-class-session  # (Reuse session for tests in class.)
 --crumbs  # (Delete all cookies between tests reusing a session.)
+--no-tt  # (Skips "--test-type" when using Proxy Mode. Adds stealth.)
 --disable-beforeunload  # (Disable the "beforeunload" event on Chrome.)
 --window-position=X,Y  # (Set the browser's starting window position.)
 --window-size=WIDTH,HEIGHT  # (Set the browser's starting window size.)
@@ -1670,7 +1681,7 @@ pytest --reruns=1 --reruns-delay=1
 
 <p><div><b><a href="https://github.com/mdmintz" target="_blank" rel="noopener">https://github.com/mdmintz</a></b></div></p>
 
-<div><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/super_logo_sb3.png" title="SeleniumBase" width="310" style="max-width: 100% !important; height: auto !important;" /></a></div>
+<div><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/super_logo_sb6.png" title="SeleniumBase" width="310" style="max-width: 100% !important; height: auto !important;" /></a></div>
 <div><a href="https://github.com/seleniumbase/SeleniumBase"><img src="https://img.shields.io/badge/tested%20with-SeleniumBase-04C38E.svg" alt="Tested with SeleniumBase" /></a> <img src="https://views.whatilearened.today/views/github/seleniumbase/SeleniumBase.svg" width="98px" height="20px" alt="Views" /></div>
 <div><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/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-22BBCC.svg" title="SeleniumBase" height="20" /></a> </div>
 <div align="left"></div>

{seleniumbase-4.57.1 → seleniumbase-4.58.0}/README.md

@@ -8,13 +8,10 @@
 <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"><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">Browser Automation, Web Scraping, and End-to-End Testing.<br /></h3>
+<h3 align="center" class="hero__title"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/nice_logo_8t.png" alt="SeleniumBase" title="SeleniumBase" width="450" /></a><br /><b>A Complete Browser Automation Experience:<br />Web Crawling / Testing / Scraping / Stealth</b></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>
+<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://flat.badgen.net/github/checks/seleniumbase/SeleniumBase/master?label=CI&" alt="CI Status" 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><br /><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> <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://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">
@@ -52,6 +49,27 @@
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/case_plans.md">🗂️ CPlans</a>
 </p>
 
+<h4>SeleniumBase is the professional toolkit for web automation activities. Built for testing websites, bypassing CAPTCHAs, enhancing productivity, completing tasks, and scaling your business.</h4>
+
+--------
+
+📚 Learn from [**over 200 examples** in **SeleniumBase/examples/**](https://github.com/seleniumbase/SeleniumBase/tree/master/examples).
+
+<p align="left"><a href="https://github.com/seleniumbase/SeleniumBase/tree/master/examples" target="_blank" rel="noopener"><img src="https://seleniumbase.github.io/cdn/gif/google_search.gif" alt="SeleniumBase Google Search" title="SeleniumBase Google Search" width="480" /></a></p>
+
+--------
+
+<h3 align="left"><img src="https://seleniumbase.io/img/logo6.png" title="SeleniumBase" width="32" /> SeleniumBase Chromium architecture and modes:</h3>
+
+<img src="https://seleniumbase.github.io/other/sb_architecture.png" width="600" style="max-width: 100% !important; height: auto !important;" alt="Stealthy architecture flowchart" />
+
+> (*Note that "Regular Mode" also supports Safari/WebKit and Firefox/Gecko.*)
+
+<ul>
+<li>🐙 <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md"><b>CDP Mode</b></a> <b>bypasses bot-detection with Chromium-based browsers.</b></li>
+<li>🎭 <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> <b>extends CDP Mode's stealth to Playwright.</b></li>
+</ul>
+
 --------
 
 🧪 End-to-End Testing examples are located in [./examples/](https://github.com/seleniumbase/SeleniumBase/blob/master/examples).
@@ -71,21 +89,21 @@
 ```python
 from seleniumbase import sb_cdp
 
-sb = sb_cdp.Chrome()  # Launches a stealth browser
+sb = sb_cdp.Chrome()  # Launch a stealth browser
 sb.goto("https://www.planetminecraft.com/account")
 sb.type('[name="email"]', "Test123")
 sb.type('[name="password"]', "Pass")
-sb.click("input#autologin")  # Unchecks a checkbox
-sb.solve_captcha()  # (as backup if not automatic)
+sb.click("input#autologin")  # Uncheck a checkbox
+sb.solve_captcha()  # (fallback if not automatic)
 sb.assert_element('input[name="login"]')
 sb.assert_element_not_visible("input[disabled]")
-sb.sleep(1)  # (only to slow down the live demo)
-sb.quit()  # (otherwise quits automatically at end)
+sb.sleep(1)  # (see the live demo more easily)
+sb.quit()
 ```
 
 <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>
+<img src="https://seleniumbase.github.io/other/pmc_captcha_3.png" width="572" style="max-width: 100% !important; height: auto !important;" alt="Cloudflare Turnstile bypassed successfully" />
+<br /><em>(Note: In this example, the click only unchecks the "Stay signed in" checkbox.)</em>
 </p>
 
 --------
@@ -165,12 +183,6 @@ 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="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">📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_get_swag.py" target="_blank" rel="noopener">This script</a> tests an e-commerce site: (Runs with <b><code>pytest</code></b>):</p>
@@ -259,7 +271,7 @@ pytest test_demo_site.py
 
 --------
 
-<p align="left"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/super_logo_sb3.png" alt="SeleniumBase" title="SeleniumBase" width="232" /></a></p>
+<p align="left"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/super_logo_sb3.png" alt="SeleniumBase" title="SeleniumBase" width="248" /></a></p>
 
 <blockquote>
 <p dir="auto"><strong>Explore the README:</strong></p>
@@ -813,6 +825,7 @@ pytest test_coffee_cart.py --trace
 --rs | --reuse-session  # (Reuse browser session for all tests.)
 --rcs | --reuse-class-session  # (Reuse session for tests in class.)
 --crumbs  # (Delete all cookies between tests reusing a session.)
+--no-tt  # (Skips "--test-type" when using Proxy Mode. Adds stealth.)
 --disable-beforeunload  # (Disable the "beforeunload" event on Chrome.)
 --window-position=X,Y  # (Set the browser's starting window position.)
 --window-size=WIDTH,HEIGHT  # (Set the browser's starting window size.)
@@ -1489,7 +1502,7 @@ pytest --reruns=1 --reruns-delay=1
 
 <p><div><b><a href="https://github.com/mdmintz" target="_blank" rel="noopener">https://github.com/mdmintz</a></b></div></p>
 
-<div><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/super_logo_sb3.png" title="SeleniumBase" width="310" style="max-width: 100% !important; height: auto !important;" /></a></div>
+<div><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/super_logo_sb6.png" title="SeleniumBase" width="310" style="max-width: 100% !important; height: auto !important;" /></a></div>
 <div><a href="https://github.com/seleniumbase/SeleniumBase"><img src="https://img.shields.io/badge/tested%20with-SeleniumBase-04C38E.svg" alt="Tested with SeleniumBase" /></a> <img src="https://views.whatilearened.today/views/github/seleniumbase/SeleniumBase.svg" width="98px" height="20px" alt="Views" /></div>
 <div><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/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-22BBCC.svg" title="SeleniumBase" height="20" /></a> </div>
 <div align="left"></div>

{seleniumbase-4.57.1 → seleniumbase-4.58.0}/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.9;python_version>="3.11"
+filelock>=4.2.10;python_version>="3.11"
 fasteners>=0.20
 mycdp>=1.4.0
 pynose>=1.5.5
@@ -25,7 +25,7 @@ pyyaml>=6.0.3
 pygments>=2.20.1
 pyreadline3>=3.5.4;platform_system=="Windows"
 tabcompleter>=1.4.1
-pdbp>=1.8.3
+pdbp>=1.9.0
 idna>=3.20
 charset-normalizer>=3.5.2,<4
 urllib3>=2.8.0,<3
@@ -56,12 +56,12 @@ pytest-xdist==3.8.0
 parameterized==0.9.0
 behave==1.2.6
 soupsieve~=2.10.0;python_version<"3.11.5"
-soupsieve~=4.0.1;python_version>="3.11.5"
+soupsieve~=4.1.1;python_version>="3.11.5"
 beautifulsoup4~=4.15.0
-pyotp~=2.10.0
+pyotp~=2.11.2
 python-xlib==0.33;platform_system=="Linux"
 PyAutoGUI>=0.9.54;platform_system=="Linux"
-markdown-it-py==4.2.0
+markdown-it-py==4.3.0
 mdurl==0.1.2
 rich>=15.0.0,<16
 
@@ -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.2;python_version>="3.11"
+coverage>=7.17.3;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.1 → seleniumbase-4.58.0}/seleniumbase/__version__.py

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

{seleniumbase-4.57.1 → seleniumbase-4.58.0}/seleniumbase/core/browser_launcher.py

@@ -929,6 +929,7 @@ def uc_open_with_cdp_mode(driver, url=None, **kwargs):
     cdp.enter_mfa_code = CDPM.enter_mfa_code
     cdp.flash = CDPM.flash
     cdp.highlight = CDPM.highlight
+    cdp.highlight_if_visible = CDPM.highlight_if_visible
     cdp.focus = CDPM.focus
     cdp.highlight_overlay = CDPM.highlight_overlay
     cdp.get_window_position = CDPM.get_window_position
@@ -2373,7 +2374,8 @@ def _set_chrome_options(
     device_pixel_ratio,
 ):
     chrome_options = webdriver.ChromeOptions()
-    if is_using_uc(undetectable, browser_name):
+    is_uc = is_using_uc(undetectable, browser_name)
+    if is_uc:
         from seleniumbase import undetected
         chrome_options = undetected.ChromeOptions()
     elif browser_name == constants.Browser.EDGE:
@@ -2457,7 +2459,7 @@ def _set_chrome_options(
         chrome_options.add_argument(
             "--host-resolver-rules=%s" % host_resolver_rules
         )
-    if mobile_emulator and not is_using_uc(undetectable, browser_name):
+    if mobile_emulator and not is_uc:
         emulator_settings = {}
         device_metrics = {}
         if (
@@ -2555,7 +2557,7 @@ def _set_chrome_options(
             pass
     if dark_mode:
         chrome_options.add_argument("--enable-features=WebContentsForceDark")
-    if user_data_dir and not is_using_uc(undetectable, browser_name):
+    if user_data_dir and not is_uc:
         abs_path = os.path.abspath(user_data_dir)
         chrome_options.add_argument("--user-data-dir=%s" % abs_path)
     if extension_zip:
@@ -2646,7 +2648,7 @@ def _set_chrome_options(
     if proxy_string:
         if proxy_auth:
             zip_it = True
-            if is_using_uc(undetectable, browser_name):
+            if is_uc:
                 zip_it = False  # undetected-chromedriver needs a folder ext
             chrome_options = _add_chrome_proxy_extension(
                 chrome_options,
@@ -2666,7 +2668,7 @@ def _set_chrome_options(
     elif proxy_pac_url:
         if proxy_auth:
             zip_it = True  # undetected-chromedriver needs a folder ext
-            if is_using_uc(undetectable, browser_name):
+            if is_uc:
                 zip_it = False
             chrome_options = _add_chrome_proxy_extension(
                 chrome_options,
@@ -2679,18 +2681,14 @@ def _set_chrome_options(
                 multi_proxy,
             )
         chrome_options.add_argument("--proxy-pac-url=%s" % proxy_pac_url)
-    if (
-        not is_using_uc(undetectable, browser_name)
-        or not enable_ws
-        or proxy_string
-    ):
+    if not is_uc or not enable_ws or proxy_string:
         chrome_options.add_argument("--ignore-certificate-errors")
         chrome_options.add_argument("--ignore-ssl-errors=yes")
     if not enable_ws:
         chrome_options.add_argument("--disable-web-security")
     if (
         IS_LINUX
-        or (IS_MAC and not is_using_uc(undetectable, browser_name))
+        or (IS_MAC and not is_uc)
     ):
         chrome_options.add_argument("--no-sandbox")
     if remote_debug:
@@ -2705,13 +2703,10 @@ def _set_chrome_options(
     if swiftshader:
         chrome_options.add_argument("--use-gl=angle")
         chrome_options.add_argument("--use-angle=swiftshader-webgl")
-    elif (
-        not is_using_uc(undetectable, browser_name)
-        and not enable_3d_apis
-    ):
+    elif not is_uc and not enable_3d_apis:
         chrome_options.add_argument("--disable-gpu")
     if (
-        (not IS_LINUX and is_using_uc(undetectable, browser_name))
+        (not IS_LINUX and is_uc)
         or (
             IS_MAC
             and binary_location
@@ -2722,7 +2717,7 @@ def _set_chrome_options(
         chrome_options.add_argument("--disable-application-cache")
     if IS_LINUX:
         chrome_options.add_argument("--disable-dev-shm-usage")
-        if is_using_uc(undetectable, browser_name):
+        if is_uc:
             chrome_options.add_argument("--disable-application-cache")
             chrome_options.add_argument("--disable-setuid-sandbox")
         if not binary_location:
@@ -2762,9 +2757,7 @@ def _set_chrome_options(
                     )
             if "set-binary" in chromium_arg_item and not binary_location:
                 br_app = "google-chrome"
-                binary_loc = detect_b_ver.get_binary_location(
-                    br_app, is_using_uc(undetectable, browser_name)
-                )
+                binary_loc = detect_b_ver.get_binary_location(br_app, is_uc)
                 if os.path.exists(binary_loc):
                     binary_location = binary_loc
             elif "disable-features=" in chromium_arg_item:
@@ -2789,9 +2782,9 @@ def _set_chrome_options(
     chrome_options.add_argument("--disable-translate")
     if binary_location:
         chrome_options.binary_location = binary_location
-    if not enable_3d_apis and not is_using_uc(undetectable, browser_name):
+    if not enable_3d_apis and not is_uc:
         chrome_options.add_argument("--disable-3d-apis")
-    if headless or headless2 or is_using_uc(undetectable, browser_name):
+    if headless or headless2 or is_uc:
         chrome_options.add_argument("--disable-renderer-backgrounding")
     chrome_options.add_argument("--disable-background-networking")
     chrome_options.add_argument("--disable-backgrounding-occluded-windows")
@@ -2805,7 +2798,10 @@ def _set_chrome_options(
     chrome_options.add_argument(
         '--simulate-outdated-no-au="Tue, 31 Dec 2099 23:59:59 GMT"'
     )
-    chrome_options.add_argument("--disable-ipc-flooding-protection")
+    if not is_uc or __is_using_fast_mode():
+        # Since disabling IPC FP is detectable by sites that look for it,
+        # we'll now keep it enabled in UC Mode / CDP Mode, unless "fast".
+        chrome_options.add_argument("--disable-ipc-flooding-protection")
     chrome_options.add_argument("--disable-password-generation")
     chrome_options.add_argument("--disable-domain-reliability")
     chrome_options.add_argument("--disable-breakpad")
@@ -2830,7 +2826,7 @@ def _set_chrome_options(
     included_disabled_features.append("PasskeyAuth")
     included_disabled_features.append("DialMediaRouteProvider")
     included_disabled_features.append("WebRtcHideLocalIpsWithMdns")
-    if is_using_uc(undetectable, browser_name):
+    if is_uc:
         included_disabled_features.append("IsolateOrigins")
         included_disabled_features.append("site-per-process")
     for item in extra_disabled_features:
@@ -2839,20 +2835,30 @@ def _set_chrome_options(
     d_f_string = ",".join(included_disabled_features)
     chrome_options.add_argument("--disable-features=%s" % d_f_string)
     chrome_options.add_argument("--enable-unsafe-extension-debugging")
+    if is_uc and binary_location and "cft_drivers" in binary_location:
+        chrome_options.add_argument("--disable-infobars")
     if (
         hasattr(sb_config, "_cdp_browser")
         and sb_config._cdp_browser == "brave"
     ):
         pass  # Looks like "--test-type" breaks Brave now
     else:
-        chrome_options.add_argument("--test-type")
+        if not is_uc or (
+            proxy_string and not (
+                hasattr(sb_config, "_no_tt") and sb_config._no_tt
+            )
+        ):
+            # Since --test-type is detectable by sites that look for it,
+            # there's a new no_tt option to skip it in UC Mode / CDP Mode
+            # when using a proxy. Not used anymore if no proxy otherwise.
+            chrome_options.add_argument("--test-type")
     if proxy_auth or sb_config._ext_dirs:
-        if not is_using_uc(undetectable, browser_name):
+        if not is_uc:
             chrome_options.add_argument("--remote-debugging-pipe")
             chrome_options.enable_webextensions = True
             chrome_options.enable_bidi = True
     if (
-        is_using_uc(undetectable, browser_name)
+        is_uc
         and (
             not headless
             or IS_LINUX  # switches to Xvfb (non-headless)
@@ -2866,7 +2872,8 @@ def _set_chrome_options(
         chrome_options.add_argument("--disable-auto-reload")
         chrome_options.add_argument("--disable-background-timer-throttling")
         # Prevent new tabs opened by Selenium from being blocked:
-        chrome_options.add_argument("--disable-popup-blocking")
+        # (Option might not be needed anymore. Removing for now.)
+        # chrome_options.add_argument("--disable-popup-blocking")
         # Skip remaining options that trigger anti-bot services
         return chrome_options
     chrome_options.add_argument("--log-level=3")

{seleniumbase-4.57.1 → seleniumbase-4.58.0}/seleniumbase/core/sb_cdp.py

@@ -257,12 +257,15 @@ class CDPMethods():
         that SeleniumBase methods can be called from Playwright
         without encountering event loop error messages such as:
         Cannot run the event loop while another loop is running.
+        Also fixes a NodeJS compatibility issue on old versions
+        of macOS when using Playwright versions 1.65.0 or newer.
         Also sets an environment variable to hide this warning:
         Deprecation: "url.parse() behavior is not standardized".
         (github.com/microsoft/playwright-python/issues/3016)"""
         from seleniumbase.core import nest_asyncio
         nest_asyncio.apply()
         os.environ["NODE_NO_WARNINGS"] = "1"
+        shared_utils.fix_playwright_node_compatibility()
         driver = self.driver
         if hasattr(driver, "cdp_base"):
             driver = driver.cdp_base
@@ -1249,6 +1252,19 @@ class CDPMethods():
         element.flash(0.30, "44CC88", x_offset, y_offset)
         time.sleep(0.30)
 
+    def highlight_if_visible(self, selector, scroll=True, timeout=0):
+        if self.is_element_visible(selector):
+            with suppress(Exception):
+                self.highlight(selector, scroll=scroll, timeout=1)
+        elif timeout == 0:
+            return
+        else:
+            with suppress(Exception):
+                self.find_element(selector, timeout=timeout)
+                self.sleep(0.1)
+                if self.is_element_visible(selector):
+                    self.highlight(selector, scroll=scroll, timeout=1)
+
     def focus(self, selector, timeout=None):
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
@@ -2463,8 +2479,8 @@ class CDPMethods():
         self.loop.run_until_complete(self.page.wait(0.05))
         if (
             self.is_element_visible(
-                'body > iframe[src*="/geo.captcha-delivery.com/captcha/"], '
-                'body > iframe[src*="/geo.captcha-delivery.com/interstitial/"]'
+                'iframe[src*="/geo.captcha-delivery.com/captcha/"], '
+                'iframe[src*="/geo.captcha-delivery.com/interstitial/"]'
             )
         ):
             return True
@@ -2551,8 +2567,8 @@ class CDPMethods():
 
     def __gui_slide_datadome_captcha(self):
         iframe = (
-            'body > iframe[src*="/geo.captcha-delivery.com/captcha/"], '
-            'body > iframe[src*="/geo.captcha-delivery.com/interstitial/"]'
+            'iframe[src*="/geo.captcha-delivery.com/captcha/"], '
+            'iframe[src*="/geo.captcha-delivery.com/interstitial/"]'
         )
         if not self.is_element_visible(iframe):
             return False