wavexis 2.2.0__tar.gz → 2.2.1__tar.gz

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

@@ -2,6 +2,15 @@
 
 All notable changes to wavexis are documented in this file.
 
+## 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.1}/PKG-INFO

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "wavexis"
-version = "2.2.0"
+version = "2.2.1"
 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.1}/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.1}/wavexis/__init__.py

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

{wavexis-2.2.0 → wavexis-2.2.1}/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:

{wavexis-2.2.0 → wavexis-2.2.1}/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.1}/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