| 1 | #!/usr/bin/env python
|
|---|
| 2 |
|
|---|
| 3 | """ This module tries to retrieve as much platform-identifying data as
|
|---|
| 4 | possible. It makes this information available via function APIs.
|
|---|
| 5 |
|
|---|
| 6 | If called from the command line, it prints the platform
|
|---|
| 7 | information concatenated as single string to stdout. The output
|
|---|
| 8 | format is useable as part of a filename.
|
|---|
| 9 |
|
|---|
| 10 | """
|
|---|
| 11 | # This module is maintained by Marc-Andre Lemburg <mal@egenix.com>.
|
|---|
| 12 | # If you find problems, please submit bug reports/patches via the
|
|---|
| 13 | # Python bug tracker (http://bugs.python.org) and assign them to "lemburg".
|
|---|
| 14 | #
|
|---|
| 15 | # Note: Please keep this module compatible to Python 1.5.2.
|
|---|
| 16 | #
|
|---|
| 17 | # Still needed:
|
|---|
| 18 | # * more support for WinCE
|
|---|
| 19 | # * support for MS-DOS (PythonDX ?)
|
|---|
| 20 | # * support for Amiga and other still unsupported platforms running Python
|
|---|
| 21 | # * support for additional Linux distributions
|
|---|
| 22 | #
|
|---|
| 23 | # Many thanks to all those who helped adding platform-specific
|
|---|
| 24 | # checks (in no particular order):
|
|---|
| 25 | #
|
|---|
| 26 | # Charles G Waldman, David Arnold, Gordon McMillan, Ben Darnell,
|
|---|
| 27 | # Jeff Bauer, Cliff Crawford, Ivan Van Laningham, Josef
|
|---|
| 28 | # Betancourt, Randall Hopper, Karl Putland, John Farrell, Greg
|
|---|
| 29 | # Andruk, Just van Rossum, Thomas Heller, Mark R. Levinson, Mark
|
|---|
| 30 | # Hammond, Bill Tutt, Hans Nowak, Uwe Zessin (OpenVMS support),
|
|---|
| 31 | # Colin Kong, Trent Mick, Guido van Rossum, Anthony Baxter
|
|---|
| 32 | #
|
|---|
| 33 | # History:
|
|---|
| 34 | #
|
|---|
| 35 | # <see CVS and SVN checkin messages for history>
|
|---|
| 36 | #
|
|---|
| 37 | # 1.0.6 - added linux_distribution()
|
|---|
| 38 | # 1.0.5 - fixed Java support to allow running the module on Jython
|
|---|
| 39 | # 1.0.4 - added IronPython support
|
|---|
| 40 | # 1.0.3 - added normalization of Windows system name
|
|---|
| 41 | # 1.0.2 - added more Windows support
|
|---|
| 42 | # 1.0.1 - reformatted to make doc.py happy
|
|---|
| 43 | # 1.0.0 - reformatted a bit and checked into Python CVS
|
|---|
| 44 | # 0.8.0 - added sys.version parser and various new access
|
|---|
| 45 | # APIs (python_version(), python_compiler(), etc.)
|
|---|
| 46 | # 0.7.2 - fixed architecture() to use sizeof(pointer) where available
|
|---|
| 47 | # 0.7.1 - added support for Caldera OpenLinux
|
|---|
| 48 | # 0.7.0 - some fixes for WinCE; untabified the source file
|
|---|
| 49 | # 0.6.2 - support for OpenVMS - requires version 1.5.2-V006 or higher and
|
|---|
| 50 | # vms_lib.getsyi() configured
|
|---|
| 51 | # 0.6.1 - added code to prevent 'uname -p' on platforms which are
|
|---|
| 52 | # known not to support it
|
|---|
| 53 | # 0.6.0 - fixed win32_ver() to hopefully work on Win95,98,NT and Win2k;
|
|---|
| 54 | # did some cleanup of the interfaces - some APIs have changed
|
|---|
| 55 | # 0.5.5 - fixed another type in the MacOS code... should have
|
|---|
| 56 | # used more coffee today ;-)
|
|---|
| 57 | # 0.5.4 - fixed a few typos in the MacOS code
|
|---|
| 58 | # 0.5.3 - added experimental MacOS support; added better popen()
|
|---|
| 59 | # workarounds in _syscmd_ver() -- still not 100% elegant
|
|---|
| 60 | # though
|
|---|
| 61 | # 0.5.2 - fixed uname() to return '' instead of 'unknown' in all
|
|---|
| 62 | # return values (the system uname command tends to return
|
|---|
| 63 | # 'unknown' instead of just leaving the field emtpy)
|
|---|
| 64 | # 0.5.1 - included code for slackware dist; added exception handlers
|
|---|
| 65 | # to cover up situations where platforms don't have os.popen
|
|---|
| 66 | # (e.g. Mac) or fail on socket.gethostname(); fixed libc
|
|---|
| 67 | # detection RE
|
|---|
| 68 | # 0.5.0 - changed the API names referring to system commands to *syscmd*;
|
|---|
| 69 | # added java_ver(); made syscmd_ver() a private
|
|---|
| 70 | # API (was system_ver() in previous versions) -- use uname()
|
|---|
| 71 | # instead; extended the win32_ver() to also return processor
|
|---|
| 72 | # type information
|
|---|
| 73 | # 0.4.0 - added win32_ver() and modified the platform() output for WinXX
|
|---|
| 74 | # 0.3.4 - fixed a bug in _follow_symlinks()
|
|---|
| 75 | # 0.3.3 - fixed popen() and "file" command invokation bugs
|
|---|
| 76 | # 0.3.2 - added architecture() API and support for it in platform()
|
|---|
| 77 | # 0.3.1 - fixed syscmd_ver() RE to support Windows NT
|
|---|
| 78 | # 0.3.0 - added system alias support
|
|---|
| 79 | # 0.2.3 - removed 'wince' again... oh well.
|
|---|
| 80 | # 0.2.2 - added 'wince' to syscmd_ver() supported platforms
|
|---|
| 81 | # 0.2.1 - added cache logic and changed the platform string format
|
|---|
| 82 | # 0.2.0 - changed the API to use functions instead of module globals
|
|---|
| 83 | # since some action take too long to be run on module import
|
|---|
| 84 | # 0.1.0 - first release
|
|---|
| 85 | #
|
|---|
| 86 | # You can always get the latest version of this module at:
|
|---|
| 87 | #
|
|---|
| 88 | # http://www.egenix.com/files/python/platform.py
|
|---|
| 89 | #
|
|---|
| 90 | # If that URL should fail, try contacting the author.
|
|---|
| 91 |
|
|---|
| 92 | __copyright__ = """
|
|---|
| 93 | Copyright (c) 1999-2000, Marc-Andre Lemburg; mailto:mal@lemburg.com
|
|---|
| 94 | Copyright (c) 2000-2008, eGenix.com Software GmbH; mailto:info@egenix.com
|
|---|
| 95 |
|
|---|
| 96 | Permission to use, copy, modify, and distribute this software and its
|
|---|
| 97 | documentation for any purpose and without fee or royalty is hereby granted,
|
|---|
| 98 | provided that the above copyright notice appear in all copies and that
|
|---|
| 99 | both that copyright notice and this permission notice appear in
|
|---|
| 100 | supporting documentation or portions thereof, including modifications,
|
|---|
| 101 | that you make.
|
|---|
| 102 |
|
|---|
| 103 | EGENIX.COM SOFTWARE GMBH DISCLAIMS ALL WARRANTIES WITH REGARD TO
|
|---|
| 104 | THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
|
|---|
| 105 | FITNESS, IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL,
|
|---|
| 106 | INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
|
|---|
| 107 | FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
|
|---|
| 108 | NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
|
|---|
| 109 | WITH THE USE OR PERFORMANCE OF THIS SOFTWARE !
|
|---|
| 110 |
|
|---|
| 111 | """
|
|---|
| 112 |
|
|---|
| 113 | __version__ = '1.0.6'
|
|---|
| 114 |
|
|---|
| 115 | import sys,string,os,re
|
|---|
| 116 |
|
|---|
| 117 | ### Platform specific APIs
|
|---|
| 118 |
|
|---|
| 119 | _libc_search = re.compile(r'(__libc_init)'
|
|---|
| 120 | '|'
|
|---|
| 121 | '(GLIBC_([0-9.]+))'
|
|---|
| 122 | '|'
|
|---|
| 123 | '(libc(_\w+)?\.so(?:\.(\d[0-9.]*))?)')
|
|---|
| 124 |
|
|---|
| 125 | def libc_ver(executable=sys.executable,lib='',version='',
|
|---|
| 126 |
|
|---|
| 127 | chunksize=2048):
|
|---|
| 128 |
|
|---|
| 129 | """ Tries to determine the libc version that the file executable
|
|---|
| 130 | (which defaults to the Python interpreter) is linked against.
|
|---|
| 131 |
|
|---|
| 132 | Returns a tuple of strings (lib,version) which default to the
|
|---|
| 133 | given parameters in case the lookup fails.
|
|---|
| 134 |
|
|---|
| 135 | Note that the function has intimate knowledge of how different
|
|---|
| 136 | libc versions add symbols to the executable and thus is probably
|
|---|
| 137 | only useable for executables compiled using gcc.
|
|---|
| 138 |
|
|---|
| 139 | The file is read and scanned in chunks of chunksize bytes.
|
|---|
| 140 |
|
|---|
| 141 | """
|
|---|
| 142 | if hasattr(os.path, 'realpath'):
|
|---|
| 143 | # Python 2.2 introduced os.path.realpath(); it is used
|
|---|
| 144 | # here to work around problems with Cygwin not being
|
|---|
| 145 | # able to open symlinks for reading
|
|---|
| 146 | executable = os.path.realpath(executable)
|
|---|
| 147 | f = open(executable,'rb')
|
|---|
| 148 | binary = f.read(chunksize)
|
|---|
| 149 | pos = 0
|
|---|
| 150 | while 1:
|
|---|
| 151 | m = _libc_search.search(binary,pos)
|
|---|
| 152 | if not m:
|
|---|
| 153 | binary = f.read(chunksize)
|
|---|
| 154 | if not binary:
|
|---|
| 155 | break
|
|---|
| 156 | pos = 0
|
|---|
| 157 | continue
|
|---|
| 158 | libcinit,glibc,glibcversion,so,threads,soversion = m.groups()
|
|---|
| 159 | if libcinit and not lib:
|
|---|
| 160 | lib = 'libc'
|
|---|
| 161 | elif glibc:
|
|---|
| 162 | if lib != 'glibc':
|
|---|
| 163 | lib = 'glibc'
|
|---|
| 164 | version = glibcversion
|
|---|
| 165 | elif glibcversion > version:
|
|---|
| 166 | version = glibcversion
|
|---|
| 167 | elif so:
|
|---|
| 168 | if lib != 'glibc':
|
|---|
| 169 | lib = 'libc'
|
|---|
| 170 | if soversion > version:
|
|---|
| 171 | version = soversion
|
|---|
| 172 | if threads and version[-len(threads):] != threads:
|
|---|
| 173 | version = version + threads
|
|---|
| 174 | pos = m.end()
|
|---|
| 175 | f.close()
|
|---|
| 176 | return lib,version
|
|---|
| 177 |
|
|---|
| 178 | def _dist_try_harder(distname,version,id):
|
|---|
| 179 |
|
|---|
| 180 | """ Tries some special tricks to get the distribution
|
|---|
| 181 | information in case the default method fails.
|
|---|
| 182 |
|
|---|
| 183 | Currently supports older SuSE Linux, Caldera OpenLinux and
|
|---|
| 184 | Slackware Linux distributions.
|
|---|
| 185 |
|
|---|
| 186 | """
|
|---|
| 187 | if os.path.exists('/var/adm/inst-log/info'):
|
|---|
| 188 | # SuSE Linux stores distribution information in that file
|
|---|
| 189 | info = open('/var/adm/inst-log/info').readlines()
|
|---|
| 190 | distname = 'SuSE'
|
|---|
| 191 | for line in info:
|
|---|
| 192 | tv = string.split(line)
|
|---|
| 193 | if len(tv) == 2:
|
|---|
| 194 | tag,value = tv
|
|---|
| 195 | else:
|
|---|
| 196 | continue
|
|---|
| 197 | if tag == 'MIN_DIST_VERSION':
|
|---|
| 198 | version = string.strip(value)
|
|---|
| 199 | elif tag == 'DIST_IDENT':
|
|---|
| 200 | values = string.split(value,'-')
|
|---|
| 201 | id = values[2]
|
|---|
| 202 | return distname,version,id
|
|---|
| 203 |
|
|---|
| 204 | if os.path.exists('/etc/.installed'):
|
|---|
| 205 | # Caldera OpenLinux has some infos in that file (thanks to Colin Kong)
|
|---|
| 206 | info = open('/etc/.installed').readlines()
|
|---|
| 207 | for line in info:
|
|---|
| 208 | pkg = string.split(line,'-')
|
|---|
| 209 | if len(pkg) >= 2 and pkg[0] == 'OpenLinux':
|
|---|
| 210 | # XXX does Caldera support non Intel platforms ? If yes,
|
|---|
| 211 | # where can we find the needed id ?
|
|---|
| 212 | return 'OpenLinux',pkg[1],id
|
|---|
| 213 |
|
|---|
| 214 | if os.path.isdir('/usr/lib/setup'):
|
|---|
| 215 | # Check for slackware verson tag file (thanks to Greg Andruk)
|
|---|
| 216 | verfiles = os.listdir('/usr/lib/setup')
|
|---|
| 217 | for n in range(len(verfiles)-1, -1, -1):
|
|---|
| 218 | if verfiles[n][:14] != 'slack-version-':
|
|---|
| 219 | del verfiles[n]
|
|---|
| 220 | if verfiles:
|
|---|
| 221 | verfiles.sort()
|
|---|
| 222 | distname = 'slackware'
|
|---|
| 223 | version = verfiles[-1][14:]
|
|---|
| 224 | return distname,version,id
|
|---|
| 225 |
|
|---|
| 226 | return distname,version,id
|
|---|
| 227 |
|
|---|
| 228 | _release_filename = re.compile(r'(\w+)[-_](release|version)')
|
|---|
| 229 | _lsb_release_version = re.compile(r'(.+)'
|
|---|
| 230 | ' release '
|
|---|
| 231 | '([\d.]+)'
|
|---|
| 232 | '[^(]*(?:\((.+)\))?')
|
|---|
| 233 | _release_version = re.compile(r'([^0-9]+)'
|
|---|
| 234 | '(?: release )?'
|
|---|
| 235 | '([\d.]+)'
|
|---|
| 236 | '[^(]*(?:\((.+)\))?')
|
|---|
| 237 |
|
|---|
| 238 | # See also http://www.novell.com/coolsolutions/feature/11251.html
|
|---|
| 239 | # and http://linuxmafia.com/faq/Admin/release-files.html
|
|---|
| 240 | # and http://data.linux-ntfs.org/rpm/whichrpm
|
|---|
| 241 | # and http://www.die.net/doc/linux/man/man1/lsb_release.1.html
|
|---|
| 242 |
|
|---|
| 243 | _supported_dists = (
|
|---|
| 244 | 'SuSE', 'debian', 'fedora', 'redhat', 'centos',
|
|---|
| 245 | 'mandrake', 'mandriva', 'rocks', 'slackware', 'yellowdog', 'gentoo',
|
|---|
| 246 | 'UnitedLinux', 'turbolinux')
|
|---|
| 247 |
|
|---|
| 248 | def _parse_release_file(firstline):
|
|---|
| 249 |
|
|---|
| 250 | # Default to empty 'version' and 'id' strings. Both defaults are used
|
|---|
| 251 | # when 'firstline' is empty. 'id' defaults to empty when an id can not
|
|---|
| 252 | # be deduced.
|
|---|
| 253 | version = ''
|
|---|
| 254 | id = ''
|
|---|
| 255 |
|
|---|
| 256 | # Parse the first line
|
|---|
| 257 | m = _lsb_release_version.match(firstline)
|
|---|
| 258 | if m is not None:
|
|---|
| 259 | # LSB format: "distro release x.x (codename)"
|
|---|
| 260 | return tuple(m.groups())
|
|---|
| 261 |
|
|---|
| 262 | # Pre-LSB format: "distro x.x (codename)"
|
|---|
| 263 | m = _release_version.match(firstline)
|
|---|
| 264 | if m is not None:
|
|---|
| 265 | return tuple(m.groups())
|
|---|
| 266 |
|
|---|
| 267 | # Unkown format... take the first two words
|
|---|
| 268 | l = string.split(string.strip(firstline))
|
|---|
| 269 | if l:
|
|---|
| 270 | version = l[0]
|
|---|
| 271 | if len(l) > 1:
|
|---|
| 272 | id = l[1]
|
|---|
| 273 | return '', version, id
|
|---|
| 274 |
|
|---|
| 275 | def _test_parse_release_file():
|
|---|
| 276 |
|
|---|
| 277 | for input, output in (
|
|---|
| 278 | # Examples of release file contents:
|
|---|
| 279 | ('SuSE Linux 9.3 (x86-64)', ('SuSE Linux ', '9.3', 'x86-64'))
|
|---|
| 280 | ('SUSE LINUX 10.1 (X86-64)', ('SUSE LINUX ', '10.1', 'X86-64'))
|
|---|
| 281 | ('SUSE LINUX 10.1 (i586)', ('SUSE LINUX ', '10.1', 'i586'))
|
|---|
| 282 | ('Fedora Core release 5 (Bordeaux)', ('Fedora Core', '5', 'Bordeaux'))
|
|---|
| 283 | ('Red Hat Linux release 8.0 (Psyche)', ('Red Hat Linux', '8.0', 'Psyche'))
|
|---|
| 284 | ('Red Hat Linux release 9 (Shrike)', ('Red Hat Linux', '9', 'Shrike'))
|
|---|
| 285 | ('Red Hat Enterprise Linux release 4 (Nahant)', ('Red Hat Enterprise Linux', '4', 'Nahant'))
|
|---|
| 286 | ('CentOS release 4', ('CentOS', '4', None))
|
|---|
| 287 | ('Rocks release 4.2.1 (Cydonia)', ('Rocks', '4.2.1', 'Cydonia'))
|
|---|
| 288 | ):
|
|---|
| 289 | parsed = _parse_release_file(input)
|
|---|
| 290 | if parsed != output:
|
|---|
| 291 | print (input, parsed)
|
|---|
| 292 |
|
|---|
| 293 | def linux_distribution(distname='', version='', id='',
|
|---|
| 294 |
|
|---|
| 295 | supported_dists=_supported_dists,
|
|---|
| 296 | full_distribution_name=1):
|
|---|
| 297 |
|
|---|
| 298 | """ Tries to determine the name of the Linux OS distribution name.
|
|---|
| 299 |
|
|---|
| 300 | The function first looks for a distribution release file in
|
|---|
| 301 | /etc and then reverts to _dist_try_harder() in case no
|
|---|
| 302 | suitable files are found.
|
|---|
| 303 |
|
|---|
| 304 | supported_dists may be given to define the set of Linux
|
|---|
| 305 | distributions to look for. It defaults to a list of currently
|
|---|
| 306 | supported Linux distributions identified by their release file
|
|---|
| 307 | name.
|
|---|
| 308 |
|
|---|
| 309 | If full_distribution_name is true (default), the full
|
|---|
| 310 | distribution read from the OS is returned. Otherwise the short
|
|---|
| 311 | name taken from supported_dists is used.
|
|---|
| 312 |
|
|---|
| 313 | Returns a tuple (distname,version,id) which default to the
|
|---|
| 314 | args given as parameters.
|
|---|
| 315 |
|
|---|
| 316 | """
|
|---|
| 317 | try:
|
|---|
| 318 | etc = os.listdir('/etc')
|
|---|
| 319 | except os.error:
|
|---|
| 320 | # Probably not a Unix system
|
|---|
| 321 | return distname,version,id
|
|---|
| 322 | etc.sort()
|
|---|
| 323 | for file in etc:
|
|---|
| 324 | m = _release_filename.match(file)
|
|---|
| 325 | if m is not None:
|
|---|
| 326 | _distname,dummy = m.groups()
|
|---|
| 327 | if _distname in supported_dists:
|
|---|
| 328 | distname = _distname
|
|---|
| 329 | break
|
|---|
| 330 | else:
|
|---|
| 331 | return _dist_try_harder(distname,version,id)
|
|---|
| 332 |
|
|---|
| 333 | # Read the first line
|
|---|
| 334 | f = open('/etc/'+file, 'r')
|
|---|
| 335 | firstline = f.readline()
|
|---|
| 336 | f.close()
|
|---|
| 337 | _distname, _version, _id = _parse_release_file(firstline)
|
|---|
| 338 |
|
|---|
| 339 | if _distname and full_distribution_name:
|
|---|
| 340 | distname = _distname
|
|---|
| 341 | if _version:
|
|---|
| 342 | version = _version
|
|---|
| 343 | if _id:
|
|---|
| 344 | id = _id
|
|---|
| 345 | return distname, version, id
|
|---|
| 346 |
|
|---|
| 347 | # To maintain backwards compatibility:
|
|---|
| 348 |
|
|---|
| 349 | def dist(distname='',version='',id='',
|
|---|
| 350 |
|
|---|
| 351 | supported_dists=_supported_dists):
|
|---|
| 352 |
|
|---|
| 353 | """ Tries to determine the name of the Linux OS distribution name.
|
|---|
| 354 |
|
|---|
| 355 | The function first looks for a distribution release file in
|
|---|
| 356 | /etc and then reverts to _dist_try_harder() in case no
|
|---|
| 357 | suitable files are found.
|
|---|
| 358 |
|
|---|
| 359 | Returns a tuple (distname,version,id) which default to the
|
|---|
| 360 | args given as parameters.
|
|---|
| 361 |
|
|---|
| 362 | """
|
|---|
| 363 | return linux_distribution(distname, version, id,
|
|---|
| 364 | supported_dists=supported_dists,
|
|---|
| 365 | full_distribution_name=0)
|
|---|
| 366 |
|
|---|
| 367 | class _popen:
|
|---|
| 368 |
|
|---|
| 369 | """ Fairly portable (alternative) popen implementation.
|
|---|
| 370 |
|
|---|
| 371 | This is mostly needed in case os.popen() is not available, or
|
|---|
| 372 | doesn't work as advertised, e.g. in Win9X GUI programs like
|
|---|
| 373 | PythonWin or IDLE.
|
|---|
| 374 |
|
|---|
| 375 | Writing to the pipe is currently not supported.
|
|---|
| 376 |
|
|---|
| 377 | """
|
|---|
| 378 | tmpfile = ''
|
|---|
| 379 | pipe = None
|
|---|
| 380 | bufsize = None
|
|---|
| 381 | mode = 'r'
|
|---|
| 382 |
|
|---|
| 383 | def __init__(self,cmd,mode='r',bufsize=None):
|
|---|
| 384 |
|
|---|
| 385 | if mode != 'r':
|
|---|
| 386 | raise ValueError,'popen()-emulation only supports read mode'
|
|---|
| 387 | import tempfile
|
|---|
| 388 | self.tmpfile = tmpfile = tempfile.mktemp()
|
|---|
| 389 | os.system(cmd + ' > %s' % tmpfile)
|
|---|
| 390 | self.pipe = open(tmpfile,'rb')
|
|---|
| 391 | self.bufsize = bufsize
|
|---|
| 392 | self.mode = mode
|
|---|
| 393 |
|
|---|
| 394 | def read(self):
|
|---|
| 395 |
|
|---|
| 396 | return self.pipe.read()
|
|---|
| 397 |
|
|---|
| 398 | def readlines(self):
|
|---|
| 399 |
|
|---|
| 400 | if self.bufsize is not None:
|
|---|
| 401 | return self.pipe.readlines()
|
|---|
| 402 |
|
|---|
| 403 | def close(self,
|
|---|
| 404 |
|
|---|
| 405 | remove=os.unlink,error=os.error):
|
|---|
| 406 |
|
|---|
| 407 | if self.pipe:
|
|---|
| 408 | rc = self.pipe.close()
|
|---|
| 409 | else:
|
|---|
| 410 | rc = 255
|
|---|
| 411 | if self.tmpfile:
|
|---|
| 412 | try:
|
|---|
| 413 | remove(self.tmpfile)
|
|---|
| 414 | except error:
|
|---|
| 415 | pass
|
|---|
| 416 | return rc
|
|---|
| 417 |
|
|---|
| 418 | # Alias
|
|---|
| 419 | __del__ = close
|
|---|
| 420 |
|
|---|
| 421 | def popen(cmd, mode='r', bufsize=None):
|
|---|
| 422 |
|
|---|
| 423 | """ Portable popen() interface.
|
|---|
| 424 | """
|
|---|
| 425 | # Find a working popen implementation preferring win32pipe.popen
|
|---|
| 426 | # over os.popen over _popen
|
|---|
| 427 | popen = None
|
|---|
| 428 | if os.environ.get('OS','') == 'Windows_NT':
|
|---|
| 429 | # On NT win32pipe should work; on Win9x it hangs due to bugs
|
|---|
| 430 | # in the MS C lib (see MS KnowledgeBase article Q150956)
|
|---|
| 431 | try:
|
|---|
| 432 | import win32pipe
|
|---|
| 433 | except ImportError:
|
|---|
| 434 | pass
|
|---|
| 435 | else:
|
|---|
| 436 | popen = win32pipe.popen
|
|---|
| 437 | if popen is None:
|
|---|
| 438 | if hasattr(os,'popen'):
|
|---|
| 439 | popen = os.popen
|
|---|
| 440 | # Check whether it works... it doesn't in GUI programs
|
|---|
| 441 | # on Windows platforms
|
|---|
| 442 | if sys.platform == 'win32': # XXX Others too ?
|
|---|
| 443 | try:
|
|---|
| 444 | popen('')
|
|---|
| 445 | except os.error:
|
|---|
| 446 | popen = _popen
|
|---|
| 447 | else:
|
|---|
| 448 | popen = _popen
|
|---|
| 449 | if bufsize is None:
|
|---|
| 450 | return popen(cmd,mode)
|
|---|
| 451 | else:
|
|---|
| 452 | return popen(cmd,mode,bufsize)
|
|---|
| 453 |
|
|---|
| 454 | def _norm_version(version, build=''):
|
|---|
| 455 |
|
|---|
| 456 | """ Normalize the version and build strings and return a single
|
|---|
| 457 | version string using the format major.minor.build (or patchlevel).
|
|---|
| 458 | """
|
|---|
| 459 | l = string.split(version,'.')
|
|---|
| 460 | if build:
|
|---|
| 461 | l.append(build)
|
|---|
| 462 | try:
|
|---|
| 463 | ints = map(int,l)
|
|---|
| 464 | except ValueError:
|
|---|
| 465 | strings = l
|
|---|
| 466 | else:
|
|---|
| 467 | strings = map(str,ints)
|
|---|
| 468 | version = string.join(strings[:3],'.')
|
|---|
| 469 | return version
|
|---|
| 470 |
|
|---|
| 471 | _ver_output = re.compile(r'(?:([\w ]+) ([\w.]+) '
|
|---|
| 472 | '.*'
|
|---|
| 473 | 'Version ([\d.]+))')
|
|---|
| 474 |
|
|---|
| 475 | def _syscmd_ver(system='', release='', version='',
|
|---|
| 476 |
|
|---|
| 477 | supported_platforms=('win32','win16','dos','os2')):
|
|---|
| 478 |
|
|---|
| 479 | """ Tries to figure out the OS version used and returns
|
|---|
| 480 | a tuple (system,release,version).
|
|---|
| 481 |
|
|---|
| 482 | It uses the "ver" shell command for this which is known
|
|---|
| 483 | to exists on Windows, DOS and OS/2. XXX Others too ?
|
|---|
| 484 |
|
|---|
| 485 | In case this fails, the given parameters are used as
|
|---|
| 486 | defaults.
|
|---|
| 487 |
|
|---|
| 488 | """
|
|---|
| 489 | if sys.platform not in supported_platforms:
|
|---|
| 490 | return system,release,version
|
|---|
| 491 |
|
|---|
| 492 | # Try some common cmd strings
|
|---|
| 493 | for cmd in ('ver','command /c ver','cmd /c ver'):
|
|---|
| 494 | try:
|
|---|
| 495 | pipe = popen(cmd)
|
|---|
| 496 | info = pipe.read()
|
|---|
| 497 | if pipe.close():
|
|---|
| 498 | raise os.error,'command failed'
|
|---|
| 499 | # XXX How can I supress shell errors from being written
|
|---|
| 500 | # to stderr ?
|
|---|
| 501 | except os.error,why:
|
|---|
| 502 | #print 'Command %s failed: %s' % (cmd,why)
|
|---|
| 503 | continue
|
|---|
| 504 | except IOError,why:
|
|---|
| 505 | #print 'Command %s failed: %s' % (cmd,why)
|
|---|
| 506 | continue
|
|---|
| 507 | else:
|
|---|
| 508 | break
|
|---|
| 509 | else:
|
|---|
| 510 | return system,release,version
|
|---|
| 511 |
|
|---|
| 512 | # Parse the output
|
|---|
| 513 | info = string.strip(info)
|
|---|
| 514 | m = _ver_output.match(info)
|
|---|
| 515 | if m is not None:
|
|---|
| 516 | system,release,version = m.groups()
|
|---|
| 517 | # Strip trailing dots from version and release
|
|---|
| 518 | if release[-1] == '.':
|
|---|
| 519 | release = release[:-1]
|
|---|
| 520 | if version[-1] == '.':
|
|---|
| 521 | version = version[:-1]
|
|---|
| 522 | # Normalize the version and build strings (eliminating additional
|
|---|
| 523 | # zeros)
|
|---|
| 524 | version = _norm_version(version)
|
|---|
| 525 | return system,release,version
|
|---|
| 526 |
|
|---|
| 527 | def _win32_getvalue(key,name,default=''):
|
|---|
| 528 |
|
|---|
| 529 | """ Read a value for name from the registry key.
|
|---|
| 530 |
|
|---|
| 531 | In case this fails, default is returned.
|
|---|
| 532 |
|
|---|
| 533 | """
|
|---|
| 534 | try:
|
|---|
| 535 | # Use win32api if available
|
|---|
| 536 | from win32api import RegQueryValueEx
|
|---|
| 537 | except ImportError:
|
|---|
| 538 | # On Python 2.0 and later, emulate using _winreg
|
|---|
| 539 | import _winreg
|
|---|
| 540 | RegQueryValueEx = _winreg.QueryValueEx
|
|---|
| 541 | try:
|
|---|
| 542 | return RegQueryValueEx(key,name)
|
|---|
| 543 | except:
|
|---|
| 544 | return default
|
|---|
| 545 |
|
|---|
| 546 | def win32_ver(release='',version='',csd='',ptype=''):
|
|---|
| 547 |
|
|---|
| 548 | """ Get additional version information from the Windows Registry
|
|---|
| 549 | and return a tuple (version,csd,ptype) referring to version
|
|---|
| 550 | number, CSD level and OS type (multi/single
|
|---|
| 551 | processor).
|
|---|
| 552 |
|
|---|
| 553 | As a hint: ptype returns 'Uniprocessor Free' on single
|
|---|
| 554 | processor NT machines and 'Multiprocessor Free' on multi
|
|---|
| 555 | processor machines. The 'Free' refers to the OS version being
|
|---|
| 556 | free of debugging code. It could also state 'Checked' which
|
|---|
| 557 | means the OS version uses debugging code, i.e. code that
|
|---|
| 558 | checks arguments, ranges, etc. (Thomas Heller).
|
|---|
| 559 |
|
|---|
| 560 | Note: this function works best with Mark Hammond's win32
|
|---|
| 561 | package installed, but also on Python 2.3 and later. It
|
|---|
| 562 | obviously only runs on Win32 compatible platforms.
|
|---|
| 563 |
|
|---|
| 564 | """
|
|---|
| 565 | # XXX Is there any way to find out the processor type on WinXX ?
|
|---|
| 566 | # XXX Is win32 available on Windows CE ?
|
|---|
| 567 | #
|
|---|
| 568 | # Adapted from code posted by Karl Putland to comp.lang.python.
|
|---|
| 569 | #
|
|---|
| 570 | # The mappings between reg. values and release names can be found
|
|---|
| 571 | # here: http://msdn.microsoft.com/library/en-us/sysinfo/base/osversioninfo_str.asp
|
|---|
| 572 |
|
|---|
| 573 | # Import the needed APIs
|
|---|
| 574 | try:
|
|---|
| 575 | import win32api
|
|---|
| 576 | from win32api import RegQueryValueEx, RegOpenKeyEx, \
|
|---|
| 577 | RegCloseKey, GetVersionEx
|
|---|
| 578 | from win32con import HKEY_LOCAL_MACHINE, VER_PLATFORM_WIN32_NT, \
|
|---|
| 579 | VER_PLATFORM_WIN32_WINDOWS, VER_NT_WORKSTATION
|
|---|
| 580 | except ImportError:
|
|---|
| 581 | # Emulate the win32api module using Python APIs
|
|---|
| 582 | try:
|
|---|
| 583 | sys.getwindowsversion
|
|---|
| 584 | except AttributeError:
|
|---|
| 585 | # No emulation possible, so return the defaults...
|
|---|
| 586 | return release,version,csd,ptype
|
|---|
| 587 | else:
|
|---|
| 588 | # Emulation using _winreg (added in Python 2.0) and
|
|---|
| 589 | # sys.getwindowsversion() (added in Python 2.3)
|
|---|
| 590 | import _winreg
|
|---|
| 591 | GetVersionEx = sys.getwindowsversion
|
|---|
| 592 | RegQueryValueEx = _winreg.QueryValueEx
|
|---|
| 593 | RegOpenKeyEx = _winreg.OpenKeyEx
|
|---|
| 594 | RegCloseKey = _winreg.CloseKey
|
|---|
| 595 | HKEY_LOCAL_MACHINE = _winreg.HKEY_LOCAL_MACHINE
|
|---|
| 596 | VER_PLATFORM_WIN32_WINDOWS = 1
|
|---|
| 597 | VER_PLATFORM_WIN32_NT = 2
|
|---|
| 598 | VER_NT_WORKSTATION = 1
|
|---|
| 599 |
|
|---|
| 600 | # Find out the registry key and some general version infos
|
|---|
| 601 | maj,min,buildno,plat,csd = GetVersionEx()
|
|---|
| 602 | version = '%i.%i.%i' % (maj,min,buildno & 0xFFFF)
|
|---|
| 603 | if csd[:13] == 'Service Pack ':
|
|---|
| 604 | csd = 'SP' + csd[13:]
|
|---|
| 605 | if plat == VER_PLATFORM_WIN32_WINDOWS:
|
|---|
| 606 | regkey = 'SOFTWARE\\Microsoft\\Windows\\CurrentVersion'
|
|---|
| 607 | # Try to guess the release name
|
|---|
| 608 | if maj == 4:
|
|---|
| 609 | if min == 0:
|
|---|
| 610 | release = '95'
|
|---|
| 611 | elif min == 10:
|
|---|
| 612 | release = '98'
|
|---|
| 613 | elif min == 90:
|
|---|
| 614 | release = 'Me'
|
|---|
| 615 | else:
|
|---|
| 616 | release = 'postMe'
|
|---|
| 617 | elif maj == 5:
|
|---|
| 618 | release = '2000'
|
|---|
| 619 | elif plat == VER_PLATFORM_WIN32_NT:
|
|---|
| 620 | regkey = 'SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'
|
|---|
| 621 | if maj <= 4:
|
|---|
| 622 | release = 'NT'
|
|---|
| 623 | elif maj == 5:
|
|---|
| 624 | if min == 0:
|
|---|
| 625 | release = '2000'
|
|---|
| 626 | elif min == 1:
|
|---|
| 627 | release = 'XP'
|
|---|
| 628 | elif min == 2:
|
|---|
| 629 | release = '2003Server'
|
|---|
| 630 | else:
|
|---|
| 631 | release = 'post2003'
|
|---|
| 632 | elif maj == 6:
|
|---|
| 633 | if min == 0:
|
|---|
| 634 | # Per http://msdn2.microsoft.com/en-us/library/ms724429.aspx
|
|---|
| 635 | try:
|
|---|
| 636 | productType = GetVersionEx(1)[8]
|
|---|
| 637 | except TypeError:
|
|---|
| 638 | # sys.getwindowsversion() doesn't take any arguments, so
|
|---|
| 639 | # we cannot detect 2008 Server that way.
|
|---|
| 640 | # XXX Add some other means of detecting 2008 Server ?!
|
|---|
| 641 | release = 'Vista'
|
|---|
| 642 | else:
|
|---|
| 643 | if productType == VER_NT_WORKSTATION:
|
|---|
| 644 | release = 'Vista'
|
|---|
| 645 | else:
|
|---|
| 646 | release = '2008Server'
|
|---|
| 647 | else:
|
|---|
| 648 | release = 'post2008Server'
|
|---|
| 649 | else:
|
|---|
| 650 | if not release:
|
|---|
| 651 | # E.g. Win3.1 with win32s
|
|---|
| 652 | release = '%i.%i' % (maj,min)
|
|---|
| 653 | return release,version,csd,ptype
|
|---|
| 654 |
|
|---|
| 655 | # Open the registry key
|
|---|
| 656 | try:
|
|---|
| 657 | keyCurVer = RegOpenKeyEx(HKEY_LOCAL_MACHINE, regkey)
|
|---|
| 658 | # Get a value to make sure the key exists...
|
|---|
| 659 | RegQueryValueEx(keyCurVer, 'SystemRoot')
|
|---|
| 660 | except:
|
|---|
| 661 | return release,version,csd,ptype
|
|---|
| 662 |
|
|---|
| 663 | # Parse values
|
|---|
| 664 | #subversion = _win32_getvalue(keyCurVer,
|
|---|
| 665 | # 'SubVersionNumber',
|
|---|
| 666 | # ('',1))[0]
|
|---|
| 667 | #if subversion:
|
|---|
| 668 | # release = release + subversion # 95a, 95b, etc.
|
|---|
| 669 | build = _win32_getvalue(keyCurVer,
|
|---|
| 670 | 'CurrentBuildNumber',
|
|---|
| 671 | ('',1))[0]
|
|---|
| 672 | ptype = _win32_getvalue(keyCurVer,
|
|---|
| 673 | 'CurrentType',
|
|---|
| 674 | (ptype,1))[0]
|
|---|
| 675 |
|
|---|
| 676 | # Normalize version
|
|---|
| 677 | version = _norm_version(version,build)
|
|---|
| 678 |
|
|---|
| 679 | # Close key
|
|---|
| 680 | RegCloseKey(keyCurVer)
|
|---|
| 681 | return release,version,csd,ptype
|
|---|
| 682 |
|
|---|
| 683 | def _mac_ver_lookup(selectors,default=None):
|
|---|
| 684 |
|
|---|
| 685 | from gestalt import gestalt
|
|---|
| 686 | import MacOS
|
|---|
| 687 | l = []
|
|---|
| 688 | append = l.append
|
|---|
| 689 | for selector in selectors:
|
|---|
| 690 | try:
|
|---|
| 691 | append(gestalt(selector))
|
|---|
| 692 | except (RuntimeError, MacOS.Error):
|
|---|
| 693 | append(default)
|
|---|
| 694 | return l
|
|---|
| 695 |
|
|---|
| 696 | def _bcd2str(bcd):
|
|---|
| 697 |
|
|---|
| 698 | return hex(bcd)[2:]
|
|---|
| 699 |
|
|---|
| 700 | def mac_ver(release='',versioninfo=('','',''),machine=''):
|
|---|
| 701 |
|
|---|
| 702 | """ Get MacOS version information and return it as tuple (release,
|
|---|
| 703 | versioninfo, machine) with versioninfo being a tuple (version,
|
|---|
| 704 | dev_stage, non_release_version).
|
|---|
| 705 |
|
|---|
| 706 | Entries which cannot be determined are set to the paramter values
|
|---|
| 707 | which default to ''. All tuple entries are strings.
|
|---|
| 708 |
|
|---|
| 709 | Thanks to Mark R. Levinson for mailing documentation links and
|
|---|
| 710 | code examples for this function. Documentation for the
|
|---|
| 711 | gestalt() API is available online at:
|
|---|
| 712 |
|
|---|
| 713 | http://www.rgaros.nl/gestalt/
|
|---|
| 714 |
|
|---|
| 715 | """
|
|---|
| 716 | # Check whether the version info module is available
|
|---|
| 717 | try:
|
|---|
| 718 | import gestalt
|
|---|
| 719 | import MacOS
|
|---|
| 720 | except ImportError:
|
|---|
| 721 | return release,versioninfo,machine
|
|---|
| 722 | # Get the infos
|
|---|
| 723 | sysv,sysa = _mac_ver_lookup(('sysv','sysa'))
|
|---|
| 724 | # Decode the infos
|
|---|
| 725 | if sysv:
|
|---|
| 726 | major = (sysv & 0xFF00) >> 8
|
|---|
| 727 | minor = (sysv & 0x00F0) >> 4
|
|---|
| 728 | patch = (sysv & 0x000F)
|
|---|
| 729 |
|
|---|
| 730 | if (major, minor) >= (10, 4):
|
|---|
| 731 | # the 'sysv' gestald cannot return patchlevels
|
|---|
| 732 | # higher than 9. Apple introduced 3 new
|
|---|
| 733 | # gestalt codes in 10.4 to deal with this
|
|---|
| 734 | # issue (needed because patch levels can
|
|---|
| 735 | # run higher than 9, such as 10.4.11)
|
|---|
| 736 | major,minor,patch = _mac_ver_lookup(('sys1','sys2','sys3'))
|
|---|
| 737 | release = '%i.%i.%i' %(major, minor, patch)
|
|---|
| 738 | else:
|
|---|
| 739 | release = '%s.%i.%i' % (_bcd2str(major),minor,patch)
|
|---|
| 740 |
|
|---|
| 741 | if sysa:
|
|---|
| 742 | machine = {0x1: '68k',
|
|---|
| 743 | 0x2: 'PowerPC',
|
|---|
| 744 | 0xa: 'i386'}.get(sysa,'')
|
|---|
| 745 | return release,versioninfo,machine
|
|---|
| 746 |
|
|---|
| 747 | def _java_getprop(name,default):
|
|---|
| 748 |
|
|---|
| 749 | from java.lang import System
|
|---|
| 750 | try:
|
|---|
| 751 | value = System.getProperty(name)
|
|---|
| 752 | if value is None:
|
|---|
| 753 | return default
|
|---|
| 754 | return value
|
|---|
| 755 | except AttributeError:
|
|---|
| 756 | return default
|
|---|
| 757 |
|
|---|
| 758 | def java_ver(release='',vendor='',vminfo=('','',''),osinfo=('','','')):
|
|---|
| 759 |
|
|---|
| 760 | """ Version interface for Jython.
|
|---|
| 761 |
|
|---|
| 762 | Returns a tuple (release,vendor,vminfo,osinfo) with vminfo being
|
|---|
| 763 | a tuple (vm_name,vm_release,vm_vendor) and osinfo being a
|
|---|
| 764 | tuple (os_name,os_version,os_arch).
|
|---|
| 765 |
|
|---|
| 766 | Values which cannot be determined are set to the defaults
|
|---|
| 767 | given as parameters (which all default to '').
|
|---|
| 768 |
|
|---|
| 769 | """
|
|---|
| 770 | # Import the needed APIs
|
|---|
| 771 | try:
|
|---|
| 772 | import java.lang
|
|---|
| 773 | except ImportError:
|
|---|
| 774 | return release,vendor,vminfo,osinfo
|
|---|
| 775 |
|
|---|
| 776 | vendor = _java_getprop('java.vendor', vendor)
|
|---|
| 777 | release = _java_getprop('java.version', release)
|
|---|
| 778 | vm_name, vm_release, vm_vendor = vminfo
|
|---|
| 779 | vm_name = _java_getprop('java.vm.name', vm_name)
|
|---|
| 780 | vm_vendor = _java_getprop('java.vm.vendor', vm_vendor)
|
|---|
| 781 | vm_release = _java_getprop('java.vm.version', vm_release)
|
|---|
| 782 | vminfo = vm_name, vm_release, vm_vendor
|
|---|
| 783 | os_name, os_version, os_arch = osinfo
|
|---|
| 784 | os_arch = _java_getprop('java.os.arch', os_arch)
|
|---|
| 785 | os_name = _java_getprop('java.os.name', os_name)
|
|---|
| 786 | os_version = _java_getprop('java.os.version', os_version)
|
|---|
| 787 | osinfo = os_name, os_version, os_arch
|
|---|
| 788 |
|
|---|
| 789 | return release, vendor, vminfo, osinfo
|
|---|
| 790 |
|
|---|
| 791 | ### System name aliasing
|
|---|
| 792 |
|
|---|
| 793 | def system_alias(system,release,version):
|
|---|
| 794 |
|
|---|
| 795 | """ Returns (system,release,version) aliased to common
|
|---|
| 796 | marketing names used for some systems.
|
|---|
| 797 |
|
|---|
| 798 | It also does some reordering of the information in some cases
|
|---|
| 799 | where it would otherwise cause confusion.
|
|---|
| 800 |
|
|---|
| 801 | """
|
|---|
| 802 | if system == 'Rhapsody':
|
|---|
| 803 | # Apple's BSD derivative
|
|---|
| 804 | # XXX How can we determine the marketing release number ?
|
|---|
| 805 | return 'MacOS X Server',system+release,version
|
|---|
| 806 |
|
|---|
| 807 | elif system == 'SunOS':
|
|---|
| 808 | # Sun's OS
|
|---|
| 809 | if release < '5':
|
|---|
| 810 | # These releases use the old name SunOS
|
|---|
| 811 | return system,release,version
|
|---|
| 812 | # Modify release (marketing release = SunOS release - 3)
|
|---|
| 813 | l = string.split(release,'.')
|
|---|
| 814 | if l:
|
|---|
| 815 | try:
|
|---|
| 816 | major = int(l[0])
|
|---|
| 817 | except ValueError:
|
|---|
| 818 | pass
|
|---|
| 819 | else:
|
|---|
| 820 | major = major - 3
|
|---|
| 821 | l[0] = str(major)
|
|---|
| 822 | release = string.join(l,'.')
|
|---|
| 823 | if release < '6':
|
|---|
| 824 | system = 'Solaris'
|
|---|
| 825 | else:
|
|---|
| 826 | # XXX Whatever the new SunOS marketing name is...
|
|---|
| 827 | system = 'Solaris'
|
|---|
| 828 |
|
|---|
| 829 | elif system == 'IRIX64':
|
|---|
| 830 | # IRIX reports IRIX64 on platforms with 64-bit support; yet it
|
|---|
| 831 | # is really a version and not a different platform, since 32-bit
|
|---|
| 832 | # apps are also supported..
|
|---|
| 833 | system = 'IRIX'
|
|---|
| 834 | if version:
|
|---|
| 835 | version = version + ' (64bit)'
|
|---|
| 836 | else:
|
|---|
| 837 | version = '64bit'
|
|---|
| 838 |
|
|---|
| 839 | elif system in ('win32','win16'):
|
|---|
| 840 | # In case one of the other tricks
|
|---|
| 841 | system = 'Windows'
|
|---|
| 842 |
|
|---|
| 843 | return system,release,version
|
|---|
| 844 |
|
|---|
| 845 | ### Various internal helpers
|
|---|
| 846 |
|
|---|
| 847 | def _platform(*args):
|
|---|
| 848 |
|
|---|
| 849 | """ Helper to format the platform string in a filename
|
|---|
| 850 | compatible format e.g. "system-version-machine".
|
|---|
| 851 | """
|
|---|
| 852 | # Format the platform string
|
|---|
| 853 | platform = string.join(
|
|---|
| 854 | map(string.strip,
|
|---|
| 855 | filter(len, args)),
|
|---|
| 856 | '-')
|
|---|
| 857 |
|
|---|
| 858 | # Cleanup some possible filename obstacles...
|
|---|
| 859 | replace = string.replace
|
|---|
| 860 | platform = replace(platform,' ','_')
|
|---|
| 861 | platform = replace(platform,'/','-')
|
|---|
| 862 | platform = replace(platform,'\\','-')
|
|---|
| 863 | platform = replace(platform,':','-')
|
|---|
| 864 | platform = replace(platform,';','-')
|
|---|
| 865 | platform = replace(platform,'"','-')
|
|---|
| 866 | platform = replace(platform,'(','-')
|
|---|
| 867 | platform = replace(platform,')','-')
|
|---|
| 868 |
|
|---|
| 869 | # No need to report 'unknown' information...
|
|---|
| 870 | platform = replace(platform,'unknown','')
|
|---|
| 871 |
|
|---|
| 872 | # Fold '--'s and remove trailing '-'
|
|---|
| 873 | while 1:
|
|---|
| 874 | cleaned = replace(platform,'--','-')
|
|---|
| 875 | if cleaned == platform:
|
|---|
| 876 | break
|
|---|
| 877 | platform = cleaned
|
|---|
| 878 | while platform[-1] == '-':
|
|---|
| 879 | platform = platform[:-1]
|
|---|
| 880 |
|
|---|
| 881 | return platform
|
|---|
| 882 |
|
|---|
| 883 | def _node(default=''):
|
|---|
| 884 |
|
|---|
| 885 | """ Helper to determine the node name of this machine.
|
|---|
| 886 | """
|
|---|
| 887 | try:
|
|---|
| 888 | import socket
|
|---|
| 889 | except ImportError:
|
|---|
| 890 | # No sockets...
|
|---|
| 891 | return default
|
|---|
| 892 | try:
|
|---|
| 893 | return socket.gethostname()
|
|---|
| 894 | except socket.error:
|
|---|
| 895 | # Still not working...
|
|---|
| 896 | return default
|
|---|
| 897 |
|
|---|
| 898 | # os.path.abspath is new in Python 1.5.2:
|
|---|
| 899 | if not hasattr(os.path,'abspath'):
|
|---|
| 900 |
|
|---|
| 901 | def _abspath(path,
|
|---|
| 902 |
|
|---|
| 903 | isabs=os.path.isabs,join=os.path.join,getcwd=os.getcwd,
|
|---|
| 904 | normpath=os.path.normpath):
|
|---|
| 905 |
|
|---|
| 906 | if not isabs(path):
|
|---|
| 907 | path = join(getcwd(), path)
|
|---|
| 908 | return normpath(path)
|
|---|
| 909 |
|
|---|
| 910 | else:
|
|---|
| 911 |
|
|---|
| 912 | _abspath = os.path.abspath
|
|---|
| 913 |
|
|---|
| 914 | def _follow_symlinks(filepath):
|
|---|
| 915 |
|
|---|
| 916 | """ In case filepath is a symlink, follow it until a
|
|---|
| 917 | real file is reached.
|
|---|
| 918 | """
|
|---|
| 919 | filepath = _abspath(filepath)
|
|---|
| 920 | while os.path.islink(filepath):
|
|---|
| 921 | filepath = os.path.normpath(
|
|---|
| 922 | os.path.join(os.path.dirname(filepath),os.readlink(filepath)))
|
|---|
| 923 | return filepath
|
|---|
| 924 |
|
|---|
| 925 | def _syscmd_uname(option,default=''):
|
|---|
| 926 |
|
|---|
| 927 | """ Interface to the system's uname command.
|
|---|
| 928 | """
|
|---|
| 929 | if sys.platform in ('dos','win32','win16','os2'):
|
|---|
| 930 | # XXX Others too ?
|
|---|
| 931 | return default
|
|---|
| 932 | try:
|
|---|
| 933 | f = os.popen('uname %s 2> /dev/null' % option)
|
|---|
| 934 | except (AttributeError,os.error):
|
|---|
| 935 | return default
|
|---|
| 936 | output = string.strip(f.read())
|
|---|
| 937 | rc = f.close()
|
|---|
| 938 | if not output or rc:
|
|---|
| 939 | return default
|
|---|
| 940 | else:
|
|---|
| 941 | return output
|
|---|
| 942 |
|
|---|
| 943 | def _syscmd_file(target,default=''):
|
|---|
| 944 |
|
|---|
| 945 | """ Interface to the system's file command.
|
|---|
| 946 |
|
|---|
| 947 | The function uses the -b option of the file command to have it
|
|---|
| 948 | ommit the filename in its output and if possible the -L option
|
|---|
| 949 | to have the command follow symlinks. It returns default in
|
|---|
| 950 | case the command should fail.
|
|---|
| 951 |
|
|---|
| 952 | """
|
|---|
| 953 | if sys.platform in ('dos','win32','win16','os2'):
|
|---|
| 954 | # XXX Others too ?
|
|---|
| 955 | return default
|
|---|
| 956 | target = _follow_symlinks(target)
|
|---|
| 957 | try:
|
|---|
| 958 | f = os.popen('file "%s" 2> /dev/null' % target)
|
|---|
| 959 | except (AttributeError,os.error):
|
|---|
| 960 | return default
|
|---|
| 961 | output = string.strip(f.read())
|
|---|
| 962 | rc = f.close()
|
|---|
| 963 | if not output or rc:
|
|---|
| 964 | return default
|
|---|
| 965 | else:
|
|---|
| 966 | return output
|
|---|
| 967 |
|
|---|
| 968 | ### Information about the used architecture
|
|---|
| 969 |
|
|---|
| 970 | # Default values for architecture; non-empty strings override the
|
|---|
| 971 | # defaults given as parameters
|
|---|
| 972 | _default_architecture = {
|
|---|
| 973 | 'win32': ('','WindowsPE'),
|
|---|
| 974 | 'win16': ('','Windows'),
|
|---|
| 975 | 'dos': ('','MSDOS'),
|
|---|
| 976 | }
|
|---|
| 977 |
|
|---|
| 978 | _architecture_split = re.compile(r'[\s,]').split
|
|---|
| 979 |
|
|---|
| 980 | def architecture(executable=sys.executable,bits='',linkage=''):
|
|---|
| 981 |
|
|---|
| 982 | """ Queries the given executable (defaults to the Python interpreter
|
|---|
| 983 | binary) for various architecture information.
|
|---|
| 984 |
|
|---|
| 985 | Returns a tuple (bits,linkage) which contains information about
|
|---|
| 986 | the bit architecture and the linkage format used for the
|
|---|
| 987 | executable. Both values are returned as strings.
|
|---|
| 988 |
|
|---|
| 989 | Values that cannot be determined are returned as given by the
|
|---|
| 990 | parameter presets. If bits is given as '', the sizeof(pointer)
|
|---|
| 991 | (or sizeof(long) on Python version < 1.5.2) is used as
|
|---|
| 992 | indicator for the supported pointer size.
|
|---|
| 993 |
|
|---|
| 994 | The function relies on the system's "file" command to do the
|
|---|
| 995 | actual work. This is available on most if not all Unix
|
|---|
| 996 | platforms. On some non-Unix platforms where the "file" command
|
|---|
| 997 | does not exist and the executable is set to the Python interpreter
|
|---|
| 998 | binary defaults from _default_architecture are used.
|
|---|
| 999 |
|
|---|
| 1000 | """
|
|---|
| 1001 | # Use the sizeof(pointer) as default number of bits if nothing
|
|---|
| 1002 | # else is given as default.
|
|---|
| 1003 | if not bits:
|
|---|
| 1004 | import struct
|
|---|
| 1005 | try:
|
|---|
| 1006 | size = struct.calcsize('P')
|
|---|
| 1007 | except struct.error:
|
|---|
| 1008 | # Older installations can only query longs
|
|---|
| 1009 | size = struct.calcsize('l')
|
|---|
| 1010 | bits = str(size*8) + 'bit'
|
|---|
| 1011 |
|
|---|
| 1012 | # Get data from the 'file' system command
|
|---|
| 1013 | if executable:
|
|---|
| 1014 | output = _syscmd_file(executable, '')
|
|---|
| 1015 | else:
|
|---|
| 1016 | output = ''
|
|---|
| 1017 |
|
|---|
| 1018 | if not output and \
|
|---|
| 1019 | executable == sys.executable:
|
|---|
| 1020 | # "file" command did not return anything; we'll try to provide
|
|---|
| 1021 | # some sensible defaults then...
|
|---|
| 1022 | if _default_architecture.has_key(sys.platform):
|
|---|
| 1023 | b,l = _default_architecture[sys.platform]
|
|---|
| 1024 | if b:
|
|---|
| 1025 | bits = b
|
|---|
| 1026 | if l:
|
|---|
| 1027 | linkage = l
|
|---|
| 1028 | return bits,linkage
|
|---|
| 1029 |
|
|---|
| 1030 | # Split the output into a list of strings omitting the filename
|
|---|
| 1031 | fileout = _architecture_split(output)[1:]
|
|---|
| 1032 |
|
|---|
| 1033 | if 'executable' not in fileout:
|
|---|
| 1034 | # Format not supported
|
|---|
| 1035 | return bits,linkage
|
|---|
| 1036 |
|
|---|
| 1037 | # Bits
|
|---|
| 1038 | if '32-bit' in fileout:
|
|---|
| 1039 | bits = '32bit'
|
|---|
| 1040 | elif 'N32' in fileout:
|
|---|
| 1041 | # On Irix only
|
|---|
| 1042 | bits = 'n32bit'
|
|---|
| 1043 | elif '64-bit' in fileout:
|
|---|
| 1044 | bits = '64bit'
|
|---|
| 1045 |
|
|---|
| 1046 | # Linkage
|
|---|
| 1047 | if 'ELF' in fileout:
|
|---|
| 1048 | linkage = 'ELF'
|
|---|
| 1049 | elif 'PE' in fileout:
|
|---|
| 1050 | # E.g. Windows uses this format
|
|---|
| 1051 | if 'Windows' in fileout:
|
|---|
| 1052 | linkage = 'WindowsPE'
|
|---|
| 1053 | else:
|
|---|
| 1054 | linkage = 'PE'
|
|---|
| 1055 | elif 'COFF' in fileout:
|
|---|
| 1056 | linkage = 'COFF'
|
|---|
| 1057 | elif 'MS-DOS' in fileout:
|
|---|
| 1058 | linkage = 'MSDOS'
|
|---|
| 1059 | else:
|
|---|
| 1060 | # XXX the A.OUT format also falls under this class...
|
|---|
| 1061 | pass
|
|---|
| 1062 |
|
|---|
| 1063 | return bits,linkage
|
|---|
| 1064 |
|
|---|
| 1065 | ### Portable uname() interface
|
|---|
| 1066 |
|
|---|
| 1067 | _uname_cache = None
|
|---|
| 1068 |
|
|---|
| 1069 | def uname():
|
|---|
| 1070 |
|
|---|
| 1071 | """ Fairly portable uname interface. Returns a tuple
|
|---|
| 1072 | of strings (system,node,release,version,machine,processor)
|
|---|
| 1073 | identifying the underlying platform.
|
|---|
| 1074 |
|
|---|
| 1075 | Note that unlike the os.uname function this also returns
|
|---|
| 1076 | possible processor information as an additional tuple entry.
|
|---|
| 1077 |
|
|---|
| 1078 | Entries which cannot be determined are set to ''.
|
|---|
| 1079 |
|
|---|
| 1080 | """
|
|---|
| 1081 | global _uname_cache
|
|---|
| 1082 | no_os_uname = 0
|
|---|
| 1083 |
|
|---|
| 1084 | if _uname_cache is not None:
|
|---|
| 1085 | return _uname_cache
|
|---|
| 1086 |
|
|---|
| 1087 | processor = ''
|
|---|
| 1088 |
|
|---|
| 1089 | # Get some infos from the builtin os.uname API...
|
|---|
| 1090 | try:
|
|---|
| 1091 | system,node,release,version,machine = os.uname()
|
|---|
| 1092 | except AttributeError:
|
|---|
| 1093 | no_os_uname = 1
|
|---|
| 1094 |
|
|---|
| 1095 | if no_os_uname or not filter(None, (system, node, release, version, machine)):
|
|---|
| 1096 | # Hmm, no there is either no uname or uname has returned
|
|---|
| 1097 | #'unknowns'... we'll have to poke around the system then.
|
|---|
| 1098 | if no_os_uname:
|
|---|
| 1099 | system = sys.platform
|
|---|
| 1100 | release = ''
|
|---|
| 1101 | version = ''
|
|---|
| 1102 | node = _node()
|
|---|
| 1103 | machine = ''
|
|---|
| 1104 |
|
|---|
| 1105 | use_syscmd_ver = 01
|
|---|
| 1106 |
|
|---|
| 1107 | # Try win32_ver() on win32 platforms
|
|---|
| 1108 | if system == 'win32':
|
|---|
| 1109 | release,version,csd,ptype = win32_ver()
|
|---|
| 1110 | if release and version:
|
|---|
| 1111 | use_syscmd_ver = 0
|
|---|
| 1112 | # Try to use the PROCESSOR_* environment variables
|
|---|
| 1113 | # available on Win XP and later; see
|
|---|
| 1114 | # http://support.microsoft.com/kb/888731 and
|
|---|
| 1115 | # http://www.geocities.com/rick_lively/MANUALS/ENV/MSWIN/PROCESSI.HTM
|
|---|
| 1116 | if not machine:
|
|---|
| 1117 | machine = os.environ.get('PROCESSOR_ARCHITECTURE', '')
|
|---|
| 1118 | if not processor:
|
|---|
| 1119 | processor = os.environ.get('PROCESSOR_IDENTIFIER', machine)
|
|---|
| 1120 |
|
|---|
| 1121 | # Try the 'ver' system command available on some
|
|---|
| 1122 | # platforms
|
|---|
| 1123 | if use_syscmd_ver:
|
|---|
| 1124 | system,release,version = _syscmd_ver(system)
|
|---|
| 1125 | # Normalize system to what win32_ver() normally returns
|
|---|
| 1126 | # (_syscmd_ver() tends to return the vendor name as well)
|
|---|
| 1127 | if system == 'Microsoft Windows':
|
|---|
| 1128 | system = 'Windows'
|
|---|
| 1129 | elif system == 'Microsoft' and release == 'Windows':
|
|---|
| 1130 | # Under Windows Vista and Windows Server 2008,
|
|---|
| 1131 | # Microsoft changed the output of the ver command. The
|
|---|
| 1132 | # release is no longer printed. This causes the
|
|---|
| 1133 | # system and release to be misidentified.
|
|---|
| 1134 | system = 'Windows'
|
|---|
| 1135 | if '6.0' == version[:3]:
|
|---|
| 1136 | release = 'Vista'
|
|---|
| 1137 | else:
|
|---|
| 1138 | release = ''
|
|---|
| 1139 |
|
|---|
| 1140 | # In case we still don't know anything useful, we'll try to
|
|---|
| 1141 | # help ourselves
|
|---|
| 1142 | if system in ('win32','win16'):
|
|---|
| 1143 | if not version:
|
|---|
| 1144 | if system == 'win32':
|
|---|
| 1145 | version = '32bit'
|
|---|
| 1146 | else:
|
|---|
| 1147 | version = '16bit'
|
|---|
| 1148 | system = 'Windows'
|
|---|
| 1149 |
|
|---|
| 1150 | elif system[:4] == 'java':
|
|---|
| 1151 | release,vendor,vminfo,osinfo = java_ver()
|
|---|
| 1152 | system = 'Java'
|
|---|
| 1153 | version = string.join(vminfo,', ')
|
|---|
| 1154 | if not version:
|
|---|
| 1155 | version = vendor
|
|---|
| 1156 |
|
|---|
| 1157 | elif os.name == 'mac':
|
|---|
| 1158 | release,(version,stage,nonrel),machine = mac_ver()
|
|---|
| 1159 | system = 'MacOS'
|
|---|
| 1160 |
|
|---|
| 1161 | # System specific extensions
|
|---|
| 1162 | if system == 'OpenVMS':
|
|---|
| 1163 | # OpenVMS seems to have release and version mixed up
|
|---|
| 1164 | if not release or release == '0':
|
|---|
| 1165 | release = version
|
|---|
| 1166 | version = ''
|
|---|
| 1167 | # Get processor information
|
|---|
| 1168 | try:
|
|---|
| 1169 | import vms_lib
|
|---|
| 1170 | except ImportError:
|
|---|
| 1171 | pass
|
|---|
| 1172 | else:
|
|---|
| 1173 | csid, cpu_number = vms_lib.getsyi('SYI$_CPU',0)
|
|---|
| 1174 | if (cpu_number >= 128):
|
|---|
| 1175 | processor = 'Alpha'
|
|---|
| 1176 | else:
|
|---|
| 1177 | processor = 'VAX'
|
|---|
| 1178 | if not processor:
|
|---|
| 1179 | # Get processor information from the uname system command
|
|---|
| 1180 | processor = _syscmd_uname('-p','')
|
|---|
| 1181 |
|
|---|
| 1182 | #If any unknowns still exist, replace them with ''s, which are more portable
|
|---|
| 1183 | if system == 'unknown':
|
|---|
| 1184 | system = ''
|
|---|
| 1185 | if node == 'unknown':
|
|---|
| 1186 | node = ''
|
|---|
| 1187 | if release == 'unknown':
|
|---|
| 1188 | release = ''
|
|---|
| 1189 | if version == 'unknown':
|
|---|
| 1190 | version = ''
|
|---|
| 1191 | if machine == 'unknown':
|
|---|
| 1192 | machine = ''
|
|---|
| 1193 | if processor == 'unknown':
|
|---|
| 1194 | processor = ''
|
|---|
| 1195 |
|
|---|
| 1196 | # normalize name
|
|---|
| 1197 | if system == 'Microsoft' and release == 'Windows':
|
|---|
| 1198 | system = 'Windows'
|
|---|
| 1199 | release = 'Vista'
|
|---|
| 1200 |
|
|---|
| 1201 | _uname_cache = system,node,release,version,machine,processor
|
|---|
| 1202 | return _uname_cache
|
|---|
| 1203 |
|
|---|
| 1204 | ### Direct interfaces to some of the uname() return values
|
|---|
| 1205 |
|
|---|
| 1206 | def system():
|
|---|
| 1207 |
|
|---|
| 1208 | """ Returns the system/OS name, e.g. 'Linux', 'Windows' or 'Java'.
|
|---|
| 1209 |
|
|---|
| 1210 | An empty string is returned if the value cannot be determined.
|
|---|
| 1211 |
|
|---|
| 1212 | """
|
|---|
| 1213 | return uname()[0]
|
|---|
| 1214 |
|
|---|
| 1215 | def node():
|
|---|
| 1216 |
|
|---|
| 1217 | """ Returns the computer's network name (which may not be fully
|
|---|
| 1218 | qualified)
|
|---|
| 1219 |
|
|---|
| 1220 | An empty string is returned if the value cannot be determined.
|
|---|
| 1221 |
|
|---|
| 1222 | """
|
|---|
| 1223 | return uname()[1]
|
|---|
| 1224 |
|
|---|
| 1225 | def release():
|
|---|
| 1226 |
|
|---|
| 1227 | """ Returns the system's release, e.g. '2.2.0' or 'NT'
|
|---|
| 1228 |
|
|---|
| 1229 | An empty string is returned if the value cannot be determined.
|
|---|
| 1230 |
|
|---|
| 1231 | """
|
|---|
| 1232 | return uname()[2]
|
|---|
| 1233 |
|
|---|
| 1234 | def version():
|
|---|
| 1235 |
|
|---|
| 1236 | """ Returns the system's release version, e.g. '#3 on degas'
|
|---|
| 1237 |
|
|---|
| 1238 | An empty string is returned if the value cannot be determined.
|
|---|
| 1239 |
|
|---|
| 1240 | """
|
|---|
| 1241 | return uname()[3]
|
|---|
| 1242 |
|
|---|
| 1243 | def machine():
|
|---|
| 1244 |
|
|---|
| 1245 | """ Returns the machine type, e.g. 'i386'
|
|---|
| 1246 |
|
|---|
| 1247 | An empty string is returned if the value cannot be determined.
|
|---|
| 1248 |
|
|---|
| 1249 | """
|
|---|
| 1250 | return uname()[4]
|
|---|
| 1251 |
|
|---|
| 1252 | def processor():
|
|---|
| 1253 |
|
|---|
| 1254 | """ Returns the (true) processor name, e.g. 'amdk6'
|
|---|
| 1255 |
|
|---|
| 1256 | An empty string is returned if the value cannot be
|
|---|
| 1257 | determined. Note that many platforms do not provide this
|
|---|
| 1258 | information or simply return the same value as for machine(),
|
|---|
| 1259 | e.g. NetBSD does this.
|
|---|
| 1260 |
|
|---|
| 1261 | """
|
|---|
| 1262 | return uname()[5]
|
|---|
| 1263 |
|
|---|
| 1264 | ### Various APIs for extracting information from sys.version
|
|---|
| 1265 |
|
|---|
| 1266 | _sys_version_parser = re.compile(
|
|---|
| 1267 | r'([\w.+]+)\s*'
|
|---|
| 1268 | '\(#?([^,]+),\s*([\w ]+),\s*([\w :]+)\)\s*'
|
|---|
| 1269 | '\[([^\]]+)\]?')
|
|---|
| 1270 |
|
|---|
| 1271 | _jython_sys_version_parser = re.compile(
|
|---|
| 1272 | r'([\d\.]+)')
|
|---|
| 1273 |
|
|---|
| 1274 | _ironpython_sys_version_parser = re.compile(
|
|---|
| 1275 | r'IronPython\s*'
|
|---|
| 1276 | '([\d\.]+)'
|
|---|
| 1277 | '(?: \(([\d\.]+)\))?'
|
|---|
| 1278 | ' on (.NET [\d\.]+)')
|
|---|
| 1279 |
|
|---|
| 1280 | _sys_version_cache = {}
|
|---|
| 1281 |
|
|---|
| 1282 | def _sys_version(sys_version=None):
|
|---|
| 1283 |
|
|---|
| 1284 | """ Returns a parsed version of Python's sys.version as tuple
|
|---|
| 1285 | (name, version, branch, revision, buildno, builddate, compiler)
|
|---|
| 1286 | referring to the Python implementation name, version, branch,
|
|---|
| 1287 | revision, build number, build date/time as string and the compiler
|
|---|
| 1288 | identification string.
|
|---|
| 1289 |
|
|---|
| 1290 | Note that unlike the Python sys.version, the returned value
|
|---|
| 1291 | for the Python version will always include the patchlevel (it
|
|---|
| 1292 | defaults to '.0').
|
|---|
| 1293 |
|
|---|
| 1294 | The function returns empty strings for tuple entries that
|
|---|
| 1295 | cannot be determined.
|
|---|
| 1296 |
|
|---|
| 1297 | sys_version may be given to parse an alternative version
|
|---|
| 1298 | string, e.g. if the version was read from a different Python
|
|---|
| 1299 | interpreter.
|
|---|
| 1300 |
|
|---|
| 1301 | """
|
|---|
| 1302 | # Get the Python version
|
|---|
| 1303 | if sys_version is None:
|
|---|
| 1304 | sys_version = sys.version
|
|---|
| 1305 |
|
|---|
| 1306 | # Try the cache first
|
|---|
| 1307 | result = _sys_version_cache.get(sys_version, None)
|
|---|
| 1308 | if result is not None:
|
|---|
| 1309 | return result
|
|---|
| 1310 |
|
|---|
| 1311 | # Parse it
|
|---|
| 1312 | if sys_version[:10] == 'IronPython':
|
|---|
| 1313 | # IronPython
|
|---|
| 1314 | name = 'IronPython'
|
|---|
| 1315 | match = _ironpython_sys_version_parser.match(sys_version)
|
|---|
| 1316 | if match is None:
|
|---|
| 1317 | raise ValueError(
|
|---|
| 1318 | 'failed to parse IronPython sys.version: %s' %
|
|---|
| 1319 | repr(sys_version))
|
|---|
| 1320 | version, alt_version, compiler = match.groups()
|
|---|
| 1321 | branch = ''
|
|---|
| 1322 | revision = ''
|
|---|
| 1323 | buildno = ''
|
|---|
| 1324 | builddate = ''
|
|---|
| 1325 |
|
|---|
| 1326 | elif sys.platform[:4] == 'java':
|
|---|
| 1327 | # Jython
|
|---|
| 1328 | name = 'Jython'
|
|---|
| 1329 | match = _jython_sys_version_parser.match(sys_version)
|
|---|
| 1330 | if match is None:
|
|---|
| 1331 | raise ValueError(
|
|---|
| 1332 | 'failed to parse Jython sys.version: %s' %
|
|---|
| 1333 | repr(sys_version))
|
|---|
| 1334 | version, = match.groups()
|
|---|
| 1335 | branch = ''
|
|---|
| 1336 | revision = ''
|
|---|
| 1337 | compiler = sys.platform
|
|---|
| 1338 | buildno = ''
|
|---|
| 1339 | builddate = ''
|
|---|
| 1340 |
|
|---|
| 1341 | else:
|
|---|
| 1342 | # CPython
|
|---|
| 1343 | match = _sys_version_parser.match(sys_version)
|
|---|
| 1344 | if match is None:
|
|---|
| 1345 | raise ValueError(
|
|---|
| 1346 | 'failed to parse CPython sys.version: %s' %
|
|---|
| 1347 | repr(sys_version))
|
|---|
| 1348 | version, buildno, builddate, buildtime, compiler = \
|
|---|
| 1349 | match.groups()
|
|---|
| 1350 | if hasattr(sys, 'subversion'):
|
|---|
| 1351 | # sys.subversion was added in Python 2.5
|
|---|
| 1352 | name, branch, revision = sys.subversion
|
|---|
| 1353 | else:
|
|---|
| 1354 | name = 'CPython'
|
|---|
| 1355 | branch = ''
|
|---|
| 1356 | revision = ''
|
|---|
| 1357 | builddate = builddate + ' ' + buildtime
|
|---|
| 1358 |
|
|---|
| 1359 | # Add the patchlevel version if missing
|
|---|
| 1360 | l = string.split(version, '.')
|
|---|
| 1361 | if len(l) == 2:
|
|---|
| 1362 | l.append('0')
|
|---|
| 1363 | version = string.join(l, '.')
|
|---|
| 1364 |
|
|---|
| 1365 | # Build and cache the result
|
|---|
| 1366 | result = (name, version, branch, revision, buildno, builddate, compiler)
|
|---|
| 1367 | _sys_version_cache[sys_version] = result
|
|---|
| 1368 | return result
|
|---|
| 1369 |
|
|---|
| 1370 | def _test_sys_version():
|
|---|
| 1371 |
|
|---|
| 1372 | _sys_version_cache.clear()
|
|---|
| 1373 | for input, output in (
|
|---|
| 1374 | ('2.4.3 (#1, Jun 21 2006, 13:54:21) \n[GCC 3.3.4 (pre 3.3.5 20040809)]',
|
|---|
| 1375 | ('CPython', '2.4.3', '', '', '1', 'Jun 21 2006 13:54:21', 'GCC 3.3.4 (pre 3.3.5 20040809)')),
|
|---|
| 1376 | ('IronPython 1.0.60816 on .NET 2.0.50727.42',
|
|---|
| 1377 | ('IronPython', '1.0.60816', '', '', '', '', '.NET 2.0.50727.42')),
|
|---|
| 1378 | ('IronPython 1.0 (1.0.61005.1977) on .NET 2.0.50727.42',
|
|---|
| 1379 | ('IronPython', '1.0.0', '', '', '', '', '.NET 2.0.50727.42')),
|
|---|
| 1380 | ):
|
|---|
| 1381 | parsed = _sys_version(input)
|
|---|
| 1382 | if parsed != output:
|
|---|
| 1383 | print (input, parsed)
|
|---|
| 1384 |
|
|---|
| 1385 | def python_implementation():
|
|---|
| 1386 |
|
|---|
| 1387 | """ Returns a string identifying the Python implementation.
|
|---|
| 1388 |
|
|---|
| 1389 | Currently, the following implementations are identified:
|
|---|
| 1390 | 'CPython' (C implementation of Python),
|
|---|
| 1391 | 'IronPython' (.NET implementation of Python),
|
|---|
| 1392 | 'Jython' (Java implementation of Python).
|
|---|
| 1393 |
|
|---|
| 1394 | """
|
|---|
| 1395 | return _sys_version()[0]
|
|---|
| 1396 |
|
|---|
| 1397 | def python_version():
|
|---|
| 1398 |
|
|---|
| 1399 | """ Returns the Python version as string 'major.minor.patchlevel'
|
|---|
| 1400 |
|
|---|
| 1401 | Note that unlike the Python sys.version, the returned value
|
|---|
| 1402 | will always include the patchlevel (it defaults to 0).
|
|---|
| 1403 |
|
|---|
| 1404 | """
|
|---|
| 1405 | return _sys_version()[1]
|
|---|
| 1406 |
|
|---|
| 1407 | def python_version_tuple():
|
|---|
| 1408 |
|
|---|
| 1409 | """ Returns the Python version as tuple (major, minor, patchlevel)
|
|---|
| 1410 | of strings.
|
|---|
| 1411 |
|
|---|
| 1412 | Note that unlike the Python sys.version, the returned value
|
|---|
| 1413 | will always include the patchlevel (it defaults to 0).
|
|---|
| 1414 |
|
|---|
| 1415 | """
|
|---|
| 1416 | return tuple(string.split(_sys_version()[1], '.'))
|
|---|
| 1417 |
|
|---|
| 1418 | def python_branch():
|
|---|
| 1419 |
|
|---|
| 1420 | """ Returns a string identifying the Python implementation
|
|---|
| 1421 | branch.
|
|---|
| 1422 |
|
|---|
| 1423 | For CPython this is the Subversion branch from which the
|
|---|
| 1424 | Python binary was built.
|
|---|
| 1425 |
|
|---|
| 1426 | If not available, an empty string is returned.
|
|---|
| 1427 |
|
|---|
| 1428 | """
|
|---|
| 1429 |
|
|---|
| 1430 | return _sys_version()[2]
|
|---|
| 1431 |
|
|---|
| 1432 | def python_revision():
|
|---|
| 1433 |
|
|---|
| 1434 | """ Returns a string identifying the Python implementation
|
|---|
| 1435 | revision.
|
|---|
| 1436 |
|
|---|
| 1437 | For CPython this is the Subversion revision from which the
|
|---|
| 1438 | Python binary was built.
|
|---|
| 1439 |
|
|---|
| 1440 | If not available, an empty string is returned.
|
|---|
| 1441 |
|
|---|
| 1442 | """
|
|---|
| 1443 | return _sys_version()[3]
|
|---|
| 1444 |
|
|---|
| 1445 | def python_build():
|
|---|
| 1446 |
|
|---|
| 1447 | """ Returns a tuple (buildno, builddate) stating the Python
|
|---|
| 1448 | build number and date as strings.
|
|---|
| 1449 |
|
|---|
| 1450 | """
|
|---|
| 1451 | return _sys_version()[4:6]
|
|---|
| 1452 |
|
|---|
| 1453 | def python_compiler():
|
|---|
| 1454 |
|
|---|
| 1455 | """ Returns a string identifying the compiler used for compiling
|
|---|
| 1456 | Python.
|
|---|
| 1457 |
|
|---|
| 1458 | """
|
|---|
| 1459 | return _sys_version()[6]
|
|---|
| 1460 |
|
|---|
| 1461 | ### The Opus Magnum of platform strings :-)
|
|---|
| 1462 |
|
|---|
| 1463 | _platform_cache = {}
|
|---|
| 1464 |
|
|---|
| 1465 | def platform(aliased=0, terse=0):
|
|---|
| 1466 |
|
|---|
| 1467 | """ Returns a single string identifying the underlying platform
|
|---|
| 1468 | with as much useful information as possible (but no more :).
|
|---|
| 1469 |
|
|---|
| 1470 | The output is intended to be human readable rather than
|
|---|
| 1471 | machine parseable. It may look different on different
|
|---|
| 1472 | platforms and this is intended.
|
|---|
| 1473 |
|
|---|
| 1474 | If "aliased" is true, the function will use aliases for
|
|---|
| 1475 | various platforms that report system names which differ from
|
|---|
| 1476 | their common names, e.g. SunOS will be reported as
|
|---|
| 1477 | Solaris. The system_alias() function is used to implement
|
|---|
| 1478 | this.
|
|---|
| 1479 |
|
|---|
| 1480 | Setting terse to true causes the function to return only the
|
|---|
| 1481 | absolute minimum information needed to identify the platform.
|
|---|
| 1482 |
|
|---|
| 1483 | """
|
|---|
| 1484 | result = _platform_cache.get((aliased, terse), None)
|
|---|
| 1485 | if result is not None:
|
|---|
| 1486 | return result
|
|---|
| 1487 |
|
|---|
| 1488 | # Get uname information and then apply platform specific cosmetics
|
|---|
| 1489 | # to it...
|
|---|
| 1490 | system,node,release,version,machine,processor = uname()
|
|---|
| 1491 | if machine == processor:
|
|---|
| 1492 | processor = ''
|
|---|
| 1493 | if aliased:
|
|---|
| 1494 | system,release,version = system_alias(system,release,version)
|
|---|
| 1495 |
|
|---|
| 1496 | if system == 'Windows':
|
|---|
| 1497 | # MS platforms
|
|---|
| 1498 | rel,vers,csd,ptype = win32_ver(version)
|
|---|
| 1499 | if terse:
|
|---|
| 1500 | platform = _platform(system,release)
|
|---|
| 1501 | else:
|
|---|
| 1502 | platform = _platform(system,release,version,csd)
|
|---|
| 1503 |
|
|---|
| 1504 | elif system in ('Linux',):
|
|---|
| 1505 | # Linux based systems
|
|---|
| 1506 | distname,distversion,distid = dist('')
|
|---|
| 1507 | if distname and not terse:
|
|---|
| 1508 | platform = _platform(system,release,machine,processor,
|
|---|
| 1509 | 'with',
|
|---|
| 1510 | distname,distversion,distid)
|
|---|
| 1511 | else:
|
|---|
| 1512 | # If the distribution name is unknown check for libc vs. glibc
|
|---|
| 1513 | libcname,libcversion = libc_ver(sys.executable)
|
|---|
| 1514 | platform = _platform(system,release,machine,processor,
|
|---|
| 1515 | 'with',
|
|---|
| 1516 | libcname+libcversion)
|
|---|
| 1517 | elif system == 'Java':
|
|---|
| 1518 | # Java platforms
|
|---|
| 1519 | r,v,vminfo,(os_name,os_version,os_arch) = java_ver()
|
|---|
| 1520 | if terse or not os_name:
|
|---|
| 1521 | platform = _platform(system,release,version)
|
|---|
| 1522 | else:
|
|---|
| 1523 | platform = _platform(system,release,version,
|
|---|
| 1524 | 'on',
|
|---|
| 1525 | os_name,os_version,os_arch)
|
|---|
| 1526 |
|
|---|
| 1527 | elif system == 'MacOS':
|
|---|
| 1528 | # MacOS platforms
|
|---|
| 1529 | if terse:
|
|---|
| 1530 | platform = _platform(system,release)
|
|---|
| 1531 | else:
|
|---|
| 1532 | platform = _platform(system,release,machine)
|
|---|
| 1533 |
|
|---|
| 1534 | else:
|
|---|
| 1535 | # Generic handler
|
|---|
| 1536 | if terse:
|
|---|
| 1537 | platform = _platform(system,release)
|
|---|
| 1538 | else:
|
|---|
| 1539 | bits,linkage = architecture(sys.executable)
|
|---|
| 1540 | platform = _platform(system,release,machine,processor,bits,linkage)
|
|---|
| 1541 |
|
|---|
| 1542 | _platform_cache[(aliased, terse)] = platform
|
|---|
| 1543 | return platform
|
|---|
| 1544 |
|
|---|
| 1545 | ### Command line interface
|
|---|
| 1546 |
|
|---|
| 1547 | if __name__ == '__main__':
|
|---|
| 1548 | # Default is to print the aliased verbose platform string
|
|---|
| 1549 | terse = ('terse' in sys.argv or '--terse' in sys.argv)
|
|---|
| 1550 | aliased = (not 'nonaliased' in sys.argv and not '--nonaliased' in sys.argv)
|
|---|
| 1551 | print platform(aliased,terse)
|
|---|
| 1552 | sys.exit(0)
|
|---|
