/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to bzrlib/osutils.py

  • Committer: Robert Collins
  • Date: 2005-12-24 02:20:45 UTC
  • mto: (1185.50.57 bzr-jam-integration)
  • mto: This revision was merged to the branch mainline in revision 1550.
  • Revision ID: robertc@robertcollins.net-20051224022045-14efc8dfa0e1a4e9
Start tests for api usage.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
# Bazaar-NG -- distributed version control
2
 
 
 
2
#
3
3
# Copyright (C) 2005 by Canonical Ltd
4
 
 
 
4
#
5
5
# This program is free software; you can redistribute it and/or modify
6
6
# it under the terms of the GNU General Public License as published by
7
7
# the Free Software Foundation; either version 2 of the License, or
8
8
# (at your option) any later version.
9
 
 
 
9
#
10
10
# This program is distributed in the hope that it will be useful,
11
11
# but WITHOUT ANY WARRANTY; without even the implied warranty of
12
12
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13
13
# GNU General Public License for more details.
14
 
 
 
14
#
15
15
# You should have received a copy of the GNU General Public License
16
16
# along with this program; if not, write to the Free Software
17
17
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
18
18
 
19
 
import os, types, re, time, errno, sys
20
 
from stat import S_ISREG, S_ISDIR, S_ISLNK, ST_MODE, ST_SIZE
 
19
from shutil import copyfile
 
20
from stat import (S_ISREG, S_ISDIR, S_ISLNK, ST_MODE, ST_SIZE,
 
21
                  S_ISCHR, S_ISBLK, S_ISFIFO, S_ISSOCK)
 
22
from cStringIO import StringIO
 
23
import errno
 
24
import os
 
25
import re
 
26
import sha
 
27
import string
 
28
import sys
 
29
import time
 
30
import types
21
31
 
22
 
from bzrlib.errors import BzrError
 
32
import bzrlib
 
33
from bzrlib.errors import BzrError, PathNotChild
23
34
from bzrlib.trace import mutter
24
 
import bzrlib
 
35
 
25
36
 
26
37
def make_readonly(filename):
27
38
    """Make a filename read-only."""
28
 
    # TODO: probably needs to be fixed for windows
29
39
    mod = os.stat(filename).st_mode
30
40
    mod = mod & 0777555
31
41
    os.chmod(filename, mod)
37
47
    os.chmod(filename, mod)
38
48
 
39
49
 
40
 
_QUOTE_RE = re.compile(r'([^a-zA-Z0-9.,:/_~-])')
 
50
_QUOTE_RE = None
41
51
 
42
 
_SLASH_RE = re.compile(r'[\\/]+')
43
52
 
44
53
def quotefn(f):
45
54
    """Return a quoted filename filename
47
56
    This previously used backslash quoting, but that works poorly on
48
57
    Windows."""
49
58
    # TODO: I'm not really sure this is the best format either.x
 
59
    global _QUOTE_RE
 
60
    if _QUOTE_RE == None:
 
61
        _QUOTE_RE = re.compile(r'([^a-zA-Z0-9.,:/\\_~-])')
 
62
        
50
63
    if _QUOTE_RE.search(f):
51
64
        return '"' + f + '"'
52
65
    else:
61
74
        return 'directory'
62
75
    elif S_ISLNK(mode):
63
76
        return 'symlink'
 
77
    elif S_ISCHR(mode):
 
78
        return 'chardev'
 
79
    elif S_ISBLK(mode):
 
80
        return 'block'
 
81
    elif S_ISFIFO(mode):
 
82
        return 'fifo'
 
83
    elif S_ISSOCK(mode):
 
84
        return 'socket'
64
85
    else:
65
 
        raise BzrError("can't handle file kind with mode %o of %r" % (mode, f))
 
86
        return 'unknown'
66
87
 
67
88
 
68
89
def kind_marker(kind):
75
96
    else:
76
97
        raise BzrError('invalid file kind %r' % kind)
