buffr-blink-cdp 0.1.4

Headless Chromium CDP backend for buffr-engine (Phase 4 spike)
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

//! Error types for the blink-cdp backend.

use thiserror::Error;

/// Errors specific to the blink-cdp backend.
#[derive(Debug, Error)]
pub enum BlinkError {
    #[error("chromium binary not found — install chromium, google-chrome, or chromium-browser")]
    ChromiumNotFound,

    #[error("failed to spawn chromium subprocess: {0}")]
    SpawnFailed(#[source] std::io::Error),

    #[error("failed to probe for a free port: {0}")]
    PortProbe(#[source] std::io::Error),

    #[error("CDP probe failed (is port {port} free?): {source}")]
    ProbeFailed {
        port: u16,
        #[source]
        source: Box<dyn std::error::Error + Send + Sync>,
    },

    #[error("CDP WebSocket connect failed: {0}")]
    WsConnect(String),

    #[error("CDP WebSocket I/O error: {0}")]
    WsIo(String),

    #[error("CDP protocol error: {0}")]
    Protocol(String),

    #[error("CDP command timed out: {method}")]
    Timeout { method: &'static str },

    #[error("CDP worker shut down")]
    WorkerDead,

    #[error("image decode failed: {0}")]
    ImageDecode(String),

    #[error("no active tab")]
    NoActiveTab,

    #[error("failed to create disk-cache directory: {0}")]
    CacheDirCreate(std::io::Error),

    #[error("tab not found: {0}")]
    TabNotFound(buffr_engine::TabId),
}

impl From<BlinkError> for buffr_engine::EngineError {
    fn from(e: BlinkError) -> Self {
        match e {
            BlinkError::ChromiumNotFound => buffr_engine::EngineError::InitFailed(e.to_string()),
            BlinkError::SpawnFailed(_) => buffr_engine::EngineError::InitFailed(e.to_string()),
            BlinkError::CacheDirCreate(_) => buffr_engine::EngineError::InitFailed(e.to_string()),
            BlinkError::PortProbe(_) => buffr_engine::EngineError::InitFailed(e.to_string()),
            BlinkError::ProbeFailed { .. } => buffr_engine::EngineError::InitFailed(e.to_string()),
            BlinkError::WsConnect(_) => buffr_engine::EngineError::InitFailed(e.to_string()),
            BlinkError::NoActiveTab => buffr_engine::EngineError::NoActiveTab,
            BlinkError::TabNotFound(id) => buffr_engine::EngineError::TabNotFound(id),
            other => buffr_engine::EngineError::Other(other.to_string()),
        }
    }
}