seleniumbase 4.49.0__tar.gz → 4.49.1__tar.gz

{seleniumbase-4.49.0/seleniumbase.egg-info → seleniumbase-4.49.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: seleniumbase
-Version: 4.49.0
-Summary: Stealthy automation (via CDP Mode) that passes every bot detection test with any Chromium browser you want. Includes a test framework.
+Version: 4.49.1
+Summary: A framework for stealthy Chromium automation with CDP Mode. Includes CAPTCHA-bypass, E2E Testing, and a Playwright integration.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz
 Author-email: mdmintz@gmail.com
@@ -16,7 +16,7 @@ Project-URL: PyPI, https://pypi.org/project/seleniumbase/
 Project-URL: Source, https://github.com/seleniumbase/SeleniumBase
 Project-URL: Repository, https://github.com/seleniumbase/SeleniumBase
 Project-URL: Documentation, https://seleniumbase.io/
-Keywords: pytest,selenium,framework,automation,browser,testing,webdriver,seleniumbase,sbase,web-crawling,web-scraping,scraping,stealth,chromium,playwright,anti-detect,antidetect,undetected,bot-detection,fingerprint,recaptcha,cloudflare,turnstile,datadome,captcha,headless
+Keywords: pytest,selenium,framework,automation,browser,testing,webdriver,seleniumbase,sbase,web-crawling,web-scraping,stealth,chromium,playwright,undetected,bot-detection,fingerprint,recaptcha,cloudflare,turnstile,datadome,captcha,headless
 Platform: Windows
 Platform: Linux
 Platform: Mac OS-X
@@ -84,6 +84,7 @@ Requires-Dist: six>=1.17.0
 Requires-Dist: parse>=1.22.0
 Requires-Dist: parse-type>=0.6.6
 Requires-Dist: colorama>=0.4.6
+Requires-Dist: psutil>=7.2.2
 Requires-Dist: pyyaml>=6.0.3
 Requires-Dist: pygments>=2.20.0
 Requires-Dist: pyreadline3>=3.5.4; platform_system == "Windows"
@@ -166,9 +167,7 @@ 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.58.0; extra == "playwright"
-Provides-Extra: psutil
-Requires-Dist: psutil>=7.2.2; extra == "psutil"
+Requires-Dist: playwright>=1.60.0; extra == "playwright"
 Provides-Extra: pyautogui
 Requires-Dist: PyAutoGUI>=0.9.54; platform_system != "Linux" and extra == "pyautogui"
 Provides-Extra: selenium-stealth
@@ -208,19 +207,12 @@ 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>SeleniumBase</h1>
-
 <p align="center"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/nice_logo_8t.png" alt="SeleniumBase" width="424" /></a></p>
 
 <p align="center"><a href="https://pypi.python.org/pypi/seleniumbase" target="_blank"><img src="https://img.shields.io/pypi/v/seleniumbase.svg?color=3399EE" alt="PyPI version" /></a> <a href="https://pepy.tech/projects/seleniumbase?timeRange=threeMonths&category=version&includeCIDownloads=true&granularity=daily&viewType=line&versions=*" target="_blank"><img src="https://static.pepy.tech/badge/seleniumbase" alt="SeleniumBase PyPI downloads" /></a> <a href="https://discord.gg/EdhQTn3EyE" target="_blank"><img src="https://img.shields.io/discord/727927627830001734?color=7289DA&label=Discord&logo=discord&logoColor=white"/></a><br /> <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-22BBCC.svg" title="SeleniumBase" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/actions" target="_blank"><img src="https://github.com/seleniumbase/SeleniumBase/workflows/CI%20build/badge.svg" alt="SeleniumBase GitHub Actions" /></a> <a href="https://seleniumbase.io"><img src="https://img.shields.io/badge/docs-seleniumbase.io-11BBAA.svg" alt="SeleniumBase Docs" /></a></p>
 <p align="center"></p>
 
-<h3 align="center">Stealthy automation that passes every bot detection test.</h3>
-
-<table align="center"><tr><td>
-<b>Verified using multiple different Chromium browsers:<br />Chrome, Chrome-for-Testing, Chromium, Edge, Brave.</b>
-</td></tr></table>
-
+<h3 align="center">Stealthy Chromium Automation and E2E Testing.</h3>
 
 <p align="center">
 <a href="#python_installation">🚀 Start</a> |
@@ -240,7 +232,7 @@ Dynamic: summary
 <a href="https://seleniumbase.io/demo_page">📰 TestPage</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>  |
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/chart_maker/ReadMe.md">📶 Charts</a> |
 <a href="https://seleniumbase.io/devices/?url=seleniumbase.com">🖥️ Farm</a>
 <br />
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/how_it_works.md">👁️ How</a> |
@@ -260,9 +252,11 @@ Dynamic: summary
 
 🐙 <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 handles CAPTCHAs by driving the browser directly through the <a href="https://chromedevtools.github.io/devtools-protocol/" translate="no">Chrome DevTools Protocol</a>. Includes <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/ReadMe.md"><b><span translate="no">Stealthy Playwright Mode</span></b></a>, which extends these advanced anti-detection patches to Playwright scripts.
 
-📚 The [SeleniumBase/examples/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples) folder includes over 100 ready-to-run examples. Examples that start with `test_` or end with `_test.py`/`_tests.py` are specifically designed to run with `pytest`. Other examples run directly with raw `python` (those files generally start with `raw_` to avoid confusion).
+📚 The [SeleniumBase/examples/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples) folder includes over 100 ready-to-run examples of E2E testing. Examples that start with `test_` or end with `_test.py`/`_tests.py` are specifically designed to run with `pytest`. Other examples run directly with raw `python` (those files generally start with `raw_` to avoid confusion).
+
+🥷 Stealthy CDP Mode examples are located in [./examples/cdp_mode/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples/cdp_mode).
 
-🥷 Stealthy examples are located in [SeleniumBase/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/).
 
 --------
 
@@ -283,13 +277,13 @@ url = "https://www.browserscan.net/bot-detection"
 sb = sb_cdp.Chrome(url, locale="en", ad_block=True)
 sb.flash("Test Results", duration=3, pause=1)
 sb.assert_element('strong:contains("Normal")')
-print("Bot Not detected")
+print("Bot Not Detected")
 sb.flash('strong:contains("Normal")', duration=3, pause=2)
 ```
 
 <img src="https://seleniumbase.github.io/other/b_scan_results.jpg" width="628" alt="Stealthy architecture flowchart" />
 
-📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/raw_browserscan_sync.py">This</a> also works as a drop-in replacement for Playwright (making it stealthy):
+📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/raw_browserscan_sync.py">This example</a> demonstrates the drop-in patch that makes Playwright stealthy:
 
 ```python
 from playwright.sync_api import sync_playwright
@@ -310,7 +304,7 @@ with sync_playwright() as p:
 
 --------
 
-For choosing which Chromium browser to use, you can set command-line options:
+💡 You can set which Chromium browser to use via command-line options:
 
 ```zsh
 python SCRIPT.py --use-chromium  # Use the unbranded Chromium browser
@@ -319,7 +313,13 @@ python SCRIPT.py --edge  # Use Microsoft Edge
 python SCRIPT.py --brave  # Use Brave browser
 ```
 
-(Google Chrome is the default browser if not specified.)
+Google Chrome is the default browser if not specified. Only unbranded Chromium and Chrome-for-Testing are installed automatically if not already installed.
+
+You can also set the browser via method args, eg: `cft=True`, `use_chromium=True`, `browser="edge"`, `browser="brave"`, etc. Eg:
+
+```python
+sb = sb_cdp.Chrome(url, use_chromium=True)
+```
 
 --------
 

{seleniumbase-4.49.0 → seleniumbase-4.49.1}/README.md

@@ -7,19 +7,12 @@
 <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>SeleniumBase</h1>
-
 <p align="center"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/nice_logo_8t.png" alt="SeleniumBase" width="424" /></a></p>
 
 <p align="center"><a href="https://pypi.python.org/pypi/seleniumbase" target="_blank"><img src="https://img.shields.io/pypi/v/seleniumbase.svg?color=3399EE" alt="PyPI version" /></a> <a href="https://pepy.tech/projects/seleniumbase?timeRange=threeMonths&category=version&includeCIDownloads=true&granularity=daily&viewType=line&versions=*" target="_blank"><img src="https://static.pepy.tech/badge/seleniumbase" alt="SeleniumBase PyPI downloads" /></a> <a href="https://discord.gg/EdhQTn3EyE" target="_blank"><img src="https://img.shields.io/discord/727927627830001734?color=7289DA&label=Discord&logo=discord&logoColor=white"/></a><br /> <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-22BBCC.svg" title="SeleniumBase" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/actions" target="_blank"><img src="https://github.com/seleniumbase/SeleniumBase/workflows/CI%20build/badge.svg" alt="SeleniumBase GitHub Actions" /></a> <a href="https://seleniumbase.io"><img src="https://img.shields.io/badge/docs-seleniumbase.io-11BBAA.svg" alt="SeleniumBase Docs" /></a></p>
 <p align="center"></p>
 
-<h3 align="center">Stealthy automation that passes every bot detection test.</h3>
-
-<table align="center"><tr><td>
-<b>Verified using multiple different Chromium browsers:<br />Chrome, Chrome-for-Testing, Chromium, Edge, Brave.</b>
-</td></tr></table>
-
+<h3 align="center">Stealthy Chromium Automation and E2E Testing.</h3>
 
 <p align="center">
 <a href="#python_installation">🚀 Start</a> |
@@ -39,7 +32,7 @@
 <a href="https://seleniumbase.io/demo_page">📰 TestPage</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>  |
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/chart_maker/ReadMe.md">📶 Charts</a> |
 <a href="https://seleniumbase.io/devices/?url=seleniumbase.com">🖥️ Farm</a>
 <br />
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/how_it_works.md">👁️ How</a> |
@@ -59,9 +52,11 @@
 
 🐙 <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 handles CAPTCHAs by driving the browser directly through the <a href="https://chromedevtools.github.io/devtools-protocol/" translate="no">Chrome DevTools Protocol</a>. Includes <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/ReadMe.md"><b><span translate="no">Stealthy Playwright Mode</span></b></a>, which extends these advanced anti-detection patches to Playwright scripts.
 
-📚 The [SeleniumBase/examples/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples) folder includes over 100 ready-to-run examples. Examples that start with `test_` or end with `_test.py`/`_tests.py` are specifically designed to run with `pytest`. Other examples run directly with raw `python` (those files generally start with `raw_` to avoid confusion).
+📚 The [SeleniumBase/examples/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples) folder includes over 100 ready-to-run examples of E2E testing. Examples that start with `test_` or end with `_test.py`/`_tests.py` are specifically designed to run with `pytest`. Other examples run directly with raw `python` (those files generally start with `raw_` to avoid confusion).
+
+🥷 Stealthy CDP Mode examples are located in [./examples/cdp_mode/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples/cdp_mode).
 
-🥷 Stealthy examples are located in [SeleniumBase/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/).
 
 --------
 
@@ -82,13 +77,13 @@ url = "https://www.browserscan.net/bot-detection"
 sb = sb_cdp.Chrome(url, locale="en", ad_block=True)
 sb.flash("Test Results", duration=3, pause=1)
 sb.assert_element('strong:contains("Normal")')
-print("Bot Not detected")
+print("Bot Not Detected")
 sb.flash('strong:contains("Normal")', duration=3, pause=2)
 ```
 
 <img src="https://seleniumbase.github.io/other/b_scan_results.jpg" width="628" alt="Stealthy architecture flowchart" />
 
-📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/raw_browserscan_sync.py">This</a> also works as a drop-in replacement for Playwright (making it stealthy):
+📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/raw_browserscan_sync.py">This example</a> demonstrates the drop-in patch that makes Playwright stealthy:
 
 ```python
 from playwright.sync_api import sync_playwright
@@ -109,7 +104,7 @@ with sync_playwright() as p:
 
 --------
 
-For choosing which Chromium browser to use, you can set command-line options:
+💡 You can set which Chromium browser to use via command-line options:
 
 ```zsh
 python SCRIPT.py --use-chromium  # Use the unbranded Chromium browser
@@ -118,7 +113,13 @@ python SCRIPT.py --edge  # Use Microsoft Edge
 python SCRIPT.py --brave  # Use Brave browser
 ```
 
-(Google Chrome is the default browser if not specified.)
+Google Chrome is the default browser if not specified. Only unbranded Chromium and Chrome-for-Testing are installed automatically if not already installed.
+
+You can also set the browser via method args, eg: `cft=True`, `use_chromium=True`, `browser="edge"`, `browser="brave"`, etc. Eg:
+
+```python
+sb = sb_cdp.Chrome(url, use_chromium=True)
+```
 
 --------
 

{seleniumbase-4.49.0 → seleniumbase-4.49.1}/requirements.txt

@@ -24,6 +24,7 @@ six>=1.17.0
 parse>=1.22.0
 parse-type>=0.6.6
 colorama>=0.4.6
+psutil>=7.2.2
 pyyaml>=6.0.3
 pygments>=2.20.0
 pyreadline3>=3.5.4;platform_system=="Windows"

{seleniumbase-4.49.0 → seleniumbase-4.49.1}/seleniumbase/__version__.py

@@ -1,2 +1,2 @@
 # seleniumbase package
-__version__ = "4.49.0"
+__version__ = "4.49.1"

{seleniumbase-4.49.0 → seleniumbase-4.49.1}/seleniumbase/undetected/__init__.py

@@ -1,6 +1,7 @@
 import logging
 import os
 import re
+import psutil
 import requests
 import subprocess
 import sys
@@ -299,6 +300,13 @@ class Chrome(selenium.webdriver.chrome.webdriver.WebDriver):
                         creationflags=creationflags,
                     )
                     self.browser_pid = browser.pid
