16
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
21
import sys, os, os.path, random, time, sha, sets, types, re, shutil, tempfile
22
import traceback, socket, fnmatch, difflib, time
23
from binascii import hexlify
26
from inventory import Inventory
27
from trace import mutter, note
28
from tree import Tree, EmptyTree, RevisionTree, WorkingTree
29
from inventory import InventoryEntry, Inventory
30
from osutils import isdir, quotefn, isfile, uuid, sha_file, username, chomp, \
31
format_date, compact_date, pumpfile, user_email, rand_bytes, splitpath, \
32
joinpath, sha_string, file_kind, local_time_offset
33
from store import ImmutableStore
34
from revision import Revision
35
from errors import bailout
36
from textui import show_status
37
from diff import diff_trees
21
from bzrlib.trace import mutter, note
22
from bzrlib.osutils import isdir, quotefn, compact_date, rand_bytes, splitpath, \
23
sha_file, appendpath, file_kind
24
from bzrlib.errors import BzrError
39
26
BZR_BRANCH_FORMAT = "Bazaar-NG branch, format 0.0.4\n"
40
27
## TODO: Maybe include checks for common corruption of newlines, etc?
31
def find_branch(f, **args):
32
if f and (f.startswith('http://') or f.startswith('https://')):
34
return remotebranch.RemoteBranch(f, **args)
36
return Branch(f, **args)
39
def find_cached_branch(f, cache_root, **args):
40
from remotebranch import RemoteBranch
41
br = find_branch(f, **args)
42
def cacheify(br, store_name):
43
from meta_store import CachedStore
44
cache_path = os.path.join(cache_root, store_name)
46
new_store = CachedStore(getattr(br, store_name), cache_path)
47
setattr(br, store_name, new_store)
49
if isinstance(br, RemoteBranch):
50
cacheify(br, 'inventory_store')
51
cacheify(br, 'text_store')
52
cacheify(br, 'revision_store')
56
def _relpath(base, path):
57
"""Return path relative to base, or raise exception.
59
The path may be either an absolute path or a path relative to the
60
current working directory.
62
Lifted out of Branch.relpath for ease of testing.
64
os.path.commonprefix (python2.4) has a bad bug that it works just
65
on string prefixes, assuming that '/u' is a prefix of '/u2'. This
66
avoids that problem."""
67
rp = os.path.abspath(path)
71
while len(head) >= len(base):
74
head, tail = os.path.split(head)
78
from errors import NotBranchError
79
raise NotBranchError("path %r is not within branch %r" % (rp, base))
84
def find_branch_root(f=None):
85
"""Find the branch root enclosing f, or pwd.
87
f may be a filename or a URL.
89
It is not necessary that f exists.
91
Basically we keep looking up until we find the control directory or
95
elif hasattr(os.path, 'realpath'):
96
f = os.path.realpath(f)
98
f = os.path.abspath(f)
99
if not os.path.exists(f):
100
raise BzrError('%r does not exist' % f)
106
if os.path.exists(os.path.join(f, bzrlib.BZRDIR)):
108
head, tail = os.path.split(f)
110
# reached the root, whatever that may be
111
raise BzrError('%r is not in a branch' % orig_f)
114
class DivergedBranches(Exception):
115
def __init__(self, branch1, branch2):
116
self.branch1 = branch1
117
self.branch2 = branch2
118
Exception.__init__(self, "These branches have diverged.")
121
class NoSuchRevision(BzrError):
122
def __init__(self, branch, revision):
124
self.revision = revision
125
msg = "Branch %s has no revision %d" % (branch, revision)
126
BzrError.__init__(self, msg)
46
129
######################################################################
132
class Branch(object):
50
133
"""Branch holding a history of revisions.
52
:todo: Perhaps use different stores for different classes of object,
53
so that we can keep track of how much space each one uses,
54
or garbage-collect them.
56
:todo: Add a RemoteBranch subclass. For the basic case of read-only
57
HTTP access this should be very easy by,
58
just redirecting controlfile access into HTTP requests.
59
We would need a RemoteStore working similarly.
61
:todo: Keep the on-disk branch locked while the object exists.
63
:todo: mkdir() method.
136
Base directory of the branch.
142
If _lock_mode is true, a positive count of the number of times the
146
Lock object from bzrlib.lock.
65
def __init__(self, base, init=False):
153
def __init__(self, base, init=False, find_root=True):
66
154
"""Create new branch object at a particular location.
68
:param base: Base directory for the branch.
70
:param init: If True, create new control files in a previously
156
base -- Base directory for the branch.
158
init -- If True, create new control files in a previously
71
159
unversioned directory. If False, the branch must already
162
find_root -- If true and init is false, find the root of the
163
existing branch containing base.
74
165
In the test suite, creation of new trees is tested using the
75
166
`ScratchBranch` class.
77
self.base = os.path.realpath(base)
168
from bzrlib.store import ImmutableStore
170
self.base = os.path.realpath(base)
79
171
self._make_control()
173
self.base = find_branch_root(base)
175
self.base = os.path.realpath(base)
81
176
if not isdir(self.controlfilename('.')):
82
bailout("not a bzr branch: %s" % quotefn(base),
83
['use "bzr init" to initialize a new working tree',
84
'current bzr can only operate from top-of-tree'])
177
from errors import NotBranchError
178
raise NotBranchError("not a bzr branch: %s" % quotefn(base),
179
['use "bzr init" to initialize a new working tree',
180
'current bzr can only operate from top-of-tree'])
87
183
self.text_store = ImmutableStore(self.controlfilename('text-store'))
88
184
self.revision_store = ImmutableStore(self.controlfilename('revision-store'))
96
192
__repr__ = __str__
100
"""Return filename relative to branch top"""
196
if self._lock_mode or self._lock:
197
from warnings import warn
198
warn("branch %r was not explicitly unlocked" % self)
203
def lock_write(self):
205
if self._lock_mode != 'w':
206
from errors import LockError
207
raise LockError("can't upgrade to a write lock from %r" %
209
self._lock_count += 1
211
from bzrlib.lock import WriteLock
213
self._lock = WriteLock(self.controlfilename('branch-lock'))
214
self._lock_mode = 'w'
221
assert self._lock_mode in ('r', 'w'), \
222
"invalid lock mode %r" % self._lock_mode
223
self._lock_count += 1
225
from bzrlib.lock import ReadLock
227
self._lock = ReadLock(self.controlfilename('branch-lock'))
228
self._lock_mode = 'r'
234
if not self._lock_mode:
235
from errors import LockError
236
raise LockError('branch %r is not locked' % (self))
238
if self._lock_count > 1:
239
self._lock_count -= 1
243
self._lock_mode = self._lock_count = None
246
def abspath(self, name):
247
"""Return absolute filename for something in the branch"""
101
248
return os.path.join(self.base, name)
251
def relpath(self, path):
252
"""Return path relative to this branch of something inside it.
254
Raises an error if path is not in this branch."""
255
return _relpath(self.base, path)
104
258
def controlfilename(self, file_or_path):
105
259
"""Return location relative to branch."""
106
if isinstance(file_or_path, types.StringTypes):
260
if isinstance(file_or_path, basestring):
107
261
file_or_path = [file_or_path]
108
262
return os.path.join(self.base, bzrlib.BZRDIR, *file_or_path)
111
265
def controlfile(self, file_or_path, mode='r'):
112
"""Open a control file for this branch"""
113
return file(self.controlfilename(file_or_path), mode)
266
"""Open a control file for this branch.
268
There are two classes of file in the control directory: text
269
and binary. binary files are untranslated byte streams. Text
270
control files are stored with Unix newlines and in UTF-8, even
271
if the platform or locale defaults are different.
273
Controlfiles should almost never be opened in write mode but
274
rather should be atomically copied and replaced using atomicfile.
277
fn = self.controlfilename(file_or_path)
279
if mode == 'rb' or mode == 'wb':
280
return file(fn, mode)
281
elif mode == 'r' or mode == 'w':
282
# open in binary mode anyhow so there's no newline translation;
283
# codecs uses line buffering by default; don't want that.
285
return codecs.open(fn, mode + 'b', 'utf-8',
288
raise BzrError("invalid controlfile mode %r" % mode)
116
292
def _make_control(self):
293
from bzrlib.inventory import Inventory
117
294
os.mkdir(self.controlfilename([]))
118
295
self.controlfile('README', 'w').write(
119
296
"This is a Bazaar-NG control directory.\n"
120
"Do not change any files in this directory.")
297
"Do not change any files in this directory.\n")
121
298
self.controlfile('branch-format', 'w').write(BZR_BRANCH_FORMAT)
122
299
for d in ('text-store', 'inventory-store', 'revision-store'):
123
300
os.mkdir(self.controlfilename(d))
124
301
for f in ('revision-history', 'merged-patches',
125
'pending-merged-patches', 'branch-name'):
302
'pending-merged-patches', 'branch-name',
126
304
self.controlfile(f, 'w').write('')
127
305
mutter('created control directory in ' + self.base)
128
306
Inventory().write_xml(self.controlfile('inventory','w'))
136
314
In the future, we might need different in-memory Branch
137
315
classes to support downlevel branches. But not yet.
139
# read in binary mode to detect newline wierdness.
140
fmt = self.controlfile('branch-format', 'rb').read()
317
# This ignores newlines so that we can open branches created
318
# on Windows from Linux and so on. I think it might be better
319
# to always make all internal files in unix format.
320
fmt = self.controlfile('branch-format', 'r').read()
321
fmt.replace('\r\n', '')
141
322
if fmt != BZR_BRANCH_FORMAT:
142
bailout('sorry, branch format %r not supported' % fmt,
143
['use a different bzr version',
144
'or remove the .bzr directory and "bzr init" again'])
323
raise BzrError('sorry, branch format %r not supported' % fmt,
324
['use a different bzr version',
325
'or remove the .bzr directory and "bzr init" again'])
147
329
def read_working_inventory(self):
148
330
"""Read the working inventory."""
150
inv = Inventory.read_xml(self.controlfile('inventory', 'r'))
151
mutter("loaded inventory of %d items in %f"
152
% (len(inv), time.time() - before))
331
from bzrlib.inventory import Inventory
332
from time import time
334
# ElementTree does its own conversion from UTF-8, so open in
338
inv = Inventory.read_xml(self.controlfile('inventory', 'rb'))
339
mutter("loaded inventory of %d items in %f"
340
% (len(inv), time() - before))
156
346
def _write_inventory(self, inv):
157
347
"""Update the working inventory.
159
349
That is to say, the inventory describing changes underway, that
160
350
will be committed to the next revision.
162
## TODO: factor out to atomicfile? is rename safe on windows?
163
tmpfname = self.controlfilename('inventory.tmp')
164
tmpf = file(tmpfname, 'w')
167
os.rename(tmpfname, self.controlfilename('inventory'))
354
from bzrlib.atomicfile import AtomicFile
356
f = AtomicFile(self.controlfilename('inventory'), 'wb')
168
365
mutter('wrote working inventory')
171
368
inventory = property(read_working_inventory, _write_inventory, None,
172
369
"""Inventory for the working copy.""")
175
def add(self, files, verbose=False):
372
def add(self, files, verbose=False, ids=None):
176
373
"""Make files versioned.
375
Note that the command line normally calls smart_add instead.
178
377
This puts the files in the Added state, so that they will be
179
378
recorded by the next commit.
181
:todo: Perhaps have an option to add the ids even if the files do
184
:todo: Perhaps return the ids of the files? But then again it
185
is easy to retrieve them if they're needed.
187
:todo: Option to specify file id.
189
:todo: Adding a directory should optionally recurse down and
190
add all non-ignored children. Perhaps do that in a
193
>>> b = ScratchBranch(files=['foo'])
194
>>> 'foo' in b.unknowns()
199
>>> 'foo' in b.unknowns()
201
>>> bool(b.inventory.path2id('foo'))
207
Traceback (most recent call last):
209
BzrError: ('foo is already versioned', [])
211
>>> b.add(['nothere'])
212
Traceback (most recent call last):
213
BzrError: ('cannot add: not a regular file or directory: nothere', [])
381
List of paths to add, relative to the base of the tree.
384
If set, use these instead of automatically generated ids.
385
Must be the same length as the list of files, but may
386
contain None for ids that are to be autogenerated.
388
TODO: Perhaps have an option to add the ids even if the files do
391
TODO: Perhaps return the ids of the files? But then again it
392
is easy to retrieve them if they're needed.
394
TODO: Adding a directory should optionally recurse down and
395
add all non-ignored children. Perhaps do that in a
398
from bzrlib.textui import show_status
216
399
# TODO: Re-adding a file that is removed in the working copy
217
400
# should probably put it back with the previous ID.
218
if isinstance(files, types.StringTypes):
401
if isinstance(files, basestring):
402
assert(ids is None or isinstance(ids, basestring))
221
inv = self.read_working_inventory()
223
if is_control_file(f):
224
bailout("cannot add control file %s" % quotefn(f))
229
bailout("cannot add top-level %r" % f)
231
fullpath = os.path.normpath(self._rel(f))
235
elif isdir(fullpath):
238
bailout('cannot add: not a regular file or directory: %s' % quotefn(f))
241
parent_name = joinpath(fp[:-1])
242
mutter("lookup parent %r" % parent_name)
243
parent_id = inv.path2id(parent_name)
244
if parent_id == None:
245
bailout("cannot add: parent %r is not versioned"
250
file_id = _gen_file_id(fp[-1])
251
inv.add(InventoryEntry(file_id, fp[-1], kind=kind, parent_id=parent_id))
253
show_status('A', kind, quotefn(f))
255
mutter("add file %s file_id:{%s} kind=%r parent_id={%s}"
256
% (f, file_id, kind, parent_id))
257
self._write_inventory(inv)
408
ids = [None] * len(files)
410
assert(len(ids) == len(files))
414
inv = self.read_working_inventory()
415
for f,file_id in zip(files, ids):
416
if is_control_file(f):
417
raise BzrError("cannot add control file %s" % quotefn(f))
422
raise BzrError("cannot add top-level %r" % f)
424
fullpath = os.path.normpath(self.abspath(f))
427
kind = file_kind(fullpath)
429
# maybe something better?
430
raise BzrError('cannot add: not a regular file or directory: %s' % quotefn(f))
432
if kind != 'file' and kind != 'directory':
433
raise BzrError('cannot add: not a regular file or directory: %s' % quotefn(f))
436
file_id = gen_file_id(f)
437
inv.add_path(f, kind=kind, file_id=file_id)
440
print 'added', quotefn(f)
442
mutter("add file %s file_id:{%s} kind=%r" % (f, file_id, kind))
444
self._write_inventory(inv)
449
def print_file(self, file, revno):
450
"""Print `file` to stdout."""
453
tree = self.revision_tree(self.lookup_revision(revno))
454
# use inventory as it was in that revision
455
file_id = tree.inventory.path2id(file)
457
raise BzrError("%r is not present in revision %d" % (file, revno))
458
tree.print_file(file_id)
261
463
def remove(self, files, verbose=False):
264
466
This does not remove their text. This does not run on
266
:todo: Refuse to remove modified files unless --force is given?
268
>>> b = ScratchBranch(files=['foo'])
270
>>> b.inventory.has_filename('foo')
273
>>> b.working_tree().has_filename('foo')
275
>>> b.inventory.has_filename('foo')
278
>>> b = ScratchBranch(files=['foo'])
283
>>> b.inventory.has_filename('foo')
285
>>> b.basis_tree().has_filename('foo')
287
>>> b.working_tree().has_filename('foo')
290
:todo: Do something useful with directories.
292
:todo: Should this remove the text or not? Tough call; not
468
TODO: Refuse to remove modified files unless --force is given?
470
TODO: Do something useful with directories.
472
TODO: Should this remove the text or not? Tough call; not
293
473
removing may be useful and the user can just use use rm, and
294
474
is the opposite of add. Removing it is consistent with most
295
475
other tools. Maybe an option.
477
from bzrlib.textui import show_status
297
478
## TODO: Normalize names
298
479
## TODO: Remove nested loops; better scalability
300
if isinstance(files, types.StringTypes):
480
if isinstance(files, basestring):
303
tree = self.working_tree()
306
# do this before any modifications
310
bailout("cannot remove unversioned file %s" % quotefn(f))
311
mutter("remove inventory entry %s {%s}" % (quotefn(f), fid))
313
# having remove it, it must be either ignored or unknown
314
if tree.is_ignored(f):
318
show_status(new_status, inv[fid].kind, quotefn(f))
486
tree = self.working_tree()
489
# do this before any modifications
493
raise BzrError("cannot remove unversioned file %s" % quotefn(f))
494
mutter("remove inventory entry %s {%s}" % (quotefn(f), fid))
496
# having remove it, it must be either ignored or unknown
497
if tree.is_ignored(f):
501
show_status(new_status, inv[fid].kind, quotefn(f))
504
self._write_inventory(inv)
509
# FIXME: this doesn't need to be a branch method
510
def set_inventory(self, new_inventory_list):
511
from bzrlib.inventory import Inventory, InventoryEntry
513
for path, file_id, parent, kind in new_inventory_list:
514
name = os.path.basename(path)
517
inv.add(InventoryEntry(file_id, name, kind, parent))
321
518
self._write_inventory(inv)
340
537
return self.working_tree().unknowns()
343
def commit(self, message, timestamp=None, timezone=None,
346
"""Commit working copy as a new revision.
348
The basic approach is to add all the file texts into the
349
store, then the inventory, then make a new revision pointing
350
to that inventory and store that.
352
This is not quite safe if the working copy changes during the
353
commit; for the moment that is simply not allowed. A better
354
approach is to make a temporary copy of the files before
355
computing their hashes, and then add those hashes in turn to
356
the inventory. This should mean at least that there are no
357
broken hash pointers. There is no way we can get a snapshot
358
of the whole directory at an instant. This would also have to
359
be robust against files disappearing, moving, etc. So the
360
whole thing is a bit hard.
362
:param timestamp: if not None, seconds-since-epoch for a
363
postdated/predated commit.
366
## TODO: Show branch names
368
# TODO: Don't commit if there are no changes, unless forced?
370
# First walk over the working inventory; and both update that
371
# and also build a new revision inventory. The revision
372
# inventory needs to hold the text-id, sha1 and size of the
373
# actual file versions committed in the revision. (These are
374
# not present in the working inventory.) We also need to
375
# detect missing/deleted files, and remove them from the
378
work_inv = self.read_working_inventory()
380
basis = self.basis_tree()
381
basis_inv = basis.inventory
383
for path, entry in work_inv.iter_entries():
384
## TODO: Cope with files that have gone missing.
386
## TODO: Check that the file kind has not changed from the previous
387
## revision of this file (if any).
392
file_id = entry.file_id
393
mutter('commit prep file %s, id %r ' % (p, file_id))
395
if not os.path.exists(p):
396
mutter(" file is missing, removing from inventory")
398
show_status('D', entry.kind, quotefn(path))
399
missing_ids.append(file_id)
402
# TODO: Handle files that have been deleted
404
# TODO: Maybe a special case for empty files? Seems a
405
# waste to store them many times.
409
if basis_inv.has_id(file_id):
410
old_kind = basis_inv[file_id].kind
411
if old_kind != entry.kind:
412
bailout("entry %r changed kind from %r to %r"
413
% (file_id, old_kind, entry.kind))
415
if entry.kind == 'directory':
417
bailout("%s is entered as directory but not a directory" % quotefn(p))
418
elif entry.kind == 'file':
420
bailout("%s is entered as file but is not a file" % quotefn(p))
422
content = file(p, 'rb').read()
424
entry.text_sha1 = sha_string(content)
425
entry.text_size = len(content)
427
old_ie = basis_inv.has_id(file_id) and basis_inv[file_id]
429
and (old_ie.text_size == entry.text_size)
430
and (old_ie.text_sha1 == entry.text_sha1)):
431
## assert content == basis.get_file(file_id).read()
432
entry.text_id = basis_inv[file_id].text_id
433
mutter(' unchanged from previous text_id {%s}' %
437
entry.text_id = _gen_file_id(entry.name)
438
self.text_store.add(content, entry.text_id)
439
mutter(' stored with text_id {%s}' % entry.text_id)
443
elif (old_ie.name == entry.name
444
and old_ie.parent_id == entry.parent_id):
449
show_status(state, entry.kind, quotefn(path))
451
for file_id in missing_ids:
452
# have to do this later so we don't mess up the iterator.
453
# since parents may be removed before their children we
456
# FIXME: There's probably a better way to do this; perhaps
457
# the workingtree should know how to filter itself.
458
if work_inv.has_id(file_id):
459
del work_inv[file_id]
462
inv_id = rev_id = _gen_revision_id(time.time())
464
inv_tmp = tempfile.TemporaryFile()
465
inv.write_xml(inv_tmp)
467
self.inventory_store.add(inv_tmp, inv_id)
468
mutter('new inventory_id is {%s}' % inv_id)
470
self._write_inventory(work_inv)
472
if timestamp == None:
473
timestamp = time.time()
475
if committer == None:
476
committer = username()
479
timezone = local_time_offset()
481
mutter("building commit log message")
482
rev = Revision(timestamp=timestamp,
485
precursor = self.last_patch(),
490
rev_tmp = tempfile.TemporaryFile()
491
rev.write_xml(rev_tmp)
493
self.revision_store.add(rev_tmp, rev_id)
494
mutter("new revision_id is {%s}" % rev_id)
496
## XXX: Everything up to here can simply be orphaned if we abort
497
## the commit; it will leave junk files behind but that doesn't
500
## TODO: Read back the just-generated changeset, and make sure it
501
## applies and recreates the right state.
503
## TODO: Also calculate and store the inventory SHA1
504
mutter("committing patch r%d" % (self.revno() + 1))
506
mutter("append to revision-history")
507
self.controlfile('revision-history', 'at').write(rev_id + '\n')
540
def append_revision(self, revision_id):
541
from bzrlib.atomicfile import AtomicFile
543
mutter("add {%s} to revision-history" % revision_id)
544
rev_history = self.revision_history() + [revision_id]
546
f = AtomicFile(self.controlfilename('revision-history'))
548
for rev_id in rev_history:
512
555
def get_revision(self, revision_id):
513
556
"""Return the Revision object for a named revision"""
557
from bzrlib.revision import Revision
558
if not revision_id or not isinstance(revision_id, basestring):
559
raise ValueError('invalid revision-id: %r' % revision_id)
514
560
r = Revision.read_xml(self.revision_store[revision_id])
515
561
assert r.revision_id == revision_id
564
def get_revision_sha1(self, revision_id):
565
"""Hash the stored value of a revision, and return it."""
566
# In the future, revision entries will be signed. At that
567
# point, it is probably best *not* to include the signature
568
# in the revision hash. Because that lets you re-sign
569
# the revision, (add signatures/remove signatures) and still
570
# have all hash pointers stay consistent.
571
# But for now, just hash the contents.
572
return sha_file(self.revision_store[revision_id])
519
575
def get_inventory(self, inventory_id):
520
576
"""Get Inventory object by hash.
522
:todo: Perhaps for this and similar methods, take a revision
578
TODO: Perhaps for this and similar methods, take a revision
523
579
parameter which can be either an integer revno or a
581
from bzrlib.inventory import Inventory
525
582
i = Inventory.read_xml(self.inventory_store[inventory_id])
585
def get_inventory_sha1(self, inventory_id):
586
"""Return the sha1 hash of the inventory entry
588
return sha_file(self.inventory_store[inventory_id])
529
591
def get_revision_inventory(self, revision_id):
530
592
"""Return inventory of a past revision."""
531
593
if revision_id == None:
594
from bzrlib.inventory import Inventory
532
595
return Inventory()
534
597
return self.get_inventory(self.get_revision(revision_id).inventory_id)
540
603
>>> ScratchBranch().revision_history()
543
return [chomp(l) for l in self.controlfile('revision-history').readlines()]
608
return [l.rstrip('\r\n') for l in
609
self.controlfile('revision-history', 'r').readlines()]
614
def common_ancestor(self, other, self_revno=None, other_revno=None):
617
>>> sb = ScratchBranch(files=['foo', 'foo~'])
618
>>> sb.common_ancestor(sb) == (None, None)
620
>>> commit.commit(sb, "Committing first revision", verbose=False)
621
>>> sb.common_ancestor(sb)[0]
623
>>> clone = sb.clone()
624
>>> commit.commit(sb, "Committing second revision", verbose=False)
625
>>> sb.common_ancestor(sb)[0]
627
>>> sb.common_ancestor(clone)[0]
629
>>> commit.commit(clone, "Committing divergent second revision",
631
>>> sb.common_ancestor(clone)[0]
633
>>> sb.common_ancestor(clone) == clone.common_ancestor(sb)
635
>>> sb.common_ancestor(sb) != clone.common_ancestor(clone)
637
>>> clone2 = sb.clone()
638
>>> sb.common_ancestor(clone2)[0]
640
>>> sb.common_ancestor(clone2, self_revno=1)[0]
642
>>> sb.common_ancestor(clone2, other_revno=1)[0]
645
my_history = self.revision_history()
646
other_history = other.revision_history()
647
if self_revno is None:
648
self_revno = len(my_history)
649
if other_revno is None:
650
other_revno = len(other_history)
651
indices = range(min((self_revno, other_revno)))
654
if my_history[r] == other_history[r]:
655
return r+1, my_history[r]
658
def enum_history(self, direction):
659
"""Return (revno, revision_id) for history of branch.
662
'forward' is from earliest to latest
663
'reverse' is from latest to earliest
665
rh = self.revision_history()
666
if direction == 'forward':
671
elif direction == 'reverse':
677
raise ValueError('invalid history direction', direction)
549
683
That is equivalent to the number of revisions committed to
552
>>> b = ScratchBranch()
555
>>> b.commit('no foo')
559
686
return len(self.revision_history())
562
689
def last_patch(self):
563
690
"""Return last patch hash, or None if no history.
565
>>> ScratchBranch().last_patch() == None
568
692
ph = self.revision_history()
699
def missing_revisions(self, other, stop_revision=None):
701
If self and other have not diverged, return a list of the revisions
702
present in other, but missing from self.
704
>>> from bzrlib.commit import commit
705
>>> bzrlib.trace.silent = True
706
>>> br1 = ScratchBranch()
707
>>> br2 = ScratchBranch()
708
>>> br1.missing_revisions(br2)
710
>>> commit(br2, "lala!", rev_id="REVISION-ID-1")
711
>>> br1.missing_revisions(br2)
713
>>> br2.missing_revisions(br1)
715
>>> commit(br1, "lala!", rev_id="REVISION-ID-1")
716
>>> br1.missing_revisions(br2)
718
>>> commit(br2, "lala!", rev_id="REVISION-ID-2A")
719
>>> br1.missing_revisions(br2)
721
>>> commit(br1, "lala!", rev_id="REVISION-ID-2B")
722
>>> br1.missing_revisions(br2)
723
Traceback (most recent call last):
724
DivergedBranches: These branches have diverged.
726
self_history = self.revision_history()
727
self_len = len(self_history)
728
other_history = other.revision_history()
729
other_len = len(other_history)
730
common_index = min(self_len, other_len) -1
731
if common_index >= 0 and \
732
self_history[common_index] != other_history[common_index]:
733
raise DivergedBranches(self, other)
735
if stop_revision is None:
736
stop_revision = other_len
737
elif stop_revision > other_len:
738
raise NoSuchRevision(self, stop_revision)
740
return other_history[self_len:stop_revision]
743
def update_revisions(self, other, stop_revision=None):
744
"""Pull in all new revisions from other branch.
746
>>> from bzrlib.commit import commit
747
>>> bzrlib.trace.silent = True
748
>>> br1 = ScratchBranch(files=['foo', 'bar'])
751
>>> commit(br1, "lala!", rev_id="REVISION-ID-1", verbose=False)
752
>>> br2 = ScratchBranch()
753
>>> br2.update_revisions(br1)
757
>>> br2.revision_history()
759
>>> br2.update_revisions(br1)
763
>>> br1.text_store.total_size() == br2.text_store.total_size()
766
from bzrlib.progress import ProgressBar
770
from sets import Set as set
774
pb.update('comparing histories')
775
revision_ids = self.missing_revisions(other, stop_revision)
777
if hasattr(other.revision_store, "prefetch"):
778
other.revision_store.prefetch(revision_ids)
779
if hasattr(other.inventory_store, "prefetch"):
780
inventory_ids = [other.get_revision(r).inventory_id
781
for r in revision_ids]
782
other.inventory_store.prefetch(inventory_ids)
787
for rev_id in revision_ids:
789
pb.update('fetching revision', i, len(revision_ids))
790
rev = other.get_revision(rev_id)
791
revisions.append(rev)
792
inv = other.get_inventory(str(rev.inventory_id))
793
for key, entry in inv.iter_entries():
794
if entry.text_id is None:
796
if entry.text_id not in self.text_store:
797
needed_texts.add(entry.text_id)
801
count = self.text_store.copy_multi(other.text_store, needed_texts)
802
print "Added %d texts." % count
803
inventory_ids = [ f.inventory_id for f in revisions ]
804
count = self.inventory_store.copy_multi(other.inventory_store,
806
print "Added %d inventories." % count
807
revision_ids = [ f.revision_id for f in revisions]
808
count = self.revision_store.copy_multi(other.revision_store,
810
for revision_id in revision_ids:
811
self.append_revision(revision_id)
812
print "Added %d revisions." % count
815
def commit(self, *args, **kw):
816
from bzrlib.commit import commit
817
commit(self, *args, **kw)
573
820
def lookup_revision(self, revno):
574
821
"""Return revision hash for revision number."""
626
def write_log(self, show_timezone='original'):
627
"""Write out human-readable log of commits to this branch
629
:param utc: If true, show dates in universal time, not local time."""
630
## TODO: Option to choose either original, utc or local timezone
633
for p in self.revision_history():
635
print 'revno:', revno
636
## TODO: Show hash if --id is given.
637
##print 'revision-hash:', p
638
rev = self.get_revision(p)
639
print 'committer:', rev.committer
640
print 'timestamp: %s' % (format_date(rev.timestamp, rev.timezone or 0,
643
## opportunistic consistency check, same as check_patch_chaining
644
if rev.precursor != precursor:
645
bailout("mismatched precursor!")
649
print ' (no message)'
651
for l in rev.message.split('\n'):
659
def show_status(branch, show_all=False):
660
"""Display single-line status for non-ignored working files.
662
The list is show sorted in order by file name.
664
>>> b = ScratchBranch(files=['foo', 'foo~'])
670
>>> b.commit("add foo")
672
>>> os.unlink(b._rel('foo'))
867
def rename_one(self, from_rel, to_rel):
870
This can change the directory or the filename or both.
874
tree = self.working_tree()
876
if not tree.has_filename(from_rel):
877
raise BzrError("can't rename: old working file %r does not exist" % from_rel)
878
if tree.has_filename(to_rel):
879
raise BzrError("can't rename: new working file %r already exists" % to_rel)
881
file_id = inv.path2id(from_rel)
883
raise BzrError("can't rename: old name %r is not versioned" % from_rel)
885
if inv.path2id(to_rel):
886
raise BzrError("can't rename: new name %r is already versioned" % to_rel)
888
to_dir, to_tail = os.path.split(to_rel)
889
to_dir_id = inv.path2id(to_dir)
890
if to_dir_id == None and to_dir != '':
891
raise BzrError("can't determine destination directory id for %r" % to_dir)
893
mutter("rename_one:")
894
mutter(" file_id {%s}" % file_id)
895
mutter(" from_rel %r" % from_rel)
896
mutter(" to_rel %r" % to_rel)
897
mutter(" to_dir %r" % to_dir)
898
mutter(" to_dir_id {%s}" % to_dir_id)
900
inv.rename(file_id, to_dir_id, to_tail)
902
print "%s => %s" % (from_rel, to_rel)
904
from_abs = self.abspath(from_rel)
905
to_abs = self.abspath(to_rel)
907
os.rename(from_abs, to_abs)
909
raise BzrError("failed to rename %r to %r: %s"
910
% (from_abs, to_abs, e[1]),
911
["rename rolled back"])
913
self._write_inventory(inv)
918
def move(self, from_paths, to_name):
921
to_name must exist as a versioned directory.
923
If to_name exists and is a directory, the files are moved into
924
it, keeping their old names. If it is a directory,
926
Note that to_name is only the last component of the new name;
927
this doesn't change the directory.
931
## TODO: Option to move IDs only
932
assert not isinstance(from_paths, basestring)
933
tree = self.working_tree()
935
to_abs = self.abspath(to_name)
936
if not isdir(to_abs):
937
raise BzrError("destination %r is not a directory" % to_abs)
938
if not tree.has_filename(to_name):
939
raise BzrError("destination %r not in working directory" % to_abs)
940
to_dir_id = inv.path2id(to_name)
941
if to_dir_id == None and to_name != '':
942
raise BzrError("destination %r is not a versioned directory" % to_name)
943
to_dir_ie = inv[to_dir_id]
944
if to_dir_ie.kind not in ('directory', 'root_directory'):
945
raise BzrError("destination %r is not a directory" % to_abs)
947
to_idpath = inv.get_idpath(to_dir_id)
950
if not tree.has_filename(f):
951
raise BzrError("%r does not exist in working tree" % f)
952
f_id = inv.path2id(f)
954
raise BzrError("%r is not versioned" % f)
955
name_tail = splitpath(f)[-1]
956
dest_path = appendpath(to_name, name_tail)
957
if tree.has_filename(dest_path):
958
raise BzrError("destination %r already exists" % dest_path)
959
if f_id in to_idpath:
960
raise BzrError("can't move %r to a subdirectory of itself" % f)
962
# OK, so there's a race here, it's possible that someone will
963
# create a file in this interval and then the rename might be
964
# left half-done. But we should have caught most problems.
967
name_tail = splitpath(f)[-1]
968
dest_path = appendpath(to_name, name_tail)
969
print "%s => %s" % (f, dest_path)
970
inv.rename(inv.path2id(f), to_dir_id, name_tail)
972
os.rename(self.abspath(f), self.abspath(dest_path))
974
raise BzrError("failed to rename %r to %r: %s" % (f, dest_path, e[1]),
975
["rename rolled back"])
977
self._write_inventory(inv)
982
def revert(self, filenames, old_tree=None, backups=True):
983
"""Restore selected files to the versions from a previous tree.
986
If true (default) backups are made of files before
989
from bzrlib.errors import NotVersionedError, BzrError
990
from bzrlib.atomicfile import AtomicFile
991
from bzrlib.osutils import backup_file
677
:todo: Get state for single files.
679
:todo: Perhaps show a slash at the end of directory names.
683
# We have to build everything into a list first so that it can
684
# sorted by name, incorporating all the different sources.
686
# FIXME: Rather than getting things in random order and then sorting,
687
# just step through in order.
689
# Interesting case: the old ID for a file has been removed,
690
# but a new file has been created under that name.
692
old = branch.basis_tree()
693
old_inv = old.inventory
694
new = branch.working_tree()
695
new_inv = new.inventory
697
for fs, fid, oldname, newname, kind in diff_trees(old, new):
699
show_status(fs, kind,
700
oldname + ' => ' + newname)
701
elif fs == 'A' or fs == 'M':
702
show_status(fs, kind, newname)
704
show_status(fs, kind, oldname)
707
show_status(fs, kind, newname)
710
show_status(fs, kind, newname)
712
show_status(fs, kind, newname)
714
bailout("wierd file state %r" % ((fs, fid),))
993
inv = self.read_working_inventory()
995
old_tree = self.basis_tree()
996
old_inv = old_tree.inventory
1000
file_id = inv.path2id(fn)
1002
raise NotVersionedError("not a versioned file", fn)
1003
if not old_inv.has_id(file_id):
1004
raise BzrError("file not present in old tree", fn, file_id)
1005
nids.append((fn, file_id))
1007
# TODO: Rename back if it was previously at a different location
1009
# TODO: If given a directory, restore the entire contents from
1010
# the previous version.
1012
# TODO: Make a backup to a temporary file.
1014
# TODO: If the file previously didn't exist, delete it?
1015
for fn, file_id in nids:
1018
f = AtomicFile(fn, 'wb')
1020
f.write(old_tree.get_file(file_id).read())
718
1027
class ScratchBranch(Branch):
722
1031
>>> isdir(b.base)
729
def __init__(self, files = []):
1038
def __init__(self, files=[], dirs=[], base=None):
730
1039
"""Make a test branch.
732
1041
This creates a temporary directory and runs init-tree in it.
734
1043
If any files are listed, they are created in the working copy.
736
Branch.__init__(self, tempfile.mkdtemp(), init=True)
1045
from tempfile import mkdtemp
1050
Branch.__init__(self, base, init=init)
1052
os.mkdir(self.abspath(d))
738
1055
file(os.path.join(self.base, f), 'w').write('content of %s' % f)
1060
>>> orig = ScratchBranch(files=["file1", "file2"])
1061
>>> clone = orig.clone()
1062
>>> os.path.samefile(orig.base, clone.base)
1064
>>> os.path.isfile(os.path.join(clone.base, "file1"))
1067
from shutil import copytree
1068
from tempfile import mkdtemp
1071
copytree(self.base, base, symlinks=True)
1072
return ScratchBranch(base=base)
741
1074
def __del__(self):
742
1078
"""Destroy the test branch, removing the scratch directory."""
743
shutil.rmtree(self.base)
1079
from shutil import rmtree
1082
mutter("delete ScratchBranch %s" % self.base)
1085
# Work around for shutil.rmtree failing on Windows when
1086
# readonly files are encountered
1087
mutter("hit exception in destroying ScratchBranch: %s" % e)
1088
for root, dirs, files in os.walk(self.base, topdown=False):
1090
os.chmod(os.path.join(root, name), 0700)