clipmem 0.6.0

macOS clipboard memory backed by SQLite and searchable from agent runtimes
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

mod html;
mod rtf;

use serde::Serialize;

use super::ClipboardKind;

pub const TEXT_PROJECTION_VERSION: u32 = 3;

#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize)]
#[serde(rename_all = "snake_case")]
pub enum DisplayRole {
    Primary,
    Supplemental,
    Metadata,
    Hidden,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize)]
#[serde(rename_all = "snake_case")]
pub enum SearchRole {
    Searchable,
    ExactOnly,
    Excluded,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize)]
#[serde(rename_all = "snake_case")]
pub enum CopyTextRole {
    Preferred,
    Supplemental,
    Excluded,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize)]
pub struct ContentRoles {
    pub display: DisplayRole,
    pub search: SearchRole,
    pub copy_text: CopyTextRole,
}

#[derive(Debug, Clone, PartialEq, Eq, Serialize)]
#[serde(rename_all = "snake_case")]
pub enum ProjectionDiagnostic {
    InputTruncated,
    OutputTruncated,
    MalformedMarkup,
    UnsupportedCharset,
}

#[derive(Debug, Clone, Default, PartialEq, Eq)]
pub struct TextProjectionResult {
    pub text: String,
    pub urls: Vec<String>,
    pub diagnostics: Vec<ProjectionDiagnostic>,
}

pub fn content_roles(uti: &str, kind: ClipboardKind) -> ContentRoles {
    let lower = uti.to_ascii_lowercase();
    if matches!(
        lower.as_str(),
        "org.chromium.source-url" | "org.chromium.source-title"
    ) {
        return ContentRoles {
            display: DisplayRole::Metadata,
            search: SearchRole::Excluded,
            copy_text: CopyTextRole::Excluded,
        };
    }

    match kind {
        ClipboardKind::PlainText | ClipboardKind::Json | ClipboardKind::Xml => ContentRoles {
            display: DisplayRole::Primary,
            search: SearchRole::Searchable,
            copy_text: CopyTextRole::Preferred,
        },
        ClipboardKind::Html | ClipboardKind::Rtf => ContentRoles {
            display: DisplayRole::Supplemental,
            search: SearchRole::Searchable,
            copy_text: CopyTextRole::Supplemental,
        },
        ClipboardKind::Url | ClipboardKind::FileUrl => ContentRoles {
            display: DisplayRole::Metadata,
            search: SearchRole::ExactOnly,
            copy_text: CopyTextRole::Excluded,
        },
        _ => ContentRoles {
            display: DisplayRole::Hidden,
            search: SearchRole::Excluded,
            copy_text: CopyTextRole::Excluded,
        },
    }
}

pub(crate) fn html_to_text_lossy(html: &str) -> String {
    html::project_html(html).text
}

pub(crate) fn rtf_to_text_lossy(rtf: &str) -> String {
    rtf::project_rtf(rtf).text
}

pub(crate) use html::project_html;
pub(crate) use rtf::project_rtf;