+            self._process_pid = browser.pid
+            try:
+                self._process_create_time = (
+                    psutil.Process(self._process_pid).create_time()
+                )
+            except psutil.NoSuchProcess:
+                self._process_create_time = None
             service_ = None
             log_output = subprocess.PIPE
             if patch_driver:
@@ -392,6 +400,22 @@ class Chrome(selenium.webdriver.chrome.webdriver.WebDriver):
             },
         )
 
+    def is_running(self):
+        """Check if the browser is still running."""
+        if not getattr(self, "_process_pid", None):
+            return False
+        # Not good enough: return psutil.pid_exists(self._process_pid)
+        try:
+            process = psutil.Process(self._process_pid)
+            # Check for PID recycling: Is this actually our process?
+            if hasattr(self, "_process_create_time"):
+                if process.create_time() != self._process_create_time:
+                    return False  # The PID was reused by a different process!
+            # If the process is a zombie, assume the browser isn't running
+            return process.status() != psutil.STATUS_ZOMBIE
+        except psutil.NoSuchProcess:
+            return False
+
     def remove_cdc_props_as_needed(self):
         cdc_props = self._get_cdc_props()
         if len(cdc_props) > 0:

{seleniumbase-4.49.0 → seleniumbase-4.49.1}/seleniumbase/undetected/cdp_driver/browser.py

