1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
|
"""distutils.command.install
Implements the Distutils 'install' command."""
# created 1999/03/13, Greg Ward
__rcsid__ = "$Id$"
import sys, os, string
from distutils import sysconfig
from distutils.core import Command
class Install (Command):
options = [('prefix=', None, "installation prefix"),
('execprefix=', None,
"prefix for platform-specific files"),
# Build directories: where to install from
('build-base=', None,
"base build directory"),
('build-lib=', None,
"build directory for non-platform-specific library files"),
('build-platlib=', None,
"build directory for platform-specific library files"),
# Installation directories: where to put modules and packages
('install-lib=', None,
"base Python library directory"),
('install-platlib=', None,
"platform-specific Python library directory"),
('install-site-lib=', None,
"directory for site-specific packages and modules"),
('install-site-platlib=', None,
"platform-specific site directory"),
('install-scheme=', None,
"install to 'system' or 'site' library directory?"),
# 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"),
# Flags for 'build_py'
('compile-py', None, "compile .py to .pyc"),
('optimize-py', None, "compile .py to .pyo (optimized)"),
]
def set_default_options (self):
self.build_base = None
self.build_lib = None
self.build_platlib = None
# Don't define 'prefix' or 'exec_prefix' so we can know when the
# command is run whether the user supplied values
self.prefix = None
self.exec_prefix = None
# These two, we can supply real values for! (because they're
# not directories, and don't have a confusing multitude of
# possible derivations)
#self.install_scheme = 'site'
self.doc_format = None
# The actual installation directories are determined only at
# run-time, so the user can supply just prefix (and exec_prefix?)
# as a base for everything else
self.install_lib = None
self.install_platlib = None
self.install_site_lib = None
self.install_site_platlib = None
self.install_man = None
self.install_html = None
self.install_info = None
self.compile_py = 1
self.optimize_py = 1
def set_final_options (self):
# XXX this method is where the default installation directories
# for modules and extension modules are determined. (Someday,
# the default installation directories for scripts,
# documentation, and whatever else the Distutils can build and
# install will also be determined here.) Thus, this is a pretty
# important place to fiddle with for anyone interested in
# installation schemes for the Python library. Issues that
# are not yet resolved to my satisfaction:
# * how much platform dependence should be here, and
# how much can be pushed off to sysconfig (or, better, the
# Makefiles parsed by sysconfig)?
# * how independent of Python version should this be -- ie.
# should we have special cases to handle Python 1.5 and
# older, and then do it "the right way" for 1.6? Or should
# we install a site.py along with Distutils under pre-1.6
# Python to take care of the current deficiencies in
# Python's library installation scheme?
#
# Currently, this method has hacks to distinguish POSIX from
# non-POSIX systems (for installation of site-local modules),
# and assumes the Python 1.5 installation tree with no site.py
# to fix things.
# Figure out the build directories, ie. where to install from
self.set_peer_option ('build', 'basedir', self.build_base)
self.set_undefined_options ('build',
('basedir', 'build_base'),
('libdir', 'build_lib'),
('platdir', 'build_platlib'))
# Figure out actual installation directories; the basic principle
# is: if the user supplied nothing, then use the directories that
# Python was built and installed with (ie. the compiled-in prefix
# and exec_prefix, and the actual installation directories gleaned
# by sysconfig). If the user supplied a prefix (and possibly
# exec_prefix), then we generate our own installation directories,
# following any pattern gleaned from sysconfig's findings. If no
# such pattern can be gleaned, then we'll just make do and try to
# ape the behaviour of Python's configure script.
if self.prefix is None: # user didn't override
self.prefix = sys.prefix
if self.exec_prefix is None:
self.exec_prefix = sys.exec_prefix
if self.install_lib is None:
self.install_lib = \
self.replace_sys_prefix ('LIBDEST', ('lib','python1.5'))
if self.install_platlib is None:
# XXX this should probably be DESTSHARED -- but why is there no
# equivalent to DESTSHARED for the "site-packages" dir"?
self.install_platlib = \
self.replace_sys_prefix ('BINLIBDEST', ('lib','python1.5'), 1)
# Here is where we decide where to install most library files: on
# POSIX systems, they go to 'site-packages' under the install_lib
# (determined above -- typically /usr/local/lib/python1.x). Note
# that on POSIX systems, platform-specific files belong in
# 'site-packages' under install_platlib. (The actual rule is that
# a module distribution that includes *any* platform-specific files
# -- ie. extension modules -- goes under install_platlib. This
# solves the "can't find extension module in a package" problem.)
# On non-POSIX systems, install_lib and install_platlib are the
# same (eg. "C:\Program Files\Python\Lib" on Windows), as are
# install_site_lib and install_site_platlib (eg.
# "C:\Program Files\Python" on Windows) -- everything will be dumped
# right into one of the install_site directories. (It doesn't
# really matter *which* one, of course, but I'll observe decorum
# and do it properly.)
if self.install_site_lib is None:
if os.name == 'posix':
self.install_site_lib = \
os.path.join (self.install_lib, 'site-packages')
else:
self.install_site_lib = self.prefix
if self.install_site_platlib is None:
if os.name == 'posix':
self.install_site_platlib = \
os.path.join (self.install_platlib, 'site-packages')
else:
self.install_site_platlib = self.exec_prefix
#if self.install_scheme == 'site':
# install_lib = self.install_site_lib
# install_platlib = self.install_site_platlib
#elif self.install_scheme == 'system':
# install_lib = self.install_lib
# install_platlib = self.install_platlib
#else:
# # XXX new exception for this kind of misbehaviour?
# raise DistutilsArgError, \
# "invalid install scheme '%s'" % self.install_scheme
# Punt on doc directories for now -- after all, we're punting on
# documentation completely!
# set_final_options ()
def replace_sys_prefix (self, config_attr, fallback_postfix, use_exec=0):
"""Attempts to glean a simple pattern from an installation
directory available as a 'sysconfig' attribute: if the
directory name starts with the "system prefix" (the one
hard-coded in the Makefile and compiled into Python),
then replace it with the current installation prefix and
return the "relocated" installation directory."""
if use_exec:
sys_prefix = sys.exec_prefix
my_prefix = self.exec_prefix
else:
sys_prefix = sys.prefix
my_prefix = self.prefix
val = getattr (sysconfig, config_attr)
if string.find (val, sys_prefix) == 0:
# If the sysconfig directory starts with the system prefix,
# then we can "relocate" it to the user-supplied prefix --
# assuming, of course, it is different from the system prefix.
if sys_prefix == my_prefix:
return val
else:
return my_prefix + val[len(sys_prefix):]
else:
# Otherwise, just tack the "fallback postfix" onto the
# user-specified prefix.
return apply (os.path.join, (my_prefix,) + fallback_postfix)
# replace_sys_prefix ()
def run (self):
self.set_final_options ()
# Obviously have to build before we can install
self.run_peer ('build')
# Install modules in two steps: "platform-shared" files (ie. pure
# python modules) and platform-specific files (compiled C
# extensions). Note that 'install_py' is smart enough to install
# pure Python modules in the "platlib" directory if we built any
# extensions.
self.run_peer ('install_py')
self.run_peer ('install_ext')
# run ()
# class Install
|
