wavexis 2.2.0__tar.gz → 2.2.2__tar.gz

{wavexis-2.2.0 → wavexis-2.2.2}/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to wavexis are documented in this file.
 
+## v2.2.2 — 2026-07-07
+
+### Added
+
+- Auto scroll-into-view before `click`, `fill`, and `hover` in both CDP and BiDi backends
+- `_scroll_into_view_if_needed` helper checks if element is in viewport and scrolls if needed
+
+## v2.2.1 — 2026-07-07
+
+### Added
+
+- `--browser-url` global flag to connect to an existing browser (e.g. `--browser-url ws://localhost:9222`)
+- `browser_url` field in `BrowserOptions` dataclass
+- `browser_url` support in `config.yml` (`browser_url: ws://localhost:9222`)
+- `CDPBackend.launch()` now uses `CDPClient.connect()` when `browser_url` is set instead of launching a new browser
+
 ## v2.2.0 — 2026-07-07
 
 ### Added

{wavexis-2.2.0 → wavexis-2.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wavexis
-Version: 2.2.0
+Version: 2.2.2
 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.2.0 → wavexis-2.2.2}/pyproject.toml

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

{wavexis-2.2.0 → wavexis-2.2.2}/tests/unit/test_global_options.py

@@ -31,6 +31,11 @@ class TestBrowserOptions:
         assert opts.proxy is None
         assert opts.timeout == 30000
         assert opts.user_data_dir is None
+        assert opts.browser_url is None
+
+    def test_with_browser_url(self) -> None:
+        opts = BrowserOptions(browser_url="ws://localhost:9222")
+        assert opts.browser_url == "ws://localhost:9222"
 
     def test_with_user_data_dir(self) -> None:
         opts = BrowserOptions(user_data_dir="/tmp/wavexis-profile")
@@ -63,6 +68,13 @@ class TestBrowserOptionsHelper:
         assert opts.timeout == 30000
         assert opts.proxy is None
         assert opts.user_data_dir is None
+        assert opts.browser_url is None
+
+    def test_browser_url_options(self) -> None:
+        ctx = _fresh_ctx()
+        ctx.browser_url = "ws://localhost:9222"
+        opts = _cli._browser_options()
+        assert opts.browser_url == "ws://localhost:9222"
 
     def test_user_data_dir_options(self) -> None:
         ctx = _fresh_ctx()
@@ -101,6 +113,7 @@ class TestLoadGlobalConfig:
         assert ctx.timeout == 30000
         assert ctx.proxy is None
         assert ctx.user_data_dir is None
+        assert ctx.browser_url is None
 
     def test_loads_config(self, tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
         config_dir = tmp_path / ".wavexis"
@@ -111,7 +124,8 @@ class TestLoadGlobalConfig:
             "headless: false\n"
             "timeout: 60000\n"
             "proxy: http://proxy:9090\n"
-            "user_data_dir: /tmp/profile\n",
+            "user_data_dir: /tmp/profile\n"
+            "browser_url: ws://localhost:9222\n",
             encoding="utf-8",
         )
         monkeypatch.setattr(Path, "home", lambda: tmp_path)
@@ -124,6 +138,7 @@ class TestLoadGlobalConfig:
         assert ctx.timeout == 60000
         assert ctx.proxy == "http://proxy:9090"
         assert ctx.user_data_dir == "/tmp/profile"
