mirror of
https://github.com/python/cpython.git
synced 2025-07-18 00:35:17 +00:00
9f90a731eb
The contents of this attribute are an implementation detail, as documented for #9442, so we should not parse it, to support non-CPython VMs with distutils2 in the future. Unfortunately, one use comes directly from PEP 345, so an edit will have to be agreed before fixing the code (see comment in p7g.markers). Other remaining uses are found in p7g.compiler and could be replaced by the platform module (which also parses sys.version, but then it wouldn’t be my fault :)
605 lines
25 KiB
Python
605 lines
25 KiB
Python
"""Main install command, which calls the other install_* commands."""
|
|
|
|
import sys
|
|
import os
|
|
|
|
import sysconfig
|
|
from sysconfig import get_config_vars, get_paths, get_path, get_config_var
|
|
|
|
from packaging import logger
|
|
from packaging.command.cmd import Command
|
|
from packaging.errors import PackagingPlatformError
|
|
from packaging.util import write_file
|
|
from packaging.util import convert_path, change_root, get_platform
|
|
from packaging.errors import PackagingOptionError
|
|
|
|
|
|
class install_dist(Command):
|
|
|
|
description = "install everything from build directory"
|
|
|
|
user_options = [
|
|
# Select installation scheme and set base director(y|ies)
|
|
('prefix=', None,
|
|
"installation prefix"),
|
|
('exec-prefix=', None,
|
|
"(Unix only) prefix for platform-specific files"),
|
|
('user', None,
|
|
"install in user site-packages directory [%s]" %
|
|
get_path('purelib', '%s_user' % os.name)),
|
|
('home=', None,
|
|
"(Unix only) home directory to install under"),
|
|
|
|
# Or just set the base director(y|ies)
|
|
('install-base=', None,
|
|
"base installation directory (instead of --prefix or --home)"),
|
|
('install-platbase=', None,
|
|
"base installation directory for platform-specific files " +
|
|
"(instead of --exec-prefix or --home)"),
|
|
('root=', None,
|
|
"install everything relative to this alternate root directory"),
|
|
|
|
# Or explicitly set the installation scheme
|
|
('install-purelib=', None,
|
|
"installation directory for pure Python module distributions"),
|
|
('install-platlib=', None,
|
|
"installation directory for non-pure module distributions"),
|
|
('install-lib=', None,
|
|
"installation directory for all module distributions " +
|
|
"(overrides --install-purelib and --install-platlib)"),
|
|
|
|
('install-headers=', None,
|
|
"installation directory for C/C++ headers"),
|
|
('install-scripts=', None,
|
|
"installation directory for Python scripts"),
|
|
('install-data=', None,
|
|
"installation directory for data files"),
|
|
|
|
# Byte-compilation options -- see install_lib for details
|
|
('compile', 'c', "compile .py to .pyc [default]"),
|
|
('no-compile', None, "don't compile .py files"),
|
|
('optimize=', 'O',
|
|
'also compile with optimization: -O1 for "python -O", '
|
|
'-O2 for "python -OO", and -O0 to disable [default: -O0]'),
|
|
|
|
# Miscellaneous control options
|
|
('force', 'f',
|
|
"force installation (overwrite any existing files)"),
|
|
('skip-build', None,
|
|
"skip rebuilding everything (for testing/debugging)"),
|
|
|
|
# Where to install documentation (eventually!)
|
|
#('doc-format=', None, "format of documentation to generate"),
|
|
#('install-man=', None, "directory for Unix man pages"),
|
|
#('install-html=', None, "directory for HTML documentation"),
|
|
#('install-info=', None, "directory for GNU info files"),
|
|
|
|
# XXX use a name that makes clear this is the old format
|
|
('record=', None,
|
|
"filename in which to record a list of installed files "
|
|
"(not PEP 376-compliant)"),
|
|
('resources=', None,
|
|
"data files mapping"),
|
|
|
|
# .dist-info related arguments, read by install_dist_info
|
|
('no-distinfo', None,
|
|
"do not create a .dist-info directory"),
|
|
('installer=', None,
|
|
"the name of the installer"),
|
|
('requested', None,
|
|
"generate a REQUESTED file (i.e."),
|
|
('no-requested', None,
|
|
"do not generate a REQUESTED file"),
|
|
('no-record', None,
|
|
"do not generate a RECORD file"),
|
|
]
|
|
|
|
boolean_options = ['compile', 'force', 'skip-build', 'no-distinfo',
|
|
'requested', 'no-record', 'user']
|
|
|
|
negative_opt = {'no-compile': 'compile', 'no-requested': 'requested'}
|
|
|
|
def initialize_options(self):
|
|
# High-level options: these select both an installation base
|
|
# and scheme.
|
|
self.prefix = None
|
|
self.exec_prefix = None
|
|
self.home = None
|
|
self.user = False
|
|
|
|
# These select only the installation base; it's up to the user to
|
|
# specify the installation scheme (currently, that means supplying
|
|
# the --install-{platlib,purelib,scripts,data} options).
|
|
self.install_base = None
|
|
self.install_platbase = None
|
|
self.root = None
|
|
|
|
# These options are the actual installation directories; if not
|
|
# supplied by the user, they are filled in using the installation
|
|
# scheme implied by prefix/exec-prefix/home and the contents of
|
|
# that installation scheme.
|
|
self.install_purelib = None # for pure module distributions
|
|
self.install_platlib = None # non-pure (dists w/ extensions)
|
|
self.install_headers = None # for C/C++ headers
|
|
self.install_lib = None # set to either purelib or platlib
|
|
self.install_scripts = None
|
|
self.install_data = None
|
|
self.install_userbase = get_config_var('userbase')
|
|
self.install_usersite = get_path('purelib', '%s_user' % os.name)
|
|
|
|
self.compile = None
|
|
self.optimize = None
|
|
|
|
# These two are for putting non-packagized distributions into their
|
|
# own directory and creating a .pth file if it makes sense.
|
|
# 'extra_path' comes from the setup file; 'install_path_file' can
|
|
# be turned off if it makes no sense to install a .pth file. (But
|
|
# better to install it uselessly than to guess wrong and not
|
|
# install it when it's necessary and would be used!) Currently,
|
|
# 'install_path_file' is always true unless some outsider meddles
|
|
# with it.
|
|
self.extra_path = None
|
|
self.install_path_file = True
|
|
|
|
# 'force' forces installation, even if target files are not
|
|
# out-of-date. 'skip_build' skips running the "build" command,
|
|
# handy if you know it's not necessary. 'warn_dir' (which is *not*
|
|
# a user option, it's just there so the bdist_* commands can turn
|
|
# it off) determines whether we warn about installing to a
|
|
# directory not in sys.path.
|
|
self.force = False
|
|
self.skip_build = False
|
|
self.warn_dir = True
|
|
|
|
# These are only here as a conduit from the 'build' command to the
|
|
# 'install_*' commands that do the real work. ('build_base' isn't
|
|
# actually used anywhere, but it might be useful in future.) They
|
|
# are not user options, because if the user told the install
|
|
# command where the build directory is, that wouldn't affect the
|
|
# build command.
|
|
self.build_base = None
|
|
self.build_lib = None
|
|
|
|
# Not defined yet because we don't know anything about
|
|
# documentation yet.
|
|
#self.install_man = None
|
|
#self.install_html = None
|
|
#self.install_info = None
|
|
|
|
self.record = None
|
|
self.resources = None
|
|
|
|
# .dist-info related options
|
|
self.no_distinfo = None
|
|
self.installer = None
|
|
self.requested = None
|
|
self.no_record = None
|
|
|
|
# -- Option finalizing methods -------------------------------------
|
|
# (This is rather more involved than for most commands,
|
|
# because this is where the policy for installing third-
|
|
# party Python modules on various platforms given a wide
|
|
# array of user input is decided. Yes, it's quite complex!)
|
|
|
|
def finalize_options(self):
|
|
# This method (and its pliant slaves, like 'finalize_unix()',
|
|
# 'finalize_other()', and 'select_scheme()') is where the default
|
|
# installation directories for modules, extension modules, and
|
|
# anything else we care to install from a Python module
|
|
# distribution. Thus, this code makes a pretty important policy
|
|
# statement about how third-party stuff is added to a Python
|
|
# installation! Note that the actual work of installation is done
|
|
# by the relatively simple 'install_*' commands; they just take
|
|
# their orders from the installation directory options determined
|
|
# here.
|
|
|
|
# Check for errors/inconsistencies in the options; first, stuff
|
|
# that's wrong on any platform.
|
|
|
|
if ((self.prefix or self.exec_prefix or self.home) and
|
|
(self.install_base or self.install_platbase)):
|
|
raise PackagingOptionError(
|
|
"must supply either prefix/exec-prefix/home or "
|
|
"install-base/install-platbase -- not both")
|
|
|
|
if self.home and (self.prefix or self.exec_prefix):
|
|
raise PackagingOptionError(
|
|
"must supply either home or prefix/exec-prefix -- not both")
|
|
|
|
if self.user and (self.prefix or self.exec_prefix or self.home or
|
|
self.install_base or self.install_platbase):
|
|
raise PackagingOptionError(
|
|
"can't combine user with prefix/exec_prefix/home or "
|
|
"install_base/install_platbase")
|
|
|
|
# Next, stuff that's wrong (or dubious) only on certain platforms.
|
|
if os.name != "posix":
|
|
if self.exec_prefix:
|
|
logger.warning(
|
|
'%s: exec-prefix option ignored on this platform',
|
|
self.get_command_name())
|
|
self.exec_prefix = None
|
|
|
|
# Now the interesting logic -- so interesting that we farm it out
|
|
# to other methods. The goal of these methods is to set the final
|
|
# values for the install_{lib,scripts,data,...} options, using as
|
|
# input a heady brew of prefix, exec_prefix, home, install_base,
|
|
# install_platbase, user-supplied versions of
|
|
# install_{purelib,platlib,lib,scripts,data,...}, and the
|
|
# INSTALL_SCHEME dictionary above. Phew!
|
|
|
|
self.dump_dirs("pre-finalize_{unix,other}")
|
|
|
|
if os.name == 'posix':
|
|
self.finalize_unix()
|
|
else:
|
|
self.finalize_other()
|
|
|
|
self.dump_dirs("post-finalize_{unix,other}()")
|
|
|
|
# Expand configuration variables, tilde, etc. in self.install_base
|
|
# and self.install_platbase -- that way, we can use $base or
|
|
# $platbase in the other installation directories and not worry
|
|
# about needing recursive variable expansion (shudder).
|
|
|
|
py_version = '%s.%s' % sys.version_info[:2]
|
|
prefix, exec_prefix, srcdir, projectbase = get_config_vars(
|
|
'prefix', 'exec_prefix', 'srcdir', 'projectbase')
|
|
|
|
metadata = self.distribution.metadata
|
|
self.config_vars = {
|
|
'dist_name': metadata['Name'],
|
|
'dist_version': metadata['Version'],
|
|
'dist_fullname': metadata.get_fullname(),
|
|
'py_version': py_version,
|
|
'py_version_short': py_version[:3],
|
|
'py_version_nodot': py_version[:3:2],
|
|
'sys_prefix': prefix,
|
|
'prefix': prefix,
|
|
'sys_exec_prefix': exec_prefix,
|
|
'exec_prefix': exec_prefix,
|
|
'srcdir': srcdir,
|
|
'projectbase': projectbase,
|
|
'userbase': self.install_userbase,
|
|
'usersite': self.install_usersite,
|
|
}
|
|
|
|
self.expand_basedirs()
|
|
|
|
self.dump_dirs("post-expand_basedirs()")
|
|
|
|
# Now define config vars for the base directories so we can expand
|
|
# everything else.
|
|
self.config_vars['base'] = self.install_base
|
|
self.config_vars['platbase'] = self.install_platbase
|
|
|
|
# Expand "~" and configuration variables in the installation
|
|
# directories.
|
|
self.expand_dirs()
|
|
|
|
self.dump_dirs("post-expand_dirs()")
|
|
|
|
# Create directories under USERBASE
|
|
if self.user:
|
|
self.create_user_dirs()
|
|
|
|
# Pick the actual directory to install all modules to: either
|
|
# install_purelib or install_platlib, depending on whether this
|
|
# module distribution is pure or not. Of course, if the user
|
|
# already specified install_lib, use their selection.
|
|
if self.install_lib is None:
|
|
if self.distribution.ext_modules: # has extensions: non-pure
|
|
self.install_lib = self.install_platlib
|
|
else:
|
|
self.install_lib = self.install_purelib
|
|
|
|
# Convert directories from Unix /-separated syntax to the local
|
|
# convention.
|
|
self.convert_paths('lib', 'purelib', 'platlib', 'scripts',
|
|
'data', 'headers', 'userbase', 'usersite')
|
|
|
|
# Well, we're not actually fully completely finalized yet: we still
|
|
# have to deal with 'extra_path', which is the hack for allowing
|
|
# non-packagized module distributions (hello, Numerical Python!) to
|
|
# get their own directories.
|
|
self.handle_extra_path()
|
|
self.install_libbase = self.install_lib # needed for .pth file
|
|
self.install_lib = os.path.join(self.install_lib, self.extra_dirs)
|
|
|
|
# If a new root directory was supplied, make all the installation
|
|
# dirs relative to it.
|
|
if self.root is not None:
|
|
self.change_roots('libbase', 'lib', 'purelib', 'platlib',
|
|
'scripts', 'data', 'headers')
|
|
|
|
self.dump_dirs("after prepending root")
|
|
|
|
# Find out the build directories, ie. where to install from.
|
|
self.set_undefined_options('build', 'build_base', 'build_lib')
|
|
|
|
# Punt on doc directories for now -- after all, we're punting on
|
|
# documentation completely!
|
|
|
|
if self.no_distinfo is None:
|
|
self.no_distinfo = False
|
|
|
|
def finalize_unix(self):
|
|
"""Finalize options for posix platforms."""
|
|
if self.install_base is not None or self.install_platbase is not None:
|
|
if ((self.install_lib is None and
|
|
self.install_purelib is None and
|
|
self.install_platlib is None) or
|
|
self.install_headers is None or
|
|
self.install_scripts is None or
|
|
self.install_data is None):
|
|
raise PackagingOptionError(
|
|
"install-base or install-platbase supplied, but "
|
|
"installation scheme is incomplete")
|
|
return
|
|
|
|
if self.user:
|
|
if self.install_userbase is None:
|
|
raise PackagingPlatformError(
|
|
"user base directory is not specified")
|
|
self.install_base = self.install_platbase = self.install_userbase
|
|
self.select_scheme("posix_user")
|
|
elif self.home is not None:
|
|
self.install_base = self.install_platbase = self.home
|
|
self.select_scheme("posix_home")
|
|
else:
|
|
if self.prefix is None:
|
|
if self.exec_prefix is not None:
|
|
raise PackagingOptionError(
|
|
"must not supply exec-prefix without prefix")
|
|
|
|
self.prefix = os.path.normpath(sys.prefix)
|
|
self.exec_prefix = os.path.normpath(sys.exec_prefix)
|
|
|
|
else:
|
|
if self.exec_prefix is None:
|
|
self.exec_prefix = self.prefix
|
|
|
|
self.install_base = self.prefix
|
|
self.install_platbase = self.exec_prefix
|
|
self.select_scheme("posix_prefix")
|
|
|
|
def finalize_other(self):
|
|
"""Finalize options for non-posix platforms"""
|
|
if self.user:
|
|
if self.install_userbase is None:
|
|
raise PackagingPlatformError(
|
|
"user base directory is not specified")
|
|
self.install_base = self.install_platbase = self.install_userbase
|
|
self.select_scheme(os.name + "_user")
|
|
elif self.home is not None:
|
|
self.install_base = self.install_platbase = self.home
|
|
self.select_scheme("posix_home")
|
|
else:
|
|
if self.prefix is None:
|
|
self.prefix = os.path.normpath(sys.prefix)
|
|
|
|
self.install_base = self.install_platbase = self.prefix
|
|
try:
|
|
self.select_scheme(os.name)
|
|
except KeyError:
|
|
raise PackagingPlatformError(
|
|
"no support for installation on '%s'" % os.name)
|
|
|
|
def dump_dirs(self, msg):
|
|
"""Dump the list of user options."""
|
|
logger.debug(msg + ":")
|
|
for opt in self.user_options:
|
|
opt_name = opt[0]
|
|
if opt_name[-1] == "=":
|
|
opt_name = opt_name[0:-1]
|
|
if opt_name in self.negative_opt:
|
|
opt_name = self.negative_opt[opt_name]
|
|
opt_name = opt_name.replace('-', '_')
|
|
val = not getattr(self, opt_name)
|
|
else:
|
|
opt_name = opt_name.replace('-', '_')
|
|
val = getattr(self, opt_name)
|
|
logger.debug(" %s: %s", opt_name, val)
|
|
|
|
def select_scheme(self, name):
|
|
"""Set the install directories by applying the install schemes."""
|
|
# it's the caller's problem if they supply a bad name!
|
|
scheme = get_paths(name, expand=False)
|
|
for key, value in scheme.items():
|
|
if key == 'platinclude':
|
|
key = 'headers'
|
|
value = os.path.join(value, self.distribution.metadata['Name'])
|
|
attrname = 'install_' + key
|
|
if hasattr(self, attrname):
|
|
if getattr(self, attrname) is None:
|
|
setattr(self, attrname, value)
|
|
|
|
def _expand_attrs(self, attrs):
|
|
for attr in attrs:
|
|
val = getattr(self, attr)
|
|
if val is not None:
|
|
if os.name == 'posix' or os.name == 'nt':
|
|
val = os.path.expanduser(val)
|
|
# see if we want to push this work in sysconfig XXX
|
|
val = sysconfig._subst_vars(val, self.config_vars)
|
|
setattr(self, attr, val)
|
|
|
|
def expand_basedirs(self):
|
|
"""Call `os.path.expanduser` on install_{base,platbase} and root."""
|
|
self._expand_attrs(['install_base', 'install_platbase', 'root'])
|
|
|
|
def expand_dirs(self):
|
|
"""Call `os.path.expanduser` on install dirs."""
|
|
self._expand_attrs(['install_purelib', 'install_platlib',
|
|
'install_lib', 'install_headers',
|
|
'install_scripts', 'install_data'])
|
|
|
|
def convert_paths(self, *names):
|
|
"""Call `convert_path` over `names`."""
|
|
for name in names:
|
|
attr = "install_" + name
|
|
setattr(self, attr, convert_path(getattr(self, attr)))
|
|
|
|
def handle_extra_path(self):
|
|
"""Set `path_file` and `extra_dirs` using `extra_path`."""
|
|
if self.extra_path is None:
|
|
self.extra_path = self.distribution.extra_path
|
|
|
|
if self.extra_path is not None:
|
|
if isinstance(self.extra_path, str):
|
|
self.extra_path = self.extra_path.split(',')
|
|
|
|
if len(self.extra_path) == 1:
|
|
path_file = extra_dirs = self.extra_path[0]
|
|
elif len(self.extra_path) == 2:
|
|
path_file, extra_dirs = self.extra_path
|
|
else:
|
|
raise PackagingOptionError(
|
|
"'extra_path' option must be a list, tuple, or "
|
|
"comma-separated string with 1 or 2 elements")
|
|
|
|
# convert to local form in case Unix notation used (as it
|
|
# should be in setup scripts)
|
|
extra_dirs = convert_path(extra_dirs)
|
|
else:
|
|
path_file = None
|
|
extra_dirs = ''
|
|
|
|
# XXX should we warn if path_file and not extra_dirs? (in which
|
|
# case the path file would be harmless but pointless)
|
|
self.path_file = path_file
|
|
self.extra_dirs = extra_dirs
|
|
|
|
def change_roots(self, *names):
|
|
"""Change the install direcories pointed by name using root."""
|
|
for name in names:
|
|
attr = "install_" + name
|
|
setattr(self, attr, change_root(self.root, getattr(self, attr)))
|
|
|
|
def create_user_dirs(self):
|
|
"""Create directories under USERBASE as needed."""
|
|
home = convert_path(os.path.expanduser("~"))
|
|
for name, path in self.config_vars.items():
|
|
if path.startswith(home) and not os.path.isdir(path):
|
|
os.makedirs(path, 0o700)
|
|
|
|
# -- Command execution methods -------------------------------------
|
|
|
|
def run(self):
|
|
"""Runs the command."""
|
|
# Obviously have to build before we can install
|
|
if not self.skip_build:
|
|
self.run_command('build')
|
|
# If we built for any other platform, we can't install.
|
|
build_plat = self.distribution.get_command_obj('build').plat_name
|
|
# check warn_dir - it is a clue that the 'install_dist' is happening
|
|
# internally, and not to sys.path, so we don't check the platform
|
|
# matches what we are running.
|
|
if self.warn_dir and build_plat != get_platform():
|
|
raise PackagingPlatformError("Can't install when "
|
|
"cross-compiling")
|
|
|
|
# Run all sub-commands (at least those that need to be run)
|
|
for cmd_name in self.get_sub_commands():
|
|
self.run_command(cmd_name)
|
|
|
|
if self.path_file:
|
|
self.create_path_file()
|
|
|
|
# write list of installed files, if requested.
|
|
if self.record:
|
|
outputs = self.get_outputs()
|
|
if self.root: # strip any package prefix
|
|
root_len = len(self.root)
|
|
for counter in range(len(outputs)):
|
|
outputs[counter] = outputs[counter][root_len:]
|
|
self.execute(write_file,
|
|
(self.record, outputs),
|
|
"writing list of installed files to '%s'" %
|
|
self.record)
|
|
|
|
normpath, normcase = os.path.normpath, os.path.normcase
|
|
sys_path = [normcase(normpath(p)) for p in sys.path]
|
|
install_lib = normcase(normpath(self.install_lib))
|
|
if (self.warn_dir and
|
|
not (self.path_file and self.install_path_file) and
|
|
install_lib not in sys_path):
|
|
logger.debug(("modules installed to '%s', which is not in "
|
|
"Python's module search path (sys.path) -- "
|
|
"you'll have to change the search path yourself"),
|
|
self.install_lib)
|
|
|
|
def create_path_file(self):
|
|
"""Creates the .pth file"""
|
|
filename = os.path.join(self.install_libbase,
|
|
self.path_file + ".pth")
|
|
if self.install_path_file:
|
|
self.execute(write_file,
|
|
(filename, [self.extra_dirs]),
|
|
"creating %s" % filename)
|
|
else:
|
|
logger.warning('%s: path file %r not created',
|
|
self.get_command_name(), filename)
|
|
|
|
# -- Reporting methods ---------------------------------------------
|
|
|
|
def get_outputs(self):
|
|
"""Assembles the outputs of all the sub-commands."""
|
|
outputs = []
|
|
for cmd_name in self.get_sub_commands():
|
|
cmd = self.get_finalized_command(cmd_name)
|
|
# Add the contents of cmd.get_outputs(), ensuring
|
|
# that outputs doesn't contain duplicate entries
|
|
for filename in cmd.get_outputs():
|
|
if filename not in outputs:
|
|
outputs.append(filename)
|
|
|
|
if self.path_file and self.install_path_file:
|
|
outputs.append(os.path.join(self.install_libbase,
|
|
self.path_file + ".pth"))
|
|
|
|
return outputs
|
|
|
|
def get_inputs(self):
|
|
"""Returns the inputs of all the sub-commands"""
|
|
# XXX gee, this looks familiar ;-(
|
|
inputs = []
|
|
for cmd_name in self.get_sub_commands():
|
|
cmd = self.get_finalized_command(cmd_name)
|
|
inputs.extend(cmd.get_inputs())
|
|
|
|
return inputs
|
|
|
|
# -- Predicates for sub-command list -------------------------------
|
|
|
|
def has_lib(self):
|
|
"""Returns true if the current distribution has any Python
|
|
modules to install."""
|
|
return (self.distribution.has_pure_modules() or
|
|
self.distribution.has_ext_modules())
|
|
|
|
def has_headers(self):
|
|
"""Returns true if the current distribution has any headers to
|
|
install."""
|
|
return self.distribution.has_headers()
|
|
|
|
def has_scripts(self):
|
|
"""Returns true if the current distribution has any scripts to.
|
|
install."""
|
|
return self.distribution.has_scripts()
|
|
|
|
def has_data(self):
|
|
"""Returns true if the current distribution has any data to.
|
|
install."""
|
|
return self.distribution.has_data_files()
|
|
|
|
# 'sub_commands': a list of commands this command might have to run to
|
|
# get its work done. See cmd.py for more info.
|
|
sub_commands = [('install_lib', has_lib),
|
|
('install_headers', has_headers),
|
|
('install_scripts', has_scripts),
|
|
('install_data', has_data),
|
|
# keep install_distinfo last, as it needs the record
|
|
# with files to be completely generated
|
|
('install_distinfo', lambda self: not self.no_distinfo),
|
|
]
|