[wxWidgets.git] / wxPython / distutils / bcppcompiler.py

"""distutils.bcppcompiler

Contains BorlandCCompiler, an implementation of the abstract CCompiler class
for the Borland C++ compiler.
"""

# This implementation by Lyle Johnson, based on the original msvccompiler.py
# module and using the directions originally published by Gordon Williams.

# XXX looks like there's a LOT of overlap between these two classes:
# someone should sit down and factor out the common code as
# WindowsCCompiler!  --GPW

# This module should be kept compatible with Python 1.5.2.

__revision__ = "$Id$"


import sys, os
from distutils.errors import \
     DistutilsExecError, DistutilsPlatformError, \
     CompileError, LibError, LinkError, UnknownFileError
from distutils.ccompiler import \
     CCompiler, gen_preprocess_options, gen_lib_options
from distutils.file_util import write_file
from distutils.dep_util import newer
from distutils import log

class BCPPCompiler(CCompiler) :
    """Concrete class that implements an interface to the Borland C/C++
    compiler, as defined by the CCompiler abstract class.
    """

    compiler_type = 'bcpp'

    # Just set this so CCompiler's constructor doesn't barf.  We currently
    # don't use the 'set_executables()' bureaucracy provided by CCompiler,
    # as it really isn't necessary for this sort of single-compiler class.
    # Would be nice to have a consistent interface with UnixCCompiler,
    # though, so it's worth thinking about.
    executables = {}

    # Private class data (need to distinguish C from C++ source for compiler)
    _c_extensions = ['.c']
    _cpp_extensions = ['.cc', '.cpp', '.cxx']

    # Needed for the filename generation methods provided by the
    # base class, CCompiler.
    src_extensions = _c_extensions + _cpp_extensions
    obj_extension = '.obj'
    static_lib_extension = '.lib'
    shared_lib_extension = '.dll'
    static_lib_format = shared_lib_format = '%s%s'
    exe_extension = '.exe'


    def __init__ (self,
                  verbose=0,
                  dry_run=0,
                  force=0):

        CCompiler.__init__ (self, verbose, dry_run, force)

        # These executables are assumed to all be in the path.
        # Borland doesn't seem to use any special registry settings to
        # indicate their installation locations.

        self.cc = "bcc32.exe"
        self.linker = "ilink32.exe"
        self.lib = "tlib.exe"

        self.preprocess_options = None
        self.compile_options = ['/tWM', '/O2', '/q', '/g0']
        self.compile_options_debug = ['/tWM', '/Od', '/q', '/g0']

        self.ldflags_shared = ['/Tpd', '/Gn', '/q', '/x']
        self.ldflags_shared_debug = ['/Tpd', '/Gn', '/q', '/x']
        self.ldflags_static = []
        self.ldflags_exe = ['/Gn', '/q', '/x']
        self.ldflags_exe_debug = ['/Gn', '/q', '/x','/r']


    # -- Worker methods ------------------------------------------------

    def compile(self, sources,
                output_dir=None, macros=None, include_dirs=None, debug=0,
                extra_preargs=None, extra_postargs=None, depends=None):
        
        macros, objects, extra_postargs, pp_opts, build = \
                self._setup_compile(output_dir, macros, include_dirs, sources,
                                    depends, extra_postargs)
        compile_opts = extra_preargs or []
        compile_opts.append ('-c')
        if debug:
            compile_opts.extend (self.compile_options_debug)
        else:
            compile_opts.extend (self.compile_options)

        for obj, (src, ext) in build.items():
            # XXX why do the normpath here?
            src = os.path.normpath(src)
            obj = os.path.normpath(obj)
            # XXX _setup_compile() did a mkpath() too but before the normpath.
            # Is it possible to skip the normpath?
            self.mkpath(os.path.dirname(obj))

            if ext == '.res':
                # This is already a binary file -- skip it.
                continue # the 'for' loop
            if ext == '.rc':
                # This needs to be compiled to a .res file -- do it now.
                try:
                    self.spawn (["brcc32", "-fo", obj, src])
                except DistutilsExecError, msg:
                    raise CompileError, msg
                continue # the 'for' loop

            # The next two are both for the real compiler.
            if ext in self._c_extensions:
                input_opt = ""
            elif ext in self._cpp_extensions:
                input_opt = "-P"
            else:
                # Unknown file type -- no extra options.  The compiler
                # will probably fail, but let it just in case this is a
                # file the compiler recognizes even if we don't.
                input_opt = ""

            output_opt = "-o" + obj

            # Compiler command line syntax is: "bcc32 [options] file(s)".
            # Note that the source file names must appear at the end of
            # the command line.
            try:
                self.spawn ([self.cc] + compile_opts + pp_opts +
                            [input_opt, output_opt] +
                            extra_postargs + [src])
            except DistutilsExecError, msg:
                raise CompileError, msg

        return objects

    # compile ()


    def create_static_lib (self,
                           objects,
                           output_libname,
                           output_dir=None,
                           debug=0,
                           target_lang=None):

        (objects, output_dir) = self._fix_object_args (objects, output_dir)
        output_filename = \
            self.library_filename (output_libname, output_dir=output_dir)

        if self._need_link (objects, output_filename):
            lib_args = [output_filename, '/u'] + objects
            if debug:
                pass                    # XXX what goes here?
            try:
                self.spawn ([self.lib] + lib_args)
            except DistutilsExecError, msg:
                raise LibError, msg
        else:
            log.debug("skipping %s (up-to-date)", output_filename)

    # create_static_lib ()


    def link (self,
              target_desc,
              objects,
              output_filename,
              output_dir=None,
              libraries=None,
              library_dirs=None,
              runtime_library_dirs=None,
              export_symbols=None,
              debug=0,
              extra_preargs=None,
              extra_postargs=None,
              build_temp=None,
              target_lang=None):

        # XXX this ignores 'build_temp'!  should follow the lead of
        # msvccompiler.py

        (objects, output_dir) = self._fix_object_args (objects, output_dir)
        (libraries, library_dirs, runtime_library_dirs) = \
            self._fix_lib_args (libraries, library_dirs, runtime_library_dirs)

        if runtime_library_dirs:
            log.warn("I don't know what to do with 'runtime_library_dirs': %s",
                     str(runtime_library_dirs))

        if output_dir is not None:
            output_filename = os.path.join (output_dir, output_filename)

        if self._need_link (objects, output_filename):

            # Figure out linker args based on type of target.
            if target_desc == CCompiler.EXECUTABLE:
                startup_obj = 'c0w32'
                if debug:
                    ld_args = self.ldflags_exe_debug[:]
                else:
                    ld_args = self.ldflags_exe[:]
            else:
                startup_obj = 'c0d32'
                if debug:
                    ld_args = self.ldflags_shared_debug[:]
                else:
                    ld_args = self.ldflags_shared[:]


            # Create a temporary exports file for use by the linker
            if export_symbols is None:
                def_file = ''
            else:
                head, tail = os.path.split (output_filename)
                modname, ext = os.path.splitext (tail)
                temp_dir = os.path.dirname(objects[0]) # preserve tree structure
                def_file = os.path.join (temp_dir, '%s.def' % modname)
                contents = ['EXPORTS']
                for sym in (export_symbols or []):
                    contents.append('  %s=_%s' % (sym, sym))
                self.execute(write_file, (def_file, contents),
                             "writing %s" % def_file)

            # Borland C++ has problems with '/' in paths
            objects2 = map(os.path.normpath, objects)
            # split objects in .obj and .res files
            # Borland C++ needs them at different positions in the command line
            objects = [startup_obj]
            resources = []
            for file in objects2:
                (base, ext) = os.path.splitext(os.path.normcase(file))
                if ext == '.res':
                    resources.append(file)
                else:
                    objects.append(file)


            for l in library_dirs:
                ld_args.append("/L%s" % os.path.normpath(l))
            ld_args.append("/L.") # we sometimes use relative paths

            # list of object files
            ld_args.extend(objects)

            # XXX the command-line syntax for Borland C++ is a bit wonky;
            # certain filenames are jammed together in one big string, but
            # comma-delimited.  This doesn't mesh too well with the
            # Unix-centric attitude (with a DOS/Windows quoting hack) of
            # 'spawn()', so constructing the argument list is a bit
            # awkward.  Note that doing the obvious thing and jamming all
            # the filenames and commas into one argument would be wrong,
            # because 'spawn()' would quote any filenames with spaces in
            # them.  Arghghh!.  Apparently it works fine as coded...

            # name of dll/exe file
            ld_args.extend([',',output_filename])
            # no map file and start libraries
            ld_args.append(',,')

            for lib in libraries:
                # see if we find it and if there is a bcpp specific lib
                # (xxx_bcpp.lib)
                libfile = self.find_library_file(library_dirs, lib, debug)
                if libfile is None:
                    ld_args.append(lib)
                    # probably a BCPP internal library -- don't warn
                else:
                    # full name which prefers bcpp_xxx.lib over xxx.lib
                    ld_args.append(libfile)

            # some default libraries
            ld_args.append ('import32')
            ld_args.append ('cw32mt')

            # def file for export symbols
            ld_args.extend([',',def_file])
            # add resource files
            ld_args.append(',')
            ld_args.extend(resources)


            if extra_preargs:
                ld_args[:0] = extra_preargs
            if extra_postargs:
                ld_args.extend(extra_postargs)

            self.mkpath (os.path.dirname (output_filename))
            try:
                self.spawn ([self.linker] + ld_args)
            except DistutilsExecError, msg:
                raise LinkError, msg

        else:
            log.debug("skipping %s (up-to-date)", output_filename)

    # link ()

    # -- Miscellaneous methods -----------------------------------------


    def find_library_file (self, dirs, lib, debug=0):
        # List of effective library names to try, in order of preference:
        # xxx_bcpp.lib is better than xxx.lib
        # and xxx_d.lib is better than xxx.lib if debug is set
        #
        # The "_bcpp" suffix is to handle a Python installation for people
        # with multiple compilers (primarily Distutils hackers, I suspect
        # ;-).  The idea is they'd have one static library for each
        # compiler they care about, since (almost?) every Windows compiler
        # seems to have a different format for static libraries.
        if debug:
            dlib = (lib + "_d")
            try_names = (dlib + "_bcpp", lib + "_bcpp", dlib, lib)
        else:
            try_names = (lib + "_bcpp", lib)

        for dir in dirs:
            for name in try_names:
                libfile = os.path.join(dir, self.library_filename(name))
                if os.path.exists(libfile):
                    return libfile
        else:
            # Oops, didn't find it in *any* of 'dirs'
            return None

    # overwrite the one from CCompiler to support rc and res-files
    def object_filenames (self,
                          source_filenames,
                          strip_dir=0,
                          output_dir=''):
        if output_dir is None: output_dir = ''
        obj_names = []
        for src_name in source_filenames:
            # use normcase to make sure '.rc' is really '.rc' and not '.RC'
            (base, ext) = os.path.splitext (os.path.normcase(src_name))
            if ext not in (self.src_extensions + ['.rc','.res']):
                raise UnknownFileError, \
                      "unknown file type '%s' (from '%s')" % \
                      (ext, src_name)
            if strip_dir:
                base = os.path.basename (base)
            if ext == '.res':
                # these can go unchanged
                obj_names.append (os.path.join (output_dir, base + ext))
            elif ext == '.rc':
                # these need to be compiled to .res-files
                obj_names.append (os.path.join (output_dir, base + '.res'))
            else:
                obj_names.append (os.path.join (output_dir,
                                            base + self.obj_extension))
        return obj_names

    # object_filenames ()

    def preprocess (self,
                    source,
                    output_file=None,
                    macros=None,
                    include_dirs=None,
                    extra_preargs=None,
                    extra_postargs=None):

        (_, macros, include_dirs) = \
            self._fix_compile_args(None, macros, include_dirs)
        pp_opts = gen_preprocess_options(macros, include_dirs)
        pp_args = ['cpp32.exe'] + pp_opts
        if output_file is not None:
            pp_args.append('-o' + output_file)
        if extra_preargs:
            pp_args[:0] = extra_preargs
        if extra_postargs:
            pp_args.extend(extra_postargs)
        pp_args.append(source)

        # We need to preprocess: either we're being forced to, or the
        # source file is newer than the target (or the target doesn't
        # exist).
        if self.force or output_file is None or newer(source, output_file):
            if output_file:
                self.mkpath(os.path.dirname(output_file))
            try:
                self.spawn(pp_args)
            except DistutilsExecError, msg:
                print msg
                raise CompileError, msg

    # preprocess()
