/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar
5594.1.1 by Vincent Ladeuil
Fix socketpair-based SSH transport leaking socket into other child processes
1
# Copyright (C) 2005-2011 Canonical Ltd
1185.1.41 by Robert Collins
massive patch from Alexander Belchenko - many PEP8 fixes, removes unused function uuid
2
#
1 by mbp at sourcefrog
import from baz patch-364
3
# This program is free software; you can redistribute it and/or modify
4
# it under the terms of the GNU General Public License as published by
5
# the Free Software Foundation; either version 2 of the License, or
6
# (at your option) any later version.
1185.1.41 by Robert Collins
massive patch from Alexander Belchenko - many PEP8 fixes, removes unused function uuid
7
#
1 by mbp at sourcefrog
import from baz patch-364
8
# This program is distributed in the hope that it will be useful,
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11
# GNU General Public License for more details.
1185.1.41 by Robert Collins
massive patch from Alexander Belchenko - many PEP8 fixes, removes unused function uuid
12
#
1 by mbp at sourcefrog
import from baz patch-364
13
# You should have received a copy of the GNU General Public License
14
# along with this program; if not, write to the Free Software
4183.7.1 by Sabin Iacob
update FSF mailing address
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
1 by mbp at sourcefrog
import from baz patch-364
16
5225.1.1 by Andrew Bennetts
Don't lazy_import errno in osutils; it's a builtin module, and that lazy_import is implicated in a FreeBSD builder failure.
17
import errno
1996.3.14 by John Arbash Meinel
lazy_import osutils and sign_my_commits
18
import os
19
import re
20
import stat
21
import sys
22
import time
5051.2.1 by Benjamin Peterson
move codecs import out of lazy section since it is used on module import
23
import codecs
1996.3.14 by John Arbash Meinel
lazy_import osutils and sign_my_commits
24
6624 by Jelmer Vernooij
Merge Python3 porting work ('py3 pokes')
25
from .lazy_import import lazy_import
1996.3.14 by John Arbash Meinel
lazy_import osutils and sign_my_commits
26
lazy_import(globals(), """
2215.6.1 by James Henstridge
Don't rely on time.timezone and time.altzone in local_time_offset(),
27
from datetime import datetime
5187.2.7 by Parth Malwankar
moved getuser_unicode to osutils.
28
import getpass
6383.1.1 by Martin Packman
Simplify get_user_encoding by avoiding locale hacks and assuming setlocale has been called
29
import locale
5273.1.2 by Vincent Ladeuil
Cleanup imports in osutils.py.
30
import ntpath
1711.4.5 by John Arbash Meinel
the _posix_* routines should use posixpath not os.path, so tests pass on win32
31
import posixpath
6336.2.1 by Martin Packman
Add is_environment_error() and switch trace to using it
32
import select
5273.1.11 by Vincent Ladeuil
Really fix and better explain why we need both the module and the symbol.
33
# We need to import both shutil and rmtree as we export the later on posix
34
# and need the former on windows
35
import shutil
5273.1.10 by Vincent Ladeuil
Fixed as per jam's review.
36
from shutil import rmtree
5011.3.4 by Andrew Bennetts
Reinstate osutils.until_no_eintr and .send_all, reapply until_no_eintr in SmartSimplePipesClientMedium.read_bytes.
37
import socket
4398.4.3 by Vincent Ladeuil
Detect # cores on win32 and Solaris too.
38
import subprocess
5273.1.11 by Vincent Ladeuil
Really fix and better explain why we need both the module and the symbol.
39
# We need to import both tempfile and mkdtemp as we export the later on posix
40
# and need the former on windows
41
import tempfile
42
from tempfile import mkdtemp
1185.85.75 by John Arbash Meinel
Adding bzrlib.osutils.unicode_filename to handle unicode normalization for file paths.
43
import unicodedata
1996.3.25 by John Arbash Meinel
Make importing errors lazy for osutils
44
6622.1.34 by Jelmer Vernooij
Rename brzlib => breezy.
45
from breezy import (
6059.4.2 by Vincent Ladeuil
Migrate ignore_missing_extensions to stack-based config.
46
    config,
5011.3.16 by Andrew Bennetts
Merge lp:bzr.
47
    trace,
2245.4.6 by Alexander Belchenko
osutils.py: terminal_width() now use win32utils.get_console_size()
48
    win32utils,
1996.3.25 by John Arbash Meinel
Make importing errors lazy for osutils
49
    )
6622.1.34 by Jelmer Vernooij
Rename brzlib => breezy.
50
from breezy.i18n import gettext
1996.3.14 by John Arbash Meinel
lazy_import osutils and sign_my_commits
51
""")
1 by mbp at sourcefrog
import from baz patch-364
52
5848.2.1 by John Arbash Meinel
Break compatibility with python <2.6.
53
from hashlib import (
54
    md5,
55
    sha1 as sha,
56
    )
2929.3.1 by Vincent Ladeuil
Fix python2.6 deprecation warnings (still 4 failures 5 errors in test suite).
57
3504.4.1 by John Arbash Meinel
Write an alternative 'walkdirs' implementation that uses win32 apis.
58
6622.1.34 by Jelmer Vernooij
Rename brzlib => breezy.
59
import breezy
6734.1.14 by Jelmer Vernooij
Move UnsupportedTimezoneFormat.
60
from . import (
61
    _fs_enc,
62
    errors,
63
    )
1185.1.41 by Robert Collins
massive patch from Alexander Belchenko - many PEP8 fixes, removes unused function uuid
64
1 by mbp at sourcefrog
import from baz patch-364
65
1755.3.7 by John Arbash Meinel
Clean up and write tests for permissions. Now we use fstat which should be cheap, and lets us check the permissions and the file size
66
# On win32, O_BINARY is used to indicate the file should
67
# be opened in binary mode, rather than text mode.
68
# On other platforms, O_BINARY doesn't exist, because
69
# they always open in binary mode, so it is okay to
4634.140.12 by INADA Naoki
small clean up.
70
# OR with 0 on those platforms.
71
# O_NOINHERIT and O_TEXT exists only on win32 too.
1755.3.7 by John Arbash Meinel
Clean up and write tests for permissions. Now we use fstat which should be cheap, and lets us check the permissions and the file size
72
O_BINARY = getattr(os, 'O_BINARY', 0)
4634.140.12 by INADA Naoki
small clean up.
73
O_TEXT = getattr(os, 'O_TEXT', 0)
4634.140.1 by INADA Naoki
Avoids child process inherits file handles on win32. by using os.fdopen and os.open with O_NOINHERIT instead of builtin open.
74
O_NOINHERIT = getattr(os, 'O_NOINHERIT', 0)
75
1755.3.7 by John Arbash Meinel
Clean up and write tests for permissions. Now we use fstat which should be cheap, and lets us check the permissions and the file size
76
6734.1.14 by Jelmer Vernooij
Move UnsupportedTimezoneFormat.
77
class UnsupportedTimezoneFormat(errors.BzrError):
78
79
    _fmt = ('Unsupported timezone format "%(timezone)s", '
80
            'options are "utc", "original", "local".')
81
82
    def __init__(self, timezone):
83
        self.timezone = timezone
84
85
1 by mbp at sourcefrog
import from baz patch-364
86
def make_readonly(filename):
87
    """Make a filename read-only."""
2949.6.1 by Alexander Belchenko
windows python has os.lstat
88
    mod = os.lstat(filename).st_mode
2568.1.1 by John Arbash Meinel
(Elliot Murphy) Use os.lstat rather than os.stat for osutils.make_readonly/make_writeable
89
    if not stat.S_ISLNK(mod):
6619.3.14 by Jelmer Vernooij
Convert some octal numbers to new notations.
90
        mod = mod & 0o777555
6015.50.1 by Martin Pool
Use a chmod wrapper to cope with eperm from chmod
91
        chmod_if_possible(filename, mod)
1 by mbp at sourcefrog
import from baz patch-364
92
93
94
def make_writable(filename):
2949.6.1 by Alexander Belchenko
windows python has os.lstat
95
    mod = os.lstat(filename).st_mode
2568.1.1 by John Arbash Meinel
(Elliot Murphy) Use os.lstat rather than os.stat for osutils.make_readonly/make_writeable
96
    if not stat.S_ISLNK(mod):
6619.3.14 by Jelmer Vernooij
Convert some octal numbers to new notations.
97
        mod = mod | 0o200
6015.50.1 by Martin Pool
Use a chmod wrapper to cope with eperm from chmod
98
        chmod_if_possible(filename, mod)
99
100
101
def chmod_if_possible(filename, mode):
102
    # Set file mode if that can be safely done.
103
    # Sometimes even on unix the filesystem won't allow it - see
104
    # https://bugs.launchpad.net/bzr/+bug/606537
105
    try:
106
        # It is probably faster to just do the chmod, rather than
107
        # doing a stat, and then trying to compare
108
        os.chmod(filename, mode)
6619.3.2 by Jelmer Vernooij
Apply 2to3 except fix.
109
    except (IOError, OSError) as e:
6015.50.2 by Martin Pool
Also suppress EACCES from chmod
110
        # Permission/access denied seems to commonly happen on smbfs; there's
111
        # probably no point warning about it.
6015.50.1 by Martin Pool
Use a chmod wrapper to cope with eperm from chmod
112
        # <https://bugs.launchpad.net/bzr/+bug/606537>
6015.50.2 by Martin Pool
Also suppress EACCES from chmod
113
        if getattr(e, 'errno') in (errno.EPERM, errno.EACCES):
6015.50.3 by Martin Pool
More correct trace message when squelching chmod errors
114
            trace.mutter("ignore error on chmod of %r: %r" % (
115
                filename, e))
6015.50.1 by Martin Pool
Use a chmod wrapper to cope with eperm from chmod
116
            return
117
        raise
1 by mbp at sourcefrog
import from baz patch-364
118
119
2825.7.1 by Robert Collins
* Partial commits are now approximately 40% faster by walking over the
120
def minimum_path_selection(paths):
121
    """Return the smallset subset of paths which are outside paths.
122
2843.1.1 by Ian Clatworthy
Faster partial commits by walking less data (Robert Collins)
123
    :param paths: A container (and hence not None) of paths.
2825.7.1 by Robert Collins
* Partial commits are now approximately 40% faster by walking over the
124
    :return: A set of paths sufficient to include everything in paths via
4325.3.3 by Johan Walles
Add unit test and fix for minimum_path_selection() vs directory names with
125
        is_inside, drawn from the paths parameter.
2825.7.1 by Robert Collins
* Partial commits are now approximately 40% faster by walking over the
126
    """
4325.3.7 by Johan Walles
Style fixes for minimum_path_selection().
127
    if len(paths) < 2:
128
        return set(paths)
4325.3.3 by Johan Walles
Add unit test and fix for minimum_path_selection() vs directory names with
129
130
    def sort_key(path):
7067.16.1 by Jelmer Vernooij
Fix some C extensions.
131
        if isinstance(path, bytes):
132
            return path.split(b'/')
133
        else:
134
            return path.split('/')
4325.3.3 by Johan Walles
Add unit test and fix for minimum_path_selection() vs directory names with
135
    sorted_paths = sorted(list(paths), key=sort_key)
136
4325.3.7 by Johan Walles
Style fixes for minimum_path_selection().
137
    search_paths = [sorted_paths[0]]
138
    for path in sorted_paths[1:]:
4325.3.2 by Johan Walles
Use a linear algorithm for osutil.minimum_path_selection().
139
        if not is_inside(search_paths[-1], path):
140
            # This path is unique, add it
141
            search_paths.append(path)
4325.3.7 by Johan Walles
Style fixes for minimum_path_selection().
142
4325.3.2 by Johan Walles
Use a linear algorithm for osutil.minimum_path_selection().
143
    return set(search_paths)
2825.7.1 by Robert Collins
* Partial commits are now approximately 40% faster by walking over the
144
145
1077 by Martin Pool
- avoid compiling REs at module load time
146
_QUOTE_RE = None
969 by Martin Pool
- Add less-sucky is_within_any
147
148
1 by mbp at sourcefrog
import from baz patch-364
149
def quotefn(f):
779 by Martin Pool
- better quotefn for windows: use doublequotes for strings with
150
    """Return a quoted filename filename
151
152
    This previously used backslash quoting, but that works poorly on
153
    Windows."""
154
    # TODO: I'm not really sure this is the best format either.x
1077 by Martin Pool
- avoid compiling REs at module load time
155
    global _QUOTE_RE
1963.2.6 by Robey Pointer
pychecker is on crack; go back to using 'is None'.
156
    if _QUOTE_RE is None:
1185.1.41 by Robert Collins
massive patch from Alexander Belchenko - many PEP8 fixes, removes unused function uuid
157
        _QUOTE_RE = re.compile(r'([^a-zA-Z0-9.,:/\\_~-])')
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
158
779 by Martin Pool
- better quotefn for windows: use doublequotes for strings with
159
    if _QUOTE_RE.search(f):
160
        return '"' + f + '"'
161
    else:
162
        return f
1 by mbp at sourcefrog
import from baz patch-364
163
164
1753.1.1 by Robert Collins
(rbc, jam, mbp)Add bzrlib.osutils.walkdirs, an optimised walk-and-stat routine.
165
_directory_kind = 'directory'
166
7143.11.1 by Jelmer Vernooij
Remove some unused imports.
167
1755.3.7 by John Arbash Meinel
Clean up and write tests for permissions. Now we use fstat which should be cheap, and lets us check the permissions and the file size
168
def get_umask():
169
    """Return the current umask"""
170
    # Assume that people aren't messing with the umask while running
171
    # XXX: This is not thread safe, but there is no way to get the
172
    #      umask without setting it
173
    umask = os.umask(0)
174
    os.umask(umask)
175
    return umask
176
177
2324.2.1 by Dmitry Vasiliev
kind_marker() optimization
178
_kind_marker_map = {
179
    "file": "",
180
    _directory_kind: "/",
181
    "symlink": "@",
1551.10.30 by Aaron Bentley
Merge from bzr.dev
182
    'tree-reference': '+',
2324.2.1 by Dmitry Vasiliev
kind_marker() optimization
183
}
1551.10.30 by Aaron Bentley
Merge from bzr.dev
184
185
488 by Martin Pool
- new helper function kind_marker()
186
def kind_marker(kind):
2324.2.1 by Dmitry Vasiliev
kind_marker() optimization
187
    try:
188
        return _kind_marker_map[kind]
189
    except KeyError:
5024.1.2 by John Arbash Meinel
Switch so that all unknown files get an empty marker, rather than failing.
190
        # Slightly faster than using .get(, '') when the common case is that
191
        # kind will be found
192
        return ''
1 by mbp at sourcefrog
import from baz patch-364
193
2324.2.1 by Dmitry Vasiliev
kind_marker() optimization
194
1732.1.2 by John Arbash Meinel
just use os.path.lexists if it exists
195
lexists = getattr(os.path, 'lexists', None)
196
if lexists is None:
197
    def lexists(f):
198
        try:
2324.2.2 by Dmitry Vasiliev
Fixed lexists() implementation
199
            stat = getattr(os, 'lstat', os.stat)
200
            stat(f)
1732.1.2 by John Arbash Meinel
just use os.path.lexists if it exists
201
            return True
6619.3.2 by Jelmer Vernooij
Apply 2to3 except fix.
202
        except OSError as e:
1732.1.2 by John Arbash Meinel
just use os.path.lexists if it exists
203
            if e.errno == errno.ENOENT:
7143.15.2 by Jelmer Vernooij
Run autopep8.
204
                return False
1732.1.2 by John Arbash Meinel
just use os.path.lexists if it exists
205
            else:
7143.15.2 by Jelmer Vernooij
Run autopep8.
206
                raise errors.BzrError(
207
                    gettext("lstat/stat of ({0!r}): {1!r}").format(f, e))
1732.1.2 by John Arbash Meinel
just use os.path.lexists if it exists
208
1 by mbp at sourcefrog
import from baz patch-364
209
1185.31.47 by John Arbash Meinel
Added a fancy footwork rename to osutils, made SftpTransport use it.
210
def fancy_rename(old, new, rename_func, unlink_func):
211
    """A fancy rename, when you don't have atomic rename.
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
212
1185.31.47 by John Arbash Meinel
Added a fancy footwork rename to osutils, made SftpTransport use it.
213
    :param old: The old path, to rename from
214
    :param new: The new path, to rename to
215
    :param rename_func: The potentially non-atomic rename function
4935.1.1 by Vincent Ladeuil
Support Unicode paths for ftp transport (encoded as utf8).
216
    :param unlink_func: A way to delete the target file if the full rename
217
        succeeds
1185.31.47 by John Arbash Meinel
Added a fancy footwork rename to osutils, made SftpTransport use it.
218
    """
219
    # sftp rename doesn't allow overwriting, so play tricks:
220
    base = os.path.basename(new)
221
    dirname = os.path.dirname(new)
4935.1.3 by Vincent Ladeuil
Better fix for fancy_rename respecting callers file encoding.
222
    # callers use different encodings for the paths so the following MUST
223
    # respect that. We rely on python upcasting to unicode if new is unicode
224
    # and keeping a str if not.
225
    tmp_name = 'tmp.%s.%.9f.%d.%s' % (base, time.time(),
226
                                      os.getpid(), rand_chars(10))
1185.31.47 by John Arbash Meinel
Added a fancy footwork rename to osutils, made SftpTransport use it.
227
    tmp_name = pathjoin(dirname, tmp_name)
228
229
    # Rename the file out of the way, but keep track if it didn't exist
230
    # We don't want to grab just any exception
231
    # something like EACCES should prevent us from continuing
232
    # The downside is that the rename_func has to throw an exception
233
    # with an errno = ENOENT, or NoSuchFile
234
    file_existed = False
235
    try:
236
        rename_func(new, tmp_name)
7143.15.5 by Jelmer Vernooij
More PEP8 fixes.
237
    except (errors.NoSuchFile,):
1185.31.47 by John Arbash Meinel
Added a fancy footwork rename to osutils, made SftpTransport use it.
238
        pass
6619.3.2 by Jelmer Vernooij
Apply 2to3 except fix.
239
    except IOError as e:
1532 by Robert Collins
Merge in John Meinels integration branch.
240
        # RBC 20060103 abstraction leakage: the paramiko SFTP clients rename
1963.2.6 by Robey Pointer
pychecker is on crack; go back to using 'is None'.
241
        # function raises an IOError with errno is None when a rename fails.
1532 by Robert Collins
Merge in John Meinels integration branch.
242
        # This then gets caught here.
1185.50.37 by John Arbash Meinel
Fixed exception handling for fancy_rename
243
        if e.errno not in (None, errno.ENOENT, errno.ENOTDIR):
1532 by Robert Collins
Merge in John Meinels integration branch.
244
            raise
6619.3.2 by Jelmer Vernooij
Apply 2to3 except fix.
245
    except Exception as e:
1963.2.6 by Robey Pointer
pychecker is on crack; go back to using 'is None'.
246
        if (getattr(e, 'errno', None) is None
7143.15.2 by Jelmer Vernooij
Run autopep8.
247
                or e.errno not in (errno.ENOENT, errno.ENOTDIR)):
1185.31.47 by John Arbash Meinel
Added a fancy footwork rename to osutils, made SftpTransport use it.
248
            raise
249
    else:
250
        file_existed = True
251
252
    success = False
253
    try:
6619.3.27 by Martin
Unify try/except/finally block to avoid reraise complexity
254
        # This may throw an exception, in which case success will
255
        # not be set.
256
        rename_func(old, new)
257
        success = True
258
    except (IOError, OSError) as e:
259
        # source and target may be aliases of each other (e.g. on a
260
        # case-insensitive filesystem), so we may have accidentally renamed
261
        # source by when we tried to rename target
262
        if (file_existed and e.errno in (None, errno.ENOENT)
7143.15.2 by Jelmer Vernooij
Run autopep8.
263
                and old.lower() == new.lower()):
6619.3.27 by Martin
Unify try/except/finally block to avoid reraise complexity
264
            # source and target are the same file on a case-insensitive
265
            # filesystem, so we don't generate an exception
266
            pass
267
        else:
268
            raise
1185.31.47 by John Arbash Meinel
Added a fancy footwork rename to osutils, made SftpTransport use it.
269
    finally:
270
        if file_existed:
271
            # If the file used to exist, rename it back into place
272
            # otherwise just delete it from the tmp location
273
            if success:
1551.15.4 by Aaron Bentley
Revert now-unnecessary changes
274
                unlink_func(tmp_name)
1185.31.47 by John Arbash Meinel
Added a fancy footwork rename to osutils, made SftpTransport use it.
275
            else:
1185.31.49 by John Arbash Meinel
Some corrections using the new osutils.rename. **ALL TESTS PASS**
276
                rename_func(tmp_name, new)
1185.31.47 by John Arbash Meinel
Added a fancy footwork rename to osutils, made SftpTransport use it.
277
1685.1.9 by John Arbash Meinel
Updated LocalTransport so that it's base is now a URL rather than a local path. This helps consistency with all other functions. To do so, I added local_abspath() which returns the local path, and local_path_to/from_url
278
1685.1.20 by John Arbash Meinel
More changes to get 'bzr branch' and 'bzr pull' to work
279
# In Python 2.4.2 and older, os.path.abspath and os.path.realpath
280
# choke on a Unicode string containing a relative path if
281
# os.getcwd() returns a non-sys.getdefaultencoding()-encoded
282
# string.
283
def _posix_abspath(path):
1711.4.5 by John Arbash Meinel
the _posix_* routines should use posixpath not os.path, so tests pass on win32
284
    # jam 20060426 rather than encoding to fsencoding
285
    # copy posixpath.abspath, but use os.getcwdu instead
286
    if not posixpath.isabs(path):
287
        path = posixpath.join(getcwd(), path)
6015.39.2 by Florian Vichot
Fixed an infinite loop when creating a repo at the root of the filesystem,
288
    return _posix_normpath(path)
1685.1.20 by John Arbash Meinel
More changes to get 'bzr branch' and 'bzr pull' to work
289
290
291
def _posix_realpath(path):
1711.4.5 by John Arbash Meinel
the _posix_* routines should use posixpath not os.path, so tests pass on win32
292
    return posixpath.realpath(path.encode(_fs_enc)).decode(_fs_enc)
1685.1.20 by John Arbash Meinel
More changes to get 'bzr branch' and 'bzr pull' to work
293
294
6015.39.2 by Florian Vichot
Fixed an infinite loop when creating a repo at the root of the filesystem,
295
def _posix_normpath(path):
296
    path = posixpath.normpath(path)
297
    # Bug 861008: posixpath.normpath() returns a path normalized according to
298
    # the POSIX standard, which stipulates (for compatibility reasons) that two
299
    # leading slashes must not be simplified to one, and only if there are 3 or
300
    # more should they be simplified as one. So we treat the leading 2 slashes
301
    # as a special case here by simply removing the first slash, as we consider
302
    # that breaking POSIX compatibility for this obscure feature is acceptable.
303
    # This is not a paranoid precaution, as we notably get paths like this when
7143.15.2 by Jelmer Vernooij
Run autopep8.
304
    # the repo is hosted at the root of the filesystem, i.e. in "/".
6015.39.2 by Florian Vichot
Fixed an infinite loop when creating a repo at the root of the filesystem,
305
    if path.startswith('//'):
306
        path = path[1:]
307
    return path
308
309
6437.26.1 by Martin Packman
Add and test osutils._get_home_dir for unicode access to home location across platforms
310
def _posix_get_home_dir():
311
    """Get the home directory of the current user as a unicode path"""
312
    path = posixpath.expanduser("~")
313
    try:
314
        return path.decode(_fs_enc)
6621.2.26 by Martin
Misc set of changes to get started with selftest on Python 3
315
    except AttributeError:
316
        return path
6437.26.1 by Martin Packman
Add and test osutils._get_home_dir for unicode access to home location across platforms
317
    except UnicodeDecodeError:
318
        raise errors.BadFilenameEncoding(path, _fs_enc)
