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

use regex::Regex;
use thiserror::Error;

#[derive(Error, Debug)]
/// An error, which can occur while using this crate.
/// Mostly used to wrap errors from the Regex crate.
pub enum Error {
    #[error("An regex error occurred")]
    RegexError(#[from] regex::Error),
}

/// A type, which is used to return results from this crate.
/// Mostly used to wrap results from the Regex crate.
pub type Result<T> = std::result::Result<T, Error>;

/// A trait, which allows to convert something to a regex.
/// Mostly needed to work with this lib and Regex crate.
pub trait AsRegex: ToString {
    /// Returns the regex, which represents the wanted statement.
    fn as_regex(&self) -> Result<Regex> {
        let regex = Regex::new(&self.to_string())?;
        Ok(regex)
    }
}

/// A trait, which allows to chain regex statements with conditions.
/// Import this, if you want to use the `and`, `or` and `optionally` methods and chain statements.
pub trait Condition: AsRegex + Sized {
    /// Returns the regex, which chains the two given statements with an `and` condition.
    fn and(self, other: impl AsRegex) -> Regex {
        Regex::new(&format!("{}{}", self.to_string(), other.to_string()))
            .expect("Invalid regex (and)")
    }
    /// Returns the regex, which chains the two given statements with an `or` condition.
    fn or(self, other: impl AsRegex) -> Regex {
        Regex::new(&format!("{}|{}", self.to_string(), other.to_string()))
            .expect("Invalid regex (or)")
    }
    /// Returns the regex, which sets the given statement to optional.
    fn optionally(self) -> Regex {
        Regex::new(&format!("(?:{})?", self.to_string())).expect("Invalid regex (optionally)")
    }
}