~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/osutils.py

  • Committer: Vincent Ladeuil
  • Date: 2012-02-14 17:22:37 UTC
  • mfrom: (6466 +trunk)
  • mto: This revision was merged to the branch mainline in revision 6468.
  • Revision ID: v.ladeuil+lp@free.fr-20120214172237-7dv7er3n4uy8d5m4
Merge trunk

Show diffs side-by-side

added added

removed removed

Lines of Context:
14
14
# along with this program; if not, write to the Free Software
15
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16
16
 
 
17
from __future__ import absolute_import
 
18
 
17
19
import errno
18
20
import os
19
21
import re
26
28
lazy_import(globals(), """
27
29
from datetime import datetime
28
30
import getpass
 
31
import locale
29
32
import ntpath
30
33
import posixpath
 
34
import select
31
35
# We need to import both shutil and rmtree as we export the later on posix
32
36
# and need the former on windows
33
37
import shutil
42
46
 
43
47
from bzrlib import (
44
48
    cache_utf8,
 
49
    config,
45
50
    errors,
46
51
    trace,
47
52
    win32utils,
48
53
    )
 
54
from bzrlib.i18n import gettext
49
55
""")
50
56
 
51
57
from bzrlib.symbol_versioning import (
 
58
    DEPRECATED_PARAMETER,
52
59
    deprecated_function,
53
60
    deprecated_in,
 
61
    deprecated_passed,
 
62
    warn as warn_deprecated,
54
63
    )
55
64
 
56
 
# sha and md5 modules are deprecated in python2.6 but hashlib is available as
57
 
# of 2.5
58
 
if sys.version_info < (2, 5):
59
 
    import md5 as _mod_md5
60
 
    md5 = _mod_md5.new
61
 
    import sha as _mod_sha
62
 
    sha = _mod_sha.new
63
 
else:
64
 
    from hashlib import (
65
 
        md5,
66
 
        sha1 as sha,
67
 
        )
 
65
from hashlib import (
 
66
    md5,
 
67
    sha1 as sha,
 
68
    )
68
69
 
69
70
 
70
71
import bzrlib
71
 
from bzrlib import symbol_versioning
 
72
from bzrlib import symbol_versioning, _fs_enc
72
73
 
73
74
 
74
75
# Cross platform wall-clock time functionality with decent resolution.
96
97
        user_encoding = get_user_encoding()
97
98
        return [a.decode(user_encoding) for a in sys.argv[1:]]
98
99
    except UnicodeDecodeError:
99
 
        raise errors.BzrError(("Parameter '%r' is unsupported by the current "
100
 
                                                            "encoding." % a))
 
100
        raise errors.BzrError(gettext("Parameter {0!r} encoding is unsupported by {1} "
 
101
            "application locale.").format(a, user_encoding))
101
102
 
102
103
 
103
104
def make_readonly(filename):
105
106
    mod = os.lstat(filename).st_mode
106
107
    if not stat.S_ISLNK(mod):
107
108
        mod = mod & 0777555
108
 
        os.chmod(filename, mod)
 
109
        chmod_if_possible(filename, mod)
109
110
 
110
111
 
111
112
def make_writable(filename):
112
113
    mod = os.lstat(filename).st_mode
113
114
    if not stat.S_ISLNK(mod):
114
115
        mod = mod | 0200
115
 
        os.chmod(filename, mod)
 
116
        chmod_if_possible(filename, mod)
 
117
 
 
118
 
 
119
def chmod_if_possible(filename, mode):
 
120
    # Set file mode if that can be safely done.
 
121
    # Sometimes even on unix the filesystem won't allow it - see
 
122
    # https://bugs.launchpad.net/bzr/+bug/606537
 
123
    try:
 
124
        # It is probably faster to just do the chmod, rather than
 
125
        # doing a stat, and then trying to compare
 
126
        os.chmod(filename, mode)
 
127
    except (IOError, OSError),e:
 