@@ -9,6 +9,7 @@ import logging
 import os
 import pathlib
 import pickle
+import psutil
 import re
 import shutil
 import time
@@ -263,6 +264,22 @@ class Browser:
             )
             self.targets.remove(current_tab)
 
+    def is_running(self):
+        """Check if the browser is still running."""
+        if not getattr(self, "_process_pid", None):
+            return False
+        # Not good enough: return psutil.pid_exists(self._process_pid)
+        try:
+            process = psutil.Process(self._process_pid)
+            # Check for PID recycling: Is this actually our process?
+            if hasattr(self, "_process_create_time"):
+                if process.create_time() != self._process_create_time:
+                    return False  # The PID was reused by a different process!
+            # If the process is a zombie, assume the browser isn't running
+            return process.status() != psutil.STATUS_ZOMBIE
+        except psutil.NoSuchProcess:
+            return False
+
     def get_rd_host(self):
         return self.config.host
 
@@ -617,6 +634,12 @@ class Browser:
             )
             await asyncio.sleep(0.05)
             self._process_pid = self._process.pid
+            try:
+                self._process_create_time = (
+                    psutil.Process(self._process_pid).create_time()
+                )
+            except psutil.NoSuchProcess:
+                self._process_create_time = None
         await asyncio.sleep(0.05)
         self._http = HTTPApi((self.config.host, self.config.port))
         await asyncio.sleep(0.05)

