Direct CDP connection

[thalissonvs]

Closes #119

This PR adds support for connecting using a WebSocket address, enabling remote browser control.

The API now works as follows:

chrome = Chrome()
tab = await chrome.connect(your_ws_address)
# and from here you have full access to all pydoll features

ConnectionHandler was also refactored to accept a URL directly, allowing hybrid automations. For example, you can create a ConnectionHandler instance for a specific target and then manually create a WebElement instance, as long as you have its object_id:

connection_handler = ConnectionHandler(ws_address=your_ws_address)
element = WebElement(object_id, connection_handler)

This way, you can use your own CDP implementation together with Pydoll, while still taking full advantage of our API.

TODO:

• Create custom exceptions
• Refactor some conditional logic
• Remove unnecessary variables from Tab
• Review typing
• Add documentation

[codecov]

Codecov Report

❌ Patch coverage is 98.86364% with 1 line in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
pydoll/browser/tab.py	96.15%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!