+        assert ctx.browser_url == "ws://localhost:9222"
 
     def test_cli_overrides_config(
         self, tmp_path: Path, monkeypatch: pytest.MonkeyPatch

{wavexis-2.2.0 → wavexis-2.2.2}/wavexis/__init__.py

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

{wavexis-2.2.0 → wavexis-2.2.2}/wavexis/backend/bidi.py

@@ -807,19 +807,32 @@ class BiDiBackend(AbstractBackend):
 
     # ── Input ──────────────────────────────────────────────
 
+    async def _scroll_into_view_if_needed(self, selector: str) -> None:
+        """Scroll element into view if it's not visible in the viewport."""
+        client = self._require_client()
+        escaped = selector.replace("'", "\\'")
+        js = (
+            f"(function(){{var el=document.querySelector('{escaped}');"
+            f"if(!el)return;var rect=el.getBoundingClientRect();"
+            f"if(rect.top<0||rect.bottom>window.innerHeight||"
+            f"rect.left<0||rect.right>window.innerWidth)"
+            f"el.scrollIntoView({{block:'center',behavior:'instant'}});}})()"
+        )
+        await client.script.evaluate(self._context, js)
+
     async def click(
         self, selector: str, button: str = "left", click_count: int = 1
     ) -> None:
         """Click an element via BiDi script.evaluate."""
-        if self._client is None or self._context is None:
-            raise RuntimeError("BiDiBackend not launched. Call launch() first.")
+        client = self._require_client()
+        await self._scroll_into_view_if_needed(selector)
         escaped = selector.replace("'", "\\'")
         js = (
             f"document.querySelector('{escaped}')"
             f".dispatchEvent(new MouseEvent('click',{{bubbles:true}}))"
         )
         for _ in range(click_count):
-            await self._client.script.evaluate(self._context, js)
+            await client.script.evaluate(self._context, js)
 
     async def type_text(self, selector: str, text: str, delay: int = 0) -> None:
         """Type text into an element via BiDi."""
@@ -843,12 +856,12 @@ class BiDiBackend(AbstractBackend):
 
     async def fill(self, selector: str, value: str) -> None:
         """Fill an input element with a value via BiDi."""
-        if self._client is None or self._context is None:
-            raise RuntimeError("BiDiBackend not launched. Call launch() first.")
+        client = self._require_client()
+        await self._scroll_into_view_if_needed(selector)
         escaped = selector.replace("'", "\\'")
         escaped_val = value.replace("\\", "\\\\").replace("'", "\\'")
         js = f"document.querySelector('{escaped}').value = '{escaped_val}'"
-        await self._client.script.evaluate(self._context, js)
+        await client.script.evaluate(self._context, js)
 
     async def select_option(self, selector: str, value: str) -> None:
         """Select an option in a <select> element by value via BiDi."""
@@ -861,15 +874,15 @@ class BiDiBackend(AbstractBackend):
 
     async def hover(self, selector: str) -> None:
         """Hover over an element via BiDi script.evaluate."""
-        if self._client is None or self._context is None:
-            raise RuntimeError("BiDiBackend not launched. Call launch() first.")
+        client = self._require_client()
+        await self._scroll_into_view_if_needed(selector)
         escaped = selector.replace("'", "\\'")
         js = (
             f"var el=document.querySelector('{escaped}');"
             f"el.dispatchEvent(new MouseEvent('mouseover',{{bubbles:true}}));"
             f"el.dispatchEvent(new MouseEvent('mousemove',{{bubbles:true}}))"
         )
-        await self._client.script.evaluate(self._context, js)
+        await client.script.evaluate(self._context, js)
 
     async def key_press(self, key: str) -> None:
         """Press a keyboard key via BiDi script.evaluate."""

{wavexis-2.2.0 → wavexis-2.2.2}/wavexis/backend/cdp.py

@@ -83,11 +83,19 @@ class CDPBackend(AbstractBackend):
         if options.proxy:
             extra_args.append(f"--proxy-server={options.proxy}")
 
-        self._client = await CDPClient.launch(
-            headless=options.headless,
-            user_data_dir=options.user_data_dir,  # type: ignore[call-arg]
-            extra_args=extra_args if extra_args else None,
-        )
+        if options.browser_url:
+            from urllib.parse import urlparse
+
+            parsed = urlparse(options.browser_url)
+            host = parsed.hostname or "localhost"
+            port = parsed.port or 9222
+            self._client = await CDPClient.connect(host=host, port=port)  # type: ignore[attr-defined]
+        else:
+            self._client = await CDPClient.launch(
+                headless=options.headless,
+                user_data_dir=options.user_data_dir,  # type: ignore[call-arg]
+                extra_args=extra_args if extra_args else None,
+            )
         self._session = await self._client.new_page()
 
         if options.user_agent:
@@ -1018,6 +1026,23 @@ class CDPBackend(AbstractBackend):
         cy = (min(ys) + max(ys)) / 2
         return cx, cy
 
+    async def _scroll_into_view_if_needed(self, selector: str) -> None:
+        """Scroll element into view if it's not visible in the viewport.
+
+        Args:
+            selector: CSS selector for the target element.
+        """
+        session = self._require_session()
+        escaped = selector.replace("'", "\\'")
+        js = (
+            f"(function(){{var el=document.querySelector('{escaped}');"
+            f"if(!el)return;var rect=el.getBoundingClientRect();"
+            f"if(rect.top<0||rect.bottom>window.innerHeight||"
+            f"rect.left<0||rect.right>window.innerWidth)"
+            f"el.scrollIntoView({{block:'center',behavior:'instant'}});}})()"
+        )
+        await session.runtime.evaluate(js)
+
     async def click(
         self, selector: str, button: str = "left", click_count: int = 1
     ) -> None:
@@ -1029,6 +1054,7 @@ class CDPBackend(AbstractBackend):
             click_count: Number of clicks to dispatch.
         """
         session = self._require_session()
+        await self._scroll_into_view_if_needed(selector)
         x, y = await self._get_box_center(selector)
         btn_map = {"left": "left", "right": "right", "middle": "middle"}
         btn = btn_map.get(button, "left")
@@ -1066,6 +1092,7 @@ class CDPBackend(AbstractBackend):
             value: Value to set in the input field.
         """
         session = self._require_session()
+        await self._scroll_into_view_if_needed(selector)
         escaped = selector.replace("'", "\\'")
         js = (
             f"(function(){{var el=document.querySelector('{escaped}');"
@@ -1105,6 +1132,7 @@ class CDPBackend(AbstractBackend):
             selector: CSS selector for the target element.
         """
         session = self._require_session()
+        await self._scroll_into_view_if_needed(selector)
         x, y = await self._get_box_center(selector)
         await session.input.dispatch_mouse_event(
             type_="mouseMoved", x=x, y=y

{wavexis-2.2.0 → wavexis-2.2.2}/wavexis/cli/_shared.py

@@ -76,6 +76,7 @@ class CLIContext:
     timeout: int = 30000
     proxy: str | None = None
     user_data_dir: str | None = None
+    browser_url: str | None = None
 
 
 _ctx: contextvars.ContextVar[CLIContext | None] = contextvars.ContextVar(
@@ -116,6 +117,8 @@ def _load_global_config() -> None:
             ctx.proxy = str(raw["proxy"])
         if "user_data_dir" in raw:
             ctx.user_data_dir = str(raw["user_data_dir"])
+        if "browser_url" in raw:
+            ctx.browser_url = str(raw["browser_url"])
     except (OSError, ValueError, TypeError, yaml.YAMLError) as exc:
         if ctx.verbose:
             _echo(f"Warning: failed to load config from {config_path}: {exc}")
@@ -144,6 +147,9 @@ def main_callback(
     user_data_dir: str | None = typer.Option(
         None, "--user-data-dir", help="Path to persistent browser profile directory"
     ),
+    browser_url: str | None = typer.Option(
+        None, "--browser-url", help="Connect to existing browser (e.g. ws://localhost:9222)"
+    ),
     version: bool = typer.Option(
         False, "--version", help="Print wavexis version and exit"
     ),
@@ -162,6 +168,8 @@ def main_callback(
         ctx.proxy = proxy
     if user_data_dir:
         ctx.user_data_dir = user_data_dir
+    if browser_url:
+        ctx.browser_url = browser_url
     if version:
         from wavexis import __version__
 
@@ -236,6 +244,7 @@ def _browser_options() -> BrowserOptions:
         timeout=ctx.timeout,
         proxy=ctx.proxy,
         user_data_dir=ctx.user_data_dir,
+        browser_url=ctx.browser_url,
     )
 
 

{wavexis-2.2.0 → wavexis-2.2.2}/wavexis/config.py

@@ -147,6 +147,7 @@ class BrowserOptions:
         proxy: Proxy server URL (e.g. http://proxy:8080 or socks5://proxy:1080).
         timeout: Default navigation timeout in milliseconds.
         user_data_dir: Path to a persistent user data directory for browser profiles.
+        browser_url: URL of an existing browser to connect to (e.g. ws://localhost:9222).
     """
 
     headless: bool = True
@@ -157,6 +158,7 @@ class BrowserOptions:
     proxy: str | None = None
     timeout: int = 30000
     user_data_dir: str | None = None
+    browser_url: str | None = None
 
 
 @dataclass