Commit	Line	Data
1e4a197e RD	1	"""distutils.bcppcompiler
	2
	3	Contains BorlandCCompiler, an implementation of the abstract CCompiler class
	4	for the Borland C++ compiler.
	5	"""
	6
	7	# This implementation by Lyle Johnson, based on the original msvccompiler.py
	8	# module and using the directions originally published by Gordon Williams.
	9
	10	# XXX looks like there's a LOT of overlap between these two classes:
	11	# someone should sit down and factor out the common code as
	12	# WindowsCCompiler! --GPW
	13
	14	# This module should be kept compatible with Python 1.5.2.
	15
	16	__revision__ = "$Id$"
	17
	18
	19	import sys, os
	20	from distutils.errors import \
	21	DistutilsExecError, DistutilsPlatformError, \
	22	CompileError, LibError, LinkError, UnknownFileError
	23	from distutils.ccompiler import \
	24	CCompiler, gen_preprocess_options, gen_lib_options
	25	from distutils.file_util import write_file
	26	from distutils.dep_util import newer
	27	from distutils import log
	28
	29	class BCPPCompiler(CCompiler) :
	30	"""Concrete class that implements an interface to the Borland C/C++
	31	compiler, as defined by the CCompiler abstract class.
	32	"""
	33
	34	compiler_type = 'bcpp'
	35
	36	# Just set this so CCompiler's constructor doesn't barf. We currently
	37	# don't use the 'set_executables()' bureaucracy provided by CCompiler,
	38	# as it really isn't necessary for this sort of single-compiler class.
	39	# Would be nice to have a consistent interface with UnixCCompiler,
	40	# though, so it's worth thinking about.
	41	executables = {}
	42
	43	# Private class data (need to distinguish C from C++ source for compiler)
	44	_c_extensions = ['.c']
	45	_cpp_extensions = ['.cc', '.cpp', '.cxx']
	46
	47	# Needed for the filename generation methods provided by the
	48	# base class, CCompiler.
	49	src_extensions = _c_extensions + _cpp_extensions
	50	obj_extension = '.obj'
	51	static_lib_extension = '.lib'
	52	shared_lib_extension = '.dll'
	53	static_lib_format = shared_lib_format = '%s%s'
	54	exe_extension = '.exe'
	55
	56
	57	def __init__ (self,
	58	verbose=0,
	59	dry_run=0,
	60	force=0):
	61
	62	CCompiler.__init__ (self, verbose, dry_run, force)
	63
	64	# These executables are assumed to all be in the path.
