mirror of
https://github.com/python/cpython.git
synced 2025-10-31 13:41:24 +00:00
4240648a9d
implementations. Details:
* replace 'link_shared_object()', 'link_shared_lib()', and
'link_executable()' with 'link()', which is (roughly)
the union of the three methods it replaces
* in all implementation classes (UnixCCompiler, MSVCCompiler, etc.),
ditch the old 'link_*()' methods and replace them with 'link()'
* in the abstract base class (CCompiler), add the old 'link_*()'
methods as wrappers around the new 'link()' (they also print
a warning of the deprecated interface)
Also increases consistency between MSVCCompiler and BCPPCompiler,
hopefully to make it easier to factor out the mythical WindowsCCompiler
class. Details:
* use 'self.linker' instead of 'self.link'
* add ability to compile resource files to BCPPCompiler
* added (redundant?) 'object_filename()' method to BCPPCompiler
* only generate a .def file if 'export_symbols' defined
442 lines
17 KiB
Python
442 lines
17 KiB
Python
"""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 string,sys
|
|
# if sys.version contains GCC then python was compiled with
|
|
# GCC, and the config.h file should be OK
|
|
if string.find(sys.version,"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 string.find(s,"__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)
|
|
|