blob: 69a59b3a9123ce493477a16bc856082f5133538d [file] [log] [blame]
Guido van Rossum548703a1998-03-26 22:14:20 +00001"""Module/script to "compile" all .py files to .pyc (or .pyo) file.
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
13"""
Guido van Rossum5c971671996-07-22 15:23:25 +000014
15import os
Guido van Rossum7ea1d971998-12-22 13:50:33 +000016import stat
Guido van Rossum5c971671996-07-22 15:23:25 +000017import sys
18import py_compile
19
Guido van Rossum7ea1d971998-12-22 13:50:33 +000020def compile_dir(dir, maxlevels=10, ddir=None, force=0):
Guido van Rossum548703a1998-03-26 22:14:20 +000021 """Byte-compile all modules in the given directory tree.
Guido van Rossum5c971671996-07-22 15:23:25 +000022
Guido van Rossum548703a1998-03-26 22:14:20 +000023 Arguments (only dir is required):
24
25 dir: the directory to byte-compile
26 maxlevels: maximum recursion level (default 10)
27 ddir: if given, purported directory name (this is the
28 directory name that will show up in error messages)
Guido van Rossum7ea1d971998-12-22 13:50:33 +000029 force: if 1, force compilation, even if timestamps are up-to-date
Guido van Rossum548703a1998-03-26 22:14:20 +000030
31 """
32 print 'Listing', dir, '...'
33 try:
34 names = os.listdir(dir)
35 except os.error:
36 print "Can't list", dir
37 names = []
38 names.sort()
39 for name in names:
40 fullname = os.path.join(dir, name)
41 if ddir:
42 dfile = os.path.join(ddir, name)
43 else:
44 dfile = None
45 if os.path.isfile(fullname):
46 head, tail = name[:-3], name[-3:]
47 if tail == '.py':
Guido van Rossum7ea1d971998-12-22 13:50:33 +000048 cfile = fullname + (__debug__ and 'c' or 'o')
49 ftime = os.stat(fullname)[stat.ST_MTIME]
50 try: ctime = os.stat(cfile)[stat.ST_MTIME]
51 except os.error: ctime = 0
52 if (ctime > ftime) and not force: continue
Guido van Rossum548703a1998-03-26 22:14:20 +000053 print 'Compiling', fullname, '...'
54 try:
55 py_compile.compile(fullname, None, dfile)
56 except KeyboardInterrupt:
57 raise KeyboardInterrupt
58 except:
59 if type(sys.exc_type) == type(''):
60 exc_type_name = sys.exc_type
61 else: exc_type_name = sys.exc_type.__name__
62 print 'Sorry:', exc_type_name + ':',
63 print sys.exc_value
64 elif maxlevels > 0 and \
65 name != os.curdir and name != os.pardir and \
66 os.path.isdir(fullname) and \
67 not os.path.islink(fullname):
Guido van Rossum7ea1d971998-12-22 13:50:33 +000068 compile_dir(fullname, maxlevels - 1, dfile, force)
Guido van Rossum548703a1998-03-26 22:14:20 +000069
Guido van Rossum7ea1d971998-12-22 13:50:33 +000070def compile_path(skip_curdir=1, maxlevels=0, force=0):
Guido van Rossum548703a1998-03-26 22:14:20 +000071 """Byte-compile all module on sys.path.
72
73 Arguments (all optional):
74
75 skip_curdir: if true, skip current directory (default true)
76 maxlevels: max recursion level (default 0)
Guido van Rossum7ea1d971998-12-22 13:50:33 +000077 force: as for compile_dir() (default 0)
Guido van Rossum548703a1998-03-26 22:14:20 +000078
79 """
80 for dir in sys.path:
81 if (not dir or dir == os.curdir) and skip_curdir:
82 print 'Skipping current directory'
83 else:
Guido van Rossum7ea1d971998-12-22 13:50:33 +000084 compile_dir(dir, maxlevels, None, force)
Guido van Rossum5c971671996-07-22 15:23:25 +000085
86def main():
Guido van Rossum548703a1998-03-26 22:14:20 +000087 """Script main program."""
88 import getopt
89 try:
Guido van Rossum7ea1d971998-12-22 13:50:33 +000090 opts, args = getopt.getopt(sys.argv[1:], 'lfd:')
Guido van Rossum548703a1998-03-26 22:14:20 +000091 except getopt.error, msg:
92 print msg
Guido van Rossum7ea1d971998-12-22 13:50:33 +000093 print "usage: compileall [-l] [-f] [-d destdir] [directory ...]"
Guido van Rossum548703a1998-03-26 22:14:20 +000094 print "-l: don't recurse down"
Guido van Rossum7ea1d971998-12-22 13:50:33 +000095 print "-f: force rebuild even if timestamps are up-to-date"
Guido van Rossum548703a1998-03-26 22:14:20 +000096 print "-d destdir: purported directory name for error messages"
Guido van Rossum7ea1d971998-12-22 13:50:33 +000097 print "if no directory arguments, -l sys.path is assumed"
Guido van Rossum548703a1998-03-26 22:14:20 +000098 sys.exit(2)
99 maxlevels = 10
100 ddir = None
Guido van Rossum7ea1d971998-12-22 13:50:33 +0000101 force = 0
Guido van Rossum548703a1998-03-26 22:14:20 +0000102 for o, a in opts:
103 if o == '-l': maxlevels = 0
104 if o == '-d': ddir = a
Guido van Rossum7ea1d971998-12-22 13:50:33 +0000105 if o == '-f': force = 1
Guido van Rossum548703a1998-03-26 22:14:20 +0000106 if ddir:
107 if len(args) != 1:
108 print "-d destdir require exactly one directory argument"
109 sys.exit(2)
110 try:
111 if args:
112 for dir in args:
Guido van Rossum7ea1d971998-12-22 13:50:33 +0000113 compile_dir(dir, maxlevels, ddir, force)
Guido van Rossum548703a1998-03-26 22:14:20 +0000114 else:
115 compile_path()
116 except KeyboardInterrupt:
117 print "\n[interrupt]"
Guido van Rossum5c971671996-07-22 15:23:25 +0000118
119if __name__ == '__main__':
Guido van Rossum548703a1998-03-26 22:14:20 +0000120 main()