cli-clipboard is a fork of rust-clipboard that adds wayland support for terminal and window-less applications via wl-clipboard-rs. For terminal applications it supports copy and paste for both wayland and X11 linux environments, macOS and windows.
On Linux it will first attempt to setup a Wayland clipboard provider. If that fails it will then fallback to the X11 clipboard provider.
Note: On Linux, you'll need to have xorg-dev and libxcb-composite0-dev to compile. On Debian and Ubuntu you can install them with
sudo apt install xorg-dev libxcb-composite0-dev
Using ClipboardContext to create a clipboard provider:
```rust use cli_clipboard::{ClipboardContext, ClipboardProvider};
let mut ctx = ClipboardContext::new().unwrap(); let thestring = "Hello, world!"; ctx.setcontents(thestring.toowned()).unwrap(); asserteq!(ctx.getcontents().unwrap(), thestring); ctx.clear(); // clearing the clipboard causes getcontents to return Err on macos and windows if cfg!(any(windows, targetos = "macos")) { if ctx.getcontents().isok() { panic!("Should be Err"); } } else { asserteq!(ctx.get_contents(), ""); } ```
Using the helper functions:
```rust use cli_clipboard;
let thestring = "Hello, world!"; cliclipboard::setcontents(thestring.toowned()).unwrap(); asserteq!(cliclipboard::getcontents().unwrap(), the_string); ```
The ClipboardProvider trait has the following functions:
rust
fn new() -> anyhow::Result<Self>;
fn get_contents(&mut self) -> anyhow::Result<String>;
fn set_contents(&mut self, String) -> anyhow::Result<()>;
fn clear(&mut self) -> anhow::Result<()>;
ClipboardContext is a type alias for one of {WindowsClipboardContext, OSXClipboardContext, LinuxClipboardContext}, all of which implement ClipboardProvider. Which concrete type is chosen for ClipboardContext depends on the OS (via conditional compilation).WaylandClipboardContext and X11ClipboardContext are also available but generally the correct one will be chosen by LinuxClipboardContext.get_contents and set_contents are convenience functions that create a context for you and call the respective function on it.
cli-clipboard is dual-licensed under MIT and Apache2.