128
        # Permission/access denied seems to commonly happen on smbfs; there's
 
129
        # probably no point warning about it.
 
130
        # <https://bugs.launchpad.net/bzr/+bug/606537>
 
131
        if getattr(e, 'errno') in (errno.EPERM, errno.EACCES):
 
132
            trace.mutter("ignore error on chmod of %r: %r" % (
 
133
                filename, e))
 
134
            return
 
135
        raise
116
136
 
117
137
 
118
138
def minimum_path_selection(paths):
197
217
            if e.errno == errno.ENOENT:
198
218
                return False;
199
219
            else:
200
 
                raise errors.BzrError("lstat/stat of (%r): %r" % (f, e))
 
220
                raise errors.BzrError(gettext("lstat/stat of ({0!r}): {1!r}").format(f, e))
201
221
 
202
222
 
203
223
def fancy_rename(old, new, rename_func, unlink_func):
269
289
            else:
270
290
                rename_func(tmp_name, new)
271
291
    if failure_exc is not None:
272
 
        raise failure_exc[0], failure_exc[1], failure_exc[2]
 
292
        try:
 
293
            raise failure_exc[0], failure_exc[1], failure_exc[2]
 
294
        finally:
 
295
            del failure_exc
273
296
 
274
297
 
275
298
# In Python 2.4.2 and older, os.path.abspath and os.path.realpath
276
299
# choke on a Unicode string containing a relative path if
277
300
# os.getcwd() returns a non-sys.getdefaultencoding()-encoded
278
301
# string.
279
 
_fs_enc = sys.getfilesystemencoding() or 'utf-8'
280
302
def _posix_abspath(path):
281
303
    # jam 20060426 rather than encoding to fsencoding
282
304
    # copy posixpath.abspath, but use os.getcwdu instead
283
305
    if not posixpath.isabs(path):
284
306
        path = posixpath.join(getcwd(), path)
285
 
    return posixpath.normpath(path)
 
307
    return _posix_normpath(path)
286
308
 
287
309
 
288
310
def _posix_realpath(path):
289
311
    return posixpath.realpath(path.encode(_fs_enc)).decode(_fs_enc)
290
312
 
291
313
 
 
314
def _posix_normpath(path):
 
315
    path = posixpath.normpath(path)
 
316
    # Bug 861008: posixpath.normpath() returns a path normalized according to
 
317
    # the POSIX standard, which stipulates (for compatibility reasons) that two
 
318
    # leading slashes must not be simplified to one, and only if there are 3 or
 
319
    # more should they be simplified as one. So we treat the leading 2 slashes
 
320
    # as a special case here by simply removing the first slash, as we consider
 
321
    # that breaking POSIX compatibility for this obscure feature is acceptable.
 
322
    # This is not a paranoid precaution, as we notably get paths like this when
 
323
    # the repo is hosted at the root of the filesystem, i.e. in "/".    
 
324
    if path.startswith('//'):
 
325
        path = path[1:]
 
326
    return path
 
327
 
 
328
 
 
329
def _posix_path_from_environ(key):
 
330
    """Get unicode path from `key` in environment or None if not present
 
331
 
 
332
    Note that posix systems use arbitrary byte strings for filesystem objects,
 
333
    so a path that raises BadFilenameEncoding here may still be accessible.
 
334
    """
 
335
    val = os.environ.get(key, None)
 
336
    if val is None:
 
337
        return val
 
338
    try:
 
339
        return val.decode(_fs_enc)
 
340
    except UnicodeDecodeError:
 
341
        # GZ 2011-12-12:Ideally want to include `key` in the exception message
 
342
        raise errors.BadFilenameEncoding(val, _fs_enc)
 
343
 
 
344
 
 
345
def _posix_get_home_dir():
 
346
    """Get the home directory of the current user as a unicode path"""
 
347
    path = posixpath.expanduser("~")
 
348
    try:
 
