15
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
21
from warnings import warn
22
from cStringIO import StringIO
18
import sys, os, os.path, random, time, sha, sets, types, re, shutil, tempfile
19
import traceback, socket, fnmatch, difflib, time
20
from binascii import hexlify
26
from bzrlib.inventory import InventoryEntry
27
import bzrlib.inventory as inventory
28
from bzrlib.trace import mutter, note
29
from bzrlib.osutils import (isdir, quotefn, compact_date, rand_bytes,
30
rename, splitpath, sha_file, appendpath,
32
from bzrlib.errors import (BzrError, InvalidRevisionNumber, InvalidRevisionId,
33
NoSuchRevision, HistoryMissing, NotBranchError,
34
DivergedBranches, LockError, UnlistableStore,
35
UnlistableBranch, NoSuchFile)
36
from bzrlib.textui import show_status
37
from bzrlib.revision import Revision
38
from bzrlib.delta import compare_trees
39
from bzrlib.tree import EmptyTree, RevisionTree
40
from bzrlib.inventory import Inventory
41
from bzrlib.store import copy_all
42
from bzrlib.store.compressed_text import CompressedTextStore
43
from bzrlib.store.text import TextStore
44
from bzrlib.store.weave import WeaveStore
45
from bzrlib.transport import Transport, get_transport
50
BZR_BRANCH_FORMAT_4 = "Bazaar-NG branch, format 0.0.4\n"
51
BZR_BRANCH_FORMAT_5 = "Bazaar-NG branch, format 5\n"
23
from inventory import Inventory
24
from trace import mutter, note
25
from tree import Tree, EmptyTree, RevisionTree
26
from inventory import InventoryEntry, Inventory
27
from osutils import isdir, quotefn, isfile, uuid, sha_file, username, \
28
format_date, compact_date, pumpfile, user_email, rand_bytes, splitpath, \
29
joinpath, sha_file, sha_string, file_kind, local_time_offset, appendpath
30
from store import ImmutableStore
31
from revision import Revision
32
from errors import BzrError
33
from textui import show_status
35
BZR_BRANCH_FORMAT = "Bazaar-NG branch, format 0.0.4\n"
52
36
## TODO: Maybe include checks for common corruption of newlines, etc?
55
# TODO: Some operations like log might retrieve the same revisions
56
# repeatedly to calculate deltas. We could perhaps have a weakref
57
# cache in memory to make this faster. In general anything can be
58
# cached in memory between lock and unlock operations.
60
def find_branch(*ignored, **ignored_too):
61
# XXX: leave this here for about one release, then remove it
62
raise NotImplementedError('find_branch() is not supported anymore, '
63
'please use one of the new branch constructors')
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)
64
49
def _relpath(base, path):
65
50
"""Return path relative to base, or raise exception.
71
from errors import NotBranchError
86
72
raise NotBranchError("path %r is not within branch %r" % (rp, base))
88
74
return os.sep.join(s)
91
def find_branch_root(t):
92
"""Find the branch root enclosing the transport's base.
94
t is a Transport object.
96
It is not necessary that the base of t exists.
77
def find_branch_root(f=None):
78
"""Find the branch root enclosing f, or pwd.
80
f may be a filename or a URL.
82
It is not necessary that f exists.
98
84
Basically we keep looking up until we find the control directory or
99
run into the root. If there isn't one, raises NotBranchError.
88
elif hasattr(os.path, 'realpath'):
89
f = os.path.realpath(f)
91
f = os.path.abspath(f)
92
if not os.path.exists(f):
93
raise BzrError('%r does not exist' % f)
103
if t.has(bzrlib.BZRDIR):
105
new_t = t.clone('..')
106
if new_t.base == t.base:
99
if os.path.exists(os.path.join(f, bzrlib.BZRDIR)):
101
head, tail = os.path.split(f)
107
103
# reached the root, whatever that may be
108
raise NotBranchError('%s is not in a branch' % orig_base)
104
raise BzrError('%r is not in a branch' % orig_f)
107
class DivergedBranches(Exception):
108
def __init__(self, branch1, branch2):
109
self.branch1 = branch1
110
self.branch2 = branch2
111
Exception.__init__(self, "These branches have diverged.")
114
class NoSuchRevision(BzrError):
115
def __init__(self, branch, revision):
117
self.revision = revision
118
msg = "Branch %s has no revision %d" % (branch, revision)
119
BzrError.__init__(self, msg)
112
122
######################################################################
116
126
"""Branch holding a history of revisions.
119
Base directory/url of the branch.
123
def __init__(self, *ignored, **ignored_too):
124
raise NotImplementedError('The Branch class is abstract')
127
def open_downlevel(base):
128
"""Open a branch which may be of an old format.
130
Only local branches are supported."""
131
return _Branch(get_transport(base), relax_version_check=True)
135
"""Open an existing branch, rooted at 'base' (url)"""
136
t = get_transport(base)
137
mutter("trying to open %r with transport %r", base, t)
141
def open_containing(url):
142
"""Open an existing branch which contains url.
144
This probes for a branch at url, and searches upwards from there.
146
t = get_transport(url)
147
t = find_branch_root(t)
151
def initialize(base):
152
"""Create a new branch, rooted at 'base' (url)"""
153
t = get_transport(base)
154
return _Branch(t, init=True)
156
def setup_caching(self, cache_root):
157
"""Subclasses that care about caching should override this, and set
158
up cached stores located under cache_root.
160
self.cache_root = cache_root
163
class _Branch(Branch):
164
"""A branch stored in the actual filesystem.
166
Note that it's "local" in the context of the filesystem; it doesn't
167
really matter if it's on an nfs/smb/afs/coda/... share, as long as
168
it's writable, and can be accessed via the normal filesystem API.
129
Base directory of the branch.
171
132
None, or 'r' or 'w'
178
139
Lock object from bzrlib.lock.
180
# We actually expect this class to be somewhat short-lived; part of its
181
# purpose is to try to isolate what bits of the branch logic are tied to
182
# filesystem access, so that in a later step, we can extricate them to
183
# a separarte ("storage") class.
184
142
_lock_mode = None
185
143
_lock_count = None
187
_inventory_weave = None
189
# Map some sort of prefix into a namespace
190
# stuff like "revno:10", "revid:", etc.
191
# This should match a prefix with a function which accepts
192
REVISION_NAMESPACES = {}
194
def push_stores(self, branch_to):
195
"""Copy the content of this branches store to branch_to."""
196
if (self._branch_format != branch_to._branch_format
197
or self._branch_format != 4):
198
from bzrlib.fetch import greedy_fetch
199
mutter("falling back to fetch logic to push between %s(%s) and %s(%s)",
200
self, self._branch_format, branch_to, branch_to._branch_format)
201
greedy_fetch(to_branch=branch_to, from_branch=self,
202
revision=self.last_revision())
205
store_pairs = ((self.text_store, branch_to.text_store),
206
(self.inventory_store, branch_to.inventory_store),
207
(self.revision_store, branch_to.revision_store))
209
for from_store, to_store in store_pairs:
210
copy_all(from_store, to_store)
211
except UnlistableStore:
212
raise UnlistableBranch(from_store)
214
def __init__(self, transport, init=False,
215
relax_version_check=False):
146
def __init__(self, base, init=False, find_root=True):
216
147
"""Create new branch object at a particular location.
218
transport -- A Transport object, defining how to access files.
219
(If a string, transport.transport() will be used to
220
create a Transport object)
149
base -- Base directory for the branch.
222
151
init -- If True, create new control files in a previously
223
152
unversioned directory. If False, the branch must already
226
relax_version_check -- If true, the usual check for the branch
227
version is not applied. This is intended only for
228
upgrade/recovery type use; it's not guaranteed that
229
all operations will work on old format branches.
155
find_root -- If true and init is false, find the root of the
156
existing branch containing base.
231
158
In the test suite, creation of new trees is tested using the
232
159
`ScratchBranch` class.
234
assert isinstance(transport, Transport), \
235
"%r is not a Transport" % transport
236
self._transport = transport
162
self.base = os.path.realpath(base)
238
163
self._make_control()
239
self._check_format(relax_version_check)
241
def get_store(name, compressed=True):
242
# FIXME: This approach of assuming stores are all entirely compressed
243
# or entirely uncompressed is tidy, but breaks upgrade from
244
# some existing branches where there's a mixture; we probably
245
# still want the option to look for both.
246
relpath = self._rel_controlfilename(name)
248
store = CompressedTextStore(self._transport.clone(relpath))
250
store = TextStore(self._transport.clone(relpath))
251
#if self._transport.should_cache():
252
# cache_path = os.path.join(self.cache_root, name)
253
# os.mkdir(cache_path)
254
# store = bzrlib.store.CachedStore(store, cache_path)
257
relpath = self._rel_controlfilename(name)
258
ws = WeaveStore(self._transport.clone(relpath))
259
if self._transport.should_cache():
260
ws.enable_cache = True
263
if self._branch_format == 4:
264
self.inventory_store = get_store('inventory-store')
265
self.text_store = get_store('text-store')
266
self.revision_store = get_store('revision-store')
267
elif self._branch_format == 5:
268
self.control_weaves = get_weave([])
269
self.weave_store = get_weave('weaves')
270
self.revision_store = get_store('revision-store', compressed=False)
165
self.base = find_branch_root(base)
167
self.base = os.path.realpath(base)
168
if not isdir(self.controlfilename('.')):
169
from errors import NotBranchError
170
raise NotBranchError("not a bzr branch: %s" % quotefn(base),
171
['use "bzr init" to initialize a new working tree',
172
'current bzr can only operate from top-of-tree'])
175
self.text_store = ImmutableStore(self.controlfilename('text-store'))
176
self.revision_store = ImmutableStore(self.controlfilename('revision-store'))
177
self.inventory_store = ImmutableStore(self.controlfilename('inventory-store'))
272
180
def __str__(self):
273
return '%s(%r)' % (self.__class__.__name__, self._transport.base)
181
return '%s(%r)' % (self.__class__.__name__, self.base)
276
184
__repr__ = __str__
279
187
def __del__(self):
280
188
if self._lock_mode or self._lock:
281
# XXX: This should show something every time, and be suitable for
282
# headless operation and embedding
189
from warnings import warn
283
190
warn("branch %r was not explicitly unlocked" % self)
284
191
self._lock.unlock()
286
# TODO: It might be best to do this somewhere else,
287
# but it is nice for a Branch object to automatically
288
# cache it's information.
289
# Alternatively, we could have the Transport objects cache requests
290
# See the earlier discussion about how major objects (like Branch)
291
# should never expect their __del__ function to run.
292
if hasattr(self, 'cache_root') and self.cache_root is not None:
295
shutil.rmtree(self.cache_root)
298
self.cache_root = None
302
return self._transport.base
305
base = property(_get_base)
308
195
def lock_write(self):
309
# TODO: Upgrade locking to support using a Transport,
310
# and potentially a remote locking protocol
311
196
if self._lock_mode:
312
197
if self._lock_mode != 'w':
198
from errors import LockError
313
199
raise LockError("can't upgrade to a write lock from %r" %
315
201
self._lock_count += 1
317
self._lock = self._transport.lock_write(
318
self._rel_controlfilename('branch-lock'))
203
from bzrlib.lock import WriteLock
205
self._lock = WriteLock(self.controlfilename('branch-lock'))
319
206
self._lock_mode = 'w'
320
207
self._lock_count = 1
323
211
def lock_read(self):
324
212
if self._lock_mode:
325
213
assert self._lock_mode in ('r', 'w'), \
326
214
"invalid lock mode %r" % self._lock_mode
327
215
self._lock_count += 1
329
self._lock = self._transport.lock_read(
330
self._rel_controlfilename('branch-lock'))
217
from bzrlib.lock import ReadLock
219
self._lock = ReadLock(self.controlfilename('branch-lock'))
331
220
self._lock_mode = 'r'
332
221
self._lock_count = 1
334
225
def unlock(self):
335
226
if not self._lock_mode:
227
from errors import LockError
336
228
raise LockError('branch %r is not locked' % (self))
338
230
if self._lock_count > 1:
374
265
Controlfiles should almost never be opened in write mode but
375
266
rather should be atomically copied and replaced using atomicfile.
379
relpath = self._rel_controlfilename(file_or_path)
380
#TODO: codecs.open() buffers linewise, so it was overloaded with
381
# a much larger buffer, do we need to do the same for getreader/getwriter?
383
return self._transport.get(relpath)
385
raise BzrError("Branch.controlfile(mode='wb') is not supported, use put_controlfiles")
387
return codecs.getreader('utf-8')(self._transport.get(relpath), errors='replace')
389
raise BzrError("Branch.controlfile(mode='w') is not supported, use put_controlfiles")
269
fn = self.controlfilename(file_or_path)
271
if mode == 'rb' or mode == 'wb':
272
return file(fn, mode)
273
elif mode == 'r' or mode == 'w':
274
# open in binary mode anyhow so there's no newline translation;
275
# codecs uses line buffering by default; don't want that.
277
return codecs.open(fn, mode + 'b', 'utf-8',
391
280
raise BzrError("invalid controlfile mode %r" % mode)
393
def put_controlfile(self, path, f, encode=True):
394
"""Write an entry as a controlfile.
396
:param path: The path to put the file, relative to the .bzr control
398
:param f: A file-like or string object whose contents should be copied.
399
:param encode: If true, encode the contents as utf-8
401
self.put_controlfiles([(path, f)], encode=encode)
403
def put_controlfiles(self, files, encode=True):
404
"""Write several entries as controlfiles.
406
:param files: A list of [(path, file)] pairs, where the path is the directory
407
underneath the bzr control directory
408
:param encode: If true, encode the contents as utf-8
412
for path, f in files:
414
if isinstance(f, basestring):
415
f = f.encode('utf-8', 'replace')
417
f = codecs.getwriter('utf-8')(f, errors='replace')
418
path = self._rel_controlfilename(path)
419
ctrl_files.append((path, f))
420
self._transport.put_multi(ctrl_files)
422
284
def _make_control(self):
423
from bzrlib.inventory import Inventory
424
from bzrlib.weavefile import write_weave_v5
425
from bzrlib.weave import Weave
427
# Create an empty inventory
429
# if we want per-tree root ids then this is the place to set
430
# them; they're not needed for now and so ommitted for
432
bzrlib.xml5.serializer_v5.write_inventory(Inventory(), sio)
433
empty_inv = sio.getvalue()
435
bzrlib.weavefile.write_weave_v5(Weave(), sio)
436
empty_weave = sio.getvalue()
438
dirs = [[], 'revision-store', 'weaves']
285
os.mkdir(self.controlfilename([]))
286
self.controlfile('README', 'w').write(
440
287
"This is a Bazaar-NG control directory.\n"
441
"Do not change any files in this directory.\n"),
442
('branch-format', BZR_BRANCH_FORMAT_5),
443
('revision-history', ''),
446
('pending-merges', ''),
447
('inventory', empty_inv),
448
('inventory.weave', empty_weave),
449
('ancestry.weave', empty_weave)
451
cfn = self._rel_controlfilename
452
self._transport.mkdir_multi([cfn(d) for d in dirs])
453
self.put_controlfiles(files)
454
mutter('created control directory in ' + self._transport.base)
456
def _check_format(self, relax_version_check):
288
"Do not change any files in this directory.\n")
289
self.controlfile('branch-format', 'w').write(BZR_BRANCH_FORMAT)
290
for d in ('text-store', 'inventory-store', 'revision-store'):
291
os.mkdir(self.controlfilename(d))
292
for f in ('revision-history', 'merged-patches',
293
'pending-merged-patches', 'branch-name',
295
self.controlfile(f, 'w').write('')
296
mutter('created control directory in ' + self.base)
297
Inventory().write_xml(self.controlfile('inventory','w'))
300
def _check_format(self):
457
301
"""Check this branch format is supported.
459
The format level is stored, as an integer, in
460
self._branch_format for code that needs to check it later.
303
The current tool only supports the current unstable format.
462
305
In the future, we might need different in-memory Branch
463
306
classes to support downlevel branches. But not yet.
466
fmt = self.controlfile('branch-format', 'r').read()
468
raise NotBranchError(self.base)
469
mutter("got branch format %r", fmt)
470
if fmt == BZR_BRANCH_FORMAT_5:
471
self._branch_format = 5
472
elif fmt == BZR_BRANCH_FORMAT_4:
473
self._branch_format = 4
475
if (not relax_version_check
476
and self._branch_format != 5):
308
# This ignores newlines so that we can open branches created
309
# on Windows from Linux and so on. I think it might be better
310
# to always make all internal files in unix format.
311
fmt = self.controlfile('branch-format', 'r').read()
312
fmt.replace('\r\n', '')
313
if fmt != BZR_BRANCH_FORMAT:
477
314
raise BzrError('sorry, branch format %r not supported' % fmt,
478
315
['use a different bzr version',
479
'or remove the .bzr directory'
480
' and "bzr init" again'])
482
def get_root_id(self):
483
"""Return the id of this branches root"""
484
inv = self.read_working_inventory()
485
return inv.root.file_id
487
def set_root_id(self, file_id):
488
inv = self.read_working_inventory()
489
orig_root_id = inv.root.file_id
490
del inv._byid[inv.root.file_id]
491
inv.root.file_id = file_id
492
inv._byid[inv.root.file_id] = inv.root
495
if entry.parent_id in (None, orig_root_id):
496
entry.parent_id = inv.root.file_id
497
self._write_inventory(inv)
316
'or remove the .bzr directory and "bzr init" again'])
499
320
def read_working_inventory(self):
500
321
"""Read the working inventory."""
323
# ElementTree does its own conversion from UTF-8, so open in
503
# ElementTree does its own conversion from UTF-8, so open in
505
f = self.controlfile('inventory', 'rb')
506
return bzrlib.xml5.serializer_v5.read_inventory(f)
327
inv = Inventory.read_xml(self.controlfile('inventory', 'rb'))
328
mutter("loaded inventory of %d items in %f"
329
% (len(inv), time.time() - before))
514
338
That is to say, the inventory describing changes underway, that
515
339
will be committed to the next revision.
517
from cStringIO import StringIO
521
bzrlib.xml5.serializer_v5.write_inventory(inv, sio)
523
# Transport handles atomicity
524
self.put_controlfile('inventory', sio)
341
## TODO: factor out to atomicfile? is rename safe on windows?
342
## TODO: Maybe some kind of clean/dirty marker on inventory?
343
tmpfname = self.controlfilename('inventory.tmp')
344
tmpf = file(tmpfname, 'wb')
347
inv_fname = self.controlfilename('inventory')
348
if sys.platform == 'win32':
350
os.rename(tmpfname, inv_fname)
528
351
mutter('wrote working inventory')
530
354
inventory = property(read_working_inventory, _write_inventory, None,
531
355
"""Inventory for the working copy.""")
533
def add(self, files, ids=None):
358
def add(self, files, verbose=False, ids=None):
534
359
"""Make files versioned.
536
Note that the command line normally calls smart_add instead,
537
which can automatically recurse.
361
Note that the command line normally calls smart_add instead.
539
363
This puts the files in the Added state, so that they will be
540
364
recorded by the next commit.
696
520
return self.working_tree().unknowns()
699
def append_revision(self, *revision_ids):
700
for revision_id in revision_ids:
701
mutter("add {%s} to revision-history" % revision_id)
704
rev_history = self.revision_history()
705
rev_history.extend(revision_ids)
706
self.put_controlfile('revision-history', '\n'.join(rev_history))
710
def has_revision(self, revision_id):
711
"""True if this branch has a copy of the revision.
713
This does not necessarily imply the revision is merge
714
or on the mainline."""
715
return (revision_id is None
716
or revision_id in self.revision_store)
718
def get_revision_xml_file(self, revision_id):
719
"""Return XML file object for revision object."""
720
if not revision_id or not isinstance(revision_id, basestring):
721
raise InvalidRevisionId(revision_id)
726
return self.revision_store[revision_id]
727
except (IndexError, KeyError):
728
raise bzrlib.errors.NoSuchRevision(self, revision_id)
733
get_revision_xml = get_revision_xml_file
735
def get_revision_xml(self, revision_id):
736
return self.get_revision_xml_file(revision_id).read()
523
def append_revision(self, revision_id):
524
mutter("add {%s} to revision-history" % revision_id)
525
rev_history = self.revision_history()
527
tmprhname = self.controlfilename('revision-history.tmp')
528
rhname = self.controlfilename('revision-history')
530
f = file(tmprhname, 'wt')
531
rev_history.append(revision_id)
532
f.write('\n'.join(rev_history))
536
if sys.platform == 'win32':
538
os.rename(tmprhname, rhname)
739
542
def get_revision(self, revision_id):
740
543
"""Return the Revision object for a named revision"""
741
xml_file = self.get_revision_xml_file(revision_id)
744
r = bzrlib.xml5.serializer_v5.read_revision(xml_file)
745
except SyntaxError, e:
746
raise bzrlib.errors.BzrError('failed to unpack revision_xml',
544
if not revision_id or not isinstance(revision_id, basestring):
545
raise ValueError('invalid revision-id: %r' % revision_id)
546
r = Revision.read_xml(self.revision_store[revision_id])
750
547
assert r.revision_id == revision_id
753
def get_revision_delta(self, revno):
754
"""Return the delta for one revision.
756
The delta is relative to its mainline predecessor, or the
757
empty tree for revision 1.
759
assert isinstance(revno, int)
760
rh = self.revision_history()
761
if not (1 <= revno <= len(rh)):
762
raise InvalidRevisionNumber(revno)
764
# revno is 1-based; list is 0-based
766
new_tree = self.revision_tree(rh[revno-1])
768
old_tree = EmptyTree()
770
old_tree = self.revision_tree(rh[revno-2])
772
return compare_trees(old_tree, new_tree)
774
550
def get_revision_sha1(self, revision_id):
775
551
"""Hash the stored value of a revision, and return it."""
776
552
# In the future, revision entries will be signed. At that
779
555
# the revision, (add signatures/remove signatures) and still
780
556
# have all hash pointers stay consistent.
781
557
# But for now, just hash the contents.
782
return bzrlib.osutils.sha_file(self.get_revision_xml_file(revision_id))
784
def get_ancestry(self, revision_id):
785
"""Return a list of revision-ids integrated by a revision.
787
This currently returns a list, but the ordering is not guaranteed:
790
if revision_id is None:
792
w = self.control_weaves.get_weave('inventory')
793
return [None] + map(w.idx_to_name,
794
w.inclusions([w.lookup(revision_id)]))
796
def get_inventory_weave(self):
797
return self.control_weaves.get_weave('inventory')
799
def get_inventory(self, revision_id):
800
"""Get Inventory object by hash."""
801
xml = self.get_inventory_xml(revision_id)
802
return bzrlib.xml5.serializer_v5.read_inventory_from_string(xml)
804
def get_inventory_xml(self, revision_id):
805
"""Get inventory XML as a file object."""
807
assert isinstance(revision_id, basestring), type(revision_id)
808
iw = self.get_inventory_weave()
809
return iw.get_text(iw.lookup(revision_id))
811
raise bzrlib.errors.HistoryMissing(self, 'inventory', revision_id)
813
def get_inventory_sha1(self, revision_id):
558
return sha_file(self.revision_store[revision_id])
561
def get_inventory(self, inventory_id):
562
"""Get Inventory object by hash.
564
TODO: Perhaps for this and similar methods, take a revision
565
parameter which can be either an integer revno or a
567
i = Inventory.read_xml(self.inventory_store[inventory_id])
570
def get_inventory_sha1(self, inventory_id):
814
571
"""Return the sha1 hash of the inventory entry
816
return self.get_revision(revision_id).inventory_sha1
573
return sha_file(self.inventory_store[inventory_id])
818
576
def get_revision_inventory(self, revision_id):
819
577
"""Return inventory of a past revision."""
820
# TODO: Unify this with get_inventory()
821
# bzr 0.0.6 and later imposes the constraint that the inventory_id
822
# must be the same as its revision, so this is trivial.
823
578
if revision_id == None:
824
return Inventory(self.get_root_id())
826
return self.get_inventory(revision_id)
581
return self.get_inventory(self.get_revision(revision_id).inventory_id)
828
584
def revision_history(self):
829
"""Return sequence of revision hashes on to this branch."""
585
"""Return sequence of revision hashes on to this branch.
587
>>> ScratchBranch().revision_history()
832
592
return [l.rstrip('\r\n') for l in
941
719
if stop_revision is None:
942
720
stop_revision = other_len
944
assert isinstance(stop_revision, int)
945
if stop_revision > other_len:
946
raise bzrlib.errors.NoSuchRevision(self, stop_revision)
721
elif stop_revision > other_len:
722
raise NoSuchRevision(self, stop_revision)
947
724
return other_history[self_len:stop_revision]
949
727
def update_revisions(self, other, stop_revision=None):
950
"""Pull in new perfect-fit revisions."""
951
from bzrlib.fetch import greedy_fetch
952
from bzrlib.revision import get_intervening_revisions
953
if stop_revision is None:
954
stop_revision = other.last_revision()
955
greedy_fetch(to_branch=self, from_branch=other,
956
revision=stop_revision)
957
pullable_revs = self.missing_revisions(
958
other, other.revision_id_to_revno(stop_revision))
960
greedy_fetch(to_branch=self,
962
revision=pullable_revs[-1])
963
self.append_revision(*pullable_revs)
728
"""Pull in all new revisions from other branch.
730
>>> from bzrlib.commit import commit
731
>>> bzrlib.trace.silent = True
732
>>> br1 = ScratchBranch(files=['foo', 'bar'])
735
>>> commit(br1, "lala!", rev_id="REVISION-ID-1", verbose=False)
736
>>> br2 = ScratchBranch()
737
>>> br2.update_revisions(br1)
741
>>> br2.revision_history()
743
>>> br2.update_revisions(br1)
747
>>> br1.text_store.total_size() == br2.text_store.total_size()
750
from bzrlib.progress import ProgressBar
754
pb.update('comparing histories')
755
revision_ids = self.missing_revisions(other, stop_revision)
757
needed_texts = sets.Set()
759
for rev_id in revision_ids:
761
pb.update('fetching revision', i, len(revision_ids))
762
rev = other.get_revision(rev_id)
763
revisions.append(rev)
764
inv = other.get_inventory(str(rev.inventory_id))
765
for key, entry in inv.iter_entries():
766
if entry.text_id is None:
768
if entry.text_id not in self.text_store:
769
needed_texts.add(entry.text_id)
773
count = self.text_store.copy_multi(other.text_store, needed_texts)
774
print "Added %d texts." % count
775
inventory_ids = [ f.inventory_id for f in revisions ]
776
count = self.inventory_store.copy_multi(other.inventory_store,
778
print "Added %d inventories." % count
779
revision_ids = [ f.revision_id for f in revisions]
780
count = self.revision_store.copy_multi(other.revision_store,
782
for revision_id in revision_ids:
783
self.append_revision(revision_id)
784
print "Added %d revisions." % count
966
787
def commit(self, *args, **kw):
967
from bzrlib.commit import Commit
968
Commit().commit(self, *args, **kw)
970
def revision_id_to_revno(self, revision_id):
971
"""Given a revision id, return its revno"""
972
if revision_id is None:
974
history = self.revision_history()
976
return history.index(revision_id) + 1
978
raise bzrlib.errors.NoSuchRevision(self, revision_id)
789
from bzrlib.commit import commit
790
commit(self, *args, **kw)
980
def get_rev_id(self, revno, history=None):
981
"""Find the revision id of the specified revno."""
793
def lookup_revision(self, revno):
794
"""Return revision hash for revision number."""
985
history = self.revision_history()
986
elif revno <= 0 or revno > len(history):
987
raise bzrlib.errors.NoSuchRevision(self, revno)
988
return history[revno - 1]
799
# list is 0-based; revisions are 1-based
800
return self.revision_history()[revno-1]
802
raise BzrError("no such revision %s" % revno)
990
805
def revision_tree(self, revision_id):
991
806
"""Return Tree for a revision on this branch.
1142
def revert(self, filenames, old_tree=None, backups=True):
1143
"""Restore selected files to the versions from a previous tree.
1146
If true (default) backups are made of files before
1149
from bzrlib.errors import NotVersionedError, BzrError
1150
from bzrlib.atomicfile import AtomicFile
1151
from bzrlib.osutils import backup_file
1153
inv = self.read_working_inventory()
1154
if old_tree is None:
1155
old_tree = self.basis_tree()
1156
old_inv = old_tree.inventory
1159
for fn in filenames:
1160
file_id = inv.path2id(fn)
1162
raise NotVersionedError("not a versioned file", fn)
1163
if not old_inv.has_id(file_id):
1164
raise BzrError("file not present in old tree", fn, file_id)
1165
nids.append((fn, file_id))
1167
# TODO: Rename back if it was previously at a different location
1169
# TODO: If given a directory, restore the entire contents from
1170
# the previous version.
1172
# TODO: Make a backup to a temporary file.
1174
# TODO: If the file previously didn't exist, delete it?
1175
for fn, file_id in nids:
1178
f = AtomicFile(fn, 'wb')
1180
f.write(old_tree.get_file(file_id).read())
1186
def pending_merges(self):
1187
"""Return a list of pending merges.
1189
These are revisions that have been merged into the working
1190
directory but not yet committed.
1192
cfn = self._rel_controlfilename('pending-merges')
1193
if not self._transport.has(cfn):
1196
for l in self.controlfile('pending-merges', 'r').readlines():
1197
p.append(l.rstrip('\n'))
1201
def add_pending_merge(self, *revision_ids):
1202
# TODO: Perhaps should check at this point that the
1203
# history of the revision is actually present?
1204
p = self.pending_merges()
1206
for rev_id in revision_ids:
1212
self.set_pending_merges(p)
1214
def set_pending_merges(self, rev_list):
1217
self.put_controlfile('pending-merges', '\n'.join(rev_list))
1222
def get_parent(self):
1223
"""Return the parent location of the branch.
1225
This is the default location for push/pull/missing. The usual
1226
pattern is that the user can override it by specifying a
1230
_locs = ['parent', 'pull', 'x-pull']
1233
return self.controlfile(l, 'r').read().strip('\n')
1235
if e.errno != errno.ENOENT:
1240
def set_parent(self, url):
1241
# TODO: Maybe delete old location files?
1242
from bzrlib.atomicfile import AtomicFile
1245
f = AtomicFile(self.controlfilename('parent'))
1254
def check_revno(self, revno):
1256
Check whether a revno corresponds to any revision.
1257
Zero (the NULL revision) is considered valid.
1260
self.check_real_revno(revno)
1262
def check_real_revno(self, revno):
1264
Check whether a revno corresponds to a real revision.
1265
Zero (the NULL revision) is considered invalid
1267
if revno < 1 or revno > self.revno():
1268
raise InvalidRevisionNumber(revno)
1274
class ScratchBranch(_Branch):
954
class ScratchBranch(Branch):
1275
955
"""Special test class: a branch that cleans up after itself.
1277
957
>>> b = ScratchBranch()
1290
970
If any files are listed, they are created in the working copy.
1292
from tempfile import mkdtemp
1294
973
if base is None:
974
base = tempfile.mkdtemp()
1297
if isinstance(base, basestring):
1298
base = get_transport(base)
1299
_Branch.__init__(self, base, init=init)
976
Branch.__init__(self, base, init=init)
1301
self._transport.mkdir(d)
978
os.mkdir(self.abspath(d))
1304
self._transport.put(f, 'content of %s' % f)
981
file(os.path.join(self.base, f), 'w').write('content of %s' % f)
1307
984
def clone(self):
1309
986
>>> orig = ScratchBranch(files=["file1", "file2"])
1310
987
>>> clone = orig.clone()
1311
>>> if os.name != 'nt':
1312
... os.path.samefile(orig.base, clone.base)
1314
... orig.base == clone.base
988
>>> os.path.samefile(orig.base, clone.base)
1317
990
>>> os.path.isfile(os.path.join(clone.base, "file1"))
1320
from shutil import copytree
1321
from tempfile import mkdtemp
993
base = tempfile.mkdtemp()
1324
copytree(self.base, base, symlinks=True)
995
shutil.copytree(self.base, base, symlinks=True)
1325
996
return ScratchBranch(base=base)
1327
998
def __del__(self):
1330
1001
def destroy(self):
1331
1002
"""Destroy the test branch, removing the scratch directory."""
1332
from shutil import rmtree
1335
1005
mutter("delete ScratchBranch %s" % self.base)
1006
shutil.rmtree(self.base)
1337
1007
except OSError, e:
1338
1008
# Work around for shutil.rmtree failing on Windows when
1339
1009
# readonly files are encountered