319
320
6362.2.4 by Martin Packman
Use native functions for getting username avoiding bug 660174 entirely
321
def _posix_getuser_unicode():
322
    """Get username from environment or password database as unicode"""
7479.2.1 by Jelmer Vernooij
Drop python2 support.
323
    return getpass.getuser()
6362.2.4 by Martin Packman
Use native functions for getting username avoiding bug 660174 entirely
324
325
1711.5.2 by John Arbash Meinel
win32 likes to return lowercase drive letters sometimes, and uppercase at other times. normalize this
326
def _win32_fixdrive(path):
327
    """Force drive letters to be consistent.
328
329
    win32 is inconsistent whether it returns lower or upper case
330
    and even if it was consistent the user might type the other
331
    so we force it to uppercase
332
    running python.exe under cmd.exe return capital C:\\
333
    running win32 python inside a cygwin shell returns lowercase c:\\
334
    """
5273.1.2 by Vincent Ladeuil
Cleanup imports in osutils.py.
335
    drive, path = ntpath.splitdrive(path)
1711.5.2 by John Arbash Meinel
win32 likes to return lowercase drive letters sometimes, and uppercase at other times. normalize this
336
    return drive.upper() + path
337
338
1685.1.20 by John Arbash Meinel
More changes to get 'bzr branch' and 'bzr pull' to work
339
def _win32_abspath(path):
5273.1.2 by Vincent Ladeuil
Cleanup imports in osutils.py.
340
    # Real ntpath.abspath doesn't have a problem with a unicode cwd
6973.6.4 by Jelmer Vernooij
Avoid text_type()
341
    return _win32_fixdrive(ntpath.abspath(path).replace('\\', '/'))
1685.1.20 by John Arbash Meinel
More changes to get 'bzr branch' and 'bzr pull' to work
342
343
344
def _win32_realpath(path):
5273.1.2 by Vincent Ladeuil
Cleanup imports in osutils.py.
345
    # Real ntpath.realpath doesn't have a problem with a unicode cwd
6973.6.4 by Jelmer Vernooij
Avoid text_type()
346
    return _win32_fixdrive(ntpath.realpath(path).replace('\\', '/'))
1685.1.20 by John Arbash Meinel
More changes to get 'bzr branch' and 'bzr pull' to work
347
348
349
def _win32_pathjoin(*args):
5273.1.2 by Vincent Ladeuil
Cleanup imports in osutils.py.
350
    return ntpath.join(*args).replace('\\', '/')
1685.1.20 by John Arbash Meinel
More changes to get 'bzr branch' and 'bzr pull' to work
351
352
353
def _win32_normpath(path):
6973.6.4 by Jelmer Vernooij
Avoid text_type()
354
    return _win32_fixdrive(ntpath.normpath(path).replace('\\', '/'))
1685.1.20 by John Arbash Meinel
More changes to get 'bzr branch' and 'bzr pull' to work
355
356
357
def _win32_getcwd():
6619.3.26 by Martin
Fix fallout from 2to3 getcwdu transformation and other test uses
358
    return _win32_fixdrive(_getcwd().replace('\\', '/'))
1685.1.20 by John Arbash Meinel
More changes to get 'bzr branch' and 'bzr pull' to work
359
360
361
def _win32_mkdtemp(*args, **kwargs):
5331.3.1 by Martin
Avoid infinite recursion with _win32_mkdtemp by using module namespaced name
362
    return _win32_fixdrive(tempfile.mkdtemp(*args, **kwargs).replace('\\', '/'))
1685.1.20 by John Arbash Meinel
More changes to get 'bzr branch' and 'bzr pull' to work
363
364
365
def _win32_rename(old, new):
1711.7.6 by John Arbash Meinel
Change _win32_rename() so that it raises ENOENT *before* it tries any renaming.
366
    """We expect to be able to atomically replace 'new' with old.
367
1711.7.17 by John Arbash Meinel
Delay the extra syscall in _win32_rename until we get a failure.
368
    On win32, if new exists, it must be moved out of the way first,
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
369
    and then deleted.
1711.7.6 by John Arbash Meinel
Change _win32_rename() so that it raises ENOENT *before* it tries any renaming.
370
    """
1711.7.17 by John Arbash Meinel
Delay the extra syscall in _win32_rename until we get a failure.
371
    try:
5186.2.11 by Martin Pool
_win32_rename no longer relies on _wrapped_rename
372
        fancy_rename(old, new, rename_func=os.rename, unlink_func=os.unlink)
6619.3.2 by Jelmer Vernooij
Apply 2to3 except fix.
373
    except OSError as e:
1830.3.15 by John Arbash Meinel
On Mac we get EINVAL when renaming cwd
374
        if e.errno in (errno.EPERM, errno.EACCES, errno.EBUSY, errno.EINVAL):
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
375
            # If we try to rename a non-existant file onto cwd, we get
376
            # EPERM or EACCES instead of ENOENT, this will raise ENOENT
1830.3.15 by John Arbash Meinel
On Mac we get EINVAL when renaming cwd
377
            # if the old path doesn't exist, sometimes we get EACCES
378
            # On Linux, we seem to get EBUSY, on Mac we get EINVAL
1711.7.17 by John Arbash Meinel
Delay the extra syscall in _win32_rename until we get a failure.
379
            os.lstat(old)
380
        raise
1685.1.20 by John Arbash Meinel
More changes to get 'bzr branch' and 'bzr pull' to work
381
382
1830.3.11 by John Arbash Meinel
Create a mac version of 'getcwd()' which normalizes the path.
383
def _mac_getcwd():
6619.3.26 by Martin
Fix fallout from 2to3 getcwdu transformation and other test uses
384
    return unicodedata.normalize('NFC', _getcwd())
1830.3.11 by John Arbash Meinel
Create a mac version of 'getcwd()' which normalizes the path.
385
386
6468.6.1 by Ross Lagerwall
Change osutils.rename to extend any exception information given from os.rename.
387
def _rename_wrap_exception(rename_func):
388
    """Adds extra information to any exceptions that come from rename().
389
390
    The exception has an updated message and 'old_filename' and 'new_filename'
391
    attributes.
392
    """
393
394
    def _rename_wrapper(old, new):
395
        try:
396
            rename_func(old, new)
6619.3.2 by Jelmer Vernooij
Apply 2to3 except fix.
397
        except OSError as e:
6468.6.1 by Ross Lagerwall
Change osutils.rename to extend any exception information given from os.rename.
398
            detailed_error = OSError(e.errno, e.strerror +
7143.15.2 by Jelmer Vernooij
Run autopep8.
399
                                     " [occurred when renaming '%s' to '%s']" %
400
                                     (old, new))
6468.6.1 by Ross Lagerwall
Change osutils.rename to extend any exception information given from os.rename.
401
            detailed_error.old_filename = old
402
            detailed_error.new_filename = new
403
            raise detailed_error
404
405
    return _rename_wrapper
406
6619.3.26 by Martin
Fix fallout from 2to3 getcwdu transformation and other test uses
407
7479.2.1 by Jelmer Vernooij
Drop python2 support.
408
_getcwd = os.getcwd
6619.3.26 by Martin
Fix fallout from 2to3 getcwdu transformation and other test uses
409
410
6468.6.1 by Ross Lagerwall
Change osutils.rename to extend any exception information given from os.rename.
411
# Default rename wraps os.rename()
412
rename = _rename_wrap_exception(os.rename)
413
1692.7.6 by Martin Pool
[patch] force deletion of trees containing readonly files (alexander)
414
# Default is to just use the python builtins, but these can be rebound on
415
# particular platforms.
1685.1.20 by John Arbash Meinel
More changes to get 'bzr branch' and 'bzr pull' to work
416
abspath = _posix_abspath
417
realpath = _posix_realpath
1185.31.47 by John Arbash Meinel
Added a fancy footwork rename to osutils, made SftpTransport use it.
418
pathjoin = os.path.join
6015.39.2 by Florian Vichot
Fixed an infinite loop when creating a repo at the root of the filesystem,
419
normpath = _posix_normpath
6437.26.1 by Martin Packman
Add and test osutils._get_home_dir for unicode access to home location across platforms
420
_get_home_dir = _posix_get_home_dir
6362.2.4 by Martin Packman
Use native functions for getting username avoiding bug 660174 entirely
421
getuser_unicode = _posix_getuser_unicode
6619.3.26 by Martin
Fix fallout from 2to3 getcwdu transformation and other test uses
422
getcwd = _getcwd
1185.31.47 by John Arbash Meinel
Added a fancy footwork rename to osutils, made SftpTransport use it.
423
dirname = os.path.dirname
424
basename = os.path.basename
2215.4.2 by Alexander Belchenko
split and splitext now the part of osutils
425
split = os.path.split
426
splitext = os.path.splitext
5273.1.10 by Vincent Ladeuil
Fixed as per jam's review.
427
# These were already lazily imported into local scope
428
# mkdtemp = tempfile.mkdtemp
429
# rmtree = shutil.rmtree
5609.29.5 by John Arbash Meinel
Fix bug #740932. Transform should update the sha cache.
430
lstat = os.lstat
431
fstat = os.fstat
432
7143.11.1 by Jelmer Vernooij
Remove some unused imports.
433
5609.29.5 by John Arbash Meinel
Fix bug #740932. Transform should update the sha cache.
434
def wrap_stat(st):
435
    return st
436
1185.31.47 by John Arbash Meinel
Added a fancy footwork rename to osutils, made SftpTransport use it.
437
1551.2.53 by abentley
Strip trailing slashes in a platform-sensible way
438
MIN_ABS_PATHLENGTH = 1
439
1685.1.9 by John Arbash Meinel
Updated LocalTransport so that it's base is now a URL rather than a local path. This helps consistency with all other functions. To do so, I added local_abspath() which returns the local path, and local_path_to/from_url
440
1185.31.47 by John Arbash Meinel
Added a fancy footwork rename to osutils, made SftpTransport use it.
441
if sys.platform == 'win32':
6658.6.1 by Martin
Remove winver, win98 support code, and deprecated code
442
    abspath = _win32_abspath
1685.1.20 by John Arbash Meinel
More changes to get 'bzr branch' and 'bzr pull' to work
443
    realpath = _win32_realpath
444
    pathjoin = _win32_pathjoin
445
    normpath = _win32_normpath
446
    getcwd = _win32_getcwd
447
    mkdtemp = _win32_mkdtemp
6468.6.1 by Ross Lagerwall
Change osutils.rename to extend any exception information given from os.rename.
448
    rename = _rename_wrap_exception(_win32_rename)
5609.29.5 by John Arbash Meinel
Fix bug #740932. Transform should update the sha cache.
449
    try:
6624 by Jelmer Vernooij
Merge Python3 porting work ('py3 pokes')
450
        from . import _walkdirs_win32
5609.29.5 by John Arbash Meinel
Fix bug #740932. Transform should update the sha cache.
451
    except ImportError:
452
        pass
453
    else:
454
        lstat = _walkdirs_win32.lstat
455
        fstat = _walkdirs_win32.fstat
456
        wrap_stat = _walkdirs_win32.wrap_stat
1685.1.20 by John Arbash Meinel
More changes to get 'bzr branch' and 'bzr pull' to work
457
1551.2.53 by abentley
Strip trailing slashes in a platform-sensible way
458
    MIN_ABS_PATHLENGTH = 3
1532 by Robert Collins
Merge in John Meinels integration branch.
459
1692.7.6 by Martin Pool
[patch] force deletion of trees containing readonly files (alexander)
460
    def _win32_delete_readonly(function, path, excinfo):
461
        """Error handler for shutil.rmtree function [for win32]
462
        Helps to remove files and dirs marked as read-only.
463
        """
2116.5.1 by Henri Wiechers
Fixes osutils.rmtree on Windows with Python 2.5
464
        exception = excinfo[1]
1692.7.6 by Martin Pool
[patch] force deletion of trees containing readonly files (alexander)
465
        if function in (os.remove, os.rmdir) \
7143.15.2 by Jelmer Vernooij
Run autopep8.
466
                and isinstance(exception, OSError) \
467
                and exception.errno == errno.EACCES:
1996.3.14 by John Arbash Meinel
lazy_import osutils and sign_my_commits
468
            make_writable(path)
1692.7.6 by Martin Pool
[patch] force deletion of trees containing readonly files (alexander)
469
            function(path)
470
        else:
471
            raise
472
473
    def rmtree(path, ignore_errors=False, onerror=_win32_delete_readonly):
474
        """Replacer for shutil.rmtree: could remove readonly dirs/files"""
475
        return shutil.rmtree(path, ignore_errors, onerror)
4355.2.2 by Alexander Belchenko
osutils.py: get_unicode_argv function (to obtain unicode command line arguments from sys.argv) moved to the beginning of module based on suggestions from review of John Meinel.
476
6437.26.1 by Martin Packman
Add and test osutils._get_home_dir for unicode access to home location across platforms
477
    _get_home_dir = win32utils.get_home_location
6362.2.4 by Martin Packman
Use native functions for getting username avoiding bug 660174 entirely
478
    getuser_unicode = win32utils.get_user_name
4355.2.2 by Alexander Belchenko
osutils.py: get_unicode_argv function (to obtain unicode command line arguments from sys.argv) moved to the beginning of module based on suggestions from review of John Meinel.
479
1830.3.11 by John Arbash Meinel
Create a mac version of 'getcwd()' which normalizes the path.
480
elif sys.platform == 'darwin':
481
    getcwd = _mac_getcwd
1692.7.6 by Martin Pool
[patch] force deletion of trees containing readonly files (alexander)
482
1685.1.31 by John Arbash Meinel
Adding tests for the rest of the _win32 functions.
483
5320.2.4 by Robert Collins
``bzrlib.osutils.get_terminal_encoding`` will now only mutter its
484
def get_terminal_encoding(trace=False):
1711.4.10 by John Arbash Meinel
Pull out sys.stdout.encoding handling into a separate function so it can be tested, and used elsewhere.
485
    """Find the best encoding for printing to the screen.
486
487
    This attempts to check both sys.stdout and sys.stdin to see
488
    what encoding they are in, and if that fails it falls back to
3224.5.4 by Andrew Bennetts
Fix test suite, mainly weeding out uses of bzrlib.user_encoding.
489
    osutils.get_user_encoding().
1711.4.10 by John Arbash Meinel
Pull out sys.stdout.encoding handling into a separate function so it can be tested, and used elsewhere.
490
    The problem is that on Windows, locale.getpreferredencoding()
491
    is not the same encoding as that used by the console:
492
    http://mail.python.org/pipermail/python-list/2003-May/162357.html
493
494
    On my standard US Windows XP, the preferred encoding is
495
    cp1252, but the console is cp437
5320.2.4 by Robert Collins
``bzrlib.osutils.get_terminal_encoding`` will now only mutter its
496
497
    :param trace: If True trace the selected encoding via mutter().
1711.4.10 by John Arbash Meinel
Pull out sys.stdout.encoding handling into a separate function so it can be tested, and used elsewhere.
498
    """
6624 by Jelmer Vernooij
Merge Python3 porting work ('py3 pokes')
499
    from .trace import mutter
1711.4.10 by John Arbash Meinel
Pull out sys.stdout.encoding handling into a separate function so it can be tested, and used elsewhere.
500
    output_encoding = getattr(sys.stdout, 'encoding', None)
501
    if not output_encoding:
502
        input_encoding = getattr(sys.stdin, 'encoding', None)
503
        if not input_encoding:
3224.5.4 by Andrew Bennetts
Fix test suite, mainly weeding out uses of bzrlib.user_encoding.
504
            output_encoding = get_user_encoding()
5320.2.4 by Robert Collins
``bzrlib.osutils.get_terminal_encoding`` will now only mutter its
505
            if trace:
506
                mutter('encoding stdout as osutils.get_user_encoding() %r',
7143.15.2 by Jelmer Vernooij
Run autopep8.
507
                       output_encoding)
1711.4.10 by John Arbash Meinel
Pull out sys.stdout.encoding handling into a separate function so it can be tested, and used elsewhere.
508
        else:
509
            output_encoding = input_encoding
5320.2.4 by Robert Collins
``bzrlib.osutils.get_terminal_encoding`` will now only mutter its
510
            if trace:
511
                mutter('encoding stdout as sys.stdin encoding %r',
7143.15.2 by Jelmer Vernooij
Run autopep8.
512
                       output_encoding)
1711.4.10 by John Arbash Meinel
Pull out sys.stdout.encoding handling into a separate function so it can be tested, and used elsewhere.
513
    else:
5320.2.4 by Robert Collins
``bzrlib.osutils.get_terminal_encoding`` will now only mutter its
514
        if trace:
515
            mutter('encoding stdout as sys.stdout encoding %r', output_encoding)
2127.4.1 by Alexander Belchenko
(jam, bialix) Workaround for cp0 console encoding on Windows
516
    if output_encoding == 'cp0':
517
        # invalid encoding (cp0 means 'no codepage' on Windows)
3224.5.4 by Andrew Bennetts
Fix test suite, mainly weeding out uses of bzrlib.user_encoding.
518
        output_encoding = get_user_encoding()
5320.2.4 by Robert Collins
``bzrlib.osutils.get_terminal_encoding`` will now only mutter its
519
        if trace:
520
            mutter('cp0 is invalid encoding.'
7143.15.2 by Jelmer Vernooij
Run autopep8.
521
                   ' encoding stdout as osutils.get_user_encoding() %r',
522
                   output_encoding)
2192.1.1 by Alexander Belchenko
Before actually using encoding need to check that Python has corresponding codec
523
    # check encoding
524
    try:
525
        codecs.lookup(output_encoding)
526
    except LookupError:
6622.1.4 by Jelmer Vernooij
Fix some more tests.
527
        sys.stderr.write('brz: warning:'
2192.1.9 by Alexander Belchenko
final fix suggested by John Meinel
528
                         ' unknown terminal encoding %s.\n'
2192.1.1 by Alexander Belchenko
Before actually using encoding need to check that Python has corresponding codec
529
                         '  Using encoding %s instead.\n'
3224.5.4 by Andrew Bennetts
Fix test suite, mainly weeding out uses of bzrlib.user_encoding.
530
                         % (output_encoding, get_user_encoding())
7143.15.2 by Jelmer Vernooij
Run autopep8.
531
                         )
3224.5.4 by Andrew Bennetts
Fix test suite, mainly weeding out uses of bzrlib.user_encoding.
532
        output_encoding = get_user_encoding()
2192.1.1 by Alexander Belchenko
Before actually using encoding need to check that Python has corresponding codec
533
1711.4.10 by John Arbash Meinel
Pull out sys.stdout.encoding handling into a separate function so it can be tested, and used elsewhere.
534
    return output_encoding
535
536
1185.31.32 by John Arbash Meinel
Updated the bzr sourcecode to use bzrlib.osutils.pathjoin rather than os.path.join to enforce internal use of / instead of \
537
def normalizepath(f):
3287.18.2 by Matt McClure
Reverts to 3290.
538
    if getattr(os.path, 'realpath', None) is not None:
1185.31.32 by John Arbash Meinel
Updated the bzr sourcecode to use bzrlib.osutils.pathjoin rather than os.path.join to enforce internal use of / instead of \
539
        F = realpath
540
    else:
541
        F = abspath
6809.1.1 by Martin
Apply 2to3 ws_comma fixer
542
    [p, e] = os.path.split(f)
1185.31.32 by John Arbash Meinel
Updated the bzr sourcecode to use bzrlib.osutils.pathjoin rather than os.path.join to enforce internal use of / instead of \
543
    if e == "" or e == "." or e == "..":
544
        return F(f)
545
    else:
546
        return pathjoin(F(p), e)
547
1 by mbp at sourcefrog
import from baz patch-364
548
549
def isdir(f):
550
    """True if f is an accessible directory."""
551
    try:
5273.1.2 by Vincent Ladeuil
Cleanup imports in osutils.py.
552
        return stat.S_ISDIR(os.lstat(f)[stat.ST_MODE])
1 by mbp at sourcefrog
import from baz patch-364
553
    except OSError:
554
        return False
555
556
557
def isfile(f):
558
    """True if f is a regular file."""
559
    try:
5273.1.2 by Vincent Ladeuil
Cleanup imports in osutils.py.
560
        return stat.S_ISREG(os.lstat(f)[stat.ST_MODE])
1 by mbp at sourcefrog
import from baz patch-364
561
    except OSError:
562
        return False
563
7143.11.1 by Jelmer Vernooij
Remove some unused imports.
564
1092.2.6 by Robert Collins
symlink support updated to work
565
def islink(f):
566
    """True if f is a symlink."""
567
    try:
5273.1.2 by Vincent Ladeuil
Cleanup imports in osutils.py.
568
        return stat.S_ISLNK(os.lstat(f)[stat.ST_MODE])
1092.2.6 by Robert Collins
symlink support updated to work
569
    except OSError:
570
        return False
1 by mbp at sourcefrog
import from baz patch-364
571
7143.11.1 by Jelmer Vernooij
Remove some unused imports.
572
485 by Martin Pool
- move commit code into its own module
573
def is_inside(dir, fname):
574
    """True if fname is inside dir.
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
575
1185.31.38 by John Arbash Meinel
Changing os.path.normpath to osutils.normpath
576
    The parameters should typically be passed to osutils.normpath first, so
969 by Martin Pool
- Add less-sucky is_within_any
577
    that . and .. and repeated slashes are eliminated, and the separators
578
    are canonical for the platform.
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
579
580
    The empty string as a dir name is taken as top-of-tree and matches
974.1.26 by aaron.bentley at utoronto
merged mbp@sourcefrog.net-20050817233101-0939da1cf91f2472
581
    everything.
485 by Martin Pool
- move commit code into its own module
582
    """
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
583
    # XXX: Most callers of this can actually do something smarter by
969 by Martin Pool
- Add less-sucky is_within_any
584
    # looking at the inventory
972 by Martin Pool
- less dodgy is_inside function
585
    if dir == fname:
586
        return True
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
587
7067.10.1 by Jelmer Vernooij
Support both bytestrings and unicode strings in osutils.is_inside.
588
    if dir in ('', b''):
974.1.26 by aaron.bentley at utoronto
merged mbp@sourcefrog.net-20050817233101-0939da1cf91f2472
589
        return True
1185.1.41 by Robert Collins
massive patch from Alexander Belchenko - many PEP8 fixes, removes unused function uuid
590
7067.10.1 by Jelmer Vernooij
Support both bytestrings and unicode strings in osutils.is_inside.
591
    if isinstance(dir, bytes):
592
        if not dir.endswith(b'/'):
593
            dir += b'/'
594
    else:
595
        if not dir.endswith('/'):
596
            dir += '/'
1185.1.41 by Robert Collins
massive patch from Alexander Belchenko - many PEP8 fixes, removes unused function uuid
597
972 by Martin Pool
- less dodgy is_inside function
598
    return fname.startswith(dir)
599
485 by Martin Pool
- move commit code into its own module
600
601
def is_inside_any(dir_list, fname):
602
    """True if fname is inside any of given dirs."""
603
    for dirname in dir_list:
604
        if is_inside(dirname, fname):
605
            return True
2324.2.3 by Dmitry Vasiliev
Fixed is_inside_* methods implementation
606
    return False
485 by Martin Pool
- move commit code into its own module
607
608
1740.3.4 by Jelmer Vernooij
Move inventory to commit builder.
609
def is_inside_or_parent_of_any(dir_list, fname):
610
    """True if fname is a child or a parent of any of the given files."""
611
    for dirname in dir_list:
612
        if is_inside(dirname, fname) or is_inside(fname, dirname):
613
            return True
2324.2.3 by Dmitry Vasiliev
Fixed is_inside_* methods implementation
614
    return False
1740.3.4 by Jelmer Vernooij
Move inventory to commit builder.
615
616
3956.2.1 by John Arbash Meinel
Add report_activity to osutils.pumpfile
617
def pumpfile(from_file, to_file, read_length=-1, buff_size=32768,
618
             report_activity=None, direction='read'):