349
        return path.decode(_fs_enc)
 
350
    except UnicodeDecodeError:
 
351
        raise errors.BadFilenameEncoding(path, _fs_enc)
 
352
 
 
353
 
 
354
def _posix_getuser_unicode():
 
355
    """Get username from environment or password database as unicode"""
 
356
    name = getpass.getuser()
 
357
    user_encoding = get_user_encoding()
 
358
    try:
 
359
        return name.decode(user_encoding)
 
360
    except UnicodeDecodeError:
 
361
        raise errors.BzrError("Encoding of username %r is unsupported by %s "
 
362
            "application locale." % (name, user_encoding))
 
363
 
 
364
 
292
365
def _win32_fixdrive(path):
293
366
    """Force drive letters to be consistent.
294
367
 
382
455
abspath = _posix_abspath
383
456
realpath = _posix_realpath
384
457
pathjoin = os.path.join
385
 
normpath = os.path.normpath
 
458
normpath = _posix_normpath
 
459
path_from_environ = _posix_path_from_environ
 
460
_get_home_dir = _posix_get_home_dir
 
461
getuser_unicode = _posix_getuser_unicode
386
462
getcwd = os.getcwdu
387
463
rename = os.rename
388
464
dirname = os.path.dirname
392
468
# These were already lazily imported into local scope
393
469
# mkdtemp = tempfile.mkdtemp
394
470
# rmtree = shutil.rmtree
 
471
lstat = os.lstat
 
472
fstat = os.fstat
 
473
 
 
474
def wrap_stat(st):
 
475
    return st
 
476
 
395
477
 
396
478
MIN_ABS_PATHLENGTH = 1
397
479
 
407
489
    getcwd = _win32_getcwd
408
490
    mkdtemp = _win32_mkdtemp
409
491
    rename = _win32_rename
 
492
    try:
 
493
        from bzrlib import _walkdirs_win32
 
494
    except ImportError:
 
495
        pass
 
496
    else:
 
497
        lstat = _walkdirs_win32.lstat
 
498
        fstat = _walkdirs_win32.fstat
 
499
        wrap_stat = _walkdirs_win32.wrap_stat
410
500
 
411
501
    MIN_ABS_PATHLENGTH = 3
412
502
 
430
520
    f = win32utils.get_unicode_argv     # special function or None
431
521
    if f is not None:
432
522
        get_unicode_argv = f
 
523
    path_from_environ = win32utils.get_environ_unicode
 
524
    _get_home_dir = win32utils.get_home_location
 
525
    getuser_unicode = win32utils.get_user_name
433
526
 
434
527
elif sys.platform == 'darwin':
435
528
    getcwd = _mac_getcwd
867
960
    return os.fstat(f.fileno())[stat.ST_SIZE]
868
961
 
869
962
 
870
 
# Define rand_bytes based on platform.
871
 
try:
872
 
    # Python 2.4 and later have os.urandom,
873
 
    # but it doesn't work on some arches
874
 
    os.urandom(1)
875
 
    rand_bytes = os.urandom
876
 
except (NotImplementedError, AttributeError):
877
 
    # If python doesn't have os.urandom, or it doesn't work,
878
 
    # then try to first pull random data from /dev/urandom
 
963
# Alias os.urandom to support platforms (which?) without /dev/urandom and 
 
964
# override if it doesn't work. Avoid checking on windows where there is
 
965
# significant initialisation cost that can be avoided for some bzr calls.
 
966
 
 
967
rand_bytes = os.urandom
 
968
 
 
969
if rand_bytes.__module__ != "nt":
879
970
    try:
880
 
        rand_bytes = file('/dev/urandom', 'rb').read
881
 
    # Otherwise, use this hack as a last resort
882
 
    except (IOError, OSError):
 
971
        rand_bytes(1)
 
972
    except NotImplementedError:
883
973
        # not well seeded, but better than nothing
884
974
        def rand_bytes(n):
885
975
            import random
915
1005
    rps = []
916
1006
    for f in ps:
917
1007
        if f == '..':
918
 
            raise errors.BzrError("sorry, %r not allowed in path" % f)
 
1008
            raise errors.BzrError(gettext("sorry, %r not allowed in path") % f)
919
1009
        elif (f == '.') or (f == ''):
920
1010
            pass
921
1011
        else:
926
1016
def joinpath(p):
927
1017
    for f in p:
928
1018
        if (f == '..') or (f is None) or (f == ''):
929
 
            raise errors.BzrError("sorry, %r not allowed in path" % f)
 
1019
            raise errors.BzrError(gettext("sorry, %r not allowed in path") % f)
930
1020
    return pathjoin(*p)
931
1021
 
932
1022
 
976
1066
def report_extension_load_failures():
977
1067
    if not _extension_load_failures:
978
1068
        return
979
 
    from bzrlib.config import GlobalConfig
980
 
    if GlobalConfig().get_user_option_as_bool('ignore_missing_extensions'):
 
1069
    if config.GlobalStack().get('ignore_missing_extensions'):
981
1070
        return
982
1071
    # the warnings framework should by default show this only once
983
1072
    from bzrlib.trace import warning
1145
1234
 
1146
1235
    if len(base) < MIN_ABS_PATHLENGTH:
1147
1236
        # must have space for e.g. a drive letter
1148
 
        raise ValueError('%r is too short to calculate a relative path'
 
1237
        raise ValueError(gettext('%r is too short to calculate a relative path')
1149
1238
            % (base,))
1150
1239
 
1151
1240
    rp = abspath(path)
1726
1815
    """
