eregex 0.1.5

An advanced regular expression engine for Rust, inspired by mrab-regex
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

//! Pattern / literal escaping (mrab-regex's `regex.escape`).
//!
//! The escaping rules are chosen to reproduce the four examples in the
//! mrab-regex README:
//!
//! | `special_only` | `literal_spaces` | `escape("foo bar!?")` |
//! |----------------|------------------|-----------------------|
//! | false          | false            | `foo\ bar\!\?`        |
//! | true           | false            | `foo\ bar!\?`         |
//! | true           | true             | `foo bar!\?`          |

/// Escape `s` so it matches literally as a regex pattern (aggressive mode:
/// regex metacharacters plus spaces and common punctuation are escaped).
///
/// ```
/// assert_eq!(eregex::escape("a.b*c"), r"a\.b\*c");
/// ```
pub fn escape(s: &str) -> String {
    escape_impl(s, false, false)
}

/// Like [`escape`] but only escapes regex "special" characters, leaving
/// non-special punctuation alone (mrab's `special_only=True`).
///
/// ```
/// assert_eq!(eregex::escape_special_only("a.b!"), r"a\.b!");
/// ```
pub fn escape_special_only(s: &str) -> String {
    escape_impl(s, true, false)
}

/// Like [`escape`] but leaves spaces unescaped (mrab's `literal_spaces=True`).
/// This implies `special_only` semantics.
pub fn escape_literal_spaces(s: &str) -> String {
    escape_impl(s, true, true)
}

fn escape_impl(s: &str, special_only: bool, literal_spaces: bool) -> String {
    let mut out = String::with_capacity(s.len() * 2);
    for c in s.chars() {
        let is_special = matches!(
            c,
            '.' | '^' | '$' | '*' | '+' | '?' | '(' | ')' | '[' | ']' | '{' | '}' | '\\' | '|'
        );
        let is_space = c == ' ';
        let is_punct = matches!(
            c,
            '!' | '"'
                | '#'
                | '%'
                | '&'
                | '\''
                | ','
                | ':'
                | ';'
                | '<'
                | '='
                | '>'
                | '@'
                | '`'
                | '~'
                | '/'
        );
        // * regex metacharacters are always escaped;
        // * space is escaped unless `literal_spaces` is true;
        // * other punctuation is escaped unless `special_only` is true.
        let escape_this =
            is_special || (is_space && !literal_spaces) || (is_punct && !special_only);
        if escape_this {
            out.push('\\');
        }
        out.push(c);
    }
    out
}