aboutsummaryrefslogtreecommitdiffstats
path: root/contrib/python/PyHamcrest/src/hamcrest/library/text/stringmatches.py
blob: 0f66b9dce5acdd62221cb8daad15bc80a6bd9322 (plain) (blame)
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
__author__ = "Chris Rose" 
__copyright__ = "Copyright 2011 hamcrest.org" 
__license__ = "BSD, see License.txt" 
 
import re 
 
import six 
 
from hamcrest.core.base_matcher import BaseMatcher 
from hamcrest.core.helpers.hasmethod import hasmethod 
 
class StringMatchesPattern(BaseMatcher): 
 
    def __init__(self, pattern): 
        self.pattern = pattern 
 
    def describe_to(self, description): 
        description.append_text("a string matching '") \ 
                                   .append_text(self.pattern.pattern) \ 
                                   .append_text("'") 
 
    def _matches(self, item): 
        return self.pattern.search(item) is not None 
 
 
def matches_regexp(pattern): 
    """Matches if object is a string containing a match for a given regular 
    expression. 
 
    :param pattern: The regular expression to search for. 
 
    This matcher first checks whether the evaluated object is a string. If so, 
    it checks if the regular expression ``pattern`` matches anywhere within the 
    evaluated object. 
 
    """ 
    if isinstance(pattern, six.string_types): 
        pattern = re.compile(pattern) 
 
    return StringMatchesPattern(pattern)