65	# Borland doesn't seem to use any special registry settings to
66	# indicate their installation locations.
67
68	self.cc = "bcc32.exe"
69	self.linker = "ilink32.exe"
70	self.lib = "tlib.exe"
71
72	self.preprocess_options = None
73	self.compile_options = ['/tWM', '/O2', '/q', '/g0']
74	self.compile_options_debug = ['/tWM', '/Od', '/q', '/g0']
75
76	self.ldflags_shared = ['/Tpd', '/Gn', '/q', '/x']
77	self.ldflags_shared_debug = ['/Tpd', '/Gn', '/q', '/x']
78	self.ldflags_static = []
79	self.ldflags_exe = ['/Gn', '/q', '/x']
80	self.ldflags_exe_debug = ['/Gn', '/q', '/x','/r']
81
82
83	# -- Worker methods ------------------------------------------------
84
85	def compile(self, sources,
86	output_dir=None, macros=None, include_dirs=None, debug=0,
87	extra_preargs=None, extra_postargs=None, depends=None):
88
89	macros, objects, extra_postargs, pp_opts, build = \
90	self._setup_compile(output_dir, macros, include_dirs, sources,
91	depends, extra_postargs)
92	compile_opts = extra_preargs or []
93	compile_opts.append ('-c')
94	if debug:
95	compile_opts.extend (self.compile_options_debug)
96	else:
97	compile_opts.extend (self.compile_options)
98
99	for obj, (src, ext) in build.items():
100	# XXX why do the normpath here?
101	src = os.path.normpath(src)
102	obj = os.path.normpath(obj)
103	# XXX _setup_compile() did a mkpath() too but before the normpath.
104	# Is it possible to skip the normpath?
105	self.mkpath(os.path.dirname(obj))
106
107	if ext == '.res':
108	# This is already a binary file -- skip it.
109	continue # the 'for' loop
110	if ext == '.rc':
111	# This needs to be compiled to a .res file -- do it now.
112	try:
113	self.spawn (["brcc32", "-fo", obj, src])
114	except DistutilsExecError, msg:
115	raise CompileError, msg
116	continue # the 'for' loop
117
118	# The next two are both for the real compiler.
119	if ext in self._c_extensions:
120	input_opt = ""
121	elif ext in self._cpp_extensions:
122	input_opt = "-P"
123	else:
124	# Unknown file type -- no extra options. The compiler
125	# will probably fail, but let it just in case this is a
126	# file the compiler recognizes even if we don't.
127	input_opt = ""
128
129	output_opt = "-o" + obj
130
131	# Compiler command line syntax is: "bcc32 [options] file(s)".
132	# Note that the source file names must appear at the end of
133	# the command line.
134	try:
135	self.spawn ([self.cc] + compile_opts + pp_opts +
136	[input_opt, output_opt] +
137	extra_postargs + [src])
138	except DistutilsExecError, msg:
139	raise CompileError, msg
140
141	return objects
142
143	# compile ()
144
145
146	def create_static_lib (self,
147	objects,
148	output_libname,
149	output_dir=None,
150	debug=0,
151	target_lang=None):
152
153	(objects, output_dir) = self._fix_object_args (objects, output_dir)
154	output_filename = \
155	self.library_filename (output_libname, output_dir=output_dir)
156
157	if self._need_link (objects, output_filename):
158	lib_args = [output_filename, '/u'] + objects
159	if debug:
160	pass # XXX what goes here?
161	try:
162	self.spawn ([self.lib] + lib_args)
163	except DistutilsExecError, msg:
164	raise LibError, msg
165	else:
166	log.debug("skipping %s (up-to-date)", output_filename)
167
168	# create_static_lib ()
169
170
171	def link (self,
172	target_desc,
173	objects,
174	output_filename,
175	output_dir=None,
176	libraries=None,
177	library_dirs=None,
178	runtime_library_dirs=None,
179	export_symbols=None,
180	debug=0,
181	extra_preargs=None,
182	extra_postargs=None,
183	build_temp=None,
184	target_lang=None):
185
186	# XXX this ignores 'build_temp'! should follow the lead of
187	# msvccompiler.py
188
189	(objects, output_dir) = self._fix_object_args (objects, output_dir)
190	(libraries, library_dirs, runtime_library_dirs) = \
191	self._fix_lib_args (libraries, library_dirs, runtime_library_dirs)
192
193	if runtime_library_dirs:
194	log.warn("I don't know what to do with 'runtime_library_dirs': %s",
195	str(runtime_library_dirs))
196
197	if output_dir is not None:
198	output_filename = os.path.join (output_dir, output_filename)
199
200	if self._need_link (objects, output_filename):
201
202	# Figure out linker args based on type of target.
203	if target_desc == CCompiler.EXECUTABLE:
204	startup_obj = 'c0w32'
205	if debug:
206	ld_args = self.ldflags_exe_debug[:]
207	else:
208	ld_args = self.ldflags_exe[:]
209	else:
210	startup_obj = 'c0d32'
211	if debug:
212	ld_args = self.ldflags_shared_debug[:]
213	else:
214	ld_args = self.ldflags_shared[:]
215
216
217	# Create a temporary exports file for use by the linker
218	if export_symbols is None:
219	def_file = ''
220	else:
221	head, tail = os.path.split (output_filename)
222	modname, ext = os.path.splitext (tail)
223	temp_dir = os.path.dirname(objects[0]) # preserve tree structure
224	def_file = os.path.join (temp_dir, '%s.def' % modname)
225	contents = ['EXPORTS']
226	for sym in (export_symbols or []):
227	contents.append(' %s=_%s' % (sym, sym))
228	self.execute(write_file, (def_file, contents),
229	"writing %s" % def_file)
230
231	# Borland C++ has problems with '/' in paths
232	objects2 = map(os.path.normpath, objects)
233	# split objects in .obj and .res files
234	# Borland C++ needs them at different positions in the command line
235	objects = [startup_obj]
236	resources = []
237	for file in objects2:
238	(base, ext) = os.path.splitext(os.path.normcase(file))
239	if ext == '.res':
240	resources.append(file)
241	else:
242	objects.append(file)
243
244
245	for l in library_dirs:
246	ld_args.append("/L%s" % os.path.normpath(l))
247	ld_args.append("/L.") # we sometimes use relative paths
248
249	# list of object files
250	ld_args.extend(objects)
251
252	# XXX the command-line syntax for Borland C++ is a bit wonky;
253	# certain filenames are jammed together in one big string, but
254	# comma-delimited. This doesn't mesh too well with the
255	# Unix-centric attitude (with a DOS/Windows quoting hack) of
256	# 'spawn()', so constructing the argument list is a bit
257	# awkward. Note that doing the obvious thing and jamming all
258	# the filenames and commas into one argument would be wrong,
259	# because 'spawn()' would quote any filenames with spaces in
260	# them. Arghghh!. Apparently it works fine as coded...
261
262	# name of dll/exe file
263	ld_args.extend([',',output_filename])
264	# no map file and start libraries
265	ld_args.append(',,')
266
267	for lib in libraries:
268	# see if we find it and if there is a bcpp specific lib
269	# (xxx_bcpp.lib)
270	libfile = self.find_library_file(library_dirs, lib, debug)
271	if libfile is None:
272	ld_args.append(lib)
273	# probably a BCPP internal library -- don't warn
274	else:
275	# full name which prefers bcpp_xxx.lib over xxx.lib
276	ld_args.append(libfile)
277
278	# some default libraries
279	ld_args.append ('import32')
280	ld_args.append ('cw32mt')
281
282	# def file for export symbols
283	ld_args.extend([',',def_file])
284	# add resource files
285	ld_args.append(',')
286	ld_args.extend(resources)
287
288
289	if extra_preargs:
290	ld_args[:0] = extra_preargs
291	if extra_postargs:
292	ld_args.extend(extra_postargs)
293
294	self.mkpath (os.path.dirname (output_filename))
295	try:
296	self.spawn ([self.linker] + ld_args)
297	except DistutilsExecError, msg:
298	raise LinkError, msg
299
300	else:
301	log.debug("skipping %s (up-to-date)", output_filename)
302
303	# link ()
304
305	# -- Miscellaneous methods -----------------------------------------
306
307
308	def find_library_file (self, dirs, lib, debug=0):
309	# List of effective library names to try, in order of preference:
310	# xxx_bcpp.lib is better than xxx.lib
311	# and xxx_d.lib is better than xxx.lib if debug is set
312	#
313	# The "_bcpp" suffix is to handle a Python installation for people
314	# with multiple compilers (primarily Distutils hackers, I suspect
315	# ;-). The idea is they'd have one static library for each
316	# compiler they care about, since (almost?) every Windows compiler
317	# seems to have a different format for static libraries.
318	if debug:
319	dlib = (lib + "_d")
320	try_names = (dlib + "_bcpp", lib + "_bcpp", dlib, lib)
321	else:
322	try_names = (lib + "_bcpp", lib)
323
324	for dir in dirs:
325	for name in try_names:
326	libfile = os.path.join(dir, self.library_filename(name))
327	if os.path.exists(libfile):
328	return libfile
329	else:
330	# Oops, didn't find it in any of 'dirs'
331	return None
332
333	# overwrite the one from CCompiler to support rc and res-files
334	def object_filenames (self,
335	source_filenames,
336	strip_dir=0,
337	output_dir=''):
338	if output_dir is None: output_dir = ''
339	obj_names = []
340	for src_name in source_filenames:
341	# use normcase to make sure '.rc' is really '.rc' and not '.RC'
342	(base, ext) = os.path.splitext (os.path.normcase(src_name))
343	if ext not in (self.src_extensions + ['.rc','.res']):
344	raise UnknownFileError, \
345	"unknown file type '%s' (from '%s')" % \
346	(ext, src_name)
347	if strip_dir:
348	base = os.path.basename (base)
349	if ext == '.res':
350	# these can go unchanged
351	obj_names.append (os.path.join (output_dir, base + ext))
352	elif ext == '.rc':
353	# these need to be compiled to .res-files
354	obj_names.append (os.path.join (output_dir, base + '.res'))
355	else:
356	obj_names.append (os.path.join (output_dir,
357	base + self.obj_extension))
358	return obj_names
359
360	# object_filenames ()
361
362	def preprocess (self,
363	source,
364	output_file=None,
365	macros=None,
366	include_dirs=None,
367	extra_preargs=None,
368	extra_postargs=None):
369
370	(_, macros, include_dirs) = \
371	self._fix_compile_args(None, macros, include_dirs)
372	pp_opts = gen_preprocess_options(macros, include_dirs)
373	pp_args = ['cpp32.exe'] + pp_opts
374	if output_file is not None:
375	pp_args.append('-o' + output_file)
376	if extra_preargs:
377	pp_args[:0] = extra_preargs
378	if extra_postargs:
379	pp_args.extend(extra_postargs)
380	pp_args.append(source)
381
382	# We need to preprocess: either we're being forced to, or the
383	# source file is newer than the target (or the target doesn't
384	# exist).
385	if self.force or output_file is None or newer(source, output_file):
386	if output_file:
387	self.mkpath(os.path.dirname(output_file))
388	try:
389	self.spawn(pp_args)
390	except DistutilsExecError, msg:
391	print msg
392	raise CompileError, msg
393
394	# preprocess()