shellexpand 3.1.2

Shell-like expansions in strings
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


use std::fmt::Display;
use std::str::Chars;

#[path="wtraits.rs"]
pub mod wtraits;
use self::wtraits::*;

#[path="funcs.rs"]
pub mod funcs;

pub type Xstr = str;

pub type WInput<'x> = &'x str;

pub type Wstr = str;

pub type OString = String;

impl XstrRequirements for str {
}

impl<S: AsRef<str> + ?Sized> AsRefXstrExt for S {
    fn into_winput(&self) -> &str { self.as_ref() }
    fn into_ocow(&self) -> Cow<'_, str> { self.as_ref().into() }
}

impl WstrExt for str {
    fn wstr_as_str(&self) -> Option<&str> { Some(self) }
    fn wstr_len(&self) -> usize { str::len(self) }
    fn wstr_to_ostring(&self) -> String { self.to_owned() }
    fn wstr_strip_prefix(&self, c: char) -> Option<&Self> {
        if self.starts_with(c) {
            Some(&self[c.len_utf8()..])
        } else {
            None
        }
    }
}

impl<'s> WstrRefExt for &'s str {
    type Chars = Chars<'s>;

    /// Must be used only for the-{}-unbracketed $varname expansion variable name termination detection
    ///
    /// The implementation for `paths.rs` is ... limited.
    fn wstr_chars_approx(self) -> Chars<'s> {
        self.chars()
    }
}

impl CharsExt for Chars<'_> {
    fn wstr_len(&self) -> usize {
        self.as_str().len()
    }
}

impl OStringExt for String {
    fn push_str(&mut self, x: &str) { self.push_str(x) }
    fn push_wstr(&mut self, x: &str) { self.push_str(x) }
    fn push_xstr(&mut self, x: &str) { self.push_str(x) }
    fn into_ocow(self) -> Cow<'static, str> { self.into() }

    fn display_possibly_lossy(&self, f: &mut fmt::Formatter) -> fmt::Result {
        Display::fmt(self, f)
    }
}

impl PathBufExt for PathBuf {
    fn try_into_xstring(self) -> Option<String> {
        self.into_os_string().into_string().ok()
    }
}