dep_util.py 3.41 KB
Newer Older
1 2 3 4 5 6 7 8 9 10
"""distutils.dep_util

Utility functions for simple, timestamp-based dependency of files
and groups of files; also, function based entirely on such
timestamp dependency analysis."""

import os
from distutils.errors import DistutilsFileError


11 12 13 14 15
def newer (source, target):
    """Return true if 'source' exists and is more recently modified than
    'target', or if 'source' exists and 'target' doesn't.  Return false if
    both exist and 'target' is the same age or younger than 'source'.
    Raise DistutilsFileError if 'source' does not exist.
Greg Ward's avatar
Greg Ward committed
16 17
    """
    if not os.path.exists(source):
18 19
        raise DistutilsFileError("file '%s' does not exist" %
                                 os.path.abspath(source))
Greg Ward's avatar
Greg Ward committed
20
    if not os.path.exists(target):
21 22 23 24 25 26 27 28 29
        return 1

    from stat import ST_MTIME
    mtime1 = os.stat(source)[ST_MTIME]
    mtime2 = os.stat(target)[ST_MTIME]

    return mtime1 > mtime2

# newer ()
30 31


32
def newer_pairwise (sources, targets):
33
    """Walk two filename lists in parallel, testing if each source is newer
Greg Ward's avatar
Greg Ward committed
34 35 36 37 38
    than its corresponding target.  Return a pair of lists (sources,
    targets) where source is newer than target, according to the semantics
    of 'newer()'.
    """
    if len(sources) != len(targets):
39
        raise ValueError("'sources' and 'targets' must be same length")
40 41 42 43

    # build a pair of lists (sources, targets) where  source is newer
    n_sources = []
    n_targets = []
44 45 46 47
    for i in range(len(sources)):
        if newer(sources[i], targets[i]):
            n_sources.append(sources[i])
            n_targets.append(targets[i])
48

49 50 51
    return (n_sources, n_targets)

# newer_pairwise ()
52

53

54 55 56
def newer_group (sources, target, missing='error'):
    """Return true if 'target' is out-of-date with respect to any file
    listed in 'sources'.  In other words, if 'target' exists and is newer
Greg Ward's avatar
Greg Ward committed
57 58 59 60 61 62 63 64 65 66
    than every file in 'sources', return false; otherwise return true.
    'missing' controls what we do when a source file is missing; the
    default ("error") is to blow up with an OSError from inside 'stat()';
    if it is "ignore", we silently drop any missing source files; if it is
    "newer", any missing source files make us assume that 'target' is
    out-of-date (this is handy in "dry-run" mode: it'll make you pretend to
    carry out commands that wouldn't work because inputs are missing, but
    that doesn't matter because you're not actually going to run the
    commands).
    """
67
    # If the target doesn't even exist, then it's definitely out-of-date.
Greg Ward's avatar
Greg Ward committed
68
    if not os.path.exists(target):
69
        return 1
Fred Drake's avatar
Fred Drake committed
70

71 72 73 74
    # Otherwise we have to find out the hard way: if *any* source file
    # is more recent than 'target', then 'target' is out-of-date and
    # we can immediately return true.  If we fall through to the end
    # of the loop, then 'target' is up-to-date and we return false.
75 76
    from stat import ST_MTIME
    target_mtime = os.stat(target)[ST_MTIME]
77
    for source in sources:
Greg Ward's avatar
Greg Ward committed
78
        if not os.path.exists(source):
79
            if missing == 'error':      # blow up when we stat() the file
Fred Drake's avatar
Fred Drake committed
80 81
                pass
            elif missing == 'ignore':   # missing source dropped from
82 83
                continue                #  target's dependency list
            elif missing == 'newer':    # missing source means target is
84
                return 1                #  out-of-date
Fred Drake's avatar
Fred Drake committed
85

86 87 88 89 90
        source_mtime = os.stat(source)[ST_MTIME]
        if source_mtime > target_mtime:
            return 1
    else:
        return 0
91

92
# newer_group ()