use std::fs; use std::future::Future; use std::io; use std::path::Path; use std::pin::Pin; use std::task::Context; use std::task::Poll; /// Creates a new hard link on the filesystem. /// /// The `dst` path will be a link pointing to the `src` path. Note that systems /// often require these two paths to both be located on the same filesystem. /// /// This is an async version of [`std::fs::hard_link`][std] /// /// [std]: https://doc.rust-lang.org/std/fs/fn.hard_link.html pub fn hard_link, Q: AsRef>(src: P, dst: Q) -> HardLinkFuture { HardLinkFuture::new(src, dst) } /// Future returned by `hard_link`. #[derive(Debug)] #[must_use = "futures do nothing unless you `.await` or poll them"] pub struct HardLinkFuture where P: AsRef, Q: AsRef, { src: P, dst: Q, } impl HardLinkFuture where P: AsRef, Q: AsRef, { fn new(src: P, dst: Q) -> HardLinkFuture { HardLinkFuture { src, dst } } } impl Future for HardLinkFuture where P: AsRef, Q: AsRef, { type Output = io::Result<()>; fn poll(self: Pin<&mut Self>, _cx: &mut Context<'_>) -> Poll { crate::blocking_io(|| fs::hard_link(&self.src, &self.dst)) } }