clipboard-ext

Crates.ioclipboard-ext
lib.rsclipboard-ext
version0.2.0
sourcesrc
created_at2020-02-13 19:04:51.561756
updated_at2020-02-13 23:15:56.827841
descriptionA clipboard library providing useful extensions for rust-clipboard.
homepage
repositoryhttps://gitlab.com/timvisee/rust-clipboard-ext
max_upload_size
id208069
size45,470
Tim Visée (timvisee)

documentation

README

Build status on GitLab CI Newest release on crates.io Documentation Number of downloads on crates.io Project license

rust-clipboard-ext

A clipboard library providing useful extensions for the rust-clipboard library.

I had a growing annoyance with rust-clipboard, because the clipboard is cleared on the Linux/X11 platform when your application exists as per X11 design. The crate maintainer didn't want to implement workarounds (for valid reasons). This clipboard-ext crate provides additional clipboard contexts that solve this, along with a few other additions.

Here are some of these additions:

Example

Get and set clipboard contents. Keeps contents in X11 clipboard after exit by forking the process. Falls back to standard clipboard provider on non X11 platforms. See x11_fork module for details.

use clipboard_ext::prelude::*;
use clipboard_ext::x11_fork::ClipboardContext;

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

Get and set clipboard contents. Keeps contents in X11 clipboard after exit by invoking xclip/xsel. Falls back to standard clipboard provider on non X11 platforms. See x11_bin module for details.

use clipboard_ext::prelude::*;
use clipboard_ext::x11_bin::ClipboardContext;

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

Requirements

  • Rust 1.40 or above
  • Same requirements as rust-clipboard
  • Requirements noted in specific clipboard context modules

Special thanks

  • to aweinstock314 for building rust-clipboard
  • to everyone involved in all crate dependencies used

License

This project is dual-licensed under the MIT and Apache2 license.

Commit count: 33

cargo fmt