~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/revisionspec.py

  • Committer: John Arbash Meinel
  • Date: 2006-09-20 14:51:03 UTC
  • mfrom: (0.8.23 version_info)
  • mto: This revision was merged to the branch mainline in revision 2028.
  • Revision ID: john@arbash-meinel.com-20060920145103-02725c6d6c886040
[merge] version-info plugin, and cleanup for layout in bzr

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005-2010 Canonical Ltd
 
1
# Copyright (C) 2005 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
12
12
#
13
13
# You should have received a copy of the GNU General Public License
14
14
# along with this program; if not, write to the Free Software
15
 
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16
 
 
17
 
 
18
 
from bzrlib.lazy_import import lazy_import
19
 
lazy_import(globals(), """
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
16
 
 
17
 
20
18
import bisect
21
19
import datetime
 
20
import re
22
21
 
23
22
from bzrlib import (
24
 
    branch as _mod_branch,
25
 
    osutils,
 
23
    errors,
26
24
    revision,
27
25
    symbol_versioning,
28
 
    workingtree,
29
 
    )
30
 
""")
31
 
 
32
 
from bzrlib import (
33
 
    errors,
34
 
    lazy_regex,
35
 
    registry,
36
26
    trace,
37
27
    )
38
28
 
41
31
 
42
32
 
43
33
class RevisionInfo(object):
44
 
    """The results of applying a revision specification to a branch."""
45
 
 
46
 
    help_txt = """The results of applying a revision specification to a branch.
 
34
    """The results of applying a revision specification to a branch.
47
35
 
48
36
    An instance has two useful attributes: revno, and rev_id.
49
37
 
102
90
        return '<bzrlib.revisionspec.RevisionInfo object %s, %s for %r>' % (
103
91
            self.revno, self.rev_id, self.branch)
104
92
 
105
 
    @staticmethod
106
 
    def from_revision_id(branch, revision_id, revs):
107
 
        """Construct a RevisionInfo given just the id.
108
93
 
109
 
        Use this if you don't know or care what the revno is.
110
 
        """
111
 
        if revision_id == revision.NULL_REVISION:
112
 
            return RevisionInfo(branch, 0, revision_id)
113
 
        try:
114
 
            revno = revs.index(revision_id) + 1
115
 
        except ValueError:
116
 
            revno = None
117
 
        return RevisionInfo(branch, revno, revision_id)
 
94
# classes in this list should have a "prefix" attribute, against which
 
95
# string specs are matched
 
96
SPEC_TYPES = []
 
97
_revno_regex = None
118
98
 
119
99
 
120
100
class RevisionSpec(object):
121
 
    """A parsed revision specification."""
122
 
 
123
 
    help_txt = """A parsed revision specification.
124
 
 
125
 
    A revision specification is a string, which may be unambiguous about
126
 
    what it represents by giving a prefix like 'date:' or 'revid:' etc,
127
 
    or it may have no prefix, in which case it's tried against several
128
 
    specifier types in sequence to determine what the user meant.
 
101
    """A parsed revision specification.
 
102
 
 
103
    A revision specification can be an integer, in which case it is
 
104
    assumed to be a revno (though this will translate negative values
 
105
    into positive ones); or it can be a string, in which case it is
 
106
    parsed for something like 'date:' or 'revid:' etc.
129
107
 
130
108
    Revision specs are an UI element, and they have been moved out
131
109
    of the branch class to leave "back-end" classes unaware of such
137
115
    """
138
116
 
139
117
    prefix = None
140
 
    wants_revision_history = True
141
 
    dwim_catchable_exceptions = (errors.InvalidRevisionSpec,)
142
 
    """Exceptions that RevisionSpec_dwim._match_on will catch.
143
 
 
144
 
    If the revspec is part of ``dwim_revspecs``, it may be tried with an
145
 
    invalid revspec and raises some exception. The exceptions mentioned here
146
 
    will not be reported to the user but simply ignored without stopping the
147
 
    dwim processing.
148
 
    """
 
118
 
 
119
    def __new__(cls, spec, _internal=False):
 
120
        if _internal:
 
121
            return object.__new__(cls, spec, _internal=_internal)
 
122
 
 
123
        symbol_versioning.warn('Creating a RevisionSpec directly has'
 
124
                               ' been deprecated in version 0.11. Use'
 
125
                               ' RevisionSpec.from_string()'
 
126
                               ' instead.',
 
127
                               DeprecationWarning, stacklevel=2)
 
128
        return RevisionSpec.from_string(spec)
149
129
 
150
130
    @staticmethod
151
131
    def from_string(spec):
160
140
 
161
141
        if spec is None:
162
142
            return RevisionSpec(None, _internal=True)
163
 
        match = revspec_registry.get_prefix(spec)
164
 
        if match is not None:
165
 
            spectype, specsuffix = match
166
 
            trace.mutter('Returning RevisionSpec %s for %s',
167
 
                         spectype.__name__, spec)
168
 
            return spectype(spec, _internal=True)
 
143
 
 
144
        assert isinstance(spec, basestring), \
 
145
            "You should only supply strings not %s" % (type(spec),)
 
146
 
 
147
        for spectype in SPEC_TYPES:
 
148
            if spec.startswith(spectype.prefix):
 
149
                trace.mutter('Returning RevisionSpec %s for %s',
 
150
                             spectype.__name__, spec)
 
151
                return spectype(spec, _internal=True)
169
152
        else:
170
 
            # Otherwise treat it as a DWIM, build the RevisionSpec object and
171
 
            # wait for _match_on to be called.
172
 
            return RevisionSpec_dwim(spec, _internal=True)
 
153
            # RevisionSpec_revno is special cased, because it is the only
 
154
            # one that directly handles plain integers
 
155
            global _revno_regex
 
156
            if _revno_regex is None:
 
157
                _revno_regex = re.compile(r'-?\d+(:.*)?$')
 
158
            if _revno_regex.match(spec) is not None:
 
159
                return RevisionSpec_revno(spec, _internal=True)
 
160
 
 
161
            raise errors.NoSuchRevisionSpec(spec)
173
162
 
174
163
    def __init__(self, spec, _internal=False):
175
164
        """Create a RevisionSpec referring to the Null revision.
