playhard-cdp 0.1.1

Typed Chrome DevTools Protocol helpers for the Playhard Rust browser automation stack.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

# Playhard

Playhard is a minimal playright style library written in Rust. It is currently on active development. 

## Crates

| Crate                 | Purpose                                                                   |
| --------------------- | ------------------------------------------------------------------------- |
| `playhard`            | Umbrella crate for applications that want one dependency.                 |
| `playhard-automation` | Page, locator, storage, network, route, and screenshot automation.        |
| `playhard-cdp`        | Typed Chrome DevTools Protocol request and response helpers.              |
| `playhard-launcher`   | Chrome discovery, profile setup, process launch, and transport selection. |
| `playhard-transport`  | WebSocket and pipe transports with request/response correlation.          |
| `test-mock-portal`    | Local workspace scenario runner; not published as a library crate.        |

## Requirements

- Rust 1.81 or newer.
- A Chrome or Chromium installation available to `chrome-locations`, unless you
  connect to an existing DevTools endpoint yourself.

## Quick Start

Add the umbrella crate from this repository:

```toml
[dependencies]
playhard = { git = "https://github.com/shirshak55/playhard" }
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }
```

Launch Chrome, open a page, and read the title:

```rust,no_run
use playhard::{launcher::LaunchOptions, Browser, Result};

#[tokio::main]
async fn main() -> Result<()> {
    let browser = Browser::launch(LaunchOptions {
        headless: true,
        ..LaunchOptions::default()
    })
    .await?;

    let page = browser.new_page().await?;
    page.goto("https://example.com").await?;
    let title = page.evaluate("document.title").await?;

    println!("{title}");
    browser.shutdown().await?;
    Ok(())
}
```

## Development

```bash
cargo fmt --all -- --check
cargo check --workspace --all-targets --locked
cargo clippy --workspace --all-targets --all-features --locked -- -D warnings
cargo test -p playhard-cdp --locked
cargo test -p playhard-transport --locked
cargo test -p playhard-launcher --locked
cargo test -p playhard-automation --lib --locked
cargo test -p playhard --locked
cargo test -p test-mock-portal --locked
```

```bash
cargo test -p playhard-automation --test feature_tour --locked
cargo test -p playhard-automation --test live_bots -- --ignored --nocapture
```