1"""Module/script to byte-compile all .py files to .pyc (or .pyo) files.
2
3When called as a script with arguments, this compiles the directories
4given as arguments recursively; the -l option prevents it from
5recursing into directories.
6
7Without arguments, if compiles all modules on sys.path, without
8recursing into subdirectories.  (Even though it should do so for
9packages -- for now, you'll have to deal with packages separately.)
10
11See module py_compile for details of the actual byte-compilation.
12"""
13import os
14import sys
15import py_compile
16import struct
17import imp
18
19__all__ = ["compile_dir","compile_file","compile_path"]
20
21def compile_dir(dir, maxlevels=10, ddir=None,
22                force=0, rx=None, quiet=0):
23    """Byte-compile all modules in the given directory tree.
24
25    Arguments (only dir is required):
26
27    dir:       the directory to byte-compile
28    maxlevels: maximum recursion level (default 10)
29    ddir:      the directory that will be prepended to the path to the
30               file as it is compiled into each byte-code file.
31    force:     if 1, force compilation, even if timestamps are up-to-date
32    quiet:     if 1, be quiet during compilation
33    """
34    if not quiet:
35        print 'Listing', dir, '...'
36    try:
37        names = os.listdir(dir)
38    except os.error:
39        print "Can't list", dir
40        names = []
41    names.sort()
42    success = 1
43    for name in names:
44        fullname = os.path.join(dir, name)
45        if ddir is not None:
46            dfile = os.path.join(ddir, name)
47        else:
48            dfile = None
49        if not os.path.isdir(fullname):
50            if not compile_file(fullname, ddir, force, rx, quiet):
51                success = 0
52        elif maxlevels > 0 and \
53             name != os.curdir and name != os.pardir and \
54             os.path.isdir(fullname) and \
55             not os.path.islink(fullname):
56            if not compile_dir(fullname, maxlevels - 1, dfile, force, rx,
57                               quiet):
58                success = 0
59    return success
60
61def compile_file(fullname, ddir=None, force=0, rx=None, quiet=0):
62    """Byte-compile one file.
63
64    Arguments (only fullname is required):
65
66    fullname:  the file to byte-compile
67    ddir:      if given, the directory name compiled in to the
68               byte-code file.
69    force:     if 1, force compilation, even if timestamps are up-to-date
70    quiet:     if 1, be quiet during compilation
71    """
72    success = 1
73    name = os.path.basename(fullname)
74    if ddir is not None:
75        dfile = os.path.join(ddir, name)
76    else:
77        dfile = None
78    if rx is not None:
79        mo = rx.search(fullname)
80        if mo:
81            return success
82    if os.path.isfile(fullname):
83        head, tail = name[:-3], name[-3:]
84        if tail == '.py':
85            if not force:
86                try:
87                    mtime = int(os.stat(fullname).st_mtime)
88                    expect = struct.pack('<4sl', imp.get_magic(), mtime)
89                    cfile = fullname + (__debug__ and 'c' or 'o')
90                    with open(cfile, 'rb') as chandle:
91                        actual = chandle.read(8)
92                    if expect == actual:
93                        return success
94                except IOError:
95                    pass
96            if not quiet:
97                print 'Compiling', fullname, '...'
98            try:
99                ok = py_compile.compile(fullname, None, dfile, True)
100            except py_compile.PyCompileError,err:
101                if quiet:
102                    print 'Compiling', fullname, '...'
103                print err.msg
104                success = 0
105            except IOError, e:
106                print "Sorry", e
107                success = 0
108            else:
109                if ok == 0:
110                    success = 0
111    return success
112
113def compile_path(skip_curdir=1, maxlevels=0, force=0, quiet=0):
114    """Byte-compile all module on sys.path.
115
116    Arguments (all optional):
117
118    skip_curdir: if true, skip current directory (default true)
119    maxlevels:   max recursion level (default 0)
120    force: as for compile_dir() (default 0)
121    quiet: as for compile_dir() (default 0)
122    """
123    success = 1
124    for dir in sys.path:
125        if (not dir or dir == os.curdir) and skip_curdir:
126            print 'Skipping current directory'
127        else:
128            success = success and compile_dir(dir, maxlevels, None,
129                                              force, quiet=quiet)
130    return success
131
132def expand_args(args, flist):
133    """read names in flist and append to args"""
134    expanded = args[:]
135    if flist:
136        try:
137            if flist == '-':
138                fd = sys.stdin
139            else:
140                fd = open(flist)
141            while 1:
142                line = fd.readline()
143                if not line:
144                    break
145                expanded.append(line[:-1])
146        except IOError:
147            print "Error reading file list %s" % flist
148            raise
149    return expanded
150
151def main():
152    """Script main program."""
153    import getopt
154    try:
155        opts, args = getopt.getopt(sys.argv[1:], 'lfqd:x:i:')
156    except getopt.error, msg:
157        print msg
158        print "usage: python compileall.py [-l] [-f] [-q] [-d destdir] " \
159              "[-x regexp] [-i list] [directory|file ...]"
160        print
161        print "arguments: zero or more file and directory names to compile; " \
162              "if no arguments given, "
163        print "           defaults to the equivalent of -l sys.path"
164        print
165        print "options:"
166        print "-l: don't recurse into subdirectories"
167        print "-f: force rebuild even if timestamps are up-to-date"
168        print "-q: output only error messages"
169        print "-d destdir: directory to prepend to file paths for use in " \
170              "compile-time tracebacks and in"
171        print "            runtime tracebacks in cases where the source " \
172              "file is unavailable"
173        print "-x regexp: skip files matching the regular expression regexp; " \
174              "the regexp is searched for"
175        print "           in the full path of each file considered for " \
176              "compilation"
177        print "-i file: add all the files and directories listed in file to " \
178              "the list considered for"
179        print '         compilation; if "-", names are read from stdin'
180
181        sys.exit(2)
182    maxlevels = 10
183    ddir = None
184    force = 0
185    quiet = 0
186    rx = None
187    flist = None
188    for o, a in opts:
189        if o == '-l': maxlevels = 0
190        if o == '-d': ddir = a
191        if o == '-f': force = 1
192        if o == '-q': quiet = 1
193        if o == '-x':
194            import re
195            rx = re.compile(a)
196        if o == '-i': flist = a
197    if ddir:
198        if len(args) != 1 and not os.path.isdir(args[0]):
199            print "-d destdir require exactly one directory argument"
200            sys.exit(2)
201    success = 1
202    try:
203        if args or flist:
204            try:
205                if flist:
206                    args = expand_args(args, flist)
207            except IOError:
208                success = 0
209            if success:
210                for arg in args:
211                    if os.path.isdir(arg):
212                        if not compile_dir(arg, maxlevels, ddir,
213                                           force, rx, quiet):
214                            success = 0
215                    else:
216                        if not compile_file(arg, ddir, force, rx, quiet):
217                            success = 0
218        else:
219            success = compile_path()
220    except KeyboardInterrupt:
221        print "\n[interrupted]"
222        success = 0
223    return success
224
225if __name__ == '__main__':
226    exit_status = int(not main())
227    sys.exit(exit_status)
228