2745.5.2 by Robert Collins
* ``bzrlib.transport.Transport.put_file`` now returns the number of bytes
619
    """Copy contents of one file to another.
3408.6.1 by Eric Holmberg
Fix for Bug #215426 in which bzr can cause a MemoryError in socket.recv while
620
621
    The read_length can either be -1 to read to end-of-file (EOF) or
622
    it can specify the maximum number of bytes to read.
623
624
    The buff_size represents the maximum size for each read operation
625
    performed on from_file.
626
3956.2.1 by John Arbash Meinel
Add report_activity to osutils.pumpfile
627
    :param report_activity: Call this as bytes are read, see
628
        Transport._report_activity
629
    :param direction: Will be passed to report_activity
630
2745.5.2 by Robert Collins
* ``bzrlib.transport.Transport.put_file`` now returns the number of bytes
631
    :return: The number of bytes copied.
632
    """
633
    length = 0
3408.6.1 by Eric Holmberg
Fix for Bug #215426 in which bzr can cause a MemoryError in socket.recv while
634
    if read_length >= 0:
635
        # read specified number of bytes
636
637
        while read_length > 0:
638
            num_bytes_to_read = min(read_length, buff_size)
639
640
            block = from_file.read(num_bytes_to_read)
641
            if not block:
642
                # EOF reached
643
                break
3956.2.1 by John Arbash Meinel
Add report_activity to osutils.pumpfile
644
            if report_activity is not None:
645
                report_activity(len(block), direction)
3408.6.1 by Eric Holmberg
Fix for Bug #215426 in which bzr can cause a MemoryError in socket.recv while
646
            to_file.write(block)
647
648
            actual_bytes_read = len(block)
649
            read_length -= actual_bytes_read
650
            length += actual_bytes_read
651
    else:
652
        # read to EOF
653
        while True:
654
            block = from_file.read(buff_size)
655
            if not block:
656
                # EOF reached
657
                break
3956.2.1 by John Arbash Meinel
Add report_activity to osutils.pumpfile
658
            if report_activity is not None:
659
                report_activity(len(block), direction)
3408.6.1 by Eric Holmberg
Fix for Bug #215426 in which bzr can cause a MemoryError in socket.recv while
660
            to_file.write(block)
661
            length += len(block)
2745.5.2 by Robert Collins
* ``bzrlib.transport.Transport.put_file`` now returns the number of bytes
662
    return length
1 by mbp at sourcefrog
import from baz patch-364
663
664
3635.1.2 by Robert Collins
Add osutils.pump_string_file helper function.
665
def pump_string_file(bytes, file_handle, segment_size=None):
666
    """Write bytes to file_handle in many smaller writes.
667
668
    :param bytes: The string to write.
669
    :param file_handle: The file to write to.
670
    """
671
    # Write data in chunks rather than all at once, because very large
672
    # writes fail on some platforms (e.g. Windows with SMB  mounted
673
    # drives).
674
    if not segment_size:
7143.15.2 by Jelmer Vernooij
Run autopep8.
675
        segment_size = 5242880  # 5MB
6632.1.1 by Martin
Change uses of buffer to memoryview
676
    offsets = range(0, len(bytes), segment_size)
677
    view = memoryview(bytes)
3635.1.2 by Robert Collins
Add osutils.pump_string_file helper function.
678
    write = file_handle.write
6632.1.1 by Martin
Change uses of buffer to memoryview
679
    for offset in offsets:
7143.15.2 by Jelmer Vernooij
Run autopep8.
680
        write(view[offset:offset + segment_size])
3635.1.2 by Robert Collins
Add osutils.pump_string_file helper function.
681
682
1185.67.7 by Aaron Bentley
Refactored a bit
683
def file_iterator(input_file, readsize=32768):
684
    while True:
685
        b = input_file.read(readsize)
686
        if len(b) == 0:
687
            break
688
        yield b
689
690
6803.2.2 by Martin
Make groupcompress Python 3 compatible
691
# GZ 2017-09-16: Makes sense in general for hexdigest() result to be text, but
692
# used as bytes through most interfaces so encode with this wrapper.
7479.2.1 by Jelmer Vernooij
Drop python2 support.
693
def _hexdigest(hashobj):
694
    return hashobj.hexdigest().encode()
6803.2.2 by Martin
Make groupcompress Python 3 compatible
695
696
1 by mbp at sourcefrog
import from baz patch-364
697
def sha_file(f):
3376.2.4 by Martin Pool
Remove every assert statement from bzrlib!
698
    """Calculate the hexdigest of an open file.
699
700
    The file cursor should be already at the start.
701
    """
2929.3.1 by Vincent Ladeuil
Fix python2.6 deprecation warnings (still 4 failures 5 errors in test suite).
702
    s = sha()
7143.15.2 by Jelmer Vernooij
Run autopep8.
703
    BUFSIZE = 128 << 10
320 by Martin Pool
- Compute SHA-1 of files in chunks
704
    while True:
705
        b = f.read(BUFSIZE)
706
        if not b:
707
            break
708
        s.update(b)
6803.2.2 by Martin
Make groupcompress Python 3 compatible
709
    return _hexdigest(s)
1 by mbp at sourcefrog
import from baz patch-364
710
711
3368.2.49 by Ian Clatworthy
added osutils.size_sha_file() with tests
712
def size_sha_file(f):
713
    """Calculate the size and hexdigest of an open file.
714
715
    The file cursor should be already at the start and
716
    the caller is responsible for closing the file afterwards.
717
    """
718
    size = 0
719
    s = sha()
7143.15.2 by Jelmer Vernooij
Run autopep8.
720
    BUFSIZE = 128 << 10
3368.2.49 by Ian Clatworthy
added osutils.size_sha_file() with tests
721
    while True:
722
        b = f.read(BUFSIZE)
723
        if not b:
724
            break
725
        size += len(b)
726
        s.update(b)
6803.2.2 by Martin
Make groupcompress Python 3 compatible
727
    return size, _hexdigest(s)
3368.2.49 by Ian Clatworthy
added osutils.size_sha_file() with tests
728
729
2872.3.1 by Martin Pool
Add -Dhashcache option; clean up dirstate sha1 code
730
def sha_file_by_name(fname):
731
    """Calculate the SHA1 of a file by reading the full text"""
2929.3.1 by Vincent Ladeuil
Fix python2.6 deprecation warnings (still 4 failures 5 errors in test suite).
732
    s = sha()
4634.140.1 by INADA Naoki
Avoids child process inherits file handles on win32. by using os.fdopen and os.open with O_NOINHERIT instead of builtin open.
733
    f = os.open(fname, os.O_RDONLY | O_BINARY | O_NOINHERIT)
2872.3.1 by Martin Pool
Add -Dhashcache option; clean up dirstate sha1 code
734
    try:
2872.3.2 by Martin Pool
Do sha_file_by_name using raw os files rather than file objects; makes this routine about 12osutils.py faster
735
        while True:
7143.15.2 by Jelmer Vernooij
Run autopep8.
736
            b = os.read(f, 1 << 16)
2872.3.2 by Martin Pool
Do sha_file_by_name using raw os files rather than file objects; makes this routine about 12osutils.py faster
737
            if not b:
6803.2.2 by Martin
Make groupcompress Python 3 compatible
738
                return _hexdigest(s)
2872.3.2 by Martin Pool
Do sha_file_by_name using raw os files rather than file objects; makes this routine about 12osutils.py faster
739
            s.update(b)
2872.3.1 by Martin Pool
Add -Dhashcache option; clean up dirstate sha1 code
740
    finally:
2872.3.2 by Martin Pool
Do sha_file_by_name using raw os files rather than file objects; makes this routine about 12osutils.py faster
741
        os.close(f)
2872.3.1 by Martin Pool
Add -Dhashcache option; clean up dirstate sha1 code
742
743
2929.3.1 by Vincent Ladeuil
Fix python2.6 deprecation warnings (still 4 failures 5 errors in test suite).
744
def sha_strings(strings, _factory=sha):
1235 by Martin Pool
- split sha_strings into osutils
745
    """Return the sha-1 of concatenation of strings"""
2825.2.1 by Robert Collins
Micro-tweaks to sha routines.
746
    s = _factory()
6631.3.1 by Martin
Run 2to3 map fixer and refactor after
747
    for string in strings:
748
        s.update(string)
6803.2.2 by Martin
Make groupcompress Python 3 compatible
749
    return _hexdigest(s)
1235 by Martin Pool
- split sha_strings into osutils
750
751
2929.3.1 by Vincent Ladeuil
Fix python2.6 deprecation warnings (still 4 failures 5 errors in test suite).
752
def sha_string(f, _factory=sha):
6803.2.2 by Martin
Make groupcompress Python 3 compatible
753
    # GZ 2017-09-16: Dodgy if factory is ever not sha, probably shouldn't be.
754
    return _hexdigest(_factory(f))
1 by mbp at sourcefrog
import from baz patch-364
755
756
124 by mbp at sourcefrog
- check file text for past revisions is correct
757
def fingerprint_file(f):
126 by mbp at sourcefrog
Use just one big read to fingerprint files
758
    b = f.read()
2825.2.1 by Robert Collins
Micro-tweaks to sha routines.
759
    return {'size': len(b),
6803.2.2 by Martin
Make groupcompress Python 3 compatible
760
            'sha1': _hexdigest(sha(b))}
124 by mbp at sourcefrog
- check file text for past revisions is correct
761
762
1 by mbp at sourcefrog
import from baz patch-364
763
def compare_files(a, b):
764
    """Returns true if equal in contents"""
74 by mbp at sourcefrog
compare_files: read in one page at a time rather than
765
    BUFSIZE = 4096
766
    while True:
767
        ai = a.read(BUFSIZE)
768
        bi = b.read(BUFSIZE)
769
        if ai != bi:
770
            return False
6973.12.9 by Jelmer Vernooij
More fixes.
771
        if not ai:
74 by mbp at sourcefrog
compare_files: read in one page at a time rather than
772
            return True
1 by mbp at sourcefrog
import from baz patch-364
773
774
49 by mbp at sourcefrog
fix local-time-offset calculation
775
def local_time_offset(t=None):
776
    """Return offset of local zone from GMT, either at present or at time t."""
1963.2.6 by Robey Pointer
pychecker is on crack; go back to using 'is None'.
777
    if t is None:
73 by mbp at sourcefrog
fix time.localtime call for python 2.3
778
        t = time.time()
2215.6.1 by James Henstridge
Don't rely on time.timezone and time.altzone in local_time_offset(),
779
    offset = datetime.fromtimestamp(t) - datetime.utcfromtimestamp(t)
780
    return offset.days * 86400 + offset.seconds
8 by mbp at sourcefrog
store committer's timezone in revision and show
781
7143.15.2 by Jelmer Vernooij
Run autopep8.
782
3512.3.1 by Martin von Gagern
Hand-selected minimalistic set of changes from my setlocale branch.
783
weekdays = ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']
4379.4.1 by Ian Clatworthy
make log --long faster
784
_default_format_by_weekday_num = [wd + " %Y-%m-%d %H:%M:%S" for wd in weekdays]
785
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
786
2425.6.2 by Martin Pool
Make timestamps use existing format_date; document that function more
787
def format_date(t, offset=0, timezone='original', date_fmt=None,
3526.5.4 by Martin von Gagern
Use separate function format_local_date for local weekday formats in unicode.
788
                show_offset=True):
2425.6.2 by Martin Pool
Make timestamps use existing format_date; document that function more
789
    """Return a formatted date string.
790
791
    :param t: Seconds since the epoch.
792
    :param offset: Timezone offset in seconds east of utc.
793
    :param timezone: How to display the time: 'utc', 'original' for the
794
         timezone specified by offset, or 'local' for the process's current
795
         timezone.
3526.5.4 by Martin von Gagern
Use separate function format_local_date for local weekday formats in unicode.
796
    :param date_fmt: strftime format.
797
    :param show_offset: Whether to append the timezone.
798
    """
799
    (date_fmt, tt, offset_str) = \
7143.15.2 by Jelmer Vernooij
Run autopep8.
800
        _format_date(t, offset, timezone, date_fmt, show_offset)
3526.5.4 by Martin von Gagern
Use separate function format_local_date for local weekday formats in unicode.
801
    date_fmt = date_fmt.replace('%a', weekdays[tt[6]])
802
    date_str = time.strftime(date_fmt, tt)
803
    return date_str + offset_str
804
4379.4.1 by Ian Clatworthy
make log --long faster
805
806
# Cache of formatted offset strings
807
_offset_cache = {}
808
809
4379.4.2 by Ian Clatworthy
add NEWS item and tests for new date formatting API
810
def format_date_with_offset_in_original_timezone(t, offset=0,
7143.15.2 by Jelmer Vernooij
Run autopep8.
811
                                                 _cache=_offset_cache):
4379.4.1 by Ian Clatworthy
make log --long faster
812
    """Return a formatted date string in the original timezone.
813
814
    This routine may be faster then format_date.
815
816
    :param t: Seconds since the epoch.
817
    :param offset: Timezone offset in seconds east of utc.
818
    """
819
    if offset is None:
820
        offset = 0
6840.1.1 by Jelmer Vernooij
Revert custom gmtime implementation without tests.
821
    tt = time.gmtime(t + offset)
4379.4.1 by Ian Clatworthy
make log --long faster
822
    date_fmt = _default_format_by_weekday_num[tt[6]]
823
    date_str = time.strftime(date_fmt, tt)
824
    offset_str = _cache.get(offset, None)
825
    if offset_str is None:
826
        offset_str = ' %+03d%02d' % (offset / 3600, (offset / 60) % 60)
827
        _cache[offset] = offset_str
828
    return date_str + offset_str
829
830
3526.5.4 by Martin von Gagern
Use separate function format_local_date for local weekday formats in unicode.
831
def format_local_date(t, offset=0, timezone='original', date_fmt=None,
832
                      show_offset=True):
833
    """Return an unicode date string formatted according to the current locale.
834
835
    :param t: Seconds since the epoch.
836
    :param offset: Timezone offset in seconds east of utc.
837
    :param timezone: How to display the time: 'utc', 'original' for the
838
         timezone specified by offset, or 'local' for the process's current
839
         timezone.
840
    :param date_fmt: strftime format.
841
    :param show_offset: Whether to append the timezone.
842
    """
843
    (date_fmt, tt, offset_str) = \
7143.15.2 by Jelmer Vernooij
Run autopep8.
844
        _format_date(t, offset, timezone, date_fmt, show_offset)
3526.5.4 by Martin von Gagern
Use separate function format_local_date for local weekday formats in unicode.
845
    date_str = time.strftime(date_fmt, tt)
7479.2.1 by Jelmer Vernooij
Drop python2 support.
846
    if not isinstance(date_str, str):
4385.4.1 by Alexander Belchenko
removed all references to bzrlib.user_encoding
847
        date_str = date_str.decode(get_user_encoding(), 'replace')
3526.5.4 by Martin von Gagern
Use separate function format_local_date for local weekday formats in unicode.
848
    return date_str + offset_str
849
4379.4.1 by Ian Clatworthy
make log --long faster
850
3526.5.4 by Martin von Gagern
Use separate function format_local_date for local weekday formats in unicode.
851
def _format_date(t, offset, timezone, date_fmt, show_offset):
8 by mbp at sourcefrog
store committer's timezone in revision and show
852
    if timezone == 'utc':
6840.1.1 by Jelmer Vernooij
Revert custom gmtime implementation without tests.
853
        tt = time.gmtime(t)
1 by mbp at sourcefrog
import from baz patch-364
854
        offset = 0
8 by mbp at sourcefrog
store committer's timezone in revision and show
855
    elif timezone == 'original':
1963.2.6 by Robey Pointer
pychecker is on crack; go back to using 'is None'.
856
        if offset is None:
23 by mbp at sourcefrog
format_date: handle revisions with no timezone offset
857
            offset = 0
6840.1.1 by Jelmer Vernooij
Revert custom gmtime implementation without tests.
858
        tt = time.gmtime(t + offset)
12 by mbp at sourcefrog
new --timezone option for bzr log
859
    elif timezone == 'local':
1 by mbp at sourcefrog
import from baz patch-364
860
        tt = time.localtime(t)
49 by mbp at sourcefrog
fix local-time-offset calculation
861
        offset = local_time_offset(t)
12 by mbp at sourcefrog
new --timezone option for bzr log
862
    else:
6734.1.14 by Jelmer Vernooij
Move UnsupportedTimezoneFormat.
863
        raise UnsupportedTimezoneFormat(timezone)
1185.12.24 by Aaron Bentley
Made format_date more flexible
864
    if date_fmt is None:
865
        date_fmt = "%a %Y-%m-%d %H:%M:%S"
866
    if show_offset:
867
        offset_str = ' %+03d%02d' % (offset / 3600, (offset / 60) % 60)
868
    else:
869
        offset_str = ''
3526.5.4 by Martin von Gagern
Use separate function format_local_date for local weekday formats in unicode.
870
    return (date_fmt, tt, offset_str)
1 by mbp at sourcefrog
import from baz patch-364
871
872
873
def compact_date(when):
6840.1.1 by Jelmer Vernooij
Revert custom gmtime implementation without tests.
874
    return time.strftime('%Y%m%d%H%M%S', time.gmtime(when))
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
875
1 by mbp at sourcefrog
import from baz patch-364
876
1957.1.4 by John Arbash Meinel
create a helper for formatting a time delta
877
def format_delta(delta):
878
    """Get a nice looking string for a time delta.
879
880
    :param delta: The time difference in seconds, can be positive or negative.
881
        positive indicates time in the past, negative indicates time in the
882
        future. (usually time.time() - stored_time)
883
    :return: String formatted to show approximate resolution
884
    """
885
    delta = int(delta)
886
    if delta >= 0:
887
        direction = 'ago'
888
    else:
889
        direction = 'in the future'
890
        delta = -delta
891
892
    seconds = delta
7143.15.2 by Jelmer Vernooij
Run autopep8.
893
    if seconds < 90:  # print seconds up to 90 seconds
1957.1.4 by John Arbash Meinel
create a helper for formatting a time delta
894
        if seconds == 1:
895
            return '%d second %s' % (seconds, direction,)
896
        else:
897
            return '%d seconds %s' % (seconds, direction)
898
899
    minutes = int(seconds / 60)
900
    seconds -= 60 * minutes
901
    if seconds == 1:
902
        plural_seconds = ''
903
    else:
904
        plural_seconds = 's'
7143.15.2 by Jelmer Vernooij
Run autopep8.
905
    if minutes < 90:  # print minutes, seconds up to 90 minutes
1957.1.4 by John Arbash Meinel
create a helper for formatting a time delta
906
        if minutes == 1:
907
            return '%d minute, %d second%s %s' % (
7143.15.2 by Jelmer Vernooij
Run autopep8.
908
                minutes, seconds, plural_seconds, direction)
1957.1.4 by John Arbash Meinel
create a helper for formatting a time delta
909
        else:
910
            return '%d minutes, %d second%s %s' % (
7143.15.2 by Jelmer Vernooij
Run autopep8.
911
                minutes, seconds, plural_seconds, direction)
1957.1.4 by John Arbash Meinel
create a helper for formatting a time delta
912
913
    hours = int(minutes / 60)
914
    minutes -= 60 * hours
915
    if minutes == 1:
916
        plural_minutes = ''
917
    else:
918
        plural_minutes = 's'
919
920
    if hours == 1:
921
        return '%d hour, %d minute%s %s' % (hours, minutes,
922
                                            plural_minutes, direction)
923
    return '%d hours, %d minute%s %s' % (hours, minutes,
924
                                         plural_minutes, direction)
1 by mbp at sourcefrog
import from baz patch-364
925
7143.15.2 by Jelmer Vernooij
Run autopep8.
926
1 by mbp at sourcefrog
import from baz patch-364
927
def filesize(f):
928
    """Return size of given open file."""
5273.1.2 by Vincent Ladeuil
Cleanup imports in osutils.py.
929
    return os.fstat(f.fileno())[stat.ST_SIZE]
1 by mbp at sourcefrog
import from baz patch-364
930
1553.5.5 by Martin Pool
New utility routine rand_chars
931
7143.15.2 by Jelmer Vernooij
Run autopep8.
932
# Alias os.urandom to support platforms (which?) without /dev/urandom and
6419.1.1 by Martin Packman
Simplify urandom alias osutils.rand_bytes based on present realities
933
# override if it doesn't work. Avoid checking on windows where there is
934
# significant initialisation cost that can be avoided for some bzr calls.
935
936
rand_bytes = os.urandom
937
938
if rand_bytes.__module__ != "nt":
2067.1.1 by John Arbash Meinel
Catch an exception while opening /dev/urandom rather than using os.path.exists()
939
    try:
6419.1.1 by Martin Packman
Simplify urandom alias osutils.rand_bytes based on present realities
940
        rand_bytes(1)
941
    except NotImplementedError:
1185.1.7 by Robert Collins
Nathaniel McCallums patch for urandom friendliness on aix.
942
        # not well seeded, but better than nothing
943
        def rand_bytes(n):
944
            import random
945
            s = ''
946
            while n:
947
                s += chr(random.randint(0, 255))
948
                n -= 1
949
            return s
1 by mbp at sourcefrog
import from baz patch-364
950
1553.5.5 by Martin Pool
New utility routine rand_chars
951
952
ALNUM = '0123456789abcdefghijklmnopqrstuvwxyz'
7143.15.2 by Jelmer Vernooij
Run autopep8.
953
954
1553.5.5 by Martin Pool
New utility routine rand_chars
955
def rand_chars(num):
956
    """Return a random string of num alphanumeric characters
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
957
958
    The result only contains lowercase chars because it may be used on
1553.5.5 by Martin Pool
New utility routine rand_chars
959
    case-insensitive filesystems.
960
    """
961
    s = ''
962
    for raw_byte in rand_bytes(num):
7479.2.1 by Jelmer Vernooij
Drop python2 support.
963
        s += ALNUM[raw_byte % 36]
1553.5.5 by Martin Pool
New utility routine rand_chars
964
    return s
965
966
7143.15.2 by Jelmer Vernooij
Run autopep8.
967
# TODO: We could later have path objects that remember their list
968
# decomposition (might be too tricksy though.)
1 by mbp at sourcefrog
import from baz patch-364
969
970
def splitpath(p):
1996.3.14 by John Arbash Meinel
lazy_import osutils and sign_my_commits
971
    """Turn string into list of parts."""
7397.5.1 by Victor Stinner
Support passing bytestring paths to osutils.splitpath.
972
    use_bytes = isinstance(p, bytes)
7121.2.1 by Jelmer Vernooij
Support adding/removing files with a name that consists of just
973
    if os.path.sep == '\\':
974
        # split on either delimiter because people might use either on
975
        # Windows
7397.5.1 by Victor Stinner
Support passing bytestring paths to osutils.splitpath.
976
        if use_bytes:
7121.2.1 by Jelmer Vernooij
Support adding/removing files with a name that consists of just
977
            ps = re.split(b'[\\\\/]', p)
978
        else:
979
            ps = re.split(r'[\\/]', p)
7067.16.1 by Jelmer Vernooij
Fix some C extensions.
980
    else:
7397.5.1 by Victor Stinner
Support passing bytestring paths to osutils.splitpath.
981
        if use_bytes:
7121.2.1 by Jelmer Vernooij
Support adding/removing files with a name that consists of just
982
            ps = p.split(b'/')
983
        else:
984
            ps = p.split('/')
271 by Martin Pool
- Windows path fixes
985
7397.5.1 by Victor Stinner
Support passing bytestring paths to osutils.splitpath.
986
    if use_bytes:
987
        parent_dir = b'..'
988
        current_empty_dir = (b'.', b'')
989
    else:
990
        parent_dir = '..'
991
        current_empty_dir = ('.', '')
992
271 by Martin Pool
- Windows path fixes
993
    rps = []
1 by mbp at sourcefrog
import from baz patch-364
994
    for f in ps:
7397.5.2 by Jelmer Vernooij
Fix test.
995
        if f == parent_dir:
