seleniumbase 4.54.8__tar.gz → 4.54.9__tar.gz

{seleniumbase-4.54.8/seleniumbase.egg-info → seleniumbase-4.54.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: seleniumbase
-Version: 4.54.8
+Version: 4.54.9
 Summary: SeleniumBase is a framework for web crawling, scraping, and testing. Supports pytest. CDP Mode adds stealth. Includes many tools.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz
@@ -67,7 +67,7 @@ Requires-Dist: certifi>=2026.7.22
 Requires-Dist: exceptiongroup>=1.3.1
 Requires-Dist: websockets~=16.1.1; python_version == "3.10"
 Requires-Dist: websockets>=16.1.1; python_version >= "3.11"
-Requires-Dist: filelock>=3.32.7
+Requires-Dist: filelock>=4.0.0
 Requires-Dist: fasteners>=0.20
 Requires-Dist: mycdp>=1.4.0
 Requires-Dist: pynose>=1.5.5
@@ -86,7 +86,7 @@ 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: idna>=3.19
+Requires-Dist: idna>=3.20
 Requires-Dist: charset-normalizer<4,>=3.5.1
 Requires-Dist: urllib3<3,>=2.8.0
 Requires-Dist: requests~=2.34.2
@@ -109,7 +109,7 @@ Requires-Dist: pytest-html==4.0.2
 Requires-Dist: pytest-metadata==3.1.1
 Requires-Dist: pytest-ordering==0.6
 Requires-Dist: pytest-rerunfailures==16.3; python_version == "3.10"
-Requires-Dist: pytest-rerunfailures==16.6.1; python_version >= "3.11"
+Requires-Dist: pytest-rerunfailures==16.7; python_version >= "3.11"
 Requires-Dist: pytest-xdist==3.8.0
 Requires-Dist: parameterized==0.9.0
 Requires-Dist: behave==1.2.6

{seleniumbase-4.54.8 → seleniumbase-4.54.9}/mcp_servers/server.py

@@ -652,6 +652,7 @@ def get_attributes(
 
     Args:
         selector: CSS selector or SeleniumBase-supported XPath selector.
+            If multiple elements match, then only the first one is used.
 
         attribute: Specific HTML attribute to retrieve. When omitted, returns
             all HTML attributes of the matching element as a dictionary.
@@ -1057,6 +1058,8 @@ def select_option(
 ) -> str:
     """Select an option from an HTML <select> dropdown.
 
+    Changing a dropdown selection can trigger additional events on a page.
+
     Args:
         dropdown_selector: CSS selector identifying the <select> element.
 
@@ -1445,8 +1448,11 @@ def manage_cookies(
     Notes:
         Loading saved cookies does not guarantee restoration of a login.
         Cookies may be expired, invalidated, domain/path restricted, or
-        dependent on other browser state. Navigate to the relevant site when
-        necessary so the browser has the appropriate origin for the cookies.
+        dependent on other browser state.
+
+    When not to use:
+        - Do not use this tool to load cookies if the cookie origin does
+          not match the origin of the current page.
     """
     sb = _get_sb()
 
@@ -1800,45 +1806,38 @@ def manage_tabs(
     annotations=ToolAnnotations(
         read_only_hint=False,
         destructive_hint=False,
-        idempotent_hint=False,  # A 2nd attempt on an already-handled or
-        # rotated CAPTCHA widget isn't guaranteed to be a no-op.
+        idempotent_hint=False,  # Re-attempting an already-handled or
+        # rotated CAPTCHA is not a no-op.
         open_world_hint=True,  # Interacts with a 3rd-party CAPTCHA widget.
     ),
 )
 @handle_sb_errors
 def solve_captcha() -> str:
-    """Perform a SeleniumBase CDP-based CAPTCHA interaction, such as clicking
-    a CAPTCHA checkbox, or performing a drag/drop action on a slider CAPTCHA.
+    """Attempts a SeleniumBase CDP interaction (click or drag/drop) to solve
+    detectable CAPTCHAs on the current page.
 
-    Supported CAPTCHAs include: Cloudflare Turnstile, reCAPTCHA, hCaptcha,
-    DataDome Slider, and FriendlyCaptcha.
+    Supported CAPTCHAs:
+    - CF Turnstile, reCAPTCHA, hCaptcha, DataDome Slider, FriendlyCaptcha
 
-    This tool automatically detects the location of CAPTCHA checkboxes
-    for the click action. If none of the supported CAPTCHAs are detected
-    on the current page, then no click action is attempted.
+    Tool workflow:
+    1. Inspect page structure (e.g., via `get_content`) to verify that a
+       CAPTCHA is present.
+    2. Call `solve_captcha` if there's a CAPTCHA. (No-op if no CAPTCHA.)
+    3. Verify success via `get_page_info`, `get_content`, or `manage_cookies`.
 
-    The tool does not guarantee that the CAPTCHA gets solved. Some CAPTCHA
-    controls are embedded inside shadow DOM or otherwise do not expose an
-    easy success signal. A successful attempt may result in changes to page
-    state or browser cookies.
+    Notes:
+        This tool does not guarantee that the CAPTCHA gets solved.
+        A successful attempt may result in changes to page state and cookies.
 
-    Tool workflow:
-        1. Inspect the webpage with get_content when you need to
-           determine whether CAPTCHA-related controls are present.
-        2. Call 'solve_captcha' to attempt the CAPTCHA interaction.
-        3. Use 'get_page_info', 'get_content', 'check_if_condition', or
-           'manage_cookies' to inspect the resulting page/session state
-           to determine whether the interaction appears to have succeeded.
+    Tool Selection:
+    - Use `solve_captcha` specifically for automated CAPTCHA widget
+      interactions.
+    - Use `click_element` for standard visible elements.
+    - Use `hover_action` (action="hover_and_click") to reveal and
+      click targets.
 
     Returns:
-        A message indicating that the CAPTCHA interaction was attempted.
-
-    Tool selection:
-        - Need to interact with one of the supported CAPTCHAs ->
-          use solve_captcha.
-        - Need to hover an element in order to click another ->
-          use hover_action with action="hover_and_click".
-        - Need to click a specific visible element -> use click_element.
+        A confirmation message indicating that the attempt was initiated.
     """
     sb = _get_sb()
     sb.solve_captcha()

{seleniumbase-4.54.8 → seleniumbase-4.54.9}/requirements.txt

@@ -7,7 +7,7 @@ certifi>=2026.7.22
 exceptiongroup>=1.3.1
 websockets~=16.1.1;python_version=="3.10"
 websockets>=16.1.1;python_version>="3.11"
-filelock>=3.32.7
+filelock>=4.0.0
 fasteners>=0.20
 mycdp>=1.4.0
 pynose>=1.5.5
@@ -26,7 +26,7 @@ pygments>=2.20.1
 pyreadline3>=3.5.4;platform_system=="Windows"
 tabcompleter>=1.4.1
 pdbp>=1.8.3
-idna>=3.19
+idna>=3.20
 charset-normalizer>=3.5.1,<4
 urllib3>=2.8.0,<3
 requests~=2.34.2
@@ -49,7 +49,7 @@ pytest-html==4.0.2
 pytest-metadata==3.1.1
 pytest-ordering==0.6
 pytest-rerunfailures==16.3;python_version=="3.10"
-pytest-rerunfailures==16.6.1;python_version>="3.11"
+pytest-rerunfailures==16.7;python_version>="3.11"
 pytest-xdist==3.8.0
 parameterized==0.9.0
 behave==1.2.6

{seleniumbase-4.54.8 → seleniumbase-4.54.9}/seleniumbase/__version__.py

@@ -1,2 +1,2 @@
 # seleniumbase package
-__version__ = "4.54.8"
+__version__ = "4.54.9"

{seleniumbase-4.54.8 → seleniumbase-4.54.9/seleniumbase.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: seleniumbase
-Version: 4.54.8
+Version: 4.54.9
 Summary: SeleniumBase is a framework for web crawling, scraping, and testing. Supports pytest. CDP Mode adds stealth. Includes many tools.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz
@@ -67,7 +67,7 @@ Requires-Dist: certifi>=2026.7.22
 Requires-Dist: exceptiongroup>=1.3.1
 Requires-Dist: websockets~=16.1.1; python_version == "3.10"
 Requires-Dist: websockets>=16.1.1; python_version >= "3.11"
-Requires-Dist: filelock>=3.32.7
+Requires-Dist: filelock>=4.0.0
 Requires-Dist: fasteners>=0.20
 Requires-Dist: mycdp>=1.4.0
 Requires-Dist: pynose>=1.5.5
@@ -86,7 +86,7 @@ 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: idna>=3.19
+Requires-Dist: idna>=3.20
 Requires-Dist: charset-normalizer<4,>=3.5.1
 Requires-Dist: urllib3<3,>=2.8.0
 Requires-Dist: requests~=2.34.2
@@ -109,7 +109,7 @@ Requires-Dist: pytest-html==4.0.2
 Requires-Dist: pytest-metadata==3.1.1
 Requires-Dist: pytest-ordering==0.6
 Requires-Dist: pytest-rerunfailures==16.3; python_version == "3.10"
-Requires-Dist: pytest-rerunfailures==16.6.1; python_version >= "3.11"
+Requires-Dist: pytest-rerunfailures==16.7; python_version >= "3.11"
 Requires-Dist: pytest-xdist==3.8.0
 Requires-Dist: parameterized==0.9.0
 Requires-Dist: behave==1.2.6

{seleniumbase-4.54.8 → seleniumbase-4.54.9}/seleniumbase.egg-info/requires.txt

@@ -5,7 +5,7 @@ wheel>=0.48.0
 attrs>=26.1.0
 certifi>=2026.7.22
 exceptiongroup>=1.3.1
-filelock>=3.32.7
+filelock>=4.0.0
 fasteners>=0.20
 mycdp>=1.4.0
 pynose>=1.5.5
@@ -23,7 +23,7 @@ pyyaml>=6.0.3
 pygments>=2.20.1
 tabcompleter>=1.4.1
 pdbp>=1.8.3
-idna>=3.19
+idna>=3.20
 charset-normalizer<4,>=3.5.1
 urllib3<3,>=2.8.0
 requests~=2.34.2
@@ -70,7 +70,7 @@ pytest-rerunfailures==16.3
 [:python_version >= "3.11"]
 websockets>=16.1.1
 pytest==9.1.1
-pytest-rerunfailures==16.6.1
+pytest-rerunfailures==16.7
 
 [allure]
 allure-pytest>=2.16.0

{seleniumbase-4.54.8 → seleniumbase-4.54.9}/setup.py

@@ -173,7 +173,7 @@ setup(
         'exceptiongroup>=1.3.1',
         'websockets~=16.1.1;python_version=="3.10"',
         'websockets>=16.1.1;python_version>="3.11"',
-        'filelock>=3.32.7',
+        'filelock>=4.0.0',
         'fasteners>=0.20',
         'mycdp>=1.4.0',
         'pynose>=1.5.5',
@@ -192,7 +192,7 @@ setup(
         'pyreadline3>=3.5.4;platform_system=="Windows"',
         'tabcompleter>=1.4.1',
         'pdbp>=1.8.3',
-        'idna>=3.19',
+        'idna>=3.20',
         'charset-normalizer>=3.5.1,<4',
         'urllib3>=2.8.0,<3',
         'requests~=2.34.2',
@@ -215,7 +215,7 @@ setup(
         'pytest-metadata==3.1.1',
         'pytest-ordering==0.6',
         'pytest-rerunfailures==16.3;python_version=="3.10"',
-        'pytest-rerunfailures==16.6.1;python_version>="3.11"',
+        'pytest-rerunfailures==16.7;python_version>="3.11"',
         'pytest-xdist==3.8.0',
         'parameterized==0.9.0',
         'behave==1.2.6',  # Newer ones had issues