{seleniumbase-4.49.0 → seleniumbase-4.49.1/seleniumbase.egg-info}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: seleniumbase
-Version: 4.49.0
-Summary: Stealthy automation (via CDP Mode) that passes every bot detection test with any Chromium browser you want. Includes a test framework.
+Version: 4.49.1
+Summary: A framework for stealthy Chromium automation with CDP Mode. Includes CAPTCHA-bypass, E2E Testing, and a Playwright integration.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz
 Author-email: mdmintz@gmail.com
@@ -16,7 +16,7 @@ Project-URL: PyPI, https://pypi.org/project/seleniumbase/
 Project-URL: Source, https://github.com/seleniumbase/SeleniumBase
 Project-URL: Repository, https://github.com/seleniumbase/SeleniumBase
 Project-URL: Documentation, https://seleniumbase.io/
-Keywords: pytest,selenium,framework,automation,browser,testing,webdriver,seleniumbase,sbase,web-crawling,web-scraping,scraping,stealth,chromium,playwright,anti-detect,antidetect,undetected,bot-detection,fingerprint,recaptcha,cloudflare,turnstile,datadome,captcha,headless
+Keywords: pytest,selenium,framework,automation,browser,testing,webdriver,seleniumbase,sbase,web-crawling,web-scraping,stealth,chromium,playwright,undetected,bot-detection,fingerprint,recaptcha,cloudflare,turnstile,datadome,captcha,headless
 Platform: Windows
 Platform: Linux
 Platform: Mac OS-X
