cdpkits 1.2.5

Chrome DevTools Protocol Toolkit in Python

CDPKit: A Python Implementation of the CDP(Chrome DevTools Protocol)Toolkit

English | 中文

Overview

CDPKit is a toolkit for the Chrome DevTools Protocol (CDP). The protocol component of this project is built on pydantic, supporting friendly code completion and parameter type checking. It also provides a connection module that enables CDP interactions via the remote-debugging-port.

Key Features

• Type Safety: Leverages pydantic to automatically implement type checking for command inputs and outputs.
• Rich Type Hints: Provides type hints for command results, eliminating the need to consult documentation for return values.
• Dynamic Code Generation: Generates protocol code based on the official CDP JSON schema, ensuring fast updates.
• Async Performance: Offers an asynchronous CDPSessionManager that abstracts communication logic, allowing direct method calls.

Installation

1. Install by pip

pip install cdpkits

2. Install by uv

• 2.1. Install uv(if not currently installed)

curl -LsSf https://astral.sh/uv/install.sh | sh  # macOS and Linux
# on Windows:
# powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

• 2.2. Clone the repository:

git clone https://github.com/yie1d/cdpkit.git  
cd cdpkit

• 2.3. Create a new virtual environment and activate it:

uv venv
source .venv/bin/activate  # On Unix/macOS
# Or on Windows:
# .venv\Scripts\activate

• 2.4. Install dependencies:

uv sync

Basic Usage

import asyncio
from cdpkit.connection import CDPSessionManager
from cdpkit.protocol import Target


async def main():
    session_manager = CDPSessionManager(connection_port=9222)
    cdp_session = await session_manager.get_session()

    target_resp = await cdp_session.execute(Target.GetTargets())

    for target_info in target_resp.targetInfos:
        print(target_info.model_dump())



asyncio.run(main())