virtual-file-transfer 0.1.0

Transfer in-memory, generated, or archived data as files via Windows drag-and-drop and clipboard without staging temporary files
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

use crate::{Error, FileNameErrorReason, InputError, Result};

pub(crate) fn validate_file_name(name: &str) -> Result<()> {
    if name.is_empty() {
        return Err(Error::InvalidInput(InputError::EmptyName));
    }

    if name.contains('\0') {
        return Err(Error::InvalidInput(InputError::InvalidFileName {
            name: name.to_owned(),
            reason: FileNameErrorReason::InvalidCharacter('\0'),
        }));
    }

    for component in name.split('/') {
        if component.is_empty() || matches!(component, "." | "..") {
            return Err(Error::InvalidInput(InputError::InvalidFileName {
                name: name.to_owned(),
                reason: FileNameErrorReason::InvalidComponent(component.to_owned()),
            }));
        }
    }

    #[cfg(windows)]
    crate::windows::validation::validate_file_name(name)?;

    Ok(())
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn accepts_valid_names() {
        for name in ["file.txt", "日本語.txt", "😀.txt", ".gitignore"] {
            assert!(validate_file_name(name).is_ok(), "{name:?}");
        }
    }

    #[test]
    fn rejects_empty_name() {
        assert!(matches!(
            validate_file_name(""),
            Err(Error::InvalidInput(InputError::EmptyName))
        ));
    }

    #[test]
    fn rejects_invalid_names() {
        assert!(matches!(
            validate_file_name("a\0b.txt"),
            Err(Error::InvalidInput(InputError::InvalidFileName {
                reason: FileNameErrorReason::InvalidCharacter('\0'),
                ..
            }))
        ));

        for name in [".", ".."] {
            assert!(
                matches!(
                    validate_file_name(name),
                    Err(Error::InvalidInput(InputError::InvalidFileName {
                        reason: FileNameErrorReason::InvalidComponent(_),
                        ..
                    }))
                ),
                "{name:?}"
            );
        }
    }

    #[test]
    fn rejects_invalid_relative_paths() {
        for name in [
            ".",
            "..",
            "a/../b.txt",
            "a/./b.txt",
            "a//b.txt",
            "/a.txt",
            "a/",
        ] {
            assert!(
                matches!(
                    validate_file_name(name),
                    Err(Error::InvalidInput(InputError::InvalidFileName {
                        reason: FileNameErrorReason::InvalidComponent(_),
                        ..
                    }))
                ),
                "{name:?}"
            );
        }
    }

    #[test]
    fn accepts_valid_relative_paths() {
        for name in [
            "file.txt",
            "folder/file.txt",
            "folder/sub/file.txt",
            ".gitignore",
        ] {
            assert!(validate_file_name(name).is_ok(), "{name:?}");
        }
    }
}