Fix pyproject

douglasdcm · douglasdcm · commit c240b9c8a327 · 2026-03-20T23:45:48.000-03:00
diff --git a/caqui/_vendor/chrome_devtools_protocol/cdp/browser.py b/caqui/_vendor/chrome_devtools_protocol/cdp/browser.py
@@ -11,9 +11,10 @@
 import typing
 from dataclasses import dataclass
 
-from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
 from deprecated.sphinx import deprecated  # type: ignore
 
+from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
+
 from . import page, target
 
 
diff --git a/caqui/_vendor/chrome_devtools_protocol/cdp/debugger.py b/caqui/_vendor/chrome_devtools_protocol/cdp/debugger.py
@@ -11,9 +11,10 @@
 import typing
 from dataclasses import dataclass
 
-from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
 from deprecated.sphinx import deprecated  # type: ignore
 
+from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
+
 from . import runtime
 
 
diff --git a/caqui/_vendor/chrome_devtools_protocol/cdp/dom.py b/caqui/_vendor/chrome_devtools_protocol/cdp/dom.py
@@ -11,9 +11,10 @@
 import typing
 from dataclasses import dataclass
 
-from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
 from deprecated.sphinx import deprecated  # type: ignore
 
+from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
+
 from . import page, runtime
 
 
diff --git a/caqui/_vendor/chrome_devtools_protocol/cdp/dom_debugger.py b/caqui/_vendor/chrome_devtools_protocol/cdp/dom_debugger.py
@@ -11,9 +11,10 @@
 import typing
 from dataclasses import dataclass
 
-from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
 from deprecated.sphinx import deprecated  # type: ignore
 
+from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
+
 from . import dom, runtime
 
 
diff --git a/caqui/_vendor/chrome_devtools_protocol/cdp/dom_snapshot.py b/caqui/_vendor/chrome_devtools_protocol/cdp/dom_snapshot.py
@@ -11,9 +11,10 @@
 import typing
 from dataclasses import dataclass
 
-from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
 from deprecated.sphinx import deprecated  # type: ignore
 
+from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
+
 from . import dom, dom_debugger, page
 
 
diff --git a/caqui/_vendor/chrome_devtools_protocol/cdp/emulation.py b/caqui/_vendor/chrome_devtools_protocol/cdp/emulation.py
@@ -11,9 +11,10 @@
 import typing
 from dataclasses import dataclass
 
-from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
 from deprecated.sphinx import deprecated  # type: ignore
 
+from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
+
 from . import dom, network, page
 
 
diff --git a/caqui/_vendor/chrome_devtools_protocol/cdp/headless_experimental.py b/caqui/_vendor/chrome_devtools_protocol/cdp/headless_experimental.py
@@ -11,9 +11,10 @@
 import typing
 from dataclasses import dataclass
 
-from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
 from deprecated.sphinx import deprecated  # type: ignore
 
+from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
+
 
 @dataclass
 class ScreenshotParams:
diff --git a/caqui/_vendor/chrome_devtools_protocol/cdp/network.py b/caqui/_vendor/chrome_devtools_protocol/cdp/network.py
@@ -11,9 +11,10 @@
 import typing
 from dataclasses import dataclass
 
-from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
 from deprecated.sphinx import deprecated  # type: ignore
 
+from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
+
 from . import debugger, emulation, io, page, runtime, security
 
 
diff --git a/caqui/_vendor/chrome_devtools_protocol/cdp/overlay.py b/caqui/_vendor/chrome_devtools_protocol/cdp/overlay.py
@@ -11,9 +11,10 @@
 import typing
 from dataclasses import dataclass
 
-from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
 from deprecated.sphinx import deprecated  # type: ignore
 
+from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
+
 from . import dom, page, runtime
 
 
diff --git a/caqui/_vendor/chrome_devtools_protocol/cdp/page.py b/caqui/_vendor/chrome_devtools_protocol/cdp/page.py
@@ -11,9 +11,10 @@
 import typing
 from dataclasses import dataclass
 
-from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
 from deprecated.sphinx import deprecated  # type: ignore
 
+from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
+
 from . import debugger, dom, emulation, io, network, runtime
 
 
