| """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 an import library for its dll |
| # - create a def-file for python??.dll |
| # - create an 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 |
| # * cygwin gcc 3.2/ld 2.13.90 works |
| # (ld supports -shared) |
| # * mingw gcc 3.2/ld 2.13 works |
| # (ld supports -shared) |
| # * llvm-mingw with Clang 11 works |
| # (lld supports -shared) |
| |
| import os |
| import sys |
| import copy |
| import shlex |
| import warnings |
| from subprocess import check_output |
| |
| from distutils.unixccompiler import UnixCCompiler |
| from distutils.file_util import write_file |
| from distutils.errors import ( |
| DistutilsExecError, |
| DistutilsPlatformError, |
| CCompilerError, |
| CompileError, |
| UnknownFileError, |
| ) |
| from distutils.version import LooseVersion, suppress_known_deprecation |
| |
| |
| def get_msvcr(): |
| """Include the appropriate MSVC runtime library if Python was built |
| with MSVC 7.0 or later. |
| """ |
| msc_pos = sys.version.find('MSC v.') |
| if msc_pos != -1: |
| msc_ver = sys.version[msc_pos + 6 : msc_pos + 10] |
| if msc_ver == '1300': |
| # MSVC 7.0 |
| return ['msvcr70'] |
| elif msc_ver == '1310': |
| # MSVC 7.1 |
| return ['msvcr71'] |
| elif msc_ver == '1400': |
| # VS2005 / MSVC 8.0 |
| return ['msvcr80'] |
| elif msc_ver == '1500': |
| # VS2008 / MSVC 9.0 |
| return ['msvcr90'] |
| elif msc_ver == '1600': |
| # VS2010 / MSVC 10.0 |
| return ['msvcr100'] |
| elif msc_ver == '1700': |
| # VS2012 / MSVC 11.0 |
| return ['msvcr110'] |
| elif msc_ver == '1800': |
| # VS2013 / MSVC 12.0 |
| return ['msvcr120'] |
| elif 1900 <= int(msc_ver) < 2000: |
| # VS2015 / MSVC 14.0 |
| return ['ucrt', 'vcruntime140'] |
| else: |
| raise ValueError("Unknown MS Compiler version %s " % msc_ver) |
| |
| |
| class CygwinCCompiler(UnixCCompiler): |
| """Handles the Cygwin port of the GNU C compiler to Windows.""" |
| |
| compiler_type = 'cygwin' |
| obj_extension = ".o" |
| static_lib_extension = ".a" |
| shared_lib_extension = ".dll.a" |
| dylib_lib_extension = ".dll" |
| static_lib_format = "lib%s%s" |
| shared_lib_format = "lib%s%s" |
| dylib_lib_format = "cyg%s%s" |
| exe_extension = ".exe" |
| |
| def __init__(self, verbose=0, dry_run=0, force=0): |
| |
| super().__init__(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 pyconfig.h doesn't seem to support your compiler. " |
| "Reason: %s. " |
| "Compiling may fail because of undefined preprocessor macros." % details |
| ) |
| |
| self.cc = os.environ.get('CC', 'gcc') |
| self.cxx = os.environ.get('CXX', 'g++') |
| |
| self.linker_dll = self.cc |
| shared_option = "-shared" |
| |
| self.set_executables( |
| compiler='%s -mcygwin -O -Wall' % self.cc, |
| compiler_so='%s -mcygwin -mdll -O -Wall' % self.cc, |
| compiler_cxx='%s -mcygwin -O -Wall' % self.cxx, |
| linker_exe='%s -mcygwin' % self.cc, |
| linker_so=('%s -mcygwin %s' % (self.linker_dll, shared_option)), |
| ) |
| |
| # Include the appropriate MSVC runtime library if Python was built |
| # with MSVC 7.0 or later. |
| self.dll_libraries = get_msvcr() |
| |
| @property |
| def gcc_version(self): |
| # Older numpy dependend on this existing to check for ancient |
| # gcc versions. This doesn't make much sense with clang etc so |
| # just hardcode to something recent. |
| # https://github.com/numpy/numpy/pull/20333 |
| warnings.warn( |
| "gcc_version attribute of CygwinCCompiler is deprecated. " |
| "Instead of returning actual gcc version a fixed value 11.2.0 is returned.", |
| DeprecationWarning, |
| stacklevel=2, |
| ) |
| with suppress_known_deprecation(): |
| return LooseVersion("11.2.0") |
| |
| def _compile(self, obj, src, ext, cc_args, extra_postargs, pp_opts): |
| """Compiles the source by spawning GCC and windres if needed.""" |
| 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 as 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 as msg: |
| raise CompileError(msg) |
| |
| 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, |
| ): |
| """Link the objects.""" |
| # 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 []) |
| |
| if runtime_library_dirs: |
| self.warn( |
| "I don't know what to do with 'runtime_library_dirs': " |
| + str(runtime_library_dirs) |
| ) |
| |
| # 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") |
| 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 |
| |
| # 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 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 ld strip the output file |
| # (On my machine: 10KiB < stripped_file < ??100KiB |
| # unstripped_file = stripped_file + XXX KiB |
| # ( 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, |
| target_lang, |
| ) |
| |
| def runtime_library_dir_option(self, dir): |
| # cygwin doesn't support rpath. While in theory we could error |
| # out like MSVC does, code might expect it to work like on Unix, so |
| # just warn and hope for the best. |
| self.warn("don't know how to set runtime library search path on Windows") |
| return [] |
| |
| # -- Miscellaneous methods ----------------------------------------- |
| |
| def object_filenames(self, source_filenames, strip_dir=0, output_dir=''): |
| """Adds supports for rc and res files.""" |
| 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 in ('.res', '.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 |
| |
| |
| # the same as cygwin plus some additional parameters |
| class Mingw32CCompiler(CygwinCCompiler): |
| """Handles the Mingw32 port of the GNU C compiler to Windows.""" |
| |
| compiler_type = 'mingw32' |
| |
| def __init__(self, verbose=0, dry_run=0, force=0): |
| |
| super().__init__(verbose, dry_run, force) |
| |
| shared_option = "-shared" |
| |
| if is_cygwincc(self.cc): |
| raise CCompilerError('Cygwin gcc cannot be used with --compiler=mingw32') |
| |
| self.set_executables( |
| compiler='%s -O -Wall' % self.cc, |
| compiler_so='%s -mdll -O -Wall' % self.cc, |
| compiler_cxx='%s -O -Wall' % self.cxx, |
| linker_exe='%s' % self.cc, |
| linker_so='%s %s' % (self.linker_dll, shared_option), |
| ) |
| |
| # 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 = [] |
| |
| # Include the appropriate MSVC runtime library if Python was built |
| # with MSVC 7.0 or later. |
| self.dll_libraries = get_msvcr() |
| |
| def runtime_library_dir_option(self, dir): |
| raise DistutilsPlatformError( |
| "don't know how to set runtime library search path on Windows" |
| ) |
| |
| |
| # Because these compilers aren't configured in Python's pyconfig.h file by |
| # default, we should at least warn the user if he is using an 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 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 pyconfig.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 "pyconfig.h" contains the string "__GNUC__". |
| """ |
| |
| # XXX since this function also checks sys.version, it's not strictly a |
| # "pyconfig.h" check -- should probably be renamed... |
| |
| from distutils import sysconfig |
| |
| # if sys.version contains GCC then python was compiled with GCC, and the |
| # pyconfig.h file should be OK |
| if "GCC" in sys.version: |
| return CONFIG_H_OK, "sys.version mentions 'GCC'" |
| |
| # Clang would also work |
| if "Clang" in sys.version: |
| return CONFIG_H_OK, "sys.version mentions 'Clang'" |
| |
| # let's see if __GNUC__ is mentioned in python.h |
| fn = sysconfig.get_config_h_filename() |
| try: |
| config_h = open(fn) |
| try: |
| if "__GNUC__" in config_h.read(): |
| return CONFIG_H_OK, "'%s' mentions '__GNUC__'" % fn |
| else: |
| return CONFIG_H_NOTOK, "'%s' does not mention '__GNUC__'" % fn |
| finally: |
| config_h.close() |
| except OSError as exc: |
| return (CONFIG_H_UNCERTAIN, "couldn't read '%s': %s" % (fn, exc.strerror)) |
| |
| |
| def is_cygwincc(cc): |
| '''Try to determine if the compiler that would be used is from cygwin.''' |
| out_string = check_output(shlex.split(cc) + ['-dumpmachine']) |
| return out_string.strip().endswith(b'cygwin') |
| |
| |
| get_versions = None |
| """ |
| A stand-in for the previous get_versions() function to prevent failures |
| when monkeypatched. See pypa/setuptools#2969. |
| """ |
