Implement write support for clipboard_x11

This commit is contained in:
Héctor Ramón Jiménez 2021-03-06 04:34:02 +01:00
parent aeda90d4ef
commit a97dfae8f6
11 changed files with 496 additions and 185 deletions

30
examples/write.rs Normal file
View file

@ -0,0 +1,30 @@
use window_clipboard::Clipboard;
use winit::{
event::{Event, WindowEvent},
event_loop::{ControlFlow, EventLoop},
window::WindowBuilder,
};
fn main() {
let event_loop = EventLoop::new();
let window = WindowBuilder::new()
.with_title("A fantastic window!")
.build(&event_loop)
.unwrap();
let mut clipboard = Clipboard::new(&window).expect("Create clipboard");
clipboard
.write(String::from("Hello, world!"))
.expect("Write to clipboard");
event_loop.run(move |event, _, control_flow| match event {
Event::MainEventsCleared => {}
Event::WindowEvent {
event: WindowEvent::CloseRequested,
window_id,
} if window_id == window.id() => *control_flow = ControlFlow::Exit,
_ => *control_flow = ControlFlow::Wait,
});
}

View file

@ -43,12 +43,16 @@ impl Clipboard {
} }
pub fn read(&self) -> Result<String, Box<dyn Error>> { pub fn read(&self) -> Result<String, Box<dyn Error>> {
// TODO: Think about use of `RefCell`
// Maybe we should make `read` mutable (?)
self.raw.read() self.raw.read()
} }
pub fn write(&mut self, contents: String) -> Result<(), Box<dyn Error>> {
self.raw.write(contents)
}
} }
pub trait ClipboardProvider { pub trait ClipboardProvider {
fn read(&self) -> Result<String, Box<dyn Error>>; fn read(&self) -> Result<String, Box<dyn Error>>;
fn write(&mut self, contents: String) -> Result<(), Box<dyn Error>>;
} }

View file

@ -35,4 +35,8 @@ impl ClipboardProvider for Clipboard {
fn read(&self) -> Result<String, Box<dyn Error>> { fn read(&self) -> Result<String, Box<dyn Error>> {
Err(Box::new(AndroidClipboardError::Unimplemented)) Err(Box::new(AndroidClipboardError::Unimplemented))
} }
fn write(&mut self, contents: String) -> Result<(), Box<dyn Error>> {
Err(Box::new(AndroidClipboardError::Unimplemented))
}
} }

View file

@ -35,4 +35,8 @@ impl ClipboardProvider for Clipboard {
fn read(&self) -> Result<String, Box<dyn Error>> { fn read(&self) -> Result<String, Box<dyn Error>> {
Err(Box::new(iOSClipboardError::Unimplemented)) Err(Box::new(iOSClipboardError::Unimplemented))
} }
fn write(&mut self, contents: String) -> Result<(), Box<dyn Error>> {
Err(Box::new(AndroidClipboardError::Unimplemented))
}
} }

View file

@ -27,10 +27,18 @@ impl ClipboardProvider for wayland::Clipboard {
fn read(&self) -> Result<String, Box<dyn Error>> { fn read(&self) -> Result<String, Box<dyn Error>> {
self.read() self.read()
} }
fn write(&mut self, contents: String) -> Result<(), Box<dyn Error>> {
self.write(contents)
}
} }
impl ClipboardProvider for x11::Clipboard { impl ClipboardProvider for x11::Clipboard {
fn read(&self) -> Result<String, Box<dyn Error>> { fn read(&self) -> Result<String, Box<dyn Error>> {
self.read() self.read().map_err(Box::from)
}
fn write(&mut self, contents: String) -> Result<(), Box<dyn Error>> {
self.write(contents).map_err(Box::from)
} }
} }

View file

@ -13,4 +13,8 @@ impl ClipboardProvider for clipboard_macos::Clipboard {
fn read(&self) -> Result<String, Box<dyn Error>> { fn read(&self) -> Result<String, Box<dyn Error>> {
self.read() self.read()
} }
fn write(&mut self, contents: String) -> Result<(), Box<dyn Error>> {
self.write(contents)
}
} }

View file