diff --git a/caqui/_vendor/chrome_devtools_protocol/cdp/performance.py b/caqui/_vendor/chrome_devtools_protocol/cdp/performance.py
@@ -11,9 +11,10 @@
 import typing
 from dataclasses import dataclass
 
-from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
 from deprecated.sphinx import deprecated  # type: ignore
 
+from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
+
 
 @dataclass
 class Metric:
diff --git a/caqui/_vendor/chrome_devtools_protocol/cdp/security.py b/caqui/_vendor/chrome_devtools_protocol/cdp/security.py
@@ -11,9 +11,10 @@
 import typing
 from dataclasses import dataclass
 
-from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
 from deprecated.sphinx import deprecated  # type: ignore
 
+from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
+
 from . import network
 
 
diff --git a/caqui/_vendor/chrome_devtools_protocol/cdp/storage.py b/caqui/_vendor/chrome_devtools_protocol/cdp/storage.py
@@ -11,9 +11,10 @@
 import typing
 from dataclasses import dataclass
 
-from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
 from deprecated.sphinx import deprecated  # type: ignore
 
+from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
+
 from . import browser, network, page, target
 
 
diff --git a/caqui/_vendor/chrome_devtools_protocol/cdp/target.py b/caqui/_vendor/chrome_devtools_protocol/cdp/target.py
@@ -11,9 +11,10 @@
 import typing
 from dataclasses import dataclass
 
-from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
 from deprecated.sphinx import deprecated  # type: ignore
 
+from caqui._vendor.chrome_devtools_protocol.cdp.util import T_JSON_DICT, event_class
+
 from . import browser, page
 
 
diff --git a/caqui/cdp/connection.py b/caqui/cdp/connection.py
@@ -374,7 +374,34 @@ def pending_command_count(self) -> int:
 
 
 class SyncCDPConnection:
+    """
+    Manages a WebSocket connection to Chrome DevTools Protocol.
+
+    This class handles:
+    - WebSocket connection management
+    - JSON-RPC message framing (request ID assignment)
+    - Command multiplexing (tracking multiple concurrent commands)
+    - Event dispatching
+    - Error handling
+
+    Example:
+        async with CDPConnection("ws://localhost:9222/devtools/page/...") as conn:
+            # Send a command
+            result = await conn.execute(some_command())
+
+            # Listen for events
+            async for event in conn.listen():
+                print(event)
+    """
+
     def __init__(self, url: str, timeout: float = 30.0):
+        """
+        Initialize a CDP connection.
+
+        Args:
+            url: WebSocket URL for the CDP endpoint
+            timeout: Default timeout for commands in seconds
+        """
         self._url = url
         self._timeout = timeout
         self._ws = None
diff --git a/caqui/cdp/engine/asynchronous.py b/caqui/cdp/engine/asynchronous.py
@@ -224,6 +224,19 @@ async def _find_all_elements(
         return node_id
 
 
+async def dismiss_all_alerts(conn: AsyncCDPConnection, timeout=2):
+    """Closes all alerts open in page. It may take some time"""
+    current_datetime = datetime.datetime.now()
+    time_to_add = datetime.timedelta(seconds=timeout)
+    new_datetime = current_datetime + time_to_add
+    while datetime.datetime.now() < new_datetime:
+        event = conn.get_event_nowait()
+        if isinstance(event, page.JavascriptDialogOpening):
+            conn.execute(page.handle_java_script_dialog(accept=False))
+        else:
+            asyncio.sleep(0.05)
+
+
 async def _handle_alert(
     conn: AsyncCDPConnection, alert_element, timeout, function_callback, text=None
 ):
@@ -1364,7 +1377,15 @@ async def execute_script(
     return_by_value=False,
 ):
     """Executes a script, like 'style.background='#000000''
-    to change the background of the element"""
+    to change the background of the element
+
+    Args:
+        script: the Javascript script to be executed over the element
+        positive: if True the current script is executed. If False, the negative flag (!)
+        is placed in front of the script
+        return_by_value: Whether the result is expected to be a JSON object which should
+        be sent by value.
+    """
     positive = "" if positive else "!"
     try:
         remote_object = await conn.execute(dom.resolve_node(node_id=element))
diff --git a/caqui/cdp/engine/synchronous.py b/caqui/cdp/engine/synchronous.py
diff --git a/caqui/helper.py b/caqui/helper.py
