stepshots-cli 1.0.1

CLI for recording, bundling, and uploading Stepshots demos
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

use manifest::Viewport;

use crate::actions::execute_action;
use crate::browser::Browser;
use crate::config::StepshotsConfig;
use crate::error::CliError;

/// Run a tutorial in a visible browser for preview/debugging.
pub async fn run(
    config: &StepshotsConfig,
    tutorial_key: &str,
    viewport: &Viewport,
) -> Result<(), CliError> {
    let tutorial = config.tutorials.get(tutorial_key).ok_or_else(|| {
        CliError::Config(format!(
            "Tutorial '{tutorial_key}' not found. Available: {}",
            config
                .tutorials
                .keys()
                .cloned()
                .collect::<Vec<_>>()
                .join(", ")
        ))
    })?;

    println!("Preview: {} ({})", tutorial.title, tutorial_key);
    println!("Browser will stay open — press Ctrl+C to close.");

    let browser = Browser::launch(viewport, false).await?;

    let start_url = resolve_url(&config.base_url, &tutorial.url);
    browser.navigate(&start_url).await?;
    browser.wait_idle(config.default_delay).await;

    for (i, step) in tutorial.steps.iter().enumerate() {
        println!(
            "  Step {}: {} {}",
            i + 1,
            step.action,
            step.selector.as_deref().unwrap_or("")
        );
        execute_action(&browser, step, &config.base_url).await?;
        let delay = step.delay.unwrap_or(config.default_delay);
        browser.wait_idle(delay).await;
    }

    println!("All steps executed. Browser is open — press Ctrl+C to exit.");

    // Wait until interrupted
    tokio::signal::ctrl_c()
        .await
        .map_err(|e| CliError::Other(format!("Signal error: {e}")))?;

    Ok(())
}

fn resolve_url(base: &str, path: &str) -> String {
    if path.starts_with("http://") || path.starts_with("https://") {
        path.to_string()
    } else {
        let base = base.trim_end_matches('/');
        let path = if path.starts_with('/') {
            path.to_string()
        } else {
            format!("/{path}")
        };
        format!("{base}{path}")
    }
}