1727
1816
    global _selected_dir_reader
1728
1817
    if _selected_dir_reader is None:
1729
 
        fs_encoding = _fs_enc.upper()
1730
1818
        if sys.platform == "win32" and win32utils.winver == 'Windows NT':
1731
1819
            # Win98 doesn't have unicode apis like FindFirstFileW
1732
1820
            # TODO: We possibly could support Win98 by falling back to the
1738
1826
                _selected_dir_reader = Win32ReadDir()
1739
1827
            except ImportError:
1740
1828
                pass
1741
 
        elif fs_encoding in ('UTF-8', 'US-ASCII', 'ANSI_X3.4-1968'):
1742
 
            # ANSI_X3.4-1968 is a form of ASCII
 
1829
        elif _fs_enc in ('utf-8', 'ascii'):
1743
1830
            try:
1744
1831
                from bzrlib._readdir_pyx import UTF8DirReader
1745
1832
                _selected_dir_reader = UTF8DirReader()
1904
1991
_cached_user_encoding = None
1905
1992
 
1906
1993
 
1907
 
def get_user_encoding(use_cache=True):
 
1994
def get_user_encoding(use_cache=DEPRECATED_PARAMETER):
1908
1995
    """Find out what the preferred user encoding is.
1909
1996
 
1910
1997
    This is generally the encoding that is used for command line parameters
1911
1998
    and file contents. This may be different from the terminal encoding
1912
1999
    or the filesystem encoding.
1913
2000
 
1914
 
    :param  use_cache:  Enable cache for detected encoding.
1915
 
                        (This parameter is turned on by default,
1916
 
                        and required only for selftesting)
1917
 
 
1918
2001
    :return: A string defining the preferred user encoding
1919
2002
    """
1920
2003
    global _cached_user_encoding
1921
 
    if _cached_user_encoding is not None and use_cache:
 
2004
    if deprecated_passed(use_cache):
 
2005
        warn_deprecated("use_cache should only have been used for tests",
 
2006
            DeprecationWarning, stacklevel=2) 
 
2007
    if _cached_user_encoding is not None:
1922
2008
        return _cached_user_encoding
1923
2009
 
1924
 
    if sys.platform == 'darwin':