@ -1,6 +1,6 @@
use crate::ClipboardProvider; use crate::ClipboardProvider;
use clipboard_win::get_clipboard_string; use clipboard_win::{get_clipboard_string, set_clipboard_string};
use raw_window_handle::HasRawWindowHandle; use raw_window_handle::HasRawWindowHandle;
use std::error::Error; use std::error::Error;
@ -17,4 +17,8 @@ impl ClipboardProvider for Clipboard {
fn read(&self) -> Result<String, Box<dyn Error>> { fn read(&self) -> Result<String, Box<dyn Error>> {
Ok(get_clipboard_string()?) Ok(get_clipboard_string()?)
} }
fn write(&mut self, contents: String) -> Result<(), Box<dyn Error>> {
Ok(set_clipboard_string(&contents)?)
}
} }

View file

@ -1,15 +1,267 @@
use crate::error::Error; use crate::error::Error;
use std::thread;
use std::time::{Duration, Instant};
use x11rb::connection::Connection as _; use x11rb::connection::Connection as _;
use x11rb::errors::ConnectError; use x11rb::errors::ConnectError;
use x11rb::protocol::xproto::{self, Atom, AtomEnum, Window}; use x11rb::protocol::xproto::{self, Atom, AtomEnum, Window};
use x11rb::protocol::Event; use x11rb::protocol::Event;
use x11rb::rust_connection::RustConnection as Connection; use x11rb::rust_connection::RustConnection as Connection;
use std::collections::HashMap;
use std::sync::mpsc;
use std::sync::{Arc, RwLock};
use std::thread;
use std::time::{Duration, Instant};
const POLL_DURATION: std::time::Duration = Duration::from_micros(50); const POLL_DURATION: std::time::Duration = Duration::from_micros(50);
/// X11 Clipboard
pub struct Clipboard {
reader: Context,
writer: Arc<Context>,
selections: Arc<RwLock<HashMap<Atom, (Atom, Vec<u8>)>>>,
worker: mpsc::Sender<Atom>,
}
impl Clipboard {
/// Create Clipboard.
pub fn new() -> Result<Self, Error> {
let reader = Context::new(None)?;
let writer = Arc::new(Context::new(None)?);
let selections = Arc::new(RwLock::new(HashMap::new()));
let (sender, receiver) = mpsc::channel();
let worker = Worker {
context: Arc::clone(&writer),
selections: Arc::clone(&selections),
receiver,
};
thread::spawn(move || worker.run());
Ok(Clipboard {
reader,
writer,
selections,
worker: sender,
})
}
pub fn read(&self) -> Result<String, Error> {
Ok(String::from_utf8(self.load(
self.reader.atoms.clipboard,
self.reader.atoms.utf8_string,
self.reader.atoms.property,
std::time::Duration::from_secs(3),
)?)
.map_err(Error::InvalidUtf8)?)
}
pub fn write(&mut self, contents: String) -> Result<(), Error> {
let selection = self.writer.atoms.clipboard;
let target = self.writer.atoms.utf8_string;
let _ = self.worker.send(selection)?;
self.selections
.write()
.map_err(|_| Error::SelectionLocked)?
.insert(selection, (target, contents.into()));
let _ = xproto::set_selection_owner(
&self.writer.connection,
self.writer.window,
selection,
x11rb::CURRENT_TIME,
)?;
let _ = self.writer.connection.flush()?;
let reply =
xproto::get_selection_owner(&self.writer.connection, selection)
.map_err(Into::into)
.and_then(|cookie| cookie.reply())?;
if reply.owner == self.writer.window {
Ok(())
} else {
Err(Error::InvalidOwner)
}
}
/// load value.
fn load(
&self,
selection: Atom,
target: Atom,
property: Atom,
timeout: impl Into<Option<Duration>>,
) -> Result<Vec<u8>, Error> {
let mut buff = Vec::new();
let timeout = timeout.into();
let _ = xproto::convert_selection(
&self.reader.connection,
self.reader.window,
selection,
target,
property,
x11rb::CURRENT_TIME, // FIXME ^
// Clients should not use CurrentTime for the time argument of a ConvertSelection request.
// Instead, they should use the timestamp of the event that caused the request to be made.
)?;
let _ = self.reader.connection.flush()?;
self.process_event(&mut buff, selection, target, property, timeout)?;
let _ = xproto::delete_property(
&self.reader.connection,
self.reader.window,
property,
)?;
let _ = self.reader.connection.flush()?;
Ok(buff)
}
fn process_event<T>(
&self,
buff: &mut Vec<u8>,
selection: Atom,
target: Atom,
property: Atom,
timeout: T,
) -> Result<(), Error>
where
T: Into<Option<Duration>>,
{
let mut is_incr = false;
let timeout = timeout.into();
let start_time = if timeout.is_some() {
Some(Instant::now())
} else {
None
};
loop {
if timeout
.into_iter()
.zip(start_time)
.next()
.map(|(timeout, time)| (Instant::now() - time) >= timeout)
.unwrap_or(false)
{
return Err(Error::Timeout);
}
let event = match self.reader.connection.poll_for_event()? {
Some(event) => event,
None => {
thread::park_timeout(POLL_DURATION);
continue;
}
};
match event {
Event::SelectionNotify(event) => {
if event.selection != selection {
continue;
};
// Note that setting the property argument to None indicates that the
// conversion requested could not be made.
if event.property == AtomEnum::NONE.into() {
break;
}
let reply = xproto::get_property(
&self.reader.connection,
false,
self.reader.window,
event.property,
Atom::from(AtomEnum::ANY),
buff.len() as u32,
::std::u32::MAX, // FIXME reasonable buffer size
)
.map_err(Into::into)
.and_then(|cookie| cookie.reply())?;
if reply.type_ == self.reader.atoms.incr {
if let Some(&size) = reply.value.get(0) {
buff.reserve(size as usize);
}
let _ = xproto::delete_property(
&self.reader.connection,
self.reader.window,
property,
);
let _ = self.reader.connection.flush();
is_incr = true;
continue;
} else if reply.type_ != target {
return Err(Error::UnexpectedType(reply.type_));
}
buff.extend_from_slice(&reply.value);
break;
}
Event::PropertyNotify(event) if is_incr => {
if event.state != xproto::Property::NEW_VALUE {
continue;
};
let length = xproto::get_property(
&self.reader.connection,
false,
self.reader.window,
property,
Atom::from(AtomEnum::ANY),
0,
0,
)
.map_err(Into::into)
.and_then(|cookie| cookie.reply())?
.bytes_after;
let reply = xproto::get_property(
&self.reader.connection,
true,
self.reader.window,
property,
Atom::from(AtomEnum::ANY),
0,
length,
)
.map_err(Into::into)
.and_then(|cookie| cookie.reply())?;
if reply.type_ != target {
continue;
};
if reply.value_len != 0 {
buff.extend_from_slice(&reply.value);
} else {
break;
}
}
_ => {}
}
}
Ok(())
}
}
pub struct Context {
pub connection: Connection,
pub screen: usize,
pub window: Window,
pub atoms: Atoms,
}
#[derive(Clone, Debug)] #[derive(Clone, Debug)]
pub struct Atoms { pub struct Atoms {
pub primary: Atom, pub primary: Atom,
@ -21,18 +273,6 @@ pub struct Atoms {
pub incr: Atom, pub incr: Atom,
} }
/// X11 Clipboard
pub struct Clipboard {
pub getter: Context,
}
pub struct Context {
pub connection: Connection,
pub screen: usize,
pub window: Window,
pub atoms: Atoms,
}
#[inline] #[inline]
fn get_atom(connection: &Connection, name: &str) -> Result<Atom, Error> { fn get_atom(connection: &Connection, name: &str) -> Result<Atom, Error> {
x11rb::protocol::xproto::intern_atom(connection, false, name.as_bytes()) x11rb::protocol::xproto::intern_atom(connection, false, name.as_bytes())
@ -95,180 +335,199 @@ impl Context {
} }
} }
impl Clipboard { pub struct Worker {
/// Create Clipboard. context: Arc<Context>,
pub fn new() -> Result<Self, Error> { selections: Arc<RwLock<HashMap<Atom, (Atom, Vec<u8>)>>>,
let getter = Context::new(None)?; receiver: mpsc::Receiver<Atom>,
}
Ok(Clipboard { getter }) struct IncrState {
} selection: Atom,
requestor: Atom,
property: Atom,
pos: usize,
}
fn process_event<T>( impl Worker {
&self, pub const INCR_CHUNK_SIZE: usize = 4000;
buff: &mut Vec<u8>,
selection: Atom,
target: Atom,
property: Atom,
timeout: T,
) -> Result<(), Error>
where
T: Into<Option<Duration>>,
{
let mut is_incr = false;
let timeout = timeout.into();
let start_time = if timeout.is_some() {
Some(Instant::now())
} else {
None
};
loop { pub fn run(self) {
if timeout use x11rb::connection::RequestConnection;
.into_iter()
.zip(start_time)
.next()
.map(|(timeout, time)| (Instant::now() - time) >= timeout)
.unwrap_or(false)
{
return Err(Error::Timeout);
}
let event = match self.getter.connection.poll_for_event()? { let mut incr_map = HashMap::new();
Some(event) => event, let mut state_map = HashMap::new();
None => {
thread::park_timeout(POLL_DURATION); let max_length = self.context.connection.maximum_request_bytes() * 4;
continue;
while let Ok(event) = self.context.connection.wait_for_event() {
while let Ok(selection) = self.receiver.try_recv() {
if let Some(property) = incr_map.remove(&selection) {
state_map.remove(&property);
} }
}; }
match event { match event {
Event::SelectionNotify(event) => { Event::SelectionRequest(event) => {
if event.selection != selection { let selections = match self.selections.read().ok() {
continue; Some(selections) => selections,
None => continue,
}; };
// Note that setting the property argument to None indicates that the let &(target, ref value) =
// conversion requested could not be made. match selections.get(&event.selection) {
if event.property == AtomEnum::NONE.into() { Some(key_value) => key_value,
break; None => continue,
};
if event.target == self.context.atoms.targets {
let data: Vec<u8> = {
let atom_target_bytes =
self.context.atoms.targets.to_le_bytes();
let target_bytes = target.to_le_bytes();
atom_target_bytes
.iter()
.chain(target_bytes.iter())
.copied()
.collect()
};
xproto::change_property(
&self.context.connection,
xproto::PropMode::REPLACE,
event.requestor,
event.property,
xproto::AtomEnum::ATOM,
32,
2,
&data,
)
.expect("Change property");
} else if value.len() < max_length - 24 {
let _ = xproto::change_property(
&self.context.connection,
xproto::PropMode::REPLACE,
event.requestor,
event.property,
target,
8,
value.len() as u32,
value,
)
.expect("Change property");
} else {
let _ = xproto::change_window_attributes(
&self.context.connection,
event.requestor,
&xproto::ChangeWindowAttributesAux::new()
.event_mask(xproto::EventMask::PROPERTY_CHANGE),
)
.expect("Change window attributes");
xproto::change_property(
&self.context.connection,
xproto::PropMode::REPLACE,
event.requestor,
event.property,
self.context.atoms.incr,
32,
0,
&[],
)
.expect("Change property");
incr_map.insert(event.selection, event.property);
state_map.insert(
event.property,
IncrState {
selection: event.selection,
requestor: event.requestor,
property: event.property,
pos: 0,
},
);
} }
let reply = xproto::get_property( let _ = xproto::send_event(
&self.getter.connection, &self.context.connection,
false, false,
self.getter.window, event.requestor,
event.property, 0u32,
Atom::from(AtomEnum::ANY), xproto::SelectionNotifyEvent {
buff.len() as u32, response_type: 31,
::std::u32::MAX, // FIXME reasonable buffer size sequence: event.sequence,
time: event.time,
requestor: event.requestor,
selection: event.selection,
target: event.target,
property: event.property,
},
) )
.map_err(Into::into) .expect("Send event");
.and_then(|cookie| cookie.reply())?;
if reply.type_ == self.getter.atoms.incr { let _ = self.context.connection.flush();
if let Some(&size) = reply.value.get(0) { }
buff.reserve(size as usize); Event::PropertyNotify(event) => {
} if event.state != xproto::Property::DELETE {
continue;
}
let _ = xproto::delete_property( let is_end = {
&self.getter.connection, let state = match state_map.get_mut(&event.atom) {
self.getter.window, Some(state) => state,
property, None => continue,
};
let selections = match self.selections.read().ok() {
Some(selections) => selections,
None => continue,
};
let &(target, ref value) =
match selections.get(&state.selection) {
Some(key_value) => key_value,
None => continue,
};
let len = std::cmp::min(
Self::INCR_CHUNK_SIZE,
value.len() - state.pos,
); );
let _ = self.getter.connection.flush(); let _ = xproto::change_property(
is_incr = true; &self.context.connection,
xproto::PropMode::REPLACE,
state.requestor,
state.property,
target,
8,
len as u32,
&value[state.pos..][..len],
)
.expect("Change property");
continue; state.pos += len;
} else if reply.type_ != target { len == 0
return Err(Error::UnexpectedType(reply.type_));
}
buff.extend_from_slice(&reply.value);
break;
}
Event::PropertyNotify(event) if is_incr => {
if event.state != xproto::Property::NEW_VALUE {
continue;
}; };
let length = xproto::get_property( if is_end {
&self.getter.connection, state_map.remove(&event.atom);
false, }
self.getter.window,
property,
Atom::from(AtomEnum::ANY),
0,
0,
)
.map_err(Into::into)
.and_then(|cookie| cookie.reply())?
.bytes_after;
let reply = xproto::get_property( self.context.connection.flush().expect("Flush connection");
&self.getter.connection, }
true, Event::SelectionClear(event) => {
self.getter.window, if let Some(property) = incr_map.remove(&event.selection) {
property, state_map.remove(&property);
Atom::from(AtomEnum::ANY), }
0,
length,
)
.map_err(Into::into)
.and_then(|cookie| cookie.reply())?;
if reply.type_ != target { if let Ok(mut write_setmap) = self.selections.write() {
continue; write_setmap.remove(&event.selection);
};
if reply.value_len != 0 {
buff.extend_from_slice(&reply.value);
} else {
break;
} }
} }
_ => {} _ => (),
} }
} }
Ok(())
}
/// load value.
pub fn load<T>(
&self,
selection: Atom,
target: Atom,
property: Atom,
timeout: T,
) -> Result<Vec<u8>, Error>
where
T: Into<Option<Duration>>,
{
let mut buff = Vec::new();
let timeout = timeout.into();
let _ = xproto::convert_selection(
&self.getter.connection,
self.getter.window,
selection,
target,
property,
x11rb::CURRENT_TIME, // FIXME ^
// Clients should not use CurrentTime for the time argument of a ConvertSelection request.
// Instead, they should use the timestamp of the event that caused the request to be made.
)?;
let _ = self.getter.connection.flush();
self.process_event(&mut buff, selection, target, property, timeout)?;
let _ = xproto::delete_property(
&self.getter.connection,
self.getter.window,
property,
)?;
let _ = self.getter.connection.flush()?;
Ok(buff)
} }
} }

