abstracttui 0.3.1

A reactive, compositor-grade terminal UI engine: fine-grained signals, layered rendering with damage tracking, images (kitty/iTerm2/sixel/mosaic), software-rasterized 3D (GLB), themes and animation.
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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

//! Best-effort host clipboard when the terminal does not advertise OSC 52 copy.
//!
//! Used by selection release-copy and explicit `copy_to_clipboard` calls so
//! macOS Terminal.app / Cursor-style hosts still receive text without OSC 52.

use std::io::Write;
use std::process::{Command, Stdio};

/// Copy `text` to the OS clipboard via a platform helper. Returns false when
/// no helper exists, spawn fails, or the helper exits non-zero.
pub(crate) fn try_copy(text: &str) -> bool {
    if text.trim().is_empty() {
        return false;
    }
    #[cfg(target_os = "macos")]
    {
        copy_via_stdin("pbcopy", text)
    }
    #[cfg(target_os = "linux")]
    {
        if copy_via_stdin("wl-copy", text) {
            return true;
        }
        copy_via_stdin_args(&["xclip", "-selection", "clipboard"], text)
    }
    #[cfg(windows)]
    {
        copy_windows(text)
    }
    #[cfg(not(any(target_os = "macos", target_os = "linux", windows)))]
    {
        let _ = text;
        false
    }
}

fn copy_via_stdin(program: &str, text: &str) -> bool {
    let mut child = match Command::new(program)
        .stdin(Stdio::piped())
        .stdout(Stdio::null())
        .stderr(Stdio::null())
        .spawn()
    {
        Ok(c) => c,
        Err(_) => return false,
    };
    if let Some(mut stdin) = child.stdin.take() {
        if stdin.write_all(text.as_bytes()).is_err() {
            let _ = child.kill();
            return false;
        }
    }
    child.wait().map(|s| s.success()).unwrap_or(false)
}

#[cfg(target_os = "linux")]
fn copy_via_stdin_args(program_and_args: &[&str], text: &str) -> bool {
    let (program, args) = match program_and_args.split_first() {
        Some(pair) => pair,
        None => return false,
    };
    let mut child = match Command::new(program)
        .args(args)
        .stdin(Stdio::piped())
        .stdout(Stdio::null())
        .stderr(Stdio::null())
        .spawn()
    {
        Ok(c) => c,
        Err(_) => return false,
    };
    if let Some(mut stdin) = child.stdin.take() {
        if stdin.write_all(text.as_bytes()).is_err() {
            let _ = child.kill();
            return false;
        }
    }
    child.wait().map(|s| s.success()).unwrap_or(false)
}

#[cfg(windows)]
fn copy_windows(text: &str) -> bool {
    // clip.exe expects UTF-16 LE on stdin without a BOM.
    let mut wide: Vec<u8> = text.encode_utf16().flat_map(|u| u.to_le_bytes()).collect();
    wide.extend_from_slice(&[0, 0]);
    let mut child = match Command::new("cmd")
        .args(["/C", "clip"])
        .stdin(Stdio::piped())
        .stdout(Stdio::null())
        .stderr(Stdio::null())
        .spawn()
    {
        Ok(c) => c,
        Err(_) => return false,
    };
    if let Some(mut stdin) = child.stdin.take() {
        if stdin.write_all(&wide).is_err() {
            let _ = child.kill();
            return false;
        }
    }
    child.wait().map(|s| s.success()).unwrap_or(false)
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn empty_text_is_rejected() {
        assert!(!try_copy(""));
        assert!(!try_copy("   \n\t"));
    }
}