@@ -84,6 +84,7 @@ Requires-Dist: six>=1.17.0
 Requires-Dist: parse>=1.22.0
 Requires-Dist: parse-type>=0.6.6
 Requires-Dist: colorama>=0.4.6
+Requires-Dist: psutil>=7.2.2
 Requires-Dist: pyyaml>=6.0.3
 Requires-Dist: pygments>=2.20.0
 Requires-Dist: pyreadline3>=3.5.4; platform_system == "Windows"
@@ -166,9 +167,7 @@ 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.58.0; extra == "playwright"
-Provides-Extra: psutil
-Requires-Dist: psutil>=7.2.2; extra == "psutil"
+Requires-Dist: playwright>=1.60.0; extra == "playwright"
 Provides-Extra: pyautogui
 Requires-Dist: PyAutoGUI>=0.9.54; platform_system != "Linux" and extra == "pyautogui"
 Provides-Extra: selenium-stealth
@@ -208,19 +207,12 @@ 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>SeleniumBase</h1>
-
 <p align="center"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/nice_logo_8t.png" alt="SeleniumBase" width="424" /></a></p>
 
 <p align="center"><a href="https://pypi.python.org/pypi/seleniumbase" target="_blank"><img src="https://img.shields.io/pypi/v/seleniumbase.svg?color=3399EE" alt="PyPI version" /></a> <a href="https://pepy.tech/projects/seleniumbase?timeRange=threeMonths&category=version&includeCIDownloads=true&granularity=daily&viewType=line&versions=*" target="_blank"><img src="https://static.pepy.tech/badge/seleniumbase" alt="SeleniumBase PyPI downloads" /></a> <a href="https://discord.gg/EdhQTn3EyE" target="_blank"><img src="https://img.shields.io/discord/727927627830001734?color=7289DA&label=Discord&logo=discord&logoColor=white"/></a><br /> <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-22BBCC.svg" title="SeleniumBase" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/actions" target="_blank"><img src="https://github.com/seleniumbase/SeleniumBase/workflows/CI%20build/badge.svg" alt="SeleniumBase GitHub Actions" /></a> <a href="https://seleniumbase.io"><img src="https://img.shields.io/badge/docs-seleniumbase.io-11BBAA.svg" alt="SeleniumBase Docs" /></a></p>
 <p align="center"></p>
 
