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

If you're not sure about the file name format, learn more about wheel file names.

trio_chrome_devtools_protocol-0.6.0-py3-none-any.whl (79.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: trio-chrome-devtools-protocol-0.6.0.tar.gz
  • Upload date:
  • Size: 57.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.0.5 CPython/3.7.5 Linux/5.3.0-40-generic

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 Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page