23
25
from inventory import Inventory
24
26
from trace import mutter, note
25
from tree import Tree, EmptyTree, RevisionTree
27
from tree import Tree, EmptyTree, RevisionTree, WorkingTree
26
28
from inventory import InventoryEntry, Inventory
27
29
from osutils import isdir, quotefn, isfile, uuid, sha_file, username, \
28
30
format_date, compact_date, pumpfile, user_email, rand_bytes, splitpath, \
29
31
joinpath, sha_string, file_kind, local_time_offset, appendpath
30
32
from store import ImmutableStore
31
33
from revision import Revision
32
from errors import BzrError
34
from errors import bailout, BzrError
33
35
from textui import show_status
36
from diff import diff_trees
35
38
BZR_BRANCH_FORMAT = "Bazaar-NG branch, format 0.0.4\n"
36
39
## TODO: Maybe include checks for common corruption of newlines, etc?
40
def find_branch(f, **args):
41
if f and (f.startswith('http://') or f.startswith('https://')):
43
return remotebranch.RemoteBranch(f, **args)
45
return Branch(f, **args)
49
def with_writelock(method):
50
"""Method decorator for functions run with the branch locked."""
52
# called with self set to the branch
55
return method(self, *a, **k)
61
def with_readlock(method):
65
return method(self, *a, **k)
71
43
def find_branch_root(f=None):
72
44
"""Find the branch root enclosing f, or pwd.
74
f may be a filename or a URL.
76
46
It is not necessary that f exists.
78
48
Basically we keep looking up until we find the control directory or
165
119
__repr__ = __str__
170
from warnings import warn
171
warn("branch %r was not explicitly unlocked" % self)
175
def lock(self, mode):
177
if mode == 'w' and cur_lm == 'r':
178
raise BzrError("can't upgrade to a write lock")
123
def lock(self, mode='w'):
124
"""Lock the on-disk branch, excluding other processes."""
130
om = os.O_WRONLY | os.O_CREAT
135
raise BzrError("invalid locking mode %r" % mode)
138
lockfile = os.open(self.controlfilename('branch-lock'), om)
140
if e.errno == errno.ENOENT:
141
# might not exist on branches from <0.0.4
142
self.controlfile('branch-lock', 'w').close()
143
lockfile = os.open(self.controlfilename('branch-lock'), om)
180
assert self._lock_count >= 1
181
self._lock_count += 1
183
from bzrlib.lock import lock, LOCK_SH, LOCK_EX
189
raise ValueError('invalid lock mode %r' % mode)
191
lock(self._lockfile, m)
192
self._lock_mode = mode
197
if not self._lock_mode:
198
raise BzrError('branch %r is not locked' % (self))
200
if self._lock_count > 1:
201
self._lock_count -= 1
203
assert self._lock_count == 1
204
from bzrlib.lock import unlock
205
unlock(self._lockfile)
206
self._lock_mode = self._lock_count = None
147
fcntl.lockf(lockfile, lm)
149
fcntl.lockf(lockfile, fcntl.LOCK_UN)
151
self._lockmode = None
153
self._lockmode = mode
155
warning("please write a locking method for platform %r" % sys.platform)
157
self._lockmode = None
159
self._lockmode = mode
162
def _need_readlock(self):
163
if self._lockmode not in ['r', 'w']:
164
raise BzrError('need read lock on branch, only have %r' % self._lockmode)
166
def _need_writelock(self):
167
if self._lockmode not in ['w']:
168
raise BzrError('need write lock on branch, only have %r' % self._lockmode)
209
171
def abspath(self, name):
350
307
TODO: Adding a directory should optionally recurse down and
351
308
add all non-ignored children. Perhaps do that in a
352
309
higher-level method.
311
>>> b = ScratchBranch(files=['foo'])
312
>>> 'foo' in b.unknowns()
317
>>> 'foo' in b.unknowns()
319
>>> bool(b.inventory.path2id('foo'))
325
Traceback (most recent call last):
327
BzrError: ('foo is already versioned', [])
329
>>> b.add(['nothere'])
330
Traceback (most recent call last):
331
BzrError: ('cannot add: not a regular file or directory: nothere', [])
333
self._need_writelock()
354
335
# TODO: Re-adding a file that is removed in the working copy
355
336
# should probably put it back with the previous ID.
356
337
if isinstance(files, types.StringTypes):
357
assert(ids is None or isinstance(ids, types.StringTypes))
363
ids = [None] * len(files)
365
assert(len(ids) == len(files))
367
340
inv = self.read_working_inventory()
368
for f,file_id in zip(files, ids):
369
342
if is_control_file(f):
370
raise BzrError("cannot add control file %s" % quotefn(f))
343
bailout("cannot add control file %s" % quotefn(f))
372
345
fp = splitpath(f)
375
raise BzrError("cannot add top-level %r" % f)
348
bailout("cannot add top-level %r" % f)
377
350
fullpath = os.path.normpath(self.abspath(f))
380
353
kind = file_kind(fullpath)
382
355
# maybe something better?
383
raise BzrError('cannot add: not a regular file or directory: %s' % quotefn(f))
356
bailout('cannot add: not a regular file or directory: %s' % quotefn(f))
385
358
if kind != 'file' and kind != 'directory':
386
raise BzrError('cannot add: not a regular file or directory: %s' % quotefn(f))
359
bailout('cannot add: not a regular file or directory: %s' % quotefn(f))
389
file_id = gen_file_id(f)
361
file_id = gen_file_id(f)
390
362
inv.add_path(f, kind=kind, file_id=file_id)
393
365
show_status('A', kind, quotefn(f))
395
367
mutter("add file %s file_id:{%s} kind=%r" % (f, file_id, kind))
397
369
self._write_inventory(inv)
400
372
def print_file(self, file, revno):
401
373
"""Print `file` to stdout."""
374
self._need_readlock()
402
375
tree = self.revision_tree(self.lookup_revision(revno))
403
376
# use inventory as it was in that revision
404
377
file_id = tree.inventory.path2id(file)
406
raise BzrError("%r is not present in revision %d" % (file, revno))
379
bailout("%r is not present in revision %d" % (file, revno))
407
380
tree.print_file(file_id)
411
383
def remove(self, files, verbose=False):
412
384
"""Mark nominated files for removal from the inventory.
477
463
return self.working_tree().unknowns()
466
def commit(self, message, timestamp=None, timezone=None,
469
"""Commit working copy as a new revision.
471
The basic approach is to add all the file texts into the
472
store, then the inventory, then make a new revision pointing
473
to that inventory and store that.
475
This is not quite safe if the working copy changes during the
476
commit; for the moment that is simply not allowed. A better
477
approach is to make a temporary copy of the files before
478
computing their hashes, and then add those hashes in turn to
479
the inventory. This should mean at least that there are no
480
broken hash pointers. There is no way we can get a snapshot
481
of the whole directory at an instant. This would also have to
482
be robust against files disappearing, moving, etc. So the
483
whole thing is a bit hard.
485
timestamp -- if not None, seconds-since-epoch for a
486
postdated/predated commit.
488
self._need_writelock()
490
## TODO: Show branch names
492
# TODO: Don't commit if there are no changes, unless forced?
494
# First walk over the working inventory; and both update that
495
# and also build a new revision inventory. The revision
496
# inventory needs to hold the text-id, sha1 and size of the
497
# actual file versions committed in the revision. (These are
498
# not present in the working inventory.) We also need to
499
# detect missing/deleted files, and remove them from the
502
work_inv = self.read_working_inventory()
504
basis = self.basis_tree()
505
basis_inv = basis.inventory
507
for path, entry in work_inv.iter_entries():
508
## TODO: Cope with files that have gone missing.
510
## TODO: Check that the file kind has not changed from the previous
511
## revision of this file (if any).
515
p = self.abspath(path)
516
file_id = entry.file_id
517
mutter('commit prep file %s, id %r ' % (p, file_id))
519
if not os.path.exists(p):
520
mutter(" file is missing, removing from inventory")
522
show_status('D', entry.kind, quotefn(path))
523
missing_ids.append(file_id)
526
# TODO: Handle files that have been deleted
528
# TODO: Maybe a special case for empty files? Seems a
529
# waste to store them many times.
533
if basis_inv.has_id(file_id):
534
old_kind = basis_inv[file_id].kind
535
if old_kind != entry.kind:
536
bailout("entry %r changed kind from %r to %r"
537
% (file_id, old_kind, entry.kind))
539
if entry.kind == 'directory':
541
bailout("%s is entered as directory but not a directory" % quotefn(p))
542
elif entry.kind == 'file':
544
bailout("%s is entered as file but is not a file" % quotefn(p))
546
content = file(p, 'rb').read()
548
entry.text_sha1 = sha_string(content)
549
entry.text_size = len(content)
551
old_ie = basis_inv.has_id(file_id) and basis_inv[file_id]
553
and (old_ie.text_size == entry.text_size)
554
and (old_ie.text_sha1 == entry.text_sha1)):
555
## assert content == basis.get_file(file_id).read()
556
entry.text_id = basis_inv[file_id].text_id
557
mutter(' unchanged from previous text_id {%s}' %
561
entry.text_id = gen_file_id(entry.name)
562
self.text_store.add(content, entry.text_id)
563
mutter(' stored with text_id {%s}' % entry.text_id)
567
elif (old_ie.name == entry.name
568
and old_ie.parent_id == entry.parent_id):
573
show_status(state, entry.kind, quotefn(path))
575
for file_id in missing_ids:
576
# have to do this later so we don't mess up the iterator.
577
# since parents may be removed before their children we
580
# FIXME: There's probably a better way to do this; perhaps
581
# the workingtree should know how to filter itself.
582
if work_inv.has_id(file_id):
583
del work_inv[file_id]
586
inv_id = rev_id = _gen_revision_id(time.time())
588
inv_tmp = tempfile.TemporaryFile()
589
inv.write_xml(inv_tmp)
591
self.inventory_store.add(inv_tmp, inv_id)
592
mutter('new inventory_id is {%s}' % inv_id)
594
self._write_inventory(work_inv)
596
if timestamp == None:
597
timestamp = time.time()
599
if committer == None:
600
committer = username()
603
timezone = local_time_offset()
605
mutter("building commit log message")
606
rev = Revision(timestamp=timestamp,
609
precursor = self.last_patch(),
614
rev_tmp = tempfile.TemporaryFile()
615
rev.write_xml(rev_tmp)
617
self.revision_store.add(rev_tmp, rev_id)
618
mutter("new revision_id is {%s}" % rev_id)
620
## XXX: Everything up to here can simply be orphaned if we abort
621
## the commit; it will leave junk files behind but that doesn't
624
## TODO: Read back the just-generated changeset, and make sure it
625
## applies and recreates the right state.
627
## TODO: Also calculate and store the inventory SHA1
628
mutter("committing patch r%d" % (self.revno() + 1))
631
self.append_revision(rev_id)
634
note("commited r%d" % self.revno())
480
637
def append_revision(self, revision_id):
481
638
mutter("add {%s} to revision-history" % revision_id)
482
639
rev_history = self.revision_history()
627
798
def rename_one(self, from_rel, to_rel):
628
799
"""Rename one file.
630
801
This can change the directory or the filename or both.
803
self._need_writelock()
632
804
tree = self.working_tree()
633
805
inv = tree.inventory
634
806
if not tree.has_filename(from_rel):
635
raise BzrError("can't rename: old working file %r does not exist" % from_rel)
807
bailout("can't rename: old working file %r does not exist" % from_rel)
636
808
if tree.has_filename(to_rel):
637
raise BzrError("can't rename: new working file %r already exists" % to_rel)
809
bailout("can't rename: new working file %r already exists" % to_rel)
639
811
file_id = inv.path2id(from_rel)
640
812
if file_id == None:
641
raise BzrError("can't rename: old name %r is not versioned" % from_rel)
813
bailout("can't rename: old name %r is not versioned" % from_rel)
643
815
if inv.path2id(to_rel):
644
raise BzrError("can't rename: new name %r is already versioned" % to_rel)
816
bailout("can't rename: new name %r is already versioned" % to_rel)
646
818
to_dir, to_tail = os.path.split(to_rel)
647
819
to_dir_id = inv.path2id(to_dir)
648
820
if to_dir_id == None and to_dir != '':
649
raise BzrError("can't determine destination directory id for %r" % to_dir)
821
bailout("can't determine destination directory id for %r" % to_dir)
651
823
mutter("rename_one:")
652
824
mutter(" file_id {%s}" % file_id)
684
855
Note that to_name is only the last component of the new name;
685
856
this doesn't change the directory.
858
self._need_writelock()
687
859
## TODO: Option to move IDs only
688
860
assert not isinstance(from_paths, basestring)
689
861
tree = self.working_tree()
690
862
inv = tree.inventory
691
863
to_abs = self.abspath(to_name)
692
864
if not isdir(to_abs):
693
raise BzrError("destination %r is not a directory" % to_abs)
865
bailout("destination %r is not a directory" % to_abs)
694
866
if not tree.has_filename(to_name):
695
raise BzrError("destination %r not in working directory" % to_abs)
867
bailout("destination %r not in working directory" % to_abs)
696
868
to_dir_id = inv.path2id(to_name)
697
869
if to_dir_id == None and to_name != '':
698
raise BzrError("destination %r is not a versioned directory" % to_name)
870
bailout("destination %r is not a versioned directory" % to_name)
699
871
to_dir_ie = inv[to_dir_id]
700
872
if to_dir_ie.kind not in ('directory', 'root_directory'):
701
raise BzrError("destination %r is not a directory" % to_abs)
873
bailout("destination %r is not a directory" % to_abs)
703
to_idpath = inv.get_idpath(to_dir_id)
875
to_idpath = Set(inv.get_idpath(to_dir_id))
705
877
for f in from_paths:
706
878
if not tree.has_filename(f):
707
raise BzrError("%r does not exist in working tree" % f)
879
bailout("%r does not exist in working tree" % f)
708
880
f_id = inv.path2id(f)
710
raise BzrError("%r is not versioned" % f)
882
bailout("%r is not versioned" % f)
711
883
name_tail = splitpath(f)[-1]
712
884
dest_path = appendpath(to_name, name_tail)
713
885
if tree.has_filename(dest_path):
714
raise BzrError("destination %r already exists" % dest_path)
886
bailout("destination %r already exists" % dest_path)
715
887
if f_id in to_idpath:
716
raise BzrError("can't move %r to a subdirectory of itself" % f)
888
bailout("can't move %r to a subdirectory of itself" % f)
718
890
# OK, so there's a race here, it's possible that someone will
719
891
# create a file in this interval and then the rename might be
728
900
os.rename(self.abspath(f), self.abspath(dest_path))
729
901
except OSError, e:
730
raise BzrError("failed to rename %r to %r: %s" % (f, dest_path, e[1]),
902
bailout("failed to rename %r to %r: %s" % (f, dest_path, e[1]),
731
903
["rename rolled back"])
733
905
self._write_inventory(inv)
909
def show_status(self, show_all=False):
910
"""Display single-line status for non-ignored working files.
912
The list is show sorted in order by file name.
914
>>> b = ScratchBranch(files=['foo', 'foo~'])
920
>>> b.commit("add foo")
922
>>> os.unlink(b.abspath('foo'))
926
TODO: Get state for single files.
928
self._need_readlock()
930
# We have to build everything into a list first so that it can
931
# sorted by name, incorporating all the different sources.
933
# FIXME: Rather than getting things in random order and then sorting,
934
# just step through in order.
936
# Interesting case: the old ID for a file has been removed,
937
# but a new file has been created under that name.
939
old = self.basis_tree()
940
new = self.working_tree()
942
for fs, fid, oldname, newname, kind in diff_trees(old, new):
944
show_status(fs, kind,
945
oldname + ' => ' + newname)
946
elif fs == 'A' or fs == 'M':
947
show_status(fs, kind, newname)
949
show_status(fs, kind, oldname)
952
show_status(fs, kind, newname)
955
show_status(fs, kind, newname)
957
show_status(fs, kind, newname)
959
bailout("weird file state %r" % ((fs, fid),))
738
963
class ScratchBranch(Branch):
739
964
"""Special test class: a branch that cleans up after itself.