-<h3 align="center">Stealthy automation that passes every bot detection test.</h3>
-
-<table align="center"><tr><td>
-<b>Verified using multiple different Chromium browsers:<br />Chrome, Chrome-for-Testing, Chromium, Edge, Brave.</b>
-</td></tr></table>
-
+<h3 align="center">Stealthy Chromium Automation and E2E Testing.</h3>
 
 <p align="center">
 <a href="#python_installation">🚀 Start</a> |
@@ -240,7 +232,7 @@ Dynamic: summary
 <a href="https://seleniumbase.io/demo_page">📰 TestPage</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>  |
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/chart_maker/ReadMe.md">📶 Charts</a> |
 <a href="https://seleniumbase.io/devices/?url=seleniumbase.com">🖥️ Farm</a>
 <br />
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/how_it_works.md">👁️ How</a> |
@@ -260,9 +252,11 @@ Dynamic: summary
 
 🐙 <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 handles CAPTCHAs by driving the browser directly through the <a href="https://chromedevtools.github.io/devtools-protocol/" translate="no">Chrome DevTools Protocol</a>. Includes <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/ReadMe.md"><b><span translate="no">Stealthy Playwright Mode</span></b></a>, which extends these advanced anti-detection patches to Playwright scripts.
 
-📚 The [SeleniumBase/examples/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples) folder includes over 100 ready-to-run examples. Examples that start with `test_` or end with `_test.py`/`_tests.py` are specifically designed to run with `pytest`. Other examples run directly with raw `python` (those files generally start with `raw_` to avoid confusion).
+📚 The [SeleniumBase/examples/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples) folder includes over 100 ready-to-run examples of E2E testing. Examples that start with `test_` or end with `_test.py`/`_tests.py` are specifically designed to run with `pytest`. Other examples run directly with raw `python` (those files generally start with `raw_` to avoid confusion).
+
+🥷 Stealthy CDP Mode examples are located in [./examples/cdp_mode/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples/cdp_mode).
 
-🥷 Stealthy examples are located in [SeleniumBase/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/).
 
 --------
 
@@ -283,13 +277,13 @@ url = "https://www.browserscan.net/bot-detection"
 sb = sb_cdp.Chrome(url, locale="en", ad_block=True)
 sb.flash("Test Results", duration=3, pause=1)
 sb.assert_element('strong:contains("Normal")')
-print("Bot Not detected")
+print("Bot Not Detected")
 sb.flash('strong:contains("Normal")', duration=3, pause=2)
 ```
 
 <img src="https://seleniumbase.github.io/other/b_scan_results.jpg" width="628" alt="Stealthy architecture flowchart" />
 
-📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/raw_browserscan_sync.py">This</a> also works as a drop-in replacement for Playwright (making it stealthy):
+📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/raw_browserscan_sync.py">This example</a> demonstrates the drop-in patch that makes Playwright stealthy:
 
 ```python
 from playwright.sync_api import sync_playwright