179
168
            called directly. Only from RevisionSpec.from_string()
180
169
        """
181
170
        if not _internal:
 
171
            # XXX: Update this after 0.10 is released
182
172
            symbol_versioning.warn('Creating a RevisionSpec directly has'
183
173
                                   ' been deprecated in version 0.11. Use'
184
174
                                   ' RevisionSpec.from_string()'
191
181
 
192
182
    def _match_on(self, branch, revs):
193
183
        trace.mutter('Returning RevisionSpec._match_on: None')
194
 
        return RevisionInfo(branch, None, None)
 
184
        return RevisionInfo(branch, 0, None)
195
185
 
196
186
    def _match_on_and_check(self, branch, revs):
197
187
        info = self._match_on(branch, revs)
198
188
        if info:
199
189
            return info
200
 
        elif info == (None, None):
201
 
            # special case - nothing supplied
 
190
        elif info == (0, None):
 
191
            # special case - the empty tree
202
192
            return info
203
193
        elif self.prefix:
204
194
            raise errors.InvalidRevisionSpec(self.user_spec, branch)
207
197
 
208
198
    def in_history(self, branch):
209
199
        if branch:
210
 
            if self.wants_revision_history:
211
 
                revs = branch.revision_history()
212
 
            else:
213
 
                revs = None
 
200
            revs = branch.revision_history()
214
201
        else:
215
 
            # this should never trigger.
216
 
            # TODO: make it a deprecated code path. RBC 20060928
217
202
            revs = None
218
203
        return self._match_on_and_check(branch, revs)
219
204
 
226
211
    # will do what you expect.
227
212
    in_store = in_history
228
213
    in_branch = in_store
229
 
 
230
 
    def as_revision_id(self, context_branch):
231
 
        """Return just the revision_id for this revisions spec.
232
 
 
233
 
        Some revision specs require a context_branch to be able to determine
234
 
        their value. Not all specs will make use of it.
235
 
        """
236
 
        return self._as_revision_id(context_branch)
237
 
 
238
 
    def _as_revision_id(self, context_branch):
239
 
        """Implementation of as_revision_id()
240
 
 
241
 
        Classes should override this function to provide appropriate
242
 
        functionality. The default is to just call '.in_history().rev_id'
243
 
        """
244
 
        return self.in_history(context_branch).rev_id
245
 
 
246
 
    def as_tree(self, context_branch):
247
 
        """Return the tree object for this revisions spec.
248
 
 
249
 
        Some revision specs require a context_branch to be able to determine
250
 
        the revision id and access the repository. Not all specs will make
251
 
        use of it.
252
 
        """
253
 
        return self._as_tree(context_branch)
254
 
 
255
 
    def _as_tree(self, context_branch):
256
 
        """Implementation of as_tree().
257
 
 
258
 
        Classes should override this function to provide appropriate
259
 
        functionality. The default is to just call '.as_revision_id()'
260
 
        and get the revision tree from context_branch's repository.
261
 
        """
262
 
        revision_id = self.as_revision_id(context_branch)
263
 
        return context_branch.repository.revision_tree(revision_id)
264
 
 
 
214
        
265
215
    def __repr__(self):
266
216
        # this is mostly for helping with testing
267
217
        return '<%s %s>' % (self.__class__.__name__,
268
218
                              self.user_spec)
269
 
 
 
219
    
270
220
    def needs_branch(self):
271
221
        """Whether this revision spec needs a branch.
272
222
 
276
226
 
277
227
    def get_branch(self):
278
228
        """When the revision specifier contains a branch location, return it.
279
 
 
 
229
        
280
230
        Otherwise, return None.
281
231
        """
282
232
        return None
284
234
 
285
235
# private API
286
236
 
287
 
class RevisionSpec_dwim(RevisionSpec):
288
 
    """Provides a DWIMish revision specifier lookup.
289
 
 
290
 
    Note that this does not go in the revspec_registry because by definition
291
 
    there is no prefix to identify it.  It's solely called from
292
 
    RevisionSpec.from_string() because the DWIMification happen when _match_on
293
 
    is called so the string describing the revision is kept here until needed.
294
 
    """
295
 
 
296
 
    help_txt = None
297
 
    # We don't need to build the revision history ourself, that's delegated to
298
 
    # each revspec we try.
299
 
    wants_revision_history = False
300
 
 
301
 
    _revno_regex = lazy_regex.lazy_compile(r'^(?:(\d+(\.\d+)*)|-\d+)(:.*)?$')