77
98
 
78
 
 
 
99
def lexists(f):
 
100
    try:
 
101
        if hasattr(os, 'lstat'):
 
102
            os.lstat(f)
 
103
        else:
 
104
            os.stat(f)
 
105
        return True
 
106
    except OSError,e:
 
107
        if e.errno == errno.ENOENT:
 
108
            return False;
 
109
        else:
 
110
            raise BzrError("lstat/stat of (%r): %r" % (f, e))
 
111
 
 
112
def normalizepath(f):
 
113
    if hasattr(os.path, 'realpath'):
 
114
        F = os.path.realpath
 
115
    else:
 
116
        F = os.path.abspath
 
117
    [p,e] = os.path.split(f)
 
118
    if e == "" or e == "." or e == "..":
 
119
        return F(f)
 
120
    else:
 
121
        return os.path.join(F(p), e)
 
122
 
 
123
if os.name == "posix":
 
124
    # In Python 2.4.2 and older, os.path.abspath and os.path.realpath
 
125
    # choke on a Unicode string containing a relative path if
 
126
    # os.getcwd() returns a non-sys.getdefaultencoding()-encoded
 
127
    # string.
 
128
    _fs_enc = sys.getfilesystemencoding()
 
129
    def abspath(path):
 
130
        return os.path.abspath(path.encode(_fs_enc)).decode(_fs_enc)
 
131
    def realpath(path):
 
132
        return os.path.realpath(path.encode(_fs_enc)).decode(_fs_enc)
 
133
else:
 
134
    # We need to use the Unicode-aware os.path.abspath and
 
135
    # os.path.realpath on Windows systems.
 
136
    abspath = os.path.abspath
 
137
    realpath = os.path.realpath
79
138
 
80
139
def backup_file(fn):
81
140
    """Copy a file to a backup.
84
143
 
85
144
    If the file is already a backup, it's not copied.
86
145
    """
87
 
    import os
88
146
    if fn[-1] == '~':
89
147
        return
90
148
    bfn = fn + '~'
91
149
 
 
150
    if has_symlinks() and os.path.islink(fn):
 
151
        target = os.readlink(fn)
 
152
        os.symlink(target, bfn)
 
153
        return
92
154
    inf = file(fn, 'rb')
93
155
    try:
94
156
        content = inf.read()
101
163
    finally:
102
164
        outf.close()
103
165
 
104
 
def rename(path_from, path_to):
105
 
    """Basically the same as os.rename() just special for win32"""
106
 
    if sys.platform == 'win32':
107
 
        try:
108
 
            os.remove(path_to)
109
 
        except OSError, e:
110
 
            if e.errno != e.ENOENT:
111
 
                raise
112
 
    os.rename(path_from, path_to)
113
 
 
114
 
 
115
 
 
 
166
if os.name == 'nt':
 
167
    import shutil
 
168
    rename = shutil.move
 
169
else:
 
170
    rename = os.rename
116
171
 
117
172
 
118
173
def isdir(f):
123
178
        return False
124
179
 
125
180
 
126
 
 
127
181
def isfile(f):
128
182
    """True if f is a regular file."""
129
183
    try:
131
185
    except OSError:
132
186
        return False
133
187
 
 
188
def islink(f):
 
189
    """True if f is a symlink."""
 
190
    try:
 
191
        return S_ISLNK(os.lstat(f)[ST_MODE])
 
192
    except OSError:
 
193
        return False
134
194
 