1925
 
        # python locale.getpreferredencoding() always return
1926
 
        # 'mac-roman' on darwin. That's a lie.
1927
 
        sys.platform = 'posix'
1928
 
        try:
1929
 
            if os.environ.get('LANG', None) is None:
1930
 
                # If LANG is not set, we end up with 'ascii', which is bad
1931
 
                # ('mac-roman' is more than ascii), so we set a default which
1932
 
                # will give us UTF-8 (which appears to work in all cases on
1933
 
                # OSX). Users are still free to override LANG of course, as
1934
 
                # long as it give us something meaningful. This work-around
1935
 
                # *may* not be needed with python 3k and/or OSX 10.5, but will
1936
 
                # work with them too -- vila 20080908
1937
 
                os.environ['LANG'] = 'en_US.UTF-8'
1938
 
            import locale
1939
 
        finally:
1940
 
            sys.platform = 'darwin'
 
2010
    if os.name == 'posix' and getattr(locale, 'CODESET', None) is not None:
 
2011
        # Use the existing locale settings and call nl_langinfo directly
 
2012
        # rather than going through getpreferredencoding. This avoids
 
2013
        # <http://bugs.python.org/issue6202> on OSX Python 2.6 and the
 
2014
        # possibility of the setlocale call throwing an error.
 
2015
        user_encoding = locale.nl_langinfo(locale.CODESET)
1941
2016
    else:
1942
 
        import locale
 
2017
        # GZ 2011-12-19: On windows could call GetACP directly instead.
 
2018
        user_encoding = locale.getpreferredencoding(False)
1943
2019
 
1944
2020
    try:
1945
 
        user_encoding = locale.getpreferredencoding()
1946
 
    except locale.Error, e:
1947
 
        sys.stderr.write('bzr: warning: %s\n'
1948
 
                         '  Could not determine what text encoding to use.\n'
1949
 
                         '  This error usually means your Python interpreter\n'
1950
 
                         '  doesn\'t support the locale set by $LANG (%s)\n'
1951
 
                         "  Continuing with ascii encoding.\n"
1952
 
                         % (e, os.environ.get('LANG')))
1953
 
        user_encoding = 'ascii'
1954
 
 
1955
 
    # Windows returns 'cp0' to indicate there is no code page. So we'll just
1956
 
    # treat that as ASCII, and not support printing unicode characters to the
1957
 
    # console.
1958
 
    #
1959
 
    # For python scripts run under vim, we get '', so also treat that as ASCII
1960
 
    if user_encoding in (None, 'cp0', ''):
1961
 
        user_encoding = 'ascii'
1962
 
    else:
1963
 
        # check encoding
1964
 
        try:
1965
 
            codecs.lookup(user_encoding)
1966
 
        except LookupError:
 
2021
        user_encoding = codecs.lookup(user_encoding).name
 
2022
    except LookupError:
 
2023
        if user_encoding not in ("", "cp0"):
1967
2024
            sys.stderr.write('bzr: warning:'
1968
2025
                             ' unknown encoding %s.'
1969
2026
                             ' Continuing with ascii encoding.\n'
1970
2027
                             % user_encoding
1971
2028
                            )
1972
 
            user_encoding = 'ascii'
1973
 
 
1974
 
    if use_cache:
1975
 
        _cached_user_encoding = user_encoding
1976
 
 
 
2029
        user_encoding = 'ascii'
 
2030
    else:
 
2031
        # Get 'ascii' when setlocale has not been called or LANG=C or unset.
 
2032
        if user_encoding == 'ascii':
 
2033
            if sys.platform == 'darwin':
 
2034
                # OSX is special-cased in Python to have a UTF-8 filesystem
 
2035
                # encoding and previously had LANG set here if not present.
 
2036
                user_encoding = 'utf-8'
 
2037
            # GZ 2011-12-19: Maybe UTF-8 should be the default in this case
 
2038
            #                for some other posix platforms as well.
 
