Python code coverage for Lib/packaging/command/install_dist.py

#	count	content
1	n/a	"""Main install command, which calls the other install_* commands."""
2	n/a
3	n/a	import sys
4	n/a	import os
5	n/a
6	n/a	import sysconfig
7	n/a	from sysconfig import get_config_vars, get_paths, get_path, get_config_var
8	n/a
9	n/a	from packaging import logger
10	n/a	from packaging.command.cmd import Command
11	n/a	from packaging.errors import PackagingPlatformError
12	n/a	from packaging.util import write_file
13	n/a	from packaging.util import convert_path, change_root, get_platform
14	n/a	from packaging.errors import PackagingOptionError
15	n/a
16	n/a
17	n/a	class install_dist(Command):
18	n/a
19	n/a	description = "install everything from build directory"
20	n/a
21	n/a	user_options = [
22	n/a	# Select installation scheme and set base director(y\|ies)
23	n/a	('prefix=', None,
24	n/a	"installation prefix"),
25	n/a	('exec-prefix=', None,
26	n/a	"(Unix only) prefix for platform-specific files"),
27	n/a	('user', None,
28	n/a	"install in user site-packages directory [%s]" %
29	n/a	get_path('purelib', '%s_user' % os.name)),
30	n/a	('home=', None,
31	n/a	"(Unix only) home directory to install under"),
32	n/a
33	n/a	# Or just set the base director(y\|ies)
34	n/a	('install-base=', None,
35	n/a	"base installation directory (instead of --prefix or --home)"),
36	n/a	('install-platbase=', None,
37	n/a	"base installation directory for platform-specific files " +
38	n/a	"(instead of --exec-prefix or --home)"),
39	n/a	('root=', None,
40	n/a	"install everything relative to this alternate root directory"),
41	n/a
42	n/a	# Or explicitly set the installation scheme
43	n/a	('install-purelib=', None,
44	n/a	"installation directory for pure Python module distributions"),
45	n/a	('install-platlib=', None,
46	n/a	"installation directory for non-pure module distributions"),
47	n/a	('install-lib=', None,
48	n/a	"installation directory for all module distributions " +
49	n/a	"(overrides --install-purelib and --install-platlib)"),
50	n/a
51	n/a	('install-headers=', None,
52	n/a	"installation directory for C/C++ headers"),
53	n/a	('install-scripts=', None,
54	n/a	"installation directory for Python scripts"),
55	n/a	('install-data=', None,
56	n/a	"installation directory for data files"),
57	n/a
58	n/a	# Byte-compilation options -- see install_lib for details
59	n/a	('compile', 'c', "compile .py to .pyc [default]"),
60	n/a	('no-compile', None, "don't compile .py files"),
61	n/a	('optimize=', 'O',
62	n/a	'also compile with optimization: -O1 for "python -O", '
63	n/a	'-O2 for "python -OO", and -O0 to disable [default: -O0]'),
64	n/a
65	n/a	# Miscellaneous control options
66	n/a	('force', 'f',
67	n/a	"force installation (overwrite any existing files)"),
68	n/a	('skip-build', None,
69	n/a	"skip rebuilding everything (for testing/debugging)"),
70	n/a
71	n/a	# Where to install documentation (eventually!)
72	n/a	#('doc-format=', None, "format of documentation to generate"),
73	n/a	#('install-man=', None, "directory for Unix man pages"),
74	n/a	#('install-html=', None, "directory for HTML documentation"),
75	n/a	#('install-info=', None, "directory for GNU info files"),
76	n/a
77	n/a	# XXX use a name that makes clear this is the old format
78	n/a	('record=', None,
79	n/a	"filename in which to record a list of installed files "
80	n/a	"(not PEP 376-compliant)"),
81	n/a	('resources=', None,
82	n/a	"data files mapping"),
83	n/a
84	n/a	# .dist-info related arguments, read by install_dist_info
85	n/a	('no-distinfo', None,
86	n/a	"do not create a .dist-info directory"),
87	n/a	('installer=', None,
88	n/a	"the name of the installer"),
89	n/a	('requested', None,
90	n/a	"generate a REQUESTED file (i.e."),
91	n/a	('no-requested', None,
92	n/a	"do not generate a REQUESTED file"),
93	n/a	('no-record', None,
94	n/a	"do not generate a RECORD file"),
95	n/a	]
96	n/a
97	n/a	boolean_options = ['compile', 'force', 'skip-build', 'no-distinfo',
98	n/a	'requested', 'no-record', 'user']
99	n/a
100	n/a	negative_opt = {'no-compile': 'compile', 'no-requested': 'requested'}
101	n/a
102	n/a	def initialize_options(self):
103	n/a	# High-level options: these select both an installation base
104	n/a	# and scheme.
105	n/a	self.prefix = None
106	n/a	self.exec_prefix = None
107	n/a	self.home = None
108	n/a	self.user = False
109	n/a
110	n/a	# These select only the installation base; it's up to the user to
111	n/a	# specify the installation scheme (currently, that means supplying
112	n/a	# the --install-{platlib,purelib,scripts,data} options).
113	n/a	self.install_base = None
114	n/a	self.install_platbase = None
115	n/a	self.root = None
116	n/a
117	n/a	# These options are the actual installation directories; if not
118	n/a	# supplied by the user, they are filled in using the installation
119	n/a	# scheme implied by prefix/exec-prefix/home and the contents of
120	n/a	# that installation scheme.
121	n/a	self.install_purelib = None # for pure module distributions
122	n/a	self.install_platlib = None # non-pure (dists w/ extensions)
123	n/a	self.install_headers = None # for C/C++ headers
124	n/a	self.install_lib = None # set to either purelib or platlib
125	n/a	self.install_scripts = None
126	n/a	self.install_data = None
127	n/a	self.install_userbase = get_config_var('userbase')
128	n/a	self.install_usersite = get_path('purelib', '%s_user' % os.name)
129	n/a
130	n/a	self.compile = None
131	n/a	self.optimize = None
132	n/a
133	n/a	# These two are for putting non-packagized distributions into their
134	n/a	# own directory and creating a .pth file if it makes sense.
135	n/a	# 'extra_path' comes from the setup file; 'install_path_file' can
136	n/a	# be turned off if it makes no sense to install a .pth file. (But
137	n/a	# better to install it uselessly than to guess wrong and not
138	n/a	# install it when it's necessary and would be used!) Currently,
139	n/a	# 'install_path_file' is always true unless some outsider meddles
140	n/a	# with it.
141	n/a	self.extra_path = None
142	n/a	self.install_path_file = True
143	n/a
144	n/a	# 'force' forces installation, even if target files are not
145	n/a	# out-of-date. 'skip_build' skips running the "build" command,
146	n/a	# handy if you know it's not necessary. 'warn_dir' (which is not
147	n/a	# a user option, it's just there so the bdist_* commands can turn
148	n/a	# it off) determines whether we warn about installing to a
149	n/a	# directory not in sys.path.
150	n/a	self.force = False
151	n/a	self.skip_build = False
152	n/a	self.warn_dir = True
153	n/a
154	n/a	# These are only here as a conduit from the 'build' command to the
155	n/a	# 'install_*' commands that do the real work. ('build_base' isn't
156	n/a	# actually used anywhere, but it might be useful in future.) They
157	n/a	# are not user options, because if the user told the install
158	n/a	# command where the build directory is, that wouldn't affect the
159	n/a	# build command.
160	n/a	self.build_base = None
161	n/a	self.build_lib = None
162	n/a
163	n/a	# Not defined yet because we don't know anything about
164	n/a	# documentation yet.
165	n/a	#self.install_man = None
166	n/a	#self.install_html = None
167	n/a	#self.install_info = None
168	n/a
169	n/a	self.record = None
170	n/a	self.resources = None
171	n/a
172	n/a	# .dist-info related options
173	n/a	self.no_distinfo = None
174	n/a	self.installer = None
175	n/a	self.requested = None
176	n/a	self.no_record = None
177	n/a
178	n/a	# -- Option finalizing methods -------------------------------------
179	n/a	# (This is rather more involved than for most commands,
180	n/a	# because this is where the policy for installing third-
181	n/a	# party Python modules on various platforms given a wide
182	n/a	# array of user input is decided. Yes, it's quite complex!)
183	n/a
184	n/a	def finalize_options(self):
185	n/a	# This method (and its pliant slaves, like 'finalize_unix()',
186	n/a	# 'finalize_other()', and 'select_scheme()') is where the default
187	n/a	# installation directories for modules, extension modules, and
188	n/a	# anything else we care to install from a Python module
189	n/a	# distribution. Thus, this code makes a pretty important policy
190	n/a	# statement about how third-party stuff is added to a Python
191	n/a	# installation! Note that the actual work of installation is done
192	n/a	# by the relatively simple 'install_*' commands; they just take
193	n/a	# their orders from the installation directory options determined
194	n/a	# here.
195	n/a
196	n/a	# Check for errors/inconsistencies in the options; first, stuff
197	n/a	# that's wrong on any platform.
198	n/a
199	n/a	if ((self.prefix or self.exec_prefix or self.home) and
200	n/a	(self.install_base or self.install_platbase)):
201	n/a	raise PackagingOptionError(
202	n/a	"must supply either prefix/exec-prefix/home or "
203	n/a	"install-base/install-platbase -- not both")
204	n/a
205	n/a	if self.home and (self.prefix or self.exec_prefix):
206	n/a	raise PackagingOptionError(
207	n/a	"must supply either home or prefix/exec-prefix -- not both")
208	n/a
209	n/a	if self.user and (self.prefix or self.exec_prefix or self.home or
210	n/a	self.install_base or self.install_platbase):
211	n/a	raise PackagingOptionError(
212	n/a	"can't combine user with prefix/exec_prefix/home or "
213	n/a	"install_base/install_platbase")
214	n/a
215	n/a	# Next, stuff that's wrong (or dubious) only on certain platforms.
216	n/a	if os.name != "posix":
217	n/a	if self.exec_prefix:
218	n/a	logger.warning(
219	n/a	'%s: exec-prefix option ignored on this platform',
220	n/a	self.get_command_name())
221	n/a	self.exec_prefix = None
222	n/a
223	n/a	# Now the interesting logic -- so interesting that we farm it out
224	n/a	# to other methods. The goal of these methods is to set the final
225	n/a	# values for the install_{lib,scripts,data,...} options, using as
226	n/a	# input a heady brew of prefix, exec_prefix, home, install_base,
227	n/a	# install_platbase, user-supplied versions of
228	n/a	# install_{purelib,platlib,lib,scripts,data,...}, and the
229	n/a	# INSTALL_SCHEME dictionary above. Phew!
230	n/a
231	n/a	self.dump_dirs("pre-finalize_{unix,other}")
232	n/a
233	n/a	if os.name == 'posix':
234	n/a	self.finalize_unix()
235	n/a	else:
236	n/a	self.finalize_other()
237	n/a
238	n/a	self.dump_dirs("post-finalize_{unix,other}()")
239	n/a
240	n/a	# Expand configuration variables, tilde, etc. in self.install_base
241	n/a	# and self.install_platbase -- that way, we can use $base or
242	n/a	# $platbase in the other installation directories and not worry
243	n/a	# about needing recursive variable expansion (shudder).
244	n/a
245	n/a	py_version = '%s.%s' % sys.version_info[:2]
246	n/a	prefix, exec_prefix, srcdir, projectbase = get_config_vars(
247	n/a	'prefix', 'exec_prefix', 'srcdir', 'projectbase')
248	n/a
249	n/a	metadata = self.distribution.metadata
250	n/a	self.config_vars = {
251	n/a	'dist_name': metadata['Name'],
252	n/a	'dist_version': metadata['Version'],
253	n/a	'dist_fullname': metadata.get_fullname(),
254	n/a	'py_version': py_version,
255	n/a	'py_version_short': py_version[:3],
256	n/a	'py_version_nodot': py_version[:3:2],
257	n/a	'sys_prefix': prefix,
258	n/a	'prefix': prefix,
259	n/a	'sys_exec_prefix': exec_prefix,
260	n/a	'exec_prefix': exec_prefix,
261	n/a	'srcdir': srcdir,
262	n/a	'projectbase': projectbase,
263	n/a	'userbase': self.install_userbase,
264	n/a	'usersite': self.install_usersite,
265	n/a	}
266	n/a
267	n/a	self.expand_basedirs()
268	n/a
269	n/a	self.dump_dirs("post-expand_basedirs()")
270	n/a
271	n/a	# Now define config vars for the base directories so we can expand
272	n/a	# everything else.
273	n/a	self.config_vars['base'] = self.install_base
274	n/a	self.config_vars['platbase'] = self.install_platbase
275	n/a
276	n/a	# Expand "~" and configuration variables in the installation
277	n/a	# directories.
278	n/a	self.expand_dirs()
279	n/a
280	n/a	self.dump_dirs("post-expand_dirs()")
281	n/a
282	n/a	# Create directories under USERBASE
283	n/a	if self.user:
284	n/a	self.create_user_dirs()
285	n/a
286	n/a	# Pick the actual directory to install all modules to: either
287	n/a	# install_purelib or install_platlib, depending on whether this
288	n/a	# module distribution is pure or not. Of course, if the user
289	n/a	# already specified install_lib, use their selection.
290	n/a	if self.install_lib is None:
291	n/a	if self.distribution.ext_modules: # has extensions: non-pure
292	n/a	self.install_lib = self.install_platlib
293	n/a	else:
294	n/a	self.install_lib = self.install_purelib
295	n/a
296	n/a	# Convert directories from Unix /-separated syntax to the local
297	n/a	# convention.
298	n/a	self.convert_paths('lib', 'purelib', 'platlib', 'scripts',
299	n/a	'data', 'headers', 'userbase', 'usersite')
300	n/a
301	n/a	# Well, we're not actually fully completely finalized yet: we still
302	n/a	# have to deal with 'extra_path', which is the hack for allowing
303	n/a	# non-packagized module distributions (hello, Numerical Python!) to
304	n/a	# get their own directories.
305	n/a	self.handle_extra_path()
306	n/a	self.install_libbase = self.install_lib # needed for .pth file
307	n/a	self.install_lib = os.path.join(self.install_lib, self.extra_dirs)
308	n/a
309	n/a	# If a new root directory was supplied, make all the installation
310	n/a	# dirs relative to it.
311	n/a	if self.root is not None:
312	n/a	self.change_roots('libbase', 'lib', 'purelib', 'platlib',
313	n/a	'scripts', 'data', 'headers')
314	n/a
315	n/a	self.dump_dirs("after prepending root")
316	n/a
317	n/a	# Find out the build directories, ie. where to install from.
318	n/a	self.set_undefined_options('build', 'build_base', 'build_lib')
319	n/a
320	n/a	# Punt on doc directories for now -- after all, we're punting on
321	n/a	# documentation completely!
322	n/a
323	n/a	if self.no_distinfo is None:
324	n/a	self.no_distinfo = False
325	n/a
326	n/a	def finalize_unix(self):
327	n/a	"""Finalize options for posix platforms."""
328	n/a	if self.install_base is not None or self.install_platbase is not None:
329	n/a	if ((self.install_lib is None and
330	n/a	self.install_purelib is None and
331	n/a	self.install_platlib is None) or
332	n/a	self.install_headers is None or
333	n/a	self.install_scripts is None or
334	n/a	self.install_data is None):
335	n/a	raise PackagingOptionError(
336	n/a	"install-base or install-platbase supplied, but "
337	n/a	"installation scheme is incomplete")
338	n/a	return
339	n/a
340	n/a	if self.user:
341	n/a	if self.install_userbase is None:
342	n/a	raise PackagingPlatformError(
343	n/a	"user base directory is not specified")
344	n/a	self.install_base = self.install_platbase = self.install_userbase
345	n/a	self.select_scheme("posix_user")
346	n/a	elif self.home is not None:
347	n/a	self.install_base = self.install_platbase = self.home
348	n/a	self.select_scheme("posix_home")
349	n/a	else:
350	n/a	if self.prefix is None:
351	n/a	if self.exec_prefix is not None:
352	n/a	raise PackagingOptionError(
353	n/a	"must not supply exec-prefix without prefix")
354	n/a
355	n/a	self.prefix = os.path.normpath(sys.prefix)
356	n/a	self.exec_prefix = os.path.normpath(sys.exec_prefix)
357	n/a
358	n/a	else:
359	n/a	if self.exec_prefix is None:
360	n/a	self.exec_prefix = self.prefix
361	n/a
362	n/a	self.install_base = self.prefix
363	n/a	self.install_platbase = self.exec_prefix
364	n/a	self.select_scheme("posix_prefix")
365	n/a
366	n/a	def finalize_other(self):
367	n/a	"""Finalize options for non-posix platforms"""
368	n/a	if self.user:
369	n/a	if self.install_userbase is None:
370	n/a	raise PackagingPlatformError(
371	n/a	"user base directory is not specified")
372	n/a	self.install_base = self.install_platbase = self.install_userbase
373	n/a	self.select_scheme(os.name + "_user")
374	n/a	elif self.home is not None:
375	n/a	self.install_base = self.install_platbase = self.home
376	n/a	self.select_scheme("posix_home")
377	n/a	else:
378	n/a	if self.prefix is None:
379	n/a	self.prefix = os.path.normpath(sys.prefix)
380	n/a
381	n/a	self.install_base = self.install_platbase = self.prefix
382	n/a	try:
383	n/a	self.select_scheme(os.name)
384	n/a	except KeyError:
385	n/a	raise PackagingPlatformError(
386	n/a	"no support for installation on '%s'" % os.name)
387	n/a
388	n/a	def dump_dirs(self, msg):
389	n/a	"""Dump the list of user options."""
390	n/a	logger.debug(msg + ":")
391	n/a	for opt in self.user_options:
392	n/a	opt_name = opt[0]
393	n/a	if opt_name[-1] == "=":
394	n/a	opt_name = opt_name[0:-1]
395	n/a	if opt_name in self.negative_opt:
396	n/a	opt_name = self.negative_opt[opt_name]
397	n/a	opt_name = opt_name.replace('-', '_')
398	n/a	val = not getattr(self, opt_name)
399	n/a	else:
400	n/a	opt_name = opt_name.replace('-', '_')
401	n/a	val = getattr(self, opt_name)
402	n/a	logger.debug(" %s: %s", opt_name, val)
403	n/a
404	n/a	def select_scheme(self, name):
405	n/a	"""Set the install directories by applying the install schemes."""
406	n/a	# it's the caller's problem if they supply a bad name!
407	n/a	scheme = get_paths(name, expand=False)
408	n/a	for key, value in scheme.items():
409	n/a	if key == 'platinclude':
410	n/a	key = 'headers'
411	n/a	value = os.path.join(value, self.distribution.metadata['Name'])
412	n/a	attrname = 'install_' + key
413	n/a	if hasattr(self, attrname):
414	n/a	if getattr(self, attrname) is None:
415	n/a	setattr(self, attrname, value)
416	n/a
417	n/a	def _expand_attrs(self, attrs):
418	n/a	for attr in attrs:
419	n/a	val = getattr(self, attr)
420	n/a	if val is not None:
421	n/a	if os.name == 'posix' or os.name == 'nt':
422	n/a	val = os.path.expanduser(val)
423	n/a	# see if we want to push this work in sysconfig XXX
424	n/a	val = sysconfig._subst_vars(val, self.config_vars)
425	n/a	setattr(self, attr, val)
426	n/a
427	n/a	def expand_basedirs(self):
428	n/a	"""Call `os.path.expanduser` on install_{base,platbase} and root."""
429	n/a	self._expand_attrs(['install_base', 'install_platbase', 'root'])
430	n/a
431	n/a	def expand_dirs(self):
432	n/a	"""Call `os.path.expanduser` on install dirs."""
433	n/a	self._expand_attrs(['install_purelib', 'install_platlib',
434	n/a	'install_lib', 'install_headers',
435	n/a	'install_scripts', 'install_data'])
436	n/a
437	n/a	def convert_paths(self, *names):
438	n/a	"""Call `convert_path` over `names`."""
439	n/a	for name in names:
440	n/a	attr = "install_" + name
441	n/a	setattr(self, attr, convert_path(getattr(self, attr)))
442	n/a
443	n/a	def handle_extra_path(self):
444	n/a	"""Set `path_file` and `extra_dirs` using `extra_path`."""
445	n/a	if self.extra_path is None:
446	n/a	self.extra_path = self.distribution.extra_path
447	n/a
448	n/a	if self.extra_path is not None:
449	n/a	if isinstance(self.extra_path, str):
450	n/a	self.extra_path = self.extra_path.split(',')
451	n/a
452	n/a	if len(self.extra_path) == 1:
453	n/a	path_file = extra_dirs = self.extra_path[0]
454	n/a	elif len(self.extra_path) == 2:
455	n/a	path_file, extra_dirs = self.extra_path
456	n/a	else:
457	n/a	raise PackagingOptionError(
458	n/a	"'extra_path' option must be a list, tuple, or "
459	n/a	"comma-separated string with 1 or 2 elements")
460	n/a
461	n/a	# convert to local form in case Unix notation used (as it
462	n/a	# should be in setup scripts)
463	n/a	extra_dirs = convert_path(extra_dirs)
464	n/a	else:
465	n/a	path_file = None
466	n/a	extra_dirs = ''
467	n/a
468	n/a	# XXX should we warn if path_file and not extra_dirs? (in which
469	n/a	# case the path file would be harmless but pointless)
470	n/a	self.path_file = path_file
471	n/a	self.extra_dirs = extra_dirs
472	n/a
473	n/a	def change_roots(self, *names):
474	n/a	"""Change the install direcories pointed by name using root."""
475	n/a	for name in names:
476	n/a	attr = "install_" + name
477	n/a	setattr(self, attr, change_root(self.root, getattr(self, attr)))
478	n/a
479	n/a	def create_user_dirs(self):
480	n/a	"""Create directories under USERBASE as needed."""
481	n/a	home = convert_path(os.path.expanduser("~"))
482	n/a	for name, path in self.config_vars.items():
483	n/a	if path.startswith(home) and not os.path.isdir(path):
484	n/a	os.makedirs(path, 0o700)
485	n/a
486	n/a	# -- Command execution methods -------------------------------------
487	n/a
488	n/a	def run(self):
489	n/a	"""Runs the command."""
490	n/a	# Obviously have to build before we can install
491	n/a	if not self.skip_build:
492	n/a	self.run_command('build')
493	n/a	# If we built for any other platform, we can't install.
494	n/a	build_plat = self.distribution.get_command_obj('build').plat_name
495	n/a	# check warn_dir - it is a clue that the 'install_dist' is happening
496	n/a	# internally, and not to sys.path, so we don't check the platform
497	n/a	# matches what we are running.
498	n/a	if self.warn_dir and build_plat != get_platform():
499	n/a	raise PackagingPlatformError("Can't install when "
500	n/a	"cross-compiling")
501	n/a
502	n/a	# Run all sub-commands (at least those that need to be run)
503	n/a	for cmd_name in self.get_sub_commands():
504	n/a	self.run_command(cmd_name)
505	n/a
506	n/a	if self.path_file:
507	n/a	self.create_path_file()
508	n/a
509	n/a	# write list of installed files, if requested.
510	n/a	if self.record:
511	n/a	outputs = self.get_outputs()
512	n/a	if self.root: # strip any package prefix
513	n/a	root_len = len(self.root)
514	n/a	for counter in range(len(outputs)):
515	n/a	outputs[counter] = outputs[counter][root_len:]
516	n/a	self.execute(write_file,
517	n/a	(self.record, outputs),
518	n/a	"writing list of installed files to '%s'" %
519	n/a	self.record)
520	n/a
521	n/a	normpath, normcase = os.path.normpath, os.path.normcase
522	n/a	sys_path = [normcase(normpath(p)) for p in sys.path]
523	n/a	install_lib = normcase(normpath(self.install_lib))
524	n/a	if (self.warn_dir and
525	n/a	not (self.path_file and self.install_path_file) and
526	n/a	install_lib not in sys_path):
527	n/a	logger.debug(("modules installed to '%s', which is not in "
528	n/a	"Python's module search path (sys.path) -- "
529	n/a	"you'll have to change the search path yourself"),
530	n/a	self.install_lib)
531	n/a
532	n/a	def create_path_file(self):
533	n/a	"""Creates the .pth file"""
534	n/a	filename = os.path.join(self.install_libbase,
535	n/a	self.path_file + ".pth")
536	n/a	if self.install_path_file:
537	n/a	self.execute(write_file,
538	n/a	(filename, [self.extra_dirs]),
539	n/a	"creating %s" % filename)
540	n/a	else:
541	n/a	logger.warning('%s: path file %r not created',
542	n/a	self.get_command_name(), filename)
543	n/a
544	n/a	# -- Reporting methods ---------------------------------------------
545	n/a
546	n/a	def get_outputs(self):
547	n/a	"""Assembles the outputs of all the sub-commands."""
548	n/a	outputs = []
549	n/a	for cmd_name in self.get_sub_commands():
550	n/a	cmd = self.get_finalized_command(cmd_name)
551	n/a	# Add the contents of cmd.get_outputs(), ensuring
552	n/a	# that outputs doesn't contain duplicate entries
553	n/a	for filename in cmd.get_outputs():
554	n/a	if filename not in outputs:
555	n/a	outputs.append(filename)
556	n/a
557	n/a	if self.path_file and self.install_path_file:
558	n/a	outputs.append(os.path.join(self.install_libbase,
559	n/a	self.path_file + ".pth"))
560	n/a
561	n/a	return outputs
562	n/a
563	n/a	def get_inputs(self):
564	n/a	"""Returns the inputs of all the sub-commands"""
565	n/a	# XXX gee, this looks familiar ;-(
566	n/a	inputs = []
567	n/a	for cmd_name in self.get_sub_commands():
568	n/a	cmd = self.get_finalized_command(cmd_name)
569	n/a	inputs.extend(cmd.get_inputs())
570	n/a
571	n/a	return inputs
572	n/a
573	n/a	# -- Predicates for sub-command list -------------------------------
574	n/a
575	n/a	def has_lib(self):
576	n/a	"""Returns true if the current distribution has any Python
577	n/a	modules to install."""
578	n/a	return (self.distribution.has_pure_modules() or
579	n/a	self.distribution.has_ext_modules())
580	n/a
581	n/a	def has_headers(self):
582	n/a	"""Returns true if the current distribution has any headers to
583	n/a	install."""
584	n/a	return self.distribution.has_headers()
585	n/a
586	n/a	def has_scripts(self):
587	n/a	"""Returns true if the current distribution has any scripts to.
588	n/a	install."""
589	n/a	return self.distribution.has_scripts()
590	n/a
591	n/a	def has_data(self):
592	n/a	"""Returns true if the current distribution has any data to.
593	n/a	install."""
594	n/a	return self.distribution.has_data_files()
595	n/a
596	n/a	# 'sub_commands': a list of commands this command might have to run to
597	n/a	# get its work done. See cmd.py for more info.
598	n/a	sub_commands = [('install_lib', has_lib),
599	n/a	('install_headers', has_headers),
600	n/a	('install_scripts', has_scripts),
601	n/a	('install_data', has_data),
602	n/a	# keep install_distinfo last, as it needs the record
603	n/a	# with files to be completely generated
604	n/a	('install_distinfo', lambda self: not self.no_distinfo),
605	n/a	]