6138.3.8 by Jonathan Riddell
more error gettext()ing
996
            raise errors.BzrError(gettext("sorry, %r not allowed in path") % f)
7397.5.1 by Victor Stinner
Support passing bytestring paths to osutils.splitpath.
997
        elif f in current_empty_dir:
271 by Martin Pool
- Windows path fixes
998
            pass
999
        else:
1000
            rps.append(f)
1001
    return rps
1 by mbp at sourcefrog
import from baz patch-364
1002
3890.2.4 by John Arbash Meinel
Add a new function that can convert 'chunks' format to a 'lines' format.
1003
1 by mbp at sourcefrog
import from baz patch-364
1004
def joinpath(p):
1005
    for f in p:
1963.2.6 by Robey Pointer
pychecker is on crack; go back to using 'is None'.
1006
        if (f == '..') or (f is None) or (f == ''):
6138.3.8 by Jonathan Riddell
more error gettext()ing
1007
            raise errors.BzrError(gettext("sorry, %r not allowed in path") % f)
1185.31.32 by John Arbash Meinel
Updated the bzr sourcecode to use bzrlib.osutils.pathjoin rather than os.path.join to enforce internal use of / instead of \
1008
    return pathjoin(*p)
1 by mbp at sourcefrog
import from baz patch-364
1009
1010
4370.1.1 by Ian Clatworthy
add osutils.parent_directories() API
1011
def parent_directories(filename):
4371.1.1 by Ian Clatworthy
(igc) added osutils.parent_directories() (Ian Clatworthy)
1012
    """Return the list of parent directories, deepest first.
5279.2.7 by Eric Moritz
1. deleted trailing whitespace
1013
4371.1.1 by Ian Clatworthy
(igc) added osutils.parent_directories() (Ian Clatworthy)
1014
    For example, parent_directories("a/b/c") -> ["a/b", "a"].
1015
    """
4370.1.1 by Ian Clatworthy
add osutils.parent_directories() API
1016
    parents = []
1017
    parts = splitpath(dirname(filename))
1018
    while parts:
1019
        parents.append(joinpath(parts))
1020
        parts.pop()
1021
    return parents
1022
1023
4574.3.8 by Martin Pool
Only mutter extension load errors when they occur, and record for later
1024
_extension_load_failures = []
1025
1026
1027
def failed_to_load_extension(exception):
4574.3.1 by Martin Pool
Give a warning when failing to load _chunks_to_lines_pyx
1028
    """Handle failing to load a binary extension.
1029
1030
    This should be called from the ImportError block guarding the attempt to
1031
    import the native extension.  If this function returns, the pure-Python
1032
    implementation should be loaded instead::
1033
1034
    >>> try:
6622.1.34 by Jelmer Vernooij
Rename brzlib => breezy.
1035
    >>>     import breezy._fictional_extension_pyx
4574.3.1 by Martin Pool
Give a warning when failing to load _chunks_to_lines_pyx
1036
    >>> except ImportError, e:
6622.1.34 by Jelmer Vernooij
Rename brzlib => breezy.
1037
    >>>     breezy.osutils.failed_to_load_extension(e)
1038
    >>>     import breezy._fictional_extension_py
4574.3.1 by Martin Pool
Give a warning when failing to load _chunks_to_lines_pyx
1039
    """
1040
    # NB: This docstring is just an example, not a doctest, because doctest
1041
    # currently can't cope with the use of lazy imports in this namespace --
1042
    # mbp 20090729
5279.2.7 by Eric Moritz
1. deleted trailing whitespace
1043
4574.3.8 by Martin Pool
Only mutter extension load errors when they occur, and record for later
1044
    # This currently doesn't report the failure at the time it occurs, because
1045
    # they tend to happen very early in startup when we can't check config
1046
    # files etc, and also we want to report all failures but not spam the user
1047
    # with 10 warnings.
1048
    exception_str = str(exception)
1049
    if exception_str not in _extension_load_failures:
5523.2.3 by Parth Malwankar
message is now shown to the user but is not too scary.
1050
        trace.mutter("failed to load compiled extension: %s" % exception_str)
4574.3.8 by Martin Pool
Only mutter extension load errors when they occur, and record for later
1051
        _extension_load_failures.append(exception_str)
1052
1053
1054
def report_extension_load_failures():
1055
    if not _extension_load_failures:
1056
        return
6695.2.3 by Jelmer Vernooij
Add help topic.
1057
    if config.GlobalConfig().suppress_warning('missing_extensions'):
4574.3.8 by Martin Pool
Only mutter extension load errors when they occur, and record for later
1058
        return
1059
    # the warnings framework should by default show this only once
6624 by Jelmer Vernooij
Merge Python3 porting work ('py3 pokes')
1060
    from .trace import warning
4695.4.1 by Martin Pool
Give a shorter/cleaner message for missing extensions
1061
    warning(
6622.1.4 by Jelmer Vernooij
Fix some more tests.
1062
        "brz: warning: some compiled extensions could not be loaded; "
6695.2.3 by Jelmer Vernooij
Add help topic.
1063
        "see ``brz help missing-extensions``")
4695.4.1 by Martin Pool
Give a shorter/cleaner message for missing extensions
1064
    # we no longer show the specific missing extensions here, because it makes
1065
    # the message too long and scary - see
1066
    # https://bugs.launchpad.net/bzr/+bug/430529
4574.3.1 by Martin Pool
Give a warning when failing to load _chunks_to_lines_pyx
1067
1068
3890.2.7 by John Arbash Meinel
A Pyrex extension is about 5x faster than the fastest python code I could write.
1069
try:
6624 by Jelmer Vernooij
Merge Python3 porting work ('py3 pokes')
1070
    from ._chunks_to_lines_pyx import chunks_to_lines
6619.3.2 by Jelmer Vernooij
Apply 2to3 except fix.
1071
except ImportError as e:
4574.3.8 by Martin Pool
Only mutter extension load errors when they occur, and record for later
1072
    failed_to_load_extension(e)
6624 by Jelmer Vernooij
Merge Python3 porting work ('py3 pokes')
1073
    from ._chunks_to_lines_py import chunks_to_lines
3890.2.7 by John Arbash Meinel
A Pyrex extension is about 5x faster than the fastest python code I could write.
1074
1075
1231 by Martin Pool
- more progress on fetch on top of weaves
1076
def split_lines(s):
1077
    """Split s into lines, but without removing the newline characters."""
3890.2.18 by John Arbash Meinel
Implement osutils.split_lines() in terms of chunks_to_lines if possible.
1078
    # Trivially convert a fulltext into a 'chunked' representation, and let
1079
    # chunks_to_lines do the heavy lifting.
7045.4.16 by Jelmer Vernooij
Fix some osutils tests.
1080
    if isinstance(s, bytes):
3890.2.18 by John Arbash Meinel
Implement osutils.split_lines() in terms of chunks_to_lines if possible.
1081
        # chunks_to_lines only supports 8-bit strings
1082
        return chunks_to_lines([s])
1083
    else:
1084
        return _split_lines(s)
1085
1086
1087
def _split_lines(s):
1088
    """Split s into lines, but without removing the newline characters.
1089
1090
    This supports Unicode or plain string objects.
1091
    """
6677.1.1 by Martin
Go back to native str for urls and many other py3 changes
1092
    nl = b'\n' if isinstance(s, bytes) else u'\n'
1093
    lines = s.split(nl)
1094
    result = [line + nl for line in lines[:-1]]
1666.1.6 by Robert Collins
Make knit the default format.
1095
    if lines[-1]:
1096
        result.append(lines[-1])
1097
    return result
1391 by Robert Collins
merge from integration
1098
1099
1185.10.4 by Aaron Bentley
Disabled hardlinks on cygwin, mac OS
1100
def hardlinks_good():
1185.10.5 by Aaron Bentley
Fixed hardlinks_good test
1101
    return sys.platform not in ('win32', 'cygwin', 'darwin')
1185.10.4 by Aaron Bentley
Disabled hardlinks on cygwin, mac OS
1102
1185.1.46 by Robert Collins
Aarons branch --basis patch
1103
1185.10.3 by Aaron Bentley
Made copy_multi_immutable create hardlinks opportunistically
1104
def link_or_copy(src, dest):
1105
    """Hardlink a file, or copy it if it can't be hardlinked."""
1185.10.4 by Aaron Bentley
Disabled hardlinks on cygwin, mac OS
1106
    if not hardlinks_good():
1996.3.14 by John Arbash Meinel
lazy_import osutils and sign_my_commits
1107
        shutil.copyfile(src, dest)
1185.10.3 by Aaron Bentley
Made copy_multi_immutable create hardlinks opportunistically
1108
        return
1109
    try:
1110
        os.link(src, dest)
6619.3.2 by Jelmer Vernooij
Apply 2to3 except fix.
1111
    except (OSError, IOError) as e:
1185.10.3 by Aaron Bentley
Made copy_multi_immutable create hardlinks opportunistically
1112
        if e.errno != errno.EXDEV:
1113
            raise
1996.3.14 by John Arbash Meinel
lazy_import osutils and sign_my_commits
1114
        shutil.copyfile(src, dest)
1399.1.4 by Robert Collins
move diff and symlink conditionals into inventory.py from diff.py
1115
2831.5.2 by Vincent Ladeuil
Review feedback.
1116
1117
def delete_any(path):
5279.2.7 by Eric Moritz
1. deleted trailing whitespace
1118
    """Delete a file, symlink or directory.
1119
4490.1.1 by Martin Pool
merge fix for forcing readonly deletion, and tweak
1120
    Will delete even if readonly.
1121
    """
4440.1.2 by Craig Hewetson
Fixes made after first code review.
1122
    try:
7143.15.2 by Jelmer Vernooij
Run autopep8.
1123
        _delete_file_or_dir(path)
6619.3.2 by Jelmer Vernooij
Apply 2to3 except fix.
1124
    except (OSError, IOError) as e:
4440.1.2 by Craig Hewetson
Fixes made after first code review.
1125
        if e.errno in (errno.EPERM, errno.EACCES):
4490.1.1 by Martin Pool
merge fix for forcing readonly deletion, and tweak
1126
            # make writable and try again
1127
            try:
4440.1.2 by Craig Hewetson
Fixes made after first code review.
1128
                make_writable(path)
4490.1.1 by Martin Pool
merge fix for forcing readonly deletion, and tweak
1129
            except (OSError, IOError):
4440.1.2 by Craig Hewetson
Fixes made after first code review.
1130
                pass
4490.1.1 by Martin Pool
merge fix for forcing readonly deletion, and tweak
1131
            _delete_file_or_dir(path)
1132
        else:
1133
            raise
1134
1135
1136
def _delete_file_or_dir(path):
1137
    # Look Before You Leap (LBYL) is appropriate here instead of Easier to Ask for
1138
    # Forgiveness than Permission (EAFP) because:
1139
    # - root can damage a solaris file system by using unlink,
1140
    # - unlink raises different exceptions on different OSes (linux: EISDIR, win32:
1141
    #   EACCES, OSX: EPERM) when invoked on a directory.
7143.15.2 by Jelmer Vernooij
Run autopep8.
1142
    if isdir(path):  # Takes care of symlinks
2831.5.2 by Vincent Ladeuil
Review feedback.
1143
        os.rmdir(path)
1144
    else:
1145
        os.unlink(path)
1558.12.9 by Aaron Bentley
Handle resolving conflicts with directories properly
1146
1399.1.4 by Robert Collins
move diff and symlink conditionals into inventory.py from diff.py
1147
1148
def has_symlinks():
1963.2.6 by Robey Pointer
pychecker is on crack; go back to using 'is None'.
1149
    if getattr(os, 'symlink', None) is not None:
1399.1.4 by Robert Collins
move diff and symlink conditionals into inventory.py from diff.py
1150
        return True
1151
    else:
1152
        return False
2831.5.2 by Vincent Ladeuil
Review feedback.
1153
1185.16.38 by Martin Pool
- move contains_whitespace and contains_linebreaks to osutils
1154
3136.1.1 by Aaron Bentley
Add support for hardlinks to TreeTransform
1155
def has_hardlinks():
1156
    if getattr(os, 'link', None) is not None:
1157
        return True
1158
    else:
1159
        return False
1160
1161
3287.18.14 by Matt McClure
Extracted a host_os_dereferences_symlinks method.
1162
def host_os_dereferences_symlinks():
1163
    return (has_symlinks()
3287.18.19 by Matt McClure
Changed tested sys.platform value from 'windows' (mistaken) to 'win32'
1164
            and sys.platform not in ('cygwin', 'win32'))
3287.18.14 by Matt McClure
Extracted a host_os_dereferences_symlinks method.
1165
1166
4241.14.14 by Vincent Ladeuil
Test and implements osutils.readlink().
1167
def readlink(abspath):
1168
    """Return a string representing the path to which the symbolic link points.
1169
1170
    :param abspath: The link absolute unicode path.
1171
1172
    This his guaranteed to return the symbolic link in unicode in all python
1173
    versions.
1174
    """
1175
    link = abspath.encode(_fs_enc)
1176
    target = os.readlink(link)
1177
    target = target.decode(_fs_enc)
1178
    return target
1179
1180
1185.16.38 by Martin Pool
- move contains_whitespace and contains_linebreaks to osutils
1181
def contains_whitespace(s):
1182
    """True if there are any whitespace characters in s."""
2249.2.1 by John Arbash Meinel
(John Arbash Meinel) hard-code the whitespace chars to avoid problems in some locales.
1183
    # string.whitespace can include '\xa0' in certain locales, because it is
1184
    # considered "non-breaking-space" as part of ISO-8859-1. But it
1185
    # 1) Isn't a breaking whitespace
1186
    # 2) Isn't one of ' \t\r\n' which are characters we sometimes use as
1187
    #    separators
1188
    # 3) '\xa0' isn't unicode safe since it is >128.
2249.5.16 by John Arbash Meinel
[merge] bzr.dev 2283
1189
6684.1.3 by Martin
Changes across many modules working towards Python 3 support
1190
    if isinstance(s, str):
1191
        ws = ' \t\n\r\v\f'
1192
    else:
1193
        ws = (b' ', b'\t', b'\n', b'\r', b'\v', b'\f')
1194
    for ch in ws:
1185.16.38 by Martin Pool
- move contains_whitespace and contains_linebreaks to osutils
1195
        if ch in s:
1196
            return True
1197
    else:
1198
        return False
1199
1200
1201
def contains_linebreaks(s):
1202
    """True if there is any vertical whitespace in s."""
1203
    for ch in '\f\n\r':
1204
        if ch in s:
1205
            return True
1206
    else:
1207
        return False
1457.1.2 by Robert Collins
move branch._relpath into osutils as relpath
1208
1209
1210
def relpath(base, path):
5193.2.1 by Alexander Belchenko
update docstring for osutils.relpath() function.
1211
    """Return path relative to base, or raise PathNotChild exception.
1457.1.2 by Robert Collins
move branch._relpath into osutils as relpath
1212
1213
    The path may be either an absolute path or a path relative to the
1214
    current working directory.
1215
1216
    os.path.commonprefix (python2.4) has a bad bug that it works just
1217
    on string prefixes, assuming that '/u' is a prefix of '/u2'.  This
1636.1.1 by Robert Collins
Fix calling relpath() and abspath() on transports at their root.
1218
    avoids that problem.
5193.2.1 by Alexander Belchenko
update docstring for osutils.relpath() function.
1219
5193.2.2 by Alexander Belchenko
update wording based on spiv's review.
1220
    NOTE: `base` should not have a trailing slash otherwise you'll get
1221
    PathNotChild exceptions regardless of `path`.
1636.1.1 by Robert Collins
Fix calling relpath() and abspath() on transports at their root.
1222
    """
1685.1.12 by John Arbash Meinel
Some more work to get LocalTransport to only support URLs
1223
3376.2.4 by Martin Pool
Remove every assert statement from bzrlib!
1224
    if len(base) < MIN_ABS_PATHLENGTH:
1225
        # must have space for e.g. a drive letter
6138.3.8 by Jonathan Riddell
more error gettext()ing
1226
        raise ValueError(gettext('%r is too short to calculate a relative path')
7143.15.2 by Jelmer Vernooij
Run autopep8.
1227
                         % (base,))
1685.1.9 by John Arbash Meinel
Updated LocalTransport so that it's base is now a URL rather than a local path. This helps consistency with all other functions. To do so, I added local_abspath() which returns the local path, and local_path_to/from_url
1228
1685.1.12 by John Arbash Meinel
Some more work to get LocalTransport to only support URLs
1229
    rp = abspath(path)
1457.1.2 by Robert Collins
move branch._relpath into osutils as relpath
1230
1231
    s = []
1685.1.12 by John Arbash Meinel
Some more work to get LocalTransport to only support URLs
1232
    head = rp
4555.2.1 by John Arbash Meinel
Fix bug #394227, osutils.relpath() could get into an infinite loop.
1233
    while True:
1234
        if len(head) <= len(base) and head != base:
1235
            raise errors.PathNotChild(rp, base)
1457.1.2 by Robert Collins
move branch._relpath into osutils as relpath
1236
        if head == base:
1237
            break
4555.2.1 by John Arbash Meinel
Fix bug #394227, osutils.relpath() could get into an infinite loop.
1238
        head, tail = split(head)
1457.1.2 by Robert Collins
move branch._relpath into osutils as relpath
1239
        if tail:
4555.2.1 by John Arbash Meinel
Fix bug #394227, osutils.relpath() could get into an infinite loop.
1240
            s.append(tail)
1457.1.2 by Robert Collins
move branch._relpath into osutils as relpath
1241
1185.31.35 by John Arbash Meinel
Couple small fixes, all tests pass on cygwin.
1242
    if s:
4555.2.3 by John Arbash Meinel
Fix a trivial bug that should have been caught earlier. :)
1243
        return pathjoin(*reversed(s))
1185.31.35 by John Arbash Meinel
Couple small fixes, all tests pass on cygwin.
1244
    else:
1245
        return ''
1185.33.60 by Martin Pool
Use full terminal width for verbose test output.
1246
1247
3794.5.29 by Mark Hammond
cicp_canonical_relpath -> _cicp_canonical_relpath
1248
def _cicp_canonical_relpath(base, path):
3794.5.1 by Mark Hammond
Add canonical_relpath api function
1249
    """Return the canonical path relative to base.
1250
1251
    Like relpath, but on case-insensitive-case-preserving file-systems, this
3794.5.13 by Mark Hammond
Tweaks suggested by Martin
1252
    will return the relpath as stored on the file-system rather than in the
1253
    case specified in the input string, for all existing portions of the path.
1254
3794.5.28 by Mark Hammond
Update comments.
1255
    This will cause O(N) behaviour if called for every path in a tree; if you
1256
    have a number of paths to convert, you should use canonical_relpaths().
3794.5.31 by Mark Hammond
bulk of the simple review comments from igc.
1257
    """
1258
    # TODO: it should be possible to optimize this for Windows by using the
1259
    # win32 API FindFiles function to look for the specified name - but using
1260
    # os.listdir() still gives us the correct, platform agnostic semantics in
1261
    # the short term.
3794.5.13 by Mark Hammond
Tweaks suggested by Martin
1262
3794.5.1 by Mark Hammond
Add canonical_relpath api function
1263
    rel = relpath(base, path)
1264
    # '.' will have been turned into ''
1265
    if not rel:
1266
        return rel
1267
1268
    abs_base = abspath(base)
1269
    current = abs_base
1270
1271
    # use an explicit iterator so we can easily consume the rest on early exit.
3794.5.36 by Mark Hammond
test for, and fix problem with canonical_relpath when the tail does not exist.
1272
    bit_iter = iter(rel.split('/'))
3794.5.1 by Mark Hammond
Add canonical_relpath api function
1273
    for bit in bit_iter:
1274
        lbit = bit.lower()
4634.70.2 by John Arbash Meinel
Fix bug #322807, teach cicp_canonical_relpath how to handle
1275
        try:
7489.5.3 by Jelmer Vernooij
use scandir rather than listdir.
1276
            next_entries = scandir(current)
7143.15.2 by Jelmer Vernooij
Run autopep8.
1277
        except OSError:  # enoent, eperm, etc
4634.70.3 by John Arbash Meinel
Clean up some terminology, catch a double _listdir request, thanks spiv.
1278
            # We can't find this in the filesystem, so just append the
1279
            # remaining bits.
4634.70.2 by John Arbash Meinel
Fix bug #322807, teach cicp_canonical_relpath how to handle
1280
            current = pathjoin(current, bit, *list(bit_iter))
1281
            break
7489.5.3 by Jelmer Vernooij
use scandir rather than listdir.
1282
        for entry in next_entries:
1283
            if lbit == entry.name.lower():
1284
                current = entry.path
3794.5.1 by Mark Hammond
Add canonical_relpath api function
1285
                break
1286
        else:
1287
            # got to the end, nothing matched, so we just return the
1288
            # non-existing bits as they were specified (the filename may be
1289
            # the target of a move, for example).
1290
            current = pathjoin(current, bit, *list(bit_iter))
1291
            break
4634.70.2 by John Arbash Meinel
Fix bug #322807, teach cicp_canonical_relpath how to handle
1292
    return current[len(abs_base):].lstrip('/')
3794.5.1 by Mark Hammond
Add canonical_relpath api function
1293
7143.15.2 by Jelmer Vernooij
Run autopep8.
1294
3794.5.13 by Mark Hammond
Tweaks suggested by Martin
1295
# XXX - TODO - we need better detection/integration of case-insensitive
4241.9.5 by Vincent Ladeuil
Fix unicode related OSX failures.
1296
# file-systems; Linux often sees FAT32 devices (or NFS-mounted OSX
1297
# filesystems), for example, so could probably benefit from the same basic
1298
# support there.  For now though, only Windows and OSX get that support, and
1299
# they get it for *all* file-systems!
4241.9.2 by Vincent Ladeuil
Fix most of cicp related failures on OSX.
1300
if sys.platform in ('win32', 'darwin'):
3794.5.29 by Mark Hammond
cicp_canonical_relpath -> _cicp_canonical_relpath
1301
    canonical_relpath = _cicp_canonical_relpath
3794.5.1 by Mark Hammond
Add canonical_relpath api function
1302
else:
1303
    canonical_relpath = relpath
1304
7143.15.2 by Jelmer Vernooij
Run autopep8.
1305
3794.5.15 by Mark Hammond
Add canonical_relpaths() as a placeholder for a future caching implementation.
1306
def canonical_relpaths(base, paths):
1307
    """Create an iterable to canonicalize a sequence of relative paths.
1308
1309
    The intent is for this implementation to use a cache, vastly speeding
1310
    up multiple transformations in the same directory.
1311
    """
1312
    # but for now, we haven't optimized...
1313
    return [canonical_relpath(base, p) for p in paths]
3794.5.1 by Mark Hammond
Add canonical_relpath api function
1314
5279.2.7 by Eric Moritz
1. deleted trailing whitespace
1315
1316
def decode_filename(filename):
1317
    """Decode the filename using the filesystem encoding
1318
1319
    If it is unicode, it is returned.
1320
    Otherwise it is decoded from the the filesystem's encoding. If decoding
1321
    fails, a errors.BadFilenameEncoding exception is raised.
1322
    """
7479.2.1 by Jelmer Vernooij
Drop python2 support.
1323
    if isinstance(filename, str):
5279.2.4 by Eric Moritz
Added the filename_decode
1324
        return filename
5279.2.7 by Eric Moritz
1. deleted trailing whitespace
1325
    try:
1326
        return filename.decode(_fs_enc)
1327
    except UnicodeDecodeError:
1328
        raise errors.BadFilenameEncoding(filename, _fs_enc)