135
195
def is_inside(dir, fname):
136
196
    """True if fname is inside dir.
142
202
    The empty string as a dir name is taken as top-of-tree and matches 
143
203
    everything.
144
204
    
145
 
    >>> is_inside('src', 'src/foo.c')
 
205
    >>> is_inside('src', os.path.join('src', 'foo.c'))
146
206
    True
147
207
    >>> is_inside('src', 'srccontrol')
148
208
    False
149
 
    >>> is_inside('src', 'src/a/a/a/foo.c')
 
209
    >>> is_inside('src', os.path.join('src', 'a', 'a', 'a', 'foo.c'))
150
210
    True
151
211
    >>> is_inside('foo.c', 'foo.c')
152
212
    True
162
222
    
163
223
    if dir == '':
164
224
        return True
165
 
    
 
225
 
166
226
    if dir[-1] != os.sep:
167
227
        dir += os.sep
168
 
    
 
228
 
169
229
    return fname.startswith(dir)
170
230
 
171
231
 
180
240
 
181
241
def pumpfile(fromfile, tofile):
182
242
    """Copy contents of one file to another."""
183
 
    tofile.write(fromfile.read())
184
 
 
185
 
 
186
 
def uuid():
187
 
    """Return a new UUID"""
188
 
    try:
189
 
        return file('/proc/sys/kernel/random/uuid').readline().rstrip('\n')
190
 
    except IOError:
191
 
        return chomp(os.popen('uuidgen').readline())
 
243
    BUFSIZE = 32768
 
244
    while True:
 
245
        b = fromfile.read(BUFSIZE)
 
246
        if not b:
 
247
            break
 
248
        tofile.write(b)
192
249
 
193
250
 
194
251
def sha_file(f):
195
 
    import sha
196
252
    if hasattr(f, 'tell'):
197
253
        assert f.tell() == 0
198
254
    s = sha.new()
205
261
    return s.hexdigest()
206
262
 
207
263
 
 
264
 
 
265
def sha_strings(strings):
 
266
    """Return the sha-1 of concatenation of strings"""
 
267
    s = sha.new()
 
268
    map(s.update, strings)
 
269
    return s.hexdigest()
 
270
 
 
271
 
208
272
def sha_string(f):
209
 
    import sha
210
273
    s = sha.new()
211
274
    s.update(f)
212
275
    return s.hexdigest()
213
276
 
214
277
 
215
 
 
216
278
def fingerprint_file(f):
217
 
    import sha
218
279
    s = sha.new()
219
280
    b = f.read()
220
281
    s.update(b)
223
284
            'sha1': s.hexdigest()}
224
285
 
225
286
 
226
 
def config_dir():
227
 
    """Return per-user configuration directory.
228
 
 
229
 
    By default this is ~/.bzr.conf/
230
 
    
231
 
    TODO: Global option --config-dir to override this.
232
 
    """
233
 
    return os.path.expanduser("~/.bzr.conf")
234
 
 
235
 
 
236
 
def _auto_user_id():
237
 
    """Calculate automatic user identification.
238
 
 
239
 
    Returns (realname, email).
240
 
 
241
 
    Only used when none is set in the environment or the id file.
242
 
 
243
 
    This previously used the FQDN as the default domain, but that can
244
 
    be very slow on machines where DNS is broken.  So now we simply
245
 
    use the hostname.
246
 
    """
247
 
    import socket
248
 
 
249
 
    # XXX: Any good way to get real user name on win32?
250
 
 
251
 
    try:
252
 
        import pwd
253
 
        uid = os.getuid()
254
 
        w = pwd.getpwuid(uid)
255
 
        gecos = w.pw_gecos.decode(bzrlib.user_encoding)
256
 
        username = w.pw_name.decode(bzrlib.user_encoding)
257
 
        comma = gecos.find(',')
258
 
        if comma == -1:
259
 
            realname = gecos
260
 
        else:
261
 
            realname = gecos[:comma]
262
 
        if not realname:
263
 
            realname = username
264
 
 
265
 
    except ImportError:
266
 
        import getpass
267
 
        realname = username = getpass.getuser().decode(bzrlib.user_encoding)
268
 
 
269
 
    return realname, (username + '@' + socket.gethostname())
270
 
 
271
 
 
272
 
def _get_user_id():
273
 
    """Return the full user id from a file or environment variable.
274
 
 
275
 
    TODO: Allow taking this from a file in the branch directory too
