annotate Lib/distutils/ccompiler.py @ 54294:dba767bc3155 legacy-trunk

remove mention of old ctypes version
author Benjamin Peterson <benjamin@python.org>
date Sat, 23 May 2009 20:59:09 +0000
parents b4261da4ea50
children 076db4de037a
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
1 """distutils.ccompiler
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
2
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
3 Contains CCompiler, an abstract base class that defines the interface
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
4 for the Distutils compiler abstraction model."""
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
5
11897
017e592c0fd2 Changed '__rcsid__' to '__revision__'.
Greg Ward <gward@python.net>
parents: 11889
diff changeset
6 __revision__ = "$Id$"
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
7
16674
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
8 import sys, os, re
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
9 from types import *
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
10 from distutils.errors import *
11196
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
11 from distutils.spawn import spawn
13008
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
12 from distutils.file_util import move_file
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
13 from distutils.dir_util import mkpath
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
14 from distutils.dep_util import newer_pairwise, newer_group
13809
f3968dd1711b Added 'execute()' method, a thin wrapper around 'util.execute() (just like
Greg Ward <gward@python.net>
parents: 13725
diff changeset
15 from distutils.util import split_quoted, execute
23668
ca87119255eb Make setup.py less chatty by default.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23272
diff changeset
16 from distutils import log
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
17
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
18 class CCompiler:
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
19 """Abstract base class to define the interface that must be implemented
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
20 by real compiler classes. Also has some utility methods used by
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
21 several compiler classes.
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
22
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
23 The basic idea behind a compiler abstraction class is that each
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
24 instance can be used for all the compile/link steps in building a
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
25 single project. Thus, attributes common to all of those compile and
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
26 link steps -- include directories, macros to define, libraries to link
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
27 against, etc. -- are attributes of the compiler instance. To allow for
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
28 variability in how individual files are treated, most of those
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
29 attributes may be varied on a per-compilation or per-link basis.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
30 """
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
31
11335
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
32 # 'compiler_type' is a class attribute that identifies this class. It
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
33 # keeps code that wants to know what kind of compiler it's dealing with
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
34 # from having to import all possible compiler classes just to do an
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
35 # 'isinstance'. In concrete CCompiler subclasses, 'compiler_type'
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
36 # should really, really be one of the keys of the 'compiler_class'
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
37 # dictionary (see below -- used by the 'new_compiler()' factory
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
38 # function) -- authors of new compiler interface classes are
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
39 # responsible for updating 'compiler_class'!
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
40 compiler_type = None
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
41
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
42 # XXX things not handled by this compiler abstraction model:
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
43 # * client can't provide additional options for a compiler,
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
44 # e.g. warning, optimization, debugging flags. Perhaps this
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
45 # should be the domain of concrete compiler abstraction classes
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
46 # (UnixCCompiler, MSVCCompiler, etc.) -- or perhaps the base
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
47 # class should have methods for the common ones.
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
48 # * can't completely override the include or library searchg
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
49 # path, ie. no "cc -I -Idir1 -Idir2" or "cc -L -Ldir1 -Ldir2".
11196
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
50 # I'm not sure how widely supported this is even by Unix
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
51 # compilers, much less on other platforms. And I'm even less
11196
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
52 # sure how useful it is; maybe for cross-compiling, but
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
53 # support for that is a ways off. (And anyways, cross
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
54 # compilers probably have a dedicated binary with the
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
55 # right paths compiled in. I hope.)
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
56 # * can't do really freaky things with the library list/library
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
57 # dirs, e.g. "-Ldir1 -lfoo -Ldir2 -lfoo" to link against
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
58 # different versions of libfoo.a in different locations. I
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
59 # think this is useless without the ability to null out the
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
60 # library search path anyways.
21267
7a7f557b4d54 Whitespace normalization.
Fred Drake <fdrake@acm.org>
parents: 19498
diff changeset
61
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
62
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
63 # Subclasses that rely on the standard filename generation methods
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
64 # implemented below should override these; see the comment near
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
65 # those methods ('object_filenames()' et. al.) for details:
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
66 src_extensions = None # list of strings
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
67 obj_extension = None # string
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
68 static_lib_extension = None
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
69 shared_lib_extension = None # string
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
70 static_lib_format = None # format string
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
71 shared_lib_format = None # prob. same as static_lib_format
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
72 exe_extension = None # string
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
73
26036
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
74 # Default language settings. language_map is used to detect a source
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
75 # file or Extension target language, checking source filenames.
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
76 # language_order is used to detect the language precedence, when deciding
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
77 # what language to use when mixing source types. For example, if some
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
78 # extension has two files with ".c" extension, and one with ".cpp", it
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
79 # is still linked as c++.
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
80 language_map = {".c" : "c",
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
81 ".cc" : "c++",
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
82 ".cpp" : "c++",
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
83 ".cxx" : "c++",
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
84 ".m" : "objc",
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
85 }
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
86 language_order = ["c++", "objc", "c"]
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
87
11196
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
88 def __init__ (self,
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
89 verbose=0,
11358
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name
Greg Ward <gward@python.net>
parents: 11335
diff changeset
90 dry_run=0,
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name
Greg Ward <gward@python.net>
parents: 11335
diff changeset
91 force=0):
11196
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
92
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
93 self.dry_run = dry_run
11358
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name
Greg Ward <gward@python.net>
parents: 11335
diff changeset
94 self.force = force
25524
c12a4f7a00b7 save the verbose argument as an instance attributes. Subclasses of
Skip Montanaro <skip@pobox.com>
parents: 25512
diff changeset
95 self.verbose = verbose
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
96
11274
efa75c69857d Added 'output_dir' attribute, and 'output_dir' parameter to several method
Greg Ward <gward@python.net>
parents: 11258
diff changeset
97 # 'output_dir': a common output directory for object, library,
efa75c69857d Added 'output_dir' attribute, and 'output_dir' parameter to several method
Greg Ward <gward@python.net>
parents: 11258
diff changeset
98 # shared object, and shared library files
efa75c69857d Added 'output_dir' attribute, and 'output_dir' parameter to several method
Greg Ward <gward@python.net>
parents: 11258
diff changeset
99 self.output_dir = None
efa75c69857d Added 'output_dir' attribute, and 'output_dir' parameter to several method
Greg Ward <gward@python.net>
parents: 11258
diff changeset
100
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
101 # 'macros': a list of macro definitions (or undefinitions). A
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
102 # macro definition is a 2-tuple (name, value), where the value is
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
103 # either a string or None (no explicit value). A macro
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
104 # undefinition is a 1-tuple (name,).
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
105 self.macros = []
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
106
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
107 # 'include_dirs': a list of directories to search for include files
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
108 self.include_dirs = []
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
109
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
110 # 'libraries': a list of libraries to include in any link
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
111 # (library names, not filenames: eg. "foo" not "libfoo.a")
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
112 self.libraries = []
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
113
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
114 # 'library_dirs': a list of directories to search for libraries
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
115 self.library_dirs = []
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
116
11196
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
117 # 'runtime_library_dirs': a list of directories to search for
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
118 # shared libraries/objects at runtime
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
119 self.runtime_library_dirs = []
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
120
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
121 # 'objects': a list of object files (or similar, such as explicitly
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
122 # named library files) to include on any link
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
123 self.objects = []
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
124
13008
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
125 for key in self.executables.keys():
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
126 self.set_executable(key, self.executables[key])
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
127
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
128 # __init__ ()
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
129
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
130
13008
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
131 def set_executables (self, **args):
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
132
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
133 """Define the executables (and options for them) that will be run
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
134 to perform the various stages of compilation. The exact set of
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
135 executables that may be specified here depends on the compiler
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
136 class (via the 'executables' class attribute), but most will have:
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
137 compiler the C/C++ compiler
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
138 linker_so linker used to create shared objects and libraries
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
139 linker_exe linker used to create binary executables
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
140 archiver static library creator
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
141
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
142 On platforms with a command-line (Unix, DOS/Windows), each of these
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
143 is a string that will be split into executable name and (optional)
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
144 list of arguments. (Splitting the string is done similarly to how
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
145 Unix shells operate: words are delimited by spaces, but quotes and
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
146 backslashes can override this. See
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
147 'distutils.util.split_quoted()'.)
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
148 """
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
149
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
150 # Note that some CCompiler implementation classes will define class
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
151 # attributes 'cpp', 'cc', etc. with hard-coded executable names;
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
152 # this is appropriate when a compiler class is for exactly one
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
153 # compiler/OS combination (eg. MSVCCompiler). Other compiler
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
154 # classes (UnixCCompiler, in particular) are driven by information
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
155 # discovered at run-time, since there are many different ways to do
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
156 # basically the same things with Unix C compilers.
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
157
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
158 for key in args.keys():
45413
8a187f562959 Removed uses of dict.has_key() from distutils, and uses of
Guido van Rossum <guido@python.org>
parents: 38369
diff changeset
159 if key not in self.executables:
13008
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
160 raise ValueError, \
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
161 "unknown executable '%s' for class %s" % \
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
162 (key, self.__class__.__name__)
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
163 self.set_executable(key, args[key])
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
164
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
165 # set_executables ()
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
166
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
167 def set_executable(self, key, value):
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
168 if type(value) is StringType:
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
169 setattr(self, key, split_quoted(value))
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
170 else:
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
171 setattr(self, key, value)
21267
7a7f557b4d54 Whitespace normalization.
Fred Drake <fdrake@acm.org>
parents: 19498
diff changeset
172
13008
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
173
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
174 def _find_macro (self, name):
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
175 i = 0
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
176 for defn in self.macros:
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
177 if defn[0] == name:
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
178 return i
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
179 i = i + 1
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
180
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
181 return None
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
182
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
183
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
184 def _check_macro_definitions (self, definitions):
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
185 """Ensures that every element of 'definitions' is a valid macro
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
186 definition, ie. either (name,value) 2-tuple or a (name,) tuple. Do
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
187 nothing if all definitions are OK, raise TypeError otherwise.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
188 """
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
189 for defn in definitions:
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
190 if not (type (defn) is TupleType and
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
191 (len (defn) == 1 or
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
192 (len (defn) == 2 and
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
193 (type (defn[1]) is StringType or defn[1] is None))) and
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
194 type (defn[0]) is StringType):
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
195 raise TypeError, \
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
196 ("invalid macro definition '%s': " % defn) + \
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
197 "must be tuple (string,), (string, string), or " + \
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
198 "(string, None)"
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
199
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
200
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
201 # -- Bookkeeping methods -------------------------------------------
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
202
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
203 def define_macro (self, name, value=None):
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
204 """Define a preprocessor macro for all compilations driven by this
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
205 compiler object. The optional parameter 'value' should be a
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
206 string; if it is not supplied, then the macro will be defined
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
207 without an explicit value and the exact outcome depends on the
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
208 compiler used (XXX true? does ANSI say anything about this?)
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
209 """
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
210 # Delete from the list of macro definitions/undefinitions if
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
211 # already there (so that this one will take precedence).
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
212 i = self._find_macro (name)
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
213 if i is not None:
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
214 del self.macros[i]
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
215
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
216 defn = (name, value)
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
217 self.macros.append (defn)
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
218
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
219
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
220 def undefine_macro (self, name):
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
221 """Undefine a preprocessor macro for all compilations driven by
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
222 this compiler object. If the same macro is defined by
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
223 'define_macro()' and undefined by 'undefine_macro()' the last call
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
224 takes precedence (including multiple redefinitions or
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
225 undefinitions). If the macro is redefined/undefined on a
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
226 per-compilation basis (ie. in the call to 'compile()'), then that
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
227 takes precedence.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
228 """
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
229 # Delete from the list of macro definitions/undefinitions if
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
230 # already there (so that this one will take precedence).
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
231 i = self._find_macro (name)
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
232 if i is not None:
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
233 del self.macros[i]
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
234
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
235 undefn = (name,)
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
236 self.macros.append (undefn)
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
237
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
238
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
239 def add_include_dir (self, dir):
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
240 """Add 'dir' to the list of directories that will be searched for
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
241 header files. The compiler is instructed to search directories in
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
242 the order in which they are supplied by successive calls to
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
243 'add_include_dir()'.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
244 """
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
245 self.include_dirs.append (dir)
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
246
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
247 def set_include_dirs (self, dirs):
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
248 """Set the list of directories that will be searched to 'dirs' (a
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
249 list of strings). Overrides any preceding calls to
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
250 'add_include_dir()'; subsequence calls to 'add_include_dir()' add
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
251 to the list passed to 'set_include_dirs()'. This does not affect
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
252 any list of standard include directories that the compiler may
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
253 search by default.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
254 """
54101
b4261da4ea50 Fix bootstrapping by removing uses of the copy module in distutils
Antoine Pitrou <solipsis@pitrou.net>
parents: 51047
diff changeset
255 self.include_dirs = dirs[:]
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
256
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
257
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
258 def add_library (self, libname):
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
259 """Add 'libname' to the list of libraries that will be included in
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
260 all links driven by this compiler object. Note that 'libname'
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
261 should *not* be the name of a file containing a library, but the
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
262 name of the library itself: the actual filename will be inferred by
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
263 the linker, the compiler, or the compiler class (depending on the
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
264 platform).
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
265
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
266 The linker will be instructed to link against libraries in the
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
267 order they were supplied to 'add_library()' and/or
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
268 'set_libraries()'. It is perfectly valid to duplicate library
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
269 names; the linker will be instructed to link against libraries as
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
270 many times as they are mentioned.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
271 """
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
272 self.libraries.append (libname)
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
273
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
274 def set_libraries (self, libnames):
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
275 """Set the list of libraries to be included in all links driven by
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
276 this compiler object to 'libnames' (a list of strings). This does
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
277 not affect any standard system libraries that the linker may
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
278 include by default.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
279 """
54101
b4261da4ea50 Fix bootstrapping by removing uses of the copy module in distutils
Antoine Pitrou <solipsis@pitrou.net>
parents: 51047
diff changeset
280 self.libraries = libnames[:]
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
281
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
282
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
283 def add_library_dir (self, dir):
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
284 """Add 'dir' to the list of directories that will be searched for
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
285 libraries specified to 'add_library()' and 'set_libraries()'. The
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
286 linker will be instructed to search for libraries in the order they
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
287 are supplied to 'add_library_dir()' and/or 'set_library_dirs()'.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
288 """
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
289 self.library_dirs.append (dir)
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
290
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
291 def set_library_dirs (self, dirs):
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
292 """Set the list of library search directories to 'dirs' (a list of
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
293 strings). This does not affect any standard library search path
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
294 that the linker may search by default.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
295 """
54101
b4261da4ea50 Fix bootstrapping by removing uses of the copy module in distutils
Antoine Pitrou <solipsis@pitrou.net>
parents: 51047
diff changeset
296 self.library_dirs = dirs[:]
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
297
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
298
11196
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
299 def add_runtime_library_dir (self, dir):
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
300 """Add 'dir' to the list of directories that will be searched for
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
301 shared libraries at runtime.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
302 """
11196
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
303 self.runtime_library_dirs.append (dir)
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
304
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
305 def set_runtime_library_dirs (self, dirs):
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
306 """Set the list of directories to search for shared libraries at
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
307 runtime to 'dirs' (a list of strings). This does not affect any
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
308 standard search path that the runtime linker may search by
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
309 default.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
310 """
54101
b4261da4ea50 Fix bootstrapping by removing uses of the copy module in distutils
Antoine Pitrou <solipsis@pitrou.net>
parents: 51047
diff changeset
311 self.runtime_library_dirs = dirs[:]
11196
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
312
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
313
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
314 def add_link_object (self, object):
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
315 """Add 'object' to the list of object files (or analogues, such as
13725
449dd3a00bd7 Fixed a grab-bag of typos spotted by Rob Hooft.
Greg Ward <gward@python.net>
parents: 13413
diff changeset
316 explicitly named library files or the output of "resource
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
317 compilers") to be included in every link driven by this compiler
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
318 object.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
319 """
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
320 self.objects.append (object)
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
321
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
322 def set_link_objects (self, objects):
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
323 """Set the list of object files (or analogues) to be included in
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
324 every link to 'objects'. This does not affect any standard object
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
325 files that the linker may include by default (such as system
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
326 libraries).
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
327 """
54101
b4261da4ea50 Fix bootstrapping by removing uses of the copy module in distutils
Antoine Pitrou <solipsis@pitrou.net>
parents: 51047
diff changeset
328 self.objects = objects[:]
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
329
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
330
23272
582855f6d35b Fix trivial typo.
Thomas Heller <theller@ctypes.org>
parents: 21851
diff changeset
331 # -- Private utility methods --------------------------------------
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
332 # (here for the convenience of subclasses)
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
333
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
334 # Helper method to prep compiler in subclass compile() methods
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
335
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
336 def _setup_compile(self, outdir, macros, incdirs, sources, depends,
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
337 extra):
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
338 """Process arguments and decide which source files to compile.
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
339
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
340 Merges _fix_compile_args() and _prep_compile().
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
341 """
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
342 if outdir is None:
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
343 outdir = self.output_dir
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
344 elif type(outdir) is not StringType:
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
345 raise TypeError, "'output_dir' must be a string or None"
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
346
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
347 if macros is None:
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
348 macros = self.macros
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
349 elif type(macros) is ListType:
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
350 macros = macros + (self.macros or [])
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
351 else:
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
352 raise TypeError, "'macros' (if supplied) must be a list of tuples"
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
353
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
354 if incdirs is None:
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
355 incdirs = self.include_dirs
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
356 elif type(incdirs) in (ListType, TupleType):
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
357 incdirs = list(incdirs) + (self.include_dirs or [])
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
358 else:
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
359 raise TypeError, \
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
360 "'include_dirs' (if supplied) must be a list of strings"
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
361
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
362 if extra is None:
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
363 extra = []
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
364
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
365 # Get the list of expected output (object) files
26821
d6f483fc9e02 Bug #599248: strip directories when building Python. Out-of-tree builds should work again.
Andrew M. Kuchling <amk@amk.ca>
parents: 26285
diff changeset
366 objects = self.object_filenames(sources,
38369
13e0f71a70d5 Fix distutils so that libffi will cross-compile between darwin/x86 and darwin/ppc
Bob Ippolito <bob@redivi.com>
parents: 33965
diff changeset
367 strip_dir=0,
26821
d6f483fc9e02 Bug #599248: strip directories when building Python. Out-of-tree builds should work again.
Andrew M. Kuchling <amk@amk.ca>
parents: 26285
diff changeset
368 output_dir=outdir)
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
369 assert len(objects) == len(sources)
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
370
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
371 # XXX should redo this code to eliminate skip_source entirely.
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
372 # XXX instead create build and issue skip messages inline
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
373
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
374 if self.force:
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
375 skip_source = {} # rebuild everything
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
376 for source in sources:
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
377 skip_source[source] = 0
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
378 elif depends is None:
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
379 # If depends is None, figure out which source files we
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
380 # have to recompile according to a simplistic check. We
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
381 # just compare the source and object file, no deep
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
382 # dependency checking involving header files.
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
383 skip_source = {} # rebuild everything
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
384 for source in sources: # no wait, rebuild nothing
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
385 skip_source[source] = 1
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
386
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
387 n_sources, n_objects = newer_pairwise(sources, objects)
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
388 for source in n_sources: # no really, only rebuild what's
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
389 skip_source[source] = 0 # out-of-date
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
390 else:
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
391 # If depends is a list of files, then do a different
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
392 # simplistic check. Assume that each object depends on
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
393 # its source and all files in the depends list.
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
394 skip_source = {}
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
395 # L contains all the depends plus a spot at the end for a
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
396 # particular source file
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
397 L = depends[:] + [None]
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
398 for i in range(len(objects)):
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
399 source = sources[i]
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
400 L[-1] = source
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
401 if newer_group(L, objects[i]):
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
402 skip_source[source] = 0
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
403 else:
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
404 skip_source[source] = 1
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
405
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
406 pp_opts = gen_preprocess_options(macros, incdirs)
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
407
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
408 build = {}
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
409 for i in range(len(sources)):
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
410 src = sources[i]
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
411 obj = objects[i]
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
412 ext = os.path.splitext(src)[1]
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
413 self.mkpath(os.path.dirname(obj))
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
414 if skip_source[src]:
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
415 log.debug("skipping %s (%s up-to-date)", src, obj)
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
416 else:
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
417 build[obj] = src, ext
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
418
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
419 return macros, objects, extra, pp_opts, build
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
420
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
421 def _get_cc_args(self, pp_opts, debug, before):
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
422 # works for unixccompiler, emxccompiler, cygwinccompiler
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
423 cc_args = pp_opts + ['-c']
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
424 if debug:
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
425 cc_args[:0] = ['-g']
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
426 if before:
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
427 cc_args[:0] = before
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
428 return cc_args
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
429
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
430 def _fix_compile_args (self, output_dir, macros, include_dirs):
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
431 """Typecheck and fix-up some of the arguments to the 'compile()'
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
432 method, and return fixed-up values. Specifically: if 'output_dir'
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
433 is None, replaces it with 'self.output_dir'; ensures that 'macros'
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
434 is a list, and augments it with 'self.macros'; ensures that
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
435 'include_dirs' is a list, and augments it with 'self.include_dirs'.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
436 Guarantees that the returned values are of the correct type,
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
437 i.e. for 'output_dir' either string or None, and for 'macros' and
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
438 'include_dirs' either list or None.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
439 """
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
440 if output_dir is None:
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
441 output_dir = self.output_dir
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
442 elif type (output_dir) is not StringType:
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
443 raise TypeError, "'output_dir' must be a string or None"
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
444
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
445 if macros is None:
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
446 macros = self.macros
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
447 elif type (macros) is ListType:
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
448 macros = macros + (self.macros or [])
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
449 else:
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
450 raise TypeError, "'macros' (if supplied) must be a list of tuples"
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
451
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
452 if include_dirs is None:
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
453 include_dirs = self.include_dirs
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
454 elif type (include_dirs) in (ListType, TupleType):
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
455 include_dirs = list (include_dirs) + (self.include_dirs or [])
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
456 else:
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
457 raise TypeError, \
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
458 "'include_dirs' (if supplied) must be a list of strings"
21267
7a7f557b4d54 Whitespace normalization.
Fred Drake <fdrake@acm.org>
parents: 19498
diff changeset
459
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
460 return output_dir, macros, include_dirs
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
461
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
462 # _fix_compile_args ()
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
463
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
464
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
465 def _prep_compile(self, sources, output_dir, depends=None):
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
466 """Decide which souce files must be recompiled.
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
467
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
468 Determine the list of object files corresponding to 'sources',
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
469 and figure out which ones really need to be recompiled.
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
470 Return a list of all object files and a dictionary telling
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
471 which source files can be skipped.
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
472 """
21267
7a7f557b4d54 Whitespace normalization.
Fred Drake <fdrake@acm.org>
parents: 19498
diff changeset
473 # Get the list of expected output (object) files
38369
13e0f71a70d5 Fix distutils so that libffi will cross-compile between darwin/x86 and darwin/ppc
Bob Ippolito <bob@redivi.com>
parents: 33965
diff changeset
474 objects = self.object_filenames(sources, output_dir=output_dir)
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
475 assert len(objects) == len(sources)
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
476
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
477 if self.force:
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
478 skip_source = {} # rebuild everything
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
479 for source in sources:
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
480 skip_source[source] = 0
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
481 elif depends is None:
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
482 # If depends is None, figure out which source files we
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
483 # have to recompile according to a simplistic check. We
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
484 # just compare the source and object file, no deep
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
485 # dependency checking involving header files.
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
486 skip_source = {} # rebuild everything
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
487 for source in sources: # no wait, rebuild nothing
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
488 skip_source[source] = 1
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
489
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
490 n_sources, n_objects = newer_pairwise(sources, objects)
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
491 for source in n_sources: # no really, only rebuild what's
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
492 skip_source[source] = 0 # out-of-date
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
493 else:
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
494 # If depends is a list of files, then do a different
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
495 # simplistic check. Assume that each object depends on
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
496 # its source and all files in the depends list.
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
497 skip_source = {}
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
498 # L contains all the depends plus a spot at the end for a
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
499 # particular source file
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
500 L = depends[:] + [None]
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
501 for i in range(len(objects)):
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
502 source = sources[i]
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
503 L[-1] = source
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
504 if newer_group(L, objects[i]):
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
505 skip_source[source] = 0
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
506 else:
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
507 skip_source[source] = 1
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
508
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
509 return objects, skip_source
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
510
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
511 # _prep_compile ()
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
512
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
513
12054
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
514 def _fix_object_args (self, objects, output_dir):
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
515 """Typecheck and fix up some arguments supplied to various methods.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
516 Specifically: ensure that 'objects' is a list; if output_dir is
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
517 None, replace with self.output_dir. Return fixed versions of
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
518 'objects' and 'output_dir'.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
519 """
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
520 if type (objects) not in (ListType, TupleType):
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
521 raise TypeError, \
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
522 "'objects' must be a list or tuple of strings"
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
523 objects = list (objects)
21267
7a7f557b4d54 Whitespace normalization.
Fred Drake <fdrake@acm.org>
parents: 19498
diff changeset
524
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
525 if output_dir is None:
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
526 output_dir = self.output_dir
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
527 elif type (output_dir) is not StringType:
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
528 raise TypeError, "'output_dir' must be a string or None"
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
529
12054
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
530 return (objects, output_dir)
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
531
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
532
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
533 def _fix_lib_args (self, libraries, library_dirs, runtime_library_dirs):
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
534 """Typecheck and fix up some of the arguments supplied to the
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
535 'link_*' methods. Specifically: ensure that all arguments are
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
536 lists, and augment them with their permanent versions
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
537 (eg. 'self.libraries' augments 'libraries'). Return a tuple with
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
538 fixed versions of all arguments.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
539 """
12054
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
540 if libraries is None:
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
541 libraries = self.libraries
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
542 elif type (libraries) in (ListType, TupleType):
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
543 libraries = list (libraries) + (self.libraries or [])
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
544 else:
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
545 raise TypeError, \
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
546 "'libraries' (if supplied) must be a list of strings"
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
547
12054
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
548 if library_dirs is None:
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
549 library_dirs = self.library_dirs
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
550 elif type (library_dirs) in (ListType, TupleType):
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
551 library_dirs = list (library_dirs) + (self.library_dirs or [])
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
552 else:
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
553 raise TypeError, \
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
554 "'library_dirs' (if supplied) must be a list of strings"
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
555
12054
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
556 if runtime_library_dirs is None:
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
557 runtime_library_dirs = self.runtime_library_dirs
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
558 elif type (runtime_library_dirs) in (ListType, TupleType):
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
559 runtime_library_dirs = (list (runtime_library_dirs) +
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
560 (self.runtime_library_dirs or []))
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
561 else:
12054
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
562 raise TypeError, \
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
563 "'runtime_library_dirs' (if supplied) " + \
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
564 "must be a list of strings"
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
565
12054
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
566 return (libraries, library_dirs, runtime_library_dirs)
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
567
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
568 # _fix_lib_args ()
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
569
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
570
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
571 def _need_link (self, objects, output_file):
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
572 """Return true if we need to relink the files listed in 'objects'
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
573 to recreate 'output_file'.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
574 """
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
575 if self.force:
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
576 return 1
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
577 else:
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
578 if self.dry_run:
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
579 newer = newer_group (objects, output_file, missing='newer')
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
580 else:
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
581 newer = newer_group (objects, output_file)
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
582 return newer
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
583
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
584 # _need_link ()
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
585
26036
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
586 def detect_language (self, sources):
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
587 """Detect the language of a given file, or list of files. Uses
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
588 language_map, and language_order to do the job.
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
589 """
26049
5819c4439ba2 Repair inconsistent use of tabs and spaces.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 26036
diff changeset
590 if type(sources) is not ListType:
26036
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
591 sources = [sources]
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
592 lang = None
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
593 index = len(self.language_order)
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
594 for source in sources:
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
595 base, ext = os.path.splitext(source)
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
596 extlang = self.language_map.get(ext)
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
597 try:
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
598 extindex = self.language_order.index(extlang)
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
599 if extindex < index:
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
600 lang = extlang
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
601 index = extindex
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
602 except ValueError:
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
603 pass
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
604 return lang
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
605
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
606 # detect_language ()
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
607
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
608 # -- Worker methods ------------------------------------------------
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
609 # (must be implemented by subclasses)
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
610
12977
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented
Greg Ward <gward@python.net>
parents: 12869
diff changeset
611 def preprocess (self,
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented
Greg Ward <gward@python.net>
parents: 12869
diff changeset
612 source,
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented
Greg Ward <gward@python.net>
parents: 12869
diff changeset
613 output_file=None,
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented
Greg Ward <gward@python.net>
parents: 12869
diff changeset
614 macros=None,
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented
Greg Ward <gward@python.net>
parents: 12869
diff changeset
615 include_dirs=None,
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented
Greg Ward <gward@python.net>
parents: 12869
diff changeset
616 extra_preargs=None,
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented
Greg Ward <gward@python.net>
parents: 12869
diff changeset
617 extra_postargs=None):
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented
Greg Ward <gward@python.net>
parents: 12869
diff changeset
618 """Preprocess a single C/C++ source file, named in 'source'.
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented
Greg Ward <gward@python.net>
parents: 12869
diff changeset
619 Output will be written to file named 'output_file', or stdout if
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented
Greg Ward <gward@python.net>
parents: 12869
diff changeset
620 'output_file' not supplied. 'macros' is a list of macro
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented
Greg Ward <gward@python.net>
parents: 12869
diff changeset
621 definitions as for 'compile()', which will augment the macros set
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented
Greg Ward <gward@python.net>
parents: 12869
diff changeset
622 with 'define_macro()' and 'undefine_macro()'. 'include_dirs' is a
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented
Greg Ward <gward@python.net>
parents: 12869
diff changeset
623 list of directory names that will be added to the default list.
13008
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
624
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables
Greg Ward <gward@python.net>
parents: 13005
diff changeset
625 Raises PreprocessError on failure.
12977
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented
Greg Ward <gward@python.net>
parents: 12869
diff changeset
626 """
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented
Greg Ward <gward@python.net>
parents: 12869
diff changeset
627 pass
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented
Greg Ward <gward@python.net>
parents: 12869
diff changeset
628
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
629 def compile(self, sources, output_dir=None, macros=None,
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
630 include_dirs=None, debug=0, extra_preargs=None,
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
631 extra_postargs=None, depends=None):
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
632 """Compile one or more source files.
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
633
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
634 'sources' must be a list of filenames, most likely C/C++
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
635 files, but in reality anything that can be handled by a
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
636 particular compiler and compiler class (eg. MSVCCompiler can
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
637 handle resource files in 'sources'). Return a list of object
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
638 filenames, one per source filename in 'sources'. Depending on
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
639 the implementation, not all source files will necessarily be
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
640 compiled, but all corresponding object filenames will be
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
641 returned.
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
642
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
643 If 'output_dir' is given, object files will be put under it, while
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
644 retaining their original path component. That is, "foo/bar.c"
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
645 normally compiles to "foo/bar.o" (for a Unix implementation); if
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
646 'output_dir' is "build", then it would compile to
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
647 "build/foo/bar.o".
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
648
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
649 'macros', if given, must be a list of macro definitions. A macro
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
650 definition is either a (name, value) 2-tuple or a (name,) 1-tuple.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
651 The former defines a macro; if the value is None, the macro is
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
652 defined without an explicit value. The 1-tuple case undefines a
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
653 macro. Later definitions/redefinitions/ undefinitions take
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
654 precedence.
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
655
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
656 'include_dirs', if given, must be a list of strings, the
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
657 directories to add to the default include file search path for this
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
658 compilation only.
11728
985723498b1b Added 'debug' flag to compile and link method signatures.
Greg Ward <gward@python.net>
parents: 11646
diff changeset
659
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
660 'debug' is a boolean; if true, the compiler will be instructed to
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
661 output debug symbols in (or alongside) the object file(s).
11335
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
662
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
663 'extra_preargs' and 'extra_postargs' are implementation- dependent.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
664 On platforms that have the notion of a command-line (e.g. Unix,
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
665 DOS/Windows), they are most likely lists of strings: extra
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
666 command-line arguments to prepand/append to the compiler command
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
667 line. On other platforms, consult the implementation class
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
668 documentation. In any event, they are intended as an escape hatch
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
669 for those occasions when the abstract compiler framework doesn't
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
670 cut the mustard.
12790
f8c1c5b7dc9f Changed to catch compile/link failures and raise CompileError, LibError,
Greg Ward <gward@python.net>
parents: 12718
diff changeset
671
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
672 'depends', if given, is a list of filenames that all targets
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
673 depend on. If a source file is older than any file in
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
674 depends, then the source file will be recompiled. This
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
675 supports dependency tracking, but only at a coarse
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
676 granularity.
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
677
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
678 Raises CompileError on failure.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
679 """
23912
075f755a65da Add a default implementation of compile() to the base class.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23821
diff changeset
680
075f755a65da Add a default implementation of compile() to the base class.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23821
diff changeset
681 # A concrete compiler class can either override this method
075f755a65da Add a default implementation of compile() to the base class.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23821
diff changeset
682 # entirely or implement _compile().
32736
c3a096bfbd6b Whitespace normalization, via reindent.py.
Tim Peters <tim.peters@gmail.com>
parents: 31129
diff changeset
683
23912
075f755a65da Add a default implementation of compile() to the base class.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23821
diff changeset
684 macros, objects, extra_postargs, pp_opts, build = \
075f755a65da Add a default implementation of compile() to the base class.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23821
diff changeset
685 self._setup_compile(output_dir, macros, include_dirs, sources,
075f755a65da Add a default implementation of compile() to the base class.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23821
diff changeset
686 depends, extra_postargs)
075f755a65da Add a default implementation of compile() to the base class.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23821
diff changeset
687 cc_args = self._get_cc_args(pp_opts, debug, extra_preargs)
075f755a65da Add a default implementation of compile() to the base class.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23821
diff changeset
688
31129
be9ef9b92d61 Compile the files in the same order they are passed to the compiler.
Thomas Heller <theller@ctypes.org>
parents: 28801
diff changeset
689 for obj in objects:
be9ef9b92d61 Compile the files in the same order they are passed to the compiler.
Thomas Heller <theller@ctypes.org>
parents: 28801
diff changeset
690 try:
be9ef9b92d61 Compile the files in the same order they are passed to the compiler.
Thomas Heller <theller@ctypes.org>
parents: 28801
diff changeset
691 src, ext = build[obj]
be9ef9b92d61 Compile the files in the same order they are passed to the compiler.
Thomas Heller <theller@ctypes.org>
parents: 28801
diff changeset
692 except KeyError:
be9ef9b92d61 Compile the files in the same order they are passed to the compiler.
Thomas Heller <theller@ctypes.org>
parents: 28801
diff changeset
693 continue
23912
075f755a65da Add a default implementation of compile() to the base class.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23821
diff changeset
694 self._compile(obj, src, ext, cc_args, extra_postargs, pp_opts)
075f755a65da Add a default implementation of compile() to the base class.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23821
diff changeset
695
075f755a65da Add a default implementation of compile() to the base class.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23821
diff changeset
696 # Return *all* object filenames, not just the ones we just built.
075f755a65da Add a default implementation of compile() to the base class.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23821
diff changeset
697 return objects
075f755a65da Add a default implementation of compile() to the base class.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23821
diff changeset
698
075f755a65da Add a default implementation of compile() to the base class.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23821
diff changeset
699 def _compile(self, obj, src, ext, cc_args, extra_postargs, pp_opts):
075f755a65da Add a default implementation of compile() to the base class.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23821
diff changeset
700 """Compile 'src' to product 'obj'."""
32736
c3a096bfbd6b Whitespace normalization, via reindent.py.
Tim Peters <tim.peters@gmail.com>
parents: 31129
diff changeset
701
23912
075f755a65da Add a default implementation of compile() to the base class.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23821
diff changeset
702 # A concrete compiler class that does not override compile()
075f755a65da Add a default implementation of compile() to the base class.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23821
diff changeset
703 # should implement _compile().
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
704 pass
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
705
11955
6e3c81bd8291 Renamed 'link_static_lib() to 'create_static_lib()'.
Greg Ward <gward@python.net>
parents: 11915
diff changeset
706 def create_static_lib (self,
6e3c81bd8291 Renamed 'link_static_lib() to 'create_static_lib()'.
Greg Ward <gward@python.net>
parents: 11915
diff changeset
707 objects,
6e3c81bd8291 Renamed 'link_static_lib() to 'create_static_lib()'.
Greg Ward <gward@python.net>
parents: 11915
diff changeset
708 output_libname,
6e3c81bd8291 Renamed 'link_static_lib() to 'create_static_lib()'.
Greg Ward <gward@python.net>
parents: 11915
diff changeset
709 output_dir=None,
26036
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
710 debug=0,
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
711 target_lang=None):
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
712 """Link a bunch of stuff together to create a static library file.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
713 The "bunch of stuff" consists of the list of object files supplied
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
714 as 'objects', the extra object files supplied to
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
715 'add_link_object()' and/or 'set_link_objects()', the libraries
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
716 supplied to 'add_library()' and/or 'set_libraries()', and the
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
717 libraries supplied as 'libraries' (if any).
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
718
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
719 'output_libname' should be a library name, not a filename; the
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
720 filename will be inferred from the library name. 'output_dir' is
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
721 the directory where the library file will be put.
11728
985723498b1b Added 'debug' flag to compile and link method signatures.
Greg Ward <gward@python.net>
parents: 11646
diff changeset
722
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
723 'debug' is a boolean; if true, debugging information will be
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
724 included in the library (note that on most platforms, it is the
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
725 compile step where this matters: the 'debug' flag is included here
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
726 just for consistency).
12790
f8c1c5b7dc9f Changed to catch compile/link failures and raise CompileError, LibError,
Greg Ward <gward@python.net>
parents: 12718
diff changeset
727
26036
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
728 'target_lang' is the target language for which the given objects
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
729 are being compiled. This allows specific linkage time treatment of
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
730 certain languages.
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
731
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
732 Raises LibError on failure.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
733 """
11728
985723498b1b Added 'debug' flag to compile and link method signatures.
Greg Ward <gward@python.net>
parents: 11646
diff changeset
734 pass
21267
7a7f557b4d54 Whitespace normalization.
Fred Drake <fdrake@acm.org>
parents: 19498
diff changeset
735
11728
985723498b1b Added 'debug' flag to compile and link method signatures.
Greg Ward <gward@python.net>
parents: 11646
diff changeset
736
14890
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
737 # values for target_desc parameter in link()
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
738 SHARED_OBJECT = "shared_object"
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
739 SHARED_LIBRARY = "shared_library"
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
740 EXECUTABLE = "executable"
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
741
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
742 def link (self,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
743 target_desc,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
744 objects,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
745 output_filename,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
746 output_dir=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
747 libraries=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
748 library_dirs=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
749 runtime_library_dirs=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
750 export_symbols=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
751 debug=0,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
752 extra_preargs=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
753 extra_postargs=None,
26036
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
754 build_temp=None,
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
755 target_lang=None):
14890
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
756 """Link a bunch of stuff together to create an executable or
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
757 shared library file.
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
758
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
759 The "bunch of stuff" consists of the list of object files supplied
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
760 as 'objects'. 'output_filename' should be a filename. If
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
761 'output_dir' is supplied, 'output_filename' is relative to it
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
762 (i.e. 'output_filename' can provide directory components if
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
763 needed).
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
764
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
765 'libraries' is a list of libraries to link against. These are
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
766 library names, not filenames, since they're translated into
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
767 filenames in a platform-specific way (eg. "foo" becomes "libfoo.a"
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
768 on Unix and "foo.lib" on DOS/Windows). However, they can include a
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
769 directory component, which means the linker will look in that
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
770 specific directory rather than searching all the normal locations.
11358
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name
Greg Ward <gward@python.net>
parents: 11335
diff changeset
771
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
772 'library_dirs', if supplied, should be a list of directories to
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
773 search for libraries that were specified as bare library names
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
774 (ie. no directory component). These are on top of the system
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
775 default and those supplied to 'add_library_dir()' and/or
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
776 'set_library_dirs()'. 'runtime_library_dirs' is a list of
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
777 directories that will be embedded into the shared library and used
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
778 to search for other shared libraries that *it* depends on at
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
779 run-time. (This may only be relevant on Unix.)
12717
0a6af59ebffd Added support for the 'export_symbols' parameter to 'link_shared_object()'
Greg Ward <gward@python.net>
parents: 12054
diff changeset
780
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
781 'export_symbols' is a list of symbols that the shared library will
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
782 export. (This appears to be relevant only on Windows.)
11335
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
783
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
784 'debug' is as for 'compile()' and 'create_static_lib()', with the
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
785 slight distinction that it actually matters on most platforms (as
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
786 opposed to 'create_static_lib()', which includes a 'debug' flag
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
787 mostly for form's sake).
11728
985723498b1b Added 'debug' flag to compile and link method signatures.
Greg Ward <gward@python.net>
parents: 11646
diff changeset
788
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
789 'extra_preargs' and 'extra_postargs' are as for 'compile()' (except
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
790 of course that they supply command-line arguments for the
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
791 particular linker being used).
12790
f8c1c5b7dc9f Changed to catch compile/link failures and raise CompileError, LibError,
Greg Ward <gward@python.net>
parents: 12718
diff changeset
792
26036
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
793 'target_lang' is the target language for which the given objects
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
794 are being compiled. This allows specific linkage time treatment of
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
795 certain languages.
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
796
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
797 Raises LinkError on failure.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
798 """
14890
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
799 raise NotImplementedError
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
800
21267
7a7f557b4d54 Whitespace normalization.
Fred Drake <fdrake@acm.org>
parents: 19498
diff changeset
801
14891
e4641d193220 Remove deprecation warnings on old 'link_*()' methods, ie. they're not
Greg Ward <gward@python.net>
parents: 14890
diff changeset
802 # Old 'link_*()' methods, rewritten to use the new 'link()' method.
14890
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
803
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
804 def link_shared_lib (self,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
805 objects,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
806 output_libname,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
807 output_dir=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
808 libraries=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
809 library_dirs=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
810 runtime_library_dirs=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
811 export_symbols=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
812 debug=0,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
813 extra_preargs=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
814 extra_postargs=None,
26036
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
815 build_temp=None,
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
816 target_lang=None):
21267
7a7f557b4d54 Whitespace normalization.
Fred Drake <fdrake@acm.org>
parents: 19498
diff changeset
817 self.link(CCompiler.SHARED_LIBRARY, objects,
14890
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
818 self.library_filename(output_libname, lib_type='shared'),
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
819 output_dir,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
820 libraries, library_dirs, runtime_library_dirs,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
821 export_symbols, debug,
26036
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
822 extra_preargs, extra_postargs, build_temp, target_lang)
21267
7a7f557b4d54 Whitespace normalization.
Fred Drake <fdrake@acm.org>
parents: 19498
diff changeset
823
11335
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
824
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
825 def link_shared_object (self,
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
826 objects,
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
827 output_filename,
11274
efa75c69857d Added 'output_dir' attribute, and 'output_dir' parameter to several method
Greg Ward <gward@python.net>
parents: 11258
diff changeset
828 output_dir=None,
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
829 libraries=None,
11245
854b801253f0 Patch from Perry Stoll:
Greg Ward <gward@python.net>
parents: 11196
diff changeset
830 library_dirs=None,
12054
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
831 runtime_library_dirs=None,
12717
0a6af59ebffd Added support for the 'export_symbols' parameter to 'link_shared_object()'
Greg Ward <gward@python.net>
parents: 12054
diff changeset
832 export_symbols=None,
11728
985723498b1b Added 'debug' flag to compile and link method signatures.
Greg Ward <gward@python.net>
parents: 11646
diff changeset
833 debug=0,
11335
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
834 extra_preargs=None,
13045
72058dc7d545 Lyle Johnson: added 'build_temp' parameter to 'link_shared_{lib,object}()'
Greg Ward <gward@python.net>
parents: 13008
diff changeset
835 extra_postargs=None,
26036
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
836 build_temp=None,
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
837 target_lang=None):
14890
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
838 self.link(CCompiler.SHARED_OBJECT, objects,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
839 output_filename, output_dir,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
840 libraries, library_dirs, runtime_library_dirs,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
841 export_symbols, debug,
26036
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
842 extra_preargs, extra_postargs, build_temp, target_lang)
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
843
11196
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
844
11646
472a17f2ca9f Removed a bunch of irrelevant parameters from 'link_static_lib()' signature.
Greg Ward <gward@python.net>
parents: 11547
diff changeset
845 def link_executable (self,
472a17f2ca9f Removed a bunch of irrelevant parameters from 'link_static_lib()' signature.
Greg Ward <gward@python.net>
parents: 11547
diff changeset
846 objects,
472a17f2ca9f Removed a bunch of irrelevant parameters from 'link_static_lib()' signature.
Greg Ward <gward@python.net>
parents: 11547
diff changeset
847 output_progname,
472a17f2ca9f Removed a bunch of irrelevant parameters from 'link_static_lib()' signature.
Greg Ward <gward@python.net>
parents: 11547
diff changeset
848 output_dir=None,
472a17f2ca9f Removed a bunch of irrelevant parameters from 'link_static_lib()' signature.
Greg Ward <gward@python.net>
parents: 11547
diff changeset
849 libraries=None,
472a17f2ca9f Removed a bunch of irrelevant parameters from 'link_static_lib()' signature.
Greg Ward <gward@python.net>
parents: 11547
diff changeset
850 library_dirs=None,
12054
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_*()' methods.
Greg Ward <gward@python.net>
parents: 12016
diff changeset
851 runtime_library_dirs=None,
11728
985723498b1b Added 'debug' flag to compile and link method signatures.
Greg Ward <gward@python.net>
parents: 11646
diff changeset
852 debug=0,
11646
472a17f2ca9f Removed a bunch of irrelevant parameters from 'link_static_lib()' signature.
Greg Ward <gward@python.net>
parents: 11547
diff changeset
853 extra_preargs=None,
26036
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
854 extra_postargs=None,
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
855 target_lang=None):
21267
7a7f557b4d54 Whitespace normalization.
Fred Drake <fdrake@acm.org>
parents: 19498
diff changeset
856 self.link(CCompiler.EXECUTABLE, objects,
14891
e4641d193220 Remove deprecation warnings on old 'link_*()' methods, ie. they're not
Greg Ward <gward@python.net>
parents: 14890
diff changeset
857 self.executable_filename(output_progname), output_dir,
21267
7a7f557b4d54 Whitespace normalization.
Fred Drake <fdrake@acm.org>
parents: 19498
diff changeset
858 libraries, library_dirs, runtime_library_dirs, None,
26036
771b6f521b95 This patch fixes the following bugs:
Gustavo Niemeyer <gustavo@niemeyer.net>
parents: 25524
diff changeset
859 debug, extra_preargs, extra_postargs, None, target_lang)
11646
472a17f2ca9f Removed a bunch of irrelevant parameters from 'link_static_lib()' signature.
Greg Ward <gward@python.net>
parents: 11547
diff changeset
860
472a17f2ca9f Removed a bunch of irrelevant parameters from 'link_static_lib()' signature.
Greg Ward <gward@python.net>
parents: 11547
diff changeset
861
12718
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be
Greg Ward <gward@python.net>
parents: 12717
diff changeset
862 # -- Miscellaneous methods -----------------------------------------
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be
Greg Ward <gward@python.net>
parents: 12717
diff changeset
863 # These are all used by the 'gen_lib_options() function; there is
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be
Greg Ward <gward@python.net>
parents: 12717
diff changeset
864 # no appropriate default implementation so subclasses should
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be
Greg Ward <gward@python.net>
parents: 12717
diff changeset
865 # implement all of these.
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be
Greg Ward <gward@python.net>
parents: 12717
diff changeset
866
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be
Greg Ward <gward@python.net>
parents: 12717
diff changeset
867 def library_dir_option (self, dir):
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
868 """Return the compiler option to add 'dir' to the list of
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
869 directories searched for libraries.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
870 """
12718
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be
Greg Ward <gward@python.net>
parents: 12717
diff changeset
871 raise NotImplementedError
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be
Greg Ward <gward@python.net>
parents: 12717
diff changeset
872
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be
Greg Ward <gward@python.net>
parents: 12717
diff changeset
873 def runtime_library_dir_option (self, dir):
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
874 """Return the compiler option to add 'dir' to the list of
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
875 directories searched for runtime libraries.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
876 """
12718
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be
Greg Ward <gward@python.net>
parents: 12717
diff changeset
877 raise NotImplementedError
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be
Greg Ward <gward@python.net>
parents: 12717
diff changeset
878
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be
Greg Ward <gward@python.net>
parents: 12717
diff changeset
879 def library_option (self, lib):
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be
Greg Ward <gward@python.net>
parents: 12717
diff changeset
880 """Return the compiler option to add 'dir' to the list of libraries
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
881 linked into the shared library or executable.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
882 """
12718
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be
Greg Ward <gward@python.net>
parents: 12717
diff changeset
883 raise NotImplementedError
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be
Greg Ward <gward@python.net>
parents: 12717
diff changeset
884
28801
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
885 def has_function(self, funcname,
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
886 includes=None,
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
887 include_dirs=None,
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
888 libraries=None,
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
889 library_dirs=None):
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
890 """Return a boolean indicating whether funcname is supported on
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
891 the current platform. The optional arguments can be used to
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
892 augment the compilation environment.
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
893 """
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
894
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
895 # this can't be included at module scope because it tries to
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
896 # import math which might not be available at that point - maybe
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
897 # the necessary logic should just be inlined?
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
898 import tempfile
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
899 if includes is None:
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
900 includes = []
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
901 if include_dirs is None:
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
902 include_dirs = []
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
903 if libraries is None:
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
904 libraries = []
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
905 if library_dirs is None:
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
906 library_dirs = []
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
907 fd, fname = tempfile.mkstemp(".c", funcname, text=True)
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
908 f = os.fdopen(fd, "w")
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
909 for incl in includes:
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
910 f.write("""#include "%s"\n""" % incl)
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
911 f.write("""\
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
912 main (int argc, char **argv) {
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
913 %s();
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
914 }
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
915 """ % funcname)
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
916 f.close()
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
917 try:
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
918 objects = self.compile([fname], include_dirs=include_dirs)
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
919 except CompileError:
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
920 return False
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
921
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
922 try:
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
923 self.link_executable(objects, "a.out",
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
924 libraries=libraries,
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
925 library_dirs=library_dirs)
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
926 except (LinkError, TypeError):
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
927 return False
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
928 return True
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the
Skip Montanaro <skip@pobox.com>
parents: 28078
diff changeset
929
13843
00a5c806cf7c Added 'debug' flag to 'find_library_file()'.
Greg Ward <gward@python.net>
parents: 13809
diff changeset
930 def find_library_file (self, dirs, lib, debug=0):
12718
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be
Greg Ward <gward@python.net>
parents: 12717
diff changeset
931 """Search the specified list of directories for a static or shared
13843
00a5c806cf7c Added 'debug' flag to 'find_library_file()'.
Greg Ward <gward@python.net>
parents: 13809
diff changeset
932 library file 'lib' and return the full path to that file. If
00a5c806cf7c Added 'debug' flag to 'find_library_file()'.
Greg Ward <gward@python.net>
parents: 13809
diff changeset
933 'debug' true, look for a debugging version (if that makes sense on
00a5c806cf7c Added 'debug' flag to 'find_library_file()'.
Greg Ward <gward@python.net>
parents: 13809
diff changeset
934 the current platform). Return None if 'lib' wasn't found in any of
00a5c806cf7c Added 'debug' flag to 'find_library_file()'.
Greg Ward <gward@python.net>
parents: 13809
diff changeset
935 the specified directories.
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
936 """
12718
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be
Greg Ward <gward@python.net>
parents: 12717
diff changeset
937 raise NotImplementedError
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be
Greg Ward <gward@python.net>
parents: 12717
diff changeset
938
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
939 # -- Filename generation methods -----------------------------------
11274
efa75c69857d Added 'output_dir' attribute, and 'output_dir' parameter to several method
Greg Ward <gward@python.net>
parents: 11258
diff changeset
940
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
941 # The default implementation of the filename generating methods are
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
942 # prejudiced towards the Unix/DOS/Windows view of the world:
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
943 # * object files are named by replacing the source file extension
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
944 # (eg. .c/.cpp -> .o/.obj)
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
945 # * library files (shared or static) are named by plugging the
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
946 # library name and extension into a format string, eg.
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
947 # "lib%s.%s" % (lib_name, ".a") for Unix static libraries
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
948 # * executables are named by appending an extension (possibly
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
949 # empty) to the program name: eg. progname + ".exe" for
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
950 # Windows
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
951 #
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
952 # To reduce redundant code, these methods expect to find
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
953 # several attributes in the current object (presumably defined
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
954 # as class attributes):
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
955 # * src_extensions -
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
956 # list of C/C++ source file extensions, eg. ['.c', '.cpp']
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
957 # * obj_extension -
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
958 # object file extension, eg. '.o' or '.obj'
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
959 # * static_lib_extension -
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
960 # extension for static library files, eg. '.a' or '.lib'
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
961 # * shared_lib_extension -
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
962 # extension for shared library/object files, eg. '.so', '.dll'
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
963 # * static_lib_format -
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
964 # format string for generating static library filenames,
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
965 # eg. 'lib%s.%s' or '%s.%s'
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
966 # * shared_lib_format
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
967 # format string for generating shared library filenames
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
968 # (probably same as static_lib_format, since the extension
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
969 # is one of the intended parameters to the format string)
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
970 # * exe_extension -
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
971 # extension for executable files, eg. '' or '.exe'
11196
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
972
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
973 def object_filenames(self, source_filenames, strip_dir=0, output_dir=''):
25512
d124fb087778 Commit fix for SF 603831.
Guido van Rossum <guido@python.org>
parents: 25212
diff changeset
974 if output_dir is None:
d124fb087778 Commit fix for SF 603831.
Guido van Rossum <guido@python.org>
parents: 25212
diff changeset
975 output_dir = ''
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
976 obj_names = []
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
977 for src_name in source_filenames:
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
978 base, ext = os.path.splitext(src_name)
28078
bb6bd549f92a [Bug #668662] Patch from Pearu Pearson: if a C source file is
Andrew M. Kuchling <amk@amk.ca>
parents: 26821
diff changeset
979 base = os.path.splitdrive(base)[1] # Chop off the drive
bb6bd549f92a [Bug #668662] Patch from Pearu Pearson: if a C source file is
Andrew M. Kuchling <amk@amk.ca>
parents: 26821
diff changeset
980 base = base[os.path.isabs(base):] # If abs, chop off leading /
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
981 if ext not in self.src_extensions:
13002
5f3626fe58ca Changed 'object_filenames()' to raise exception instead of silently carrying
Greg Ward <gward@python.net>
parents: 12997
diff changeset
982 raise UnknownFileError, \
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
983 "unknown file type '%s' (from '%s')" % (ext, src_name)
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
984 if strip_dir:
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
985 base = os.path.basename(base)
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
986 obj_names.append(os.path.join(output_dir,
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
987 base + self.obj_extension))
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
988 return obj_names
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
989
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
990 def shared_object_filename(self, basename, strip_dir=0, output_dir=''):
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
991 assert output_dir is not None
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
992 if strip_dir:
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
993 basename = os.path.basename (basename)
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
994 return os.path.join(output_dir, basename + self.shared_lib_extension)
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
995
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
996 def executable_filename(self, basename, strip_dir=0, output_dir=''):
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
997 assert output_dir is not None
14890
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
998 if strip_dir:
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
999 basename = os.path.basename (basename)
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and
Greg Ward <gward@python.net>
parents: 13846
diff changeset
1000 return os.path.join(output_dir, basename + (self.exe_extension or ''))
11196
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
1001
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
1002 def library_filename(self, libname, lib_type='static', # or 'shared'
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
1003 strip_dir=0, output_dir=''):
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
1004 assert output_dir is not None
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
1005 if lib_type not in ("static", "shared", "dylib"):
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
1006 raise ValueError, "'lib_type' must be \"static\", \"shared\" or \"dylib\""
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
1007 fmt = getattr(self, lib_type + "_lib_format")
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
1008 ext = getattr(self, lib_type + "_lib_extension")
11245
854b801253f0 Patch from Perry Stoll:
Greg Ward <gward@python.net>
parents: 11196
diff changeset
1009
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
1010 dir, base = os.path.split (libname)
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
1011 filename = fmt % (base, ext)
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
1012 if strip_dir:
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
1013 dir = ''
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
1014
23821
3126c4262962 Extend compiler() method with optional depends argument.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23668
diff changeset
1015 return os.path.join(output_dir, dir, filename)
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
1016
11196
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
1017
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
1018 # -- Utility methods -----------------------------------------------
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
1019
11274
efa75c69857d Added 'output_dir' attribute, and 'output_dir' parameter to several method
Greg Ward <gward@python.net>
parents: 11258
diff changeset
1020 def announce (self, msg, level=1):
23668
ca87119255eb Make setup.py less chatty by default.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23272
diff changeset
1021 log.debug(msg)
11274
efa75c69857d Added 'output_dir' attribute, and 'output_dir' parameter to several method
Greg Ward <gward@python.net>
parents: 11258
diff changeset
1022
13846
0525851ba0b7 Added 'debug_print()'.
Greg Ward <gward@python.net>
parents: 13843
diff changeset
1023 def debug_print (self, msg):
25212
12949eced55f Use distutils.debug.DEBUG instead of distutils.core.DEBUG.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23912
diff changeset
1024 from distutils.debug import DEBUG
13846
0525851ba0b7 Added 'debug_print()'.
Greg Ward <gward@python.net>
parents: 13843
diff changeset
1025 if DEBUG:
0525851ba0b7 Added 'debug_print()'.
Greg Ward <gward@python.net>
parents: 13843
diff changeset
1026 print msg
0525851ba0b7 Added 'debug_print()'.
Greg Ward <gward@python.net>
parents: 13843
diff changeset
1027
11358
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name
Greg Ward <gward@python.net>
parents: 11335
diff changeset
1028 def warn (self, msg):
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name
Greg Ward <gward@python.net>
parents: 11335
diff changeset
1029 sys.stderr.write ("warning: %s\n" % msg)
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name
Greg Ward <gward@python.net>
parents: 11335
diff changeset
1030
13809
f3968dd1711b Added 'execute()' method, a thin wrapper around 'util.execute() (just like
Greg Ward <gward@python.net>
parents: 13725
diff changeset
1031 def execute (self, func, args, msg=None, level=1):
23668
ca87119255eb Make setup.py less chatty by default.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23272
diff changeset
1032 execute(func, args, msg, self.dry_run)
13809
f3968dd1711b Added 'execute()' method, a thin wrapper around 'util.execute() (just like
Greg Ward <gward@python.net>
parents: 13725
diff changeset
1033
11196
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
1034 def spawn (self, cmd):
23668
ca87119255eb Make setup.py less chatty by default.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23272
diff changeset
1035 spawn (cmd, dry_run=self.dry_run)
11196
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
1036
11274
efa75c69857d Added 'output_dir' attribute, and 'output_dir' parameter to several method
Greg Ward <gward@python.net>
parents: 11258
diff changeset
1037 def move_file (self, src, dst):
23668
ca87119255eb Make setup.py less chatty by default.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23272
diff changeset
1038 return move_file (src, dst, dry_run=self.dry_run)
11274
efa75c69857d Added 'output_dir' attribute, and 'output_dir' parameter to several method
Greg Ward <gward@python.net>
parents: 11258
diff changeset
1039
11889
1a49b6144f0d Added 'mkpath()' method: convenience wrapper around 'util.mkpath()' that adds
Greg Ward <gward@python.net>
parents: 11728
diff changeset
1040 def mkpath (self, name, mode=0777):
50257
e4675113d10e Merged revisions 67654,67676-67677,67681,67692,67725,67746,67748,67761,67784-67785,67787-67788,67802,67832,67848-67849,67859,67862-67864,67880,67882,67885,67889-67892,67895 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 45413
diff changeset
1041 mkpath (name, mode, dry_run=self.dry_run)
11889
1a49b6144f0d Added 'mkpath()' method: convenience wrapper around 'util.mkpath()' that adds
Greg Ward <gward@python.net>
parents: 11728
diff changeset
1042
11196
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
1043
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
1044 # class CCompiler
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
1045
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
1046
16674
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1047 # Map a sys.platform/os.name ('posix', 'nt') to the default compiler
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1048 # type for that platform. Keys are interpreted as re match
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1049 # patterns. Order is important; platform mappings are preferred over
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1050 # OS names.
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1051 _default_compilers = (
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1052
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1053 # Platform string mappings
16800
e0062e89d8f4 Patch #403947: On Cygwin, use the Unix compiler class, and not
Andrew M. Kuchling <amk@amk.ca>
parents: 16674
diff changeset
1054
e0062e89d8f4 Patch #403947: On Cygwin, use the Unix compiler class, and not
Andrew M. Kuchling <amk@amk.ca>
parents: 16674
diff changeset
1055 # on a cygwin built python we can use gcc like an ordinary UNIXish
e0062e89d8f4 Patch #403947: On Cygwin, use the Unix compiler class, and not
Andrew M. Kuchling <amk@amk.ca>
parents: 16674
diff changeset
1056 # compiler
e0062e89d8f4 Patch #403947: On Cygwin, use the Unix compiler class, and not
Andrew M. Kuchling <amk@amk.ca>
parents: 16674
diff changeset
1057 ('cygwin.*', 'unix'),
21851
e0fc286d57a4 OS/2 patches by Andrew I MacIntyre for distutils.
Marc-André Lemburg <mal@egenix.com>
parents: 21267
diff changeset
1058 ('os2emx', 'emx'),
21267
7a7f557b4d54 Whitespace normalization.
Fred Drake <fdrake@acm.org>
parents: 19498
diff changeset
1059
16674
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1060 # OS name mappings
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1061 ('posix', 'unix'),
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1062 ('nt', 'msvc'),
21267
7a7f557b4d54 Whitespace normalization.
Fred Drake <fdrake@acm.org>
parents: 19498
diff changeset
1063
16674
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1064 )
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1065
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1066 def get_default_compiler(osname=None, platform=None):
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1067
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1068 """ Determine the default compiler to use for the given platform.
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1069
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1070 osname should be one of the standard Python OS names (i.e. the
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1071 ones returned by os.name) and platform the common value
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1072 returned by sys.platform for the platform in question.
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1073
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1074 The default values are os.name and sys.platform in case the
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1075 parameters are not given.
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1076
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1077 """
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1078 if osname is None:
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1079 osname = os.name
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1080 if platform is None:
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1081 platform = sys.platform
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1082 for pattern, compiler in _default_compilers:
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1083 if re.match(pattern, platform) is not None or \
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1084 re.match(pattern, osname) is not None:
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1085 return compiler
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1086 # Default to Unix compiler
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1087 return 'unix'
11335
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1088
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1089 # Map compiler types to (module_name, class_name) pairs -- ie. where to
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1090 # find the code that implements an interface to this compiler. (The module
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1091 # is assumed to be in the 'distutils' package.)
12997
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch.
Greg Ward <gward@python.net>
parents: 12977
diff changeset
1092 compiler_class = { 'unix': ('unixccompiler', 'UnixCCompiler',
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch.
Greg Ward <gward@python.net>
parents: 12977
diff changeset
1093 "standard UNIX-style compiler"),
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch.
Greg Ward <gward@python.net>
parents: 12977
diff changeset
1094 'msvc': ('msvccompiler', 'MSVCCompiler',
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch.
Greg Ward <gward@python.net>
parents: 12977
diff changeset
1095 "Microsoft Visual C++"),
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch.
Greg Ward <gward@python.net>
parents: 12977
diff changeset
1096 'cygwin': ('cygwinccompiler', 'CygwinCCompiler',
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch.
Greg Ward <gward@python.net>
parents: 12977
diff changeset
1097 "Cygwin port of GNU C Compiler for Win32"),
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch.
Greg Ward <gward@python.net>
parents: 12977
diff changeset
1098 'mingw32': ('cygwinccompiler', 'Mingw32CCompiler',
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch.
Greg Ward <gward@python.net>
parents: 12977
diff changeset
1099 "Mingw32 port of GNU C Compiler for Win32"),
13045
72058dc7d545 Lyle Johnson: added 'build_temp' parameter to 'link_shared_{lib,object}()'
Greg Ward <gward@python.net>
parents: 13008
diff changeset
1100 'bcpp': ('bcppcompiler', 'BCPPCompiler',
72058dc7d545 Lyle Johnson: added 'build_temp' parameter to 'link_shared_{lib,object}()'
Greg Ward <gward@python.net>
parents: 13008
diff changeset
1101 "Borland C++ Compiler"),
21851
e0fc286d57a4 OS/2 patches by Andrew I MacIntyre for distutils.
Marc-André Lemburg <mal@egenix.com>
parents: 21267
diff changeset
1102 'emx': ('emxccompiler', 'EMXCCompiler',
e0fc286d57a4 OS/2 patches by Andrew I MacIntyre for distutils.
Marc-André Lemburg <mal@egenix.com>
parents: 21267
diff changeset
1103 "EMX port of GNU C Compiler for OS/2"),
11335
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1104 }
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1105
12869
88872791998a Patch from Rene Liebscher: this adds "--help-foo" options to list the
Greg Ward <gward@python.net>
parents: 12792
diff changeset
1106 def show_compilers():
12997
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch.
Greg Ward <gward@python.net>
parents: 12977
diff changeset
1107 """Print list of available compilers (used by the "--help-compiler"
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch.
Greg Ward <gward@python.net>
parents: 12977
diff changeset
1108 options to "build", "build_ext", "build_clib").
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch.
Greg Ward <gward@python.net>
parents: 12977
diff changeset
1109 """
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch.
Greg Ward <gward@python.net>
parents: 12977
diff changeset
1110 # XXX this "knows" that the compiler option it's describing is
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch.
Greg Ward <gward@python.net>
parents: 12977
diff changeset
1111 # "--compiler", which just happens to be the case for the three
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch.
Greg Ward <gward@python.net>
parents: 12977
diff changeset
1112 # commands that use it.
21267
7a7f557b4d54 Whitespace normalization.
Fred Drake <fdrake@acm.org>
parents: 19498
diff changeset
1113 from distutils.fancy_getopt import FancyGetopt
12997
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch.
Greg Ward <gward@python.net>
parents: 12977
diff changeset
1114 compilers = []
12869
88872791998a Patch from Rene Liebscher: this adds "--help-foo" options to list the
Greg Ward <gward@python.net>
parents: 12792
diff changeset
1115 for compiler in compiler_class.keys():
13413
7fea4a1af090 fix inconsistent use of tabs and spaces
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 13045
diff changeset
1116 compilers.append(("compiler="+compiler, None,
12997
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch.
Greg Ward <gward@python.net>
parents: 12977
diff changeset
1117 compiler_class[compiler][2]))
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch.
Greg Ward <gward@python.net>
parents: 12977
diff changeset
1118 compilers.sort()
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch.
Greg Ward <gward@python.net>
parents: 12977
diff changeset
1119 pretty_printer = FancyGetopt(compilers)
12869
88872791998a Patch from Rene Liebscher: this adds "--help-foo" options to list the
Greg Ward <gward@python.net>
parents: 12792
diff changeset
1120 pretty_printer.print_help("List of available compilers:")
21267
7a7f557b4d54 Whitespace normalization.
Fred Drake <fdrake@acm.org>
parents: 19498
diff changeset
1121
11335
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1122
11196
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
1123 def new_compiler (plat=None,
11335
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1124 compiler=None,
11196
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and
Greg Ward <gward@python.net>
parents: 11117
diff changeset
1125 verbose=0,
11358
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name
Greg Ward <gward@python.net>
parents: 11335
diff changeset
1126 dry_run=0,
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name
Greg Ward <gward@python.net>
parents: 11335
diff changeset
1127 force=0):
11335
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1128 """Generate an instance of some CCompiler subclass for the supplied
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1129 platform/compiler combination. 'plat' defaults to 'os.name'
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1130 (eg. 'posix', 'nt'), and 'compiler' defaults to the default compiler
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1131 for that platform. Currently only 'posix' and 'nt' are supported, and
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1132 the default compilers are "traditional Unix interface" (UnixCCompiler
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1133 class) and Visual C++ (MSVCCompiler class). Note that it's perfectly
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1134 possible to ask for a Unix compiler object under Windows, and a
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1135 Microsoft compiler object under Unix -- if you supply a value for
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1136 'compiler', 'plat' is ignored.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1137 """
11335
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1138 if plat is None:
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1139 plat = os.name
11117
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model.
Greg Ward <gward@python.net>
parents:
diff changeset
1140
11335
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1141 try:
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1142 if compiler is None:
16674
f4e97ec1dc9a This patch makes the default compiler determination more flexible
Marc-André Lemburg <mal@egenix.com>
parents: 15903
diff changeset
1143 compiler = get_default_compiler(plat)
21267
7a7f557b4d54 Whitespace normalization.
Fred Drake <fdrake@acm.org>
parents: 19498
diff changeset
1144
12997
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch.
Greg Ward <gward@python.net>
parents: 12977
diff changeset
1145 (module_name, class_name, long_description) = compiler_class[compiler]
11335
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1146 except KeyError:
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1147 msg = "don't know how to compile C/C++ code on platform '%s'" % plat
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1148 if compiler is not None:
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1149 msg = msg + " with '%s' compiler" % compiler
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1150 raise DistutilsPlatformError, msg
21267
7a7f557b4d54 Whitespace normalization.
Fred Drake <fdrake@acm.org>
parents: 19498
diff changeset
1151
11335
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1152 try:
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1153 module_name = "distutils." + module_name
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1154 __import__ (module_name)
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1155 module = sys.modules[module_name]
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1156 klass = vars(module)[class_name]
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1157 except ImportError:
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1158 raise DistutilsModuleError, \
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1159 "can't compile C/C++ code: unable to load module '%s'" % \
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1160 module_name
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1161 except KeyError:
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1162 raise DistutilsModuleError, \
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1163 ("can't compile C/C++ code: unable to find class '%s' " +
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1164 "in module '%s'") % (class_name, module_name)
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
Greg Ward <gward@python.net>
parents: 11304
diff changeset
1165
23668
ca87119255eb Make setup.py less chatty by default.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23272
diff changeset
1166 # XXX The None is necessary to preserve backwards compatibility
ca87119255eb Make setup.py less chatty by default.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23272
diff changeset
1167 # with classes that expect verbose to be the first positional
ca87119255eb Make setup.py less chatty by default.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23272
diff changeset
1168 # argument.
ca87119255eb Make setup.py less chatty by default.
Jeremy Hylton <jeremy@alum.mit.edu>
parents: 23272
diff changeset
1169 return klass (None, dry_run, force)
11258
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1170
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1171
11547
236d8428c4c5 Catch up with terminology change in UnixCCompiler: 'includes' -> 'include_dirs'.
Greg Ward <gward@python.net>
parents: 11358
diff changeset
1172 def gen_preprocess_options (macros, include_dirs):
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1173 """Generate C pre-processor options (-D, -U, -I) as used by at least
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1174 two types of compilers: the typical Unix compiler and Visual C++.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1175 'macros' is the usual thing, a list of 1- or 2-tuples, where (name,)
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1176 means undefine (-U) macro 'name', and (name,value) means define (-D)
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1177 macro 'name' to 'value'. 'include_dirs' is just a list of directory
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1178 names to be added to the header file search path (-I). Returns a list
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1179 of command-line options suitable for either Unix compilers or Visual
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1180 C++.
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1181 """
11258
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1182 # XXX it would be nice (mainly aesthetic, and so we don't generate
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1183 # stupid-looking command lines) to go over 'macros' and eliminate
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1184 # redundant definitions/undefinitions (ie. ensure that only the
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1185 # latest mention of a particular macro winds up on the command
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1186 # line). I don't think it's essential, though, since most (all?)
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1187 # Unix C compilers only pay attention to the latest -D or -U
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1188 # mention of a macro on their command line. Similar situation for
11547
236d8428c4c5 Catch up with terminology change in UnixCCompiler: 'includes' -> 'include_dirs'.
Greg Ward <gward@python.net>
parents: 11358
diff changeset
1189 # 'include_dirs'. I'm punting on both for now. Anyways, weeding out
11258
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1190 # redundancies like this should probably be the province of
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1191 # CCompiler, since the data structures used are inherited from it
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1192 # and therefore common to all CCompiler classes.
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1193
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1194 pp_opts = []
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1195 for macro in macros:
11304
424b31af6d51 Typecheck elements of 'macros' parameter in 'gen_preprocess_options().
Greg Ward <gward@python.net>
parents: 11274
diff changeset
1196
424b31af6d51 Typecheck elements of 'macros' parameter in 'gen_preprocess_options().
Greg Ward <gward@python.net>
parents: 11274
diff changeset
1197 if not (type (macro) is TupleType and
424b31af6d51 Typecheck elements of 'macros' parameter in 'gen_preprocess_options().
Greg Ward <gward@python.net>
parents: 11274
diff changeset
1198 1 <= len (macro) <= 2):
424b31af6d51 Typecheck elements of 'macros' parameter in 'gen_preprocess_options().
Greg Ward <gward@python.net>
parents: 11274
diff changeset
1199 raise TypeError, \
424b31af6d51 Typecheck elements of 'macros' parameter in 'gen_preprocess_options().
Greg Ward <gward@python.net>
parents: 11274
diff changeset
1200 ("bad macro definition '%s': " +
424b31af6d51 Typecheck elements of 'macros' parameter in 'gen_preprocess_options().
Greg Ward <gward@python.net>
parents: 11274
diff changeset
1201 "each element of 'macros' list must be a 1- or 2-tuple") % \
424b31af6d51 Typecheck elements of 'macros' parameter in 'gen_preprocess_options().
Greg Ward <gward@python.net>
parents: 11274
diff changeset
1202 macro
424b31af6d51 Typecheck elements of 'macros' parameter in 'gen_preprocess_options().
Greg Ward <gward@python.net>
parents: 11274
diff changeset
1203
11258
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1204 if len (macro) == 1: # undefine this macro
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1205 pp_opts.append ("-U%s" % macro[0])
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1206 elif len (macro) == 2:
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1207 if macro[1] is None: # define with no explicit value
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1208 pp_opts.append ("-D%s" % macro[0])
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1209 else:
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1210 # XXX *don't* need to be clever about quoting the
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1211 # macro value here, because we're going to avoid the
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1212 # shell at all costs when we spawn the command!
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1213 pp_opts.append ("-D%s=%s" % macro)
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1214
11547
236d8428c4c5 Catch up with terminology change in UnixCCompiler: 'includes' -> 'include_dirs'.
Greg Ward <gward@python.net>
parents: 11358
diff changeset
1215 for dir in include_dirs:
11258
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1216 pp_opts.append ("-I%s" % dir)
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1217
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1218 return pp_opts
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1219
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1220 # gen_preprocess_options ()
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1221
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1222
12016
13fd0dfec560 Changed to pay attention to the 'runtime_library_dirs' list (= 'rpath'
Greg Ward <gward@python.net>
parents: 11955
diff changeset
1223 def gen_lib_options (compiler, library_dirs, runtime_library_dirs, libraries):
11258
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1224 """Generate linker options for searching library directories and
13005
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1225 linking with specific libraries. 'libraries' and 'library_dirs' are,
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1226 respectively, lists of library names (not filenames!) and search
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1227 directories. Returns a list of command-line options suitable for use
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1228 with some compiler (depending on the two format strings passed in).
82181e820de3 Docstring reformatting/tweaking binge.
Greg Ward <gward@python.net>
parents: 13002
diff changeset
1229 """
11258
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1230 lib_opts = []
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1231
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1232 for dir in library_dirs:
11358
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name
Greg Ward <gward@python.net>
parents: 11335
diff changeset
1233 lib_opts.append (compiler.library_dir_option (dir))
11258
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1234
12016
13fd0dfec560 Changed to pay attention to the 'runtime_library_dirs' list (= 'rpath'
Greg Ward <gward@python.net>
parents: 11955
diff changeset
1235 for dir in runtime_library_dirs:
33320
d5b097608c9d Patch #973204: Use -rpath instead of -R on Irix and Tru64.
Martin v. Löwis <martin@v.loewis.de>
parents: 32736
diff changeset
1236 opt = compiler.runtime_library_dir_option (dir)
d5b097608c9d Patch #973204: Use -rpath instead of -R on Irix and Tru64.
Martin v. Löwis <martin@v.loewis.de>
parents: 32736
diff changeset
1237 if type(opt) is ListType:
d5b097608c9d Patch #973204: Use -rpath instead of -R on Irix and Tru64.
Martin v. Löwis <martin@v.loewis.de>
parents: 32736
diff changeset
1238 lib_opts = lib_opts + opt
d5b097608c9d Patch #973204: Use -rpath instead of -R on Irix and Tru64.
Martin v. Löwis <martin@v.loewis.de>
parents: 32736
diff changeset
1239 else:
d5b097608c9d Patch #973204: Use -rpath instead of -R on Irix and Tru64.
Martin v. Löwis <martin@v.loewis.de>
parents: 32736
diff changeset
1240 lib_opts.append (opt)
12016
13fd0dfec560 Changed to pay attention to the 'runtime_library_dirs' list (= 'rpath'
Greg Ward <gward@python.net>
parents: 11955
diff changeset
1241
11258
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1242 # XXX it's important that we *not* remove redundant library mentions!
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1243 # sometimes you really do have to say "-lfoo -lbar -lfoo" in order to
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1244 # resolve all symbols. I just hope we never have to say "-lfoo obj.o
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1245 # -lbar" to get things to work -- that's certainly a possibility, but a
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1246 # pretty nasty way to arrange your C code.
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1247
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1248 for lib in libraries:
11358
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name
Greg Ward <gward@python.net>
parents: 11335
diff changeset
1249 (lib_dir, lib_name) = os.path.split (lib)
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name
Greg Ward <gward@python.net>
parents: 11335
diff changeset
1250 if lib_dir:
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name
Greg Ward <gward@python.net>
parents: 11335
diff changeset
1251 lib_file = compiler.find_library_file ([lib_dir], lib_name)
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name
Greg Ward <gward@python.net>
parents: 11335
diff changeset
1252 if lib_file:
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name
Greg Ward <gward@python.net>
parents: 11335
diff changeset
1253 lib_opts.append (lib_file)
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name
Greg Ward <gward@python.net>
parents: 11335
diff changeset
1254 else:
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name
Greg Ward <gward@python.net>
parents: 11335
diff changeset
1255 compiler.warn ("no library file corresponding to "
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name
Greg Ward <gward@python.net>
parents: 11335
diff changeset
1256 "'%s' found (skipping)" % lib)
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name
Greg Ward <gward@python.net>
parents: 11335
diff changeset
1257 else:
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name
Greg Ward <gward@python.net>
parents: 11335
diff changeset
1258 lib_opts.append (compiler.library_option (lib))
11258
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1259
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1260 return lib_opts
2341be74b758 os.name is "posix" or "nt" or we don't care.
Greg Ward <gward@python.net>
parents: 11245
diff changeset
1261
11915
7922d08426ca Serious overhaul of the C compiler interface and the two classes that
Greg Ward <gward@python.net>
parents: 11897
diff changeset
1262 # gen_lib_options ()