1329
5279.2.4 by Eric Moritz
Added the filename_decode
1330
1534.3.1 by Robert Collins
* bzrlib.osutils.safe_unicode now exists to provide parameter coercion
1331
def safe_unicode(unicode_or_utf8_string):
1332
    """Coerce unicode_or_utf8_string into unicode.
1333
1334
    If it is unicode, it is returned.
4204.2.1 by Matt Nordhoff
Fix a broken sentence in osutils.safe_unicode's docstring
1335
    Otherwise it is decoded from utf-8. If decoding fails, the exception is
1336
    wrapped in a BzrBadParameterNotUnicode exception.
1534.3.1 by Robert Collins
* bzrlib.osutils.safe_unicode now exists to provide parameter coercion
1337
    """
7479.2.1 by Jelmer Vernooij
Drop python2 support.
1338
    if isinstance(unicode_or_utf8_string, str):
1534.3.1 by Robert Collins
* bzrlib.osutils.safe_unicode now exists to provide parameter coercion
1339
        return unicode_or_utf8_string
1340
    try:
1341
        return unicode_or_utf8_string.decode('utf8')
1342
    except UnicodeDecodeError:
1996.3.25 by John Arbash Meinel
Make importing errors lazy for osutils
1343
        raise errors.BzrBadParameterNotUnicode(unicode_or_utf8_string)
1534.3.1 by Robert Collins
* bzrlib.osutils.safe_unicode now exists to provide parameter coercion
1344
1345
2249.5.8 by John Arbash Meinel
Add osutils.safe_utf8 and safe_revision_id for the new revision_id work.
1346
def safe_utf8(unicode_or_utf8_string):
1347
    """Coerce unicode_or_utf8_string to a utf8 string.
1348
1349
    If it is a str, it is returned.
1350
    If it is Unicode, it is encoded into a utf-8 string.
1351
    """
6684.1.3 by Martin
Changes across many modules working towards Python 3 support
1352
    if isinstance(unicode_or_utf8_string, bytes):
2249.5.8 by John Arbash Meinel
Add osutils.safe_utf8 and safe_revision_id for the new revision_id work.
1353
        # TODO: jam 20070209 This is overkill, and probably has an impact on
1354
        #       performance if we are dealing with lots of apis that want a
1355
        #       utf-8 revision id
1356
        try:
1357
            # Make sure it is a valid utf-8 string
1358
            unicode_or_utf8_string.decode('utf-8')
1359
        except UnicodeDecodeError:
1360
            raise errors.BzrBadParameterNotUnicode(unicode_or_utf8_string)
1361
        return unicode_or_utf8_string
1362
    return unicode_or_utf8_string.encode('utf-8')
1363
1364
1185.85.75 by John Arbash Meinel
Adding bzrlib.osutils.unicode_filename to handle unicode normalization for file paths.
1365
_platform_normalizes_filenames = False
1366
if sys.platform == 'darwin':
1367
    _platform_normalizes_filenames = True
1368
1369
1370
def normalizes_filenames():
1371
    """Return True if this platform normalizes unicode filenames.
1372
5283.2.1 by Martin Pool
Additional platform name tweaks
1373
    Only Mac OSX.
1185.85.75 by John Arbash Meinel
Adding bzrlib.osutils.unicode_filename to handle unicode normalization for file paths.
1374
    """
1375
    return _platform_normalizes_filenames
1376
1377
1830.3.2 by John Arbash Meinel
normalized_filename is a much better name
1378
def _accessible_normalized_filename(path):
1830.3.1 by John Arbash Meinel
Change the return value of unicode_filename, and make it testable on all platforms
1379
    """Get the unicode normalized path, and if you can access the file.
1380
1381
    On platforms where the system normalizes filenames (Mac OSX),
1382
    you can access a file by any path which will normalize correctly.
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
1383
    On platforms where the system does not normalize filenames
5283.2.1 by Martin Pool
Additional platform name tweaks
1384
    (everything else), you have to access a file by its exact path.
1830.3.1 by John Arbash Meinel
Change the return value of unicode_filename, and make it testable on all platforms
1385
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
1386
    Internally, bzr only supports NFC normalization, since that is
1830.3.1 by John Arbash Meinel
Change the return value of unicode_filename, and make it testable on all platforms
1387
    the standard for XML documents.
1388
1389
    So return the normalized path, and a flag indicating if the file
1390
    can be accessed by that path.
1391
    """
1392
6973.6.4 by Jelmer Vernooij
Avoid text_type()
1393
    if isinstance(path, bytes):
1394
        path = path.decode(sys.getfilesystemencoding())
1395
    return unicodedata.normalize('NFC', path), True
1830.3.1 by John Arbash Meinel
Change the return value of unicode_filename, and make it testable on all platforms
1396
1397
1830.3.2 by John Arbash Meinel
normalized_filename is a much better name
1398
def _inaccessible_normalized_filename(path):
1399
    __doc__ = _accessible_normalized_filename.__doc__
1830.3.1 by John Arbash Meinel
Change the return value of unicode_filename, and make it testable on all platforms
1400
6973.6.4 by Jelmer Vernooij
Avoid text_type()
1401
    if isinstance(path, bytes):
1402
        path = path.decode(sys.getfilesystemencoding())
1403
    normalized = unicodedata.normalize('NFC', path)
1830.3.1 by John Arbash Meinel
Change the return value of unicode_filename, and make it testable on all platforms
1404
    return normalized, normalized == path
1405
1406
1185.85.75 by John Arbash Meinel
Adding bzrlib.osutils.unicode_filename to handle unicode normalization for file paths.
1407
if _platform_normalizes_filenames:
1830.3.2 by John Arbash Meinel
normalized_filename is a much better name
1408
    normalized_filename = _accessible_normalized_filename
1185.85.75 by John Arbash Meinel
Adding bzrlib.osutils.unicode_filename to handle unicode normalization for file paths.
1409
else:
1830.3.2 by John Arbash Meinel
normalized_filename is a much better name
1410
    normalized_filename = _inaccessible_normalized_filename
1185.85.75 by John Arbash Meinel
Adding bzrlib.osutils.unicode_filename to handle unicode normalization for file paths.
1411
1412
4634.142.2 by Andrew Bennetts
Make calling siginterrupt in set_signal_handler conditional on a restart_syscall param (default True), and add missing import.
1413
def set_signal_handler(signum, handler, restart_syscall=True):
4634.142.1 by Andrew Bennetts
Add osutils.set_signal_handler to call signal.siginterrupt where possible, and use it in bzrlib.
1414
    """A wrapper for signal.signal that also calls siginterrupt(signum, False)
1415
    on platforms that support that.
4634.142.2 by Andrew Bennetts
Make calling siginterrupt in set_signal_handler conditional on a restart_syscall param (default True), and add missing import.
1416
1417
    :param restart_syscall: if set, allow syscalls interrupted by a signal to
1418
        automatically restart (by calling `signal.siginterrupt(signum,
1419
        False)`).  May be ignored if the feature is not available on this
1420
        platform or Python version.
4634.142.1 by Andrew Bennetts
Add osutils.set_signal_handler to call signal.siginterrupt where possible, and use it in bzrlib.
1421
    """
5141.4.1 by Andrew Bennetts
Reset siginterrupt every time we handle a signal.
1422
    try:
5169.2.2 by Vincent Ladeuil
Just rely on python to tell us what it supports.
1423
        import signal
5141.4.1 by Andrew Bennetts
Reset siginterrupt every time we handle a signal.
1424
        siginterrupt = signal.siginterrupt
5169.2.2 by Vincent Ladeuil
Just rely on python to tell us what it supports.
1425
    except ImportError:
1426
        # This python implementation doesn't provide signal support, hence no
1427
        # handler exists
1428
        return None
5141.4.1 by Andrew Bennetts
Reset siginterrupt every time we handle a signal.
1429
    except AttributeError:
1430
        # siginterrupt doesn't exist on this platform, or for this version
1431
        # of Python.
7143.15.2 by Jelmer Vernooij
Run autopep8.
1432
        def siginterrupt(signum, flag): return None
4634.142.2 by Andrew Bennetts
Make calling siginterrupt in set_signal_handler conditional on a restart_syscall param (default True), and add missing import.
1433
    if restart_syscall:
5141.4.1 by Andrew Bennetts
Reset siginterrupt every time we handle a signal.
1434
        def sig_handler(*args):
1435
            # Python resets the siginterrupt flag when a signal is
5141.4.3 by Andrew Bennetts
Link to Python bug in comment.
1436
            # received.  <http://bugs.python.org/issue8354>
1437
            # As a workaround for some cases, set it back the way we want it.
4634.142.2 by Andrew Bennetts
Make calling siginterrupt in set_signal_handler conditional on a restart_syscall param (default True), and add missing import.
1438
            siginterrupt(signum, False)
5141.4.1 by Andrew Bennetts
Reset siginterrupt every time we handle a signal.
1439
            # Now run the handler function passed to set_signal_handler.
1440
            handler(*args)
1441
    else:
1442
        sig_handler = handler
1443
    old_handler = signal.signal(signum, sig_handler)
1444
    if restart_syscall:
1445
        siginterrupt(signum, False)
4634.142.1 by Andrew Bennetts
Add osutils.set_signal_handler to call signal.siginterrupt where possible, and use it in bzrlib.
1446
    return old_handler
1447
1448
4747.3.6 by Vincent Ladeuil
terminal_width can now returns None.
1449
default_terminal_width = 80
1450
"""The default terminal width for ttys.
1451
1452
This is defined so that higher levels can share a common fallback value when
1453
terminal_width() returns None.
1454
"""
1455
4797.54.2 by Andrew Bennetts
Try to preserve the 'use COLUMNS until SIGWINCH' behaviour without using SIGWINCH, to keep the behaviour in 2.1 as stable as possible.
1456
# Keep some state so that terminal_width can detect if _terminal_size has
1457
# returned a different size since the process started.  See docstring and
1458
# comments of terminal_width for details.
1459
# _terminal_size_state has 3 possible values: no_data, unchanged, and changed.
1460
_terminal_size_state = 'no_data'
1461
_first_terminal_size = None
4747.3.6 by Vincent Ladeuil
terminal_width can now returns None.
1462
7143.15.2 by Jelmer Vernooij
Run autopep8.
1463
1185.33.60 by Martin Pool
Use full terminal width for verbose test output.
1464
def terminal_width():
4747.3.6 by Vincent Ladeuil
terminal_width can now returns None.
1465
    """Return terminal width.
1466
1467
    None is returned if the width can't established precisely.
4747.4.5 by Vincent Ladeuil
More robusts tests for osutils.terminal_width().
1468
1469
    The rules are:
6622.1.28 by Jelmer Vernooij
More renames; commands in output, environment variables.
1470
    - if BRZ_COLUMNS is set, returns its value
4747.4.5 by Vincent Ladeuil
More robusts tests for osutils.terminal_width().
1471
    - if there is no controlling terminal, returns None
4797.54.2 by Andrew Bennetts
Try to preserve the 'use COLUMNS until SIGWINCH' behaviour without using SIGWINCH, to keep the behaviour in 2.1 as stable as possible.
1472
    - query the OS, if the queried size has changed since the last query,
1473
      return its value,
4747.4.5 by Vincent Ladeuil
More robusts tests for osutils.terminal_width().
1474
    - if COLUMNS is set, returns its value,
4797.54.2 by Andrew Bennetts
Try to preserve the 'use COLUMNS until SIGWINCH' behaviour without using SIGWINCH, to keep the behaviour in 2.1 as stable as possible.
1475
    - if the OS has a value (even though it's never changed), return its value.
4747.4.5 by Vincent Ladeuil
More robusts tests for osutils.terminal_width().
1476
1477
    From there, we need to query the OS to get the size of the controlling
1478
    terminal.
1479
4797.54.2 by Andrew Bennetts
Try to preserve the 'use COLUMNS until SIGWINCH' behaviour without using SIGWINCH, to keep the behaviour in 2.1 as stable as possible.
1480
    On Unices we query the OS by:
4747.4.5 by Vincent Ladeuil
More robusts tests for osutils.terminal_width().
1481
    - get termios.TIOCGWINSZ
1482
    - if an error occurs or a negative value is obtained, returns None
1483
4797.54.2 by Andrew Bennetts
Try to preserve the 'use COLUMNS until SIGWINCH' behaviour without using SIGWINCH, to keep the behaviour in 2.1 as stable as possible.
1484
    On Windows we query the OS by:
4747.4.5 by Vincent Ladeuil
More robusts tests for osutils.terminal_width().
1485
    - win32utils.get_console_size() decides,
1486
    - returns None on error (provided default value)
4747.3.6 by Vincent Ladeuil
terminal_width can now returns None.
1487
    """
4797.54.2 by Andrew Bennetts
Try to preserve the 'use COLUMNS until SIGWINCH' behaviour without using SIGWINCH, to keep the behaviour in 2.1 as stable as possible.
1488
    # Note to implementors: if changing the rules for determining the width,
1489
    # make sure you've considered the behaviour in these cases:
1490
    #  - M-x shell in emacs, where $COLUMNS is set and TIOCGWINSZ returns 0,0.
6622.1.30 by Jelmer Vernooij
Some more test fixes.
1491
    #  - brz log | less, in bash, where $COLUMNS not set and TIOCGWINSZ returns
4797.54.2 by Andrew Bennetts
Try to preserve the 'use COLUMNS until SIGWINCH' behaviour without using SIGWINCH, to keep the behaviour in 2.1 as stable as possible.
1492
    #    0,0.
1493
    #  - (add more interesting cases here, if you find any)
1494
    # Some programs implement "Use $COLUMNS (if set) until SIGWINCH occurs",
1495
    # but we don't want to register a signal handler because it is impossible
1496
    # to do so without risking EINTR errors in Python <= 2.6.5 (see
1497
    # <http://bugs.python.org/issue8354>).  Instead we check TIOCGWINSZ every
1498
    # time so we can notice if the reported size has changed, which should have
1499
    # a similar effect.
4747.3.4 by Vincent Ladeuil
Add tests, introduce explicit default values, always respect COLUMNS.
1500
6622.1.28 by Jelmer Vernooij
More renames; commands in output, environment variables.
1501
    # If BRZ_COLUMNS is set, take it, user is always right
5582.7.1 by Neil Martinsen-Burrell
allow BZR_COLUMNS to be 0
1502
    # Except if they specified 0 in which case, impose no limit here
4747.3.7 by Vincent Ladeuil
Introduce BZR_COLUMNS since COLUMNS behaviour is too obscure.
1503
    try:
6622.1.28 by Jelmer Vernooij
More renames; commands in output, environment variables.
1504
        width = int(os.environ['BRZ_COLUMNS'])
4747.3.7 by Vincent Ladeuil
Introduce BZR_COLUMNS since COLUMNS behaviour is too obscure.
1505
    except (KeyError, ValueError):
5582.7.1 by Neil Martinsen-Burrell
allow BZR_COLUMNS to be 0
1506
        width = None
1507
    if width is not None:
1508
        if width > 0:
1509
            return width
1510
        else:
1511
            return None
4747.3.7 by Vincent Ladeuil
Introduce BZR_COLUMNS since COLUMNS behaviour is too obscure.
1512
4747.3.3 by Vincent Ladeuil
More complete fix (previous one changed the focus).
1513
    isatty = getattr(sys.stdout, 'isatty', None)
4797.54.1 by Andrew Bennetts
Remove the SIGWINCH signal handler.
1514
    if isatty is None or not isatty():
6622.1.28 by Jelmer Vernooij
More renames; commands in output, environment variables.
1515
        # Don't guess, setting BRZ_COLUMNS is the recommended way to override.
4747.3.6 by Vincent Ladeuil
terminal_width can now returns None.
1516
        return None
4747.3.1 by Joke de Buhr
Prevent linebreaks in output if it's not connected to a tty.
1517
4797.54.2 by Andrew Bennetts
Try to preserve the 'use COLUMNS until SIGWINCH' behaviour without using SIGWINCH, to keep the behaviour in 2.1 as stable as possible.
1518
    # Query the OS
1519
    width, height = os_size = _terminal_size(None, None)
1520
    global _first_terminal_size, _terminal_size_state
1521
    if _terminal_size_state == 'no_data':
1522
        _first_terminal_size = os_size
1523
        _terminal_size_state = 'unchanged'
1524
    elif (_terminal_size_state == 'unchanged' and
1525
          _first_terminal_size != os_size):
1526
        _terminal_size_state = 'changed'
1527
1528
    # If the OS claims to know how wide the terminal is, and this value has
1529
    # ever changed, use that.
1530
    if _terminal_size_state == 'changed':
1531
        if width is not None and width > 0:
1532
            return width
4797.54.1 by Andrew Bennetts
Remove the SIGWINCH signal handler.
1533
1534
    # If COLUMNS is set, use it.
4747.4.3 by Vincent Ladeuil
Re-fix the priority order since there is a known valid case.
1535
    try:
1536
        return int(os.environ['COLUMNS'])
1537
    except (KeyError, ValueError):
1538
        pass
1539
4797.54.2 by Andrew Bennetts
Try to preserve the 'use COLUMNS until SIGWINCH' behaviour without using SIGWINCH, to keep the behaviour in 2.1 as stable as possible.
1540
    # Finally, use an unchanged size from the OS, if we have one.
1541
    if _terminal_size_state == 'unchanged':
1542
        if width is not None and width > 0:
1543
            return width
1544
1545
    # The width could not be determined.
4797.54.1 by Andrew Bennetts
Remove the SIGWINCH signal handler.
1546
    return None
4747.4.5 by Vincent Ladeuil
More robusts tests for osutils.terminal_width().
1547
1548
1549
def _win32_terminal_size(width, height):
7143.15.2 by Jelmer Vernooij
Run autopep8.
1550
    width, height = win32utils.get_console_size(
1551
        defaultx=width, defaulty=height)
4747.4.5 by Vincent Ladeuil
More robusts tests for osutils.terminal_width().
1552
    return width, height
1553
1554
1555
def _ioctl_terminal_size(width, height):
1185.33.60 by Martin Pool
Use full terminal width for verbose test output.
1556
    try:
7143.15.2 by Jelmer Vernooij
Run autopep8.
1557
        import struct
1558
        import fcntl
1559
        import termios
1704.2.2 by Martin Pool
Detect terminal width using ioctl
1560
        s = struct.pack('HHHH', 0, 0, 0, 0)
1561
        x = fcntl.ioctl(1, termios.TIOCGWINSZ, s)
4747.4.6 by Vincent Ladeuil
Fix parameter order.
1562
        height, width = struct.unpack('HHHH', x)[0:2]
4747.3.4 by Vincent Ladeuil
Add tests, introduce explicit default values, always respect COLUMNS.
1563
    except (IOError, AttributeError):
4747.4.5 by Vincent Ladeuil
More robusts tests for osutils.terminal_width().
1564
        pass
1565
    return width, height
1566
7143.15.2 by Jelmer Vernooij
Run autopep8.
1567
4747.4.5 by Vincent Ladeuil
More robusts tests for osutils.terminal_width().
1568
_terminal_size = None
1569
"""Returns the terminal size as (width, height).
1570
1571
:param width: Default value for width.
1572
:param height: Default value for height.
1573
1574
This is defined specifically for each OS and query the size of the controlling
1575
terminal. If any error occurs, the provided default values should be returned.
1576
"""
1577
if sys.platform == 'win32':
1578
    _terminal_size = _win32_terminal_size
1579
else:
1580
    _terminal_size = _ioctl_terminal_size
1534.7.25 by Aaron Bentley
Added set_executability
1581
1963.1.5 by John Arbash Meinel
Create an osutils helper function for modifying the environment
1582
7122.7.1 by Jelmer Vernooij
Check for fs type to determine whether executable bit is supported.
1583
def supports_executable(path):
7122.7.2 by Jelmer Vernooij
Add tests.
1584
    """Return if filesystem at path supports executable bit.
1585
1586
    :param path: Path for which to check the file system
1587
    :return: boolean indicating whether executable bit can be stored/relied upon
1588
    """
7122.7.1 by Jelmer Vernooij
Check for fs type to determine whether executable bit is supported.
1589
    if sys.platform == 'win32':
1590
        return False
7122.7.7 by Jelmer Vernooij
cope with psutil not being available.
1591
    try:
1592
        fs_type = get_fs_type(path)
7122.6.7 by Jelmer Vernooij
Review comments.
1593
    except errors.DependencyNotPresent as e:
1594
        trace.mutter('Unable to get fs type for %r: %s', path, e)
7122.7.7 by Jelmer Vernooij
cope with psutil not being available.
1595
    else:
1596
        if fs_type in ('vfat', 'ntfs'):
1597
            # filesystems known to not support executable bit
1598
            return False
7122.7.1 by Jelmer Vernooij
Check for fs type to determine whether executable bit is supported.
1599
    return True
1551.2.53 by abentley
Strip trailing slashes in a platform-sensible way
1600
1601
7122.7.8 by Jelmer Vernooij
Add osutils.supports_symlinks.
1602
def supports_symlinks(path):
1603
    """Return if the filesystem at path supports the creation of symbolic links.
1604
1605
    """
1606
    if not has_symlinks():
1607
        return False
1608
    try:
1609
        fs_type = get_fs_type(path)
7122.6.7 by Jelmer Vernooij
Review comments.
1610
    except errors.DependencyNotPresent as e:
1611
        trace.mutter('Unable to get fs type for %r: %s', path, e)
7122.7.8 by Jelmer Vernooij
Add osutils.supports_symlinks.
1612
    else:
1613
        if fs_type in ('vfat', 'ntfs'):
7122.6.9 by Jelmer Vernooij
Fix tests on python 2.
1614
            # filesystems known to not support symlinks
7122.7.8 by Jelmer Vernooij
Add osutils.supports_symlinks.
1615
            return False
1616
    return True
1617
1618
1551.10.4 by Aaron Bentley
Update to skip on win32
1619
def supports_posix_readonly():
1620
    """Return True if 'readonly' has POSIX semantics, False otherwise.
1621
1622
    Notably, a win32 readonly file cannot be deleted, unlike POSIX where the
1623
    directory controls creation/deletion, etc.
1624
1625
    And under win32, readonly means that the directory itself cannot be
1626
    deleted.  The contents of a readonly directory can be changed, unlike POSIX
1627
    where files in readonly directories cannot be added, deleted or renamed.
1628
    """
1629
    return sys.platform != "win32"
1630
1631
1963.1.5 by John Arbash Meinel
Create an osutils helper function for modifying the environment
1632
def set_or_unset_env(env_variable, value):
1633
    """Modify the environment, setting or removing the env_variable.
1634
1635
    :param env_variable: The environment variable in question
1636
    :param value: The value to set the environment to. If None, then
1637
        the variable will be removed.
1638
    :return: The original value of the environment variable.
1639
    """
1640
    orig_val = os.environ.get(env_variable)
1641
    if value is None:
1642
        if orig_val is not None:
1643
            del os.environ[env_variable]
1644
    else:
1645
        os.environ[env_variable] = value
1646
    return orig_val
1647
1648
1551.2.56 by Aaron Bentley
Better illegal pathname check for Windows
1649
_validWin32PathRE = re.compile(r'^([A-Za-z]:[/\\])?[^:<>*"?\|]*$')
1650
1651
1652
def check_legal_path(path):
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
1653
    """Check whether the supplied path is legal.
1551.2.56 by Aaron Bentley
Better illegal pathname check for Windows
1654
    This is only required on Windows, so we don't test on other platforms
1655
    right now.
1656
    """
1657
    if sys.platform != "win32":
1658
        return
1659
    if _validWin32PathRE.match(path) is None:
1996.3.25 by John Arbash Meinel
Make importing errors lazy for osutils
1660
        raise errors.IllegalPath(path)
1753.1.1 by Robert Collins
(rbc, jam, mbp)Add bzrlib.osutils.walkdirs, an optimised walk-and-stat routine.
1661
1662
7143.15.2 by Jelmer Vernooij
Run autopep8.
1663
_WIN32_ERROR_DIRECTORY = 267  # Similar to errno.ENOTDIR
1664
3596.2.2 by John Arbash Meinel
Factor out the common exception handling looking for ENOTDIR and use it
1665
7489.5.2 by Jelmer Vernooij
Factor out scandir.
1666
try:
1667
    scandir = os.scandir
