14
14
# along with this program; if not, write to the Free Software
15
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20
from bzrlib.lazy_import import lazy_import
17
from __future__ import absolute_import
20
from .lazy_import import lazy_import
21
21
lazy_import(globals(), """
26
branch as _mod_branch,
32
from breezy.i18n import gettext
39
43
class RevisionInfo(object):
40
44
"""The results of applying a revision specification to a branch."""
53
57
or treat the result as a tuple.
56
def __init__(self, branch, revno, rev_id=_marker):
60
def __init__(self, branch, revno=None, rev_id=None):
57
61
self.branch = branch
62
self._has_revno = (revno is not None)
65
if self.rev_id is None and self._revno is not None:
60
66
# allow caller to be lazy
61
if self.revno is None:
64
self.rev_id = branch.get_rev_id(self.revno)
68
def __nonzero__(self):
69
# first the easy ones...
67
self.rev_id = branch.get_rev_id(self._revno)
71
if not self._has_revno and self.rev_id is not None:
73
self._revno = self.branch.revision_id_to_revno(self.rev_id)
74
except errors.NoSuchRevision:
76
self._has_revno = True
70
80
if self.rev_id is None:
72
if self.revno is not None:
74
82
# TODO: otherwise, it should depend on how I was built -
75
83
# if it's in_history(branch), then check revision_history(),
76
84
# if it's in_store(branch), do the check below
77
85
return self.branch.repository.has_revision(self.rev_id)
87
__nonzero__ = __bool__
90
100
def __eq__(self, other):
91
101
if type(other) not in (tuple, list, type(self)):
93
if type(other) is type(self) and self.branch is not other.branch:
103
if isinstance(other, type(self)) and self.branch is not other.branch:
95
105
return tuple(self) == tuple(other)
97
107
def __repr__(self):
98
return '<bzrlib.revisionspec.RevisionInfo object %s, %s for %r>' % (
108
return '<breezy.revisionspec.RevisionInfo object %s, %s for %r>' % (
99
109
self.revno, self.rev_id, self.branch)
102
def from_revision_id(branch, revision_id, revs):
112
def from_revision_id(branch, revision_id):
103
113
"""Construct a RevisionInfo given just the id.
105
115
Use this if you don't know or care what the revno is.
107
if revision_id == revision.NULL_REVISION:
108
return RevisionInfo(branch, 0, revision_id)
110
revno = revs.index(revision_id) + 1
113
return RevisionInfo(branch, revno, revision_id)
117
return RevisionInfo(branch, revno=None, rev_id=revision_id)
119
120
class RevisionSpec(object):
166
163
spectype.__name__, spec)
167
164
return spectype(spec, _internal=True)
169
for spectype in SPEC_TYPES:
170
if spec.startswith(spectype.prefix):
171
trace.mutter('Returning RevisionSpec %s for %s',
172
spectype.__name__, spec)
173
return spectype(spec, _internal=True)
174
166
# Otherwise treat it as a DWIM, build the RevisionSpec object and
175
167
# wait for _match_on to be called.
176
168
return RevisionSpec_dwim(spec, _internal=True)
183
175
called directly. Only from RevisionSpec.from_string()
185
177
if not _internal:
186
symbol_versioning.warn('Creating a RevisionSpec directly has'
187
' been deprecated in version 0.11. Use'
188
' RevisionSpec.from_string()'
190
DeprecationWarning, stacklevel=2)
178
raise AssertionError(
179
'Creating a RevisionSpec directly is not supported. '
180
'Use RevisionSpec.from_string() instead.')
191
181
self.user_spec = spec
192
182
if self.prefix and spec.startswith(self.prefix):
193
183
spec = spec[len(self.prefix):]
210
200
raise errors.InvalidRevisionSpec(self.spec, branch)
212
202
def in_history(self, branch):
214
if self.wants_revision_history:
215
revs = branch.revision_history()
219
# this should never trigger.
220
# TODO: make it a deprecated code path. RBC 20060928
222
return self._match_on_and_check(branch, revs)
203
return self._match_on_and_check(branch, revs=None)
224
205
# FIXME: in_history is somewhat broken,
225
206
# it will return non-history revisions in many
312
295
"""Run the lookup and see what we can get."""
314
297
# First, see if it's a revno
316
if _revno_regex is None:
317
_revno_regex = re.compile(r'^(?:(\d+(\.\d+)*)|-\d+)(:.*)?$')
318
if _revno_regex.match(self.spec) is not None:
298
if self._revno_regex.match(self.spec) is not None:
320
300
return self._try_spectype(RevisionSpec_revno, branch)
321
301
except RevisionSpec_revno.dwim_catchable_exceptions:
324
304
# Next see what has been registered
325
for rs_class in dwim_revspecs:
305
for objgetter in self._possible_revspecs:
306
rs_class = objgetter.get_obj()
327
308
return self._try_spectype(rs_class, branch)
328
309
except rs_class.dwim_catchable_exceptions:
333
314
# really relevant.
334
315
raise errors.InvalidRevisionSpec(self.spec, branch)
318
def append_possible_revspec(cls, revspec):
319
"""Append a possible DWIM revspec.
321
:param revspec: Revision spec to try.
323
cls._possible_revspecs.append(registry._ObjectGetter(revspec))
326
def append_possible_lazy_revspec(cls, module_name, member_name):
327
"""Append a possible lazily loaded DWIM revspec.
329
:param module_name: Name of the module with the revspec
330
:param member_name: Name of the revspec within the module
332
cls._possible_revspecs.append(
333
registry._LazyObjectGetter(module_name, member_name))
337
336
class RevisionSpec_revno(RevisionSpec):
338
337
"""Selects a revision using a number."""
356
355
your history is very long.
358
357
prefix = 'revno:'
359
wants_revision_history = False
361
359
def _match_on(self, branch, revs):
362
360
"""Lookup a revision by revision number"""
363
branch, revno, revision_id = self._lookup(branch, revs)
361
branch, revno, revision_id = self._lookup(branch)
364
362
return RevisionInfo(branch, revno, revision_id)
366
def _lookup(self, branch, revs_or_none):
364
def _lookup(self, branch):
367
365
loc = self.spec.find(':')
369
367
revno_spec = self.spec
387
385
# right now - RBC 20060928
389
387
match_revno = tuple((int(number) for number in revno_spec.split('.')))
390
except ValueError, e:
388
except ValueError as e:
391
389
raise errors.InvalidRevisionSpec(self.user_spec, branch, e)
396
# the user has override the branch to look in.
397
# we need to refresh the revision_history map and
399
from bzrlib.branch import Branch
400
branch = Branch.open(branch_spec)
394
# the user has overriden the branch to look in.
395
branch = _mod_branch.Branch.open(branch_spec)
421
415
revno = last_revno + revno + 1
423
revision_id = branch.get_rev_id(revno, revs_or_none)
417
revision_id = branch.get_rev_id(revno)
424
418
except errors.NoSuchRevision:
425
419
raise errors.InvalidRevisionSpec(self.user_spec, branch)
426
420
return branch, revno, revision_id
428
422
def _as_revision_id(self, context_branch):
429
423
# We would have the revno here, but we don't really care
430
branch, revno, revision_id = self._lookup(context_branch, None)
424
branch, revno, revision_id = self._lookup(context_branch)
431
425
return revision_id
433
427
def needs_branch(self):
443
437
RevisionSpec_int = RevisionSpec_revno
447
class RevisionSpec_revid(RevisionSpec):
440
class RevisionIDSpec(RevisionSpec):
442
def _match_on(self, branch, revs):
443
revision_id = self.as_revision_id(branch)
444
return RevisionInfo.from_revision_id(branch, revision_id)
447
class RevisionSpec_revid(RevisionIDSpec):
448
448
"""Selects a revision using the revision id."""
450
450
help_txt = """Selects a revision using the revision id.
460
460
prefix = 'revid:'
462
def _match_on(self, branch, revs):
462
def _as_revision_id(self, context_branch):
463
463
# self.spec comes straight from parsing the command line arguments,
464
464
# so we expect it to be a Unicode string. Switch it to the internal
465
465
# representation.
466
revision_id = osutils.safe_revision_id(self.spec, warn=False)
467
return RevisionInfo.from_revision_id(branch, revision_id, revs)
469
def _as_revision_id(self, context_branch):
470
return osutils.safe_revision_id(self.spec, warn=False)
466
if isinstance(self.spec, unicode):
467
return cache_utf8.encode(self.spec)
489
487
def _match_on(self, branch, revs):
490
revno, revision_id = self._revno_and_revision_id(branch, revs)
488
revno, revision_id = self._revno_and_revision_id(branch)
491
489
return RevisionInfo(branch, revno, revision_id)
493
def _revno_and_revision_id(self, context_branch, revs_or_none):
491
def _revno_and_revision_id(self, context_branch):
494
492
last_revno, last_revision_id = context_branch.last_revision_info()
496
494
if self.spec == '':
573
567
return RevisionInfo(branch, revno, revision_id)
575
569
def _as_revision_id(self, context_branch):
576
base_revspec = RevisionSpec.from_string(self.spec)
577
base_revision_id = base_revspec.as_revision_id(context_branch)
570
base_revision_id = RevisionSpec.from_string(self.spec)._as_revision_id(context_branch)
578
571
if base_revision_id == revision.NULL_REVISION:
579
572
raise errors.InvalidRevisionSpec(self.user_spec, context_branch,
580
573
'cannot go before the null: revision')
610
603
def _match_on(self, branch, revs):
611
604
# Can raise tags not supported, NoSuchTag, etc
612
605
return RevisionInfo.from_revision_id(branch,
613
branch.tags.lookup_tag(self.spec),
606
branch.tags.lookup_tag(self.spec))
616
608
def _as_revision_id(self, context_branch):
617
609
return context_branch.tags.lookup_tag(self.spec)
621
613
class _RevListToTimestamps(object):
622
614
"""This takes a list of revisions, and allows you to bisect by date"""
624
__slots__ = ['revs', 'branch']
616
__slots__ = ['branch']
626
def __init__(self, revs, branch):
618
def __init__(self, branch):
628
619
self.branch = branch
630
621
def __getitem__(self, index):
631
622
"""Get the date of the index'd item"""
632
r = self.branch.repository.get_revision(self.revs[index])
623
r = self.branch.repository.get_revision(self.branch.get_rev_id(index))
633
624
# TODO: Handle timezone.
634
625
return datetime.datetime.fromtimestamp(r.timestamp)
636
627
def __len__(self):
637
return len(self.revs)
628
return self.branch.revno()
640
631
class RevisionSpec_date(RevisionSpec):
714
705
hour=hour, minute=minute, second=second)
715
706
branch.lock_read()
717
rev = bisect.bisect(_RevListToTimestamps(revs, branch), dt)
708
rev = bisect.bisect(_RevListToTimestamps(branch), dt, 1)
711
if rev == branch.revno():
721
712
raise errors.InvalidRevisionSpec(self.user_spec, branch)
723
return RevisionInfo(branch, rev + 1)
713
return RevisionInfo(branch, rev)
757
747
def _find_revision_info(branch, other_location):
758
748
revision_id = RevisionSpec_ancestor._find_revision_id(branch,
761
revno = branch.revision_id_to_revno(revision_id)
762
except errors.NoSuchRevision:
764
return RevisionInfo(branch, revno, revision_id)
750
return RevisionInfo(branch, None, revision_id)
767
753
def _find_revision_id(branch, other_location):
768
from bzrlib.branch import Branch
754
from .branch import Branch
770
756
branch.lock_read()
808
794
dwim_catchable_exceptions = (errors.NotBranchError,)
810
796
def _match_on(self, branch, revs):
811
from bzrlib.branch import Branch
797
from .branch import Branch
812
798
other_branch = Branch.open(self.spec)
813
799
revision_b = other_branch.last_revision()
814
800
if revision_b in (None, revision.NULL_REVISION):
815
801
raise errors.NoCommits(other_branch)
816
# pull in the remote revisions so we can diff
817
branch.fetch(other_branch, revision_b)
819
revno = branch.revision_id_to_revno(revision_b)
820
except errors.NoSuchRevision:
822
return RevisionInfo(branch, revno, revision_b)
803
branch = other_branch
806
# pull in the remote revisions so we can diff
807
branch.fetch(other_branch, revision_b)
808
except errors.ReadOnlyError:
809
branch = other_branch
810
return RevisionInfo(branch, None, revision_b)
824
812
def _as_revision_id(self, context_branch):
825
from bzrlib.branch import Branch
813
from .branch import Branch
826
814
other_branch = Branch.open(self.spec)
827
815
last_revision = other_branch.last_revision()
828
816
last_revision = revision.ensure_null(last_revision)
884
879
self._get_submit_location(context_branch))
882
class RevisionSpec_annotate(RevisionIDSpec):
886
help_txt = """Select the revision that last modified the specified line.
888
Select the revision that last modified the specified line. Line is
889
specified as path:number. Path is a relative path to the file. Numbers
890
start at 1, and are relative to the current version, not the last-
891
committed version of the file.
894
def _raise_invalid(self, numstring, context_branch):
895
raise errors.InvalidRevisionSpec(self.user_spec, context_branch,
896
'No such line: %s' % numstring)
898
def _as_revision_id(self, context_branch):
899
path, numstring = self.spec.rsplit(':', 1)
901
index = int(numstring) - 1
903
self._raise_invalid(numstring, context_branch)
904
tree, file_path = workingtree.WorkingTree.open_containing(path)
907
file_id = tree.path2id(file_path)
909
raise errors.InvalidRevisionSpec(self.user_spec,
910
context_branch, "File '%s' is not versioned." %
912
revision_ids = [r for (r, l) in tree.annotate_iter(file_id)]
916
revision_id = revision_ids[index]
918
self._raise_invalid(numstring, context_branch)
919
if revision_id == revision.CURRENT_REVISION:
920
raise errors.InvalidRevisionSpec(self.user_spec, context_branch,
921
'Line %s has not been committed.' % numstring)
925
class RevisionSpec_mainline(RevisionIDSpec):
927
help_txt = """Select mainline revision that merged the specified revision.
929
Select the revision that merged the specified revision into mainline.
934
def _as_revision_id(self, context_branch):
935
revspec = RevisionSpec.from_string(self.spec)
936
if revspec.get_branch() is None:
937
spec_branch = context_branch
939
spec_branch = _mod_branch.Branch.open(revspec.get_branch())
940
revision_id = revspec.as_revision_id(spec_branch)
941
graph = context_branch.repository.get_graph()
942
result = graph.find_lefthand_merger(revision_id,
943
context_branch.last_revision())
945
raise errors.InvalidRevisionSpec(self.user_spec, context_branch)
887
949
# The order in which we want to DWIM a revision spec without any prefix.
888
950
# revno is always tried first and isn't listed here, this is used by
889
951
# RevisionSpec_dwim._match_on
891
RevisionSpec_tag, # Let's try for a tag
892
RevisionSpec_revid, # Maybe it's a revid?
893
RevisionSpec_date, # Perhaps a date?
894
RevisionSpec_branch, # OK, last try, maybe it's a branch
952
RevisionSpec_dwim.append_possible_revspec(RevisionSpec_tag)
953
RevisionSpec_dwim.append_possible_revspec(RevisionSpec_revid)
954
RevisionSpec_dwim.append_possible_revspec(RevisionSpec_date)
955
RevisionSpec_dwim.append_possible_revspec(RevisionSpec_branch)
898
957
revspec_registry = registry.Registry()
899
958
def _register_revspec(revspec):
908
967
_register_revspec(RevisionSpec_ancestor)
909
968
_register_revspec(RevisionSpec_branch)
910
969
_register_revspec(RevisionSpec_submit)
912
# classes in this list should have a "prefix" attribute, against which
913
# string specs are matched
914
SPEC_TYPES = symbol_versioning.deprecated_list(
915
symbol_versioning.deprecated_in((1, 12, 0)), "SPEC_TYPES", [])
970
_register_revspec(RevisionSpec_annotate)
971
_register_revspec(RevisionSpec_mainline)