| """distutils.cygwinccompiler |
| |
| Provides the CygwinCCompiler class, a subclass of UnixCCompiler that |
| handles the Cygwin port of the GNU C compiler to Windows. It also contains |
| the Mingw32CCompiler class which handles the mingw32 port of GCC (same as |
| cygwin in no-cygwin mode). |
| """ |
| |
| # problems: |
| # |
| # * if you use a msvc compiled python version (1.5.2) |
| # 1. you have to insert a __GNUC__ section in its config.h |
| # 2. you have to generate a import library for its dll |
| # - create a def-file for python??.dll |
| # - create a import library using |
| # dlltool --dllname python15.dll --def python15.def \ |
| # --output-lib libpython15.a |
| # |
| # see also http://starship.python.net/crew/kernr/mingw32/Notes.html |
| # |
| # * We put export_symbols in a def-file, and don't use |
| # --export-all-symbols because it doesn't worked reliable in some |
| # tested configurations. And because other windows compilers also |
| # need their symbols specified this no serious problem. |
| # |
| # tested configurations: |
| # |
| # * cygwin gcc 2.91.57/ld 2.9.4/dllwrap 0.2.4 works |
| # (after patching python's config.h and for C++ some other include files) |
| # see also http://starship.python.net/crew/kernr/mingw32/Notes.html |
| # * mingw32 gcc 2.95.2/ld 2.9.4/dllwrap 0.2.4 works |
| # (ld doesn't support -shared, so we use dllwrap) |
| # * cygwin gcc 2.95.2/ld 2.10.90/dllwrap 2.10.90 works now |
| # - its dllwrap doesn't work, there is a bug in binutils 2.10.90 |
| # see also http://sources.redhat.com/ml/cygwin/2000-06/msg01274.html |
| # - using gcc -mdll instead dllwrap doesn't work without -static because |
| # it tries to link against dlls instead their import libraries. (If |
| # it finds the dll first.) |
| # By specifying -static we force ld to link against the import libraries, |
| # this is windows standard and there are normally not the necessary symbols |
| # in the dlls. |
| # *** only the version of June 2000 shows these problems |
| |
| # created 2000/05/05, Rene Liebscher |
| |
| __revision__ = "$Id$" |
| |
| import os,sys,copy |
| from distutils.ccompiler import gen_preprocess_options, gen_lib_options |
| from distutils.unixccompiler import UnixCCompiler |
| from distutils.file_util import write_file |
| from distutils.errors import DistutilsExecError, CompileError, UnknownFileError |
| |
| class CygwinCCompiler (UnixCCompiler): |
| |
| compiler_type = 'cygwin' |
| obj_extension = ".o" |
| static_lib_extension = ".a" |
| shared_lib_extension = ".dll" |
| static_lib_format = "lib%s%s" |
| shared_lib_format = "%s%s" |
| exe_extension = ".exe" |
| |
| def __init__ (self, |
| verbose=0, |
| dry_run=0, |
| force=0): |
| |
| UnixCCompiler.__init__ (self, verbose, dry_run, force) |
| |
| (status, details) = check_config_h() |
| self.debug_print("Python's GCC status: %s (details: %s)" % |
| (status, details)) |
| if status is not CONFIG_H_OK: |
| self.warn( |
| "Python's config.h doesn't seem to support your compiler. " + |
| ("Reason: %s." % details) + |
| "Compiling may fail because of undefined preprocessor macros.") |
| |
| (self.gcc_version, self.ld_version, self.dllwrap_version) = \ |
| get_versions() |
| self.debug_print(self.compiler_type + ": gcc %s, ld %s, dllwrap %s\n" % |
| (self.gcc_version, |
| self.ld_version, |
| self.dllwrap_version) ) |
| |
| # ld_version >= "2.10.90" should also be able to use |
| # gcc -mdll instead of dllwrap |
| # Older dllwraps had own version numbers, newer ones use the |
| # same as the rest of binutils ( also ld ) |
| # dllwrap 2.10.90 is buggy |
| if self.ld_version >= "2.10.90": |
| self.linker_dll = "gcc" |
| else: |
| self.linker_dll = "dllwrap" |
| |
| # Hard-code GCC because that's what this is all about. |
| # XXX optimization, warnings etc. should be customizable. |
| self.set_executables(compiler='gcc -mcygwin -O -Wall', |
| compiler_so='gcc -mcygwin -mdll -O -Wall', |
| linker_exe='gcc -mcygwin', |
| linker_so=('%s -mcygwin -mdll -static' % |
| self.linker_dll)) |
| |
| # cygwin and mingw32 need different sets of libraries |
| if self.gcc_version == "2.91.57": |
| # cygwin shouldn't need msvcrt, but without the dlls will crash |
| # (gcc version 2.91.57) -- perhaps something about initialization |
| self.dll_libraries=["msvcrt"] |
| self.warn( |
| "Consider upgrading to a newer version of gcc") |
| else: |
| self.dll_libraries=[] |
| |
| # __init__ () |
| |
| # not much different of the compile method in UnixCCompiler, |
| # but we have to insert some lines in the middle of it, so |
| # we put here a adapted version of it. |
| # (If we would call compile() in the base class, it would do some |
| # initializations a second time, this is why all is done here.) |
| def compile (self, |
| sources, |
| output_dir=None, |
| macros=None, |
| include_dirs=None, |
| debug=0, |
| extra_preargs=None, |
| extra_postargs=None): |
| |
| (output_dir, macros, include_dirs) = \ |
| self._fix_compile_args (output_dir, macros, include_dirs) |
| (objects, skip_sources) = self._prep_compile (sources, output_dir) |
| |
| # Figure out the options for the compiler command line. |
| pp_opts = gen_preprocess_options (macros, include_dirs) |
| cc_args = pp_opts + ['-c'] |
| if debug: |
| cc_args[:0] = ['-g'] |
| if extra_preargs: |
| cc_args[:0] = extra_preargs |
| if extra_postargs is None: |
| extra_postargs = [] |
| |
| # Compile all source files that weren't eliminated by |
| # '_prep_compile()'. |
| for i in range (len (sources)): |
| src = sources[i] ; obj = objects[i] |
| ext = (os.path.splitext (src))[1] |
| if skip_sources[src]: |
| self.announce ("skipping %s (%s up-to-date)" % (src, obj)) |
| else: |
| self.mkpath (os.path.dirname (obj)) |
| if ext == '.rc' or ext == '.res': |
| # gcc needs '.res' and '.rc' compiled to object files !!! |
| try: |
| self.spawn (["windres","-i",src,"-o",obj]) |
| except DistutilsExecError, msg: |
| raise CompileError, msg |
| else: # for other files use the C-compiler |
| try: |
| self.spawn (self.compiler_so + cc_args + |
| [src, '-o', obj] + |
| extra_postargs) |
| except DistutilsExecError, msg: |
| raise CompileError, msg |
| |
| # Return *all* object filenames, not just the ones we just built. |
| return objects |
| |
| # compile () |
| |
| |
| 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): |
| |
| # use separate copies, so we can modify the lists |
| extra_preargs = copy.copy(extra_preargs or []) |
| libraries = copy.copy(libraries or []) |
| objects = copy.copy(objects or []) |
| |
| # Additional libraries |
| libraries.extend(self.dll_libraries) |
| |
| # handle export symbols by creating a def-file |
| # with executables this only works with gcc/ld as linker |
| if ((export_symbols is not None) and |
| (target_desc != self.EXECUTABLE or self.linker_dll == "gcc")): |
| # (The linker doesn't do anything if output is up-to-date. |
| # So it would probably better to check if we really need this, |
| # but for this we had to insert some unchanged parts of |
| # UnixCCompiler, and this is not what we want.) |
| |
| # we want to put some files in the same directory as the |
| # object files are, build_temp doesn't help much |
| # where are the object files |
| temp_dir = os.path.dirname(objects[0]) |
| # name of dll to give the helper files the same base name |
| (dll_name, dll_extension) = os.path.splitext( |
| os.path.basename(output_filename)) |
| |
| # generate the filenames for these files |
| def_file = os.path.join(temp_dir, dll_name + ".def") |
| exp_file = os.path.join(temp_dir, dll_name + ".exp") |
| lib_file = os.path.join(temp_dir, 'lib' + dll_name + ".a") |
| |
| # Generate .def file |
| contents = [ |
| "LIBRARY %s" % os.path.basename(output_filename), |
| "EXPORTS"] |
| for sym in export_symbols: |
| contents.append(sym) |
| self.execute(write_file, (def_file, contents), |
| "writing %s" % def_file) |
| |
| # next add options for def-file and to creating import libraries |
| |
| # dllwrap uses different options than gcc/ld |
| if self.linker_dll == "dllwrap": |
| extra_preargs.extend([#"--output-exp",exp_file, |
| "--output-lib",lib_file, |
| ]) |
| # for dllwrap we have to use a special option |
| extra_preargs.extend(["--def", def_file]) |
| # we use gcc/ld here and can be sure ld is >= 2.9.10 |
| else: |
| # doesn't work: bfd_close build\...\libfoo.a: Invalid operation |
| #extra_preargs.extend(["-Wl,--out-implib,%s" % lib_file]) |
| # for gcc/ld the def-file is specified as any other object files |
| objects.append(def_file) |
| |
| #end: if ((export_symbols is not None) and |
| # (target_desc != self.EXECUTABLE or self.linker_dll == "gcc")): |
| |
| # who wants symbols and a many times larger output file |
| # should explicitly switch the debug mode on |
| # otherwise we let dllwrap/ld strip the output file |
| # (On my machine: 10KB < stripped_file < ??100KB |
| # unstripped_file = stripped_file + XXX KB |
| # ( XXX=254 for a typical python extension)) |
| if not debug: |
| extra_preargs.append("-s") |
| |
| UnixCCompiler.link(self, |
| target_desc, |
| objects, |
| output_filename, |
| output_dir, |
| libraries, |
| library_dirs, |
| runtime_library_dirs, |
| None, # export_symbols, we do this in our def-file |
| debug, |
| extra_preargs, |
| extra_postargs, |
| build_temp) |
| |
| # link () |
| |
| # -- Miscellaneous methods ----------------------------------------- |
| |
| # 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' or ext == '.rc': |
| # these need to be compiled to object files |
| obj_names.append (os.path.join (output_dir, |
| base + ext + self.obj_extension)) |
| else: |
| obj_names.append (os.path.join (output_dir, |
| base + self.obj_extension)) |
| return obj_names |
| |
| # object_filenames () |
| |
| # class CygwinCCompiler |
| |
| |
| # the same as cygwin plus some additional parameters |
| class Mingw32CCompiler (CygwinCCompiler): |
| |
| compiler_type = 'mingw32' |
| |
| def __init__ (self, |
| verbose=0, |
| dry_run=0, |
| force=0): |
| |
| CygwinCCompiler.__init__ (self, verbose, dry_run, force) |
| |
| # A real mingw32 doesn't need to specify a different entry point, |
| # but cygwin 2.91.57 in no-cygwin-mode needs it. |
| if self.gcc_version <= "2.91.57": |
| entry_point = '--entry _DllMain@12' |
| else: |
| entry_point = '' |
| |
| self.set_executables(compiler='gcc -mno-cygwin -O -Wall', |
| compiler_so='gcc -mno-cygwin -mdll -O -Wall', |
| linker_exe='gcc -mno-cygwin', |
| linker_so='%s -mno-cygwin -mdll -static %s' |
| % (self.linker_dll, entry_point)) |
| # Maybe we should also append -mthreads, but then the finished |
| # dlls need another dll (mingwm10.dll see Mingw32 docs) |
| # (-mthreads: Support thread-safe exception handling on `Mingw32') |
| |
| # no additional libraries needed |
| self.dll_libraries=[] |
| |
| # __init__ () |
| |
| # class Mingw32CCompiler |
| |
| # Because these compilers aren't configured in Python's config.h file by |
| # default, we should at least warn the user if he is using a unmodified |
| # version. |
| |
| CONFIG_H_OK = "ok" |
| CONFIG_H_NOTOK = "not ok" |
| CONFIG_H_UNCERTAIN = "uncertain" |
| |
| def check_config_h(): |
| |
| """Check if the current Python installation (specifically, config.h) |
| appears amenable to building extensions with GCC. Returns a tuple |
| (status, details), where 'status' is one of the following constants: |
| CONFIG_H_OK |
| all is well, go ahead and compile |
| CONFIG_H_NOTOK |
| doesn't look good |
| CONFIG_H_UNCERTAIN |
| not sure -- unable to read config.h |
| 'details' is a human-readable string explaining the situation. |
| |
| Note there are two ways to conclude "OK": either 'sys.version' contains |
| the string "GCC" (implying that this Python was built with GCC), or the |
| installed "config.h" contains the string "__GNUC__". |
| """ |
| |
| # XXX since this function also checks sys.version, it's not strictly a |
| # "config.h" check -- should probably be renamed... |
| |
| from distutils import sysconfig |
| import sys |
| # if sys.version contains GCC then python was compiled with |
| # GCC, and the config.h file should be OK |
| if sys.version.find("GCC") >= 0: |
| return (CONFIG_H_OK, "sys.version mentions 'GCC'") |
| |
| fn = sysconfig.get_config_h_filename() |
| try: |
| # It would probably better to read single lines to search. |
| # But we do this only once, and it is fast enough |
| f = open(fn) |
| s = f.read() |
| f.close() |
| |
| except IOError, exc: |
| # if we can't read this file, we cannot say it is wrong |
| # the compiler will complain later about this file as missing |
| return (CONFIG_H_UNCERTAIN, |
| "couldn't read '%s': %s" % (fn, exc.strerror)) |
| |
| else: |
| # "config.h" contains an "#ifdef __GNUC__" or something similar |
| if s.find("__GNUC__") >= 0: |
| return (CONFIG_H_OK, "'%s' mentions '__GNUC__'" % fn) |
| else: |
| return (CONFIG_H_NOTOK, "'%s' does not mention '__GNUC__'" % fn) |
| |
| |
| |
| def get_versions(): |
| """ Try to find out the versions of gcc, ld and dllwrap. |
| If not possible it returns None for it. |
| """ |
| from distutils.version import StrictVersion |
| from distutils.spawn import find_executable |
| import re |
| |
| gcc_exe = find_executable('gcc') |
| if gcc_exe: |
| out = os.popen(gcc_exe + ' -dumpversion','r') |
| out_string = out.read() |
| out.close() |
| result = re.search('(\d+\.\d+\.\d+)',out_string) |
| if result: |
| gcc_version = StrictVersion(result.group(1)) |
| else: |
| gcc_version = None |
| else: |
| gcc_version = None |
| ld_exe = find_executable('ld') |
| if ld_exe: |
| out = os.popen(ld_exe + ' -v','r') |
| out_string = out.read() |
| out.close() |
| result = re.search('(\d+\.\d+\.\d+)',out_string) |
| if result: |
| ld_version = StrictVersion(result.group(1)) |
| else: |
| ld_version = None |
| else: |
| ld_version = None |
| dllwrap_exe = find_executable('dllwrap') |
| if dllwrap_exe: |
| out = os.popen(dllwrap_exe + ' --version','r') |
| out_string = out.read() |
| out.close() |
| result = re.search(' (\d+\.\d+\.\d+)',out_string) |
| if result: |
| dllwrap_version = StrictVersion(result.group(1)) |
| else: |
| dllwrap_version = None |
| else: |
| dllwrap_version = None |
| return (gcc_version, ld_version, dllwrap_version) |
| |