1668
except AttributeError:  # Python < 3
7489.5.4 by Jelmer Vernooij
Fix tests.
1669
    lazy_import(globals(), """\
1670
from scandir import scandir
1671
""")
1672
1673
1674
def _is_error_enotdir(e):
1675
    """Check if this exception represents ENOTDIR.
1676
1677
    Unfortunately, python is very inconsistent about the exception
1678
    here. The cases are:
1679
      1) Linux, Mac OSX all versions seem to set errno == ENOTDIR
1680
      2) Windows, Python2.4, uses errno == ERROR_DIRECTORY (267)
1681
         which is the windows error code.
1682
      3) Windows, Python2.5 uses errno == EINVAL and
1683
         winerror == ERROR_DIRECTORY
1684
1685
    :param e: An Exception object (expected to be OSError with an errno
1686
        attribute, but we should be able to cope with anything)
1687
    :return: True if this represents an ENOTDIR error. False otherwise.
1688
    """
1689
    en = getattr(e, 'errno', None)
1690
    if (en == errno.ENOTDIR or
1691
        (sys.platform == 'win32' and
1692
            (en == _WIN32_ERROR_DIRECTORY or
1693
             (en == errno.EINVAL
1694
              and getattr(e, 'winerror', None) == _WIN32_ERROR_DIRECTORY)
1695
             ))):
1696
        return True
1697
    return False
7489.5.2 by Jelmer Vernooij
Factor out scandir.
1698
1699
1757.2.8 by Robert Collins
Teach walkdirs to walk a subdir of a tree.
1700
def walkdirs(top, prefix=""):
1753.1.1 by Robert Collins
(rbc, jam, mbp)Add bzrlib.osutils.walkdirs, an optimised walk-and-stat routine.
1701
    """Yield data about all the directories in a tree.
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
1702
1753.1.1 by Robert Collins
(rbc, jam, mbp)Add bzrlib.osutils.walkdirs, an optimised walk-and-stat routine.
1703
    This yields all the data about the contents of a directory at a time.
1704
    After each directory has been yielded, if the caller has mutated the list
1705
    to exclude some directories, they are then not descended into.
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
1706
1753.1.1 by Robert Collins
(rbc, jam, mbp)Add bzrlib.osutils.walkdirs, an optimised walk-and-stat routine.
1707
    The data yielded is of the form:
1897.1.2 by Robert Collins
cleanup osutils.walkdirs changes after review.
1708
    ((directory-relpath, directory-path-from-top),
2694.4.1 by Alexander Belchenko
trivial fix for docstring of osutils.walkdirs()
1709
    [(relpath, basename, kind, lstat, path-from-top), ...]),
1897.1.2 by Robert Collins
cleanup osutils.walkdirs changes after review.
1710
     - directory-relpath is the relative path of the directory being returned
1711
       with respect to top. prefix is prepended to this.
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
1712
     - directory-path-from-root is the path including top for this directory.
1897.1.2 by Robert Collins
cleanup osutils.walkdirs changes after review.
1713
       It is suitable for use with os functions.
1897.1.1 by Robert Collins
Add some useful summary data to osutils.walkdirs output.
1714
     - relpath is the relative path within the subtree being walked.
1715
     - basename is the basename of the path
1897.1.2 by Robert Collins
cleanup osutils.walkdirs changes after review.
1716
     - kind is the kind of the file now. If unknown then the file is not
1897.1.1 by Robert Collins
Add some useful summary data to osutils.walkdirs output.
1717
       present within the tree - but it may be recorded as versioned. See
1718
       versioned_kind.
1719
     - lstat is the stat data *if* the file was statted.
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
1720
     - planned, not implemented:
1897.1.1 by Robert Collins
Add some useful summary data to osutils.walkdirs output.
1721
       path_from_tree_root is the path from the root of the tree.
1753.1.1 by Robert Collins
(rbc, jam, mbp)Add bzrlib.osutils.walkdirs, an optimised walk-and-stat routine.
1722
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
1723
    :param prefix: Prefix the relpaths that are yielded with 'prefix'. This
1757.2.16 by Robert Collins
Review comments.
1724
        allows one to walk a subtree but get paths that are relative to a tree
1725
        rooted higher up.
1753.1.1 by Robert Collins
(rbc, jam, mbp)Add bzrlib.osutils.walkdirs, an optimised walk-and-stat routine.
1726
    :return: an iterator over the dirs.
1727
    """
7143.15.2 by Jelmer Vernooij
Run autopep8.
1728
    # TODO there is a bit of a smell where the results of the directory-
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
1729
    # summary in this, and the path from the root, may not agree
1897.1.1 by Robert Collins
Add some useful summary data to osutils.walkdirs output.
1730
    # depending on top and prefix - i.e. ./foo and foo as a pair leads to
1731
    # potentially confusing output. We should make this more robust - but
1897.1.2 by Robert Collins
cleanup osutils.walkdirs changes after review.
1732
    # not at a speed cost. RBC 20060731
1753.1.1 by Robert Collins
(rbc, jam, mbp)Add bzrlib.osutils.walkdirs, an optimised walk-and-stat routine.
1733
    _directory = _directory_kind
2255.7.32 by John Arbash Meinel
Add tests that the walkdirs variants work on unicode paths.
1734
    pending = [(safe_unicode(prefix), "", _directory, None, safe_unicode(top))]
1753.1.1 by Robert Collins
(rbc, jam, mbp)Add bzrlib.osutils.walkdirs, an optimised walk-and-stat routine.
1735
    while pending:
1736
        # 0 - relpath, 1- basename, 2- kind, 3- stat, 4-toppath
2255.7.33 by John Arbash Meinel
More inner loop tuning of walkdirs, can save as much as 5%
1737
        relroot, _, _, _, top = pending.pop()
2255.7.32 by John Arbash Meinel
Add tests that the walkdirs variants work on unicode paths.
1738
        if relroot:
1739
            relprefix = relroot + u'/'
1753.1.1 by Robert Collins
(rbc, jam, mbp)Add bzrlib.osutils.walkdirs, an optimised walk-and-stat routine.
1740
        else:
2255.7.33 by John Arbash Meinel
More inner loop tuning of walkdirs, can save as much as 5%
1741
            relprefix = ''
2255.7.32 by John Arbash Meinel
Add tests that the walkdirs variants work on unicode paths.
1742
        top_slash = top + u'/'
2255.7.33 by John Arbash Meinel
More inner loop tuning of walkdirs, can save as much as 5%
1743
1744
        dirblock = []
7489.5.4 by Jelmer Vernooij
Fix tests.
1745
        try:
1746
            for entry in scandir(top):
1747
                name = decode_filename(entry.name)
1748
                statvalue = entry.stat(follow_symlinks=False)
1749
                kind = file_kind_from_stat_mode(statvalue.st_mode)
1750
                dirblock.append((relprefix + name, name, kind, statvalue, entry.path))
1751
        except OSError as e:
1752
            if not _is_error_enotdir(e):
1753
                raise
1754
        except UnicodeDecodeError as e:
1755
            raise errors.BadFilenameEncoding(e.object, _fs_enc)
7489.5.1 by Jelmer Vernooij
Use os.scandir.
1756
        dirblock.sort()
2255.7.32 by John Arbash Meinel
Add tests that the walkdirs variants work on unicode paths.
1757
        yield (relroot, top), dirblock
2255.7.33 by John Arbash Meinel
More inner loop tuning of walkdirs, can save as much as 5%
1758
1753.1.1 by Robert Collins
(rbc, jam, mbp)Add bzrlib.osutils.walkdirs, an optimised walk-and-stat routine.
1759
        # push the user specified dirs from dirblock
2255.7.32 by John Arbash Meinel
Add tests that the walkdirs variants work on unicode paths.
1760
        pending.extend(d for d in reversed(dirblock) if d[2] == _directory)
1773.3.1 by Robert Collins
Add path_prefix_key and compare_paths_prefix_order utility functions.
1761
1762
3696.3.1 by Robert Collins
Refactor bzrlib.osutils._walkdirs_utf8 to aid API migration in future.
1763
class DirReader(object):
1764
    """An interface for reading directories."""
1765
1766
    def top_prefix_to_starting_dir(self, top, prefix=""):
1767
        """Converts top and prefix to a starting dir entry
1768
1769
        :param top: A utf8 path
1770
        :param prefix: An optional utf8 path to prefix output relative paths
1771
            with.
1772
        :return: A tuple starting with prefix, and ending with the native
1773
            encoding of top.
1774
        """
1775
        raise NotImplementedError(self.top_prefix_to_starting_dir)
1776
1777
    def read_dir(self, prefix, top):
1778
        """Read a specific dir.
1779
1780
        :param prefix: A utf8 prefix to be preprended to the path basenames.
1781
        :param top: A natively encoded path to read.
3696.3.10 by Robert Collins
Review feedback.
1782
        :return: A list of the directories contents. Each item contains:
3696.3.1 by Robert Collins
Refactor bzrlib.osutils._walkdirs_utf8 to aid API migration in future.
1783
            (utf8_relpath, utf8_name, kind, lstatvalue, native_abspath)
1784
        """
1785
        raise NotImplementedError(self.read_dir)
1786
1787
1788
_selected_dir_reader = None
1789
3557.2.3 by John Arbash Meinel
Change the logic for selecting a real _walkdirs_utf8 implementation,
1790
2255.7.27 by John Arbash Meinel
Add a _walkdirs_utf8 which returns utf8 paths instead of Unicode. Approx 20% faster in walking utf8 filesystems
1791
def _walkdirs_utf8(top, prefix=""):
1792
    """Yield data about all the directories in a tree.
1793
1794
    This yields the same information as walkdirs() only each entry is yielded
1795
    in utf-8. On platforms which have a filesystem encoding of utf8 the paths
1796
    are returned as exact byte-strings.
2255.7.32 by John Arbash Meinel
Add tests that the walkdirs variants work on unicode paths.
1797
1798
    :return: yields a tuple of (dir_info, [file_info])
1799
        dir_info is (utf8_relpath, path-from-top)
1800
        file_info is (utf8_relpath, utf8_name, kind, lstat, path-from-top)
1801
        if top is an absolute path, path-from-top is also an absolute path.
1802
        path-from-top might be unicode or utf8, but it is the correct path to
1803
        pass to os functions to affect the file in question. (such as os.lstat)
1804
    """
3696.3.1 by Robert Collins
Refactor bzrlib.osutils._walkdirs_utf8 to aid API migration in future.
1805
    global _selected_dir_reader
1806
    if _selected_dir_reader is None:
6658.6.1 by Martin
Remove winver, win98 support code, and deprecated code
1807
        if sys.platform == "win32":
3557.2.3 by John Arbash Meinel
Change the logic for selecting a real _walkdirs_utf8 implementation,
1808
            try:
6624 by Jelmer Vernooij
Merge Python3 porting work ('py3 pokes')
1809
                from ._walkdirs_win32 import Win32ReadDir
3696.3.1 by Robert Collins
Refactor bzrlib.osutils._walkdirs_utf8 to aid API migration in future.
1810
                _selected_dir_reader = Win32ReadDir()
4241.14.6 by Vincent Ladeuil
Start DirReader parametrized tests.
1811
            except ImportError:
1812
                pass
6352.3.4 by Martin Packman
Minor tweaks including normalising _fs_enc value
1813
        elif _fs_enc in ('utf-8', 'ascii'):
3696.3.5 by Robert Collins
Streamline _walkdirs_utf8 for utf8 file systems, reducing time to traverse a mozilla tree from 1s to .6 seconds. (Robert Collins)
1814
            try:
6624 by Jelmer Vernooij
Merge Python3 porting work ('py3 pokes')
1815
                from ._readdir_pyx import UTF8DirReader
3696.3.5 by Robert Collins
Streamline _walkdirs_utf8 for utf8 file systems, reducing time to traverse a mozilla tree from 1s to .6 seconds. (Robert Collins)
1816
                _selected_dir_reader = UTF8DirReader()
6619.3.2 by Jelmer Vernooij
Apply 2to3 except fix.
1817
            except ImportError as e:
4574.3.8 by Martin Pool
Only mutter extension load errors when they occur, and record for later
1818
                failed_to_load_extension(e)
4241.14.6 by Vincent Ladeuil
Start DirReader parametrized tests.
1819
                pass
1820
1821
    if _selected_dir_reader is None:
1822
        # Fallback to the python version
1823
        _selected_dir_reader = UnicodeDirReader()
1824
2255.7.33 by John Arbash Meinel
More inner loop tuning of walkdirs, can save as much as 5%
1825
    # 0 - relpath, 1- basename, 2- kind, 3- stat, 4-toppath
1826
    # But we don't actually uses 1-3 in pending, so set them to None
3696.3.5 by Robert Collins
Streamline _walkdirs_utf8 for utf8 file systems, reducing time to traverse a mozilla tree from 1s to .6 seconds. (Robert Collins)
1827
    pending = [[_selected_dir_reader.top_prefix_to_starting_dir(top, prefix)]]
3696.3.1 by Robert Collins
Refactor bzrlib.osutils._walkdirs_utf8 to aid API migration in future.
1828
    read_dir = _selected_dir_reader.read_dir
1829
    _directory = _directory_kind
2255.7.27 by John Arbash Meinel
Add a _walkdirs_utf8 which returns utf8 paths instead of Unicode. Approx 20% faster in walking utf8 filesystems
1830
    while pending:
3696.3.5 by Robert Collins
Streamline _walkdirs_utf8 for utf8 file systems, reducing time to traverse a mozilla tree from 1s to .6 seconds. (Robert Collins)
1831
        relroot, _, _, _, top = pending[-1].pop()
1832
        if not pending[-1]:
1833
            pending.pop()
1834
        dirblock = sorted(read_dir(relroot, top))
3696.3.1 by Robert Collins
Refactor bzrlib.osutils._walkdirs_utf8 to aid API migration in future.
1835
        yield (relroot, top), dirblock
1836
        # push the user specified dirs from dirblock
3696.3.5 by Robert Collins
Streamline _walkdirs_utf8 for utf8 file systems, reducing time to traverse a mozilla tree from 1s to .6 seconds. (Robert Collins)
1837
        next = [d for d in reversed(dirblock) if d[2] == _directory]
1838
        if next:
1839
            pending.append(next)
3696.3.1 by Robert Collins
Refactor bzrlib.osutils._walkdirs_utf8 to aid API migration in future.
1840
1841
1842
class UnicodeDirReader(DirReader):
1843
    """A dir reader for non-utf8 file systems, which transcodes."""
1844
1845
    __slots__ = ['_utf8_encode']
1846
1847
    def __init__(self):
1848
        self._utf8_encode = codecs.getencoder('utf8')
1849
1850
    def top_prefix_to_starting_dir(self, top, prefix=""):
1851
        """See DirReader.top_prefix_to_starting_dir."""
1852
        return (safe_utf8(prefix), None, None, None, safe_unicode(top))
1853
1854
    def read_dir(self, prefix, top):
1855
        """Read a single directory from a non-utf8 file system.
1856
1857
        top, and the abspath element in the output are unicode, all other paths
1858
        are utf8. Local disk IO is done via unicode calls to listdir etc.
1859
1860
        This is currently the fallback code path when the filesystem encoding is
1861
        not UTF-8. It may be better to implement an alternative so that we can
1862
        safely handle paths that are not properly decodable in the current
1863
        encoding.
1864
1865
        See DirReader.read_dir for details.
1866
        """
1867
        _utf8_encode = self._utf8_encode
7143.15.2 by Jelmer Vernooij
Run autopep8.
1868
1869
        def _fs_decode(s): return s.decode(_fs_enc)
1870
1871
        def _fs_encode(s): return s.encode(_fs_enc)
3696.3.1 by Robert Collins
Refactor bzrlib.osutils._walkdirs_utf8 to aid API migration in future.
1872
1873
        if prefix:
6684.1.3 by Martin
Changes across many modules working towards Python 3 support
1874
            relprefix = prefix + b'/'
2255.7.32 by John Arbash Meinel
Add tests that the walkdirs variants work on unicode paths.
1875
        else:
6684.1.3 by Martin
Changes across many modules working towards Python 3 support
1876
            relprefix = b''
1877
        top_slash = top + '/'
2255.7.33 by John Arbash Meinel
More inner loop tuning of walkdirs, can save as much as 5%
1878
2255.7.32 by John Arbash Meinel
Add tests that the walkdirs variants work on unicode paths.
1879
        dirblock = []
2255.7.33 by John Arbash Meinel
More inner loop tuning of walkdirs, can save as much as 5%
1880
        append = dirblock.append
7489.5.4 by Jelmer Vernooij
Fix tests.
1881
        for entry in scandir(safe_utf8(top)):
3696.3.12 by Robert Collins
Fix PQM test failure.
1882
            try:
7489.5.3 by Jelmer Vernooij
use scandir rather than listdir.
1883
                name = _fs_decode(entry.name)
3696.3.12 by Robert Collins
Fix PQM test failure.
1884
            except UnicodeDecodeError:
1885
                raise errors.BadFilenameEncoding(
7489.5.3 by Jelmer Vernooij
use scandir rather than listdir.
1886
                    relprefix + entry.name, _fs_enc)
7489.5.4 by Jelmer Vernooij
Fix tests.
1887
            abspath = top_slash + name
7078.16.1 by Jelmer Vernooij
Fix bad fs tests on Python 3.
1888
            name_utf8 = _utf8_encode(name)[0]
7489.5.3 by Jelmer Vernooij
use scandir rather than listdir.
1889
            statvalue = entry.stat(follow_symlinks=False)
1890
            kind = file_kind_from_stat_mode(statvalue.st_mode)
2255.7.33 by John Arbash Meinel
More inner loop tuning of walkdirs, can save as much as 5%
1891
            append((relprefix + name_utf8, name_utf8, kind, statvalue, abspath))
7047.2.1 by Jelmer Vernooij
Defer sorting paths until utf8 encoding has happened.
1892
        return sorted(dirblock)
2255.7.27 by John Arbash Meinel
Add a _walkdirs_utf8 which returns utf8 paths instead of Unicode. Approx 20% faster in walking utf8 filesystems
1893
1894
1907.3.2 by John Arbash Meinel
Updated the copy_tree function to allow overriding functionality.
1895
def copy_tree(from_path, to_path, handlers={}):
1907.3.1 by John Arbash Meinel
create a copy_tree wrapper around walkdirs()
1896
    """Copy all of the entries in from_path into to_path.
1897
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
1898
    :param from_path: The base directory to copy.
1907.3.1 by John Arbash Meinel
create a copy_tree wrapper around walkdirs()
1899
    :param to_path: The target directory. If it does not exist, it will
1900
        be created.
1907.3.2 by John Arbash Meinel
Updated the copy_tree function to allow overriding functionality.
1901
    :param handlers: A dictionary of functions, which takes a source and
1902
        destinations for files, directories, etc.
1903
        It is keyed on the file kind, such as 'directory', 'symlink', or 'file'
1904
        'file', 'directory', and 'symlink' should always exist.
1905
        If they are missing, they will be replaced with 'os.mkdir()',
1906
        'os.readlink() + os.symlink()', and 'shutil.copy2()', respectively.
1907.3.1 by John Arbash Meinel
create a copy_tree wrapper around walkdirs()
1907
    """
1908
    # Now, just copy the existing cached tree to the new location
1909
    # We use a cheap trick here.
1910
    # Absolute paths are prefixed with the first parameter
1911
    # relative paths are prefixed with the second.
1912
    # So we can get both the source and target returned
1913
    # without any extra work.
1914
1907.3.2 by John Arbash Meinel
Updated the copy_tree function to allow overriding functionality.
1915
    def copy_dir(source, dest):
1916
        os.mkdir(dest)
1917
1918
    def copy_link(source, dest):
1919
        """Copy the contents of a symlink"""
1920
        link_to = os.readlink(source)
1921
        os.symlink(link_to, dest)
1922
6809.1.1 by Martin
Apply 2to3 ws_comma fixer
1923
    real_handlers = {'file': shutil.copy2,
1924
                     'symlink': copy_link,
1925
                     'directory': copy_dir,
7143.15.2 by Jelmer Vernooij
Run autopep8.
1926
                     }
1907.3.2 by John Arbash Meinel
Updated the copy_tree function to allow overriding functionality.
1927
    real_handlers.update(handlers)
1928
1907.3.1 by John Arbash Meinel
create a copy_tree wrapper around walkdirs()
1929
    if not os.path.exists(to_path):
1907.3.2 by John Arbash Meinel
Updated the copy_tree function to allow overriding functionality.
1930
        real_handlers['directory'](from_path, to_path)
1907.3.1 by John Arbash Meinel
create a copy_tree wrapper around walkdirs()
1931
1932
    for dir_info, entries in walkdirs(from_path, prefix=to_path):
1933
        for relpath, name, kind, st, abspath in entries:
1907.3.2 by John Arbash Meinel
Updated the copy_tree function to allow overriding functionality.
1934
            real_handlers[kind](abspath, relpath)
1907.3.1 by John Arbash Meinel
create a copy_tree wrapper around walkdirs()
1935
1936
5116.2.6 by Parth Malwankar
renamed copy_ownership to copy_ownership_from_path.
1937
def copy_ownership_from_path(dst, src=None):
5051.4.11 by Parth Malwankar
closed Martins review comments.
1938
    """Copy usr/grp ownership from src file/dir to dst file/dir.
1939
1940
    If src is None, the containing directory is used as source. If chown
1941
    fails, the error is ignored and a warning is printed.
1942
    """
5074.4.6 by John Arbash Meinel
Unbreak bzr on windows.
1943
    chown = getattr(os, 'chown', None)
1944
    if chown is None:
1945
        return
5051.4.9 by Parth Malwankar
removed parent_dir.
1946
7143.15.5 by Jelmer Vernooij
More PEP8 fixes.
1947
    if src is None:
5051.4.9 by Parth Malwankar
removed parent_dir.
1948
        src = os.path.dirname(dst)
1949
        if src == '':
1950
            src = '.'
1951
4634.143.4 by Parth Malwankar
added parent_dir and mkdir to osutils. osutils.mkdir optionally
1952
    try:
4634.143.1 by Parth Malwankar
default .bazaar, .bzr.log and .bazaar/bazaar.conf retain
1953
        s = os.stat(src)
5074.4.6 by John Arbash Meinel
Unbreak bzr on windows.
1954
        chown(dst, s.st_uid, s.st_gid)
7143.15.5 by Jelmer Vernooij
More PEP8 fixes.
1955
    except OSError:
5523.2.3 by Parth Malwankar
message is now shown to the user but is not too scary.
1956
        trace.warning(
1957
            'Unable to copy ownership from "%s" to "%s". '
1958
            'You may want to set it manually.', src, dst)
1959
        trace.log_exception_quietly()
4634.143.4 by Parth Malwankar
added parent_dir and mkdir to osutils. osutils.mkdir optionally
1960
1961
1773.3.1 by Robert Collins
Add path_prefix_key and compare_paths_prefix_order utility functions.
1962
def path_prefix_key(path):
1963
    """Generate a prefix-order path key for path.
1964
1965
    This can be used to sort paths in the same way that walkdirs does.
1966
    """
6809.1.1 by Martin
Apply 2to3 ws_comma fixer
1967
    return (dirname(path), path)
1773.3.1 by Robert Collins
Add path_prefix_key and compare_paths_prefix_order utility functions.
1968
1969
1970
def compare_paths_prefix_order(path_a, path_b):
1971
    """Compare path_a and path_b to generate the same order walkdirs uses."""
1972
    key_a = path_prefix_key(path_a)
1973
    key_b = path_prefix_key(path_b)
7065.3.6 by Jelmer Vernooij
Fix some more tests.
1974
    return (key_a > key_b) - (key_a < key_b)