@@ -310,7 +304,7 @@ with sync_playwright() as p:
 
 --------
 
-For choosing which Chromium browser to use, you can set command-line options:
+💡 You can set which Chromium browser to use via command-line options:
 
 ```zsh
 python SCRIPT.py --use-chromium  # Use the unbranded Chromium browser
@@ -319,7 +313,13 @@ python SCRIPT.py --edge  # Use Microsoft Edge
 python SCRIPT.py --brave  # Use Brave browser
 ```
 
-(Google Chrome is the default browser if not specified.)
+Google Chrome is the default browser if not specified. Only unbranded Chromium and Chrome-for-Testing are installed automatically if not already installed.
+
+You can also set the browser via method args, eg: `cft=True`, `use_chromium=True`, `browser="edge"`, `browser="brave"`, etc. Eg:
+
+```python
+sb = sb_cdp.Chrome(url, use_chromium=True)
+```
 
 --------
 

{seleniumbase-4.49.0 → seleniumbase-4.49.1}/seleniumbase.egg-info/requires.txt

@@ -14,6 +14,7 @@ six>=1.17.0
 parse>=1.22.0
 parse-type>=0.6.6
 colorama>=0.4.6
+psutil>=7.2.2
 pyyaml>=6.0.3
 pygments>=2.20.0
 tabcompleter>=1.4.1
@@ -139,14 +140,11 @@ Pillow>=12.2.0
 pip-system-certs==4.0
 
 [playwright]
-playwright>=1.58.0
+playwright>=1.60.0
 
 [proxy]
 proxy.py==2.4.3
 
-[psutil]
-psutil>=7.2.2
-
 [pyautogui]
 
 [pyautogui:platform_system != "Linux"]

{seleniumbase-4.49.0 → seleniumbase-4.49.1}/setup.py

@@ -75,8 +75,8 @@ setup(
     name="seleniumbase",
     version=about["__version__"],
     description=(
-        "Stealthy automation (via CDP Mode) that passes every bot detection "
-        "test with any Chromium browser you want. Includes a test framework."
+        "A framework for stealthy Chromium automation with CDP Mode. "
+        "Includes CAPTCHA-bypass, E2E Testing, and a Playwright integration."
     ),
     long_description=long_description,
     long_description_content_type="text/markdown",
@@ -109,12 +109,9 @@ setup(
         "sbase",
         "web-crawling",
         "web-scraping",
-        "scraping",
         "stealth",
         "chromium",
         "playwright",
-        "anti-detect",
-        "antidetect",
         "undetected",
         "bot-detection",
         "fingerprint",
@@ -185,11 +182,12 @@ setup(
         'typing-extensions>=4.15.0',
         'sbvirtualdisplay>=1.4.0',
         'MarkupSafe>=3.0.3',
-        "Jinja2>=3.1.6",
-        "six>=1.17.0",
+        'Jinja2>=3.1.6',
+        'six>=1.17.0',
         'parse>=1.22.0',
         'parse-type>=0.6.6',
         'colorama>=0.4.6',
+        'psutil>=7.2.2',
         'pyyaml>=6.0.3',
         'pygments>=2.20.0',
         'pyreadline3>=3.5.4;platform_system=="Windows"',
@@ -306,11 +304,7 @@ setup(
         # pip install -e .[playwright]
         # (For the Playwright integration.)
         "playwright": [
-            "playwright>=1.58.0",
-        ],
-        # pip install -e .[psutil]
-        "psutil": [
-            "psutil>=7.2.2",
+            "playwright>=1.60.0",
         ],
         # pip install -e .[pyautogui]
         # (Already a required dependency on Linux now.)