#clipboard

clipboard

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

13 releases

Uses old Rust 2015

0.5.0 Sep 22, 2018
0.4.6 Feb 22, 2018
0.4.2 Sep 26, 2017
0.4.0 Jun 19, 2017
0.1.0 Nov 30, 2015

#7 in #clipboard

Download history 7530/week @ 2021-10-07 5819/week @ 2021-10-14 5170/week @ 2021-10-21 4396/week @ 2021-10-28 3908/week @ 2021-11-04 4327/week @ 2021-11-11 5198/week @ 2021-11-18 6572/week @ 2021-11-25 5193/week @ 2021-12-02 5088/week @ 2021-12-09 3781/week @ 2021-12-16 2832/week @ 2021-12-23 4154/week @ 2021-12-30 4142/week @ 2022-01-06 4188/week @ 2022-01-13 5126/week @ 2022-01-20

17,928 downloads per month
Used in 130 crates (93 directly)

MIT/Apache

14KB
188 lines

rust-clipboard

rust-clipboard is a cross-platform library for getting and setting the contents of the OS-level clipboard.
It has been tested on Windows, Mac OSX, GNU/Linux, and FreeBSD. It is used in Mozilla Servo.

Appveyor Build Status Travis Build Status

Prerequisites

On Linux you need the x11 library, install it with something like:

sudo apt-get install xorg-dev

Example

extern crate clipboard;

use clipboard::ClipboardProvider;
use clipboard::ClipboardContext;

fn example() {
    let mut ctx: ClipboardContext = ClipboardProvider::new().unwrap();
    println!("{:?}", ctx.get_contents());
    ctx.set_contents("some string".to_owned()).unwrap();
}

API

The ClipboardProvider trait has the following functions:

fn new() -> Result<Self, Box<Error>>;
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

~165KB