2039
 
 
2040
    _cached_user_encoding = user_encoding
1977
2041
    return user_encoding
1978
2042
 
1979
2043
 
1988
2052
    behaves inconsistently on different platforms.
1989
2053
    """
1990
2054
    if sys.platform == "win32":
1991
 
        import win32utils
1992
2055
        return win32utils.get_host_name()
1993
2056
    else:
1994
2057
        import socket
2169
2232
    return file_kind_from_stat_mode(mode)
2170
2233
file_kind_from_stat_mode = file_kind_from_stat_mode_thunk
2171
2234
 
2172
 
 
2173
 
def file_kind(f, _lstat=os.lstat):
 
2235
def file_stat(f, _lstat=os.lstat):
2174
2236
    try:
2175
 
        return file_kind_from_stat_mode(_lstat(f).st_mode)
 
2237
        # XXX cache?
 
2238
        return _lstat(f)
2176
2239
    except OSError, e:
2177
2240
        if getattr(e, 'errno', None) in (errno.ENOENT, errno.ENOTDIR):
2178
2241
            raise errors.NoSuchFile(f)
2179
2242
        raise
2180
2243
 
 
2244
def file_kind(f, _lstat=os.lstat):
 
2245
    stat_value = file_stat(f, _lstat)
 
2246
    return file_kind_from_stat_mode(stat_value.st_mode)
2181
2247
 
2182
2248
def until_no_eintr(f, *a, **kw):
2183
2249
    """Run f(*a, **kw), retrying if an EINTR error occurs.
2227
2293
 
2228
2294
 
2229
2295
if sys.platform == "win32":
2230
 
    import msvcrt
2231
2296
    def getchar():
 
2297
        import msvcrt
2232
2298
        return msvcrt.getch()
2233
2299
else:
2234
 
    import tty
2235
 
    import termios
2236
2300
    def getchar():
 
2301
        import tty
 
2302
        import termios
2237
2303
        fd = sys.stdin.fileno()
2238
2304
        settings = termios.tcgetattr(fd)
2239
2305
        try:
2243
2309
            termios.tcsetattr(fd, termios.TCSADRAIN, settings)
2244
2310
        return ch
2245
2311
 
2246
 
 
2247
 
if sys.platform == 'linux2':
 
2312
if sys.platform.startswith('linux'):
2248
2313
    def _local_concurrency():
2249
 
        concurrency = None
2250
 
        prefix = 'processor'
2251
 
        for line in file('/proc/cpuinfo', 'rb'):
2252
 
            if line.startswith(prefix):
2253
 
                concurrency = int(line[line.find(':')+1:]) + 1
2254
 
        return concurrency
 
2314
        try:
 
2315
            return os.sysconf('SC_NPROCESSORS_ONLN')
 
2316
        except (ValueError, OSError, AttributeError):
 
2317
            return None
2255
2318
elif sys.platform == 'darwin':
2256
2319
    def _local_concurrency():
2257
2320
        return subprocess.Popen(['sysctl', '-n', 'hw.availcpu'],
2258
2321
                                stdout=subprocess.PIPE).communicate()[0]
2259
 
elif sys.platform[0:7] == 'freebsd':
 
2322
elif "bsd" in sys.platform:
2260
2323
    def _local_concurrency():
2261
2324
        return subprocess.Popen(['sysctl', '-n', 'hw.ncpu'],
2262
2325
                                stdout=subprocess.PIPE).communicate()[0]
2290
2353
    concurrency = os.environ.get('BZR_CONCURRENCY', None)
2291
2354
    if concurrency is None:
2292
2355
        try:
2293
 
            concurrency = _local_concurrency()
2294
 
        except (OSError, IOError):
2295
 
            pass
 
2356
            import multiprocessing
 
2357
            concurrency = multiprocessing.cpu_count()
 
2358
        except (ImportError, NotImplementedError):
 