302
 
 
303
 
    # The revspecs to try
304
 
    _possible_revspecs = []
305
 
 
306
 
    def _try_spectype(self, rstype, branch):
307
 
        rs = rstype(self.spec, _internal=True)
308
 
        # Hit in_history to find out if it exists, or we need to try the
309
 
        # next type.
310
 
        return rs.in_history(branch)
311
 
 
312
 
    def _match_on(self, branch, revs):
313
 
        """Run the lookup and see what we can get."""
314
 
 
315
 
        # First, see if it's a revno
316
 
        if self._revno_regex.match(self.spec) is not None:
317
 
            try:
318
 
                return self._try_spectype(RevisionSpec_revno, branch)
319
 
            except RevisionSpec_revno.dwim_catchable_exceptions:
320
 
                pass
321
 
 
322
 
        # Next see what has been registered
323
 
        for objgetter in self._possible_revspecs:
324
 
            rs_class = objgetter.get_obj()
325
 
            try:
326
 
                return self._try_spectype(rs_class, branch)
327
 
            except rs_class.dwim_catchable_exceptions:
328
 
                pass
329
 
 
330
 
        # Try the old (deprecated) dwim list:
331
 
        for rs_class in dwim_revspecs:
332
 
            try:
333
 
                return self._try_spectype(rs_class, branch)
334
 
            except rs_class.dwim_catchable_exceptions:
335
 
                pass
336
 
 
337
 
        # Well, I dunno what it is. Note that we don't try to keep track of the
338
 
        # first of last exception raised during the DWIM tries as none seems
339
 
        # really relevant.
340
 
        raise errors.InvalidRevisionSpec(self.spec, branch)
341
 
 
342
 
    @classmethod
343
 
    def append_possible_revspec(cls, revspec):
344
 
        """Append a possible DWIM revspec.
345
 
 
346
 
        :param revspec: Revision spec to try.
347
 
        """
348
 
        cls._possible_revspecs.append(registry._ObjectGetter(revspec))
349
 
 
350
 
    @classmethod
351
 
    def append_possible_lazy_revspec(cls, module_name, member_name):
352
 
        """Append a possible lazily loaded DWIM revspec.
353
 
 
354
 
        :param module_name: Name of the module with the revspec
355
 
        :param member_name: Name of the revspec within the module
356
 
        """
357
 
        cls._possible_revspecs.append(
358
 
            registry._LazyObjectGetter(module_name, member_name))
359
 
 
360
 
 
361
237
class RevisionSpec_revno(RevisionSpec):
362
 
    """Selects a revision using a number."""
363
 
 
364
 
    help_txt = """Selects a revision using a number.
365
 
 
366
 
    Use an integer to specify a revision in the history of the branch.
367
 
    Optionally a branch can be specified.  A negative number will count
368
 
    from the end of the branch (-1 is the last revision, -2 the previous
369
 
    one). If the negative number is larger than the branch's history, the
370
 
    first revision is returned.
371
 
    Examples::
372
 
 
373
 
      revno:1                   -> return the first revision of this branch
374
 
      revno:3:/path/to/branch   -> return the 3rd revision of
375
 
                                   the branch '/path/to/branch'
376
 
      revno:-1                  -> The last revision in a branch.
377
 
      -2:http://other/branch    -> The second to last revision in the
378
 
                                   remote branch.
379
 
      -1000000                  -> Most likely the first revision, unless
380
 
                                   your history is very long.
381
 
    """
382
238
    prefix = 'revno:'
383
 
    wants_revision_history = False
384
239
 
385
240
    def _match_on(self, branch, revs):
386
241
        """Lookup a revision by revision number"""
387
 
        branch, revno, revision_id = self._lookup(branch, revs)
388
 
        return RevisionInfo(branch, revno, revision_id)
389
 
 
390
 
    def _lookup(self, branch, revs_or_none):
391
242
        loc = self.spec.find(':')
392
243
        if loc == -1:
393
244
            revno_spec = self.spec
404
255
        else:
405
256
            try:
406
257
                revno = int(revno_spec)
407
 
                dotted = False
408
 
            except ValueError:
409
 
                # dotted decimal. This arguably should not be here
410
 
                # but the from_string method is a little primitive
411
 
                # right now - RBC 20060928
412
 
                try:
413
 
                    match_revno = tuple((int(number) for number in revno_spec.split('.')))
414
 
                except ValueError, e:
415
 
                    raise errors.InvalidRevisionSpec(self.user_spec, branch, e)
416
 
 
417
 
                dotted = True
 
258
            except ValueError, e:
 
259
                raise errors.InvalidRevisionSpec(self.user_spec,
 
260
                                                 branch, e)
418
261
 
419
262
        if branch_spec:
420
 
            # the user has override the branch to look in.
421
 
            # we need to refresh the revision_history map and
422
 
            # the branch object.
423
263
            from bzrlib.branch import Branch
424
264
            branch = Branch.open(branch_spec)
425
 
            revs_or_none = None
 
265
            # Need to use a new revision history
 
266
            # because we are using a specific branch
 
267
            revs = branch.revision_history()
426
268
 
427
 
        if dotted:
428
 
            try:
429
 
                revision_id = branch.dotted_revno_to_revision_id(match_revno,
430
 
                    _cache_reverse=True)
431
 
            except errors.NoSuchRevision:
