cap_fs_ext/
reopen.rs

1use cap_primitives::fs::{reopen, OpenOptions};
2#[cfg(any(feature = "std", feature = "async_std"))]
3use io_lifetimes::AsFilelike;
4#[cfg(feature = "async_std")]
5use io_lifetimes::FromFilelike;
6use std::io;
7
8/// A trait for the `reopen` function.
9pub trait Reopen {
10    /// Re-open a file, producing a new independent handle.
11    ///
12    /// This operation isn't supported by all operating systems in all
13    /// circumstances, or in some operating systems in any circumstances, so it
14    /// may return an `io::ErrorKind::Other` error if the file cannot be
15    /// reopened.
16    ///
17    /// For files that aren't deleted, it's supported mostly-reliably on Linux
18    /// and Windows and somewhat-reliably on Darwin. Beyond that, it works
19    /// reliably on terminal device files and (slowly) on directories. It's not
20    /// possible to implement this operation with POSIX APIs alone (short of
21    /// traversing the entire filesystem), so further support will depend on
22    /// operating systems providing OS-specific APIs.
23    ///
24    /// This function takes an `OpenOptions`, however it does not acquire new
25    /// permissions that the original handle lacks.
26    fn reopen(&self, options: &OpenOptions) -> io::Result<Self>
27    where
28        Self: Sized;
29}
30
31impl Reopen for std::fs::File {
32    #[inline]
33    fn reopen(&self, options: &OpenOptions) -> io::Result<Self> {
34        reopen(self, options)
35    }
36}
37
38#[cfg(feature = "std")]
39impl Reopen for cap_std::fs::File {
40    #[inline]
41    fn reopen(&self, options: &OpenOptions) -> io::Result<Self> {
42        let file = reopen(
43            &AsFilelike::as_filelike_view::<std::fs::File>(self),
44            options,
45        )?;
46        Ok(Self::from_std(file))
47    }
48}
49
50#[cfg(all(feature = "std", feature = "fs_utf8"))]
51impl Reopen for cap_std::fs_utf8::File {
52    #[inline]
53    fn reopen(&self, options: &OpenOptions) -> io::Result<Self> {
54        let file = reopen(&self.as_filelike_view::<std::fs::File>(), options)?;
55        Ok(Self::from_std(file))
56    }
57}
58
59#[cfg(feature = "async_std")]
60impl Reopen for async_std::fs::File {
61    #[inline]
62    fn reopen(&self, options: &OpenOptions) -> io::Result<Self> {
63        let file = reopen(&self.as_filelike_view::<std::fs::File>(), options)?;
64        Ok(async_std::fs::File::from_into_filelike(file))
65    }
66}
67
68#[cfg(feature = "async_std")]
69impl Reopen for cap_async_std::fs::File {
70    #[inline]
71    fn reopen(&self, options: &OpenOptions) -> io::Result<Self> {
72        let file = reopen(&self.as_filelike_view::<std::fs::File>(), options)?;
73        let std = async_std::fs::File::from_into_filelike(file);
74        Ok(Self::from_std(std))
75    }
76}
77
78#[cfg(all(feature = "async_std", feature = "fs_utf8"))]
79impl Reopen for cap_async_std::fs_utf8::File {
80    #[inline]
81    fn reopen(&self, options: &OpenOptions) -> io::Result<Self> {
82        let file = reopen(&self.as_filelike_view::<std::fs::File>(), options)?;
83        let std = async_std::fs::File::from_into_filelike(file);
84        Ok(Self::from_std(std))
85    }
86}
cap_fs_ext/reopen.rs

cap_fs_ext/
reopen.rs