1955.2.2 by John Arbash Meinel
Change the name of the test classes (test_lang => test_locale), move the function into osutils.py
1975
1976
1977
_cached_user_encoding = None
1978
1979
6630.1.1 by Jelmer Vernooij
Remove deprecated functionality.
1980
def get_user_encoding():
1955.2.2 by John Arbash Meinel
Change the name of the test classes (test_lang => test_locale), move the function into osutils.py
1981
    """Find out what the preferred user encoding is.
1982
1983
    This is generally the encoding that is used for command line parameters
1984
    and file contents. This may be different from the terminal encoding
1985
    or the filesystem encoding.
1986
1987
    :return: A string defining the preferred user encoding
1988
    """
1989
    global _cached_user_encoding
6383.1.3 by Martin Packman
Deprecate public use_cache parameter in favour of test specific override
1990
    if _cached_user_encoding is not None:
1955.2.2 by John Arbash Meinel
Change the name of the test classes (test_lang => test_locale), move the function into osutils.py
1991
        return _cached_user_encoding
1992
6383.1.1 by Martin Packman
Simplify get_user_encoding by avoiding locale hacks and assuming setlocale has been called
1993
    if os.name == 'posix' and getattr(locale, 'CODESET', None) is not None:
1994
        # Use the existing locale settings and call nl_langinfo directly
1995
        # rather than going through getpreferredencoding. This avoids
1996
        # <http://bugs.python.org/issue6202> on OSX Python 2.6 and the
1997
        # possibility of the setlocale call throwing an error.
1998
        user_encoding = locale.nl_langinfo(locale.CODESET)
1955.2.2 by John Arbash Meinel
Change the name of the test classes (test_lang => test_locale), move the function into osutils.py
1999
    else:
6383.1.1 by Martin Packman
Simplify get_user_encoding by avoiding locale hacks and assuming setlocale has been called
2000
        # GZ 2011-12-19: On windows could call GetACP directly instead.
6383.1.4 by Martin Packman
Simplify tests a little and make it clear setlocale is not being used
2001
        user_encoding = locale.getpreferredencoding(False)
1955.2.2 by John Arbash Meinel
Change the name of the test classes (test_lang => test_locale), move the function into osutils.py
2002
6383.1.1 by Martin Packman
Simplify get_user_encoding by avoiding locale hacks and assuming setlocale has been called
2003
    try:
2004
        user_encoding = codecs.lookup(user_encoding).name
2005
    except LookupError:
2006
        if user_encoding not in ("", "cp0"):
6622.1.4 by Jelmer Vernooij
Fix some more tests.
2007
            sys.stderr.write('brz: warning:'
2192.1.1 by Alexander Belchenko
Before actually using encoding need to check that Python has corresponding codec
2008
                             ' unknown encoding %s.'
2009
                             ' Continuing with ascii encoding.\n'
2192.1.3 by Alexander Belchenko
Tests for osutils.get_user_encoding
2010
                             % user_encoding
7143.15.2 by Jelmer Vernooij
Run autopep8.
2011
                             )
6383.1.1 by Martin Packman
Simplify get_user_encoding by avoiding locale hacks and assuming setlocale has been called
2012
        user_encoding = 'ascii'
2013
    else:
2014
        # Get 'ascii' when setlocale has not been called or LANG=C or unset.
2015
        if user_encoding == 'ascii':
2016
            if sys.platform == 'darwin':
2017
                # OSX is special-cased in Python to have a UTF-8 filesystem
2018
                # encoding and previously had LANG set here if not present.
2019
                user_encoding = 'utf-8'
2020
            # GZ 2011-12-19: Maybe UTF-8 should be the default in this case
2021
            #                for some other posix platforms as well.
2192.1.3 by Alexander Belchenko
Tests for osutils.get_user_encoding
2022
6383.1.3 by Martin Packman
Deprecate public use_cache parameter in favour of test specific override
2023
    _cached_user_encoding = user_encoding
2192.1.3 by Alexander Belchenko
Tests for osutils.get_user_encoding
2024
    return user_encoding
2091.1.1 by Martin Pool
Avoid MSG_WAITALL as it doesn't work on Windows
2025
2026
4797.57.10 by Alexander Belchenko
path_encoding selection logic extracted as helper function
2027
def get_diff_header_encoding():
5258.1.5 by Alexander Belchenko
tweak requested by Martin Pool: use terminal encoding for diff headers on all platforms
2028
    return get_terminal_encoding()
4797.57.10 by Alexander Belchenko
path_encoding selection logic extracted as helper function
2029
2030
3626.1.1 by Mark Hammond
Add osutils.get_host_name() to return a unicode hostname to prevent
2031
def get_host_name():
3626.1.4 by John Arbash Meinel
Document the difference in get_host_name, per Robert's request.
2032
    """Return the current unicode host name.
2033
2034
    This is meant to be used in place of socket.gethostname() because that
2035
    behaves inconsistently on different platforms.
2036
    """
3626.1.1 by Mark Hammond
Add osutils.get_host_name() to return a unicode hostname to prevent
2037
    if sys.platform == "win32":
2038
        return win32utils.get_host_name()
2039
    else:
2040
        import socket
7479.2.1 by Jelmer Vernooij
Drop python2 support.
2041
        return socket.gethostname()
3626.1.1 by Mark Hammond
Add osutils.get_host_name() to return a unicode hostname to prevent
2042
2043
5011.3.11 by Andrew Bennetts
Consolidate changes, try to minimise unnecessary changes and tidy up those that kept.
2044
# We must not read/write any more than 64k at a time from/to a socket so we
2045
# don't risk "no buffer space available" errors on some platforms.  Windows in
2046
# particular is likely to throw WSAECONNABORTED or WSAENOBUFS if given too much
2047
# data at once.
2048
MAX_SOCKET_CHUNK = 64 * 1024
2049
6437.74.2 by John Arbash Meinel
Push the change down into osutils.send_all. Needs tests at that level.
2050
_end_of_stream_errors = [errno.ECONNRESET, errno.EPIPE, errno.EINVAL]
5599.3.1 by John Arbash Meinel
Consider WSAECONNABORTED to be an end-of-stream as well as WSAECONNRESET.
2051
for _eno in ['WSAECONNRESET', 'WSAECONNABORTED']:
2052
    _eno = getattr(errno, _eno, None)
2053
    if _eno is not None:
2054
        _end_of_stream_errors.append(_eno)
2055
del _eno
2056
2057
5011.3.12 by Andrew Bennetts
Make report_activity param of read_bytes_from_socket optional.
2058
def read_bytes_from_socket(sock, report_activity=None,
7143.15.2 by Jelmer Vernooij
Run autopep8.
2059
                           max_read_size=MAX_SOCKET_CHUNK):
5011.3.11 by Andrew Bennetts
Consolidate changes, try to minimise unnecessary changes and tidy up those that kept.
2060
    """Read up to max_read_size of bytes from sock and notify of progress.
2061
2062
    Translates "Connection reset by peer" into file-like EOF (return an
2063
    empty string rather than raise an error), and repeats the recv if
2064
    interrupted by a signal.
2065
    """
6619.3.18 by Jelmer Vernooij
Run 2to3 idioms fixer.
2066
    while True:
5011.3.11 by Andrew Bennetts
Consolidate changes, try to minimise unnecessary changes and tidy up those that kept.
2067
        try:
6973.7.2 by Jelmer Vernooij
Avoid term bytes for variable names.
2068
            data = sock.recv(max_read_size)
6619.3.2 by Jelmer Vernooij
Apply 2to3 except fix.
2069
        except socket.error as e:
5011.3.11 by Andrew Bennetts
Consolidate changes, try to minimise unnecessary changes and tidy up those that kept.
2070
            eno = e.args[0]
5599.3.1 by John Arbash Meinel
Consider WSAECONNABORTED to be an end-of-stream as well as WSAECONNRESET.
2071
            if eno in _end_of_stream_errors:
5011.3.11 by Andrew Bennetts
Consolidate changes, try to minimise unnecessary changes and tidy up those that kept.
2072
                # The connection was closed by the other side.  Callers expect
2073
                # an empty string to signal end-of-stream.
6973.7.2 by Jelmer Vernooij
Avoid term bytes for variable names.
2074
                return b""
5011.3.11 by Andrew Bennetts
Consolidate changes, try to minimise unnecessary changes and tidy up those that kept.
2075
            elif eno == errno.EINTR:
2076
                # Retry the interrupted recv.
2077
                continue
2078
            raise
2079
        else:
5011.3.12 by Andrew Bennetts
Make report_activity param of read_bytes_from_socket optional.
2080
            if report_activity is not None:
6973.7.2 by Jelmer Vernooij
Avoid term bytes for variable names.
2081
                report_activity(len(data), 'read')
2082
            return data
5011.3.11 by Andrew Bennetts
Consolidate changes, try to minimise unnecessary changes and tidy up those that kept.
2083
2084
2085
def recv_all(socket, count):
2086
    """Receive an exact number of bytes.
2087
2088
    Regular Socket.recv() may return less than the requested number of bytes,
2089
    depending on what's in the OS buffer.  MSG_WAITALL is not available
2090
    on all platforms, but this should work everywhere.  This will return
2091
    less than the requested amount if the remote end closes.
2092
2093
    This isn't optimized and is intended mostly for use in testing.
2094
    """
6973.7.3 by Jelmer Vernooij
Fix some more tests.
2095
    b = b''
5011.3.11 by Andrew Bennetts
Consolidate changes, try to minimise unnecessary changes and tidy up those that kept.
2096
    while len(b) < count:
5011.3.12 by Andrew Bennetts
Make report_activity param of read_bytes_from_socket optional.
2097
        new = read_bytes_from_socket(socket, None, count - len(b))
6973.7.3 by Jelmer Vernooij
Fix some more tests.
2098
        if new == b'':
7143.15.2 by Jelmer Vernooij
Run autopep8.
2099
            break  # eof
5011.3.11 by Andrew Bennetts
Consolidate changes, try to minimise unnecessary changes and tidy up those that kept.
2100
        b += new
2101
    return b
2102
5011.3.4 by Andrew Bennetts
Reinstate osutils.until_no_eintr and .send_all, reapply until_no_eintr in SmartSimplePipesClientMedium.read_bytes.
2103
2104
def send_all(sock, bytes, report_activity=None):
2105
    """Send all bytes on a socket.
5279.2.7 by Eric Moritz
1. deleted trailing whitespace
2106
5011.3.4 by Andrew Bennetts
Reinstate osutils.until_no_eintr and .send_all, reapply until_no_eintr in SmartSimplePipesClientMedium.read_bytes.
2107
    Breaks large blocks in smaller chunks to avoid buffering limitations on
2108
    some platforms, and catches EINTR which may be thrown if the send is
2109
    interrupted by a signal.
2110
5011.3.11 by Andrew Bennetts
Consolidate changes, try to minimise unnecessary changes and tidy up those that kept.
2111
    This is preferred to socket.sendall(), because it avoids portability bugs
2112
    and provides activity reporting.
5279.2.7 by Eric Moritz
1. deleted trailing whitespace
2113
5011.3.4 by Andrew Bennetts
Reinstate osutils.until_no_eintr and .send_all, reapply until_no_eintr in SmartSimplePipesClientMedium.read_bytes.
2114
    :param report_activity: Call this as bytes are read, see
2115
        Transport._report_activity
2116
    """
2117
    sent_total = 0
2118
    byte_count = len(bytes)
6632.1.1 by Martin
Change uses of buffer to memoryview
2119
    view = memoryview(bytes)
5011.3.4 by Andrew Bennetts
Reinstate osutils.until_no_eintr and .send_all, reapply until_no_eintr in SmartSimplePipesClientMedium.read_bytes.
2120
    while sent_total < byte_count:
2121
        try:
7143.15.2 by Jelmer Vernooij
Run autopep8.
2122
            sent = sock.send(view[sent_total:sent_total + MAX_SOCKET_CHUNK])
6619.3.2 by Jelmer Vernooij
Apply 2to3 except fix.
2123
        except (socket.error, IOError) as e:
6437.74.2 by John Arbash Meinel
Push the change down into osutils.send_all. Needs tests at that level.
2124
            if e.args[0] in _end_of_stream_errors:
2125
                raise errors.ConnectionReset(
2126
                    "Error trying to write to socket", e)
5011.3.4 by Andrew Bennetts
Reinstate osutils.until_no_eintr and .send_all, reapply until_no_eintr in SmartSimplePipesClientMedium.read_bytes.
2127
            if e.args[0] != errno.EINTR:
2128
                raise
2129
        else:
6437.73.1 by John Arbash Meinel
Fix bug #1047309. Treat a series of no-bytes-sent as a ECONNRESET failure.
2130
            if sent == 0:
6437.73.2 by John Arbash Meinel
simplify the fix. Sending 0 bytes seems to always indicate that we have a closed connection.
2131
                raise errors.ConnectionReset('Sending to %s returned 0 bytes'
2132
                                             % (sock,))
5011.3.4 by Andrew Bennetts
Reinstate osutils.until_no_eintr and .send_all, reapply until_no_eintr in SmartSimplePipesClientMedium.read_bytes.
2133
            sent_total += sent
6437.73.1 by John Arbash Meinel
Fix bug #1047309. Treat a series of no-bytes-sent as a ECONNRESET failure.
2134
            if report_activity is not None:
2135
                report_activity(sent, 'write')
3118.2.1 by Andrew Bennetts
(andrew) Fix #115781 by passing no more than 64k at a time to socket.sendall.
2136
5247.5.14 by Vincent Ladeuil
Fix the helper again, the python one is bogus :-/
2137
5247.5.29 by Vincent Ladeuil
Fixed as per jam's review.
2138
def connect_socket(address):
2139
    # Slight variation of the socket.create_connection() function (provided by
2140
    # python-2.6) that can fail if getaddrinfo returns an empty list. We also
2141
    # provide it for previous python versions. Also, we don't use the timeout
2142
    # parameter (provided by the python implementation) so we don't implement
2143
    # it either).
5247.5.14 by Vincent Ladeuil
Fix the helper again, the python one is bogus :-/
2144
    err = socket.error('getaddrinfo returns an empty list')
2145
    host, port = address
2146
    for res in socket.getaddrinfo(host, port, 0, socket.SOCK_STREAM):
2147
        af, socktype, proto, canonname, sa = res
2148
        sock = None
2149
        try:
2150
            sock = socket.socket(af, socktype, proto)
2151
            sock.connect(sa)
2152
            return sock
2153
6963.1.1 by Jelmer Vernooij
Fix a bunch of tests on python3.
2154
        except socket.error as e:
2155
            err = e
5247.5.14 by Vincent Ladeuil
Fix the helper again, the python one is bogus :-/
2156
            # 'err' is now the most recent error
2157
            if sock is not None:
2158
                sock.close()
2159
    raise err
5247.3.7 by Vincent Ladeuil
Provide connect_socket (socket.create_connection) for pythons older than 2.6.
2160
3118.2.1 by Andrew Bennetts
(andrew) Fix #115781 by passing no more than 64k at a time to socket.sendall.
2161
2091.3.7 by Aaron Bentley
Rename real_parent to dereferenced_path
2162
def dereference_path(path):
2163
    """Determine the real path to a file.
2164
2165
    All parent elements are dereferenced.  But the file itself is not
2166
    dereferenced.
2167
    :param path: The original path.  May be absolute or relative.
2168
    :return: the real path *to* the file
2169
    """
2091.3.5 by Aaron Bentley
Move realpath functionality into osutils
2170
    parent, base = os.path.split(path)
2171
    # The pathjoin for '.' is a workaround for Python bug #1213894.
2172
    # (initial path components aren't dereferenced)
2173
    return pathjoin(realpath(pathjoin('.', parent)), base)
2681.3.4 by Lukáš Lalinsky
- Rename 'windows' to 'mapi'
2174
2175
2176
def supports_mapi():
2177
    """Return True if we can use MAPI to launch a mail client."""
2178
    return sys.platform == "win32"
3089.3.8 by Ian Clatworthy
move resource loading into a reusable function
2179
2180
2181
def resource_string(package, resource_name):
2182
    """Load a resource from a package and return it as a string.
2183
6622.1.34 by Jelmer Vernooij
Rename brzlib => breezy.
2184
    Note: Only packages that start with breezy are currently supported.
3089.3.8 by Ian Clatworthy
move resource loading into a reusable function
2185
2186
    This is designed to be a lightweight implementation of resource
2187
    loading in a way which is API compatible with the same API from
2188
    pkg_resources. See
2189
    http://peak.telecommunity.com/DevCenter/PkgResources#basic-resource-access.
2190
    If and when pkg_resources becomes a standard library, this routine
2191
    can delegate to it.
2192
    """
6622.1.34 by Jelmer Vernooij
Rename brzlib => breezy.
2193
    # Check package name is within breezy
2194
    if package == "breezy":
3089.3.8 by Ian Clatworthy
move resource loading into a reusable function
2195
        resource_relpath = resource_name
6622.1.34 by Jelmer Vernooij
Rename brzlib => breezy.
2196
    elif package.startswith("breezy."):
2197
        package = package[len("breezy."):].replace('.', os.sep)
3089.3.8 by Ian Clatworthy
move resource loading into a reusable function
2198
        resource_relpath = pathjoin(package, resource_name)
2199
    else:
6622.1.34 by Jelmer Vernooij
Rename brzlib => breezy.
2200
        raise errors.BzrError('resource package %s not in breezy' % package)
3089.3.8 by Ian Clatworthy
move resource loading into a reusable function
2201
2202
    # Map the resource to a file and read its contents
6622.1.34 by Jelmer Vernooij
Rename brzlib => breezy.
2203
    base = dirname(breezy.__file__)
3089.3.8 by Ian Clatworthy
move resource loading into a reusable function
2204
    if getattr(sys, 'frozen', None):    # bzr.exe
2205
        base = abspath(pathjoin(base, '..', '..'))
7027.3.7 by Jelmer Vernooij
drop broken tests.
2206
    with open(pathjoin(base, resource_relpath), "rt") as f:
4708.2.2 by Martin
Workingtree changes sitting around since November, more explict closing of files in bzrlib
2207
        return f.read()
1739.2.7 by Robert Collins
Update readdir pyrex source files and usage in line with current practice.
2208
7143.15.2 by Jelmer Vernooij
Run autopep8.
2209
3696.3.5 by Robert Collins
Streamline _walkdirs_utf8 for utf8 file systems, reducing time to traverse a mozilla tree from 1s to .6 seconds. (Robert Collins)
2210
def file_kind_from_stat_mode_thunk(mode):
2211
    global file_kind_from_stat_mode
2212
    if file_kind_from_stat_mode is file_kind_from_stat_mode_thunk:
2213
        try:
6624 by Jelmer Vernooij
Merge Python3 porting work ('py3 pokes')
2214
            from ._readdir_pyx import UTF8DirReader
3696.3.5 by Robert Collins
Streamline _walkdirs_utf8 for utf8 file systems, reducing time to traverse a mozilla tree from 1s to .6 seconds. (Robert Collins)
2215
            file_kind_from_stat_mode = UTF8DirReader().kind_from_mode
7143.15.5 by Jelmer Vernooij
More PEP8 fixes.
2216
        except ImportError:
4694.2.1 by John Arbash Meinel
Fix bug #430645, don't issue a warning when failing to import _readdir_pyx the second time.
2217
            # This is one time where we won't warn that an extension failed to
2218
            # load. The extension is never available on Windows anyway.
6624 by Jelmer Vernooij
Merge Python3 porting work ('py3 pokes')
2219
            from ._readdir_py import (
3696.4.8 by Robert Collins
Fix up inter_changes with dirstate both C and python.
2220
                _kind_from_mode as file_kind_from_stat_mode
3696.3.5 by Robert Collins
Streamline _walkdirs_utf8 for utf8 file systems, reducing time to traverse a mozilla tree from 1s to .6 seconds. (Robert Collins)
2221
                )
2222
    return file_kind_from_stat_mode(mode)
7143.15.2 by Jelmer Vernooij
Run autopep8.
2223
2224
3696.3.5 by Robert Collins
Streamline _walkdirs_utf8 for utf8 file systems, reducing time to traverse a mozilla tree from 1s to .6 seconds. (Robert Collins)
2225
file_kind_from_stat_mode = file_kind_from_stat_mode_thunk
2226
7143.15.2 by Jelmer Vernooij
Run autopep8.
2227
6046.2.6 by Shannon Weyrick
Add file_stat, and make file_kind use it. file_stat can potentially cache results.
2228
def file_stat(f, _lstat=os.lstat):
3696.3.5 by Robert Collins
Streamline _walkdirs_utf8 for utf8 file systems, reducing time to traverse a mozilla tree from 1s to .6 seconds. (Robert Collins)
2229
    try:
6046.2.6 by Shannon Weyrick
Add file_stat, and make file_kind use it. file_stat can potentially cache results.
2230
        # XXX cache?
2231
        return _lstat(f)
6619.3.2 by Jelmer Vernooij
Apply 2to3 except fix.
2232
    except OSError as e:
3696.3.5 by Robert Collins
Streamline _walkdirs_utf8 for utf8 file systems, reducing time to traverse a mozilla tree from 1s to .6 seconds. (Robert Collins)
2233
        if getattr(e, 'errno', None) in (errno.ENOENT, errno.ENOTDIR):
2234
            raise errors.NoSuchFile(f)
2235
        raise
2236
7143.15.2 by Jelmer Vernooij
Run autopep8.
2237
6046.2.6 by Shannon Weyrick
Add file_stat, and make file_kind use it. file_stat can potentially cache results.
2238
def file_kind(f, _lstat=os.lstat):
2239
    stat_value = file_stat(f, _lstat)
2240
    return file_kind_from_stat_mode(stat_value.st_mode)
3923.3.1 by Andrew Bennetts
Quick attempt at adding some EINTR-proofing to smart protocol code.
2241
7143.15.2 by Jelmer Vernooij
Run autopep8.
2242
5011.3.4 by Andrew Bennetts
Reinstate osutils.until_no_eintr and .send_all, reapply until_no_eintr in SmartSimplePipesClientMedium.read_bytes.
2243
def until_no_eintr(f, *a, **kw):
2244
    """Run f(*a, **kw), retrying if an EINTR error occurs.
5279.2.7 by Eric Moritz
1. deleted trailing whitespace
2245
5011.3.4 by Andrew Bennetts
Reinstate osutils.until_no_eintr and .send_all, reapply until_no_eintr in SmartSimplePipesClientMedium.read_bytes.
2246
    WARNING: you must be certain that it is safe to retry the call repeatedly
2247
    if EINTR does occur.  This is typically only true for low-level operations
2248
    like os.read.  If in any doubt, don't use this.
5011.3.5 by Andrew Bennetts
Expand until_no_eintr's docstring more with some explanation for why it is not a complete solution.
2249
2250
    Keep in mind that this is not a complete solution to EINTR.  There is
2251
    probably code in the Python standard library and other dependencies that
2252
    may encounter EINTR if a signal arrives (and there is signal handler for
6622.1.34 by Jelmer Vernooij
Rename brzlib => breezy.
2253
    that signal).  So this function can reduce the impact for IO that breezy
5011.3.5 by Andrew Bennetts
Expand until_no_eintr's docstring more with some explanation for why it is not a complete solution.
2254
    directly controls, but it is not a complete solution.
5011.3.4 by Andrew Bennetts
Reinstate osutils.until_no_eintr and .send_all, reapply until_no_eintr in SmartSimplePipesClientMedium.read_bytes.
2255
    """
2256
    # Borrowed from Twisted's twisted.python.util.untilConcludes function.
2257
    while True:
2258
        try:
2259
            return f(*a, **kw)
6619.3.2 by Jelmer Vernooij
Apply 2to3 except fix.
2260
        except (IOError, OSError) as e:
5011.3.4 by Andrew Bennetts
Reinstate osutils.until_no_eintr and .send_all, reapply until_no_eintr in SmartSimplePipesClientMedium.read_bytes.
2261
            if e.errno == errno.EINTR:
2262
                continue
2263
            raise
2264
2265
0.16.79 by Aaron Bentley
Remove dependencies on bzrtools
2266
if sys.platform == "win32":
2267
    def getchar():
6379.1.1 by Jelmer Vernooij
Avoid importing tty and termios if we don't have to.
2268
        import msvcrt
