mirror of https://github.com/python/cpython
242 lines
10 KiB
Python
242 lines
10 KiB
Python
"""distutils.extension
|
|
|
|
Provides the Extension class, used to describe C/C++ extension
|
|
modules in setup scripts."""
|
|
|
|
import os
|
|
import sys
|
|
import warnings
|
|
|
|
# This class is really only used by the "build_ext" command, so it might
|
|
# make sense to put it in distutils.command.build_ext. However, that
|
|
# module is already big enough, and I want to make this class a bit more
|
|
# complex to simplify some common cases ("foo" module in "foo.c") and do
|
|
# better error-checking ("foo.c" actually exists).
|
|
#
|
|
# Also, putting this in build_ext.py means every setup script would have to
|
|
# import that large-ish module (indirectly, through distutils.core) in
|
|
# order to do anything.
|
|
|
|
class Extension:
|
|
"""Just a collection of attributes that describes an extension
|
|
module and everything needed to build it (hopefully in a portable
|
|
way, but there are hooks that let you be as unportable as you need).
|
|
|
|
Instance attributes:
|
|
name : string
|
|
the full name of the extension, including any packages -- ie.
|
|
*not* a filename or pathname, but Python dotted name
|
|
sources : [string]
|
|
list of source filenames, relative to the distribution root
|
|
(where the setup script lives), in Unix form (slash-separated)
|
|
for portability. Source files may be C, C++, SWIG (.i),
|
|
platform-specific resource files, or whatever else is recognized
|
|
by the "build_ext" command as source for a Python extension.
|
|
include_dirs : [string]
|
|
list of directories to search for C/C++ header files (in Unix
|
|
form for portability)
|
|
define_macros : [(name : string, value : string|None)]
|
|
list of macros to define; each macro is defined using a 2-tuple,
|
|
where 'value' is either the string to define it to or None to
|
|
define it without a particular value (equivalent of "#define
|
|
FOO" in source or -DFOO on Unix C compiler command line)
|
|
undef_macros : [string]
|
|
list of macros to undefine explicitly
|
|
library_dirs : [string]
|
|
list of directories to search for C/C++ libraries at link time
|
|
libraries : [string]
|
|
list of library names (not filenames or paths) to link against
|
|
runtime_library_dirs : [string]
|
|
list of directories to search for C/C++ libraries at run time
|
|
(for shared extensions, this is when the extension is loaded)
|
|
extra_objects : [string]
|
|
list of extra files to link with (eg. object files not implied
|
|
by 'sources', static library that must be explicitly specified,
|
|
binary resource files, etc.)
|
|
extra_compile_args : [string]
|
|
any extra platform- and compiler-specific information to use
|
|
when compiling the source files in 'sources'. For platforms and
|
|
compilers where "command line" makes sense, this is typically a
|
|
list of command-line arguments, but for other platforms it could
|
|
be anything.
|
|
extra_link_args : [string]
|
|
any extra platform- and compiler-specific information to use
|
|
when linking object files together to create the extension (or
|
|
to create a new static Python interpreter). Similar
|
|
interpretation as for 'extra_compile_args'.
|
|
export_symbols : [string]
|
|
list of symbols to be exported from a shared extension. Not
|
|
used on all platforms, and not generally necessary for Python
|
|
extensions, which typically export exactly one symbol: "init" +
|
|
extension_name.
|
|
swig_opts : [string]
|
|
any extra options to pass to SWIG if a source file has the .i
|
|
extension.
|
|
depends : [string]
|
|
list of files that the extension depends on
|
|
language : string
|
|
extension language (i.e. "c", "c++", "objc"). Will be detected
|
|
from the source extensions if not provided.
|
|
optional : boolean
|
|
specifies that a build failure in the extension should not abort the
|
|
build process, but simply not install the failing extension.
|
|
"""
|
|
|
|
# When adding arguments to this constructor, be sure to update
|
|
# setup_keywords in core.py.
|
|
def __init__(self, name, sources,
|
|
include_dirs=None,
|
|
define_macros=None,
|
|
undef_macros=None,
|
|
library_dirs=None,
|
|
libraries=None,
|
|
runtime_library_dirs=None,
|
|
extra_objects=None,
|
|
extra_compile_args=None,
|
|
extra_link_args=None,
|
|
export_symbols=None,
|
|
swig_opts = None,
|
|
depends=None,
|
|
language=None,
|
|
optional=None,
|
|
**kw # To catch unknown keywords
|
|
):
|
|
if not isinstance(name, str):
|
|
raise AssertionError("'name' must be a string")
|
|
if not (isinstance(sources, list) and
|
|
all(isinstance(v, str) for v in sources)):
|
|
raise AssertionError("'sources' must be a list of strings")
|
|
|
|
self.name = name
|
|
self.sources = sources
|
|
self.include_dirs = include_dirs or []
|
|
self.define_macros = define_macros or []
|
|
self.undef_macros = undef_macros or []
|
|
self.library_dirs = library_dirs or []
|
|
self.libraries = libraries or []
|
|
self.runtime_library_dirs = runtime_library_dirs or []
|
|
self.extra_objects = extra_objects or []
|
|
self.extra_compile_args = extra_compile_args or []
|
|
self.extra_link_args = extra_link_args or []
|
|
self.export_symbols = export_symbols or []
|
|
self.swig_opts = swig_opts or []
|
|
self.depends = depends or []
|
|
self.language = language
|
|
self.optional = optional
|
|
|
|
# If there are unknown keyword options, warn about them
|
|
if len(kw) > 0:
|
|
options = [repr(option) for option in kw]
|
|
options = ', '.join(sorted(options))
|
|
msg = "Unknown Extension options: %s" % options
|
|
warnings.warn(msg)
|
|
|
|
def __repr__(self):
|
|
return '<%s.%s(%r) at %#x>' % (
|
|
self.__class__.__module__,
|
|
self.__class__.__name__,
|
|
self.name,
|
|
id(self))
|
|
|
|
|
|
def read_setup_file(filename):
|
|
"""Reads a Setup file and returns Extension instances."""
|
|
from distutils.sysconfig import (parse_makefile, expand_makefile_vars,
|
|
_variable_rx)
|
|
|
|
from distutils.text_file import TextFile
|
|
from distutils.util import split_quoted
|
|
|
|
# First pass over the file to gather "VAR = VALUE" assignments.
|
|
vars = parse_makefile(filename)
|
|
|
|
# Second pass to gobble up the real content: lines of the form
|
|
# <module> ... [<sourcefile> ...] [<cpparg> ...] [<library> ...]
|
|
file = TextFile(filename,
|
|
strip_comments=1, skip_blanks=1, join_lines=1,
|
|
lstrip_ws=1, rstrip_ws=1)
|
|
try:
|
|
extensions = []
|
|
|
|
while True:
|
|
line = file.readline()
|
|
if line is None: # eof
|
|
break
|
|
if _variable_rx.match(line): # VAR=VALUE, handled in first pass
|
|
continue
|
|
|
|
if line[0] == line[-1] == "*":
|
|
file.warn("'%s' lines not handled yet" % line)
|
|
continue
|
|
|
|
line = expand_makefile_vars(line, vars)
|
|
words = split_quoted(line)
|
|
|
|
# NB. this parses a slightly different syntax than the old
|
|
# makesetup script: here, there must be exactly one extension per
|
|
# line, and it must be the first word of the line. I have no idea
|
|
# why the old syntax supported multiple extensions per line, as
|
|
# they all wind up being the same.
|
|
|
|
module = words[0]
|
|
ext = Extension(module, [])
|
|
append_next_word = None
|
|
|
|
for word in words[1:]:
|
|
if append_next_word is not None:
|
|
append_next_word.append(word)
|
|
append_next_word = None
|
|
continue
|
|
|
|
suffix = os.path.splitext(word)[1]
|
|
switch = word[0:2] ; value = word[2:]
|
|
|
|
if suffix in (".c", ".cc", ".cpp", ".cxx", ".c++", ".m", ".mm"):
|
|
# hmm, should we do something about C vs. C++ sources?
|
|
# or leave it up to the CCompiler implementation to
|
|
# worry about?
|
|
ext.sources.append(word)
|
|
elif switch == "-I":
|
|
ext.include_dirs.append(value)
|
|
elif switch == "-D":
|
|
equals = value.find("=")
|
|
if equals == -1: # bare "-DFOO" -- no value
|
|
ext.define_macros.append((value, None))
|
|
else: # "-DFOO=blah"
|
|
ext.define_macros.append((value[0:equals],
|
|
value[equals+2:]))
|
|
elif switch == "-U":
|
|
ext.undef_macros.append(value)
|
|
elif switch == "-C": # only here 'cause makesetup has it!
|
|
ext.extra_compile_args.append(word)
|
|
elif switch == "-l":
|
|
ext.libraries.append(value)
|
|
elif switch == "-L":
|
|
ext.library_dirs.append(value)
|
|
elif switch == "-R":
|
|
ext.runtime_library_dirs.append(value)
|
|
elif word == "-rpath":
|
|
append_next_word = ext.runtime_library_dirs
|
|
elif word == "-Xlinker":
|
|
append_next_word = ext.extra_link_args
|
|
elif word == "-Xcompiler":
|
|
append_next_word = ext.extra_compile_args
|
|
elif switch == "-u":
|
|
ext.extra_link_args.append(word)
|
|
if not value:
|
|
append_next_word = ext.extra_link_args
|
|
elif suffix in (".a", ".so", ".sl", ".o", ".dylib"):
|
|
# NB. a really faithful emulation of makesetup would
|
|
# append a .o file to extra_objects only if it
|
|
# had a slash in it; otherwise, it would s/.o/.c/
|
|
# and append it to sources. Hmmmm.
|
|
ext.extra_objects.append(word)
|
|
else:
|
|
file.warn("unrecognized argument '%s'" % word)
|
|
|
|
extensions.append(ext)
|
|
finally:
|
|
file.close()
|
|
|
|
return extensions
|