cdp-toolkit 1.1.0__tar.gz

cdp_toolkit-1.1.0/PKG-INFO

@@ -0,0 +1,52 @@
+Metadata-Version: 2.4
+Name: cdp-toolkit
+Version: 1.1.0
+Summary: Chrome DevTools Protocol automation toolkit
+Author: aaameobius-crypto
+License: MIT
+Project-URL: Homepage, https://github.com/aaameobius-crypto/cdp-toolkit
+Keywords: cdp,chrome,automation,browser
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# CDP Toolkit
+
+> Chrome DevTools Protocol automation without external dependencies
+
+## Features
+
+- CDPClient — HTTP endpoint for tab management (list, create, close, activate)
+- CDPMouseEvents — mouse click, release, move params
+- CDPInput — text injection, key events, React/Vue native setter JS
+- CDPNavigation — navigate, evaluate JS, screenshot params
+- Pure Python stdlib — no playwright, no selenium, no puppeteer
+
+## Quick Start
+
+```python
+from cdp_client import CDPClient, CDPInput
+
+client = CDPClient("127.0.0.1", 9222)
+targets = client.list_targets()
+```
+
+## React Form Fill
+
+```python
+from cdp_client import CDPInput
+
+js = CDPInput.native_setter_js("#email", "user@example.com")
+# Send via CDP Runtime.evaluate
+```
+
+## Tests
+
+```bash
+python -m pytest tests/ -v
+```
+
+## License
+
+MIT

cdp_toolkit-1.1.0/README.md

@@ -0,0 +1,39 @@
+# CDP Toolkit
+
+> Chrome DevTools Protocol automation without external dependencies
+
+## Features
+
+- CDPClient — HTTP endpoint for tab management (list, create, close, activate)
+- CDPMouseEvents — mouse click, release, move params
+- CDPInput — text injection, key events, React/Vue native setter JS
+- CDPNavigation — navigate, evaluate JS, screenshot params
+- Pure Python stdlib — no playwright, no selenium, no puppeteer
+
+## Quick Start
+
+```python
+from cdp_client import CDPClient, CDPInput
+
+client = CDPClient("127.0.0.1", 9222)
+targets = client.list_targets()
+```
+
+## React Form Fill
+
+```python
+from cdp_client import CDPInput
+
+js = CDPInput.native_setter_js("#email", "user@example.com")
+# Send via CDP Runtime.evaluate
+```
+
+## Tests
+
+```bash
+python -m pytest tests/ -v
+```
+
+## License
+
+MIT

cdp_toolkit-1.1.0/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=64"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cdp-toolkit"
+version = "1.1.0"
+description = "Chrome DevTools Protocol automation toolkit"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.8"
+authors = [{name = "aaameobius-crypto"}]
+keywords = ["cdp", "chrome", "automation", "browser"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+]
+
+[project.urls]
+Homepage = "https://github.com/aaameobius-crypto/cdp-toolkit"

cdp_toolkit-1.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

cdp_toolkit-1.1.0/src/cdp_client.py

