|
|
|
"""distutils.command.build
|
|
|
|
|
|
|
|
Implements the Distutils 'build' command."""
|
|
|
|
|
|
|
|
import sys
|
|
|
|
import os
|
|
|
|
from distutils.core import Command
|
|
|
|
from distutils.errors import DistutilsOptionError
|
|
|
|
from distutils.util import get_platform
|
|
|
|
|
|
|
|
|
|
|
|
def show_compilers():
|
|
|
|
from distutils.ccompiler import show_compilers
|
|
|
|
|
|
|
|
show_compilers()
|
|
|
|
|
|
|
|
|
|
|
|
class build(Command):
|
|
|
|
|
|
|
|
description = "build everything needed to install"
|
|
|
|
|
|
|
|
user_options = [
|
|
|
|
('build-base=', 'b', "base directory for build library"),
|
|
|
|
('build-purelib=', None, "build directory for platform-neutral distributions"),
|
|
|
|
('build-platlib=', None, "build directory for platform-specific distributions"),
|
|
|
|
(
|
|
|
|
'build-lib=',
|
|
|
|
None,
|
|
|
|
"build directory for all distribution (defaults to either "
|
|
|
|
+ "build-purelib or build-platlib",
|
|
|
|
),
|
|
|
|
('build-scripts=', None, "build directory for scripts"),
|
|
|
|
('build-temp=', 't', "temporary build directory"),
|
|
|
|
(
|
|
|
|
'plat-name=',
|
|
|
|
'p',
|
|
|
|
"platform name to build for, if supported "
|
|
|
|
"(default: %s)" % get_platform(),
|
|
|
|
),
|
|
|
|
('compiler=', 'c', "specify the compiler type"),
|
|
|
|
('parallel=', 'j', "number of parallel build jobs"),
|
|
|
|
('debug', 'g', "compile extensions and libraries with debugging information"),
|
|
|
|
('force', 'f', "forcibly build everything (ignore file timestamps)"),
|
|
|
|
('executable=', 'e', "specify final destination interpreter path (build.py)"),
|
|
|
|
]
|
|
|
|
|
|
|
|
boolean_options = ['debug', 'force']
|
|
|
|
|
|
|
|
help_options = [
|
|
|
|
('help-compiler', None, "list available compilers", show_compilers),
|
|
|
|
]
|
|
|
|
|
|
|
|
def initialize_options(self):
|
|
|
|
self.build_base = 'build'
|
|
|
|
# these are decided only after 'build_base' has its final value
|
|
|
|
# (unless overridden by the user or client)
|
|
|
|
self.build_purelib = None
|
|
|
|
self.build_platlib = None
|
|
|
|
self.build_lib = None
|
|
|
|
self.build_temp = None
|
|
|
|
self.build_scripts = None
|
|
|
|
self.compiler = None
|
|
|
|
self.plat_name = None
|
|
|
|
self.debug = None
|
|
|
|
self.force = 0
|
|
|
|
self.executable = None
|
|
|
|
self.parallel = None
|
|
|
|
|
|
|
|
def finalize_options(self): # noqa: C901
|
|
|
|
if self.plat_name is None:
|
|
|
|
self.plat_name = get_platform()
|
|
|
|
else:
|
|
|
|
# plat-name only supported for windows (other platforms are
|
|
|
|
# supported via ./configure flags, if at all). Avoid misleading
|
|
|
|
# other platforms.
|
|
|
|
if os.name != 'nt':
|
|
|
|
raise DistutilsOptionError(
|
|
|
|
"--plat-name only supported on Windows (try "
|
|
|
|
"using './configure --help' on your platform)"
|
|
|
|
)
|
|
|
|
|
|
|
|
plat_specifier = ".{}-{}".format(self.plat_name, sys.implementation.cache_tag)
|
|
|
|
|
|
|
|
# Make it so Python 2.x and Python 2.x with --with-pydebug don't
|
|
|
|
# share the same build directories. Doing so confuses the build
|
|
|
|
# process for C modules
|
|
|
|
if hasattr(sys, 'gettotalrefcount'):
|
|
|
|
plat_specifier += '-pydebug'
|
|
|
|
|
|
|
|
# 'build_purelib' and 'build_platlib' just default to 'lib' and
|
|
|
|
# 'lib.<plat>' under the base build directory. We only use one of
|
|
|
|
# them for a given distribution, though --
|
|
|
|
if self.build_purelib is None:
|
|
|
|
self.build_purelib = os.path.join(self.build_base, 'lib')
|
|
|
|
if self.build_platlib is None:
|
|
|
|
self.build_platlib = os.path.join(self.build_base, 'lib' + plat_specifier)
|
|
|
|
|
|
|
|
# 'build_lib' is the actual directory that we will use for this
|
|
|
|
# particular module distribution -- if user didn't supply it, pick
|
|
|
|
# one of 'build_purelib' or 'build_platlib'.
|
|
|
|
if self.build_lib is None:
|
|
|
|
if self.distribution.has_ext_modules():
|
|
|
|
self.build_lib = self.build_platlib
|
|
|
|
else:
|
|
|
|
self.build_lib = self.build_purelib
|
|
|
|
|
|
|
|
# 'build_temp' -- temporary directory for compiler turds,
|
|
|
|
# "build/temp.<plat>"
|
|
|
|
if self.build_temp is None:
|
|
|
|
self.build_temp = os.path.join(self.build_base, 'temp' + plat_specifier)
|
|
|
|
if self.build_scripts is None:
|
|
|
|
self.build_scripts = os.path.join(
|
|
|
|
self.build_base, 'scripts-%d.%d' % sys.version_info[:2]
|
|
|
|
)
|
|
|
|
|
|
|
|
if self.executable is None and sys.executable:
|
|
|
|
self.executable = os.path.normpath(sys.executable)
|
|
|
|
|
|
|
|
if isinstance(self.parallel, str):
|
|
|
|
try:
|
|
|
|
self.parallel = int(self.parallel)
|
|
|
|
except ValueError:
|
|
|
|
raise DistutilsOptionError("parallel should be an integer")
|
|
|
|
|
|
|
|
def run(self):
|
|
|
|
# Run all relevant sub-commands. This will be some subset of:
|
|
|
|
# - build_py - pure Python modules
|
|
|
|
# - build_clib - standalone C libraries
|
|
|
|
# - build_ext - Python extensions
|
|
|
|
# - build_scripts - (Python) scripts
|
|
|
|
for cmd_name in self.get_sub_commands():
|
|
|
|
self.run_command(cmd_name)
|
|
|
|
|
|
|
|
# -- Predicates for the sub-command list ---------------------------
|
|
|
|
|
|
|
|
def has_pure_modules(self):
|
|
|
|
return self.distribution.has_pure_modules()
|
|
|
|
|
|
|
|
def has_c_libraries(self):
|
|
|
|
return self.distribution.has_c_libraries()
|
|
|
|
|
|
|
|
def has_ext_modules(self):
|
|
|
|
return self.distribution.has_ext_modules()
|
|
|
|
|
|
|
|
def has_scripts(self):
|
|
|
|
return self.distribution.has_scripts()
|
|
|
|
|
|
|
|
sub_commands = [
|
|
|
|
('build_py', has_pure_modules),
|
|
|
|
('build_clib', has_c_libraries),
|
|
|
|
('build_ext', has_ext_modules),
|
|
|
|
('build_scripts', has_scripts),
|
|
|
|
]
|