2359
            # multiprocessing is only available on Python >= 2.6
 
2360
            # and multiprocessing.cpu_count() isn't implemented on all
 
2361
            # platforms
 
2362
            try:
 
2363
                concurrency = _local_concurrency()
 
2364
            except (OSError, IOError):
 
2365
                pass
2296
2366
    try:
2297
2367
        concurrency = int(concurrency)
2298
2368
    except (TypeError, ValueError):
2360
2430
    open_file = open
2361
2431
 
2362
2432
 
2363
 
def getuser_unicode():
2364
 
    """Return the username as unicode.
2365
 
    """
2366
 
    try:
2367
 
        user_encoding = get_user_encoding()
2368
 
        username = getpass.getuser().decode(user_encoding)
2369
 
    except UnicodeDecodeError:
2370
 
        raise errors.BzrError("Can't decode username as %s." % \
2371
 
                user_encoding)
2372
 
    return username
2373
 
 
2374
 
 
2375
2433
def available_backup_name(base, exists):
2376
2434
    """Find a non-existing backup file name.
2377
2435
 
2436
2494
            if os.access(f, os.X_OK):
2437
2495
                return f
2438
2496
    return None
 
2497
 
 
2498
 
 
2499
def _posix_is_local_pid_dead(pid):
 
2500
    """True if pid doesn't correspond to live process on this machine"""
 
2501
    try:
 
2502
        # Special meaning of unix kill: just check if it's there.
 
2503
        os.kill(pid, 0)
 
2504
    except OSError, e:
 
2505
        if e.errno == errno.ESRCH:
 
2506
            # On this machine, and really not found: as sure as we can be
 
2507
            # that it's dead.
 
2508
            return True
 
2509
        elif e.errno == errno.EPERM:
 
2510
            # exists, though not ours
 
2511
            return False
 
2512
        else:
 
2513
            mutter("os.kill(%d, 0) failed: %s" % (pid, e))
 
2514
            # Don't really know.
 
2515
            return False
 
2516
    else:
 
2517
        # Exists and our process: not dead.
 
2518
        return False
 
2519
 
 
2520
if sys.platform == "win32":
 
2521
    is_local_pid_dead = win32utils.is_local_pid_dead
 
2522
else:
 
2523
    is_local_pid_dead = _posix_is_local_pid_dead
 
2524
 
 
2525
 
 
2526
def fdatasync(fileno):
 
2527
    """Flush file contents to disk if possible.
 
2528
    
 
2529
    :param fileno: Integer OS file handle.
 
2530
    :raises TransportNotPossible: If flushing to disk is not possible.
 
2531
    """
 
2532
    fn = getattr(os, 'fdatasync', getattr(os, 'fsync', None))
 
2533
    if fn is not None:
 
2534
        fn(fileno)
 
2535
 
 
2536
 
 
2537
def ensure_empty_directory_exists(path, exception_class):
 
2538
    """Make sure a local directory exists and is empty.
 
2539
    
 
2540
    If it does not exist, it is created.  If it exists and is not empty, an
 
2541
    instance of exception_class is raised.
 
2542
    """
 
2543
    try:
 
2544
        os.mkdir(path)
 
2545
    except OSError, e:
 
2546
        if e.errno != errno.EEXIST:
 
2547
            raise
 
2548
        if os.listdir(path) != []:
 
2549
            raise exception_class(path)
 
2550
 
 
2551
 
 
2552
def is_environment_error(evalue):
 
2553
    """True if exception instance is due to a process environment issue
 
2554
 
 
2555
    This includes OSError and IOError, but also other errors that come from
 
2556
    the operating system or core libraries but are not subclasses of those.
 
2557
    """
 
2558
    if isinstance(evalue, (EnvironmentError, select.error)):
 
2559
        return True
 
2560
    if sys.platform == "win32" and win32utils._is_pywintypes_error(evalue):
 
2561
        return True
 
2562
    return False