@@ -0,0 +1,144 @@
+"""CDP Toolkit — Chrome DevTools Protocol automation without external deps."""
+import json
+import socket
+import base64
+import urllib.request
+from typing import Any, Dict, Optional, List
+
+
+class CDPClient:
+    """Minimal CDP client using raw WebSocket protocol."""
+
+    def __init__(self, host: str = "127.0.0.1", port: int = 9222):
+        self.host = host
+        self.port = port
+        self.msg_id = 0
+        self.ws = None
+
+    def _get_ws_url(self) -> str:
+        """Get WebSocket debugger URL from CDP HTTP endpoint."""
+        url = f"http://{self.host}:{self.port}/json"
+        resp = urllib.request.urlopen(url, timeout=5)
+        tabs = json.loads(resp.read())
+        for tab in tabs:
+            if tab.get("type") == "page":
+                return tab["webSocketDebuggerUrl"]
+        raise ConnectionError("No page tab found")
+
+    def _next_id(self) -> int:
+        self.msg_id += 1
+        return self.msg_id
+
+    def list_targets(self) -> List[Dict]:
+        """List all browser targets via HTTP endpoint."""
+        url = f"http://{self.host}:{self.port}/json"
+        resp = urllib.request.urlopen(url, timeout=5)
+        return json.loads(resp.read())
+
+    def create_target(self, url: str) -> Dict:
+        """Create a new browser tab."""
+        encoded = urllib.parse.quote(url, safe="")
+        req = urllib.request.Request(
+            f"http://{self.host}:{self.port}/json/new?{encoded}",
+            method="PUT"
+        )
+        resp = urllib.request.urlopen(req, timeout=10)
+        return json.loads(resp.read())
+
+    def close_target(self, target_id: str) -> bool:
+        """Close a browser tab by target ID."""
+        req = urllib.request.Request(
+            f"http://{self.host}:{self.port}/json/close/{target_id}",
+            method="GET"
+        )
+        resp = urllib.request.urlopen(req, timeout=5)
+        result = json.loads(resp.read())
+        return result.get("result", False)
+
+    def activate_target(self, target_id: str) -> bool:
+        """Activate a browser tab."""
+        req = urllib.request.Request(
+            f"http://{self.host}:{self.port}/json/activate/{target_id}",
+            method="GET"
+        )
+        resp = urllib.request.urlopen(req, timeout=5)
+        return True
+
+    def get_version(self) -> Dict:
+        """Get browser version info."""
+        url = f"http://{self.host}:{self.port}/json/version"
+        resp = urllib.request.urlopen(url, timeout=5)
+        return json.loads(resp.read())
+
+
+class CDPMouseEvents:
+    """CDP mouse event helpers — calculates coordinates for clicks."""
+
+    @staticmethod
+    def click_params(x: int, y: int, button: str = "left", click_count: int = 1) -> Dict:
+        return {
+            "type": "mousePressed",
+            "x": x,
+            "y": y,
+            "button": button,
+            "clickCount": click_count,
+        }
+
+    @staticmethod
+    def release_params(x: int, y: int, button: str = "left") -> Dict:
+        return {
+            "type": "mouseReleased",
+            "x": x,
+            "y": y,
+            "button": button,
+            "clickCount": 1,
+        }
+
+    @staticmethod
+    def move_params(x: int, y: int) -> Dict:
+        return {"type": "mouseMoved", "x": x, "y": y}
+
+
+class CDPInput:
+    """CDP input helpers for text injection and key events."""
+
+    @staticmethod
+    def insert_text_params(text: str) -> Dict:
+        return {"text": text}
+
+    @staticmethod
+    def key_event_params(key: str, type: str = "keyDown") -> Dict:
+        return {"type": type, "key": key}
+
+    @staticmethod
+    def native_setter_js(selector: str, value: str) -> str:
+        """JavaScript for React/Vue native value setter."""
+        return f"""
+        (function() {{
+            var el = document.querySelector('{selector}');
+            if (!el) return 'Element not found';
+            var nativeInputValueSetter = Object.getOwnPropertyDescriptor(
+                window.HTMLInputElement.prototype, 'value'
+            ).set;
+            nativeInputValueSetter.call(el, '{value}');
+            el.dispatchEvent(new Event('input', {{ bubbles: true }}));
+            el.dispatchEvent(new Event('change', {{ bubbles: true }}));
+            return 'OK';
+        }})()
+        """
+
+
+class CDPNavigation:
+    """CDP navigation helpers."""
+
+    @staticmethod
+    def navigate_params(url: str) -> Dict:
+        return {"url": url}
+
+    @staticmethod
+    def evaluate_params(expression: str) -> Dict:
+        return {"expression": expression, "returnByValue": True}
+
+    @staticmethod
+    def screenshot_params(format: str = "png", quality: int = 80) -> Dict:
+        return {"format": format, "quality": quality}

cdp_toolkit-1.1.0/src/cdp_toolkit.egg-info/PKG-INFO