0.16.79 by Aaron Bentley
Remove dependencies on bzrtools
2269
        return msvcrt.getch()
2270
else:
2271
    def getchar():
6379.1.1 by Jelmer Vernooij
Avoid importing tty and termios if we don't have to.
2272
        import tty
2273
        import termios
0.16.79 by Aaron Bentley
Remove dependencies on bzrtools
2274
        fd = sys.stdin.fileno()
2275
        settings = termios.tcgetattr(fd)
2276
        try:
2277
            tty.setraw(fd)
2278
            ch = sys.stdin.read(1)
2279
        finally:
2280
            termios.tcsetattr(fd, termios.TCSADRAIN, settings)
2281
        return ch
4398.4.3 by Vincent Ladeuil
Detect # cores on win32 and Solaris too.
2282
6057.1.1 by Martin Pool
Python can now report a platform of 'linux3' on kernel 3, but it's basically the same
2283
if sys.platform.startswith('linux'):
4398.4.3 by Vincent Ladeuil
Detect # cores on win32 and Solaris too.
2284
    def _local_concurrency():
5677.1.2 by Jelmer Vernooij
Use os.sysconf to get the number of CPUs on Linux. Use sysctl to get the number of CPUs on all *BSDs, not just FreeBSD.
2285
        try:
2286
            return os.sysconf('SC_NPROCESSORS_ONLN')
2287
        except (ValueError, OSError, AttributeError):
2288
            return None
4398.4.3 by Vincent Ladeuil
Detect # cores on win32 and Solaris too.
2289
elif sys.platform == 'darwin':
2290
    def _local_concurrency():
2291
        return subprocess.Popen(['sysctl', '-n', 'hw.availcpu'],
2292
                                stdout=subprocess.PIPE).communicate()[0]
5677.1.2 by Jelmer Vernooij
Use os.sysconf to get the number of CPUs on Linux. Use sysctl to get the number of CPUs on all *BSDs, not just FreeBSD.
2293
elif "bsd" in sys.platform:
4413.1.1 by Matthew Fuller
Catch the number of cores on FreeBSD too.
2294
    def _local_concurrency():
2295
        return subprocess.Popen(['sysctl', '-n', 'hw.ncpu'],
2296
                                stdout=subprocess.PIPE).communicate()[0]
4398.4.3 by Vincent Ladeuil
Detect # cores on win32 and Solaris too.
2297
elif sys.platform == 'sunos5':
2298
    def _local_concurrency():
7143.15.2 by Jelmer Vernooij
Run autopep8.
2299
        return subprocess.Popen(['psrinfo', '-p', ],
4398.4.3 by Vincent Ladeuil
Detect # cores on win32 and Solaris too.
2300
                                stdout=subprocess.PIPE).communicate()[0]
2301
elif sys.platform == "win32":
2302
    def _local_concurrency():
4398.4.4 by Vincent Ladeuil
Fixed as per John's review.
2303
        # This appears to return the number of cores.
4398.4.3 by Vincent Ladeuil
Detect # cores on win32 and Solaris too.
2304
        return os.environ.get('NUMBER_OF_PROCESSORS')
2305
else:
2306
    def _local_concurrency():
2307
        # Who knows ?
2308
        return None
2309
2310
4398.4.4 by Vincent Ladeuil
Fixed as per John's review.
2311
_cached_local_concurrency = None
2312
7143.15.2 by Jelmer Vernooij
Run autopep8.
2313
4398.4.4 by Vincent Ladeuil
Fixed as per John's review.
2314
def local_concurrency(use_cache=True):
4398.4.3 by Vincent Ladeuil
Detect # cores on win32 and Solaris too.
2315
    """Return how many processes can be run concurrently.
2316
2317
    Rely on platform specific implementations and default to 1 (one) if
2318
    anything goes wrong.
2319
    """
4398.4.4 by Vincent Ladeuil
Fixed as per John's review.
2320
    global _cached_local_concurrency
4766.3.4 by Matt Nordhoff
Change the environment variable to a global option.
2321
4398.4.4 by Vincent Ladeuil
Fixed as per John's review.
2322
    if _cached_local_concurrency is not None and use_cache:
2323
        return _cached_local_concurrency
2324
6622.1.28 by Jelmer Vernooij
More renames; commands in output, environment variables.
2325
    concurrency = os.environ.get('BRZ_CONCURRENCY', None)
4766.3.7 by Vincent Ladeuil
Mix BZR_CONCURRENCY and --concurrency so both are available.
2326
    if concurrency is None:
6691.1.8 by Jelmer Vernooij
Rely on multiprocessing.
2327
        import multiprocessing
4766.3.7 by Vincent Ladeuil
Mix BZR_CONCURRENCY and --concurrency so both are available.
2328
        try:
6241.1.2 by Jelmer Vernooij
Simplify try/finally.
2329
            concurrency = multiprocessing.cpu_count()
6691.1.8 by Jelmer Vernooij
Rely on multiprocessing.
2330
        except NotImplementedError:
2331
            # multiprocessing.cpu_count() isn't implemented on all platforms
5677.1.3 by Jelmer Vernooij
Use try/import rather than checking python version strings.
2332
            try:
2333
                concurrency = _local_concurrency()
2334
            except (OSError, IOError):
2335
                pass
4398.4.3 by Vincent Ladeuil
Detect # cores on win32 and Solaris too.
2336
    try:
2337
        concurrency = int(concurrency)
2338
    except (TypeError, ValueError):
2339
        concurrency = 1
4398.4.4 by Vincent Ladeuil
Fixed as per John's review.
2340
    if use_cache:
7143.15.5 by Jelmer Vernooij
More PEP8 fixes.
2341
        _cached_local_concurrency = concurrency
4398.4.3 by Vincent Ladeuil
Detect # cores on win32 and Solaris too.
2342
    return concurrency
4794.1.12 by Robert Collins
Create a StreamWriter helper that doesn't trigger implicit decode('ascii') on write(a_str).
2343
2344
4794.1.15 by Robert Collins
Review feedback.
2345
class UnicodeOrBytesToBytesWriter(codecs.StreamWriter):
4794.1.12 by Robert Collins
Create a StreamWriter helper that doesn't trigger implicit decode('ascii') on write(a_str).
2346
    """A stream writer that doesn't decode str arguments."""
2347
4794.1.21 by Robert Collins
Python 2.4 doesn't use CodecInfo, so do a type check on the result of codecs.lookup.
2348
    def __init__(self, encode, stream, errors='strict'):
4794.1.12 by Robert Collins
Create a StreamWriter helper that doesn't trigger implicit decode('ascii') on write(a_str).
2349
        codecs.StreamWriter.__init__(self, stream, errors)
4794.1.21 by Robert Collins
Python 2.4 doesn't use CodecInfo, so do a type check on the result of codecs.lookup.
2350
        self.encode = encode
4794.1.12 by Robert Collins
Create a StreamWriter helper that doesn't trigger implicit decode('ascii') on write(a_str).
2351
2352
    def write(self, object):
6619.3.18 by Jelmer Vernooij
Run 2to3 idioms fixer.
2353
        if isinstance(object, str):
4794.1.12 by Robert Collins
Create a StreamWriter helper that doesn't trigger implicit decode('ascii') on write(a_str).
2354
            self.stream.write(object)
2355
        else:
2356
            data, _ = self.encode(object, self.errors)
2357
            self.stream.write(data)
4797.2.27 by Vincent Ladeuil
Merge 2.0 into 2.1 including fix for #524560
2358
7078.16.1 by Jelmer Vernooij
Fix bad fs tests on Python 3.
2359
4634.140.4 by INADA Naoki
Fix easy miss in previous commit.
2360
if sys.platform == 'win32':
4634.140.10 by INADA Naoki
Change name from osutils.open to osutils.open_file
2361
    def open_file(filename, mode='r', bufsize=-1):
4634.140.13 by Vincent Ladeuil
Fix some typos and add a NEWS entry.
2362
        """This function is used to override the ``open`` builtin.
5279.2.7 by Eric Moritz
1. deleted trailing whitespace
2363
4634.140.13 by Vincent Ladeuil
Fix some typos and add a NEWS entry.
2364
        But it uses O_NOINHERIT flag so the file handle is not inherited by
2365
        child processes.  Deleting or renaming a closed file opened with this
2366
        function is not blocking child processes.
4634.140.6 by INADA Naoki
Add comment to osutils.open()
2367
        """
4634.140.9 by INADA Naoki
Revert to previous implementation using os.fdopen(os.open())
2368
        writing = 'w' in mode
2369
        appending = 'a' in mode
2370
        updating = '+' in mode
2371
        binary = 'b' in mode
2372
4634.140.12 by INADA Naoki
small clean up.
2373
        flags = O_NOINHERIT
4634.140.9 by INADA Naoki
Revert to previous implementation using os.fdopen(os.open())
2374
        # see http://msdn.microsoft.com/en-us/library/yeby3zcb%28VS.71%29.aspx
2375
        # for flags for each modes.
2376
        if binary:
4634.140.12 by INADA Naoki
small clean up.
2377
            flags |= O_BINARY
4634.140.9 by INADA Naoki
Revert to previous implementation using os.fdopen(os.open())
2378
        else:
4634.140.12 by INADA Naoki
small clean up.
2379
            flags |= O_TEXT
4634.140.9 by INADA Naoki
Revert to previous implementation using os.fdopen(os.open())
2380
2381
        if writing:
2382
            if updating:
2383
                flags |= os.O_RDWR
2384
            else:
2385
                flags |= os.O_WRONLY
2386
            flags |= os.O_CREAT | os.O_TRUNC
2387
        elif appending:
2388
            if updating:
2389
                flags |= os.O_RDWR
2390
            else:
2391
                flags |= os.O_WRONLY
2392
            flags |= os.O_CREAT | os.O_APPEND
7143.15.2 by Jelmer Vernooij
Run autopep8.
2393
        else:  # reading
4634.140.9 by INADA Naoki
Revert to previous implementation using os.fdopen(os.open())
2394
            if updating:
2395
                flags |= os.O_RDWR
2396
            else:
2397
                flags |= os.O_RDONLY
2398
2399
        return os.fdopen(os.open(filename, flags), mode, bufsize)
4634.140.2 by INADA Naoki
Add osutils.open() that uses O_NOINHERIT on Win32.
2400
else:
4634.140.10 by INADA Naoki
Change name from osutils.open to osutils.open_file
2401
    open_file = open
5187.2.7 by Parth Malwankar
moved getuser_unicode to osutils.
2402
2403
5409.5.3 by Vincent Ladeuil
Implement osutils.available_backup_name.
2404
def available_backup_name(base, exists):
2405
    """Find a non-existing backup file name.
2406
5409.5.6 by Vincent Ladeuil
Add NEWS entry, tweak osutils.available_backup_name docstring.
2407
    This will *not* create anything, this only return a 'free' entry.  This
2408
    should be used for checking names in a directory below a locked
5409.5.8 by Vincent Ladeuil
Be more explicit about race conditions and LBYL being discouraged
2409
    tree/branch/repo to avoid race conditions. This is LBYL (Look Before You
2410
    Leap) and generally discouraged.
5409.5.3 by Vincent Ladeuil
Implement osutils.available_backup_name.
2411
2412
    :param base: The base name.
5409.5.8 by Vincent Ladeuil
Be more explicit about race conditions and LBYL being discouraged
2413
2414
    :param exists: A callable returning True if the path parameter exists.
5409.5.3 by Vincent Ladeuil
Implement osutils.available_backup_name.
2415
    """
2416
    counter = 1
2417
    name = "%s.~%d~" % (base, counter)
2418
    while exists(name):
2419
        counter += 1
5409.1.7 by Vincent Ladeuil
First orphaning implementation (some tests lacking).
2420
        name = "%s.~%d~" % (base, counter)
5409.5.3 by Vincent Ladeuil
Implement osutils.available_backup_name.
2421
    return name
5321.1.79 by Gordon Tyler
Added is_executable_on_path to osutils based on _probe from ExecutableFeature.
2422
2423
5582.6.1 by Max Bowsher
Fix socketpair-based SSH transport leaking socket into other child processes.
2424
def set_fd_cloexec(fd):
2425
    """Set a Unix file descriptor's FD_CLOEXEC flag.  Do nothing if platform
2426
    support for this is not available.
2427
    """
2428
    try:
2429
        import fcntl
2430
        old = fcntl.fcntl(fd, fcntl.F_GETFD)
2431
        fcntl.fcntl(fd, fcntl.F_SETFD, old | fcntl.FD_CLOEXEC)
2432
    except (ImportError, AttributeError):
2433
        # Either the fcntl module or specific constants are not present
2434
        pass
5321.1.114 by Gordon Tyler
Merged from bzr.dev.
2435
2436
5321.1.80 by Gordon Tyler
Changed is_executable_on_path to find_executable_on_path to make it more useful.
2437
def find_executable_on_path(name):
2438
    """Finds an executable on the PATH.
7143.15.2 by Jelmer Vernooij
Run autopep8.
2439
5321.1.79 by Gordon Tyler
Added is_executable_on_path to osutils based on _probe from ExecutableFeature.
2440
    On Windows, this will try to append each extension in the PATHEXT
2441
    environment variable to the name, if it cannot be found with the name
2442
    as given.
7143.15.2 by Jelmer Vernooij
Run autopep8.
2443
5321.1.79 by Gordon Tyler
Added is_executable_on_path to osutils based on _probe from ExecutableFeature.
2444
    :param name: The base name of the executable.
5321.1.80 by Gordon Tyler
Changed is_executable_on_path to find_executable_on_path to make it more useful.
2445
    :return: The path to the executable found or None.
5321.1.79 by Gordon Tyler
Added is_executable_on_path to osutils based on _probe from ExecutableFeature.
2446
    """
5321.1.105 by Gordon Tyler
Fixed find_executable_on_path to only check PATHEXT on win32.
2447
    if sys.platform == 'win32':
2448
        exts = os.environ.get('PATHEXT', '').split(os.pathsep)
5321.1.106 by Gordon Tyler
Fixed find_executable_on_path to properly test for executable-ness on win32 and not split the PATH for each extension in PATHEXT.
2449
        exts = [ext.lower() for ext in exts]
2450
        base, ext = os.path.splitext(name)
2451
        if ext != '':
2452
            if ext.lower() not in exts:
2453
                return None
2454
            name = base
2455
            exts = [ext]
5321.1.105 by Gordon Tyler
Fixed find_executable_on_path to only check PATHEXT on win32.
2456
    else:
2457
        exts = ['']
6437.44.1 by Gordon Tyler
Backport of fix for bug 939605 to bzr 2.5 series.
2458
    path = os.environ.get('PATH')
2459
    if path is not None:
2460
        path = path.split(os.pathsep)
2461
        for ext in exts:
2462
            for d in path:
2463
                f = os.path.join(d, name) + ext
2464
                if os.access(f, os.X_OK):
2465
                    return f
2466
    if sys.platform == 'win32':
2467
        app_path = win32utils.get_app_path(name)
2468
        if app_path != name:
2469
            return app_path
5321.1.80 by Gordon Tyler
Changed is_executable_on_path to find_executable_on_path to make it more useful.
2470
    return None
5425.5.2 by Martin
Split pid deadness detection code out into osutils
2471
2472
2473
def _posix_is_local_pid_dead(pid):
5425.5.4 by Martin
Get docstring of _posix_is_local_pid_dead the right way round
2474
    """True if pid doesn't correspond to live process on this machine"""
5425.5.2 by Martin
Split pid deadness detection code out into osutils
2475
    try:
2476
        # Special meaning of unix kill: just check if it's there.
2477
        os.kill(pid, 0)
6619.3.2 by Jelmer Vernooij
Apply 2to3 except fix.
2478
    except OSError as e:
5425.5.2 by Martin
Split pid deadness detection code out into osutils
2479
        if e.errno == errno.ESRCH:
2480
            # On this machine, and really not found: as sure as we can be
2481
            # that it's dead.
2482
            return True
2483
        elif e.errno == errno.EPERM:
2484
            # exists, though not ours
2485
            return False
2486
        else:
7143.15.5 by Jelmer Vernooij
More PEP8 fixes.
2487
            trace.mutter("os.kill(%d, 0) failed: %s" % (pid, e))
5425.4.20 by Martin Pool
Suppress failures from os.kill when just using it to check for process liveness
2488
            # Don't really know.
2489
            return False
5425.5.2 by Martin
Split pid deadness detection code out into osutils
2490
    else:
2491
        # Exists and our process: not dead.
2492
        return False
2493
7143.15.2 by Jelmer Vernooij
Run autopep8.
2494
5425.5.5 by Martin
Quick implementation of dead process detection on win32
2495
if sys.platform == "win32":
2496
    is_local_pid_dead = win32utils.is_local_pid_dead
2497
else:
2498
    is_local_pid_dead = _posix_is_local_pid_dead
6006.4.8 by Martin Pool
Use fsync when fdatasync is not available
2499
6015.60.4 by John Arbash Meinel
Found it called EOPNOTSUPP on a platform, include that spelling as well.
2500
_maybe_ignored = ['EAGAIN', 'EINTR', 'ENOTSUP', 'EOPNOTSUPP', 'EACCES']
2501
_fdatasync_ignored = [getattr(errno, name) for name in _maybe_ignored
6015.60.3 by John Arbash Meinel
only squelch known errors per vila.
2502
                      if getattr(errno, name, None) is not None]
6006.4.8 by Martin Pool
Use fsync when fdatasync is not available
2503
6015.60.4 by John Arbash Meinel
Found it called EOPNOTSUPP on a platform, include that spelling as well.
2504
6006.4.8 by Martin Pool
Use fsync when fdatasync is not available
2505
def fdatasync(fileno):
2506
    """Flush file contents to disk if possible.
7143.15.2 by Jelmer Vernooij
Run autopep8.
2507
6006.4.8 by Martin Pool
Use fsync when fdatasync is not available
2508
    :param fileno: Integer OS file handle.
2509
    :raises TransportNotPossible: If flushing to disk is not possible.
2510
    """
2511
    fn = getattr(os, 'fdatasync', getattr(os, 'fsync', None))
2512
    if fn is not None:
6015.60.2 by John Arbash Meinel
Fix bug #1075108.
2513
        try:
2514
            fn(fileno)
6619.3.2 by Jelmer Vernooij
Apply 2to3 except fix.
2515
        except IOError as e:
6015.60.2 by John Arbash Meinel
Fix bug #1075108.
2516
            # See bug #1075108, on some platforms fdatasync exists, but can
2517
            # raise ENOTSUP. However, we are calling fdatasync to be helpful
2518
            # and reduce the chance of corruption-on-powerloss situations. It
2519
            # is not a mandatory call, so it is ok to suppress failures.
2520
            trace.mutter("ignoring error calling fdatasync: %s" % (e,))
6015.60.3 by John Arbash Meinel
only squelch known errors per vila.
2521
            if getattr(e, 'errno', None) not in _fdatasync_ignored:
2522
                raise
6336.2.1 by Martin Packman
Add is_environment_error() and switch trace to using it
2523
2524
6015.51.1 by Martin Pool
Tolerate empty limbo and pending-deletion directories
2525
def ensure_empty_directory_exists(path, exception_class):
2526
    """Make sure a local directory exists and is empty.
7143.15.2 by Jelmer Vernooij
Run autopep8.
2527
6015.51.1 by Martin Pool
Tolerate empty limbo and pending-deletion directories
2528
    If it does not exist, it is created.  If it exists and is not empty, an
2529
    instance of exception_class is raised.
2530
    """
2531
    try:
2532
        os.mkdir(path)
6619.3.2 by Jelmer Vernooij
Apply 2to3 except fix.
2533
    except OSError as e:
6015.51.1 by Martin Pool
Tolerate empty limbo and pending-deletion directories
2534
        if e.errno != errno.EEXIST:
2535
            raise
2536
        if os.listdir(path) != []:
2537
            raise exception_class(path)
6344.1.1 by Martin Packman
Merge 2.4 into bzr.dev
2538
2539
7340.2.1 by Jelmer Vernooij
Read filesystem metadata from mtab directly rather than going via psutil.
2540
def read_mtab(path):
2541
    """Read an fstab-style file and extract mountpoint+filesystem information.
2542
2543
    :param path: Path to read from
2544
    :yield: Tuples with mountpoints (as bytestrings) and filesystem names
2545
    """
2546
    with open(path, 'rb') as f:
2547
        for line in f:
2548
            if line.startswith(b'#'):
2549
                continue
2550
            cols = line.split()
7340.2.2 by Jelmer Vernooij
Review comments.
2551
            if len(cols) < 3:
7340.2.1 by Jelmer Vernooij
Read filesystem metadata from mtab directly rather than going via psutil.
2552
                continue
7340.2.4 by Jelmer Vernooij
Fix tests.
2553
            yield cols[1], cols[2].decode('ascii', 'replace')
7340.2.1 by Jelmer Vernooij
Read filesystem metadata from mtab directly rather than going via psutil.
2554
2555
2556
MTAB_PATH = '/etc/mtab'
2557
2558
class FilesystemFinder(object):
2559
    """Find the filesystem for a particular path."""
2560
2561
    def __init__(self, mountpoints):
7340.2.2 by Jelmer Vernooij
Review comments.
2562
        def key(x):
2563
            return len(x[0])
2564
        self._mountpoints = sorted(mountpoints, key=key, reverse=True)
7340.2.1 by Jelmer Vernooij
Read filesystem metadata from mtab directly rather than going via psutil.
2565
2566
    @classmethod
2567
    def from_mtab(cls):
2568
        """Create a FilesystemFinder from an mtab-style file.
2569
2570
        Note that this will silenty ignore mtab if it doesn't exist or can not
2571
        be opened.
2572
        """
2573
        # TODO(jelmer): Use inotify to be notified when /etc/mtab changes and
2574
        # we need to re-read it.
2575
        try:
7340.2.2 by Jelmer Vernooij
Review comments.
2576
            return cls(read_mtab(MTAB_PATH))
7340.2.1 by Jelmer Vernooij
Read filesystem metadata from mtab directly rather than going via psutil.
2577
        except EnvironmentError as e:
2578
            trace.mutter('Unable to read mtab: %s', e)
2579
            return cls([])
2580
2581
    def find(self, path):
2582
        """Find the filesystem used by a particular path.
2583
2584
        :param path: Path to find (bytestring or text type)
2585
        :return: Filesystem name (as text type) or None, if the filesystem is
2586
            unknown.
2587
        """
2588
        for mountpoint, filesystem in self._mountpoints:
2589
            if is_inside(mountpoint, path):
2590
                return filesystem
2591
        return None
2592
2593
2594
_FILESYSTEM_FINDER = None
2595
2596
7122.7.1 by Jelmer Vernooij
Check for fs type to determine whether executable bit is supported.
2597
def get_fs_type(path):
7122.7.7 by Jelmer Vernooij
cope with psutil not being available.
2598
    """Return the filesystem type for the partition a path is in.
2599
2600
    :param path: Path to search filesystem type for
2601
    :return: A FS type, as string. E.g. "ext2"
2602
    """
7340.2.1 by Jelmer Vernooij
Read filesystem metadata from mtab directly rather than going via psutil.
2603
    global _FILESYSTEM_FINDER
2604
    if _FILESYSTEM_FINDER is None:
2605
        _FILESYSTEM_FINDER = FilesystemFinder.from_mtab()
7122.6.9 by Jelmer Vernooij
Fix tests on python 2.
2606
7340.2.4 by Jelmer Vernooij
Fix tests.
2607
    if not isinstance(path, bytes):
7122.6.9 by Jelmer Vernooij
Fix tests on python 2.
2608
        path = path.encode(_fs_enc)
2609
7340.2.1 by Jelmer Vernooij
Read filesystem metadata from mtab directly rather than going via psutil.
2610
    return _FILESYSTEM_FINDER.find(path)
7122.6.3 by Jelmer Vernooij
Merge trunk.
2611
2612
7479.2.1 by Jelmer Vernooij
Drop python2 support.
2613
perf_counter = time.perf_counter