2
"""Bootstrap distribute installation
4
If you want to use setuptools in your package's setup.py, just include this
5
file in the same directory with it, and add this to the top of your setup.py::
7
from distribute_setup import use_setuptools
10
If you want to require a specific version of setuptools, set a download
11
mirror, or use an alternate download directory, you can do so by supplying
12
the appropriate options to ``use_setuptools()``.
14
This file can also be run as a script to install or upgrade setuptools.
22
from distutils import log
25
from site import USER_SITE
32
def _python_cmd(*args):
33
args = (sys.executable,) + args
34
return subprocess.call(args) == 0
37
# will be used for python 2.3
38
def _python_cmd(*args):
39
args = (sys.executable,) + args
40
# quoting arguments if windows
41
if sys.platform == 'win32':
46
args = [quote(arg) for arg in args]
47
return os.spawnl(os.P_WAIT, sys.executable, *args) == 0
49
DEFAULT_VERSION = "0.6.10"
50
DEFAULT_URL = "http://pypi.python.org/packages/source/d/distribute/"
51
SETUPTOOLS_FAKED_VERSION = "0.6c11"
53
SETUPTOOLS_PKG_INFO = """\
63
""" % SETUPTOOLS_FAKED_VERSION
66
def _install(tarball):
67
# extracting the tarball
68
tmpdir = tempfile.mkdtemp()
69
log.warn('Extracting in %s', tmpdir)
73
tar = tarfile.open(tarball)
77
# going in the directory
78
subdir = os.path.join(tmpdir, os.listdir(tmpdir)[0])
80
log.warn('Now working in %s', subdir)
83
log.warn('Installing Distribute')
84
if not _python_cmd('setup.py', 'install'):
85
log.warn('Something went wrong during the installation.')
86
log.warn('See the error message above.')
91
def _build_egg(egg, tarball, to_dir):
92
# extracting the tarball
93
tmpdir = tempfile.mkdtemp()
94
log.warn('Extracting in %s', tmpdir)
98
tar = tarfile.open(tarball)
102
# going in the directory
103
subdir = os.path.join(tmpdir, os.listdir(tmpdir)[0])
105
log.warn('Now working in %s', subdir)
108
log.warn('Building a Distribute egg in %s', to_dir)
109
_python_cmd('setup.py', '-q', 'bdist_egg', '--dist-dir', to_dir)
113
# returning the result
115
if not os.path.exists(egg):
116
raise IOError('Could not build the egg.')
119
def _do_download(version, download_base, to_dir, download_delay):
120
egg = os.path.join(to_dir, 'distribute-%s-py%d.%d.egg'
121
% (version, sys.version_info[0], sys.version_info[1]))
122
if not os.path.exists(egg):
123
tarball = download_setuptools(version, download_base,
124
to_dir, download_delay)
125
_build_egg(egg, tarball, to_dir)
126
sys.path.insert(0, egg)
128
setuptools.bootstrap_install_from = egg
131
def use_setuptools(version=DEFAULT_VERSION, download_base=DEFAULT_URL,
132
to_dir=os.curdir, download_delay=15, no_fake=True):
133
# making sure we use the absolute path
134
to_dir = os.path.abspath(to_dir)
135
was_imported = 'pkg_resources' in sys.modules or \
136
'setuptools' in sys.modules
140
if not hasattr(pkg_resources, '_distribute'):
145
return _do_download(version, download_base, to_dir, download_delay)
147
pkg_resources.require("distribute>="+version)
149
except pkg_resources.VersionConflict:
150
e = sys.exc_info()[1]
153
"The required version of distribute (>=%s) is not available,\n"
154
"and can't be installed while this script is running. Please\n"
155
"install a more recent version first, using\n"
156
"'easy_install -U distribute'."
157
"\n\n(Currently using %r)\n" % (version, e.args[0]))
160
del pkg_resources, sys.modules['pkg_resources'] # reload ok
161
return _do_download(version, download_base, to_dir,
163
except pkg_resources.DistributionNotFound:
164
return _do_download(version, download_base, to_dir,
168
_create_fake_setuptools_pkg_info(to_dir)
170
def download_setuptools(version=DEFAULT_VERSION, download_base=DEFAULT_URL,
171
to_dir=os.curdir, delay=15):
172
"""Download distribute from a specified location and return its filename
174
`version` should be a valid distribute version number that is available
175
as an egg for download under the `download_base` URL (which should end
176
with a '/'). `to_dir` is the directory where the egg will be downloaded.
177
`delay` is the number of seconds to pause before an actual download
180
# making sure we use the absolute path
181
to_dir = os.path.abspath(to_dir)
183
from urllib.request import urlopen
185
from urllib2 import urlopen
186
tgz_name = "distribute-%s.tar.gz" % version
187
url = download_base + tgz_name
188
saveto = os.path.join(to_dir, tgz_name)
190
if not os.path.exists(saveto): # Avoid repeated downloads
192
log.warn("Downloading %s", url)
194
# Read/write all in one block, so we don't create a corrupt file
195
# if the download is interrupted.
197
dst = open(saveto, "wb")
204
return os.path.realpath(saveto)
207
def _patch_file(path, content):
208
"""Will backup the file then patch it"""
209
existing_content = open(path).read()
210
if existing_content == content:
212
log.warn('Already patched.')
214
log.warn('Patching...')
224
def _same_content(path, content):
225
return open(path).read() == content
227
def _no_sandbox(function):
228
def __no_sandbox(*args, **kw):
230
from setuptools.sandbox import DirectorySandbox
231
def violation(*args):
233
DirectorySandbox._old = DirectorySandbox._violation
234
DirectorySandbox._violation = violation
240
return function(*args, **kw)
243
DirectorySandbox._violation = DirectorySandbox._old
244
del DirectorySandbox._old
249
def _rename_path(path):
250
new_name = path + '.OLD.%s' % time.time()
251
log.warn('Renaming %s into %s', path, new_name)
252
os.rename(path, new_name)
255
def _remove_flat_installation(placeholder):
256
if not os.path.isdir(placeholder):
257
log.warn('Unkown installation at %s', placeholder)
260
for file in os.listdir(placeholder):
261
if fnmatch.fnmatch(file, 'setuptools*.egg-info'):
265
log.warn('Could not locate setuptools*.egg-info')
268
log.warn('Removing elements out of the way...')
269
pkg_info = os.path.join(placeholder, file)
270
if os.path.isdir(pkg_info):
271
patched = _patch_egg_dir(pkg_info)
273
patched = _patch_file(pkg_info, SETUPTOOLS_PKG_INFO)
276
log.warn('%s already patched.', pkg_info)
278
# now let's move the files out of the way
279
for element in ('setuptools', 'pkg_resources.py', 'site.py'):
280
element = os.path.join(placeholder, element)
281
if os.path.exists(element):
282
_rename_path(element)
284
log.warn('Could not find the %s element of the '
285
'Setuptools distribution', element)
289
def _after_install(dist):
290
log.warn('After install bootstrap.')
291
placeholder = dist.get_command_obj('install').install_purelib
292
_create_fake_setuptools_pkg_info(placeholder)
295
def _create_fake_setuptools_pkg_info(placeholder):
296
if not placeholder or not os.path.exists(placeholder):
297
log.warn('Could not find the install location')
299
pyver = '%s.%s' % (sys.version_info[0], sys.version_info[1])
300
setuptools_file = 'setuptools-%s-py%s.egg-info' % \
301
(SETUPTOOLS_FAKED_VERSION, pyver)
302
pkg_info = os.path.join(placeholder, setuptools_file)
303
if os.path.exists(pkg_info):
304
log.warn('%s already exists', pkg_info)
307
log.warn('Creating %s', pkg_info)
308
f = open(pkg_info, 'w')
310
f.write(SETUPTOOLS_PKG_INFO)
314
pth_file = os.path.join(placeholder, 'setuptools.pth')
315
log.warn('Creating %s', pth_file)
316
f = open(pth_file, 'w')
318
f.write(os.path.join(os.curdir, setuptools_file))
322
def _patch_egg_dir(path):
323
# let's check if it's already patched
324
pkg_info = os.path.join(path, 'EGG-INFO', 'PKG-INFO')
325
if os.path.exists(pkg_info):
326
if _same_content(pkg_info, SETUPTOOLS_PKG_INFO):
327
log.warn('%s already patched.', pkg_info)
331
os.mkdir(os.path.join(path, 'EGG-INFO'))
332
pkg_info = os.path.join(path, 'EGG-INFO', 'PKG-INFO')
333
f = open(pkg_info, 'w')
335
f.write(SETUPTOOLS_PKG_INFO)
341
def _before_install():
342
log.warn('Before install bootstrap.')
346
def _under_prefix(location):
347
if 'install' not in sys.argv:
349
args = sys.argv[sys.argv.index('install')+1:]
350
for index, arg in enumerate(args):
351
for option in ('--root', '--prefix'):
352
if arg.startswith('%s=' % option):
353
top_dir = arg.split('root=')[-1]
354
return location.startswith(top_dir)
356
if len(args) > index:
357
top_dir = args[index+1]
358
return location.startswith(top_dir)
359
elif option == '--user' and USER_SITE is not None:
360
return location.startswith(USER_SITE)
364
def _fake_setuptools():
365
log.warn('Scanning installed packages')
370
log.warn('Setuptools or Distribute does not seem to be installed.')
372
ws = pkg_resources.working_set
374
setuptools_dist = ws.find(pkg_resources.Requirement.parse('setuptools',
378
setuptools_dist = ws.find(pkg_resources.Requirement.parse('setuptools'))
380
if setuptools_dist is None:
381
log.warn('No setuptools distribution found')
383
# detecting if it was already faked
384
setuptools_location = setuptools_dist.location
385
log.warn('Setuptools installation detected at %s', setuptools_location)
387
# if --root or --preix was provided, and if
388
# setuptools is not located in them, we don't patch it
389
if not _under_prefix(setuptools_location):
390
log.warn('Not patching, --root or --prefix is installing Distribute'
391
' in another location')
394
# let's see if its an egg
395
if not setuptools_location.endswith('.egg'):
396
log.warn('Non-egg installation')
397
res = _remove_flat_installation(setuptools_location)
401
log.warn('Egg installation')
402
pkg_info = os.path.join(setuptools_location, 'EGG-INFO', 'PKG-INFO')
403
if (os.path.exists(pkg_info) and
404
_same_content(pkg_info, SETUPTOOLS_PKG_INFO)):
405
log.warn('Already patched.')
407
log.warn('Patching...')
408
# let's create a fake egg replacing setuptools one
409
res = _patch_egg_dir(setuptools_location)
412
log.warn('Patched done.')
417
log.warn('Relaunching...')
418
# we have to relaunch the process
419
args = [sys.executable] + sys.argv
420
sys.exit(subprocess.call(args))
423
def _extractall(self, path=".", members=None):
424
"""Extract all members from the archive to the current working
425
directory and set owner, modification time and permissions on
426
directories afterwards. `path' specifies a different directory
427
to extract to. `members' is optional and must be a subset of the
428
list returned by getmembers().
432
from tarfile import ExtractError
438
for tarinfo in members:
440
# Extract directories with a safe mode.
441
directories.append(tarinfo)
442
tarinfo = copy.copy(tarinfo)
443
tarinfo.mode = 448 # decimal for oct 0700
444
self.extract(tarinfo, path)
446
# Reverse sort directories.
447
if sys.version_info < (2, 4):
448
def sorter(dir1, dir2):
449
return cmp(dir1.name, dir2.name)
450
directories.sort(sorter)
451
directories.reverse()
453
directories.sort(key=operator.attrgetter('name'), reverse=True)
455
# Set correct owner, mtime and filemode on directories.
456
for tarinfo in directories:
457
dirpath = os.path.join(path, tarinfo.name)
459
self.chown(tarinfo, dirpath)
460
self.utime(tarinfo, dirpath)
461
self.chmod(tarinfo, dirpath)
463
e = sys.exc_info()[1]
464
if self.errorlevel > 1:
467
self._dbg(1, "tarfile: %s" % e)
470
def main(argv, version=DEFAULT_VERSION):
471
"""Install or upgrade setuptools and EasyInstall"""
472
tarball = download_setuptools()
476
if __name__ == '__main__':