file-editor 0.2.0

Clean, elegant API for creating and editing text 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

//! Pattern abstraction: literal `&str` or (with `regex`) compiled `Regex`.
#[cfg(feature = "regex")]
use regex::Regex;

/// Pattern: either a substring literal or, if you enable the `regex` feature, a `Regex`.
pub enum Pattern<'a> {
    /// Literal substring match.
    Literal(&'a str),
    /// Regex match (opt-in via `features = ["regex"]`).
    #[cfg(feature = "regex")]
    Re(&'a Regex),
}

impl Pattern<'_> {
    /// Returns `true` if the pattern matches `hay`.
    pub fn is_match(&self, hay: &str) -> bool {
        match *self {
            Pattern::Literal(s) => hay.contains(s),
            #[cfg(feature = "regex")]
            Pattern::Re(re) => re.is_match(hay),
        }
    }

    /// Replaces all matches in `buf` with `repl`, returning a new `String`.
    pub fn replace_all(&self, buf: &str, repl: &str) -> String {
        match *self {
            Pattern::Literal(s) => buf.replace(s, repl),
            #[cfg(feature = "regex")]
            Pattern::Re(re) => re.replace_all(buf, repl).into(),
        }
    }
}

/// Convert a `&str` into a `Pattern::Literal`.
impl<'a> From<&'a str> for Pattern<'a> {
    fn from(s: &'a str) -> Self {
        Pattern::Literal(s)
    }
}

#[cfg(feature = "regex")]
impl<'a> From<&'a Regex> for Pattern<'a> {
    fn from(re: &'a Regex) -> Self {
        Pattern::Re(re)
    }
}