aboutsummaryrefslogtreecommitdiffhomepage
path: root/tools/misc_utils.py
blob: 89a2f924b13b16d539c182d8e54cd2abf3724413 (plain)
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
# Copyright 2014 Google Inc.
#
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.


"""Miscellaneous utilities."""


import re


class ReSearch(object):
  """A collection of static methods for regexing things."""

  @staticmethod
  def search_within_stream(input_stream, pattern, default=None):
    """Search for regular expression in a file-like object.

    Opens a file for reading and searches line by line for a match to
    the regex and returns the parenthesized group named return for the
    first match.  Does not search across newlines.

    For example:
        pattern = '^root(:[^:]*){4}:(?P<return>[^:]*)'
        with open('/etc/passwd', 'r') as stream:
            return search_within_file(stream, pattern)
    should return root's home directory (/root on my system).

    Args:
        input_stream: file-like object to be read
        pattern: (string) to be passed to re.compile
        default: what to return if no match

    Returns:
        A string or whatever default is
    """
    pattern_object = re.compile(pattern)
    for line in input_stream:
      match = pattern_object.search(line)
      if match:
        return match.group('return')
    return default

  @staticmethod
  def search_within_string(input_string, pattern, default=None):
    """Search for regular expression in a string.

    Args:
        input_string: (string) to be searched
        pattern: (string) to be passed to re.compile
        default: what to return if no match

    Returns:
        A string or whatever default is
    """
    match = re.search(pattern, input_string)
    return match.group('return') if match else default