[config.git] / djavu-asus / elpy / rpc-venv / lib / python3.11 / site-packages / setuptools / _distutils / cygwinccompiler.py

"""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).
"""

import os
import re
import sys
import copy
import shlex
import warnings
from subprocess import check_output

from .unixccompiler import UnixCCompiler
from .file_util import write_file
from .errors import (
    DistutilsExecError,
    DistutilsPlatformError,
    CCompilerError,
    CompileError,
)
from .version import LooseVersion, suppress_known_deprecation
from ._collections import RangeMap


_msvcr_lookup = RangeMap.left(
    {
        # MSVC 7.0
        1300: ['msvcr70'],
        # MSVC 7.1
        1310: ['msvcr71'],
        # VS2005 / MSVC 8.0
        1400: ['msvcr80'],
        # VS2008 / MSVC 9.0
        1500: ['msvcr90'],
        # VS2010 / MSVC 10.0
        1600: ['msvcr100'],
        # VS2012 / MSVC 11.0
        1700: ['msvcr110'],
        # VS2013 / MSVC 12.0
        1800: ['msvcr120'],
        # VS2015 / MSVC 14.0
        1900: ['ucrt', 'vcruntime140'],
        2000: RangeMap.undefined_value,
    },
)


def get_msvcr():
    """Include the appropriate MSVC runtime library if Python was built
    with MSVC 7.0 or later.
    """
    match = re.search(r'MSC v\.(\d{4})', sys.version)
    try:
        msc_ver = int(match.group(1))
    except AttributeError:
        return
    try:
        return _msvcr_lookup[msc_ver]
    except KeyError:
        raise ValueError("Unknown MS Compiler version %s " % msc_ver)


_runtime_library_dirs_msg = (
    "Unable to set runtime library search path on Windows, "
    "usually indicated by `runtime_library_dirs` parameter to Extension"
)


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: {} (details: {})".format(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=('{} -mcygwin {}'.format(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(_runtime_library_dirs_msg)

        # 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")

            # 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

            # 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(_runtime_library_dirs_msg)
        return []

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

    def _make_out_path(self, output_dir, strip_dir, src_name):
        # use normcase to make sure '.rc' is really '.rc' and not '.RC'
        norm_src_name = os.path.normcase(src_name)
        return super()._make_out_path(output_dir, strip_dir, norm_src_name)

    @property
    def out_extensions(self):
        """
        Add support for rc and res files.
        """
        return {
            **super().out_extensions,
            **{ext: ext + self.obj_extension for ext in ('.res', '.rc')},
        }


# 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='{} {}'.format(self.linker_dll, shared_option),
        )

    def runtime_library_dir_option(self, dir):
        raise DistutilsPlatformError(_runtime_library_dirs_msg)