432
 
                raise errors.InvalidRevisionSpec(self.user_spec, branch)
 
269
        if revno < 0:
 
270
            if (-revno) >= len(revs):
 
271
                revno = 1
433
272
            else:
434
 
                # there is no traditional 'revno' for dotted-decimal revnos.
435
 
                # so for  API compatability we return None.
436
 
                return branch, None, revision_id
437
 
        else:
438
 
            last_revno, last_revision_id = branch.last_revision_info()
439
 
            if revno < 0:
440
 
                # if get_rev_id supported negative revnos, there would not be a
441
 
                # need for this special case.
442
 
                if (-revno) >= last_revno:
443
 
                    revno = 1
444
 
                else:
445
 
                    revno = last_revno + revno + 1
446
 
            try:
447
 
                revision_id = branch.get_rev_id(revno, revs_or_none)
448
 
            except errors.NoSuchRevision:
449
 
                raise errors.InvalidRevisionSpec(self.user_spec, branch)
450
 
        return branch, revno, revision_id
451
 
 
452
 
    def _as_revision_id(self, context_branch):
453
 
        # We would have the revno here, but we don't really care
454
 
        branch, revno, revision_id = self._lookup(context_branch, None)
455
 
        return revision_id
456
 
 
 
273
                revno = len(revs) + revno + 1
 
274
        try:
 
275
            revision_id = branch.get_rev_id(revno, revs)
 
276
        except errors.NoSuchRevision:
 
277
            raise errors.InvalidRevisionSpec(self.user_spec, branch)
 
278
        return RevisionInfo(branch, revno, revision_id)
 
279
        
457
280
    def needs_branch(self):
458
281
        return self.spec.find(':') == -1
459
282
 
463
286
        else:
464
287
            return self.spec[self.spec.find(':')+1:]
465
288
 
466
 
# Old compatibility
 
289
# Old compatibility 
467
290
RevisionSpec_int = RevisionSpec_revno
468
291
 
469
 
 
470
 
 
471
 
class RevisionIDSpec(RevisionSpec):
472
 
 
473
 
    def _match_on(self, branch, revs):
474
 
        revision_id = self.as_revision_id(branch)
475
 
        return RevisionInfo.from_revision_id(branch, revision_id, revs)
476
 
 
477
 
 
478
 
class RevisionSpec_revid(RevisionIDSpec):
479
 
    """Selects a revision using the revision id."""
480
 
 
481
 
    help_txt = """Selects a revision using the revision id.
482
 
 
483
 
    Supply a specific revision id, that can be used to specify any
484
 
    revision id in the ancestry of the branch.
485
 
    Including merges, and pending merges.
486
 
    Examples::
487
 
 
488
 
      revid:aaaa@bbbb-123456789 -> Select revision 'aaaa@bbbb-123456789'
489
 
    """
490
 
 
 
292
SPEC_TYPES.append(RevisionSpec_revno)
 
293
 
 
294
 
 
295
class RevisionSpec_revid(RevisionSpec):
491
296
    prefix = 'revid:'
492
297
 
493
 
    def _as_revision_id(self, context_branch):
494
 
        # self.spec comes straight from parsing the command line arguments,
495
 
        # so we expect it to be a Unicode string. Switch it to the internal
496
 
        # representation.
497
 
        return osutils.safe_revision_id(self.spec, warn=False)
 
298
    def _match_on(self, branch, revs):
 
299
        try:
 
300
            revno = revs.index(self.spec) + 1
 
301
        except ValueError:
 
302
            revno = None
 
303
        return RevisionInfo(branch, revno, self.spec)
498
304
 
 
305
SPEC_TYPES.append(RevisionSpec_revid)
499
306
 
500
307
 
501
308
class RevisionSpec_last(RevisionSpec):
502
 
    """Selects the nth revision from the end."""
503
 
 
504
 
    help_txt = """Selects the nth revision from the end.
505
 
 
506
 
    Supply a positive number to get the nth revision from the end.
507
 
    This is the same as supplying negative numbers to the 'revno:' spec.
508
 
    Examples::
509
 
 
510
 
      last:1        -> return the last revision
511
 
      last:3        -> return the revision 2 before the end.
512
 
    """
513
309
 
514
310
    prefix = 'last:'
515
311
 
516
312
    def _match_on(self, branch, revs):
517
 
        revno, revision_id = self._revno_and_revision_id(branch, revs)
518
 
        return RevisionInfo(branch, revno, revision_id)
519
 
 
520
 
    def _revno_and_revision_id(self, context_branch, revs_or_none):
521
 
        last_revno, last_revision_id = context_branch.last_revision_info()
522
 
 
523
313
        if self.spec == '':
524
 
            if not last_revno:
525
 
                raise errors.NoCommits(context_branch)
526
 
            return last_revno, last_revision_id
 
314
            if not revs:
 
315
                raise errors.NoCommits(branch)
 
316
            return RevisionInfo(branch, len(revs), revs[-1])
527
317
 
528
318
        try:
529
319
            offset = int(self.spec)
530
320
        except ValueError, e:
531
 
            raise errors.InvalidRevisionSpec(self.user_spec, context_branch, e)
 
321
            raise errors.InvalidRevisionSpec(self.user_spec, branch, e)
532
322
 
533
323
        if offset <= 0:
