wavexis 2.0.2__tar.gz → 2.0.3__tar.gz

{wavexis-2.0.2 → wavexis-2.0.3}/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to wavexis are documented in this file.
 
+## v2.0.3 — 2026-07-06
+
+### Refactored
+
+- Removed all `# noqa` lint suppressions — converted Typer argument annotations to `Annotated` types (B008), replaced sync file I/O in async functions with `asyncio.to_thread` (ASYNC230, ASYNC240), fixed mutable default argument (B006)
+- Narrowed broad `except Exception` clauses to specific exception types (`WavexisError`, `OSError`, `json.JSONDecodeError`, `KeyError`, `TypeError`, `TimeoutError`, `zipfile.BadZipFile`, `yaml.YAMLError`) across `cli/app.py`, `repl.py`, `serve.py`, `plugins.py`, `actions/record.py`, `actions/form.py`, `actions/crawl.py`, `actions/session.py`, `backend/cdp.py`
+- Replaced 6 module-level mutable globals (`_preferred_backend`, `_verbose`, `_quiet`, `_headless`, `_timeout`, `_proxy`) with `CLIContext` dataclass + `contextvars.ContextVar` for thread-safe state management
+- Removed unused `os` import in `backend/cdp.py` download handler
+- Replaced local `import json as _json` with top-level `json` import in `backend/cdp.py`
+
 ## v2.0.2 — 2026-07-06
 
 ### Changed

{wavexis-2.0.2 → wavexis-2.0.3}/PKG-INFO

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

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

{wavexis-2.0.2 → wavexis-2.0.3}/tests/unit/test_global_options.py

@@ -15,6 +15,13 @@ pytestmark = pytest.mark.unit
 _cli = sys.modules["wavexis.cli.app"]
 
 
+def _fresh_ctx() -> _cli.CLIContext:
+    """Create a fresh CLIContext and set it as the current context."""
+    ctx = _cli.CLIContext()
+    _cli._ctx.set(ctx)
+    return ctx
+
+
 class TestBrowserOptions:
     """Tests for BrowserOptions with proxy and timeout fields."""
 
@@ -45,32 +52,27 @@ class TestBrowserOptionsHelper:
     """Tests for _browser_options() CLI helper."""
 
     def test_default_options(self) -> None:
-        _cli._headless = True
-        _cli._timeout = 30000
-        _cli._proxy = None
+        _fresh_ctx()
         opts = _cli._browser_options()
         assert opts.headless is True
         assert opts.timeout == 30000
         assert opts.proxy is None
 
     def test_headed_options(self) -> None:
-        _cli._headless = False
-        _cli._timeout = 30000
-        _cli._proxy = None
+        ctx = _fresh_ctx()
+        ctx.headless = False
         opts = _cli._browser_options()
         assert opts.headless is False
 
     def test_proxy_options(self) -> None:
-        _cli._headless = True
-        _cli._timeout = 30000
-        _cli._proxy = "http://proxy:8080"
+        ctx = _fresh_ctx()
+        ctx.proxy = "http://proxy:8080"
         opts = _cli._browser_options()
         assert opts.proxy == "http://proxy:8080"
 
     def test_timeout_options(self) -> None:
-        _cli._headless = True
-        _cli._timeout = 60000
-        _cli._proxy = None
+        ctx = _fresh_ctx()
+        ctx.timeout = 60000
         opts = _cli._browser_options()
         assert opts.timeout == 60000
 
@@ -80,15 +82,12 @@ class TestLoadGlobalConfig:
 
     def test_no_config_file(self, monkeypatch: pytest.MonkeyPatch) -> None:
         monkeypatch.setattr(Path, "home", lambda: Path("/nonexistent_home_12345"))
-        _cli._preferred_backend = None
-        _cli._headless = True
-        _cli._timeout = 30000
-        _cli._proxy = None
+        ctx = _fresh_ctx()
         _cli._load_global_config()
-        assert _cli._preferred_backend is None
-        assert _cli._headless is True
-        assert _cli._timeout == 30000
-        assert _cli._proxy is None
+        assert ctx.preferred_backend is None
+        assert ctx.headless is True
+        assert ctx.timeout == 30000
+        assert ctx.proxy is None
 
     def test_loads_config(self, tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
         config_dir = tmp_path / ".wavexis"
@@ -100,16 +99,13 @@ class TestLoadGlobalConfig:
         )
         monkeypatch.setattr(Path, "home", lambda: tmp_path)
 
