chromedeveloperprotocol-client 0.1.1__tar.gz → 0.2.1__tar.gz

chromedeveloperprotocol_client-0.2.1/.gitignore

@@ -0,0 +1,12 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+*user_data
+.tau

chromedeveloperprotocol_client-0.2.1/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: chromedeveloperprotocol-client
+Version: 0.2.1
+Summary: Python wrapper for Chrome DevTools Protocol
+Requires-Python: >=3.13
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: inflection>=0.5.1
+Requires-Dist: ipykernel>=7.1.0
+Requires-Dist: jinja2-strcase>=0.0.2
+Requires-Dist: jinja2>=3.1.6
+Requires-Dist: websockets>=15.0.1
+Provides-Extra: test
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'test'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'test'
+Requires-Dist: pytest>=8.0.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# CDP Client
+
+Python wrapper for Chrome DevTools Protocol.
+
+## Installation
+
+```bash
+pip install chromedeveloperprotocol-client
+```
+
+## Usage
+
+This example shows how to connect to a running browser and fetch its version information.
+
+### Hello World Example
+
+```python
+import asyncio
+import httpx
+from cdp import Client
+
+async def get_ws_url(port=9222):
+    async with httpx.AsyncClient() as http:
+        resp = await http.get(f"http://localhost:{port}/json/version")
+        return resp.json()['webSocketDebuggerUrl']
+
+async def main():
+    # Connect to an existing browser session
+    # Browser must be started with --remote-debugging-port=9222
+    ws_url = await get_ws_url()
+    
+    async with Client(ws_url) as client:
+        # Fetch browser version information
+        version = await client.browser.get_version({})
+        print(f"Browser: {version['product']}")
+        
+        # Create a new page and navigate
+        target = await client.target.create_target({"url": "https://www.google.com"})
+        print(f"Created target: {target['targetId']}")
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Running the Examples
+
+Ensure you have a browser (Chrome or Edge) running with remote debugging enabled:
+
+```bash
+chrome.exe --remote-debugging-port=9222
+```
+
+## Updating the CDP Protocols
+
+The library automatically generates its protocol definitions from the upstream [ChromeDevTools/devtools-protocol](https://github.com/ChromeDevTools/devtools-protocol) repository during build/installation. 
+
+To fetch the latest protocol definitions and update the client code, run:
+
+```bash
+uv sync --reinstall-package chromedeveloperprotocol-client
+```
+This will trigger the build hook which pulls the latest JSON files and regenerates the `src/cdp` directory.
+

chromedeveloperprotocol_client-0.2.1/README.md

@@ -0,0 +1,63 @@
+# CDP Client
+
+Python wrapper for Chrome DevTools Protocol.
+
+## Installation
+
+```bash
+pip install chromedeveloperprotocol-client
+```
+
+## Usage
+
+This example shows how to connect to a running browser and fetch its version information.
+
+### Hello World Example
+
+```python
+import asyncio
+import httpx
+from cdp import Client
+
+async def get_ws_url(port=9222):
+    async with httpx.AsyncClient() as http:
+        resp = await http.get(f"http://localhost:{port}/json/version")
+        return resp.json()['webSocketDebuggerUrl']
+
+async def main():
+    # Connect to an existing browser session
+    # Browser must be started with --remote-debugging-port=9222
+    ws_url = await get_ws_url()
+    
+    async with Client(ws_url) as client:
+        # Fetch browser version information
+        version = await client.browser.get_version({})
+        print(f"Browser: {version['product']}")
+        
+        # Create a new page and navigate
+        target = await client.target.create_target({"url": "https://www.google.com"})
+        print(f"Created target: {target['targetId']}")
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Running the Examples
+
+Ensure you have a browser (Chrome or Edge) running with remote debugging enabled:
+
+```bash
+chrome.exe --remote-debugging-port=9222
+```
+
+## Updating the CDP Protocols
+
+The library automatically generates its protocol definitions from the upstream [ChromeDevTools/devtools-protocol](https://github.com/ChromeDevTools/devtools-protocol) repository during build/installation. 
+
+To fetch the latest protocol definitions and update the client code, run:
+
+```bash
+uv sync --reinstall-package chromedeveloperprotocol-client
+```
+This will trigger the build hook which pulls the latest JSON files and regenerates the `src/cdp` directory.
+

chromedeveloperprotocol_client-0.2.1/hatch_build.py

@@ -0,0 +1,33 @@
+import sys
+from pathlib import Path
+from hatchling.builders.hooks.plugin.interface import BuildHookInterface
+
+class BuildHook(BuildHookInterface):
+    def initialize(self, version, build_data):
+        root = Path(__file__).parent
+        src_path = root / "src"
+        
+        # Generator is run to make sure `cdp` is ready
+        if src_path.exists():
+            if str(src_path) not in sys.path:
+                sys.path.insert(0, str(src_path))
+            
+            try:
+                from cdp.generator import CDPGenerator
+                print(f"Generating CDP client code using generator in {src_path}...")
+                generator = CDPGenerator(src_path=src_path)
+                generator.generate()
+            except ImportError as e:
+                print(f"Failed to import CDPGenerator: {e}")
+        
+        # When building the wheel/sdist, the package directory structure
+        # needs to be correct. We want `cdp` as a top-level module.
+        # If we have `src/cdp`, we can set `packages = ["src"]` in pyproject.toml
+        # and not need `force_include` if we structure it right,
+        # but hatchling might require some configuration.
+        
+        # Let's rely on standard package discovery and `packages = ["src"]`
+        # and ensure `src/cdp` is where the files end up.
+        # The generator does this.
+        
+        pass

chromedeveloperprotocol_client-0.2.1/install.py

@@ -0,0 +1,9 @@
+from src.cdp.generator import CDPGenerator
+
+def main():
+    cdp_generator = CDPGenerator()
+    cdp_generator.generate()
+    print("Generation complete.")
+
+if __name__ == "__main__":
+    main()

chromedeveloperprotocol_client-0.2.1/pyproject.toml

@@ -0,0 +1,31 @@
+[project]
+name = "chromedeveloperprotocol-client"
+version = "0.2.1"
+description = "Python wrapper for Chrome DevTools Protocol"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "httpx>=0.28.1",
+    "inflection>=0.5.1",
+    "ipykernel>=7.1.0",
+    "jinja2>=3.1.6",
+    "jinja2-strcase>=0.0.2",
+    "websockets>=15.0.1",
+]
+
+[project.optional-dependencies]
+test = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+    "pytest-cov>=4.1.0",
+]
+
+[build-system]
+requires = ["hatchling", "jinja2", "jinja2-strcase", "httpx", "inflection", "websockets"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/cdp"]
+
+[tool.hatch.build.hooks.custom]
+path = "hatch_build.py"

chromedeveloperprotocol_client-0.2.1/pytest.ini

@@ -0,0 +1,11 @@
+[pytest]
+testpaths = tests
+python_files = test_*.py
+python_classes = Test*
+python_functions = test_*
+addopts = -v --tb=short --strict-markers -ra
+markers =
+    asyncio: mark test as an async test
+    integration: mark test as an integration test
+    unit: mark test as a unit test
+asyncio_mode = auto

chromedeveloperprotocol_client-0.2.1/src/cdp/__init__.py

@@ -0,0 +1,4 @@
+from .domains import Domains
+from .service import Client
+
+__all__ = ["Domains", "Client"]