276
 
    for per-branch ids."""
277
 
    v = os.environ.get('BZREMAIL')
278
 
    if v:
279
 
        return v.decode(bzrlib.user_encoding)
280
 
    
281
 
    try:
282
 
        return (open(os.path.join(config_dir(), "email"))
283
 
                .read()
284
 
                .decode(bzrlib.user_encoding)
285
 
                .rstrip("\r\n"))
286
 
    except IOError, e:
287
 
        if e.errno != errno.ENOENT:
288
 
            raise e
289
 
 
290
 
    v = os.environ.get('EMAIL')
291
 
    if v:
292
 
        return v.decode(bzrlib.user_encoding)
293
 
    else:    
294
 
        return None
295
 
 
296
 
 
297
 
def username():
298
 
    """Return email-style username.
299
 
 
300
 
    Something similar to 'Martin Pool <mbp@sourcefrog.net>'
301
 
 
302
 
    TODO: Check it's reasonably well-formed.
303
 
    """
304
 
    v = _get_user_id()
305
 
    if v:
306
 
        return v
307
 
    
308
 
    name, email = _auto_user_id()
309
 
    if name:
310
 
        return '%s <%s>' % (name, email)
311
 
    else:
312
 
        return email
313
 
 
314
 
 
315
 
_EMAIL_RE = re.compile(r'[\w+.-]+@[\w+.-]+')
316
 
def user_email():
317
 
    """Return just the email component of a username."""
318
 
    e = _get_user_id()
319
 
    if e:
320
 
        m = _EMAIL_RE.search(e)
321
 
        if not m:
322
 
            raise BzrError("%r doesn't seem to contain a reasonable email address" % e)
323
 
        return m.group(0)
324
 
 
325
 
    return _auto_user_id()[1]
326
 
    
327
 
 
328
 
 
329
287
def compare_files(a, b):
330
288
    """Returns true if equal in contents"""
331
289
    BUFSIZE = 4096
338
296
            return True
339
297
 
340
298
 
341
 
 
342
299
def local_time_offset(t=None):
343
300
    """Return offset of local zone from GMT, either at present or at time t."""
344
301
    # python2.3 localtime() can't take None
351
308
        return -time.timezone
352
309
 
353
310
    
354
 
def format_date(t, offset=0, timezone='original'):
 
311
def format_date(t, offset=0, timezone='original', date_fmt=None, 
 
312
                show_offset=True):
355
313
    ## TODO: Perhaps a global option to use either universal or local time?
356
314
    ## Or perhaps just let people set $TZ?
357
315
    assert isinstance(t, float)
369
327
    else:
370
328
        raise BzrError("unsupported timezone format %r" % timezone,
371
329
                       ['options are "utc", "original", "local"'])
372
 
 
373
 
    return (time.strftime("%a %Y-%m-%d %H:%M:%S", tt)
374
 
            + ' %+03d%02d' % (offset / 3600, (offset / 60) % 60))
 
330
    if date_fmt is None:
 
331
        date_fmt = "%a %Y-%m-%d %H:%M:%S"
 
332
    if show_offset:
 
333
        offset_str = ' %+03d%02d' % (offset / 3600, (offset / 60) % 60)
 
334
    else:
 
335
        offset_str = ''
 
336
    return (time.strftime(date_fmt, tt) +  offset_str)
375
337
 
376
338
 
377
339
def compact_date(when):
383
345
    """Return size of given open file."""
384
346
    return os.fstat(f.fileno())[ST_SIZE]
385
347
 
386
 
 
387
 
if hasattr(os, 'urandom'): # python 2.4 and later
 
348
# Define rand_bytes based on platform.
 
349
try:
 
350
    # Python 2.4 and later have os.urandom,
 
351
    # but it doesn't work on some arches
 
352
    os.urandom(1)
388
353
    rand_bytes = os.urandom
389
 
elif sys.platform == 'linux2':
390
 
    rand_bytes = file('/dev/urandom', 'rb').read
391
 
else:
392
 
    # not well seeded, but better than nothing
393
 
    def rand_bytes(n):
394
 
        import random
395
 
        s = ''
396
 
        while n:
397
 
            s += chr(random.randint(0, 255))
398
 
            n -= 1
399
 
        return s
400
 
 
 
354
except (NotImplementedError, AttributeError):
 
355
    # If python doesn't have os.urandom, or it doesn't work,
 
356
    # then try to first pull random data from /dev/urandom
 
357
    if os.path.exists("/dev/urandom"):
 
358
        rand_bytes = file('/dev/urandom', 'rb').read
 
359
    # Otherwise, use this hack as a last resort
 
360
    else:
 
361
        # not well seeded, but better than nothing
 
362
        def rand_bytes(n):
 
363
            import random
 
364
            s = ''
 
365
            while n:
 
366
                s += chr(random.randint(0, 255))
 
367
                n -= 1
 
368
            return s
401
369
 
402
370
## TODO: We could later have path objects that remember their list
403
371
## decomposition (might be too tricksy though.)
449
417
        return os.path.join(p1, p2)
450
418
    
451
419
 
452
 
def extern_command(cmd, ignore_errors = False):
453
 
    mutter('external command: %s' % `cmd`)
454
 
    if os.system(cmd):
455
 
        if not ignore_errors:
456
 
            raise BzrError('command failed')
457
 
 
458
 
 
459
 
def _read_config_value(name):
460
 
    """Read a config value from the file ~/.bzr.conf/<name>
