use std::path::Path;
use std::time::Duration;
use anyhow::{Context, Result};
use crate::deck::{Deck, TermSnapshot};
use crate::term::TermSession;
pub const DEFAULT_WAIT_MS: u64 = 1500;
pub const DEFAULT_COLS: u16 = 80;
pub struct Options {
pub wait: Duration,
pub cols: u16,
pub root: Option<std::path::PathBuf>,
}
impl Default for Options {
fn default() -> Self {
Options {
wait: Duration::from_millis(DEFAULT_WAIT_MS),
cols: DEFAULT_COLS,
root: None,
}
}
}
const FILL_CAPTURE_ROWS: u16 = 24;
pub fn capture(deck: &mut Deck, deck_dir: &Path, opts: &Options) -> Result<()> {
let cwd = match &opts.root {
Some(root) => root
.canonicalize()
.with_context(|| format!("snapshot root {}", root.display()))?,
None => deck_dir.to_path_buf(),
};
let cwd = cwd.as_path();
for block in deck.terminals_mut() {
let label = block.command.as_deref().unwrap_or("shell");
eprintln!("snapshotting terminal {}: {label}", block.id + 1);
let rows = if block.fill {
FILL_CAPTURE_ROWS
} else {
block.rows
};
let mut session = match TermSession::spawn(block.command.as_deref(), rows, opts.cols, cwd) {
Ok(session) => session,
Err(e) => {
eprintln!("warning: couldn't snapshot {label:?}: {e:#}");
continue;
}
};
let data = settle(&session, opts.wait);
session.kill();
block.snapshot = Some(TermSnapshot {
cols: opts.cols,
rows,
data,
});
}
Ok(())
}
fn settle(session: &TermSession, wait: Duration) -> Vec<u8> {
const POLL: Duration = Duration::from_millis(50);
let deadline = std::time::Instant::now() + wait;
let mut last: Option<Vec<u8>> = None;
let mut quiet = 0u32;
loop {
std::thread::sleep(POLL);
let cur = session.parser_lock().screen().contents_formatted();
if last.as_deref() == Some(cur.as_slice()) {
quiet += 1;
} else {
quiet = 0;
}
let done = session.exited() && quiet >= 2;
if done || std::time::Instant::now() >= deadline {
return cur;
}
last = Some(cur);
}
}
#[cfg(test)]
mod tests {
use super::*;
use crate::deck::Segment;
#[test]
#[ignore = "spawns a real PTY"]
fn captures_command_output() {
let mut deck =
crate::deck::parse("```terminal rows=4\nprintf snap-test; sleep 5\n```\n", "t")
.unwrap();
let opts = Options {
wait: Duration::from_millis(800),
cols: 40,
root: None,
};
capture(&mut deck, Path::new("."), &opts).unwrap();
let Segment::Terminal(block) = &deck.slide(0, 0).segments[0] else {
panic!("expected terminal");
};
let snap = block.snapshot.as_ref().unwrap();
assert_eq!(snap.cols, 40);
let text = String::from_utf8_lossy(&snap.data);
assert!(text.contains("snap-test"), "capture missing output");
}
}