-        _cli._preferred_backend = None
-        _cli._headless = True
-        _cli._timeout = 30000
-        _cli._proxy = None
+        ctx = _fresh_ctx()
         _cli._load_global_config()
 
-        assert _cli._preferred_backend == "bidi"
-        assert _cli._headless is False
-        assert _cli._timeout == 60000
-        assert _cli._proxy == "http://proxy:9090"
+        assert ctx.preferred_backend == "bidi"
+        assert ctx.headless is False
+        assert ctx.timeout == 60000
+        assert ctx.proxy == "http://proxy:9090"
 
     def test_cli_overrides_config(
         self, tmp_path: Path, monkeypatch: pytest.MonkeyPatch
@@ -120,14 +116,12 @@ class TestLoadGlobalConfig:
         config_file.write_text("backend: bidi\ntimeout: 60000\n", encoding="utf-8")
         monkeypatch.setattr(Path, "home", lambda: tmp_path)
 
-        _cli._preferred_backend = "cdp"
-        _cli._headless = True
-        _cli._timeout = 30000
-        _cli._proxy = None
+        ctx = _fresh_ctx()
+        ctx.preferred_backend = "cdp"
         _cli._load_global_config()
 
-        assert _cli._preferred_backend == "cdp"
-        assert _cli._timeout == 60000
+        assert ctx.preferred_backend == "cdp"
+        assert ctx.timeout == 60000
 
 
 class TestConfigCommand:

{wavexis-2.0.2 → wavexis-2.0.3}/tests/unit/test_interactions_crawl.py

@@ -9,6 +9,7 @@ import pytest
 from wavexis.actions.crawl import CrawlAction, CrawlParams
 from wavexis.actions.input import InputAction
 from wavexis.config import InputParams, WaitStrategy
+from wavexis.exceptions import WavexisError
 
 pytestmark = pytest.mark.unit
 
@@ -182,6 +183,8 @@ class TestCrawlAction:
             side_effect=[
                 "Page 1",
                 ["https://example.com/about", "https://other.com/page"],
+                "About",
+                [],
             ]
         )
 
@@ -205,6 +208,8 @@ class TestCrawlAction:
             side_effect=[
                 "Blog",
                 ["https://example.com/blog/post1", "https://example.com/about"],
+                "Blog Post 1",
+                [],
             ]
         )
 
@@ -242,7 +247,7 @@ class TestCrawlAction:
 
     async def test_crawl_handles_navigation_error(self) -> None:
         backend = MagicMock()
