https://github.com/aprilahijriyan/cidipi

Low-level client for interacting with Chrome Devtools Protocol (CDP) for Python.
https://github.com/aprilahijriyan/cidipi

chrome-devtools-protocol python

Last synced: 9 days ago
JSON representation

Low-level client for interacting with Chrome Devtools Protocol (CDP) for Python.

• Host: GitHub
• URL: https://github.com/aprilahijriyan/cidipi
• Owner: aprilahijriyan
• License: mit
• Created: 2024-06-14T17:21:51.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2024-07-05T09:42:41.000Z (4 months ago)
• Last Synced: 2024-09-24T06:26:03.010Z (about 1 month ago)
• Topics: chrome-devtools-protocol, python
• Language: Python
• Homepage:
• Size: 486 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# cidipi

Low-level client for interacting with Chrome Devtools Protocol (CDP) for Python.

> [!WARNING]

> This library is in alpha. Use it at your own risk.

## Installation

```bash

pip install cidipi

```

## Usage

```python

import asyncio

import logging

from typing import cast

from cidipi.client import Browser

from cidipi.models import EventResponse, Payload, Tab

from cidipi.protocols import commands, events

logging.basicConfig(

    level=logging.DEBUG, format="[%(levelname)s] [%(name)s] %(message)s"

)

logging.getLogger("websockets.client").disabled = True

async def navigate(tab: Tab, *, url: str, wait_until: str):

    async def wait_for(data: Payload, result: asyncio.Future):

        if data.kind == "result":

            return

        cdp_event_klass = events.Page.lifecycleEvent

        cdp_event_name = cdp_event_klass.get_method_name()

        resp_data = cast(EventResponse, data.data)

        if resp_data["method"] == cdp_event_name:

            obj = cdp_event_klass(**resp_data["params"])

            if obj.name == wait_until:

                result.set_result(None)

    return await tab.execute(

        commands.Page.navigate(url=url), callback=wait_for, timeout=30

    )

async def main():

    async with Browser(headless=False, remote_port=0) as browser:

        async def run(url: str):

            async with browser.new_tab() as tab:

                await tab.execute(commands.Page.enable())

                await tab.execute(commands.Page.setLifecycleEventsEnabled(enabled=True))

                await navigate(tab, url=url, wait_until="load")

        await run("https://www.google.com")

if __name__ == "__main__":

    asyncio.run(main())

```

See the [examples/](https://github.com/aprilahijriyan/cidipi/tree/main/examples) directory to get started.