zfec/ez_setup.py

   1 #!python
   2 """Bootstrap setuptools installation
   3
   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::
   6
   7     from ez_setup import use_setuptools
   8     use_setuptools()
   9
  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()``.
  13
  14 This file can also be run as a script to install or upgrade setuptools.
  15 """
  16 import sys
  17
  18 DEFAULT_VERSION = "0.6c3"
  19 DEFAULT_URL     = "http://cheeseshop.python.org/packages/%s/s/setuptools/" % sys.version[:3]
  20
  21 md5_data = {
  22     'setuptools-0.6b1-py2.3.egg': '8822caf901250d848b996b7f25c6e6ca',
  23     'setuptools-0.6b1-py2.4.egg': 'b79a8a403e4502fbb85ee3f1941735cb',
  24     'setuptools-0.6b2-py2.3.egg': '5657759d8a6d8fc44070a9d07272d99b',
  25     'setuptools-0.6b2-py2.4.egg': '4996a8d169d2be661fa32a6e52e4f82a',
  26     'setuptools-0.6b3-py2.3.egg': 'bb31c0fc7399a63579975cad9f5a0618',
  27     'setuptools-0.6b3-py2.4.egg': '38a8c6b3d6ecd22247f179f7da669fac',
  28     'setuptools-0.6b4-py2.3.egg': '62045a24ed4e1ebc77fe039aa4e6f7e5',
  29     'setuptools-0.6b4-py2.4.egg': '4cb2a185d228dacffb2d17f103b3b1c4',
  30     'setuptools-0.6c1-py2.3.egg': 'b3f2b5539d65cb7f74ad79127f1a908c',
  31     'setuptools-0.6c1-py2.4.egg': 'b45adeda0667d2d2ffe14009364f2a4b',
  32     'setuptools-0.6c2-py2.3.egg': 'f0064bf6aa2b7d0f3ba0b43f20817c27',
  33     'setuptools-0.6c2-py2.4.egg': '616192eec35f47e8ea16cd6a122b7277',
  34     'setuptools-0.6c3-py2.3.egg': 'f181fa125dfe85a259c9cd6f1d7b78fa',
  35     'setuptools-0.6c3-py2.4.egg': 'e0ed74682c998bfb73bf803a50e7b71e',
  36     'setuptools-0.6c3-py2.5.egg': 'abef16fdd61955514841c7c6bd98965e',
  37     'setuptools-0.6c4-py2.3.egg': 'b0b9131acab32022bfac7f44c5d7971f',
  38     'setuptools-0.6c4-py2.4.egg': '2a1f9656d4fbf3c97bf946c0a124e6e2',
  39     'setuptools-0.6c4-py2.5.egg': '8f5a052e32cdb9c72bcf4b5526f28afc',
  40     'setuptools-0.6c5-py2.3.egg': 'ee9fd80965da04f2f3e6b3576e9d8167',
  41     'setuptools-0.6c5-py2.4.egg': 'afe2adf1c01701ee841761f5bcd8aa64',
  42     'setuptools-0.6c5-py2.5.egg': 'a8d3f61494ccaa8714dfed37bccd3d5d',
  43 }
  44
  45 import sys, os
  46
  47 def _validate_md5(egg_name, data):
  48     if egg_name in md5_data:
  49         from md5 import md5
  50         digest = md5(data).hexdigest()
  51         if digest != md5_data[egg_name]:
  52             print >>sys.stderr, (
  53                 "md5 validation of %s failed!  (Possible download problem?)"
  54                 % egg_name
  55             )
  56             sys.exit(2)
  57     return data
  58
  59
  60 def use_setuptools(
  61     version=DEFAULT_VERSION, download_base=DEFAULT_URL, to_dir=os.curdir,
  62     download_delay=15
  63 ):
  64     """Automatically find/download setuptools and make it available on sys.path
  65
  66     `version` should be a valid setuptools version number that is available
  67     as an egg for download under the `download_base` URL (which should end with
  68     a '/').  `to_dir` is the directory where setuptools will be downloaded, if
  69     it is not already available.  If `download_delay` is specified, it should
  70     be the number of seconds that will be paused before initiating a download,
  71     should one be required.  If an older version of setuptools is installed,
  72     this routine will print a message to ``sys.stderr`` and raise SystemExit in
  73     an attempt to abort the calling script.
  74     """
  75     try:
  76         import setuptools
  77         if setuptools.__version__ == '0.0.1':
  78             print >>sys.stderr, (
  79             "You have an obsolete version of setuptools installed.  Please\n"
  80             "remove it from your system entirely before rerunning this script."
  81             )
  82             sys.exit(2)
  83     except ImportError:
  84         egg = download_setuptools(version, download_base, to_dir, download_delay)
  85         sys.path.insert(0, egg)
  86         import setuptools; setuptools.bootstrap_install_from = egg
  87
  88     import pkg_resources
  89     try:
  90         pkg_resources.require("setuptools>="+version)
  91
  92     except pkg_resources.VersionConflict, e:
  93         # XXX could we install in a subprocess here?
  94         print >>sys.stderr, (
  95             "The required version of setuptools (>=%s) is not available, and\n"
  96             "can't be installed while this script is running. Please install\n"
  97             " a more recent version first.\n\n(Currently using %r)"
  98         ) % (version, e.args[0])
  99         sys.exit(2)
 100
 101 def download_setuptools(
 102     version=DEFAULT_VERSION, download_base=DEFAULT_URL, to_dir=os.curdir
 103 ):
 104     """Download setuptools from a specified location and return its filename
 105
 106     `version` should be a valid setuptools version number that is available
 107     as an egg for download under the `download_base` URL (which should end
 108     with a '/'). `to_dir` is the directory where the egg will be downloaded.
 109     `delay` is the number of seconds to pause before an actual download attempt.
 110     """
 111     import urllib2, shutil
 112     egg_name = "setuptools-%s-py%s.egg" % (version,sys.version[:3])
 113     url = download_base + egg_name
 114     saveto = os.path.join(to_dir, egg_name)
 115     src = dst = None
 116     if not os.path.exists(saveto):  # Avoid repeated downloads
 117         try:
 118             from distutils import log
 119             if True:
 120                 log.warn("""
 121 ---------------------------------------------------------------------------
 122 This script requires setuptools version %s to run (even to display
 123 help).  I will attempt to download it for you (from
 124 %s), but
 125 you may need to enable firewall access for this script first.
 126
 127 (Note: if this machine does not have network access, please obtain the file
 128
 129    %s
 130
 131 and place it in this directory before rerunning this script.)
 132 ---------------------------------------------------------------------------""",
 133                     version, download_base, url
 134                 );
 135             log.warn("Downloading %s", url)
 136             src = urllib2.urlopen(url)
 137             # Read/write all in one block, so we don't create a corrupt file
 138             # if the download is interrupted.
 139             data = _validate_md5(egg_name, src.read())
 140             dst = open(saveto,"wb"); dst.write(data)
 141         finally:
 142             if src: src.close()
 143             if dst: dst.close()
 144     return os.path.realpath(saveto)
 145
 146 def main(argv, version=DEFAULT_VERSION):
 147     """Install or upgrade setuptools and EasyInstall"""
 148
 149     try:
 150         import setuptools
 151     except ImportError:
 152         egg = None
 153         try:
 154             egg = download_setuptools(version, delay=0)
 155             sys.path.insert(0,egg)
 156             from setuptools.command.easy_install import main
 157             return main(list(argv)+[egg])   # we're done here
 158         finally:
 159             if egg and os.path.exists(egg):
 160                 os.unlink(egg)
 161     else:
 162         if setuptools.__version__ == '0.0.1':
 163             # tell the user to uninstall obsolete version
 164             use_setuptools(version)
 165
 166     req = "setuptools>="+version
 167     import pkg_resources
 168     try:
 169         pkg_resources.require(req)
 170     except pkg_resources.VersionConflict:
 171         try:
 172             from setuptools.command.easy_install import main
 173         except ImportError:
 174             from easy_install import main
 175         main(list(argv)+[download_setuptools(delay=0)])
 176         sys.exit(0) # try to force an exit
 177     else:
 178         if argv:
 179             from setuptools.command.easy_install import main
 180             main(argv)
 181         else:
 182             print "Setuptools version",version,"or greater has been installed."
 183             print '(Run "ez_setup.py -U setuptools" to reinstall or upgrade.)'
 184
 185
 186
 187 def update_md5(filenames):
 188     """Update our built-in md5 registry"""
 189
 190     import re
 191     from md5 import md5
 192
 193     for name in filenames:
 194         base = os.path.basename(name)
 195         f = open(name,'rb')
 196         md5_data[base] = md5(f.read()).hexdigest()
 197         f.close()
 198
 199     data = ["    %r: %r,\n" % it for it in md5_data.items()]
 200     data.sort()
 201     repl = "".join(data)
 202
 203     import inspect
 204     srcfile = inspect.getsourcefile(sys.modules[__name__])
 205     f = open(srcfile, 'rb'); src = f.read(); f.close()
 206
 207     match = re.search("\nmd5_data = {\n([^}]+)}", src)
 208     if not match:
 209         print >>sys.stderr, "Internal error!"
 210         sys.exit(2)
 211
 212     src = src[:match.start(1)] + repl + src[match.end(1):]
 213     f = open(srcfile,'w')
 214     f.write(src)
 215     f.close()
 216
 217
 218 if __name__=='__main__':
 219     if len(sys.argv)>2 and sys.argv[1]=='--md5update':
 220         update_md5(sys.argv[2:])
 221     else:
 222         main(sys.argv[1:])
 223
 224
 225
 226
 227