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)
36 # will be used for python 2.3
37 def _python_cmd(*args):
38 args = (sys.executable,) + args
39 # quoting arguments if windows
40 if sys.platform == 'win32':
45 args = [quote(arg) for arg in args]
46 return os.spawnl(os.P_WAIT, sys.executable, *args) == 0
48 DEFAULT_VERSION = "0.6.10"
49 DEFAULT_URL = "http://pypi.python.org/packages/source/d/distribute/"
50 SETUPTOOLS_FAKED_VERSION = "0.6c11"
52 SETUPTOOLS_PKG_INFO = """\
62 """ % SETUPTOOLS_FAKED_VERSION
65 def _install(tarball):
66 # extracting the tarball
67 tmpdir = tempfile.mkdtemp()
68 log.warn('Extracting in %s', tmpdir)
72 tar = tarfile.open(tarball)
76 # going in the directory
77 subdir = os.path.join(tmpdir, os.listdir(tmpdir)[0])
79 log.warn('Now working in %s', subdir)
82 log.warn('Installing Distribute')
83 if not _python_cmd('setup.py', 'install'):
84 log.warn('Something went wrong during the installation.')
85 log.warn('See the error message above.')
90 def _build_egg(egg, tarball, to_dir):
91 # extracting the tarball
92 tmpdir = tempfile.mkdtemp()
93 log.warn('Extracting in %s', tmpdir)
97 tar = tarfile.open(tarball)
101 # going in the directory
102 subdir = os.path.join(tmpdir, os.listdir(tmpdir)[0])
104 log.warn('Now working in %s', subdir)
107 log.warn('Building a Distribute egg in %s', to_dir)
108 _python_cmd('setup.py', '-q', 'bdist_egg', '--dist-dir', to_dir)
112 # returning the result
114 if not os.path.exists(egg):
115 raise IOError('Could not build the egg.')
118 def _do_download(version, download_base, to_dir, download_delay):
119 egg = os.path.join(to_dir, 'distribute-%s-py%d.%d.egg'
120 % (version, sys.version_info[0], sys.version_info[1]))
121 if not os.path.exists(egg):
122 tarball = download_setuptools(version, download_base,
123 to_dir, download_delay)
124 _build_egg(egg, tarball, to_dir)
125 sys.path.insert(0, egg)
127 setuptools.bootstrap_install_from = egg
130 def use_setuptools(version=DEFAULT_VERSION, download_base=DEFAULT_URL,
131 to_dir=os.curdir, download_delay=15, no_fake=True):
132 # making sure we use the absolute path
133 to_dir = os.path.abspath(to_dir)
134 was_imported = 'pkg_resources' in sys.modules or \
135 'setuptools' in sys.modules
139 if not hasattr(pkg_resources, '_distribute'):
144 return _do_download(version, download_base, to_dir, download_delay)
146 pkg_resources.require("distribute>="+version)
148 except pkg_resources.VersionConflict:
149 e = sys.exc_info()[1]
152 "The required version of distribute (>=%s) is not available,\n"
153 "and can't be installed while this script is running. Please\n"
154 "install a more recent version first, using\n"
155 "'easy_install -U distribute'."
156 "\n\n(Currently using %r)\n" % (version, e.args[0]))
159 del pkg_resources, sys.modules['pkg_resources'] # reload ok
160 return _do_download(version, download_base, to_dir,
162 except pkg_resources.DistributionNotFound:
163 return _do_download(version, download_base, to_dir,
167 _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 _no_sandbox(function):
208 def __no_sandbox(*args, **kw):
210 from setuptools.sandbox import DirectorySandbox
211 if not hasattr(DirectorySandbox, '_old'):
212 def violation(*args):
214 DirectorySandbox._old = DirectorySandbox._violation
215 DirectorySandbox._violation = violation
223 return function(*args, **kw)
226 DirectorySandbox._violation = DirectorySandbox._old
227 del DirectorySandbox._old
232 def _patch_file(path, content):
233 """Will backup the file then patch it"""
234 existing_content = open(path).read()
235 if existing_content == content:
237 log.warn('Already patched.')
239 log.warn('Patching...')
248 _patch_file = _no_sandbox(_patch_file)
251 def _same_content(path, content):
252 return open(path).read() == content
255 def _rename_path(path):
256 new_name = path + '.OLD.%s' % time.time()
257 log.warn('Renaming %s into %s', path, new_name)
258 os.rename(path, new_name)
262 def _remove_flat_installation(placeholder):
263 if not os.path.isdir(placeholder):
264 log.warn('Unkown installation at %s', placeholder)
267 for file in os.listdir(placeholder):
268 if fnmatch.fnmatch(file, 'setuptools*.egg-info'):
272 log.warn('Could not locate setuptools*.egg-info')
275 log.warn('Removing elements out of the way...')
276 pkg_info = os.path.join(placeholder, file)
277 if os.path.isdir(pkg_info):
278 patched = _patch_egg_dir(pkg_info)
280 patched = _patch_file(pkg_info, SETUPTOOLS_PKG_INFO)
283 log.warn('%s already patched.', pkg_info)
285 # now let's move the files out of the way
286 for element in ('setuptools', 'pkg_resources.py', 'site.py'):
287 element = os.path.join(placeholder, element)
288 if os.path.exists(element):
289 _rename_path(element)
291 log.warn('Could not find the %s element of the '
292 'Setuptools distribution', element)
295 _remove_flat_installation = _no_sandbox(_remove_flat_installation)
298 def _after_install(dist):
299 log.warn('After install bootstrap.')
300 placeholder = dist.get_command_obj('install').install_purelib
301 _create_fake_setuptools_pkg_info(placeholder)
304 def _create_fake_setuptools_pkg_info(placeholder):
305 if not placeholder or not os.path.exists(placeholder):
306 log.warn('Could not find the install location')
308 pyver = '%s.%s' % (sys.version_info[0], sys.version_info[1])
309 setuptools_file = 'setuptools-%s-py%s.egg-info' % \
310 (SETUPTOOLS_FAKED_VERSION, pyver)
311 pkg_info = os.path.join(placeholder, setuptools_file)
312 if os.path.exists(pkg_info):
313 log.warn('%s already exists', pkg_info)
316 log.warn('Creating %s', pkg_info)
317 f = open(pkg_info, 'w')
319 f.write(SETUPTOOLS_PKG_INFO)
323 pth_file = os.path.join(placeholder, 'setuptools.pth')
324 log.warn('Creating %s', pth_file)
325 f = open(pth_file, 'w')
327 f.write(os.path.join(os.curdir, setuptools_file))
331 _create_fake_setuptools_pkg_info = _no_sandbox(_create_fake_setuptools_pkg_info)
334 def _patch_egg_dir(path):
335 # let's check if it's already patched
336 pkg_info = os.path.join(path, 'EGG-INFO', 'PKG-INFO')
337 if os.path.exists(pkg_info):
338 if _same_content(pkg_info, SETUPTOOLS_PKG_INFO):
339 log.warn('%s already patched.', pkg_info)
343 os.mkdir(os.path.join(path, 'EGG-INFO'))
344 pkg_info = os.path.join(path, 'EGG-INFO', 'PKG-INFO')
345 f = open(pkg_info, 'w')
347 f.write(SETUPTOOLS_PKG_INFO)
352 _patch_egg_dir = _no_sandbox(_patch_egg_dir)
354 def _before_install():
355 log.warn('Before install bootstrap.')
359 def _under_prefix(location):
360 if 'install' not in sys.argv:
362 args = sys.argv[sys.argv.index('install')+1:]
363 for index, arg in enumerate(args):
364 for option in ('--root', '--prefix'):
365 if arg.startswith('%s=' % option):
366 top_dir = arg.split('root=')[-1]
367 return location.startswith(top_dir)
369 if len(args) > index:
370 top_dir = args[index+1]
371 return location.startswith(top_dir)
372 if arg == '--user' and USER_SITE is not None:
373 return location.startswith(USER_SITE)
377 def _fake_setuptools():
378 log.warn('Scanning installed packages')
383 log.warn('Setuptools or Distribute does not seem to be installed.')
385 ws = pkg_resources.working_set
387 setuptools_dist = ws.find(pkg_resources.Requirement.parse('setuptools',
391 setuptools_dist = ws.find(pkg_resources.Requirement.parse('setuptools'))
393 if setuptools_dist is None:
394 log.warn('No setuptools distribution found')
396 # detecting if it was already faked
397 setuptools_location = setuptools_dist.location
398 log.warn('Setuptools installation detected at %s', setuptools_location)
400 # if --root or --preix was provided, and if
401 # setuptools is not located in them, we don't patch it
402 if not _under_prefix(setuptools_location):
403 log.warn('Not patching, --root or --prefix is installing Distribute'
404 ' in another location')
407 # let's see if its an egg
408 if not setuptools_location.endswith('.egg'):
409 log.warn('Non-egg installation')
410 res = _remove_flat_installation(setuptools_location)
414 log.warn('Egg installation')
415 pkg_info = os.path.join(setuptools_location, 'EGG-INFO', 'PKG-INFO')
416 if (os.path.exists(pkg_info) and
417 _same_content(pkg_info, SETUPTOOLS_PKG_INFO)):
418 log.warn('Already patched.')
420 log.warn('Patching...')
421 # let's create a fake egg replacing setuptools one
422 res = _patch_egg_dir(setuptools_location)
425 log.warn('Patched done.')
430 log.warn('Relaunching...')
431 # we have to relaunch the process
432 # pip marker to avoid a relaunch bug
433 if sys.argv[:3] == ['-c', 'install', '--single-version-externally-managed']:
434 sys.argv[0] = 'setup.py'
435 args = [sys.executable] + sys.argv
436 sys.exit(subprocess.call(args))
439 def _extractall(self, path=".", members=None):
440 """Extract all members from the archive to the current working
441 directory and set owner, modification time and permissions on
442 directories afterwards. `path' specifies a different directory
443 to extract to. `members' is optional and must be a subset of the
444 list returned by getmembers().
448 from tarfile import ExtractError
454 for tarinfo in members:
456 # Extract directories with a safe mode.
457 directories.append(tarinfo)
458 tarinfo = copy.copy(tarinfo)
459 tarinfo.mode = 448 # decimal for oct 0700
460 self.extract(tarinfo, path)
462 # Reverse sort directories.
463 if sys.version_info < (2, 4):
464 def sorter(dir1, dir2):
465 return cmp(dir1.name, dir2.name)
466 directories.sort(sorter)
467 directories.reverse()
469 directories.sort(key=operator.attrgetter('name'), reverse=True)
471 # Set correct owner, mtime and filemode on directories.
472 for tarinfo in directories:
473 dirpath = os.path.join(path, tarinfo.name)
475 self.chown(tarinfo, dirpath)
476 self.utime(tarinfo, dirpath)
477 self.chmod(tarinfo, dirpath)
479 e = sys.exc_info()[1]
480 if self.errorlevel > 1:
483 self._dbg(1, "tarfile: %s" % e)
486 def main(argv, version=DEFAULT_VERSION):
487 """Install or upgrade setuptools and EasyInstall"""
488 tarball = download_setuptools()
492 if __name__ == '__main__':