2011-09-10 11:13:51 +02:00
|
|
|
#!/usr/bin/env python
|
|
|
|
# encoding: utf-8
|
|
|
|
# Thomas Nagy, 2005-2010 (ita)
|
|
|
|
|
|
|
|
"""
|
|
|
|
Utilities and platform-specific fixes
|
|
|
|
|
|
|
|
The portability fixes try to provide a consistent behavior of the Waf API
|
2016-02-25 20:03:07 +01:00
|
|
|
through Python versions 2.5 to 3.X and across different platforms (win32, linux, etc)
|
2011-09-10 11:13:51 +02:00
|
|
|
"""
|
|
|
|
|
2016-03-18 18:26:25 +01:00
|
|
|
import os, sys, errno, traceback, inspect, re, shutil, datetime, platform, base64
|
2016-02-25 20:03:07 +01:00
|
|
|
try:
|
|
|
|
import cPickle
|
|
|
|
except ImportError:
|
|
|
|
import pickle as cPickle
|
2016-02-10 23:46:55 +01:00
|
|
|
|
|
|
|
# leave this
|
|
|
|
if os.name == 'posix' and sys.version_info[0] < 3:
|
|
|
|
try:
|
|
|
|
import subprocess32 as subprocess
|
|
|
|
except ImportError:
|
|
|
|
import subprocess
|
|
|
|
else:
|
|
|
|
import subprocess
|
2011-09-10 11:13:51 +02:00
|
|
|
|
2014-10-04 13:49:28 +02:00
|
|
|
from collections import deque, defaultdict
|
|
|
|
|
2011-09-10 11:13:51 +02:00
|
|
|
try:
|
|
|
|
import _winreg as winreg
|
2012-02-11 13:43:47 +01:00
|
|
|
except ImportError:
|
2011-09-10 11:13:51 +02:00
|
|
|
try:
|
|
|
|
import winreg
|
2012-02-11 13:43:47 +01:00
|
|
|
except ImportError:
|
2011-09-10 11:13:51 +02:00
|
|
|
winreg = None
|
|
|
|
|
|
|
|
from waflib import Errors
|
|
|
|
|
|
|
|
try:
|
|
|
|
from hashlib import md5
|
2012-02-11 13:43:47 +01:00
|
|
|
except ImportError:
|
2011-09-10 11:13:51 +02:00
|
|
|
try:
|
|
|
|
from md5 import md5
|
2012-02-11 13:43:47 +01:00
|
|
|
except ImportError:
|
2011-09-10 11:13:51 +02:00
|
|
|
# never fail to enable fixes from another module
|
|
|
|
pass
|
|
|
|
|
|
|
|
try:
|
|
|
|
import threading
|
2012-02-11 13:43:47 +01:00
|
|
|
except ImportError:
|
2014-01-05 10:51:24 +01:00
|
|
|
if not 'JOBS' in os.environ:
|
|
|
|
# no threading :-(
|
|
|
|
os.environ['JOBS'] = '1'
|
|
|
|
|
2011-09-10 11:13:51 +02:00
|
|
|
class threading(object):
|
|
|
|
"""
|
|
|
|
A fake threading class for platforms lacking the threading module.
|
|
|
|
Use ``waf -j1`` on those platforms
|
|
|
|
"""
|
|
|
|
pass
|
|
|
|
class Lock(object):
|
|
|
|
"""Fake Lock class"""
|
|
|
|
def acquire(self):
|
|
|
|
pass
|
|
|
|
def release(self):
|
|
|
|
pass
|
|
|
|
threading.Lock = threading.Thread = Lock
|
|
|
|
else:
|
|
|
|
run_old = threading.Thread.run
|
|
|
|
def run(*args, **kwargs):
|
|
|
|
try:
|
|
|
|
run_old(*args, **kwargs)
|
|
|
|
except (KeyboardInterrupt, SystemExit):
|
|
|
|
raise
|
2012-02-11 13:43:47 +01:00
|
|
|
except Exception:
|
2011-09-10 11:13:51 +02:00
|
|
|
sys.excepthook(*sys.exc_info())
|
|
|
|
threading.Thread.run = run
|
|
|
|
|
2016-02-14 11:15:52 +01:00
|
|
|
SIG_NIL = 'SIG_NIL_SIG_NIL_'.encode()
|
|
|
|
"""Arbitrary null value for hashes. Modify this value according to the hash function in use"""
|
2011-09-10 11:13:51 +02:00
|
|
|
|
|
|
|
O644 = 420
|
|
|
|
"""Constant representing the permissions for regular files (0644 raises a syntax error on python 3)"""
|
|
|
|
|
|
|
|
O755 = 493
|
|
|
|
"""Constant representing the permissions for executable files (0755 raises a syntax error on python 3)"""
|
|
|
|
|
|
|
|
rot_chr = ['\\', '|', '/', '-']
|
|
|
|
"List of characters to use when displaying the throbber (progress bar)"
|
|
|
|
|
|
|
|
rot_idx = 0
|
|
|
|
"Index of the current throbber character (progress bar)"
|
|
|
|
|
2013-10-27 12:42:41 +01:00
|
|
|
try:
|
2013-10-28 21:05:57 +01:00
|
|
|
from collections import OrderedDict as ordered_iter_dict
|
2013-10-27 12:42:41 +01:00
|
|
|
except ImportError:
|
|
|
|
class ordered_iter_dict(dict):
|
|
|
|
def __init__(self, *k, **kw):
|
|
|
|
self.lst = []
|
|
|
|
dict.__init__(self, *k, **kw)
|
|
|
|
def clear(self):
|
|
|
|
dict.clear(self)
|
|
|
|
self.lst = []
|
|
|
|
def __setitem__(self, key, value):
|
|
|
|
dict.__setitem__(self, key, value)
|
|
|
|
try:
|
|
|
|
self.lst.remove(key)
|
|
|
|
except ValueError:
|
|
|
|
pass
|
|
|
|
self.lst.append(key)
|
|
|
|
def __delitem__(self, key):
|
|
|
|
dict.__delitem__(self, key)
|
|
|
|
try:
|
|
|
|
self.lst.remove(key)
|
|
|
|
except ValueError:
|
|
|
|
pass
|
|
|
|
def __iter__(self):
|
|
|
|
for x in self.lst:
|
|
|
|
yield x
|
|
|
|
def keys(self):
|
|
|
|
return self.lst
|
2016-02-15 00:35:06 +01:00
|
|
|
def popitem(self, last=True):
|
|
|
|
key = self.lst[last and -1 or 0]
|
|
|
|
ret = (key, dict.__getitem__(self, key))
|
|
|
|
dict.__delitem(self, key)
|
|
|
|
return ret
|
|
|
|
|
|
|
|
class lru_cache(ordered_iter_dict):
|
|
|
|
def __init__(self, maxlen=100):
|
|
|
|
ordered_iter_dict.__init__(self)
|
|
|
|
self.maxlen = maxlen
|
|
|
|
def __setitem__(self, key, value):
|
|
|
|
if len(self) > self.maxlen:
|
2016-02-15 23:23:34 +01:00
|
|
|
for i in range(int(self.maxlen * 0.15)):
|
2016-02-15 00:35:06 +01:00
|
|
|
self.popitem(last=False)
|
|
|
|
ordered_iter_dict.__setitem__(self, key, value)
|
2016-02-15 21:13:48 +01:00
|
|
|
def __getitem__(self, key):
|
2016-03-16 22:28:50 +01:00
|
|
|
ret = ordered_iter_dict.__getitem__(self, key)
|
|
|
|
ordered_iter_dict.__setitem__(self, key, ret)
|
2016-02-15 21:13:48 +01:00
|
|
|
return ret
|
2011-09-10 11:13:51 +02:00
|
|
|
|
2015-03-08 18:30:57 +01:00
|
|
|
is_win32 = os.sep == '\\' or sys.platform == 'win32' # msys2
|
2011-09-10 11:13:51 +02:00
|
|
|
|
2012-06-05 04:31:31 +02:00
|
|
|
def readf(fname, m='r', encoding='ISO8859-1'):
|
2011-09-10 11:13:51 +02:00
|
|
|
"""
|
2012-05-19 10:29:44 +02:00
|
|
|
Read an entire file into a string, use this function instead of os.open() whenever possible.
|
|
|
|
|
2012-06-05 04:31:31 +02:00
|
|
|
In practice the wrapper node.read(..) should be preferred to this function::
|
2011-09-10 11:13:51 +02:00
|
|
|
|
|
|
|
def build(ctx):
|
|
|
|
from waflib import Utils
|
|
|
|
txt = Utils.readf(self.path.find_node('wscript').abspath())
|
|
|
|
txt = ctx.path.find_node('wscript').read()
|
|
|
|
|
|
|
|
:type fname: string
|
|
|
|
:param fname: Path to file
|
|
|
|
:type m: string
|
|
|
|
:param m: Open mode
|
2012-06-05 04:31:31 +02:00
|
|
|
:type encoding: string
|
|
|
|
:param encoding: encoding value, only used for python 3
|
2011-09-10 11:13:51 +02:00
|
|
|
:rtype: string
|
|
|
|
:return: Content of the file
|
|
|
|
"""
|
2012-06-05 04:31:31 +02:00
|
|
|
|
|
|
|
if sys.hexversion > 0x3000000 and not 'b' in m:
|
|
|
|
m += 'b'
|
|
|
|
f = open(fname, m)
|
|
|
|
try:
|
|
|
|
txt = f.read()
|
|
|
|
finally:
|
|
|
|
f.close()
|
2014-09-28 01:30:00 +02:00
|
|
|
if encoding:
|
|
|
|
txt = txt.decode(encoding)
|
|
|
|
else:
|
|
|
|
txt = txt.decode()
|
2012-06-05 04:31:31 +02:00
|
|
|
else:
|
|
|
|
f = open(fname, m)
|
|
|
|
try:
|
|
|
|
txt = f.read()
|
|
|
|
finally:
|
|
|
|
f.close()
|
2011-09-10 11:13:51 +02:00
|
|
|
return txt
|
|
|
|
|
2012-06-05 04:31:31 +02:00
|
|
|
def writef(fname, data, m='w', encoding='ISO8859-1'):
|
2012-02-12 15:27:38 +01:00
|
|
|
"""
|
2012-05-19 10:29:44 +02:00
|
|
|
Write an entire file from a string, use this function instead of os.open() whenever possible.
|
|
|
|
|
2012-06-05 04:31:31 +02:00
|
|
|
In practice the wrapper node.write(..) should be preferred to this function::
|
2012-02-12 15:27:38 +01:00
|
|
|
|
|
|
|
def build(ctx):
|
|
|
|
from waflib import Utils
|
|
|
|
txt = Utils.writef(self.path.make_node('i_like_kittens').abspath(), 'some data')
|
|
|
|
self.path.make_node('i_like_kittens').write('some data')
|
|
|
|
|
|
|
|
:type fname: string
|
|
|
|
:param fname: Path to file
|
|
|
|
:type data: string
|
|
|
|
:param data: The contents to write to the file
|
|
|
|
:type m: string
|
|
|
|
:param m: Open mode
|
2012-06-05 04:31:31 +02:00
|
|
|
:type encoding: string
|
|
|
|
:param encoding: encoding value, only used for python 3
|
2012-02-12 15:27:38 +01:00
|
|
|
"""
|
2012-06-05 04:31:31 +02:00
|
|
|
if sys.hexversion > 0x3000000 and not 'b' in m:
|
|
|
|
data = data.encode(encoding)
|
|
|
|
m += 'b'
|
2012-02-12 15:27:38 +01:00
|
|
|
f = open(fname, m)
|
|
|
|
try:
|
2012-05-17 13:49:09 +02:00
|
|
|
f.write(data)
|
2012-02-12 15:27:38 +01:00
|
|
|
finally:
|
|
|
|
f.close()
|
|
|
|
|
2012-05-19 10:29:44 +02:00
|
|
|
def h_file(fname):
|
2011-09-10 11:13:51 +02:00
|
|
|
"""
|
|
|
|
Compute a hash value for a file by using md5. This method may be replaced by
|
2015-12-24 18:25:47 +01:00
|
|
|
a faster version if necessary. The following uses the file size and the timestamp value.
|
|
|
|
The performance change can be 0.858s to 0.642s on no-op builds::
|
2011-09-10 11:13:51 +02:00
|
|
|
|
|
|
|
import stat
|
|
|
|
from waflib import Utils
|
2012-05-19 10:29:44 +02:00
|
|
|
def h_file(fname):
|
|
|
|
st = os.stat(fname)
|
2016-02-28 14:23:54 +01:00
|
|
|
if stat.S_ISDIR(st[stat.ST_MODE]): raise OSError('not a file')
|
2015-12-24 18:25:47 +01:00
|
|
|
s = "%s%s%s" % (st.st_mtime, st.st_size, fname)
|
|
|
|
return Utils.md5(s.encode()).digest()
|
2011-09-10 11:13:51 +02:00
|
|
|
Utils.h_file = h_file
|
|
|
|
|
2012-05-19 10:29:44 +02:00
|
|
|
:type fname: string
|
|
|
|
:param fname: path to the file to hash
|
2011-09-10 11:13:51 +02:00
|
|
|
:return: hash of the file contents
|
|
|
|
"""
|
2012-05-19 10:29:44 +02:00
|
|
|
f = open(fname, 'rb')
|
2011-09-10 11:13:51 +02:00
|
|
|
m = md5()
|
|
|
|
try:
|
2012-05-19 10:29:44 +02:00
|
|
|
while fname:
|
|
|
|
fname = f.read(200000)
|
|
|
|
m.update(fname)
|
2011-09-10 11:13:51 +02:00
|
|
|
finally:
|
|
|
|
f.close()
|
|
|
|
return m.digest()
|
|
|
|
|
2014-04-09 22:27:17 +02:00
|
|
|
def readf_win32(f, m='r', encoding='ISO8859-1'):
|
|
|
|
flags = os.O_NOINHERIT | os.O_RDONLY
|
|
|
|
if 'b' in m:
|
|
|
|
flags |= os.O_BINARY
|
|
|
|
if '+' in m:
|
|
|
|
flags |= os.O_RDWR
|
|
|
|
try:
|
|
|
|
fd = os.open(f, flags)
|
|
|
|
except OSError:
|
|
|
|
raise IOError('Cannot read from %r' % f)
|
2012-05-19 10:29:44 +02:00
|
|
|
|
2014-04-09 22:27:17 +02:00
|
|
|
if sys.hexversion > 0x3000000 and not 'b' in m:
|
|
|
|
m += 'b'
|
2012-05-21 20:23:43 +02:00
|
|
|
f = os.fdopen(fd, m)
|
2012-05-19 10:29:44 +02:00
|
|
|
try:
|
2014-04-09 22:27:17 +02:00
|
|
|
txt = f.read()
|
2012-05-19 10:29:44 +02:00
|
|
|
finally:
|
|
|
|
f.close()
|
2014-09-28 01:30:00 +02:00
|
|
|
if encoding:
|
|
|
|
txt = txt.decode(encoding)
|
|
|
|
else:
|
|
|
|
txt = txt.decode()
|
2014-04-09 22:27:17 +02:00
|
|
|
else:
|
|
|
|
f = os.fdopen(fd, m)
|
2012-05-19 10:29:44 +02:00
|
|
|
try:
|
2014-04-09 22:27:17 +02:00
|
|
|
txt = f.read()
|
2012-05-19 10:29:44 +02:00
|
|
|
finally:
|
|
|
|
f.close()
|
2014-04-09 22:27:17 +02:00
|
|
|
return txt
|
|
|
|
|
|
|
|
def writef_win32(f, data, m='w', encoding='ISO8859-1'):
|
|
|
|
if sys.hexversion > 0x3000000 and not 'b' in m:
|
|
|
|
data = data.encode(encoding)
|
|
|
|
m += 'b'
|
|
|
|
flags = os.O_CREAT | os.O_TRUNC | os.O_WRONLY | os.O_NOINHERIT
|
|
|
|
if 'b' in m:
|
|
|
|
flags |= os.O_BINARY
|
|
|
|
if '+' in m:
|
|
|
|
flags |= os.O_RDWR
|
|
|
|
try:
|
|
|
|
fd = os.open(f, flags)
|
|
|
|
except OSError:
|
2016-02-28 14:23:54 +01:00
|
|
|
raise OSError('Cannot write to %r' % f)
|
2014-04-09 22:27:17 +02:00
|
|
|
f = os.fdopen(fd, m)
|
|
|
|
try:
|
|
|
|
f.write(data)
|
|
|
|
finally:
|
|
|
|
f.close()
|
2012-05-19 10:29:44 +02:00
|
|
|
|
2014-04-09 22:27:17 +02:00
|
|
|
def h_file_win32(fname):
|
|
|
|
try:
|
|
|
|
fd = os.open(fname, os.O_BINARY | os.O_RDONLY | os.O_NOINHERIT)
|
|
|
|
except OSError:
|
2016-02-28 14:23:54 +01:00
|
|
|
raise OSError('Cannot read from %r' % fname)
|
2014-04-09 22:27:17 +02:00
|
|
|
f = os.fdopen(fd, 'rb')
|
|
|
|
m = md5()
|
|
|
|
try:
|
|
|
|
while fname:
|
|
|
|
fname = f.read(200000)
|
|
|
|
m.update(fname)
|
|
|
|
finally:
|
|
|
|
f.close()
|
|
|
|
return m.digest()
|
|
|
|
|
|
|
|
# always save these
|
|
|
|
readf_unix = readf
|
|
|
|
writef_unix = writef
|
|
|
|
h_file_unix = h_file
|
|
|
|
if hasattr(os, 'O_NOINHERIT') and sys.hexversion < 0x3040000:
|
2012-05-19 10:29:44 +02:00
|
|
|
# replace the default functions
|
|
|
|
readf = readf_win32
|
|
|
|
writef = writef_win32
|
|
|
|
h_file = h_file_win32
|
|
|
|
|
2011-09-10 11:13:51 +02:00
|
|
|
try:
|
|
|
|
x = ''.encode('hex')
|
2012-02-11 13:43:47 +01:00
|
|
|
except LookupError:
|
2011-09-10 11:13:51 +02:00
|
|
|
import binascii
|
|
|
|
def to_hex(s):
|
|
|
|
ret = binascii.hexlify(s)
|
|
|
|
if not isinstance(ret, str):
|
|
|
|
ret = ret.decode('utf-8')
|
|
|
|
return ret
|
|
|
|
else:
|
|
|
|
def to_hex(s):
|
|
|
|
return s.encode('hex')
|
|
|
|
|
|
|
|
to_hex.__doc__ = """
|
|
|
|
Return the hexadecimal representation of a string
|
|
|
|
|
|
|
|
:param s: string to convert
|
|
|
|
:type s: string
|
|
|
|
"""
|
|
|
|
|
2014-04-09 22:27:17 +02:00
|
|
|
def listdir_win32(s):
|
|
|
|
"""
|
|
|
|
List the contents of a folder in a portable manner.
|
|
|
|
On Win32, return the list of drive letters: ['C:', 'X:', 'Z:']
|
|
|
|
|
|
|
|
:type s: string
|
|
|
|
:param s: a string, which can be empty on Windows
|
|
|
|
"""
|
|
|
|
if not s:
|
|
|
|
try:
|
|
|
|
import ctypes
|
|
|
|
except ImportError:
|
|
|
|
# there is nothing much we can do
|
2016-03-18 18:26:25 +01:00
|
|
|
return [x + ':\\' for x in 'ABCDEFGHIJKLMNOPQRSTUVWXYZ']
|
2014-04-09 22:27:17 +02:00
|
|
|
else:
|
|
|
|
dlen = 4 # length of "?:\\x00"
|
|
|
|
maxdrives = 26
|
|
|
|
buf = ctypes.create_string_buffer(maxdrives * dlen)
|
|
|
|
ndrives = ctypes.windll.kernel32.GetLogicalDriveStringsA(maxdrives*dlen, ctypes.byref(buf))
|
|
|
|
return [ str(buf.raw[4*i:4*i+2].decode('ascii')) for i in range(int(ndrives/dlen)) ]
|
|
|
|
|
|
|
|
if len(s) == 2 and s[1] == ":":
|
|
|
|
s += os.sep
|
|
|
|
|
|
|
|
if not os.path.isdir(s):
|
|
|
|
e = OSError('%s is not a directory' % s)
|
|
|
|
e.errno = errno.ENOENT
|
|
|
|
raise e
|
|
|
|
return os.listdir(s)
|
|
|
|
|
2011-09-10 11:13:51 +02:00
|
|
|
listdir = os.listdir
|
|
|
|
if is_win32:
|
|
|
|
listdir = listdir_win32
|
|
|
|
|
|
|
|
def num2ver(ver):
|
|
|
|
"""
|
|
|
|
Convert a string, tuple or version number into an integer. The number is supposed to have at most 4 digits::
|
|
|
|
|
|
|
|
from waflib.Utils import num2ver
|
|
|
|
num2ver('1.3.2') == num2ver((1,3,2)) == num2ver((1,3,2,0))
|
|
|
|
|
|
|
|
:type ver: string or tuple of numbers
|
|
|
|
:param ver: a version number
|
|
|
|
"""
|
|
|
|
if isinstance(ver, str):
|
|
|
|
ver = tuple(ver.split('.'))
|
|
|
|
if isinstance(ver, tuple):
|
|
|
|
ret = 0
|
|
|
|
for i in range(4):
|
|
|
|
if i < len(ver):
|
|
|
|
ret += 256**(3 - i) * int(ver[i])
|
|
|
|
return ret
|
|
|
|
return ver
|
|
|
|
|
|
|
|
def ex_stack():
|
|
|
|
"""
|
|
|
|
Extract the stack to display exceptions
|
2016-02-28 12:23:18 +01:00
|
|
|
Deprecated: use traceback.format_exc()
|
2011-09-10 11:13:51 +02:00
|
|
|
|
|
|
|
:return: a string represening the last exception
|
|
|
|
"""
|
2016-02-28 12:23:18 +01:00
|
|
|
# TODO remove in waf 2.0
|
|
|
|
return traceback.format_exc()
|
2011-09-10 11:13:51 +02:00
|
|
|
|
|
|
|
def to_list(sth):
|
|
|
|
"""
|
|
|
|
Convert a string argument to a list by splitting on spaces, and pass
|
|
|
|
through a list argument unchanged::
|
|
|
|
|
|
|
|
from waflib.Utils import to_list
|
|
|
|
lst = to_list("a b c d")
|
|
|
|
|
|
|
|
:param sth: List or a string of items separated by spaces
|
|
|
|
:rtype: list
|
|
|
|
:return: Argument converted to list
|
|
|
|
|
|
|
|
"""
|
|
|
|
if isinstance(sth, str):
|
|
|
|
return sth.split()
|
|
|
|
else:
|
|
|
|
return sth
|
|
|
|
|
2014-04-09 22:27:17 +02:00
|
|
|
def split_path_unix(path):
|
2011-09-10 11:13:51 +02:00
|
|
|
return path.split('/')
|
|
|
|
|
|
|
|
def split_path_cygwin(path):
|
|
|
|
if path.startswith('//'):
|
|
|
|
ret = path.split('/')[2:]
|
|
|
|
ret[0] = '/' + ret[0]
|
|
|
|
return ret
|
|
|
|
return path.split('/')
|
|
|
|
|
2016-03-27 21:41:21 +02:00
|
|
|
re_sp = re.compile('[/\\\\]+')
|
2011-09-10 11:13:51 +02:00
|
|
|
def split_path_win32(path):
|
|
|
|
if path.startswith('\\\\'):
|
2016-03-27 21:41:21 +02:00
|
|
|
ret = re_sp.split(path)[2:]
|
2011-09-10 11:13:51 +02:00
|
|
|
ret[0] = '\\' + ret[0]
|
|
|
|
return ret
|
2016-03-27 21:41:21 +02:00
|
|
|
return re_sp.split(path)
|
2011-09-10 11:13:51 +02:00
|
|
|
|
2015-10-16 22:45:27 +02:00
|
|
|
msysroot = None
|
|
|
|
def split_path_msys(path):
|
|
|
|
if (path.startswith('/') or path.startswith('\\')) and not path.startswith('//') and not path.startswith('\\\\'):
|
|
|
|
# msys paths can be in the form /usr/bin
|
|
|
|
global msysroot
|
|
|
|
if not msysroot:
|
|
|
|
# msys has python 2.7 or 3, so we can use this
|
|
|
|
msysroot = subprocess.check_output(['cygpath', '-w', '/']).decode(sys.stdout.encoding or 'iso8859-1')
|
|
|
|
msysroot = msysroot.strip()
|
|
|
|
path = os.path.normpath(msysroot + os.sep + path)
|
|
|
|
return split_path_win32(path)
|
|
|
|
|
2011-09-10 11:13:51 +02:00
|
|
|
if sys.platform == 'cygwin':
|
|
|
|
split_path = split_path_cygwin
|
|
|
|
elif is_win32:
|
2015-10-16 22:45:27 +02:00
|
|
|
if os.environ.get('MSYSTEM', None):
|
|
|
|
split_path = split_path_msys
|
|
|
|
else:
|
|
|
|
split_path = split_path_win32
|
2014-04-09 22:27:17 +02:00
|
|
|
else:
|
|
|
|
split_path = split_path_unix
|
2011-09-10 11:13:51 +02:00
|
|
|
|
|
|
|
split_path.__doc__ = """
|
|
|
|
Split a path by / or \\. This function is not like os.path.split
|
|
|
|
|
|
|
|
:type path: string
|
|
|
|
:param path: path to split
|
|
|
|
:return: list of strings
|
|
|
|
"""
|
|
|
|
|
|
|
|
def check_dir(path):
|
|
|
|
"""
|
|
|
|
Ensure that a directory exists (similar to ``mkdir -p``).
|
|
|
|
|
2013-08-02 18:39:21 +02:00
|
|
|
:type path: string
|
|
|
|
:param path: Path to directory
|
2011-09-10 11:13:51 +02:00
|
|
|
"""
|
|
|
|
if not os.path.isdir(path):
|
|
|
|
try:
|
|
|
|
os.makedirs(path)
|
|
|
|
except OSError as e:
|
|
|
|
if not os.path.isdir(path):
|
|
|
|
raise Errors.WafError('Cannot create the folder %r' % path, ex=e)
|
|
|
|
|
2014-04-07 22:10:56 +02:00
|
|
|
def check_exe(name, env=None):
|
2013-08-02 18:39:21 +02:00
|
|
|
"""
|
|
|
|
Ensure that a program exists
|
2015-10-03 09:12:08 +02:00
|
|
|
|
2013-08-02 18:39:21 +02:00
|
|
|
:type name: string
|
|
|
|
:param name: name or path to program
|
|
|
|
:return: path of the program or None
|
|
|
|
"""
|
2013-08-17 18:19:10 +02:00
|
|
|
if not name:
|
|
|
|
raise ValueError('Cannot execute an empty string!')
|
2013-08-02 18:39:21 +02:00
|
|
|
def is_exe(fpath):
|
|
|
|
return os.path.isfile(fpath) and os.access(fpath, os.X_OK)
|
|
|
|
|
|
|
|
fpath, fname = os.path.split(name)
|
|
|
|
if fpath and is_exe(name):
|
2014-01-08 07:58:03 +01:00
|
|
|
return os.path.abspath(name)
|
2013-08-02 18:39:21 +02:00
|
|
|
else:
|
2014-04-07 22:10:56 +02:00
|
|
|
env = env or os.environ
|
|
|
|
for path in env["PATH"].split(os.pathsep):
|
2013-08-02 18:39:21 +02:00
|
|
|
path = path.strip('"')
|
|
|
|
exe_file = os.path.join(path, name)
|
|
|
|
if is_exe(exe_file):
|
2014-01-08 07:58:03 +01:00
|
|
|
return os.path.abspath(exe_file)
|
2013-08-02 18:39:21 +02:00
|
|
|
return None
|
|
|
|
|
2011-09-10 11:13:51 +02:00
|
|
|
def def_attrs(cls, **kw):
|
|
|
|
"""
|
|
|
|
Set default attributes on a class instance
|
|
|
|
|
|
|
|
:type cls: class
|
|
|
|
:param cls: the class to update the given attributes in.
|
|
|
|
:type kw: dict
|
|
|
|
:param kw: dictionary of attributes names and values.
|
|
|
|
"""
|
|
|
|
for k, v in kw.items():
|
|
|
|
if not hasattr(cls, k):
|
|
|
|
setattr(cls, k, v)
|
|
|
|
|
|
|
|
def quote_define_name(s):
|
|
|
|
"""
|
|
|
|
Convert a string to an identifier suitable for C defines.
|
|
|
|
|
|
|
|
:type s: string
|
|
|
|
:param s: String to convert
|
|
|
|
:rtype: string
|
|
|
|
:return: Identifier suitable for C defines
|
|
|
|
"""
|
2014-02-22 10:47:19 +01:00
|
|
|
fu = re.sub('[^a-zA-Z0-9]', '_', s)
|
|
|
|
fu = re.sub('_+', '_', fu)
|
2011-09-10 11:13:51 +02:00
|
|
|
fu = fu.upper()
|
|
|
|
return fu
|
|
|
|
|
|
|
|
def h_list(lst):
|
|
|
|
"""
|
2013-11-28 20:00:50 +01:00
|
|
|
Hash lists. For tuples, using hash(tup) is much more efficient,
|
|
|
|
except on python >= 3.3 where hash randomization assumes everybody is running a web application.
|
2011-09-10 11:13:51 +02:00
|
|
|
|
|
|
|
:param lst: list to hash
|
|
|
|
:type lst: list of strings
|
|
|
|
:return: hash of the list
|
|
|
|
"""
|
2016-02-29 18:40:44 +01:00
|
|
|
return md5(repr(lst).encode()).digest()
|
2011-09-10 11:13:51 +02:00
|
|
|
|
|
|
|
def h_fun(fun):
|
|
|
|
"""
|
|
|
|
Hash functions
|
|
|
|
|
|
|
|
:param fun: function to hash
|
|
|
|
:type fun: function
|
|
|
|
:return: hash of the function
|
|
|
|
"""
|
|
|
|
try:
|
|
|
|
return fun.code
|
|
|
|
except AttributeError:
|
|
|
|
try:
|
|
|
|
h = inspect.getsource(fun)
|
|
|
|
except IOError:
|
|
|
|
h = "nocode"
|
|
|
|
try:
|
|
|
|
fun.code = h
|
|
|
|
except AttributeError:
|
|
|
|
pass
|
|
|
|
return h
|
|
|
|
|
2015-10-03 09:12:08 +02:00
|
|
|
def h_cmd(ins):
|
|
|
|
"""
|
|
|
|
Task command hashes are calculated by calling this function. The inputs can be
|
|
|
|
strings, functions, tuples/lists containing strings/functions
|
|
|
|
"""
|
|
|
|
# this function is not meant to be particularly fast
|
|
|
|
if isinstance(ins, str):
|
|
|
|
# a command is either a string
|
|
|
|
ret = ins
|
|
|
|
elif isinstance(ins, list) or isinstance(ins, tuple):
|
|
|
|
# or a list of functions/strings
|
|
|
|
ret = str([h_cmd(x) for x in ins])
|
|
|
|
else:
|
|
|
|
# or just a python function
|
|
|
|
ret = str(h_fun(ins))
|
|
|
|
if sys.hexversion > 0x3000000:
|
|
|
|
ret = ret.encode('iso8859-1', 'xmlcharrefreplace')
|
|
|
|
return ret
|
|
|
|
|
2011-09-10 11:13:51 +02:00
|
|
|
reg_subst = re.compile(r"(\\\\)|(\$\$)|\$\{([^}]+)\}")
|
|
|
|
def subst_vars(expr, params):
|
|
|
|
"""
|
|
|
|
Replace ${VAR} with the value of VAR taken from a dict or a config set::
|
|
|
|
|
|
|
|
from waflib import Utils
|
|
|
|
s = Utils.subst_vars('${PREFIX}/bin', env)
|
|
|
|
|
|
|
|
:type expr: string
|
|
|
|
:param expr: String to perform substitution on
|
|
|
|
:param params: Dictionary or config set to look up variable values.
|
|
|
|
"""
|
|
|
|
def repl_var(m):
|
|
|
|
if m.group(1):
|
|
|
|
return '\\'
|
|
|
|
if m.group(2):
|
|
|
|
return '$'
|
|
|
|
try:
|
|
|
|
# ConfigSet instances may contain lists
|
|
|
|
return params.get_flat(m.group(3))
|
|
|
|
except AttributeError:
|
|
|
|
return params[m.group(3)]
|
2015-10-15 20:07:05 +02:00
|
|
|
# if you get a TypeError, it means that 'expr' is not a string...
|
|
|
|
# Utils.subst_vars(None, env) will not work
|
2011-09-10 11:13:51 +02:00
|
|
|
return reg_subst.sub(repl_var, expr)
|
|
|
|
|
|
|
|
def destos_to_binfmt(key):
|
|
|
|
"""
|
|
|
|
Return the binary format based on the unversioned platform name.
|
|
|
|
|
|
|
|
:param key: platform name
|
|
|
|
:type key: string
|
|
|
|
:return: string representing the binary format
|
|
|
|
"""
|
|
|
|
if key == 'darwin':
|
|
|
|
return 'mac-o'
|
|
|
|
elif key in ('win32', 'cygwin', 'uwin', 'msys'):
|
|
|
|
return 'pe'
|
|
|
|
return 'elf'
|
|
|
|
|
|
|
|
def unversioned_sys_platform():
|
|
|
|
"""
|
|
|
|
Return the unversioned platform name.
|
|
|
|
Some Python platform names contain versions, that depend on
|
|
|
|
the build environment, e.g. linux2, freebsd6, etc.
|
|
|
|
This returns the name without the version number. Exceptions are
|
|
|
|
os2 and win32, which are returned verbatim.
|
|
|
|
|
|
|
|
:rtype: string
|
|
|
|
:return: Unversioned platform name
|
|
|
|
"""
|
|
|
|
s = sys.platform
|
2015-03-06 22:02:10 +01:00
|
|
|
if s.startswith('java'):
|
2011-09-10 11:13:51 +02:00
|
|
|
# The real OS is hidden under the JVM.
|
|
|
|
from java.lang import System
|
|
|
|
s = System.getProperty('os.name')
|
|
|
|
# see http://lopica.sourceforge.net/os.html for a list of possible values
|
|
|
|
if s == 'Mac OS X':
|
|
|
|
return 'darwin'
|
|
|
|
elif s.startswith('Windows '):
|
|
|
|
return 'win32'
|
|
|
|
elif s == 'OS/2':
|
|
|
|
return 'os2'
|
|
|
|
elif s == 'HP-UX':
|
2015-03-14 03:02:01 +01:00
|
|
|
return 'hp-ux'
|
2011-09-10 11:13:51 +02:00
|
|
|
elif s in ('SunOS', 'Solaris'):
|
|
|
|
return 'sunos'
|
|
|
|
else: s = s.lower()
|
2014-01-05 10:51:24 +01:00
|
|
|
|
2011-12-03 21:44:38 +01:00
|
|
|
# powerpc == darwin for our purposes
|
|
|
|
if s == 'powerpc':
|
|
|
|
return 'darwin'
|
2014-08-09 18:08:39 +02:00
|
|
|
if s == 'win32' or s == 'os2':
|
|
|
|
return s
|
2015-10-07 00:13:09 +02:00
|
|
|
if s == 'cli' and os.name == 'nt':
|
|
|
|
# ironpython is only on windows as far as we know
|
|
|
|
return 'win32'
|
2011-09-10 11:13:51 +02:00
|
|
|
return re.split('\d+$', s)[0]
|
|
|
|
|
|
|
|
def nada(*k, **kw):
|
|
|
|
"""
|
|
|
|
A function that does nothing
|
|
|
|
|
|
|
|
:return: None
|
|
|
|
"""
|
|
|
|
pass
|
|
|
|
|
|
|
|
class Timer(object):
|
|
|
|
"""
|
|
|
|
Simple object for timing the execution of commands.
|
|
|
|
Its string representation is the current time::
|
|
|
|
|
|
|
|
from waflib.Utils import Timer
|
|
|
|
timer = Timer()
|
|
|
|
a_few_operations()
|
|
|
|
s = str(timer)
|
|
|
|
"""
|
|
|
|
def __init__(self):
|
|
|
|
self.start_time = datetime.datetime.utcnow()
|
|
|
|
|
|
|
|
def __str__(self):
|
|
|
|
delta = datetime.datetime.utcnow() - self.start_time
|
2013-08-30 07:09:59 +02:00
|
|
|
days = delta.days
|
|
|
|
hours, rem = divmod(delta.seconds, 3600)
|
|
|
|
minutes, seconds = divmod(rem, 60)
|
|
|
|
seconds += delta.microseconds * 1e-6
|
2011-09-10 11:13:51 +02:00
|
|
|
result = ''
|
|
|
|
if days:
|
|
|
|
result += '%dd' % days
|
|
|
|
if days or hours:
|
|
|
|
result += '%dh' % hours
|
|
|
|
if days or hours or minutes:
|
|
|
|
result += '%dm' % minutes
|
|
|
|
return '%s%.3fs' % (result, seconds)
|
|
|
|
|
|
|
|
if is_win32:
|
|
|
|
old = shutil.copy2
|
|
|
|
def copy2(src, dst):
|
|
|
|
"""
|
|
|
|
shutil.copy2 does not copy the file attributes on windows, so we
|
|
|
|
hack into the shutil module to fix the problem
|
|
|
|
"""
|
|
|
|
old(src, dst)
|
|
|
|
shutil.copystat(src, dst)
|
|
|
|
setattr(shutil, 'copy2', copy2)
|
|
|
|
|
|
|
|
def read_la_file(path):
|
|
|
|
"""
|
|
|
|
Read property files, used by msvc.py
|
|
|
|
|
|
|
|
:param path: file to read
|
|
|
|
:type path: string
|
|
|
|
"""
|
|
|
|
sp = re.compile(r'^([^=]+)=\'(.*)\'$')
|
|
|
|
dc = {}
|
|
|
|
for line in readf(path).splitlines():
|
|
|
|
try:
|
|
|
|
_, left, right, _ = sp.split(line.strip())
|
|
|
|
dc[left] = right
|
|
|
|
except ValueError:
|
|
|
|
pass
|
|
|
|
return dc
|
|
|
|
|
|
|
|
def run_once(fun):
|
|
|
|
"""
|
|
|
|
Decorator: let a function cache its results, use like this::
|
|
|
|
|
|
|
|
@run_once
|
|
|
|
def foo(k):
|
|
|
|
return 345*2343
|
|
|
|
|
|
|
|
:param fun: function to execute
|
|
|
|
:type fun: function
|
|
|
|
:return: the return value of the function executed
|
|
|
|
"""
|
|
|
|
cache = {}
|
2015-12-22 18:27:04 +01:00
|
|
|
def wrap(*k):
|
2011-09-10 11:13:51 +02:00
|
|
|
try:
|
|
|
|
return cache[k]
|
|
|
|
except KeyError:
|
2015-12-22 18:27:04 +01:00
|
|
|
ret = fun(*k)
|
2011-09-10 11:13:51 +02:00
|
|
|
cache[k] = ret
|
|
|
|
return ret
|
|
|
|
wrap.__cache__ = cache
|
2015-11-05 02:01:32 +01:00
|
|
|
wrap.__name__ = fun.__name__
|
2011-09-10 11:13:51 +02:00
|
|
|
return wrap
|
|
|
|
|
|
|
|
def get_registry_app_path(key, filename):
|
|
|
|
if not winreg:
|
|
|
|
return None
|
|
|
|
try:
|
|
|
|
result = winreg.QueryValue(key, "Software\\Microsoft\\Windows\\CurrentVersion\\App Paths\\%s.exe" % filename[0])
|
|
|
|
except WindowsError:
|
|
|
|
pass
|
|
|
|
else:
|
|
|
|
if os.path.isfile(result):
|
|
|
|
return result
|
|
|
|
|
2015-02-19 13:46:18 +01:00
|
|
|
def lib64():
|
|
|
|
# default settings for /usr/lib
|
|
|
|
if os.sep == '/':
|
2015-04-03 21:24:46 +02:00
|
|
|
if platform.architecture()[0] == '64bit':
|
|
|
|
if os.path.exists('/usr/lib64') and not os.path.exists('/usr/lib32'):
|
|
|
|
return '64'
|
2015-02-19 13:46:18 +01:00
|
|
|
return ''
|
|
|
|
|
2015-10-10 17:05:13 +02:00
|
|
|
def sane_path(p):
|
|
|
|
# private function for the time being!
|
|
|
|
return os.path.abspath(os.path.expanduser(p))
|
|
|
|
|
2016-02-25 20:03:07 +01:00
|
|
|
|
2016-02-26 21:09:50 +01:00
|
|
|
process_pool = []
|
2016-02-25 20:03:07 +01:00
|
|
|
def get_process():
|
2016-02-25 21:53:17 +01:00
|
|
|
try:
|
2016-02-28 00:12:50 +01:00
|
|
|
return process_pool.pop()
|
2016-02-26 21:09:50 +01:00
|
|
|
except IndexError:
|
|
|
|
filepath = os.path.dirname(os.path.abspath(__file__)) + os.sep + 'processor.py'
|
|
|
|
cmd = [sys.executable, filepath]
|
2016-02-28 00:12:50 +01:00
|
|
|
return subprocess.Popen(cmd, stdout=subprocess.PIPE, stdin=subprocess.PIPE, bufsize=0)
|
2016-02-26 20:11:58 +01:00
|
|
|
|
|
|
|
def run_prefork_process(cmd, kwargs, cargs):
|
|
|
|
obj = base64.b64encode(cPickle.dumps([cmd, kwargs, cargs]))
|
|
|
|
|
2016-02-26 21:09:50 +01:00
|
|
|
proc = get_process()
|
2016-02-28 00:12:50 +01:00
|
|
|
if not proc:
|
|
|
|
return run_regular_process(cmd, kwargs, cargs)
|
|
|
|
|
2016-02-26 20:11:58 +01:00
|
|
|
proc.stdin.write(obj)
|
|
|
|
proc.stdin.write('\n'.encode())
|
|
|
|
proc.stdin.flush()
|
|
|
|
obj = proc.stdout.readline()
|
|
|
|
if not obj:
|
2016-02-26 21:23:49 +01:00
|
|
|
raise OSError('Preforked sub-process %r died' % proc.pid)
|
2016-02-26 20:11:58 +01:00
|
|
|
|
|
|
|
process_pool.append(proc)
|
|
|
|
ret, out, err, ex, trace = cPickle.loads(base64.b64decode(obj))
|
|
|
|
if ex:
|
|
|
|
if ex == 'OSError':
|
|
|
|
raise OSError(trace)
|
|
|
|
elif ex == 'ValueError':
|
|
|
|
raise ValueError(trace)
|
|
|
|
else:
|
|
|
|
raise Exception(trace)
|
|
|
|
return ret, out, err
|
|
|
|
|
2016-02-28 00:12:50 +01:00
|
|
|
def run_regular_process(cmd, kwargs, cargs={}):
|
|
|
|
proc = subprocess.Popen(cmd, **kwargs)
|
|
|
|
if kwargs.get('stdout', None) or kwargs.get('stderr', None):
|
|
|
|
out, err = proc.communicate(**cargs)
|
|
|
|
status = proc.returncode
|
|
|
|
else:
|
|
|
|
out, err = (None, None)
|
|
|
|
status = proc.wait(**cargs)
|
|
|
|
return status, out, err
|
|
|
|
|
2016-02-26 14:25:54 +01:00
|
|
|
def run_process(cmd, kwargs, cargs={}):
|
2016-02-28 00:12:50 +01:00
|
|
|
if kwargs.get('stdout', None) and kwargs.get('stderr', None):
|
|
|
|
return run_prefork_process(cmd, kwargs, cargs)
|
|
|
|
else:
|
2016-02-26 20:11:58 +01:00
|
|
|
return run_regular_process(cmd, kwargs, cargs)
|
2016-02-28 00:12:50 +01:00
|
|
|
|
|
|
|
def alloc_process_pool(n, force=False):
|
|
|
|
# mandatory on python2, unnecessary on python >= 3.2
|
|
|
|
global run_process, get_process, alloc_process_pool
|
|
|
|
if not force:
|
|
|
|
n = max(n - len(process_pool), 0)
|
|
|
|
try:
|
|
|
|
lst = [get_process() for x in range(n)]
|
|
|
|
except OSError:
|
|
|
|
run_process = run_regular_process
|
|
|
|
get_process = alloc_process_pool = nada
|
2016-02-25 20:03:07 +01:00
|
|
|
else:
|
2016-02-28 00:12:50 +01:00
|
|
|
for x in lst:
|
|
|
|
process_pool.append(x)
|
|
|
|
|
|
|
|
if sys.platform == 'cli' or not sys.executable:
|
|
|
|
run_process = run_regular_process
|
|
|
|
get_process = alloc_process_pool = nada
|
2016-02-25 20:03:07 +01:00
|
|
|
|