106
105
mod = os.lstat(filename).st_mode
107
106
if not stat.S_ISLNK(mod):
108
107
mod = mod & 0777555
109
chmod_if_possible(filename, mod)
108
os.chmod(filename, mod)
112
111
def make_writable(filename):
113
112
mod = os.lstat(filename).st_mode
114
113
if not stat.S_ISLNK(mod):
116
chmod_if_possible(filename, mod)
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
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" % (
115
os.chmod(filename, mod)
138
118
def minimum_path_selection(paths):
290
270
rename_func(tmp_name, new)
291
271
if failure_exc is not None:
293
raise failure_exc[0], failure_exc[1], failure_exc[2]
272
raise failure_exc[0], failure_exc[1], failure_exc[2]
298
275
# In Python 2.4.2 and older, os.path.abspath and os.path.realpath
299
276
# choke on a Unicode string containing a relative path if
300
277
# os.getcwd() returns a non-sys.getdefaultencoding()-encoded
279
_fs_enc = sys.getfilesystemencoding() or 'utf-8'
302
280
def _posix_abspath(path):
303
281
# jam 20060426 rather than encoding to fsencoding
304
282
# copy posixpath.abspath, but use os.getcwdu instead
305
283
if not posixpath.isabs(path):
306
284
path = posixpath.join(getcwd(), path)
307
return _posix_normpath(path)
285
return posixpath.normpath(path)
310
288
def _posix_realpath(path):
311
289
return posixpath.realpath(path.encode(_fs_enc)).decode(_fs_enc)
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('//'):
329
def _posix_path_from_environ(key):
330
"""Get unicode path from `key` in environment or None if not present
332
Note that posix systems use arbitrary byte strings for filesystem objects,
333
so a path that raises BadFilenameEncoding here may still be accessible.
335
val = os.environ.get(key, None)
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)
345
def _posix_get_home_dir():
346
"""Get the home directory of the current user as a unicode path"""
347
path = posixpath.expanduser("~")
349
return path.decode(_fs_enc)
350
except UnicodeDecodeError:
351
raise errors.BadFilenameEncoding(path, _fs_enc)
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()
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))
365
292
def _win32_fixdrive(path):
366
293
"""Force drive letters to be consistent.
450
377
return unicodedata.normalize('NFC', os.getcwdu())
453
def _rename_wrap_exception(rename_func):
454
"""Adds extra information to any exceptions that come from rename().
456
The exception has an updated message and 'old_filename' and 'new_filename'
460
def _rename_wrapper(old, new):
462
rename_func(old, new)
464
detailed_error = OSError(e.errno, e.strerror +
465
" [occurred when renaming '%s' to '%s']" %
467
detailed_error.old_filename = old
468
detailed_error.new_filename = new
471
return _rename_wrapper
473
# Default rename wraps os.rename()
474
rename = _rename_wrap_exception(os.rename)
476
380
# Default is to just use the python builtins, but these can be rebound on
477
381
# particular platforms.
478
382
abspath = _posix_abspath
479
383
realpath = _posix_realpath
480
384
pathjoin = os.path.join
481
normpath = _posix_normpath
482
path_from_environ = _posix_path_from_environ
483
_get_home_dir = _posix_get_home_dir
484
getuser_unicode = _posix_getuser_unicode
385
normpath = os.path.normpath
485
386
getcwd = os.getcwdu
486
388
dirname = os.path.dirname
487
389
basename = os.path.basename
488
390
split = os.path.split
982
867
return os.fstat(f.fileno())[stat.ST_SIZE]
985
# Alias os.urandom to support platforms (which?) without /dev/urandom and
986
# override if it doesn't work. Avoid checking on windows where there is
987
# significant initialisation cost that can be avoided for some bzr calls.
989
rand_bytes = os.urandom
991
if rand_bytes.__module__ != "nt":
870
# Define rand_bytes based on platform.
872
# Python 2.4 and later have os.urandom,
873
# but it doesn't work on some arches
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
994
except NotImplementedError:
880
rand_bytes = file('/dev/urandom', 'rb').read
881
# Otherwise, use this hack as a last resort
882
except (IOError, OSError):
995
883
# not well seeded, but better than nothing
996
884
def rand_bytes(n):
2013
1896
_cached_user_encoding = None
2016
def get_user_encoding(use_cache=DEPRECATED_PARAMETER):
1899
def get_user_encoding(use_cache=True):
2017
1900
"""Find out what the preferred user encoding is.
2019
1902
This is generally the encoding that is used for command line parameters
2020
1903
and file contents. This may be different from the terminal encoding
2021
1904
or the filesystem encoding.
1906
:param use_cache: Enable cache for detected encoding.
1907
(This parameter is turned on by default,
1908
and required only for selftesting)
2023
1910
:return: A string defining the preferred user encoding
2025
1912
global _cached_user_encoding
2026
if deprecated_passed(use_cache):
2027
warn_deprecated("use_cache should only have been used for tests",
2028
DeprecationWarning, stacklevel=2)
2029
if _cached_user_encoding is not None:
1913
if _cached_user_encoding is not None and use_cache:
2030
1914
return _cached_user_encoding
2032
if os.name == 'posix' and getattr(locale, 'CODESET', None) is not None:
2033
# Use the existing locale settings and call nl_langinfo directly
2034
# rather than going through getpreferredencoding. This avoids
2035
# <http://bugs.python.org/issue6202> on OSX Python 2.6 and the
2036
# possibility of the setlocale call throwing an error.
2037
user_encoding = locale.nl_langinfo(locale.CODESET)
1916
if sys.platform == 'darwin':
1917
# python locale.getpreferredencoding() always return
1918
# 'mac-roman' on darwin. That's a lie.
1919
sys.platform = 'posix'
1921
if os.environ.get('LANG', None) is None:
1922
# If LANG is not set, we end up with 'ascii', which is bad
1923
# ('mac-roman' is more than ascii), so we set a default which
1924
# will give us UTF-8 (which appears to work in all cases on
1925
# OSX). Users are still free to override LANG of course, as
1926
# long as it give us something meaningful. This work-around
1927
# *may* not be needed with python 3k and/or OSX 10.5, but will
1928
# work with them too -- vila 20080908
1929
os.environ['LANG'] = 'en_US.UTF-8'
1932
sys.platform = 'darwin'
2039
# GZ 2011-12-19: On windows could call GetACP directly instead.
2040
user_encoding = locale.getpreferredencoding(False)
2043
user_encoding = codecs.lookup(user_encoding).name
2045
if user_encoding not in ("", "cp0"):
1937
user_encoding = locale.getpreferredencoding()
1938
except locale.Error, e:
1939
sys.stderr.write('bzr: warning: %s\n'
1940
' Could not determine what text encoding to use.\n'
1941
' This error usually means your Python interpreter\n'
1942
' doesn\'t support the locale set by $LANG (%s)\n'
1943
" Continuing with ascii encoding.\n"
1944
% (e, os.environ.get('LANG')))
1945
user_encoding = 'ascii'
1947
# Windows returns 'cp0' to indicate there is no code page. So we'll just
1948
# treat that as ASCII, and not support printing unicode characters to the
1951
# For python scripts run under vim, we get '', so also treat that as ASCII
1952
if user_encoding in (None, 'cp0', ''):
1953
user_encoding = 'ascii'
1957
codecs.lookup(user_encoding)
2046
1959
sys.stderr.write('bzr: warning:'
2047
1960
' unknown encoding %s.'
2048
1961
' Continuing with ascii encoding.\n'
2049
1962
% user_encoding
2051
user_encoding = 'ascii'
2053
# Get 'ascii' when setlocale has not been called or LANG=C or unset.
2054
if user_encoding == 'ascii':
2055
if sys.platform == 'darwin':
2056
# OSX is special-cased in Python to have a UTF-8 filesystem
2057
# encoding and previously had LANG set here if not present.
2058
user_encoding = 'utf-8'
2059
# GZ 2011-12-19: Maybe UTF-8 should be the default in this case
2060
# for some other posix platforms as well.
2062
_cached_user_encoding = user_encoding
1964
user_encoding = 'ascii'
1967
_cached_user_encoding = user_encoding
2063
1969
return user_encoding
2158
2057
while sent_total < byte_count:
2160
2059
sent = sock.send(buffer(bytes, sent_total, MAX_SOCKET_CHUNK))
2161
except (socket.error, IOError), e:
2162
if e.args[0] in _end_of_stream_errors:
2163
raise errors.ConnectionReset(
2164
"Error trying to write to socket", e)
2060
except socket.error, e:
2165
2061
if e.args[0] != errno.EINTR:
2169
raise errors.ConnectionReset('Sending to %s returned 0 bytes'
2171
2064
sent_total += sent
2172
if report_activity is not None:
2173
report_activity(sent, 'write')
2176
def connect_socket(address):
2177
# Slight variation of the socket.create_connection() function (provided by
2178
# python-2.6) that can fail if getaddrinfo returns an empty list. We also
2179
# provide it for previous python versions. Also, we don't use the timeout
2180
# parameter (provided by the python implementation) so we don't implement
2182
err = socket.error('getaddrinfo returns an empty list')
2183
host, port = address
2184
for res in socket.getaddrinfo(host, port, 0, socket.SOCK_STREAM):
2185
af, socktype, proto, canonname, sa = res
2188
sock = socket.socket(af, socktype, proto)
2192
except socket.error, err:
2193
# 'err' is now the most recent error
2194
if sock is not None:
2065
report_activity(sent, 'write')
2199
2068
def dereference_path(path):
2261
2130
return file_kind_from_stat_mode(mode)
2262
2131
file_kind_from_stat_mode = file_kind_from_stat_mode_thunk
2264
def file_stat(f, _lstat=os.lstat):
2134
def file_kind(f, _lstat=os.lstat):
2136
return file_kind_from_stat_mode(_lstat(f).st_mode)
2268
2137
except OSError, e:
2269
2138
if getattr(e, 'errno', None) in (errno.ENOENT, errno.ENOTDIR):
2270
2139
raise errors.NoSuchFile(f)
2273
def file_kind(f, _lstat=os.lstat):
2274
stat_value = file_stat(f, _lstat)
2275
return file_kind_from_stat_mode(stat_value.st_mode)
2277
2143
def until_no_eintr(f, *a, **kw):
2278
2144
"""Run f(*a, **kw), retrying if an EINTR error occurs.
2338
2204
termios.tcsetattr(fd, termios.TCSADRAIN, settings)
2341
if sys.platform.startswith('linux'):
2208
if sys.platform == 'linux2':
2342
2209
def _local_concurrency():
2344
return os.sysconf('SC_NPROCESSORS_ONLN')
2345
except (ValueError, OSError, AttributeError):
2211
prefix = 'processor'
2212
for line in file('/proc/cpuinfo', 'rb'):
2213
if line.startswith(prefix):
2214
concurrency = int(line[line.find(':')+1:]) + 1
2347
2216
elif sys.platform == 'darwin':
2348
2217
def _local_concurrency():
2349
2218
return subprocess.Popen(['sysctl', '-n', 'hw.availcpu'],
2350
2219
stdout=subprocess.PIPE).communicate()[0]
2351
elif "bsd" in sys.platform:
2220
elif sys.platform[0:7] == 'freebsd':
2352
2221
def _local_concurrency():
2353
2222
return subprocess.Popen(['sysctl', '-n', 'hw.ncpu'],
2354
2223
stdout=subprocess.PIPE).communicate()[0]
2459
2321
open_file = open
2462
def available_backup_name(base, exists):
2463
"""Find a non-existing backup file name.
2465
This will *not* create anything, this only return a 'free' entry. This
2466
should be used for checking names in a directory below a locked
2467
tree/branch/repo to avoid race conditions. This is LBYL (Look Before You
2468
Leap) and generally discouraged.
2470
:param base: The base name.
2472
:param exists: A callable returning True if the path parameter exists.
2475
name = "%s.~%d~" % (base, counter)
2478
name = "%s.~%d~" % (base, counter)
2482
def set_fd_cloexec(fd):
2483
"""Set a Unix file descriptor's FD_CLOEXEC flag. Do nothing if platform
2484
support for this is not available.
2488
old = fcntl.fcntl(fd, fcntl.F_GETFD)
2489
fcntl.fcntl(fd, fcntl.F_SETFD, old | fcntl.FD_CLOEXEC)
2490
except (ImportError, AttributeError):
2491
# Either the fcntl module or specific constants are not present
2495
def find_executable_on_path(name):
2496
"""Finds an executable on the PATH.
2498
On Windows, this will try to append each extension in the PATHEXT
2499
environment variable to the name, if it cannot be found with the name
2502
:param name: The base name of the executable.
2503
:return: The path to the executable found or None.
2505
if sys.platform == 'win32':
2506
exts = os.environ.get('PATHEXT', '').split(os.pathsep)
2507
exts = [ext.lower() for ext in exts]
2508
base, ext = os.path.splitext(name)
2510
if ext.lower() not in exts:
2516
path = os.environ.get('PATH')
2517
if path is not None:
2518
path = path.split(os.pathsep)
2521
f = os.path.join(d, name) + ext
2522
if os.access(f, os.X_OK):
2524
if sys.platform == 'win32':
2525
app_path = win32utils.get_app_path(name)
2526
if app_path != name:
2531
def _posix_is_local_pid_dead(pid):
2532
"""True if pid doesn't correspond to live process on this machine"""
2534
# Special meaning of unix kill: just check if it's there.
2537
if e.errno == errno.ESRCH:
2538
# On this machine, and really not found: as sure as we can be
2541
elif e.errno == errno.EPERM:
2542
# exists, though not ours
2545
mutter("os.kill(%d, 0) failed: %s" % (pid, e))
2546
# Don't really know.
2549
# Exists and our process: not dead.
2552
if sys.platform == "win32":
2553
is_local_pid_dead = win32utils.is_local_pid_dead
2555
is_local_pid_dead = _posix_is_local_pid_dead
2557
_maybe_ignored = ['EAGAIN', 'EINTR', 'ENOTSUP', 'EOPNOTSUPP', 'EACCES']
2558
_fdatasync_ignored = [getattr(errno, name) for name in _maybe_ignored
2559
if getattr(errno, name, None) is not None]
2562
def fdatasync(fileno):
2563
"""Flush file contents to disk if possible.
2565
:param fileno: Integer OS file handle.
2566
:raises TransportNotPossible: If flushing to disk is not possible.
2568
fn = getattr(os, 'fdatasync', getattr(os, 'fsync', None))
2573
# See bug #1075108, on some platforms fdatasync exists, but can
2574
# raise ENOTSUP. However, we are calling fdatasync to be helpful
2575
# and reduce the chance of corruption-on-powerloss situations. It
2576
# is not a mandatory call, so it is ok to suppress failures.
2577
trace.mutter("ignoring error calling fdatasync: %s" % (e,))
2578
if getattr(e, 'errno', None) not in _fdatasync_ignored:
2582
def ensure_empty_directory_exists(path, exception_class):
2583
"""Make sure a local directory exists and is empty.
2585
If it does not exist, it is created. If it exists and is not empty, an
2586
instance of exception_class is raised.
2591
if e.errno != errno.EEXIST:
2593
if os.listdir(path) != []:
2594
raise exception_class(path)
2597
def is_environment_error(evalue):
2598
"""True if exception instance is due to a process environment issue
2600
This includes OSError and IOError, but also other errors that come from
2601
the operating system or core libraries but are not subclasses of those.
2603
if isinstance(evalue, (EnvironmentError, select.error)):
2605
if sys.platform == "win32" and win32utils._is_pywintypes_error(evalue):
2324
def getuser_unicode():
2325
"""Return the username as unicode.
2328
user_encoding = get_user_encoding()
2329
username = getpass.getuser().decode(user_encoding)
2330
except UnicodeDecodeError:
2331
raise errors.BzrError("Can't decode username as %s." % \
added
removed
bzrlib/osutils.py