461
 
    Return None if the file does not exist"""
 
420
def split_lines(s):
 
421
    """Split s into lines, but without removing the newline characters."""
 
422
    return StringIO(s).readlines()
 
423
 
 
424
 
 
425
def hardlinks_good():
 
426
    return sys.platform not in ('win32', 'cygwin', 'darwin')
 
427
 
 
428
 
 
429
def link_or_copy(src, dest):
 
430
    """Hardlink a file, or copy it if it can't be hardlinked."""
 
431
    if not hardlinks_good():
 
432
        copyfile(src, dest)
 
433
        return
462
434
    try:
463
 
        f = file(os.path.join(config_dir(), name), "r")
464
 
        return f.read().decode(bzrlib.user_encoding).rstrip("\r\n")
465
 
    except IOError, e:
466
 
        if e.errno == errno.ENOENT:
467
 
            return None
468
 
        raise
469
 
 
470
 
 
471
 
def _get_editor():
472
 
    """Return a sequence of possible editor binaries for the current platform"""
473
 
    e = _read_config_value("editor")
474
 
    if e is not None:
475
 
        yield e
 
435
        os.link(src, dest)
 
436
    except (OSError, IOError), e:
 
437
        if e.errno != errno.EXDEV:
 
438
            raise
 
439
        copyfile(src, dest)
 
440
 
 
441
 
 
442
def has_symlinks():
 
443
    if hasattr(os, 'symlink'):
 
444
        return True
 
445
    else:
 
446
        return False
476
447
        
477
 
    if os.name == "windows":
478
 
        yield "notepad.exe"
479
 
    elif os.name == "posix":
480
 
        try:
481
 
            yield os.environ["EDITOR"]
482
 
        except KeyError:
483
 
            yield "/usr/bin/vi"
484
 
 
485
 
 
486
 
def _run_editor(filename):
487
 
    """Try to execute an editor to edit the commit message. Returns True on success,
488
 
    False on failure"""
489
 
    for e in _get_editor():
490
 
        x = os.spawnvp(os.P_WAIT, e, (e, filename))
491
 
        if x == 0:
492
 
            return True
493
 
        elif x == 127:
494
 
            continue
495
 
        else:
 
448
 
 
449
def contains_whitespace(s):
 
450
    """True if there are any whitespace characters in s."""
 
451
    for ch in string.whitespace:
 
452
        if ch in s:
 
453
            return True
 
454
    else:
 