# 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 '{}': {}".format(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.
"""
Commit	Line	Data
53e6db90 DC	1	"""distutils.cygwinccompiler
	2
	3	Provides the CygwinCCompiler class, a subclass of UnixCCompiler that
	4	handles the Cygwin port of the GNU C compiler to Windows. It also contains
	5	the Mingw32CCompiler class which handles the mingw32 port of GCC (same as
	6	cygwin in no-cygwin mode).
	7	"""
	8
	9	import os
	10	import re
	11	import sys
	12	import copy
	13	import shlex
	14	import warnings
	15	from subprocess import check_output
	16
	17	from .unixccompiler import UnixCCompiler
	18	from .file_util import write_file
	19	from .errors import (
	20	DistutilsExecError,
	21	DistutilsPlatformError,
	22	CCompilerError,
	23	CompileError,
	24	)
	25	from .version import LooseVersion, suppress_known_deprecation
	26	from ._collections import RangeMap
	27
	28
	29	_msvcr_lookup = RangeMap.left(
	30	{
	31	# MSVC 7.0
	32	1300: ['msvcr70'],
	33	# MSVC 7.1
	34	1310: ['msvcr71'],
	35	# VS2005 / MSVC 8.0
	36	1400: ['msvcr80'],
	37	# VS2008 / MSVC 9.0
	38	1500: ['msvcr90'],
	39	# VS2010 / MSVC 10.0
	40	1600: ['msvcr100'],
	41	# VS2012 / MSVC 11.0
	42	1700: ['msvcr110'],
	43	# VS2013 / MSVC 12.0
	44	1800: ['msvcr120'],
	45	# VS2015 / MSVC 14.0
	46	1900: ['ucrt', 'vcruntime140'],
	47	2000: RangeMap.undefined_value,
	48	},
	49	)
	50
	51
	52	def get_msvcr():
	53	"""Include the appropriate MSVC runtime library if Python was built
	54	with MSVC 7.0 or later.
	55	"""
	56	match = re.search(r'MSC v\.(\d{4})', sys.version)
	57	try:
	58	msc_ver = int(match.group(1))
	59	except AttributeError:
	60	return
	61	try:
	62	return _msvcr_lookup[msc_ver]
	63	except KeyError:
	64	raise ValueError("Unknown MS Compiler version %s " % msc_ver)
65
66
67	_runtime_library_dirs_msg = (
68	"Unable to set runtime library search path on Windows, "
69	"usually indicated by `runtime_library_dirs` parameter to Extension"
70	)
71
72
73	class CygwinCCompiler(UnixCCompiler):
74	"""Handles the Cygwin port of the GNU C compiler to Windows."""
75
76	compiler_type = 'cygwin'
77	obj_extension = ".o"
78	static_lib_extension = ".a"
79	shared_lib_extension = ".dll.a"
80	dylib_lib_extension = ".dll"
81	static_lib_format = "lib%s%s"
82	shared_lib_format = "lib%s%s"
83	dylib_lib_format = "cyg%s%s"
84	exe_extension = ".exe"
85
86	def __init__(self, verbose=0, dry_run=0, force=0):
87
88	super().__init__(verbose, dry_run, force)
89
90	status, details = check_config_h()
91	self.debug_print(
92	"Python's GCC status: {} (details: {})".format(status, details)
93	)
94	if status is not CONFIG_H_OK:
95	self.warn(
96	"Python's pyconfig.h doesn't seem to support your compiler. "
97	"Reason: %s. "
98	"Compiling may fail because of undefined preprocessor macros." % details
99	)
100
101	self.cc = os.environ.get('CC', 'gcc')
102	self.cxx = os.environ.get('CXX', 'g++')
103
104	self.linker_dll = self.cc
105	shared_option = "-shared"
106
107	self.set_executables(
108	compiler='%s -mcygwin -O -Wall' % self.cc,
109	compiler_so='%s -mcygwin -mdll -O -Wall' % self.cc,
110	compiler_cxx='%s -mcygwin -O -Wall' % self.cxx,
111	linker_exe='%s -mcygwin' % self.cc,
112	linker_so=('{} -mcygwin {}'.format(self.linker_dll, shared_option)),
113	)
114
115	# Include the appropriate MSVC runtime library if Python was built
116	# with MSVC 7.0 or later.
117	self.dll_libraries = get_msvcr()
118
119	@property
120	def gcc_version(self):
121	# Older numpy dependend on this existing to check for ancient
122	# gcc versions. This doesn't make much sense with clang etc so
123	# just hardcode to something recent.
124	# https://github.com/numpy/numpy/pull/20333
125	warnings.warn(
126	"gcc_version attribute of CygwinCCompiler is deprecated. "
127	"Instead of returning actual gcc version a fixed value 11.2.0 is returned.",
128	DeprecationWarning,
129	stacklevel=2,
130	)
131	with suppress_known_deprecation():
132	return LooseVersion("11.2.0")
133
134	def _compile(self, obj, src, ext, cc_args, extra_postargs, pp_opts):
135	"""Compiles the source by spawning GCC and windres if needed."""
136	if ext == '.rc' or ext == '.res':
137	# gcc needs '.res' and '.rc' compiled to object files !!!
138	try:
139	self.spawn(["windres", "-i", src, "-o", obj])
140	except DistutilsExecError as msg:
141	raise CompileError(msg)
142	else: # for other files use the C-compiler
143	try:
144	self.spawn(
145	self.compiler_so + cc_args + [src, '-o', obj] + extra_postargs
146	)
147	except DistutilsExecError as msg:
148	raise CompileError(msg)
149
150	def link(
151	self,
152	target_desc,
153	objects,
154	output_filename,
155	output_dir=None,
156	libraries=None,
157	library_dirs=None,
158	runtime_library_dirs=None,
159	export_symbols=None,
160	debug=0,
161	extra_preargs=None,
162	extra_postargs=None,
163	build_temp=None,
164	target_lang=None,
165	):
166	"""Link the objects."""
167	# use separate copies, so we can modify the lists
168	extra_preargs = copy.copy(extra_preargs or [])
169	libraries = copy.copy(libraries or [])
170	objects = copy.copy(objects or [])
171
172	if runtime_library_dirs:
173	self.warn(_runtime_library_dirs_msg)
174
175	# Additional libraries
176	libraries.extend(self.dll_libraries)
177
178	# handle export symbols by creating a def-file
179	# with executables this only works with gcc/ld as linker
180	if (export_symbols is not None) and (
181	target_desc != self.EXECUTABLE or self.linker_dll == "gcc"
182	):
183	# (The linker doesn't do anything if output is up-to-date.
184	# So it would probably better to check if we really need this,
185	# but for this we had to insert some unchanged parts of
186	# UnixCCompiler, and this is not what we want.)
187
188	# we want to put some files in the same directory as the
189	# object files are, build_temp doesn't help much
190	# where are the object files
191	temp_dir = os.path.dirname(objects[0])
192	# name of dll to give the helper files the same base name
193	(dll_name, dll_extension) = os.path.splitext(
194	os.path.basename(output_filename)
195	)
196
197	# generate the filenames for these files
198	def_file = os.path.join(temp_dir, dll_name + ".def")
199
200	# Generate .def file
201	contents = ["LIBRARY %s" % os.path.basename(output_filename), "EXPORTS"]
202	for sym in export_symbols:
203	contents.append(sym)
204	self.execute(write_file, (def_file, contents), "writing %s" % def_file)
205
206	# next add options for def-file
207
208	# for gcc/ld the def-file is specified as any object files
209	objects.append(def_file)
210
211	# end: if ((export_symbols is not None) and
212	# (target_desc != self.EXECUTABLE or self.linker_dll == "gcc")):
213
214	# who wants symbols and a many times larger output file
215	# should explicitly switch the debug mode on
216	# otherwise we let ld strip the output file
217	# (On my machine: 10KiB < stripped_file < ??100KiB
218	# unstripped_file = stripped_file + XXX KiB
219	# ( XXX=254 for a typical python extension))
220	if not debug:
221	extra_preargs.append("-s")
222
223	UnixCCompiler.link(
224	self,
225	target_desc,
226	objects,
227	output_filename,
228	output_dir,
229	libraries,
230	library_dirs,
231	runtime_library_dirs,
232	None, # export_symbols, we do this in our def-file
233	debug,
234	extra_preargs,
235	extra_postargs,
236	build_temp,
237	target_lang,
238	)
239
240	def runtime_library_dir_option(self, dir):
241	# cygwin doesn't support rpath. While in theory we could error
242	# out like MSVC does, code might expect it to work like on Unix, so
243	# just warn and hope for the best.
244	self.warn(_runtime_library_dirs_msg)
245	return []
246
247	# -- Miscellaneous methods -----------------------------------------
248
249	def _make_out_path(self, output_dir, strip_dir, src_name):
250	# use normcase to make sure '.rc' is really '.rc' and not '.RC'
251	norm_src_name = os.path.normcase(src_name)
252	return super()._make_out_path(output_dir, strip_dir, norm_src_name)
253
254	@property
255	def out_extensions(self):
256	"""
257	Add support for rc and res files.
258	"""
259	return {
260	**super().out_extensions,
261	**{ext: ext + self.obj_extension for ext in ('.res', '.rc')},
262	}
263
264
265	# the same as cygwin plus some additional parameters
266	class Mingw32CCompiler(CygwinCCompiler):
267	"""Handles the Mingw32 port of the GNU C compiler to Windows."""
268
269	compiler_type = 'mingw32'
270
271	def __init__(self, verbose=0, dry_run=0, force=0):
272
273	super().__init__(verbose, dry_run, force)
274
275	shared_option = "-shared"
276
277	if is_cygwincc(self.cc):
278	raise CCompilerError('Cygwin gcc cannot be used with --compiler=mingw32')
279
280	self.set_executables(
281	compiler='%s -O -Wall' % self.cc,
282	compiler_so='%s -mdll -O -Wall' % self.cc,
283	compiler_cxx='%s -O -Wall' % self.cxx,
284	linker_exe='%s' % self.cc,
285	linker_so='{} {}'.format(self.linker_dll, shared_option),
286	)
287
288	def runtime_library_dir_option(self, dir):
289	raise DistutilsPlatformError(_runtime_library_dirs_msg)
290
291
292	# Because these compilers aren't configured in Python's pyconfig.h file by
293	# default, we should at least warn the user if he is using an unmodified
294	# version.
295
296	CONFIG_H_OK = "ok"
297	CONFIG_H_NOTOK = "not ok"
298	CONFIG_H_UNCERTAIN = "uncertain"
299
300
301	def check_config_h():
302	"""Check if the current Python installation appears amenable to building
303	extensions with GCC.
304
305	Returns a tuple (status, details), where 'status' is one of the following
306	constants:
307
308	- CONFIG_H_OK: all is well, go ahead and compile
309	- CONFIG_H_NOTOK: doesn't look good
310	- CONFIG_H_UNCERTAIN: not sure -- unable to read pyconfig.h
311
312	'details' is a human-readable string explaining the situation.
313
314	Note there are two ways to conclude "OK": either 'sys.version' contains
315	the string "GCC" (implying that this Python was built with GCC), or the
316	installed "pyconfig.h" contains the string "__GNUC__".
317	"""
318
319	# XXX since this function also checks sys.version, it's not strictly a
320	# "pyconfig.h" check -- should probably be renamed...
321
322	from distutils import sysconfig
323
324	# if sys.version contains GCC then python was compiled with GCC, and the
325	# pyconfig.h file should be OK
326	if "GCC" in sys.version:
327	return CONFIG_H_OK, "sys.version mentions 'GCC'"
328
329	# Clang would also work
330	if "Clang" in sys.version:
331	return CONFIG_H_OK, "sys.version mentions 'Clang'"
332
333	# let's see if __GNUC__ is mentioned in python.h
334	fn = sysconfig.get_config_h_filename()
335	try:
336	config_h = open(fn)
337	try:
338	if "__GNUC__" in config_h.read():
339	return CONFIG_H_OK, "'%s' mentions '__GNUC__'" % fn
340	else:
341	return CONFIG_H_NOTOK, "'%s' does not mention '__GNUC__'" % fn
342	finally:
343	config_h.close()
344	except OSError as exc:
345	return (CONFIG_H_UNCERTAIN, "couldn't read '{}': {}".format(fn, exc.strerror))
346
347
348	def is_cygwincc(cc):
349	'''Try to determine if the compiler that would be used is from cygwin.'''
350	out_string = check_output(shlex.split(cc) + ['-dumpmachine'])
351	return out_string.strip().endswith(b'cygwin')
352
353
354	get_versions = None
355	"""
356	A stand-in for the previous get_versions() function to prevent failures
357	when monkeypatched. See pypa/setuptools#2969.
358	"""