summaryrefslogtreecommitdiffstats
path: root/Lib/glob.py
blob: 2d3132d1ea8c8df381f977a96449aadbc5fc21ea (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
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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
"""Filename globbing utility."""

import os
import re
import fnmatch

__all__ = ["glob", "iglob"]

def glob(pathname):
    """Return a list of paths matching a pathname pattern.

    The pattern may contain simple shell-style wildcards a la fnmatch.

    """
    return list(iglob(pathname))


def iglob(pathname):
    """Return an iterator which yields the paths matching a pathname pattern.

    The pattern may contain simple shell-style wildcards a la fnmatch.

    """
    if not has_magic(pathname):
        if os.path.lexists(pathname):
            yield pathname
        return
    pathnames = expand_braces(pathname)
    for pathname in pathnames:
      dirname, basename = os.path.split(pathname)
      if not dirname:
          yield from glob1(None, basename)
          return

      if has_magic(dirname):
          dirs = iglob(dirname)
      else:
          dirs = [dirname]
      if has_magic(basename):
          glob_in_dir = glob1
      else:
          glob_in_dir = glob0
      for dirname in dirs:
          for name in glob_in_dir(dirname, basename):
              yield os.path.join(dirname, name)

# These 2 helper functions non-recursively glob inside a literal directory.
# They return a list of basenames. `glob1` accepts a pattern while `glob0`
# takes a literal basename (so it only has to check for its existence).

def glob1(dirname, pattern):
    if not dirname:
        if isinstance(pattern, bytes):
            dirname = bytes(os.curdir, 'ASCII')
        else:
            dirname = os.curdir
    try:
        names = os.listdir(dirname)
    except os.error:
        return []
    if pattern[0] != '.':
        names = [x for x in names if x[0] != '.']
    return fnmatch.filter(names, pattern)

def glob0(dirname, basename):
    if basename == '':
        # `os.path.split()` returns an empty basename for paths ending with a
        # directory separator.  'q*x/' should match only directories.
        if os.path.isdir(dirname):
            return [basename]
    else:
        if os.path.lexists(os.path.join(dirname, basename)):
            return [basename]
    return []


magic_check = re.compile('[*?[{]')
magic_check_bytes = re.compile(b'[*?[{]')
def has_magic(s):
    if isinstance(s, bytes):
        match = magic_check_bytes.search(s)
    else:
        match = magic_check.search(s)
    return match is not None

brace_matcher = re.compile(r'.*(\{.+?[^\\]\})')
def expand_braces(text):
    """Find the rightmost, innermost set of braces and, if it contains a
    comma-separated list, expand its contents recursively (any of its items
    may itself be a list enclosed in braces).

    Return the full set of expanded strings.
    """
    res = set()

    match = brace_matcher.search(text)
    if match is not None:
        sub = match.group(1)
        open_brace, close_brace = match.span(1)
        if "," in sub:
            for pat in sub.strip('{}').split(','):
                res.update(expand_braces(text[:open_brace] + pat + text[close_brace:]))

        else:
            res.update(expand_braces(text[:open_brace] + sub.replace('}', '\\}') + text[close_brace:]))

    else:
        res.add(text.replace('\\}', '}'))

    return res