cap-primitives 0.9.0

Capability-oriented primitives
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

use crate::fs::{
    open_dir_for_reading, open_dir_for_reading_unchecked, open_entry_impl, read_dir_unchecked,
    remove_dir_unchecked, remove_file_unchecked, stat_unchecked, target_o_path, DirEntryInner,
    FollowSymlinks, Metadata, OpenOptions, ReadDir,
};
use posish::fs::Dir;
#[cfg(not(target_os = "wasi"))]
use posish::io::dup;
#[cfg(unix)]
use std::os::unix::{
    ffi::OsStrExt,
    io::{AsRawFd, FromRawFd},
};
#[cfg(target_os = "wasi")]
use std::os::wasi::{
    ffi::OsStrExt,
    io::{AsRawFd, FromRawFd},
};
use std::{
    ffi::OsStr,
    fmt, fs, io,
    mem::ManuallyDrop,
    path::{Component, Path},
    sync::Arc,
};

pub(crate) struct ReadDirInner {
    posish: Arc<Dir>,
}

impl ReadDirInner {
    pub(crate) fn new(start: &fs::File, path: &Path) -> io::Result<Self> {
        Ok(Self {
            posish: Arc::new(Dir::from(open_dir_for_reading(start, path)?)?),
        })
    }

    pub(crate) fn read_base_dir(start: &fs::File) -> io::Result<Self> {
        if !target_o_path().is_empty() {
            // On platforms that use `O_PATH`, open ".".
            Ok(Self {
                posish: Arc::new(Dir::from(open_dir_for_reading_unchecked(
                    start,
                    Component::CurDir.as_ref(),
                )?)?),
            })
        } else {
            // On platforms that lack `O_PATH`, we have a full file descriptor,
            // so just `dup` it (because we use `fdopendir` which assumes
            // ownership_).
            Ok(Self {
                posish: Arc::new(Dir::from(dup(start)?)?),
            })
        }
    }

    pub(crate) fn new_unchecked(start: &fs::File, path: &Path) -> io::Result<Self> {
        let dir = open_dir_for_reading_unchecked(start, path)?;
        Ok(Self {
            posish: Arc::new(Dir::from(dir)?),
        })
    }

    pub(super) fn open(&self, file_name: &OsStr, options: &OpenOptions) -> io::Result<fs::File> {
        unsafe { open_entry_impl(&self.to_std_file(), file_name, options) }
    }

    pub(super) fn metadata(&self, file_name: &OsStr) -> io::Result<Metadata> {
        unsafe { stat_unchecked(&self.to_std_file(), file_name.as_ref(), FollowSymlinks::No) }
    }

    pub(super) fn remove_file(&self, file_name: &OsStr) -> io::Result<()> {
        unsafe { remove_file_unchecked(&self.to_std_file(), file_name.as_ref()) }
    }

    pub(super) fn remove_dir(&self, file_name: &OsStr) -> io::Result<()> {
        unsafe { remove_dir_unchecked(&self.to_std_file(), file_name.as_ref()) }
    }

    pub(super) fn self_metadata(&self) -> io::Result<Metadata> {
        unsafe { Metadata::from_file(&self.to_std_file()) }
    }

    pub(super) fn read_dir(&self, file_name: &OsStr) -> io::Result<ReadDir> {
        unsafe { read_dir_unchecked(&self.to_std_file(), file_name.as_ref()) }
    }

    /// # Safety
    ///
    /// The resulting `fs::File` shouldn't outlive `self`.
    unsafe fn to_std_file(&self) -> ManuallyDrop<fs::File> {
        ManuallyDrop::<fs::File>::new(fs::File::from_raw_fd(self.posish.as_raw_fd()))
    }
}

impl Iterator for ReadDirInner {
    type Item = io::Result<DirEntryInner>;

    fn next(&mut self) -> Option<Self::Item> {
        loop {
            let entry = match self.posish.read()? {
                Err(e) => return Some(Err(e)),
                Ok(entry) => entry,
            };
            let file_name = entry.file_name().to_bytes();
            if file_name != Component::CurDir.as_os_str().as_bytes()
                && file_name != Component::ParentDir.as_os_str().as_bytes()
            {
                let clone = Arc::clone(&self.posish);
                return Some(Ok(DirEntryInner {
                    posish: entry,
                    read_dir: Self { posish: clone },
                }));
            }
        }
    }
}

impl fmt::Debug for ReadDirInner {
    // Like libstd's version, but doesn't print the path.
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        let mut b = f.debug_struct("ReadDir");
        let fd = self.posish.as_raw_fd();
        b.field("fd", &fd);
        b.finish()
    }
}