@@ -0,0 +1,52 @@
+Metadata-Version: 2.4
+Name: cdp-toolkit
+Version: 1.1.0
+Summary: Chrome DevTools Protocol automation toolkit
+Author: aaameobius-crypto
+License: MIT
+Project-URL: Homepage, https://github.com/aaameobius-crypto/cdp-toolkit
+Keywords: cdp,chrome,automation,browser
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# CDP Toolkit
+
+> Chrome DevTools Protocol automation without external dependencies
+
+## Features
+
+- CDPClient — HTTP endpoint for tab management (list, create, close, activate)
+- CDPMouseEvents — mouse click, release, move params
+- CDPInput — text injection, key events, React/Vue native setter JS
+- CDPNavigation — navigate, evaluate JS, screenshot params
+- Pure Python stdlib — no playwright, no selenium, no puppeteer
+
+## Quick Start
+
+```python
+from cdp_client import CDPClient, CDPInput
+
+client = CDPClient("127.0.0.1", 9222)
+targets = client.list_targets()
+```
+
+## React Form Fill
+
+```python
+from cdp_client import CDPInput
+
+js = CDPInput.native_setter_js("#email", "user@example.com")
+# Send via CDP Runtime.evaluate
+```
+
+## Tests
+
+```bash
+python -m pytest tests/ -v
+```
+
+## License
+
+MIT

cdp_toolkit-1.1.0/src/cdp_toolkit.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+src/__init__.py
+src/cdp_client.py
+src/cdp_toolkit.egg-info/PKG-INFO
+src/cdp_toolkit.egg-info/SOURCES.txt
+src/cdp_toolkit.egg-info/dependency_links.txt
+src/cdp_toolkit.egg-info/top_level.txt
+tests/test_cdp.py

cdp_toolkit-1.1.0/src/cdp_toolkit.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cdp_toolkit-1.1.0/src/cdp_toolkit.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+__init__
+cdp_client

cdp_toolkit-1.1.0/tests/test_cdp.py

@@ -0,0 +1,64 @@
+import sys
+import os
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src"))
+from cdp_client import CDPClient, CDPMouseEvents, CDPInput, CDPNavigation
+
+
+def test_cdp_client_init():
+    client = CDPClient("127.0.0.1", 9222)
+    assert client.host == "127.0.0.1"
+    assert client.port == 9222
+
+
+def test_mouse_click_params():
+    params = CDPMouseEvents.click_params(100, 200)
+    assert params["x"] == 100
+    assert params["y"] == 200
+    assert params["type"] == "mousePressed"
+    assert params["button"] == "left"
+
+
+def test_mouse_release_params():
+    params = CDPMouseEvents.release_params(100, 200)
+    assert params["type"] == "mouseReleased"
+
+
+def test_mouse_move_params():
+    params = CDPMouseEvents.move_params(50, 75)
+    assert params["x"] == 50
+    assert params["type"] == "mouseMoved"
+
+
+def test_insert_text():
+    params = CDPInput.insert_text_params("hello world")
+    assert params["text"] == "hello world"
+
+
+def test_key_event():
+    params = CDPInput.key_event_params("Enter", "keyDown")
+    assert params["key"] == "Enter"
+    assert params["type"] == "keyDown"
+
+
+def test_native_setter_js():
+    js = CDPInput.native_setter_js("#email", "test@test.com")
+    assert "HTMLInputElement" in js
+    assert "test@test.com" in js
+    assert "nativeInputValueSetter" in js
+
+
+def test_navigate_params():
+    params = CDPNavigation.navigate_params("https://example.com")
+    assert params["url"] == "https://example.com"
+
+
+def test_evaluate_params():
+    params = CDPNavigation.evaluate_params("document.title")
+    assert params["expression"] == "document.title"
+    assert params["returnByValue"] is True
+
+
+def test_screenshot_params():
+    params = CDPNavigation.screenshot_params("jpeg", 70)
+    assert params["format"] == "jpeg"
+    assert params["quality"] == 70