Skip to main content

Trio driver for Chrome DevTools Protocol (CDP)

Project description

Trio CDP

PyPI Python Versions MIT License Build Status Read the Docs

This Python library performs remote control of any web browser that implements the Chrome DevTools Protocol. It is built using the type wrappers in python-chrome-devtools-protocol and implements I/O using Trio. This library handles the WebSocket negotiation and session management, allowing you to transparently multiplex commands, responses, and events over a single connection.

The example below demonstrates the salient features of the library by navigating to a web page and extracting the document title.

from trio_cdp import open_cdp, page, dom

async with open_cdp(cdp_url) as conn:
    # Find the first available target (usually a browser tab).
    targets = await target.get_targets()
    target_id = targets[0].id

    # Create a new session with the chosen target.
    async with conn.open_session(target_id) as session:

        # Navigate to a website.
        async with session.page_enable()
        async with session.wait_for(page.LoadEventFired):
            await session.execute(page.navigate(target_url))

        # Extract the page title.
        root_node = await session.execute(dom.get_document())
        title_node_id = await session.execute(dom.query_selector(root_node.node_id,
            'title'))
        html = await session.execute(dom.get_outer_html(title_node_id))
        print(html)

This example code is explained in the documentation and more example code can be found in the examples/ directory of this repository.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

trio-chrome-devtools-protocol-0.6.0.tar.gz (57.1 kB view details)

Uploaded Source

Built Distribution

File details

Details for the file trio-chrome-devtools-protocol-0.6.0.tar.gz.

File metadata

File hashes

Hashes for trio-chrome-devtools-protocol-0.6.0.tar.gz
Algorithm Hash digest
SHA256 fb46d23292b54e63e4e585f5da2e6986372ad8551aff9cd096a2e2765b05f39d
MD5 722d2a8acec897410cddecaf093769f5
BLAKE2b-256 5541fda0aba190d07cc6f9fd1faf3ed0cb52f2bcae073bbeece56cd024b3e745

See more details on using hashes here.

File details

Details for the file trio_chrome_devtools_protocol-0.6.0-py3-none-any.whl.

File metadata

File hashes

Hashes for trio_chrome_devtools_protocol-0.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 03082a22060946bc099c1065ae476bc72ef96545d5041e3d341c02b43f886e4f
MD5 cddacb3038644706a0c77cfc5c48fba9
BLAKE2b-256 bef0de591fa5c05a7e1d112653712deb4d5ba99cd58a8b9cc550c50f358b5909

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page