#clipboard #cross-platform #wayland #content #getting #setting #fork

copypasta

copypasta is a cross-platform library for getting and setting the contents of the OS-level clipboard

13 unstable releases (5 breaking)

0.10.1 Feb 5, 2024
0.10.0 Oct 12, 2023
0.9.0 Oct 12, 2023
0.8.2 Feb 17, 2023
0.0.1 Oct 8, 2016

#18 in Operating systems

Download history 14940/week @ 2024-01-26 14923/week @ 2024-02-02 16208/week @ 2024-02-09 18113/week @ 2024-02-16 15638/week @ 2024-02-23 15620/week @ 2024-03-01 16387/week @ 2024-03-08 15430/week @ 2024-03-15 16891/week @ 2024-03-22 15298/week @ 2024-03-29 14830/week @ 2024-04-05 15873/week @ 2024-04-12 16534/week @ 2024-04-19 18390/week @ 2024-04-26 20768/week @ 2024-05-03 16525/week @ 2024-05-10

74,776 downloads per month
Used in 187 crates (66 directly)

MIT/Apache

17KB
246 lines

copypasta

copypasta is a rust-clipboard fork, adding support for the Wayland clipboard.

rust-clipboard is a cross-platform library for getting and setting the contents of the OS-level clipboard.

Example

extern crate copypasta;

use copypasta::{ClipboardContext, ClipboardProvider};

fn main() {
    let mut ctx = ClipboardContext::new().unwrap();

    let msg = "Hello, world!";
    ctx.set_contents(msg.to_owned()).unwrap();

    let content = ctx.get_contents().unwrap();

    println!("{}", content);
}

API

The ClipboardProvider trait has the following functions:

fn get_contents(&mut self) -> Result<String, Box<Error>>;
fn set_contents(&mut self, String) -> Result<(), Box<Error>>;

ClipboardContext is a type alias for one of {WindowsClipboardContext, OSXClipboardContext, X11ClipboardContext, NopClipboardContext}, all of which implement ClipboardProvider. Which concrete type is chosen for ClipboardContext depends on the OS (via conditional compilation).

License

rust-clipboard is dual-licensed under MIT and Apache2.

Dependencies

~0–13MB
~116K SLoC