wavexis 2.3.0__tar.gz → 2.3.1__tar.gz

{wavexis-2.3.0 → wavexis-2.3.1}/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to wavexis are documented in this file.
 
+## v2.3.1 — 2026-07-07
+
+### Added
+
+- `auto_wait: bool = True` parameter in `click`, `fill`, `hover` (both backends)
+- Pass `auto_wait=False` to skip element visibility polling for instant execution
+
 ## v2.3.0 — 2026-07-07
 
 ### Added

{wavexis-2.3.0 → wavexis-2.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wavexis
-Version: 2.3.0
+Version: 2.3.1
 Summary: Browser automation CLI — wraps cdpwave and bidiwave, no Node.js, no Chromium download
 Project-URL: Homepage, https://github.com/MathiasPaulenko/wavexis
 Project-URL: Repository, https://github.com/MathiasPaulenko/wavexis

{wavexis-2.3.0 → wavexis-2.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "wavexis"
-version = "2.3.0"
+version = "2.3.1"
 description = "Browser automation CLI — wraps cdpwave and bidiwave, no Node.js, no Chromium download"
 readme = "README.md"
 license = { text = "MIT" }

{wavexis-2.3.0 → wavexis-2.3.1}/tests/unit/test_auto_wait.py

@@ -68,6 +68,35 @@ class TestAutoWait:
         asyncio.run(backend.click("#btn"))
         assert call_order == ["wait", "scroll", "box"]
 
+    def test_cdp_click_auto_wait_false_skips_wait(self) -> None:
+        """Test that click with auto_wait=False skips _wait_for_element."""
+        from wavexis.backend.cdp import CDPBackend
+
+        backend = CDPBackend()
+        backend._session = MagicMock()
+        backend._session.input = MagicMock()
+        backend._session.input.dispatch_mouse_event = AsyncMock()
+
+        call_order: list[str] = []
+
+        async def _mock_wait(selector: str, timeout_ms: int = 30000) -> None:
+            call_order.append("wait")
+
+        async def _mock_scroll(selector: str) -> None:
+            call_order.append("scroll")
+
+        async def _mock_box(selector: str) -> tuple[float, float]:
+            call_order.append("box")
+            return 50.0, 25.0
+
+        backend._wait_for_element = _mock_wait  # type: ignore[assignment]
+        backend._scroll_into_view_if_needed = _mock_scroll  # type: ignore[assignment]
+        backend._get_box_center = _mock_box  # type: ignore[assignment]
+
+        asyncio.run(backend.click("#btn", auto_wait=False))
+        assert "wait" not in call_order
+        assert call_order == ["scroll", "box"]
+
     def test_bidi_wait_for_element_found(self) -> None:
         """Test BiDi _wait_for_element returns when element is visible."""
         from wavexis.backend.bidi import BiDiBackend

{wavexis-2.3.0 → wavexis-2.3.1}/wavexis/__init__.py

@@ -1,3 +1,3 @@
 """wavexis — CLI de automatización de navegador."""
 
-__version__ = "2.3.0"
+__version__ = "2.3.1"

{wavexis-2.3.0 → wavexis-2.3.1}/wavexis/backend/base.py

@@ -237,7 +237,11 @@ class AbstractBackend(ABC):
 
     @abstractmethod
     async def click(
-        self, selector: str, button: str = "left", click_count: int = 1
+        self,
+        selector: str,
+        button: str = "left",
+        click_count: int = 1,
+        auto_wait: bool = True,
     ) -> None:
         """Click an element matching a CSS selector."""
 
@@ -246,7 +250,9 @@ class AbstractBackend(ABC):
         """Type text into an element, optionally with delay between keystrokes."""
 
     @abstractmethod
-    async def fill(self, selector: str, value: str) -> None:
+    async def fill(
+        self, selector: str, value: str, auto_wait: bool = True
+    ) -> None:
         """Fill an input element with a value (replaces existing content)."""
 
     @abstractmethod
@@ -254,7 +260,7 @@ class AbstractBackend(ABC):
         """Select an option in a <select> element by value."""
 
     @abstractmethod
-    async def hover(self, selector: str) -> None:
+    async def hover(self, selector: str, auto_wait: bool = True) -> None:
         """Hover over an element matching a CSS selector."""
 
     @abstractmethod

{wavexis-2.3.0 → wavexis-2.3.1}/wavexis/backend/bidi.py

@@ -853,11 +853,23 @@ class BiDiBackend(AbstractBackend):
         await client.script.evaluate(self._context, js)
 
     async def click(
-        self, selector: str, button: str = "left", click_count: int = 1
+        self,
+        selector: str,
+        button: str = "left",
+        click_count: int = 1,
+        auto_wait: bool = True,
     ) -> None:
-        """Click an element via BiDi script.evaluate."""
+        """Click an element via BiDi script.evaluate.
+
+        Args:
+            selector: CSS selector for the target element.
+            button: Mouse button (unused in BiDi, for API compatibility).
+            click_count: Number of clicks to dispatch.
+            auto_wait: If True, wait for element to be visible before clicking.
+        """
         client = self._require_client()
-        await self._wait_for_element(selector)
+        if auto_wait:
+            await self._wait_for_element(selector)
         await self._scroll_into_view_if_needed(selector)
         escaped = selector.replace("'", "\\'")
         js = (
@@ -887,10 +899,19 @@ class BiDiBackend(AbstractBackend):
             if delay > 0:
                 await _asyncio.sleep(delay / 1000)
 
-    async def fill(self, selector: str, value: str) -> None:
-        """Fill an input element with a value via BiDi."""
+    async def fill(
+        self, selector: str, value: str, auto_wait: bool = True
+    ) -> None:
+        """Fill an input element with a value via BiDi.
+
+        Args:
+            selector: CSS selector for the target element.
+            value: Value to set in the input field.
+            auto_wait: If True, wait for element to be visible before filling.
+        """
         client = self._require_client()
-        await self._wait_for_element(selector)
+        if auto_wait:
+            await self._wait_for_element(selector)
         await self._scroll_into_view_if_needed(selector)
         escaped = selector.replace("'", "\\'")
         escaped_val = value.replace("\\", "\\\\").replace("'", "\\'")
@@ -906,10 +927,16 @@ class BiDiBackend(AbstractBackend):
         js = f"document.querySelector('{escaped}').value = '{escaped_val}'"
         await self._client.script.evaluate(self._context, js)
 
-    async def hover(self, selector: str) -> None:
-        """Hover over an element via BiDi script.evaluate."""
+    async def hover(self, selector: str, auto_wait: bool = True) -> None:
+        """Hover over an element via BiDi script.evaluate.
+
+        Args:
+            selector: CSS selector for the target element.
+            auto_wait: If True, wait for element to be visible before hovering.
+        """
         client = self._require_client()
-        await self._wait_for_element(selector)
+        if auto_wait:
+            await self._wait_for_element(selector)
         await self._scroll_into_view_if_needed(selector)
         escaped = selector.replace("'", "\\'")
         js = (

{wavexis-2.3.0 → wavexis-2.3.1}/wavexis/backend/cdp.py

@@ -1072,7 +1072,11 @@ class CDPBackend(AbstractBackend):
         await session.runtime.evaluate(js)
 
     async def click(
-        self, selector: str, button: str = "left", click_count: int = 1
+        self,
+        selector: str,
+        button: str = "left",
+        click_count: int = 1,
+        auto_wait: bool = True,
     ) -> None:
         """Click an element matching a CSS selector.
 
@@ -1080,9 +1084,11 @@ class CDPBackend(AbstractBackend):
             selector: CSS selector for the target element.
             button: Mouse button — "left", "right", or "middle".
             click_count: Number of clicks to dispatch.
+            auto_wait: If True, wait for element to be visible before clicking.
         """
         session = self._require_session()
-        await self._wait_for_element(selector)
+        if auto_wait:
+            await self._wait_for_element(selector)
         await self._scroll_into_view_if_needed(selector)
         x, y = await self._get_box_center(selector)
         btn_map = {"left": "left", "right": "right", "middle": "middle"}
@@ -1113,15 +1119,19 @@ class CDPBackend(AbstractBackend):
             if delay > 0:
                 await asyncio.sleep(delay / 1000)
 
-    async def fill(self, selector: str, value: str) -> None:
+    async def fill(
+        self, selector: str, value: str, auto_wait: bool = True
+    ) -> None:
         """Fill an input element with a value (replaces existing content).
 
         Args:
             selector: CSS selector for the target element.
             value: Value to set in the input field.
+            auto_wait: If True, wait for element to be visible before filling.
         """
         session = self._require_session()
-        await self._wait_for_element(selector)
+        if auto_wait:
+            await self._wait_for_element(selector)
         await self._scroll_into_view_if_needed(selector)
         escaped = selector.replace("'", "\\'")
         js = (
@@ -1155,14 +1165,16 @@ class CDPBackend(AbstractBackend):
         if not result.get("result", {}).get("value"):
             raise ElementNotFoundError(selector)
 
-    async def hover(self, selector: str) -> None:
+    async def hover(self, selector: str, auto_wait: bool = True) -> None:
         """Hover over an element matching a CSS selector.
 
         Args:
             selector: CSS selector for the target element.
+            auto_wait: If True, wait for element to be visible before hovering.
         """
         session = self._require_session()
-        await self._wait_for_element(selector)
+        if auto_wait:
+            await self._wait_for_element(selector)
         await self._scroll_into_view_if_needed(selector)
         x, y = await self._get_box_center(selector)
         await session.input.dispatch_mouse_event(