imboard 0.2.6

Exchange images with the clipboard.
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

#[cfg(not(target_os = "macos"))]
use anyhow::anyhow;
use anyhow::Result;
use image::io::Reader;
use image::DynamicImage;
use image::ImageFormat::Png;
use tempfile::NamedTempFile;
use tokio::process::Command;

/// Converts a clipboard image to image::DynamicImage
/// # Example
/// ```rust
/// use anyhow::Result;
///
/// async fn example() -> Result<()> {
///     let img = imboard::copy_image::from_clipboard().await?;
///     Ok(())
/// }
/// ```
pub async fn from_clipboard() -> Result<DynamicImage> {
    #[cfg(target_os = "macos")]
    return from_clipboard_for_darwin().await;

    #[cfg(not(target_os = "macos"))]
    return from_clipboard_for_linux().await;
}

#[cfg(target_os = "macos")]
async fn from_clipboard_for_darwin() -> Result<DynamicImage> {
    // Create a temporary file for storing clipboard image
    let temp_file = NamedTempFile::new()?;
    let temp_file_path = temp_file.path().to_str().unwrap();

    //  Copy clipboard image to a temporary file
    let script_to_copy = &format!(
        "write (the clipboard as «class PNGf») to (open for access \"{}\" with write permission)",
        temp_file_path
    );
    Command::new("osascript")
        .args(&["-e", script_to_copy])
        .spawn()?
        .await?;

    // Convert temporary file image to image::DynamicImage
    let img = Reader::open(temp_file_path)?
        .with_guessed_format()?
        .decode()?;

    // Delete temporary file
    temp_file.close()?;

    Ok(img)
}

#[cfg(not(target_os = "macos"))]
async fn from_clipboard_for_linux() -> Result<DynamicImage> {
    Err(anyhow!(
        "This crate does not support any OS other than macOS"
    ))
}

/// Copies the argument img to the clipboard
/// # Example
/// ```rust
/// use anyhow::Result;
///
/// async fn example() -> Result<()> {
///     let img = image::open("path/to/image")?;
///     imboard::copy_image::to_clipboard(img).await?;
///     Ok(())
/// }
/// ```
pub async fn to_clipboard(img: DynamicImage) -> Result<()> {
    #[cfg(target_os = "macos")]
    return to_clipboard_for_darwin(img).await;

    #[cfg(not(target_os = "macos"))]
    return to_clipboard_for_linux(img).await;
}

#[cfg(target_os = "macos")]
async fn to_clipboard_for_darwin(img: DynamicImage) -> Result<()> {
    // Create a temporary file to save image to the clipboard
    let temp_file = NamedTempFile::new()?;
    let temp_file_path = temp_file.path().to_str().unwrap();

    // Save the argument img to a temporary file as png
    img.save_with_format(temp_file_path, Png).unwrap();

    // Copy temporary file image to the clipboard
    let script_to_copy = &format!(
        "set the clipboard to (read \"{}\" as «class PNGf»)",
        temp_file_path
    );
    Command::new("osascript")
        .args(&["-e", script_to_copy])
        .spawn()?
        .await?;

    // Delete temporary file
    temp_file.close()?;

    Ok(())
}

#[cfg(not(target_os = "macos"))]
async fn to_clipboard_for_linux(_: DynamicImage) -> Result<()> {
    Err(anyhow!(
        "This crate does not support any OS other than macOS"
    ))
}