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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

// License: see LICENSE file at root directory of `master` branch

//! # Globs

use std::{
    borrow::Cow,
    collections::HashSet,
};

use crate::Glob;

/// # Globs
///
/// This struct contains a set of [`Glob`][::Glob]'s.
///
/// [::Glob]: struct.Glob.html
#[derive(Debug, Eq, PartialEq)]
pub struct Globs<'a> {

    /// # Globs
    globs: HashSet<Glob<'a>>,

}

impl<'a> Globs<'a> {

    /// # Makes new instance from an iterator of [`Cow<'a, str>`][r::Cow]
    ///
    /// ## Notes
    ///
    /// - Empty strings will be ignored.
    /// - If the iterator contains no globs, `None` is returned.
    ///
    /// ## Examples
    ///
    /// ```
    /// use sub_strs::Globs;
    ///
    /// let globs = Globs::from("*.rs|*.md".split('|').map(|s| s.into())).unwrap();
    /// assert!(globs.any("this.rs"));
    /// assert!(globs.any("that.md"));
    /// assert!(globs.any("not-this") == false);
    /// ```
    ///
    /// [r::Cow]: https://doc.rust-lang.org/std/borrow/enum.Cow.html
    pub fn from<I>(strs: I) -> Option<Self> where I: Iterator<Item=Cow<'a, str>> {
        let globs: HashSet<_> = strs.filter_map(|s| match s.is_empty() {
            true => None,
            false => Some(Glob::from(s)),
        }).collect();

        match globs.is_empty() {
            true => None,
            false => Some(Self {
                globs,
            })
        }
    }

    /// # Merges an iterator of [`Globs<'a>`][::Globs] into one
    ///
    /// If there are no inner [`Glob`][::Glob]'s, `None` is returned.
    ///
    /// ## Examples
    ///
    /// ```
    /// use sub_strs::Globs;
    ///
    /// let program_args = &["*.svg,*.OGG", "*.md"];
    /// let globs = Globs::merge(
    ///     program_args.iter().filter_map(|s|
    ///         Globs::from(s.to_lowercase().split(',').map(|s| s.to_string().into()))
    ///     )
    /// );
    /// assert!(globs.map(|g| g.any("some.ogg")).unwrap_or(false));
    /// ```
    ///
    /// [::Glob]: struct.Glob.html
    /// [::Globs]: struct.Globs.html
    pub fn merge<I>(iter: I) -> Option<Self> where I: Iterator<Item=Self> {
        let result = iter.fold(Self { globs: HashSet::new() }, |mut result, item| {
            result.globs.extend(item.globs);
            result
        });
        match result.globs.is_empty() {
            true => None,
            false => Some(result),
        }
    }

    /// # Checks if _any_ glob inside matches the input string
    pub fn any<S>(&self, s: S) -> bool where S: AsRef<str> {
        self.globs.iter().any(|g| g.matches(&s))
    }

}