455
        return False
 
456
 
 
457
 
 
458
def contains_linebreaks(s):
 
459
    """True if there is any vertical whitespace in s."""
 
460
    for ch in '\f\n\r':
 
461
        if ch in s:
 
462
            return True
 
463
    else:
 
464
        return False
 
465
 
 
466
 
 
467
def relpath(base, path):
 
468
    """Return path relative to base, or raise exception.
 
469
 
 
470
    The path may be either an absolute path or a path relative to the
 
471
    current working directory.
 
472
 
 
473
    os.path.commonprefix (python2.4) has a bad bug that it works just
 
474
    on string prefixes, assuming that '/u' is a prefix of '/u2'.  This
 
475
    avoids that problem."""
 
476
    rp = abspath(path)
 
477
 
 
478
    s = []
 
479
    head = rp
 
480
    while len(head) >= len(base):
 
481
        if head == base:
496
482
            break
497
 
    raise BzrError("Could not start any editor. Please specify $EDITOR or use ~/.bzr.conf/editor")
498
 
    return False
499
 
                          
500
 
 
501
 
def get_text_message(infotext, ignoreline = "default"):
502
 
    import tempfile
503
 
    
504
 
    if ignoreline == "default":
505
 
        ignoreline = "-- This line and the following will be ignored --"
506
 
        
 
483
        head, tail = os.path.split(head)
 
484
        if tail:
 
485
            s.insert(0, tail)
 
486
    else:
 
487
        # XXX This should raise a NotChildPath exception, as its not tied
 
488
        # to branch anymore.
 
489
        raise PathNotChild(rp, base)
 
490
 
 
491
    return os.sep.join(s)
 
492
 
 
493
 
 
494
 
 
495
def terminal_width():
 
496
    """Return estimated terminal width."""
 
497
 
 
498
    # TODO: Do something smart on Windows?
 
499
 
 
500
    # TODO: Is there anything that gets a better update when the window
 
501
    # is resized while the program is running? We could use the Python termcap
 
502
    # library.
507
503
    try:
508
 
        tmp_fileno, msgfilename = tempfile.mkstemp()
509
 
        msgfile = os.close(tmp_fileno)
510
 
        if infotext is not None and infotext != "":
511
 
            hasinfo = True
512
 
            msgfile = file(msgfilename, "w")
513
 
            msgfile.write("\n\n%s\n\n%s" % (ignoreline, infotext))
514
 
            msgfile.close()
515
 
        else:
516
 
            hasinfo = False
517
 
 
518
 
        if not _run_editor(msgfilename):
519
 
            return None
520
 
        
521
 
        started = False
522
 
        msg = []
523
 
        lastline, nlines = 0, 0
524
 
        for line in file(msgfilename, "r"):
525
 
            stripped_line = line.strip()
526
 
            # strip empty line before the log message starts
527
 
            if not started:
528
 
                if stripped_line != "":
529
 
                    started = True
530
 
                else:
531
 
                    continue
532
 
            # check for the ignore line only if there
533
 
            # is additional information at the end
534
 
            if hasinfo and stripped_line == ignoreline:
535
 
                break
536
 
            nlines += 1
537
 
            # keep track of the last line that had some content
538
 
            if stripped_line != "":
539
 
                lastline = nlines
540
 
            msg.append(line)
541
 
            
542
 
        if len(msg) == 0:
543
 
            return None
544
 
        # delete empty lines at the end
545
 
        del msg[lastline:]
546
 
        # add a newline at the end, if needed
547
 
        if not msg[-1].endswith("\n"):
548
 
            return "%s%s" % ("".join(msg), "\n")
549
 
        else:
550
 
            return "".join(msg)
551
 
    finally:
552
 
        # delete the msg file in any case
553
 
        try: os.unlink(msgfilename)
554
 
        except IOError: pass
 
504
        return int(os.environ['COLUMNS'])
 
505
    except (IndexError, KeyError, ValueError):
 
506
        return 80