View file

@ -1,6 +1,8 @@
use x11rb::errors::{ConnectError, ConnectionError, ReplyError}; use x11rb::errors::{ConnectError, ConnectionError, ReplyError};
use x11rb::protocol::xproto::Atom; use x11rb::protocol::xproto::Atom;
use std::sync::mpsc;
#[must_use] #[must_use]
#[derive(Debug, thiserror::Error)] #[derive(Debug, thiserror::Error)]
pub enum Error { pub enum Error {
@ -14,4 +16,12 @@ pub enum Error {
Timeout, Timeout,
#[error("unexpected type: {0}")] #[error("unexpected type: {0}")]
UnexpectedType(Atom), UnexpectedType(Atom),
#[error("invalid utf8 string: {0}")]
InvalidUtf8(std::string::FromUtf8Error),
#[error("deadlock")]
SelectionLocked,
#[error("invalid selection owner")]
InvalidOwner,
#[error("worker communication error")]
SendError(#[from] mpsc::SendError<Atom>),
} }

View file

@ -2,21 +2,5 @@
mod clipboard; mod clipboard;
mod error; mod error;
use std::error::Error; pub use clipboard::Clipboard;
pub use error::Error;
pub struct Clipboard(clipboard::Clipboard);
impl Clipboard {
pub fn new() -> Result<Clipboard, Box<dyn Error>> {
Ok(Clipboard(clipboard::Clipboard::new()?))
}
pub fn read(&self) -> Result<String, Box<dyn Error>> {
Ok(String::from_utf8(self.0.load(
self.0.getter.atoms.clipboard,
self.0.getter.atoms.utf8_string,
self.0.getter.atoms.property,
std::time::Duration::from_secs(3),
)?)?)
}
}