cpython-lru_cache-weakref: Lib/distutils/ccompiler.py annotate

annotate Lib/distutils/ccompiler.py @ 58925:eecf1bef052d 2.6

Merged revisions 78207 via svnmerge from svn+ssh://pythondev@svn.python.org/python/trunk ........ r78207 | ezio.melotti | 2010-02-17 01:26:09 +0200 (Wed, 17 Feb 2010) | 1 line #7930: fix stripid ........

author	Ezio Melotti <ezio.melotti@gmail.com>
date	Tue, 16 Feb 2010 23:29:44 +0000
parents	8a320694e53b
children	b36cb4602e21

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
33965 893d46576737 Update compatibility comments to 2.1, corresponding to PEP 291 1.13. Martin v. Löwis <martin@v.loewis.de> parents: 33320 diff changeset	6 # This module should be kept compatible with Python 2.1.
26285 42bfc98d295b Add comment to Distutil files about requiring 1.5.2 compatibility, as Andrew M. Kuchling <amk@amk.ca> parents: 26210 diff changeset	7
11897 017e592c0fd2 Changed '__rcsid__' to '__revision__'. Greg Ward <gward@python.net> parents: 11889 diff changeset	8 __revision__ = "$Id$"
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	9
16674 f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	10 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	11 from types import *
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	12 from copy import copy
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	13 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	14 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	15 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	16 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	17 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	18 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	19 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	20
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	21 class CCompiler:
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	22 """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	23 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	24 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	25
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	26 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	27 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	28 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	29 link steps -- include directories, macros to define, libraries to link
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	30 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	31 variability in how individual files are treated, most of those
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	32 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	33 """
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	34
11335 3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods, Greg Ward <gward@python.net> parents: 11304 diff changeset	35 # '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	36 # 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	37 # 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	38 # '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	39 # 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	40 # 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	41 # 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	42 # 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	43 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	44
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	45 # 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	46 # * 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	47 # 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	48 # 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	49 # (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	50 # 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	51 # * 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	52 # 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	53 # 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	54 # 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	55 # 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	56 # 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	57 # 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	58 # 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	59 # * 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	60 # 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	61 # 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	62 # 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	63 # library search path anyways.
21267 7a7f557b4d54 Whitespace normalization. Fred Drake <fdrake@acm.org> parents: 19498 diff changeset	64
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	65
11915 7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	66 # 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	67 # 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	68 # 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	69 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	70 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	71 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	72 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	73 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	74 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	75 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	76
26036 771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	77 # 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	78 # file or Extension target language, checking source filenames.
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	79 # 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	80 # 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	81 # 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	82 # is still linked as c++.
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	83 language_map = {".c" : "c",
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	84 ".cc" : "c++",
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	85 ".cpp" : "c++",
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	86 ".cxx" : "c++",
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	87 ".m" : "objc",
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	88 }
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	89 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	90
11196 1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and Greg Ward <gward@python.net> parents: 11117 diff changeset	91 def __init__ (self,
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and Greg Ward <gward@python.net> parents: 11117 diff changeset	92 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	93 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	94 force=0):
11196 1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and Greg Ward <gward@python.net> parents: 11117 diff changeset	95
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and Greg Ward <gward@python.net> parents: 11117 diff changeset	96 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	97 self.force = force
25524 c12a4f7a00b7 save the verbose argument as an instance attributes. Subclasses of Skip Montanaro <skip@pobox.com> parents: 25512 diff changeset	98 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	99
11274 efa75c69857d Added 'output_dir' attribute, and 'output_dir' parameter to several method Greg Ward <gward@python.net> parents: 11258 diff changeset	100 # '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	101 # 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	102 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	103
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	104 # '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	105 # 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	106 # 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	107 # 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	108 self.macros = []
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 # '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	111 self.include_dirs = []
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	112
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	113 # '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	114 # (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	115 self.libraries = []
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	116
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	117 # '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	118 self.library_dirs = []
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	119
11196 1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and Greg Ward <gward@python.net> parents: 11117 diff changeset	120 # '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	121 # 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	122 self.runtime_library_dirs = []
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and Greg Ward <gward@python.net> parents: 11117 diff changeset	123
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	124 # '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	125 # 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	126 self.objects = []
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	127
13008 6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables Greg Ward <gward@python.net> parents: 13005 diff changeset	128 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	129 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	130
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	131 # __init__ ()
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	132
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	133
13008 6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables Greg Ward <gward@python.net> parents: 13005 diff changeset	134 def set_executables (self, **args):
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables Greg Ward <gward@python.net> parents: 13005 diff changeset	135
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables Greg Ward <gward@python.net> parents: 13005 diff changeset	136 """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	137 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	138 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	139 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	140 compiler the C/C++ compiler
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables Greg Ward <gward@python.net> parents: 13005 diff changeset	141 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	142 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	143 archiver static library creator
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables Greg Ward <gward@python.net> parents: 13005 diff changeset	144
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables Greg Ward <gward@python.net> parents: 13005 diff changeset	145 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	146 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	147 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	148 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	149 backslashes can override this. See
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables Greg Ward <gward@python.net> parents: 13005 diff changeset	150 'distutils.util.split_quoted()'.)
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables Greg Ward <gward@python.net> parents: 13005 diff changeset	151 """
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables Greg Ward <gward@python.net> parents: 13005 diff changeset	152
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables Greg Ward <gward@python.net> parents: 13005 diff changeset	153 # 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	154 # 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	155 # 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	156 # 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	157 # 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	158 # 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	159 # 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	160
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables Greg Ward <gward@python.net> parents: 13005 diff changeset	161 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	162 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	163 raise ValueError, \
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables Greg Ward <gward@python.net> parents: 13005 diff changeset	164 "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	165 (key, self.__class__.__name__)
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables Greg Ward <gward@python.net> parents: 13005 diff changeset	166 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	167
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables Greg Ward <gward@python.net> parents: 13005 diff changeset	168 # set_executables ()
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables Greg Ward <gward@python.net> parents: 13005 diff changeset	169
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables Greg Ward <gward@python.net> parents: 13005 diff changeset	170 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	171 if type(value) is StringType:
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables Greg Ward <gward@python.net> parents: 13005 diff changeset	172 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	173 else:
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables Greg Ward <gward@python.net> parents: 13005 diff changeset	174 setattr(self, key, value)
21267 7a7f557b4d54 Whitespace normalization. Fred Drake <fdrake@acm.org> parents: 19498 diff changeset	175
13008 6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables Greg Ward <gward@python.net> parents: 13005 diff changeset	176
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	177 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	178 i = 0
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	179 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	180 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	181 return i
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	182 i = i + 1
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 return None
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	185
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	186
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	187 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	188 """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	189 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	190 nothing if all definitions are OK, raise TypeError otherwise.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	191 """
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	192 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	193 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	194 (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	195 (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	196 (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	197 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	198 raise TypeError, \
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	199 ("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	200 "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	201 "(string, None)"
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
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	204 # -- Bookkeeping methods -------------------------------------------
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	205
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	206 def define_macro (self, name, value=None):
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	207 """Define a preprocessor macro for all compilations driven by this
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	208 compiler object. The optional parameter 'value' should be a
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	209 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	210 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	211 compiler used (XXX true? does ANSI say anything about this?)
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	212 """
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	213 # 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	214 # 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	215 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	216 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	217 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	218
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	219 defn = (name, value)
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	220 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	221
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	222
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	223 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	224 """Undefine a preprocessor macro for all compilations driven by
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	225 this compiler object. If the same macro is defined by
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	226 'define_macro()' and undefined by 'undefine_macro()' the last call
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	227 takes precedence (including multiple redefinitions or
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	228 undefinitions). If the macro is redefined/undefined on a
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	229 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	230 takes precedence.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	231 """
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	232 # 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	233 # 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	234 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	235 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	236 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	237
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	238 undefn = (name,)
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	239 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	240
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	241
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	242 def add_include_dir (self, dir):
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	243 """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	244 header files. The compiler is instructed to search directories in
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	245 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	246 'add_include_dir()'.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	247 """
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	248 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	249
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	250 def set_include_dirs (self, dirs):
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	251 """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	252 list of strings). Overrides any preceding calls to
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	253 'add_include_dir()'; subsequence calls to 'add_include_dir()' add
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	254 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	255 any list of standard include directories that the compiler may
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	256 search by default.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	257 """
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	258 self.include_dirs = copy (dirs)
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	259
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	260
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	261 def add_library (self, libname):
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	262 """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	263 all links driven by this compiler object. Note that 'libname'
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	264 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	265 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	266 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	267 platform).
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	268
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	269 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	270 order they were supplied to 'add_library()' and/or
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	271 'set_libraries()'. It is perfectly valid to duplicate library
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	272 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	273 many times as they are mentioned.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	274 """
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	275 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	276
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	277 def set_libraries (self, libnames):
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	278 """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	279 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	280 not affect any standard system libraries that the linker may
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	281 include by default.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	282 """
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	283 self.libraries = copy (libnames)
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	284
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	285
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	286 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	287 """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	288 libraries specified to 'add_library()' and 'set_libraries()'. The
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	289 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	290 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	291 """
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	292 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	293
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	294 def set_library_dirs (self, dirs):
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	295 """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	296 strings). This does not affect any standard library search path
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	297 that the linker may search by default.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	298 """
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	299 self.library_dirs = copy (dirs)
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	300
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	301
11196 1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and Greg Ward <gward@python.net> parents: 11117 diff changeset	302 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	303 """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	304 shared libraries at runtime.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	305 """
11196 1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and Greg Ward <gward@python.net> parents: 11117 diff changeset	306 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	307
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and Greg Ward <gward@python.net> parents: 11117 diff changeset	308 def set_runtime_library_dirs (self, dirs):
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	309 """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	310 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	311 standard search path that the runtime linker may search by
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	312 default.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	313 """
11196 1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and Greg Ward <gward@python.net> parents: 11117 diff changeset	314 self.runtime_library_dirs = copy (dirs)
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and Greg Ward <gward@python.net> parents: 11117 diff changeset	315
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and Greg Ward <gward@python.net> parents: 11117 diff changeset	316
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	317 def add_link_object (self, object):
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	318 """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	319 explicitly named library files or the output of "resource
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	320 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	321 object.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	322 """
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	323 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	324
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	325 def set_link_objects (self, objects):
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	326 """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	327 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	328 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	329 libraries).
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	330 """
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	331 self.objects = copy (objects)
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	332
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	333
23272 582855f6d35b Fix trivial typo. Thomas Heller <theller@ctypes.org> parents: 21851 diff changeset	334 # -- 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	335 # (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	336
23821 3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	337 # 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	338
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	339 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	340 extra):
58253 8a320694e53b Merged revisions 77424 via svnmerge from Tarek Ziadé <ziade.tarek@gmail.com> parents: 50257 diff changeset	341 """Process arguments and decide which source files to compile."""
23821 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 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	372
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	373 build = {}
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	374 for i in range(len(sources)):
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	375 src = sources[i]
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	376 obj = objects[i]
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	377 ext = os.path.splitext(src)[1]
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	378 self.mkpath(os.path.dirname(obj))
58253 8a320694e53b Merged revisions 77424 via svnmerge from Tarek Ziadé <ziade.tarek@gmail.com> parents: 50257 diff changeset	379 build[obj] = (src, ext)
23821 3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	380
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	381 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	382
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	383 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	384 # works for unixccompiler, emxccompiler, cygwinccompiler
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	385 cc_args = pp_opts + ['-c']
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	386 if debug:
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	387 cc_args[:0] = ['-g']
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	388 if before:
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	389 cc_args[:0] = before
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	390 return cc_args
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	391
11915 7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	392 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	393 """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	394 method, and return fixed-up values. Specifically: if 'output_dir'
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	395 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	396 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	397 '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	398 Guarantees that the returned values are of the correct type,
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	399 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	400 'include_dirs' either list or None.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	401 """
11915 7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	402 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	403 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	404 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	405 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	406
7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	407 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	408 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	409 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	410 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	411 else:
23821 3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	412 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	413
7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	414 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	415 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	416 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	417 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	418 else:
7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	419 raise TypeError, \
7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	420 "'include_dirs' (if supplied) must be a list of strings"
21267 7a7f557b4d54 Whitespace normalization. Fred Drake <fdrake@acm.org> parents: 19498 diff changeset	421
23821 3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	422 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	423
7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	424 # _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	425
23821 3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	426 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	427 """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	428
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	429 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	430 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	431 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	432 which source files can be skipped.
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	433 """
21267 7a7f557b4d54 Whitespace normalization. Fred Drake <fdrake@acm.org> parents: 19498 diff changeset	434 # 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	435 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	436 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	437
58253 8a320694e53b Merged revisions 77424 via svnmerge from Tarek Ziadé <ziade.tarek@gmail.com> parents: 50257 diff changeset	438 # Return an empty dict for the "which source files can be skipped"
8a320694e53b Merged revisions 77424 via svnmerge from Tarek Ziadé <ziade.tarek@gmail.com> parents: 50257 diff changeset	439 # return value to preserve API compatibility.
8a320694e53b Merged revisions 77424 via svnmerge from Tarek Ziadé <ziade.tarek@gmail.com> parents: 50257 diff changeset	440 return objects, {}
11915 7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	441
12054 23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	442 def _fix_object_args (self, objects, output_dir):
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	443 """Typecheck and fix up some arguments supplied to various methods.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	444 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	445 None, replace with self.output_dir. Return fixed versions of
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	446 'objects' and 'output_dir'.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	447 """
11915 7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	448 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	449 raise TypeError, \
7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	450 "'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	451 objects = list (objects)
21267 7a7f557b4d54 Whitespace normalization. Fred Drake <fdrake@acm.org> parents: 19498 diff changeset	452
11915 7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	453 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	454 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	455 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	456 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	457
12054 23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	458 return (objects, output_dir)
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	459
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	460
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	461 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	462 """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	463 'link_*' methods. Specifically: ensure that all arguments are
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	464 lists, and augment them with their permanent versions
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	465 (eg. 'self.libraries' augments 'libraries'). Return a tuple with
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	466 fixed versions of all arguments.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	467 """
12054 23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	468 if libraries is None:
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	469 libraries = self.libraries
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	470 elif type (libraries) in (ListType, TupleType):
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	471 libraries = list (libraries) + (self.libraries or [])
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	472 else:
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	473 raise TypeError, \
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	474 "'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	475
12054 23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	476 if library_dirs is None:
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	477 library_dirs = self.library_dirs
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	478 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	479 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	480 else:
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	481 raise TypeError, \
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	482 "'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	483
12054 23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	484 if runtime_library_dirs is None:
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	485 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	486 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	487 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	488 (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	489 else:
12054 23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	490 raise TypeError, \
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	491 "'runtime_library_dirs' (if supplied) " + \
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	492 "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	493
12054 23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	494 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	495
23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	496 # _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	497
7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	498
7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	499 def _need_link (self, objects, output_file):
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	500 """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	501 to recreate 'output_file'.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	502 """
11915 7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	503 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	504 return 1
7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	505 else:
7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	506 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	507 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	508 else:
7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	509 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	510 return newer
7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	511
7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	512 # _need_link ()
7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	513
26036 771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	514 def detect_language (self, sources):
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	515 """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	516 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	517 """
26049 5819c4439ba2 Repair inconsistent use of tabs and spaces. Jeremy Hylton <jeremy@alum.mit.edu> parents: 26036 diff changeset	518 if type(sources) is not ListType:
26036 771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	519 sources = [sources]
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	520 lang = None
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	521 index = len(self.language_order)
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	522 for source in sources:
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	523 base, ext = os.path.splitext(source)
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	524 extlang = self.language_map.get(ext)
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	525 try:
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	526 extindex = self.language_order.index(extlang)
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	527 if extindex < index:
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	528 lang = extlang
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	529 index = extindex
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	530 except ValueError:
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	531 pass
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	532 return lang
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	533
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	534 # 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	535
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	536 # -- Worker methods ------------------------------------------------
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	537 # (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	538
12977 dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented Greg Ward <gward@python.net> parents: 12869 diff changeset	539 def preprocess (self,
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented Greg Ward <gward@python.net> parents: 12869 diff changeset	540 source,
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented Greg Ward <gward@python.net> parents: 12869 diff changeset	541 output_file=None,
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented Greg Ward <gward@python.net> parents: 12869 diff changeset	542 macros=None,
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented Greg Ward <gward@python.net> parents: 12869 diff changeset	543 include_dirs=None,
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented Greg Ward <gward@python.net> parents: 12869 diff changeset	544 extra_preargs=None,
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented Greg Ward <gward@python.net> parents: 12869 diff changeset	545 extra_postargs=None):
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented Greg Ward <gward@python.net> parents: 12869 diff changeset	546 """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	547 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	548 '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	549 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	550 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	551 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	552
6e1861e0ed68 Introduced some bureaucracy for setting and tracking the executables Greg Ward <gward@python.net> parents: 13005 diff changeset	553 Raises PreprocessError on failure.
12977 dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented Greg Ward <gward@python.net> parents: 12869 diff changeset	554 """
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented Greg Ward <gward@python.net> parents: 12869 diff changeset	555 pass
dbb103e9a56f Added 'preprocess()' method to CCompiler interface, and implemented Greg Ward <gward@python.net> parents: 12869 diff changeset	556
23821 3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	557 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	558 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	559 extra_postargs=None, depends=None):
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	560 """Compile one or more source files.
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	561
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	562 '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	563 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	564 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	565 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	566 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	567 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	568 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	569 returned.
11915 7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	570
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	571 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	572 retaining their original path component. That is, "foo/bar.c"
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	573 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	574 'output_dir' is "build", then it would compile to
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	575 "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	576
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	577 '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	578 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	579 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	580 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	581 macro. Later definitions/redefinitions/ undefinitions take
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	582 precedence.
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	583
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	584 '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	585 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	586 compilation only.
11728 985723498b1b Added 'debug' flag to compile and link method signatures. Greg Ward <gward@python.net> parents: 11646 diff changeset	587
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	588 '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	589 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	590
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	591 'extra_preargs' and 'extra_postargs' are implementation- dependent.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	592 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	593 DOS/Windows), they are most likely lists of strings: extra
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	594 command-line arguments to prepand/append to the compiler command
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	595 line. On other platforms, consult the implementation class
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	596 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	597 for those occasions when the abstract compiler framework doesn't
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	598 cut the mustard.
12790 f8c1c5b7dc9f Changed to catch compile/link failures and raise CompileError, LibError, Greg Ward <gward@python.net> parents: 12718 diff changeset	599
23821 3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	600 '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	601 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	602 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	603 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	604 granularity.
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	605
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	606 Raises CompileError on failure.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	607 """
23912 075f755a65da Add a default implementation of compile() to the base class. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23821 diff changeset	608 # 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	609 # entirely or implement _compile().
32736 c3a096bfbd6b Whitespace normalization, via reindent.py. Tim Peters <tim.peters@gmail.com> parents: 31129 diff changeset	610
23912 075f755a65da Add a default implementation of compile() to the base class. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23821 diff changeset	611 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	612 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	613 depends, extra_postargs)
075f755a65da Add a default implementation of compile() to the base class. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23821 diff changeset	614 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	615
31129 be9ef9b92d61 Compile the files in the same order they are passed to the compiler. Thomas Heller <theller@ctypes.org> parents: 28801 diff changeset	616 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	617 try:
be9ef9b92d61 Compile the files in the same order they are passed to the compiler. Thomas Heller <theller@ctypes.org> parents: 28801 diff changeset	618 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	619 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	620 continue
23912 075f755a65da Add a default implementation of compile() to the base class. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23821 diff changeset	621 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	622
075f755a65da Add a default implementation of compile() to the base class. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23821 diff changeset	623 # 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	624 return objects
075f755a65da Add a default implementation of compile() to the base class. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23821 diff changeset	625
075f755a65da Add a default implementation of compile() to the base class. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23821 diff changeset	626 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	627 """Compile 'src' to product 'obj'."""
32736 c3a096bfbd6b Whitespace normalization, via reindent.py. Tim Peters <tim.peters@gmail.com> parents: 31129 diff changeset	628
23912 075f755a65da Add a default implementation of compile() to the base class. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23821 diff changeset	629 # 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	630 # 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	631 pass
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	632
11955 6e3c81bd8291 Renamed 'link_static_lib() to 'create_static_lib()'. Greg Ward <gward@python.net> parents: 11915 diff changeset	633 def create_static_lib (self,
6e3c81bd8291 Renamed 'link_static_lib() to 'create_static_lib()'. Greg Ward <gward@python.net> parents: 11915 diff changeset	634 objects,
6e3c81bd8291 Renamed 'link_static_lib() to 'create_static_lib()'. Greg Ward <gward@python.net> parents: 11915 diff changeset	635 output_libname,
6e3c81bd8291 Renamed 'link_static_lib() to 'create_static_lib()'. Greg Ward <gward@python.net> parents: 11915 diff changeset	636 output_dir=None,
26036 771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	637 debug=0,
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	638 target_lang=None):
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	639 """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	640 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	641 as 'objects', the extra object files supplied to
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	642 'add_link_object()' and/or 'set_link_objects()', the libraries
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	643 supplied to 'add_library()' and/or 'set_libraries()', and the
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	644 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	645
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	646 '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	647 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	648 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	649
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	650 'debug' is a boolean; if true, debugging information will be
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	651 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	652 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	653 just for consistency).
12790 f8c1c5b7dc9f Changed to catch compile/link failures and raise CompileError, LibError, Greg Ward <gward@python.net> parents: 12718 diff changeset	654
26036 771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	655 '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	656 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	657 certain languages.
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	658
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	659 Raises LibError on failure.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	660 """
11728 985723498b1b Added 'debug' flag to compile and link method signatures. Greg Ward <gward@python.net> parents: 11646 diff changeset	661 pass
21267 7a7f557b4d54 Whitespace normalization. Fred Drake <fdrake@acm.org> parents: 19498 diff changeset	662
11728 985723498b1b Added 'debug' flag to compile and link method signatures. Greg Ward <gward@python.net> parents: 11646 diff changeset	663
14890 afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	664 # 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	665 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	666 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	667 EXECUTABLE = "executable"
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	668
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	669 def link (self,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	670 target_desc,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	671 objects,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	672 output_filename,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	673 output_dir=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	674 libraries=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	675 library_dirs=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	676 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	677 export_symbols=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	678 debug=0,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	679 extra_preargs=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	680 extra_postargs=None,
26036 771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	681 build_temp=None,
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	682 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	683 """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	684 shared library file.
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	685
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	686 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	687 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	688 '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	689 (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	690 needed).
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	691
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	692 '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	693 library names, not filenames, since they're translated into
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	694 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	695 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	696 directory component, which means the linker will look in that
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	697 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	698
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	699 '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	700 search for libraries that were specified as bare library names
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	701 (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	702 default and those supplied to 'add_library_dir()' and/or
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	703 'set_library_dirs()'. 'runtime_library_dirs' is a list of
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	704 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	705 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	706 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	707
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	708 '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	709 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	710
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	711 '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	712 slight distinction that it actually matters on most platforms (as
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	713 opposed to 'create_static_lib()', which includes a 'debug' flag
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	714 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	715
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	716 'extra_preargs' and 'extra_postargs' are as for 'compile()' (except
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	717 of course that they supply command-line arguments for the
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	718 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	719
26036 771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	720 '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	721 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	722 certain languages.
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	723
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	724 Raises LinkError on failure.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	725 """
14890 afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	726 raise NotImplementedError
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	727
21267 7a7f557b4d54 Whitespace normalization. Fred Drake <fdrake@acm.org> parents: 19498 diff changeset	728
14891 e4641d193220 Remove deprecation warnings on old 'link_()' methods, ie. they're not Greg Ward <gward@python.net>* parents: 14890 diff changeset	729 # 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	730
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	731 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	732 objects,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	733 output_libname,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	734 output_dir=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	735 libraries=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	736 library_dirs=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	737 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	738 export_symbols=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	739 debug=0,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	740 extra_preargs=None,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	741 extra_postargs=None,
26036 771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	742 build_temp=None,
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	743 target_lang=None):
21267 7a7f557b4d54 Whitespace normalization. Fred Drake <fdrake@acm.org> parents: 19498 diff changeset	744 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	745 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	746 output_dir,
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	747 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	748 export_symbols, debug,
26036 771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	749 extra_preargs, extra_postargs, build_temp, target_lang)
21267 7a7f557b4d54 Whitespace normalization. Fred Drake <fdrake@acm.org> parents: 19498 diff changeset	750
11335 3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods, Greg Ward <gward@python.net> parents: 11304 diff changeset	751
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	752 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	753 objects,
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	754 output_filename,
11274 efa75c69857d Added 'output_dir' attribute, and 'output_dir' parameter to several method Greg Ward <gward@python.net> parents: 11258 diff changeset	755 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	756 libraries=None,
11245 854b801253f0 Patch from Perry Stoll: Greg Ward <gward@python.net> parents: 11196 diff changeset	757 library_dirs=None,
12054 23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	758 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	759 export_symbols=None,
11728 985723498b1b Added 'debug' flag to compile and link method signatures. Greg Ward <gward@python.net> parents: 11646 diff changeset	760 debug=0,
11335 3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods, Greg Ward <gward@python.net> parents: 11304 diff changeset	761 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	762 extra_postargs=None,
26036 771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	763 build_temp=None,
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	764 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	765 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	766 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	767 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	768 export_symbols, debug,
26036 771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	769 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	770
11196 1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and Greg Ward <gward@python.net> parents: 11117 diff changeset	771
11646 472a17f2ca9f Removed a bunch of irrelevant parameters from 'link_static_lib()' signature. Greg Ward <gward@python.net> parents: 11547 diff changeset	772 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	773 objects,
472a17f2ca9f Removed a bunch of irrelevant parameters from 'link_static_lib()' signature. Greg Ward <gward@python.net> parents: 11547 diff changeset	774 output_progname,
472a17f2ca9f Removed a bunch of irrelevant parameters from 'link_static_lib()' signature. Greg Ward <gward@python.net> parents: 11547 diff changeset	775 output_dir=None,
472a17f2ca9f Removed a bunch of irrelevant parameters from 'link_static_lib()' signature. Greg Ward <gward@python.net> parents: 11547 diff changeset	776 libraries=None,
472a17f2ca9f Removed a bunch of irrelevant parameters from 'link_static_lib()' signature. Greg Ward <gward@python.net> parents: 11547 diff changeset	777 library_dirs=None,
12054 23a1c526c6f0 Added 'runtime_library_dirs' parameter to 'link_()' methods. Greg Ward <gward@python.net>* parents: 12016 diff changeset	778 runtime_library_dirs=None,
11728 985723498b1b Added 'debug' flag to compile and link method signatures. Greg Ward <gward@python.net> parents: 11646 diff changeset	779 debug=0,
11646 472a17f2ca9f Removed a bunch of irrelevant parameters from 'link_static_lib()' signature. Greg Ward <gward@python.net> parents: 11547 diff changeset	780 extra_preargs=None,
26036 771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	781 extra_postargs=None,
771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	782 target_lang=None):
21267 7a7f557b4d54 Whitespace normalization. Fred Drake <fdrake@acm.org> parents: 19498 diff changeset	783 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	784 self.executable_filename(output_progname), output_dir,
21267 7a7f557b4d54 Whitespace normalization. Fred Drake <fdrake@acm.org> parents: 19498 diff changeset	785 libraries, library_dirs, runtime_library_dirs, None,
26036 771b6f521b95 This patch fixes the following bugs: Gustavo Niemeyer <gustavo@niemeyer.net> parents: 25524 diff changeset	786 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	787
472a17f2ca9f Removed a bunch of irrelevant parameters from 'link_static_lib()' signature. Greg Ward <gward@python.net> parents: 11547 diff changeset	788
12718 53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be Greg Ward <gward@python.net> parents: 12717 diff changeset	789 # -- Miscellaneous methods -----------------------------------------
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be Greg Ward <gward@python.net> parents: 12717 diff changeset	790 # 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	791 # 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	792 # 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	793
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be Greg Ward <gward@python.net> parents: 12717 diff changeset	794 def library_dir_option (self, dir):
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	795 """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	796 directories searched for libraries.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	797 """
12718 53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be Greg Ward <gward@python.net> parents: 12717 diff changeset	798 raise NotImplementedError
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be Greg Ward <gward@python.net> parents: 12717 diff changeset	799
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be Greg Ward <gward@python.net> parents: 12717 diff changeset	800 def runtime_library_dir_option (self, dir):
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	801 """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	802 directories searched for runtime libraries.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	803 """
12718 53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be Greg Ward <gward@python.net> parents: 12717 diff changeset	804 raise NotImplementedError
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be Greg Ward <gward@python.net> parents: 12717 diff changeset	805
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be Greg Ward <gward@python.net> parents: 12717 diff changeset	806 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	807 """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	808 linked into the shared library or executable.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	809 """
12718 53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be Greg Ward <gward@python.net> parents: 12717 diff changeset	810 raise NotImplementedError
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be Greg Ward <gward@python.net> parents: 12717 diff changeset	811
28801 a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	812 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	813 includes=None,
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	814 include_dirs=None,
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	815 libraries=None,
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	816 library_dirs=None):
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	817 """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	818 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	819 augment the compilation environment.
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	820 """
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	821
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	822 # 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	823 # 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	824 # 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	825 import tempfile
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	826 if includes is None:
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	827 includes = []
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	828 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	829 include_dirs = []
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	830 if libraries is None:
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	831 libraries = []
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	832 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	833 library_dirs = []
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	834 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	835 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	836 for incl in includes:
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	837 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	838 f.write("""\
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	839 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	840 %s();
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	841 }
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	842 """ % funcname)
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	843 f.close()
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	844 try:
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	845 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	846 except CompileError:
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	847 return False
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	848
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	849 try:
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	850 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	851 libraries=libraries,
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	852 library_dirs=library_dirs)
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	853 except (LinkError, TypeError):
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	854 return False
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	855 return True
a9b56c78e0d6 new method: has_function() - returns a boolean indicating whether the Skip Montanaro <skip@pobox.com> parents: 28078 diff changeset	856
13843 00a5c806cf7c Added 'debug' flag to 'find_library_file()'. Greg Ward <gward@python.net> parents: 13809 diff changeset	857 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	858 """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	859 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	860 '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	861 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	862 the specified directories.
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	863 """
12718 53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be Greg Ward <gward@python.net> parents: 12717 diff changeset	864 raise NotImplementedError
53e54bd4e5f4 Lyle Johnson: added stubs for the four miscellaneous methods that must be Greg Ward <gward@python.net> parents: 12717 diff changeset	865
11915 7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	866 # -- 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	867
11915 7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	868 # 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	869 # 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	870 # * 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	871 # (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	872 # * 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	873 # 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	874 # "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	875 # * 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	876 # 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	877 # Windows
7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	878 #
7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	879 # 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	880 # 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	881 # 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	882 # * src_extensions -
7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	883 # 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	884 # * obj_extension -
7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	885 # 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	886 # * 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	887 # 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	888 # * 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	889 # 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	890 # * 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	891 # 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	892 # 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	893 # * 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	894 # 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	895 # (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	896 # 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	897 # * exe_extension -
7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	898 # 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	899
23821 3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	900 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	901 if output_dir is None:
d124fb087778 Commit fix for SF 603831. Guido van Rossum <guido@python.org> parents: 25212 diff changeset	902 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	903 obj_names = []
7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	904 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	905 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	906 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	907 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	908 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	909 raise UnknownFileError, \
23821 3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	910 "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	911 if strip_dir:
23821 3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	912 base = os.path.basename(base)
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	913 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	914 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	915 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	916
23821 3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	917 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	918 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	919 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	920 basename = os.path.basename (basename)
23821 3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	921 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	922
23821 3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	923 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	924 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	925 if strip_dir:
afd7ece37c46 Big patch from Rene Liebscher to simplify the CCompiler API and Greg Ward <gward@python.net> parents: 13846 diff changeset	926 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	927 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	928
23821 3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	929 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	930 strip_dir=0, output_dir=''):
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	931 assert output_dir is not None
3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	932 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	933 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	934 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	935 ext = getattr(self, lib_type + "_lib_extension")
11245 854b801253f0 Patch from Perry Stoll: Greg Ward <gward@python.net> parents: 11196 diff changeset	936
23821 3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	937 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	938 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	939 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	940 dir = ''
7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	941
23821 3126c4262962 Extend compiler() method with optional depends argument. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23668 diff changeset	942 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	943
11196 1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and Greg Ward <gward@python.net> parents: 11117 diff changeset	944
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and Greg Ward <gward@python.net> parents: 11117 diff changeset	945 # -- Utility methods -----------------------------------------------
1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and Greg Ward <gward@python.net> parents: 11117 diff changeset	946
11274 efa75c69857d Added 'output_dir' attribute, and 'output_dir' parameter to several method Greg Ward <gward@python.net> parents: 11258 diff changeset	947 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	948 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	949
13846 0525851ba0b7 Added 'debug_print()'. Greg Ward <gward@python.net> parents: 13843 diff changeset	950 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	951 from distutils.debug import DEBUG
13846 0525851ba0b7 Added 'debug_print()'. Greg Ward <gward@python.net> parents: 13843 diff changeset	952 if DEBUG:
0525851ba0b7 Added 'debug_print()'. Greg Ward <gward@python.net> parents: 13843 diff changeset	953 print msg
0525851ba0b7 Added 'debug_print()'. Greg Ward <gward@python.net> parents: 13843 diff changeset	954
11358 be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name Greg Ward <gward@python.net> parents: 11335 diff changeset	955 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	956 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	957
13809 f3968dd1711b Added 'execute()' method, a thin wrapper around 'util.execute() (just like Greg Ward <gward@python.net> parents: 13725 diff changeset	958 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	959 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	960
11196 1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and Greg Ward <gward@python.net> parents: 11117 diff changeset	961 def spawn (self, cmd):
23668 ca87119255eb Make setup.py less chatty by default. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23272 diff changeset	962 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	963
11274 efa75c69857d Added 'output_dir' attribute, and 'output_dir' parameter to several method Greg Ward <gward@python.net> parents: 11258 diff changeset	964 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	965 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	966
11889 1a49b6144f0d Added 'mkpath()' method: convenience wrapper around 'util.mkpath()' that adds Greg Ward <gward@python.net> parents: 11728 diff changeset	967 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	968 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	969
11196 1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and Greg Ward <gward@python.net> parents: 11117 diff changeset	970
11117 da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	971 # class CCompiler
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	972
da9c83b5fb07 The abstract base class that defines the C/C++ compiler abstraction model. Greg Ward <gward@python.net> parents: diff changeset	973
16674 f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	974 # 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	975 # 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	976 # 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	977 # OS names.
f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	978 _default_compilers = (
f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	979
f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	980 # 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	981
e0062e89d8f4 Patch #403947: On Cygwin, use the Unix compiler class, and not Andrew M. Kuchling <amk@amk.ca> parents: 16674 diff changeset	982 # 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	983 # compiler
e0062e89d8f4 Patch #403947: On Cygwin, use the Unix compiler class, and not Andrew M. Kuchling <amk@amk.ca> parents: 16674 diff changeset	984 ('cygwin.*', 'unix'),
21851 e0fc286d57a4 OS/2 patches by Andrew I MacIntyre for distutils. Marc-André Lemburg <mal@egenix.com> parents: 21267 diff changeset	985 ('os2emx', 'emx'),
21267 7a7f557b4d54 Whitespace normalization. Fred Drake <fdrake@acm.org> parents: 19498 diff changeset	986
16674 f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	987 # OS name mappings
f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	988 ('posix', 'unix'),
f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	989 ('nt', 'msvc'),
f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	990 ('mac', 'mwerks'),
21267 7a7f557b4d54 Whitespace normalization. Fred Drake <fdrake@acm.org> parents: 19498 diff changeset	991
16674 f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	992 )
f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	993
f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	994 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	995
f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	996 """ 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	997
f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	998 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	999 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	1000 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	1001
f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	1002 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	1003 parameters are not given.
f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	1004
f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	1005 """
f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	1006 if osname is None:
f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	1007 osname = os.name
f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	1008 if platform is None:
f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	1009 platform = sys.platform
f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	1010 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	1011 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	1012 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	1013 return compiler
f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	1014 # Default to Unix compiler
f4e97ec1dc9a This patch makes the default compiler determination more flexible Marc-André Lemburg <mal@egenix.com> parents: 15903 diff changeset	1015 return 'unix'
11335 3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods, Greg Ward <gward@python.net> parents: 11304 diff changeset	1016
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods, Greg Ward <gward@python.net> parents: 11304 diff changeset	1017 # 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	1018 # 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	1019 # 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	1020 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	1021 "standard UNIX-style compiler"),
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch. Greg Ward <gward@python.net> parents: 12977 diff changeset	1022 'msvc': ('msvccompiler', 'MSVCCompiler',
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch. Greg Ward <gward@python.net> parents: 12977 diff changeset	1023 "Microsoft Visual C++"),
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch. Greg Ward <gward@python.net> parents: 12977 diff changeset	1024 'cygwin': ('cygwinccompiler', 'CygwinCCompiler',
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch. Greg Ward <gward@python.net> parents: 12977 diff changeset	1025 "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	1026 'mingw32': ('cygwinccompiler', 'Mingw32CCompiler',
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch. Greg Ward <gward@python.net> parents: 12977 diff changeset	1027 "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	1028 'bcpp': ('bcppcompiler', 'BCPPCompiler',
72058dc7d545 Lyle Johnson: added 'build_temp' parameter to 'link_shared_{lib,object}()' Greg Ward <gward@python.net> parents: 13008 diff changeset	1029 "Borland C++ Compiler"),
15880 3ea10ee91e9c Fix from Jack Jansen for the Mac and the Metrowerks compiler, posted Andrew M. Kuchling <amk@amk.ca> parents: 14891 diff changeset	1030 'mwerks': ('mwerkscompiler', 'MWerksCompiler',
3ea10ee91e9c Fix from Jack Jansen for the Mac and the Metrowerks compiler, posted Andrew M. Kuchling <amk@amk.ca> parents: 14891 diff changeset	1031 "MetroWerks CodeWarrior"),
21851 e0fc286d57a4 OS/2 patches by Andrew I MacIntyre for distutils. Marc-André Lemburg <mal@egenix.com> parents: 21267 diff changeset	1032 'emx': ('emxccompiler', 'EMXCCompiler',
e0fc286d57a4 OS/2 patches by Andrew I MacIntyre for distutils. Marc-André Lemburg <mal@egenix.com> parents: 21267 diff changeset	1033 "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	1034 }
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods, Greg Ward <gward@python.net> parents: 11304 diff changeset	1035
12869 88872791998a Patch from Rene Liebscher: this adds "--help-foo" options to list the Greg Ward <gward@python.net> parents: 12792 diff changeset	1036 def show_compilers():
12997 27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch. Greg Ward <gward@python.net> parents: 12977 diff changeset	1037 """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	1038 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	1039 """
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch. Greg Ward <gward@python.net> parents: 12977 diff changeset	1040 # 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	1041 # "--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	1042 # commands that use it.
21267 7a7f557b4d54 Whitespace normalization. Fred Drake <fdrake@acm.org> parents: 19498 diff changeset	1043 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	1044 compilers = []
12869 88872791998a Patch from Rene Liebscher: this adds "--help-foo" options to list the Greg Ward <gward@python.net> parents: 12792 diff changeset	1045 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	1046 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	1047 compiler_class[compiler][2]))
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch. Greg Ward <gward@python.net> parents: 12977 diff changeset	1048 compilers.sort()
27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch. Greg Ward <gward@python.net> parents: 12977 diff changeset	1049 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	1050 pretty_printer.print_help("List of available compilers:")
21267 7a7f557b4d54 Whitespace normalization. Fred Drake <fdrake@acm.org> parents: 19498 diff changeset	1051
11335 3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods, Greg Ward <gward@python.net> parents: 11304 diff changeset	1052
11196 1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and Greg Ward <gward@python.net> parents: 11117 diff changeset	1053 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	1054 compiler=None,
11196 1c8e4227d987 Added 'verbose' and 'dry_run' flags to CCompiler constructor and Greg Ward <gward@python.net> parents: 11117 diff changeset	1055 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	1056 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	1057 force=0):
11335 3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods, Greg Ward <gward@python.net> parents: 11304 diff changeset	1058 """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	1059 platform/compiler combination. 'plat' defaults to 'os.name'
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	1060 (eg. 'posix', 'nt'), and 'compiler' defaults to the default compiler
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	1061 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	1062 the default compilers are "traditional Unix interface" (UnixCCompiler
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	1063 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	1064 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	1065 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	1066 'compiler', 'plat' is ignored.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	1067 """
11335 3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods, Greg Ward <gward@python.net> parents: 11304 diff changeset	1068 if plat is None:
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods, Greg Ward <gward@python.net> parents: 11304 diff changeset	1069 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	1070
11335 3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods, Greg Ward <gward@python.net> parents: 11304 diff changeset	1071 try:
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods, Greg Ward <gward@python.net> parents: 11304 diff changeset	1072 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	1073 compiler = get_default_compiler(plat)
21267 7a7f557b4d54 Whitespace normalization. Fred Drake <fdrake@acm.org> parents: 19498 diff changeset	1074
12997 27f3a18fd296 Stylistic/formatting changes to Rene Liebscher's '--help-xxx' patch. Greg Ward <gward@python.net> parents: 12977 diff changeset	1075 (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	1076 except KeyError:
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods, Greg Ward <gward@python.net> parents: 11304 diff changeset	1077 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	1078 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	1079 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	1080 raise DistutilsPlatformError, msg
21267 7a7f557b4d54 Whitespace normalization. Fred Drake <fdrake@acm.org> parents: 19498 diff changeset	1081
11335 3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods, Greg Ward <gward@python.net> parents: 11304 diff changeset	1082 try:
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods, Greg Ward <gward@python.net> parents: 11304 diff changeset	1083 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	1084 __import__ (module_name)
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods, Greg Ward <gward@python.net> parents: 11304 diff changeset	1085 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	1086 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	1087 except ImportError:
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods, Greg Ward <gward@python.net> parents: 11304 diff changeset	1088 raise DistutilsModuleError, \
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods, Greg Ward <gward@python.net> parents: 11304 diff changeset	1089 "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	1090 module_name
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods, Greg Ward <gward@python.net> parents: 11304 diff changeset	1091 except KeyError:
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods, Greg Ward <gward@python.net> parents: 11304 diff changeset	1092 raise DistutilsModuleError, \
3d154be87162 Added 'extra_preargs' and 'extra_postargs' parameters to most methods, Greg Ward <gward@python.net> parents: 11304 diff changeset	1093 ("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	1094 "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	1095
23668 ca87119255eb Make setup.py less chatty by default. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23272 diff changeset	1096 # 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	1097 # 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	1098 # argument.
ca87119255eb Make setup.py less chatty by default. Jeremy Hylton <jeremy@alum.mit.edu> parents: 23272 diff changeset	1099 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	1100
2341be74b758 os.name is "posix" or "nt" or we don't care. Greg Ward <gward@python.net> parents: 11245 diff changeset	1101
11547 236d8428c4c5 Catch up with terminology change in UnixCCompiler: 'includes' -> 'include_dirs'. Greg Ward <gward@python.net> parents: 11358 diff changeset	1102 def gen_preprocess_options (macros, include_dirs):
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	1103 """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	1104 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	1105 '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	1106 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	1107 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	1108 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	1109 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	1110 C++.
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	1111 """
11258 2341be74b758 os.name is "posix" or "nt" or we don't care. Greg Ward <gward@python.net> parents: 11245 diff changeset	1112 # 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	1113 # 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	1114 # 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	1115 # 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	1116 # 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	1117 # 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	1118 # 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	1119 # '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	1120 # 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	1121 # 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	1122 # 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	1123
2341be74b758 os.name is "posix" or "nt" or we don't care. Greg Ward <gward@python.net> parents: 11245 diff changeset	1124 pp_opts = []
2341be74b758 os.name is "posix" or "nt" or we don't care. Greg Ward <gward@python.net> parents: 11245 diff changeset	1125 for macro in macros:
11304 424b31af6d51 Typecheck elements of 'macros' parameter in 'gen_preprocess_options(). Greg Ward <gward@python.net> parents: 11274 diff changeset	1126
424b31af6d51 Typecheck elements of 'macros' parameter in 'gen_preprocess_options(). Greg Ward <gward@python.net> parents: 11274 diff changeset	1127 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	1128 1 <= len (macro) <= 2):
424b31af6d51 Typecheck elements of 'macros' parameter in 'gen_preprocess_options(). Greg Ward <gward@python.net> parents: 11274 diff changeset	1129 raise TypeError, \
424b31af6d51 Typecheck elements of 'macros' parameter in 'gen_preprocess_options(). Greg Ward <gward@python.net> parents: 11274 diff changeset	1130 ("bad macro definition '%s': " +
424b31af6d51 Typecheck elements of 'macros' parameter in 'gen_preprocess_options(). Greg Ward <gward@python.net> parents: 11274 diff changeset	1131 "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	1132 macro
424b31af6d51 Typecheck elements of 'macros' parameter in 'gen_preprocess_options(). Greg Ward <gward@python.net> parents: 11274 diff changeset	1133
11258 2341be74b758 os.name is "posix" or "nt" or we don't care. Greg Ward <gward@python.net> parents: 11245 diff changeset	1134 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	1135 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	1136 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	1137 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	1138 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	1139 else:
2341be74b758 os.name is "posix" or "nt" or we don't care. Greg Ward <gward@python.net> parents: 11245 diff changeset	1140 # 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	1141 # 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	1142 # 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	1143 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	1144
11547 236d8428c4c5 Catch up with terminology change in UnixCCompiler: 'includes' -> 'include_dirs'. Greg Ward <gward@python.net> parents: 11358 diff changeset	1145 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	1146 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	1147
2341be74b758 os.name is "posix" or "nt" or we don't care. Greg Ward <gward@python.net> parents: 11245 diff changeset	1148 return pp_opts
2341be74b758 os.name is "posix" or "nt" or we don't care. Greg Ward <gward@python.net> parents: 11245 diff changeset	1149
2341be74b758 os.name is "posix" or "nt" or we don't care. Greg Ward <gward@python.net> parents: 11245 diff changeset	1150 # gen_preprocess_options ()
2341be74b758 os.name is "posix" or "nt" or we don't care. Greg Ward <gward@python.net> parents: 11245 diff changeset	1151
2341be74b758 os.name is "posix" or "nt" or we don't care. Greg Ward <gward@python.net> parents: 11245 diff changeset	1152
12016 13fd0dfec560 Changed to pay attention to the 'runtime_library_dirs' list (= 'rpath' Greg Ward <gward@python.net> parents: 11955 diff changeset	1153 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	1154 """Generate linker options for searching library directories and
13005 82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	1155 linking with specific libraries. 'libraries' and 'library_dirs' are,
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	1156 respectively, lists of library names (not filenames!) and search
82181e820de3 Docstring reformatting/tweaking binge. Greg Ward <gward@python.net> parents: 13002 diff changeset	1157 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	1158 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	1159 """
11258 2341be74b758 os.name is "posix" or "nt" or we don't care. Greg Ward <gward@python.net> parents: 11245 diff changeset	1160 lib_opts = []
2341be74b758 os.name is "posix" or "nt" or we don't care. Greg Ward <gward@python.net> parents: 11245 diff changeset	1161
2341be74b758 os.name is "posix" or "nt" or we don't care. Greg Ward <gward@python.net> parents: 11245 diff changeset	1162 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	1163 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	1164
12016 13fd0dfec560 Changed to pay attention to the 'runtime_library_dirs' list (= 'rpath' Greg Ward <gward@python.net> parents: 11955 diff changeset	1165 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	1166 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	1167 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	1168 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	1169 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	1170 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	1171
11258 2341be74b758 os.name is "posix" or "nt" or we don't care. Greg Ward <gward@python.net> parents: 11245 diff changeset	1172 # 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	1173 # 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	1174 # 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	1175 # -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	1176 # 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	1177
2341be74b758 os.name is "posix" or "nt" or we don't care. Greg Ward <gward@python.net> parents: 11245 diff changeset	1178 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	1179 (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	1180 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	1181 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	1182 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	1183 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	1184 else:
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name Greg Ward <gward@python.net> parents: 11335 diff changeset	1185 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	1186 "'%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	1187 else:
be603fcba001 Slight change to the meaning of the 'libraries' list: if a library name Greg Ward <gward@python.net> parents: 11335 diff changeset	1188 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	1189
2341be74b758 os.name is "posix" or "nt" or we don't care. Greg Ward <gward@python.net> parents: 11245 diff changeset	1190 return lib_opts
2341be74b758 os.name is "posix" or "nt" or we don't care. Greg Ward <gward@python.net> parents: 11245 diff changeset	1191
11915 7922d08426ca Serious overhaul of the C compiler interface and the two classes that Greg Ward <gward@python.net> parents: 11897 diff changeset	1192 # gen_lib_options ()

Mercurial > cpython-lru_cache-weakref

annotate Lib/distutils/ccompiler.py @ 58925:eecf1bef052d 2.6