-        backend.navigate = AsyncMock(side_effect=Exception("Network error"))
+        backend.navigate = AsyncMock(side_effect=WavexisError("Network error"))
         backend.eval = AsyncMock()
 
         params = CrawlParams(

{wavexis-2.0.2 → wavexis-2.0.3}/tests/unit/test_new_features.py

@@ -20,6 +20,7 @@ from wavexis.actions.session import (
 )
 from wavexis.actions.websocket import WebSocketInterceptAction, WebSocketParams
 from wavexis.config import WaitStrategy
+from wavexis.exceptions import WavexisError
 
 pytestmark = pytest.mark.unit
 
@@ -68,7 +69,7 @@ class TestSessionSave:
         backend.close = AsyncMock()
         backend.get_cookies = AsyncMock(return_value=[])
         backend.storage_list = AsyncMock(side_effect=[{}, {}])
-        backend.eval = AsyncMock(side_effect=Exception("no page"))
+        backend.eval = AsyncMock(side_effect=WavexisError("no page"))
 
         with tempfile.NamedTemporaryFile(
             suffix=".json", delete=False, mode="w"
@@ -273,7 +274,7 @@ class TestFormAction:
         backend.launch = AsyncMock()
         backend.close = AsyncMock()
         backend.navigate = AsyncMock()
-        backend.fill = AsyncMock(side_effect=[None, Exception("not found")])
+        backend.fill = AsyncMock(side_effect=[None, WavexisError("not found")])
 
         params = FormParams(
             url="https://app.com/register",

{wavexis-2.0.2 → wavexis-2.0.3}/wavexis/__init__.py

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

{wavexis-2.0.2 → wavexis-2.0.3}/wavexis/actions/crawl.py

@@ -11,6 +11,7 @@ from urllib.parse import urljoin, urlparse
 from wavexis.actions.base import BaseAction
 from wavexis.backend.base import AbstractBackend
 from wavexis.config import WaitStrategy
+from wavexis.exceptions import WavexisError
 
 
 @dataclass
@@ -63,16 +64,16 @@ class CrawlAction(BaseAction[CrawlParams, list[dict[str, Any]]]):
 
             try:
                 await backend.navigate(url, self.params.wait)
-            except Exception:
+            except WavexisError:
                 continue
 
             title = ""
             links: list[str] = []
-            with contextlib.suppress(Exception):
+            with contextlib.suppress(WavexisError):
                 title = await backend.eval(
                     "document.title", await_promise=False
                 )
-            with contextlib.suppress(Exception):
+            with contextlib.suppress(WavexisError):
                 raw_links = await backend.eval(
                     "Array.from(document.querySelectorAll('a[href]')).map(a => a.href)",
                     await_promise=False,

{wavexis-2.0.2 → wavexis-2.0.3}/wavexis/actions/eval.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import asyncio
 from pathlib import Path
 from typing import Any
 
@@ -31,6 +32,8 @@ class EvalAction(BaseAction[EvalParams, Any]):
 
         expression = params.expression
         if params.file:
-            expression = Path(params.file).read_text(encoding="utf-8")  # noqa: ASYNC240
+            expression = await asyncio.to_thread(
+                lambda: Path(params.file).read_text(encoding="utf-8")
+            )
 
         return await backend.eval(expression, await_promise=params.await_promise)

{wavexis-2.0.2 → wavexis-2.0.3}/wavexis/actions/form.py

@@ -8,6 +8,7 @@ from typing import Any
 from wavexis.actions.base import BaseAction
 from wavexis.backend.base import AbstractBackend
 from wavexis.config import BrowserOptions, WaitStrategy
+from wavexis.exceptions import WavexisError
 
 
 @dataclass
@@ -52,7 +53,7 @@ class FormAction(BaseAction[FormParams, dict[str, Any]]):
                 try:
                     await backend.fill(selector, value)
                     filled += 1
-                except Exception:
+                except WavexisError:
                     pass
 
             submitted = False
@@ -60,7 +61,7 @@ class FormAction(BaseAction[FormParams, dict[str, Any]]):
                 try:
                     await backend.click(self.params.submit)
                     submitted = True
-                except Exception:
+                except WavexisError:
                     pass
 
             return {

{wavexis-2.0.2 → wavexis-2.0.3}/wavexis/actions/record.py

@@ -11,6 +11,7 @@ import yaml
 
 from wavexis.backend.base import AbstractBackend
 from wavexis.config import BrowserOptions, WaitStrategy
+from wavexis.exceptions import WavexisError
 
 _RECORD_SCRIPT = """
 (function() {
@@ -142,10 +143,10 @@ async def record_session(
             events = json.loads(raw)
         elif isinstance(raw, list):
             events = raw
-    except Exception:
+    except (json.JSONDecodeError, TypeError, WavexisError):
         pass
 
-    with contextlib.suppress(Exception):
+    with contextlib.suppress(WavexisError):
         await backend.close()
 
     return events_to_yaml(events, url)

{wavexis-2.0.2 → wavexis-2.0.3}/wavexis/actions/scrape.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import asyncio
 from pathlib import Path
 from typing import Any
 
@@ -32,7 +33,9 @@ class ScrapeAction(BaseAction[ScrapeParams, list[dict[str, Any]]]):
         expression = params.expression
 
         if params.file:
-            expression = Path(params.file).read_text(encoding="utf-8")  # noqa: ASYNC240
+            expression = await asyncio.to_thread(
+                lambda: Path(params.file).read_text(encoding="utf-8")
+            )
 
         if not expression:
             expression = "document.title"

{wavexis-2.0.2 → wavexis-2.0.3}/wavexis/actions/screencast.py

@@ -2,7 +2,8 @@
 
 from __future__ import annotations
 
-import os
+import asyncio
+from pathlib import Path
 
 from wavexis.actions.base import BaseAction
 from wavexis.backend.base import AbstractBackend
@@ -38,13 +39,14 @@ class ScreencastAction(BaseAction[ScreencastParams, list[str]]):
         finally:
             await backend.close()
 
-        os.makedirs(self._output_dir, exist_ok=True)
+        await asyncio.to_thread(
+            lambda: Path(self._output_dir).mkdir(parents=True, exist_ok=True)
+        )
         saved: list[str] = []
         for i, frame in enumerate(frames):
             ext = "png" if self.params.format == "png" else "jpg"
             fname = f"frame_{i:05d}.{ext}"
-            fpath = os.path.join(self._output_dir, fname)
-            with open(fpath, "wb") as f:  # noqa: ASYNC230
-                f.write(frame)
+            fpath = str(Path(self._output_dir) / fname)
+            await asyncio.to_thread(Path(fpath).write_bytes, frame)
             saved.append(fpath)
         return saved

{wavexis-2.0.2 → wavexis-2.0.3}/wavexis/actions/session.py

@@ -11,6 +11,7 @@ from typing import Any
 from wavexis.actions.base import BaseAction
 from wavexis.backend.base import AbstractBackend
 from wavexis.config import CookieParams
+from wavexis.exceptions import WavexisError
 
 
 @dataclass
@@ -69,7 +70,7 @@ class SessionSaveAction(BaseAction[Path, str]):
         local_storage = await backend.storage_list("local")
         session_storage = await backend.storage_list("session")
         url = ""
-        with contextlib.suppress(Exception):
+        with contextlib.suppress(WavexisError):
             url = await backend.eval("window.location.href", await_promise=False)
 
         data = SessionData(

{wavexis-2.0.2 → wavexis-2.0.3}/wavexis/backend/cdp.py

@@ -4,7 +4,9 @@ from __future__ import annotations
 
 import asyncio
 import base64
+import json
 import time
+from pathlib import Path
 from typing import Any
 
 from wavexis.backend.base import AbstractBackend
@@ -1267,11 +1269,10 @@ class CDPBackend(AbstractBackend):
         """
         if self._session is None:
             raise NavigationError("", "Session not initialized.")
-        import json as _json
 
         body = response.get("body", "")
         if isinstance(body, (dict, list)):
-            body = _json.dumps(body)
+            body = json.dumps(body)
         body_b64 = base64.b64encode(body.encode("utf-8")).decode("ascii")
 
         fulfilled: list[bool] = [False]
@@ -1374,7 +1375,6 @@ class CDPBackend(AbstractBackend):
         """
         if self._session is None:
             raise NavigationError("", "Session not initialized.")
-        import os
         import tempfile
 
         download_dir = tempfile.mkdtemp()
@@ -1385,11 +1385,9 @@ class CDPBackend(AbstractBackend):
 
         await asyncio.sleep(2)
 
-        for fname in os.listdir(download_dir):
-            fpath = os.path.join(download_dir, fname)
-            if os.path.isfile(fpath):  # noqa: ASYNC240
-                with open(fpath, "rb") as f:  # noqa: ASYNC230
-                    return f.read()
+        for fpath in await asyncio.to_thread(list, Path(download_dir).iterdir):
+            if await asyncio.to_thread(Path(fpath).is_file):
+                return await asyncio.to_thread(Path(fpath).read_bytes)
 
         return b""
 
@@ -1585,10 +1583,8 @@ class CDPBackend(AbstractBackend):
                     zf = zipfile.ZipFile(io.BytesIO(raw))
                     for name in zf.namelist():
                         content = zf.read(name).decode("utf-8", errors="replace")
-                        import json as _json
-
-                        trace_events.extend(_json.loads(content).get("traceEvents", []))
-                except Exception:
+                        trace_events.extend(json.loads(content).get("traceEvents", []))
+                except (zipfile.BadZipFile, json.JSONDecodeError, KeyError, ValueError):
                     trace_events.append({"raw_size": len(raw)})
             else:
                 trace_events.append({"error": "No stream handle in tracingComplete"})
@@ -2323,7 +2319,7 @@ class CDPBackend(AbstractBackend):
             )
             for ev in events:
                 players.append(dict(ev.get("player", ev)))
-        except Exception:
+        except (TimeoutError, KeyError, TypeError):
             pass
         return players
 
@@ -2340,7 +2336,7 @@ class CDPBackend(AbstractBackend):
             for ev in events:
                 if ev.get("playerId") == player_id:
                     messages.append(dict(ev))
-        except Exception:
+        except (TimeoutError, KeyError, TypeError):
             pass
         return messages