534
 
            raise errors.InvalidRevisionSpec(self.user_spec, context_branch,
 
324
            raise errors.InvalidRevisionSpec(self.user_spec, branch,
535
325
                                             'you must supply a positive value')
536
 
 
537
 
        revno = last_revno - offset + 1
 
326
        revno = len(revs) - offset + 1
538
327
        try:
539
 
            revision_id = context_branch.get_rev_id(revno, revs_or_none)
 
328
            revision_id = branch.get_rev_id(revno, revs)
540
329
        except errors.NoSuchRevision:
541
 
            raise errors.InvalidRevisionSpec(self.user_spec, context_branch)
542
 
        return revno, revision_id
543
 
 
544
 
    def _as_revision_id(self, context_branch):
545
 
        # We compute the revno as part of the process, but we don't really care
546
 
        # about it.
547
 
        revno, revision_id = self._revno_and_revision_id(context_branch, None)
548
 
        return revision_id
549
 
 
 
330
            raise errors.InvalidRevisionSpec(self.user_spec, branch)
 
331
        return RevisionInfo(branch, revno, revision_id)
 
332
 
 
333
SPEC_TYPES.append(RevisionSpec_last)
550
334
 
551
335
 
552
336
class RevisionSpec_before(RevisionSpec):
553
 
    """Selects the parent of the revision specified."""
554
 
 
555
 
    help_txt = """Selects the parent of the revision specified.
556
 
 
557
 
    Supply any revision spec to return the parent of that revision.  This is
558
 
    mostly useful when inspecting revisions that are not in the revision history
559
 
    of a branch.
560
 
 
561
 
    It is an error to request the parent of the null revision (before:0).
562
 
 
563
 
    Examples::
564
 
 
565
 
      before:1913    -> Return the parent of revno 1913 (revno 1912)
566
 
      before:revid:aaaa@bbbb-1234567890  -> return the parent of revision
567
 
                                            aaaa@bbbb-1234567890
568
 
      bzr diff -r before:1913..1913
569
 
            -> Find the changes between revision 1913 and its parent (1912).
570
 
               (What changes did revision 1913 introduce).
571
 
               This is equivalent to:  bzr diff -c 1913
572
 
    """
573
337
 
574
338
    prefix = 'before:'
575
 
 
 
339
    
576
340
    def _match_on(self, branch, revs):
577
341
        r = RevisionSpec.from_string(self.spec)._match_on(branch, revs)
578
342
        if r.revno == 0:
583
347
            rev = branch.repository.get_revision(r.rev_id)
584
348
            if not rev.parent_ids:
585
349
                revno = 0
586
 
                revision_id = revision.NULL_REVISION
 
350
                revision_id = None
587
351
            else:
588
352
                revision_id = rev.parent_ids[0]
589
353
                try:
599
363
                                                 branch)
600
364
        return RevisionInfo(branch, revno, revision_id)
601
365
 
602
 
    def _as_revision_id(self, context_branch):
603
 
        base_revspec = RevisionSpec.from_string(self.spec)
604
 
        base_revision_id = base_revspec.as_revision_id(context_branch)
605
 
        if base_revision_id == revision.NULL_REVISION:
606
 
            raise errors.InvalidRevisionSpec(self.user_spec, context_branch,
607
 
                                         'cannot go before the null: revision')
608
 
        context_repo = context_branch.repository
609
 
        context_repo.lock_read()
610
 
        try:
611
 
            parent_map = context_repo.get_parent_map([base_revision_id])
612
 
        finally:
613
 
            context_repo.unlock()
614
 
        if base_revision_id not in parent_map:
615
 
            # Ghost, or unknown revision id
616
 
            raise errors.InvalidRevisionSpec(self.user_spec, context_branch,
617
 
                'cannot find the matching revision')
618
 
        parents = parent_map[base_revision_id]
619
 
        if len(parents) < 1:
620
 
            raise errors.InvalidRevisionSpec(self.user_spec, context_branch,
621
 
                'No parents for revision.')
622
 
        return parents[0]
623
 
 
 
366
SPEC_TYPES.append(RevisionSpec_before)
624
367
 
625
368
 
626
369
class RevisionSpec_tag(RevisionSpec):
627
 
    """Select a revision identified by tag name"""
628
 
 
629
 
    help_txt = """Selects a revision identified by a tag name.
630
 
 
631
 
    Tags are stored in the branch and created by the 'tag' command.
632
 
    """
633
 
 
634
370
    prefix = 'tag:'
635
 
    dwim_catchable_exceptions = (errors.NoSuchTag, errors.TagsNotSupported)
636
371
 
637
372
    def _match_on(self, branch, revs):
638
 
        # Can raise tags not supported, NoSuchTag, etc
639
 
        return RevisionInfo.from_revision_id(branch,
640
 
            branch.tags.lookup_tag(self.spec),
641
 
            revs)
642
 
 
643
 
    def _as_revision_id(self, context_branch):
644
 
        return context_branch.tags.lookup_tag(self.spec)
645
 
 
 
373
        raise errors.InvalidRevisionSpec(self.user_spec, branch,
 
374
                                         'tag: namespace registered,'
 
375
                                         ' but not implemented')
 
376
 
 
377
SPEC_TYPES.append(RevisionSpec_tag)
646
378
 
647
379
 
648
380
class _RevListToTimestamps(object):
665
397
 
666
398
 
