"""distutils.ccompiler Contains MSVCCompiler, an implementation of the abstract CCompiler class for the Microsoft Visual Studio """ # created 1999/08/19, Perry Stoll # __rcsid__ = "$Id$" import os import sys from distutils.errors import * from distutils.ccompiler import \ CCompiler, gen_preprocess_options, gen_lib_options class MSVCCompiler (CCompiler) : """Concrete class that implements an interface to Microsoft Visual C++, as defined by the CCompiler abstract class.""" def __init__ (self, verbose=0, dry_run=0): CCompiler.__init__ (self, verbose, dry_run) # XXX This is a nasty dependency to add on something otherwise # pretty clean. move it to build_ext under an nt specific part. # shared libraries need to link against python15.lib self.add_library ( "python" + sys.version[0] + sys.version[2] ) self.add_library_dir( os.path.join( sys.exec_prefix, 'libs' ) ) self.cc = "cl.exe" self.link = "link.exe" self.preprocess_options = None self.compile_options = [ '/nologo' ] self.ldflags_shared = ['/DLL', '/nologo'] self.ldflags_static = [ '/nologo'] # -- Worker methods ------------------------------------------------ # (must be implemented by subclasses) _c_extensions = [ '.c' ] _cpp_extensions = [ '.cc', '.cpp' ] _obj_ext = '.obj' _exe_ext = '.exe' _shared_lib_ext = '.dll' _static_lib_ext = '.lib' def compile (self, sources, macros=None, includes=None): """Compile one or more C/C++ source files. 'sources' must be a list of strings, each one the name of a C/C++ source file. Return a list of the object filenames generated (one for each source filename in 'sources'). 'macros', if given, must be a list of macro definitions. A macro definition is either a (name, value) 2-tuple or a (name,) 1-tuple. The former defines a macro; if the value is None, the macro is defined without an explicit value. The 1-tuple case undefines a macro. Later definitions/redefinitions/ undefinitions take precedence. 'includes', if given, must be a list of strings, the directories to add to the default include file search path for this compilation only.""" if macros is None: macros = [] if includes is None: includes = [] objectFiles = [] base_pp_opts = gen_preprocess_options (self.macros + macros, self.include_dirs + includes) base_pp_opts.append('/c') for srcFile in sources: base,ext = os.path.splitext(srcFile) objFile = base + ".obj" if ext in self._c_extensions: fileOpt = "/Tc" elif ext in self._cpp_extensions: fileOpt = "/Tp" inputOpt = fileOpt + srcFile outputOpt = "/Fo" + objFile pp_opts = base_pp_opts + [ outputOpt, inputOpt ] self.spawn( [ self.cc ] + self.compile_options + pp_opts) objectFiles.append( objFile ) return objectFiles # XXX this is kind of useless without 'link_binary()' or # 'link_executable()' or something -- or maybe 'link_static_lib()' # should not exist at all, and we just have 'link_binary()'? def link_static_lib (self, objects, output_libname, libraries=None, library_dirs=None): """Link a bunch of stuff together to create a static library file. The "bunch of stuff" consists of the list of object files supplied as 'objects', the extra object files supplied to 'add_link_object()' and/or 'set_link_objects()', the libraries supplied to 'add_library()' and/or 'set_libraries()', and the libraries supplied as 'libraries' (if any). 'output_libname' should be a library name, not a filename; the filename will be inferred from the library name. 'library_dirs', if supplied, should be a list of additional directories to search on top of the system default and those supplied to 'add_library_dir()' and/or 'set_library_dirs()'.""" if libraries is None: libraries = [] if library_dirs is None: library_dirs = [] if build_info is None: build_info = {} lib_opts = gen_lib_options (self.libraries + libraries, self.library_dirs + library_dirs, "%s.lib", "/LIBPATH:%s") if build_info.has_key('def_file') : lib_opts.append('/DEF:' + build_info['def_file'] ) ld_args = self.ldflags_static + lib_opts + \ objects + ['/OUT:' + output_filename] self.spawn ( [ self.link ] + ld_args ) def link_shared_lib (self, objects, output_libname, libraries=None, library_dirs=None, build_info=None): """Link a bunch of stuff together to create a shared library file. Has the same effect as 'link_static_lib()' except that the filename inferred from 'output_libname' will most likely be different, and the type of file generated will almost certainly be different.""" # XXX should we sanity check the library name? (eg. no # slashes) self.link_shared_object (objects, self.shared_library_name(output_libname), build_info=build_info ) def link_shared_object (self, objects, output_filename, libraries=None, library_dirs=None, build_info=None): """Link a bunch of stuff together to create a shared object file. Much like 'link_shared_lib()', except the output filename is explicitly supplied as 'output_filename'.""" if libraries is None: libraries = [] if library_dirs is None: library_dirs = [] if build_info is None: build_info = {} lib_opts = gen_lib_options (self.libraries + libraries, self.library_dirs + library_dirs, "%s.lib", "/LIBPATH:%s") if build_info.has_key('def_file') : lib_opts.append('/DEF:' + build_info['def_file'] ) ld_args = self.ldflags_shared + lib_opts + \ objects + ['/OUT:' + output_filename] self.spawn ( [ self.link ] + ld_args ) # -- Filename mangling methods ------------------------------------- def _change_extensions( self, filenames, newExtension ): object_filenames = [] for srcFile in filenames: base,ext = os.path.splitext( srcFile ) # XXX should we strip off any existing path? object_filenames.append( base + newExtension ) return object_filenames def object_filenames (self, source_filenames): """Return the list of object filenames corresponding to each specified source filename.""" return self._change_extensions( source_filenames, self._obj_ext ) def shared_object_filename (self, source_filename): """Return the shared object filename corresponding to a specified source filename.""" return self._change_extensions( source_filenames, self._shared_lib_ext ) def library_filename (self, libname): """Return the static library filename corresponding to the specified library name.""" return "lib%s%s" %( libname, self._static_lib_ext ) def shared_library_filename (self, libname): """Return the shared library filename corresponding to the specified library name.""" return "lib%s%s" %( libname, self._shared_lib_ext ) # class MSVCCompiler