wild 1.1.0

Glob (wildcard) expanded command-line arguments on Windows
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

use std::ffi::OsString;
use parser;

pub(crate) struct ArgOs {
    pub pattern: OsString,
    pub text: OsString,
}

/// Iterator retuning glob-escaped arguments. Call `args()` to obtain it.
#[must_use]
#[derive(Debug)]
pub(crate) struct GlobArgs<'a> {
    line: &'a [u16],
}

#[cfg(windows)]
use std::os::windows::ffi::OsStringExt;

/// This is used only in tests on non-Windows
#[cfg(not(windows))]
trait LossyOsStringExt {
    fn from_wide(wide: &[u16]) -> OsString {
        OsString::from(String::from_utf16_lossy(wide))
    }
}

#[cfg(not(windows))]
impl LossyOsStringExt for OsString {}

impl<'a> Iterator for GlobArgs<'a> {
    type Item = ArgOs;
    fn next(&mut self) -> Option<Self::Item> {
        let (arg, rest) = parser::next_arg(self.line, (vec![], vec![]), |&mut (ref mut arg, ref mut text), c, quoted| {
            text.push(c);
            match c as u8 {
                b'?' | b'*' | b'[' | b']' if quoted && c < 256 => {
                    arg.push(u16::from(b'['));
                    arg.push(c);
                    arg.push(u16::from(b']'));
                },
                _ => arg.push(c),
            };
        });
        self.line = rest;
        arg.map(|(pattern, text)| ArgOs {
            pattern: OsString::from_wide(&pattern),
            text: OsString::from_wide(&text),
        })
    }
}

impl<'a> GlobArgs<'a> {
    /// UTF-16/UCS2 string from `GetCommandLineW`
    #[allow(dead_code)]
    pub(crate) fn new(line: &'a [u16]) -> Self {
        Self { line }
    }
}