667
399
class RevisionSpec_date(RevisionSpec):
668
 
    """Selects a revision on the basis of a datestamp."""
669
 
 
670
 
    help_txt = """Selects a revision on the basis of a datestamp.
671
 
 
672
 
    Supply a datestamp to select the first revision that matches the date.
673
 
    Date can be 'yesterday', 'today', 'tomorrow' or a YYYY-MM-DD string.
674
 
    Matches the first entry after a given date (either at midnight or
675
 
    at a specified time).
676
 
 
677
 
    One way to display all the changes since yesterday would be::
678
 
 
679
 
        bzr log -r date:yesterday..
680
 
 
681
 
    Examples::
682
 
 
683
 
      date:yesterday            -> select the first revision since yesterday
684
 
      date:2006-08-14,17:10:14  -> select the first revision after
685
 
                                   August 14th, 2006 at 5:10pm.
686
 
    """
687
400
    prefix = 'date:'
688
 
    _date_regex = lazy_regex.lazy_compile(
 
401
    _date_re = re.compile(
689
402
            r'(?P<date>(?P<year>\d\d\d\d)-(?P<month>\d\d)-(?P<day>\d\d))?'
690
403
            r'(,|T)?\s*'
691
404
            r'(?P<time>(?P<hour>\d\d):(?P<minute>\d\d)(:(?P<second>\d\d))?)?'
692
405
        )
693
406
 
694
407
    def _match_on(self, branch, revs):
695
 
        """Spec for date revisions:
 
408
        """
 
409
        Spec for date revisions:
696
410
          date:value
697
411
          value can be 'yesterday', 'today', 'tomorrow' or a YYYY-MM-DD string.
698
412
          matches the first entry after a given date (either at midnight or
699
413
          at a specified time).
 
414
 
 
415
          So the proper way of saying 'give me all entries for today' is:
 
416
              -r date:yesterday..date:today
700
417
        """
701
 
        #  XXX: This doesn't actually work
702
 
        #  So the proper way of saying 'give me all entries for today' is:
703
 
        #      -r date:yesterday..date:today
704
418
        today = datetime.datetime.fromordinal(datetime.date.today().toordinal())
705
419
        if self.spec.lower() == 'yesterday':
706
420
            dt = today - datetime.timedelta(days=1)
709
423
        elif self.spec.lower() == 'tomorrow':
710
424
            dt = today + datetime.timedelta(days=1)
711
425
        else:
712
 
            m = self._date_regex.match(self.spec)
 
426
            m = self._date_re.match(self.spec)
713
427
            if not m or (not m.group('date') and not m.group('time')):
714
428
                raise errors.InvalidRevisionSpec(self.user_spec,
715
429
                                                 branch, 'invalid date')
745
459
        finally:
746
460
            branch.unlock()
747
461
        if rev == len(revs):
748
 
            raise errors.InvalidRevisionSpec(self.user_spec, branch)
 
462
            return RevisionInfo(branch, None)
749
463
        else:
750
464
            return RevisionInfo(branch, rev + 1)
751
465
 
 
466
SPEC_TYPES.append(RevisionSpec_date)
752
467
 
753
468
 
754
469
class RevisionSpec_ancestor(RevisionSpec):
755
 
    """Selects a common ancestor with a second branch."""
756
 
 
757
 
    help_txt = """Selects a common ancestor with a second branch.
758
 
 
759
 
    Supply the path to a branch to select the common ancestor.
760
 
 
761
 
    The common ancestor is the last revision that existed in both
762
 
    branches. Usually this is the branch point, but it could also be
763
 
    a revision that was merged.
764
 
 
765
 
    This is frequently used with 'diff' to return all of the changes
766
 
    that your branch introduces, while excluding the changes that you
767
 
    have not merged from the remote branch.
768
 
 
769
 
    Examples::
770
 
 
771
 
      ancestor:/path/to/branch
772
 
      $ bzr diff -r ancestor:../../mainline/branch
773
 
    """
774
470
    prefix = 'ancestor:'
775
471
 
776
472
    def _match_on(self, branch, revs):
 
473
        from bzrlib.branch import Branch
 
474
 
777
475
        trace.mutter('matching ancestor: on: %s, %s', self.spec, branch)
778
 
        return self._find_revision_info(branch, self.spec)
779
 
 
780
 
    def _as_revision_id(self, context_branch):
781
 
        return self._find_revision_id(context_branch, self.spec)
782
 
 
783
 
    @staticmethod
784
 
    def _find_revision_info(branch, other_location):
785
 
        revision_id = RevisionSpec_ancestor._find_revision_id(branch,
786
 
                                                              other_location)
 
476
        other_branch = Branch.open(self.spec)
 
477
        revision_a = branch.last_revision()
 
478
        revision_b = other_branch.last_revision()
 
479
        for r, b in ((revision_a, branch), (revision_b, other_branch)):
 
480
            if r in (None, revision.NULL_REVISION):
 
481
                raise errors.NoCommits(b)
 
482
        revision_source = revision.MultipleRevisionSources(
 
483
                branch.repository, other_branch.repository)
 
484
        rev_id = revision.common_ancestor(revision_a, revision_b,
 
485
                                          revision_source)
787
486
        try:
788
 
            revno = branch.revision_id_to_revno(revision_id)
 
487
            revno = branch.revision_id_to_revno(rev_id)
789
488
        except errors.NoSuchRevision:
790
489
            revno = None
791
 
        return RevisionInfo(branch, revno, revision_id)
792
 
 
793
 
    @staticmethod
794
 
    def _find_revision_id(branch, other_location):
795
 
        from bzrlib.branch import Branch
796
 
 
797
 
        branch.lock_read()
798
 
        try:
799
 
            revision_a = revision.ensure_null(branch.last_revision())
800
 
            if revision_a == revision.NULL_REVISION:
801
 
                raise errors.NoCommits(branch)
802
 
            if other_location == '':
803
 
                other_location = branch.get_parent()
804
 
            other_branch = Branch.open(other_location)
805
 
            other_branch.lock_read()
806
 
            try:
807
 
                revision_b = revision.ensure_null(other_branch.last_revision())
808
 
                if revision_b == revision.NULL_REVISION:
809
 
                    raise errors.NoCommits(other_branch)
810
 
                graph = branch.repository.get_graph(other_branch.repository)
811
 
                rev_id = graph.find_unique_lca(revision_a, revision_b)
812
 
            finally:
813
 
                other_branch.unlock()
814
 
            if rev_id == revision.NULL_REVISION:
815
 
                raise errors.NoCommonAncestor(revision_a, revision_b)
816
 
            return rev_id
817
 
        finally:
818
 
            branch.unlock()
819
 
 
820
 
 
 
490
        return RevisionInfo(branch, revno, rev_id)
 
491
        
 
492
SPEC_TYPES.append(RevisionSpec_ancestor)
821
493
 
822
494
 
823
495
class RevisionSpec_branch(RevisionSpec):
824
 
    """Selects the last revision of a specified branch."""
825
 
 
826
 
    help_txt = """Selects the last revision of a specified branch.
827
 
 
828
 
    Supply the path to a branch to select its last revision.
829
 
 
830
 
    Examples::
831
 
 
832
 
      branch:/path/to/branch
 
496
    """A branch: revision specifier.
 
497
 
 
498
    This takes the path to a branch and returns its tip revision id.
833
499
    """
834
500
    prefix = 'branch:'
835
 
    dwim_catchable_exceptions = (errors.NotBranchError,)
836
501
 
837
502
    def _match_on(self, branch, revs):
838
503
        from bzrlib.branch import Branch
840
505
        revision_b = other_branch.last_revision()
841
506
        if revision_b in (None, revision.NULL_REVISION):
842
507
            raise errors.NoCommits(other_branch)
843
 
        if branch is None:
844
 
            branch = other_branch
845
 
        else:
846
 
            try:
847
 
                # pull in the remote revisions so we can diff
848
 
                branch.fetch(other_branch, revision_b)
849
 
            except errors.ReadOnlyError:
850
 
                branch = other_branch
 
508
        # pull in the remote revisions so we can diff
 
509
        branch.fetch(other_branch, revision_b)
851
510
        try:
852
511
            revno = branch.revision_id_to_revno(revision_b)
853
512
        except errors.NoSuchRevision:
854
513
            revno = None
855
514
        return RevisionInfo(branch, revno, revision_b)
856
 
 
857
 
    def _as_revision_id(self, context_branch):
858
 
        from bzrlib.branch import Branch
859
 
        other_branch = Branch.open(self.spec)
860
 
        last_revision = other_branch.last_revision()
861
 
        last_revision = revision.ensure_null(last_revision)
862
 
        context_branch.fetch(other_branch, last_revision)
863
 
        if last_revision == revision.NULL_REVISION:
864
 
            raise errors.NoCommits(other_branch)
865
 
        return last_revision
866
 
 
867
 
    def _as_tree(self, context_branch):
868
 
        from bzrlib.branch import Branch
869
 
        other_branch = Branch.open(self.spec)
870
 
        last_revision = other_branch.last_revision()
871
 
        last_revision = revision.ensure_null(last_revision)
872
 
        if last_revision == revision.NULL_REVISION:
873
 
            raise errors.NoCommits(other_branch)
874
 
        return other_branch.repository.revision_tree(last_revision)
875
 
 
876
 
    def needs_branch(self):
877
 
        return False
878
 
 
879
 
    def get_branch(self):
880
 
        return self.spec
881
 
 
882
 
 
883
 
 
884
 
class RevisionSpec_submit(RevisionSpec_ancestor):
885
 
    """Selects a common ancestor with a submit branch."""
886
 
 
887
 
    help_txt = """Selects a common ancestor with the submit branch.
888
 
 
889
 
    Diffing against this shows all the changes that were made in this branch,
890
 
    and is a good predictor of what merge will do.  The submit branch is
891
 
    used by the bundle and merge directive commands.  If no submit branch
892
 
    is specified, the parent branch is used instead.
893
 
 
894
 
    The common ancestor is the last revision that existed in both
895
 
    branches. Usually this is the branch point, but it could also be
896
 
    a revision that was merged.
897
 
 
898
 
    Examples::
899
 
 
900
 
      $ bzr diff -r submit:
901
 
    """
902
 
 
903
 
    prefix = 'submit:'
904
 
 
905
 
    def _get_submit_location(self, branch):
906
 
        submit_location = branch.get_submit_branch()
907
 
        location_type = 'submit branch'
908
 
        if submit_location is None:
909
 
            submit_location = branch.get_parent()
910
 
            location_type = 'parent branch'
911
 
        if submit_location is None:
912
 
            raise errors.NoSubmitBranch(branch)
913
 
        trace.note('Using %s %s', location_type, submit_location)
914
 
        return submit_location
915
 
 
916
 
    def _match_on(self, branch, revs):
917
 
        trace.mutter('matching ancestor: on: %s, %s', self.spec, branch)
918
 
        return self._find_revision_info(branch,
919
 
            self._get_submit_location(branch))
920
 
 
921
 
    def _as_revision_id(self, context_branch):
922
 
        return self._find_revision_id(context_branch,
923
 
            self._get_submit_location(context_branch))
924
 
 
925
 
 
926
 
class RevisionSpec_annotate(RevisionIDSpec):
927
 
 
928
 
    prefix = 'annotate:'
929
 
 
930
 
    help_txt = """Select the revision that last modified the specified line.
931
 
 
932
 
    Select the revision that last modified the specified line.  Line is
933
 
    specified as path:number.  Path is a relative path to the file.  Numbers
934
 
    start at 1, and are relative to the current version, not the last-
935
 
    committed version of the file.
936
 
    """
937
 
 
938
 
    def _raise_invalid(self, numstring, context_branch):
939
 
        raise errors.InvalidRevisionSpec(self.user_spec, context_branch,
940
 
            'No such line: %s' % numstring)
941
 
 
942
 
    def _as_revision_id(self, context_branch):
943
 
        path, numstring = self.spec.rsplit(':', 1)
944
 
        try:
945
 
            index = int(numstring) - 1
946
 
        except ValueError:
947
 
            self._raise_invalid(numstring, context_branch)
948
 
        tree, file_path = workingtree.WorkingTree.open_containing(path)
949
 
        tree.lock_read()
950
 
        try:
951
 
            file_id = tree.path2id(file_path)
952
 
            if file_id is None:
953
 
                raise errors.InvalidRevisionSpec(self.user_spec,
954
 
                    context_branch, "File '%s' is not versioned." %
955
 
                    file_path)
956
 
            revision_ids = [r for (r, l) in tree.annotate_iter(file_id)]
957
 
        finally:
958
 
            tree.unlock()
959
 
        try:
960
 
            revision_id = revision_ids[index]
961
 
        except IndexError:
962
 
            self._raise_invalid(numstring, context_branch)
963
 
        if revision_id == revision.CURRENT_REVISION:
964
 
            raise errors.InvalidRevisionSpec(self.user_spec, context_branch,
965
 
                'Line %s has not been committed.' % numstring)
966
 
        return revision_id
967
 
 
968
 
 
969
 
class RevisionSpec_mainline(RevisionIDSpec):
970
 
 
971
 
    help_txt = """Select mainline revision that merged the specified revision.
972
 
 
973
 
    Select the revision that merged the specified revision into mainline.
974
 
    """
975
 
 
976
 
    prefix = 'mainline:'
977
 
 
978
 
    def _as_revision_id(self, context_branch):
979
 
        revspec = RevisionSpec.from_string(self.spec)
980
 
        if revspec.get_branch() is None:
981
 
            spec_branch = context_branch
982
 
        else:
983
 
            spec_branch = _mod_branch.Branch.open(revspec.get_branch())
984
 
        revision_id = revspec.as_revision_id(spec_branch)
985
 
        graph = context_branch.repository.get_graph()
986
 
        result = graph.find_lefthand_merger(revision_id,
987
 
                                            context_branch.last_revision())
988
 
        if result is None:
989
 
            raise errors.InvalidRevisionSpec(self.user_spec, context_branch)
990
 
        return result
991
 
 
992
 
 
993
 
# The order in which we want to DWIM a revision spec without any prefix.
994
 
# revno is always tried first and isn't listed here, this is used by
995
 
# RevisionSpec_dwim._match_on
996
 
dwim_revspecs = symbol_versioning.deprecated_list(
997
 
    symbol_versioning.deprecated_in((2, 4, 0)), "dwim_revspecs", [])
998
 
 
999
 
RevisionSpec_dwim.append_possible_revspec(RevisionSpec_tag)
1000
 
RevisionSpec_dwim.append_possible_revspec(RevisionSpec_revid)
1001
 
RevisionSpec_dwim.append_possible_revspec(RevisionSpec_date)
1002
 
RevisionSpec_dwim.append_possible_revspec(RevisionSpec_branch)
1003
 
 
1004
 
revspec_registry = registry.Registry()
1005
 
def _register_revspec(revspec):
1006
 
    revspec_registry.register(revspec.prefix, revspec)
1007
 
 
1008
 
_register_revspec(RevisionSpec_revno)
1009
 
_register_revspec(RevisionSpec_revid)
1010
 
_register_revspec(RevisionSpec_last)
1011
 
_register_revspec(RevisionSpec_before)
1012
 
_register_revspec(RevisionSpec_tag)
1013
 
_register_revspec(RevisionSpec_date)
1014
 
_register_revspec(RevisionSpec_ancestor)
1015
 
_register_revspec(RevisionSpec_branch)
1016
 
_register_revspec(RevisionSpec_submit)
1017
 
_register_revspec(RevisionSpec_annotate)
1018
 
_register_revspec(RevisionSpec_mainline)
 
515
        
 
516
SPEC_TYPES.append(RevisionSpec_branch)