~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/commands.py

  • Committer: Martin Pool
  • Date: 2005-05-05 06:38:18 UTC
  • Revision ID: mbp@sourcefrog.net-20050505063818-3eb3260343878325
- do upload CHANGELOG to web server, even though it's autogenerated

Show diffs side-by-side

added added

removed removed

Lines of Context:
16
16
 
17
17
 
18
18
 
19
 
import sys, os
 
19
import sys, os, time, os.path
 
20
from sets import Set
20
21
 
21
22
import bzrlib
22
23
from bzrlib.trace import mutter, note, log_error
23
24
from bzrlib.errors import bailout, BzrError, BzrCheckError, BzrCommandError
24
 
from bzrlib.osutils import quotefn
25
 
from bzrlib import Branch, Inventory, InventoryEntry, BZRDIR, \
 
25
from bzrlib.osutils import quotefn, pumpfile, isdir, isfile
 
26
from bzrlib.tree import RevisionTree, EmptyTree, WorkingTree, Tree
 
27
from bzrlib.revision import Revision
 
28
from bzrlib import Branch, Inventory, InventoryEntry, ScratchBranch, BZRDIR, \
26
29
     format_date
27
30
 
28
31
 
34
37
    assert cmd.startswith("cmd_")
35
38
    return cmd[4:].replace('_','-')
36
39
 
37
 
def _parse_revision_str(revstr):
38
 
    """This handles a revision string -> revno. 
39
 
 
40
 
    There are several possibilities:
41
 
 
42
 
        '234'       -> 234
43
 
        '234:345'   -> [234, 345]
44
 
        ':234'      -> [None, 234]
45
 
        '234:'      -> [234, None]
46
 
 
47
 
    In the future we will also support:
48
 
        'uuid:blah-blah-blah'   -> ?
49
 
        'hash:blahblahblah'     -> ?
50
 
        potentially:
51
 
        'tag:mytag'             -> ?
52
 
    """
53
 
    if revstr.find(':') != -1:
54
 
        revs = revstr.split(':')
55
 
        if len(revs) > 2:
56
 
            raise ValueError('More than 2 pieces not supported for --revision: %r' % revstr)
57
 
 
58
 
        if not revs[0]:
59
 
            revs[0] = None
60
 
        else:
61
 
            revs[0] = int(revs[0])
62
 
 
63
 
        if not revs[1]:
64
 
            revs[1] = None
65
 
        else:
66
 
            revs[1] = int(revs[1])
67
 
    else:
68
 
        revs = int(revstr)
69
 
    return revs
70
 
 
71
40
def get_all_cmds():
72
41
    """Return canonical name and class for all registered commands."""
73
42
    for k, v in globals().iteritems():
89
58
    for cmdname, cmdclass in get_all_cmds():
90
59
        if cmd in cmdclass.aliases:
91
60
            return cmdname, cmdclass
92
 
 
93
 
    cmdclass = ExternalCommand.find_command(cmd)
94
 
    if cmdclass:
95
 
        return cmd, cmdclass
96
 
 
97
 
    raise BzrCommandError("unknown command %r" % cmd)
98
 
 
99
 
 
100
 
class Command(object):
 
61
    else:
 
62
        raise BzrCommandError("unknown command %r" % cmd)
 
63
 
 
64
 
 
65
class Command:
101
66
    """Base class for commands.
102
67
 
103
68
    The docstring for an actual command should give a single-line
146
111
        return 0
147
112
 
148
113
 
149
 
class ExternalCommand(Command):
150
 
    """Class to wrap external commands.
151
 
 
152
 
    We cheat a little here, when get_cmd_class() calls us we actually give it back
153
 
    an object we construct that has the appropriate path, help, options etc for the
154
 
    specified command.
155
 
 
156
 
    When run_bzr() tries to instantiate that 'class' it gets caught by the __call__
157
 
    method, which we override to call the Command.__init__ method. That then calls
158
 
    our run method which is pretty straight forward.
159
 
 
160
 
    The only wrinkle is that we have to map bzr's dictionary of options and arguments
161
 
    back into command line options and arguments for the script.
162
 
    """
163
 
 
164
 
    def find_command(cls, cmd):
165
 
        import os.path
166
 
        bzrpath = os.environ.get('BZRPATH', '')
167
 
 
168
 
        for dir in bzrpath.split(':'):
169
 
            path = os.path.join(dir, cmd)
170
 
            if os.path.isfile(path):
171
 
                return ExternalCommand(path)
172
 
 
173
 
        return None
174
 
 
175
 
    find_command = classmethod(find_command)
176
 
 
177
 
    def __init__(self, path):
178
 
        self.path = path
179
 
 
180
 
        # TODO: If either of these fail, we should detect that and
181
 
        # assume that path is not really a bzr plugin after all.
182
 
 
183
 
        pipe = os.popen('%s --bzr-usage' % path, 'r')
184
 
        self.takes_options = pipe.readline().split()
185
 
        self.takes_args = pipe.readline().split()
186
 
        pipe.close()
187
 
 
188
 
        pipe = os.popen('%s --bzr-help' % path, 'r')
189
 
        self.__doc__ = pipe.read()
190
 
        pipe.close()
191
 
 
192
 
    def __call__(self, options, arguments):
193
 
        Command.__init__(self, options, arguments)
194
 
        return self
195
 
 
196
 
    def run(self, **kargs):
197
 
        opts = []
198
 
        args = []
199
 
 
200
 
        keys = kargs.keys()
201
 
        keys.sort()
202
 
        for name in keys:
203
 
            value = kargs[name]
204
 
            if OPTIONS.has_key(name):
205
 
                # it's an option
206
 
                opts.append('--%s' % name)
207
 
                if value is not None and value is not True:
208
 
                    opts.append(str(value))
209
 
            else:
210
 
                # it's an arg, or arg list
211
 
                if type(value) is not list:
212
 
                    value = [value]
213
 
                for v in value:
214
 
                    if v is not None:
215
 
                        args.append(str(v))
216
 
 
217
 
        self.status = os.spawnv(os.P_WAIT, self.path, [self.path] + opts + args)
218
 
        return self.status
219
 
 
220
114
 
221
115
class cmd_status(Command):
222
116
    """Display status summary.
223
117
 
224
 
    This reports on versioned and unknown files, reporting them
225
 
    grouped by state.  Possible states are:
226
 
 
227
 
    added
228
 
        Versioned in the working copy but not in the previous revision.
229
 
 
230
 
    removed
231
 
        Versioned in the previous revision but removed or deleted
232
 
        in the working copy.
233
 
 
234
 
    renamed
235
 
        Path of this file changed from the previous revision;
236
 
        the text may also have changed.  This includes files whose
237
 
        parent directory was renamed.
238
 
 
239
 
    modified
240
 
        Text has changed since the previous revision.
241
 
 
242
 
    unchanged
243
 
        Nothing about this file has changed since the previous revision.
244
 
        Only shown with --all.
245
 
 
246
 
    unknown
247
 
        Not versioned and not matching an ignore pattern.
248
 
 
249
 
    To see ignored files use 'bzr ignored'.  For details in the
250
 
    changes to file texts, use 'bzr diff'.
251
 
 
252
 
    If no arguments are specified, the status of the entire working
253
 
    directory is shown.  Otherwise, only the status of the specified
254
 
    files or directories is reported.  If a directory is given, status
255
 
    is reported for everything inside that directory.
 
118
    For each file there is a single line giving its file state and name.
 
119
    The name is that in the current revision unless it is deleted or
 
120
    missing, in which case the old name is shown.
256
121
    """
257
 
    takes_args = ['file*']
258
 
    takes_options = ['all', 'show-ids']
 
122
    takes_options = ['all']
259
123
    aliases = ['st', 'stat']
260
124
    
261
 
    def run(self, all=False, show_ids=False, file_list=None):
262
 
        if file_list:
263
 
            b = Branch(file_list[0])
264
 
            file_list = [b.relpath(x) for x in file_list]
265
 
            # special case: only one path was given and it's the root
266
 
            # of the branch
267
 
            if file_list == ['']:
268
 
                file_list = None
269
 
        else:
270
 
            b = Branch('.')
271
 
        import status
272
 
        status.show_status(b, show_unchanged=all, show_ids=show_ids,
273
 
                           specific_files=file_list)
 
125
    def run(self, all=False):
 
126
        #import bzrlib.status
 
127
        #bzrlib.status.tree_status(Branch('.'))
 
128
        Branch('.').show_status(show_all=all)
274
129
 
275
130
 
276
131
class cmd_cat_revision(Command):
313
168
    recursively add that parent, rather than giving an error?
314
169
    """
315
170
    takes_args = ['file+']
316
 
    takes_options = ['verbose', 'no-recurse']
 
171
    takes_options = ['verbose']
317
172
    
318
 
    def run(self, file_list, verbose=False, no_recurse=False):
319
 
        bzrlib.add.smart_add(file_list, verbose, not no_recurse)
320
 
 
321
 
 
322
 
class cmd_relpath(Command):
 
173
    def run(self, file_list, verbose=False):
 
174
        bzrlib.add.smart_add(file_list, verbose)
 
175
 
 
176
 
 
177
def Relpath(Command):
323
178
    """Show path of a file relative to root"""
324
 
    takes_args = ['filename']
325
 
    hidden = True
 
179
    takes_args = ('filename')
326
180
    
327
 
    def run(self, filename):
328
 
        print Branch(filename).relpath(filename)
 
181
    def run(self):
 
182
        print Branch(self.args['filename']).relpath(filename)
329
183
 
330
184
 
331
185
 
332
186
class cmd_inventory(Command):
333
187
    """Show inventory of the current working copy or a revision."""
334
 
    takes_options = ['revision', 'show-ids']
 
188
    takes_options = ['revision']
335
189
    
336
 
    def run(self, revision=None, show_ids=False):
 
190
    def run(self, revision=None):
337
191
        b = Branch('.')
338
192
        if revision == None:
339
193
            inv = b.read_working_inventory()
340
194
        else:
341
195
            inv = b.get_revision_inventory(b.lookup_revision(revision))
342
196
 
343
 
        for path, entry in inv.entries():
344
 
            if show_ids:
345
 
                print '%-50s %s' % (path, entry.file_id)
346
 
            else:
347
 
                print path
 
197
        for path, entry in inv.iter_entries():
 
198
            print '%-50s %s' % (entry.file_id, path)
348
199
 
349
200
 
350
201
class cmd_move(Command):
405
256
 
406
257
 
407
258
class cmd_info(Command):
408
 
    """Show statistical information about a branch."""
409
 
    takes_args = ['branch?']
410
 
    
411
 
    def run(self, branch=None):
 
259
    """Show statistical information for this branch"""
 
260
    def run(self):
412
261
        import info
413
 
 
414
 
        from branch import find_branch
415
 
        b = find_branch(branch)
416
 
        info.show_info(b)
 
262
        info.show_info(Branch('.'))        
417
263
 
418
264
 
419
265
class cmd_remove(Command):
467
313
 
468
314
class cmd_revision_history(Command):
469
315
    """Display list of revision ids on this branch."""
470
 
    hidden = True
471
316
    def run(self):
472
317
        for patchid in Branch('.').revision_history():
473
318
            print patchid
525
370
    """
526
371
    
527
372
    takes_args = ['file*']
528
 
    takes_options = ['revision', 'diff-options']
 
373
    takes_options = ['revision']
529
374
    aliases = ['di']
530
375
 
531
 
    def run(self, revision=None, file_list=None, diff_options=None):
 
376
    def run(self, revision=None, file_list=None):
532
377
        from bzrlib.diff import show_diff
533
 
        from bzrlib import find_branch
534
 
 
535
 
        if file_list:
536
 
            b = find_branch(file_list[0])
537
 
            file_list = [b.relpath(f) for f in file_list]
538
 
            if file_list == ['']:
539
 
                # just pointing to top-of-tree
540
 
                file_list = None
541
 
        else:
542
 
            b = Branch('.')
543
378
    
544
 
        show_diff(b, revision, specific_files=file_list,
545
 
                  external_diff_options=diff_options)
546
 
 
547
 
 
548
 
        
 
379
        show_diff(Branch('.'), revision, file_list)
549
380
 
550
381
 
551
382
class cmd_deleted(Command):
570
401
                else:
571
402
                    print path
572
403
 
573
 
 
574
 
class cmd_modified(Command):
575
 
    """List files modified in working tree."""
576
 
    hidden = True
577
 
    def run(self):
578
 
        import statcache
579
 
        b = Branch('.')
580
 
        inv = b.read_working_inventory()
581
 
        sc = statcache.update_cache(b, inv)
582
 
        basis = b.basis_tree()
583
 
        basis_inv = basis.inventory
584
 
        
585
 
        # We used to do this through iter_entries(), but that's slow
586
 
        # when most of the files are unmodified, as is usually the
587
 
        # case.  So instead we iterate by inventory entry, and only
588
 
        # calculate paths as necessary.
589
 
 
590
 
        for file_id in basis_inv:
591
 
            cacheentry = sc.get(file_id)
592
 
            if not cacheentry:                 # deleted
593
 
                continue
594
 
            ie = basis_inv[file_id]
595
 
            if cacheentry[statcache.SC_SHA1] != ie.text_sha1:
596
 
                path = inv.id2path(file_id)
597
 
                print path
598
 
 
599
 
 
600
 
 
601
 
class cmd_added(Command):
602
 
    """List files added in working tree."""
603
 
    hidden = True
604
 
    def run(self):
605
 
        b = Branch('.')
606
 
        wt = b.working_tree()
607
 
        basis_inv = b.basis_tree().inventory
608
 
        inv = wt.inventory
609
 
        for file_id in inv:
610
 
            if file_id in basis_inv:
611
 
                continue
612
 
            path = inv.id2path(file_id)
613
 
            if not os.access(b.abspath(path), os.F_OK):
614
 
                continue
615
 
            print path
616
 
                
617
 
        
618
 
 
619
404
class cmd_root(Command):
620
405
    """Show the tree root directory.
621
406
 
624
409
    takes_args = ['filename?']
625
410
    def run(self, filename=None):
626
411
        """Print the branch root."""
627
 
        from branch import find_branch
628
 
        b = find_branch(filename)
629
 
        print getattr(b, 'base', None) or getattr(b, 'baseurl')
 
412
        print bzrlib.branch.find_branch_root(filename)
 
413
 
630
414
 
631
415
 
632
416
class cmd_log(Command):
633
417
    """Show log of this branch.
634
418
 
635
 
    To request a range of logs, you can use the command -r begin:end
636
 
    -r revision requests a specific revision, -r :end or -r begin: are
637
 
    also valid.
638
 
 
639
 
    TODO: Make --revision support uuid: and hash: [future tag:] notation.
640
 
  
 
419
    TODO: Options to show ids; to limit range; etc.
641
420
    """
642
 
 
643
 
    takes_args = ['filename?']
644
 
    takes_options = ['forward', 'timezone', 'verbose', 'show-ids', 'revision']
645
 
    
646
 
    def run(self, filename=None, timezone='original',
647
 
            verbose=False,
648
 
            show_ids=False,
649
 
            forward=False,
650
 
            revision=None):
651
 
        from bzrlib import show_log, find_branch
652
 
        import codecs
653
 
 
654
 
        direction = (forward and 'forward') or 'reverse'
655
 
        
656
 
        if filename:
657
 
            b = find_branch(filename)
658
 
            fp = b.relpath(filename)
659
 
            if fp:
660
 
                file_id = b.read_working_inventory().path2id(fp)
661
 
            else:
662
 
                file_id = None  # points to branch root
663
 
        else:
664
 
            b = find_branch('.')
665
 
            file_id = None
666
 
 
667
 
        if revision == None:
668
 
            revision = [None, None]
669
 
        elif isinstance(revision, int):
670
 
            revision = [revision, revision]
671
 
        else:
672
 
            # pair of revisions?
673
 
            pass
674
 
            
675
 
        assert len(revision) == 2
676
 
 
677
 
        mutter('encoding log as %r' % bzrlib.user_encoding)
678
 
 
679
 
        # use 'replace' so that we don't abort if trying to write out
680
 
        # in e.g. the default C locale.
681
 
        outf = codecs.getwriter(bzrlib.user_encoding)(sys.stdout, errors='replace')
682
 
 
683
 
        show_log(b, file_id,
684
 
                 show_timezone=timezone,
685
 
                 verbose=verbose,
686
 
                 show_ids=show_ids,
687
 
                 to_file=outf,
688
 
                 direction=direction,
689
 
                 start_revision=revision[0],
690
 
                 end_revision=revision[1])
691
 
 
692
 
 
693
 
 
694
 
class cmd_touching_revisions(Command):
695
 
    """Return revision-ids which affected a particular file.
696
 
 
697
 
    A more user-friendly interface is "bzr log FILE"."""
698
 
    hidden = True
699
 
    takes_args = ["filename"]
700
 
    def run(self, filename):
701
 
        b = Branch(filename)
702
 
        inv = b.read_working_inventory()
703
 
        file_id = inv.path2id(b.relpath(filename))
704
 
        for revno, revision_id, what in bzrlib.log.find_touching_revisions(b, file_id):
705
 
            print "%6d %s" % (revno, what)
 
421
    takes_options = ['timezone', 'verbose']
 
422
    def run(self, timezone='original', verbose=False):
 
423
        Branch('.', lock_mode='r').write_log(show_timezone=timezone, verbose=verbose)
706
424
 
707
425
 
708
426
class cmd_ls(Command):
742
460
 
743
461
 
744
462
class cmd_ignore(Command):
745
 
    """Ignore a command or pattern
746
 
 
747
 
    To remove patterns from the ignore list, edit the .bzrignore file.
748
 
 
749
 
    If the pattern contains a slash, it is compared to the whole path
750
 
    from the branch root.  Otherwise, it is comapred to only the last
751
 
    component of the path.
752
 
 
753
 
    Ignore patterns are case-insensitive on case-insensitive systems.
754
 
 
755
 
    Note: wildcards must be quoted from the shell on Unix.
756
 
 
757
 
    examples:
758
 
        bzr ignore ./Makefile
759
 
        bzr ignore '*.class'
760
 
    """
 
463
    """Ignore a command or pattern"""
761
464
    takes_args = ['name_pattern']
762
465
    
763
466
    def run(self, name_pattern):
764
 
        from bzrlib.atomicfile import AtomicFile
765
 
        import os.path
766
 
 
767
467
        b = Branch('.')
768
 
        ifn = b.abspath('.bzrignore')
769
 
 
770
 
        if os.path.exists(ifn):
771
 
            f = open(ifn, 'rt')
772
 
            try:
773
 
                igns = f.read().decode('utf-8')
774
 
            finally:
775
 
                f.close()
776
 
        else:
777
 
            igns = ''
778
 
 
779
 
        # TODO: If the file already uses crlf-style termination, maybe
780
 
        # we should use that for the newly added lines?
781
 
 
782
 
        if igns and igns[-1] != '\n':
783
 
            igns += '\n'
784
 
        igns += name_pattern + '\n'
785
 
 
786
 
        try:
787
 
            f = AtomicFile(ifn, 'wt')
788
 
            f.write(igns.encode('utf-8'))
789
 
            f.commit()
790
 
        finally:
791
 
            f.close()
 
468
 
 
469
        # XXX: This will fail if it's a hardlink; should use an AtomicFile class.
 
470
        f = open(b.abspath('.bzrignore'), 'at')
 
471
        f.write(name_pattern + '\n')
 
472
        f.close()
792
473
 
793
474
        inv = b.working_tree().inventory
794
475
        if inv.path2id('.bzrignore'):
800
481
 
801
482
 
802
483
class cmd_ignored(Command):
803
 
    """List ignored files and the patterns that matched them.
804
 
 
805
 
    See also: bzr ignore"""
 
484
    """List ignored files and the patterns that matched them."""
806
485
    def run(self):
807
486
        tree = Branch('.').working_tree()
808
487
        for path, file_class, kind, file_id in tree.list_files():
818
497
 
819
498
    example:
820
499
        bzr lookup-revision 33
821
 
    """
 
500
        """
822
501
    hidden = True
823
502
    takes_args = ['revno']
824
503
    
837
516
    If no revision is specified this exports the last committed revision."""
838
517
    takes_args = ['dest']
839
518
    takes_options = ['revision']
840
 
    def run(self, dest, revision=None):
 
519
    def run(self, dest, revno=None):
841
520
        b = Branch('.')
842
 
        if revision == None:
843
 
            rh = b.revision_history()[-1]
 
521
        if revno == None:
 
522
            rh = b.revision_history[-1]
844
523
        else:
845
 
            rh = b.lookup_revision(int(revision))
 
524
            rh = b.lookup_revision(int(revno))
846
525
        t = b.revision_tree(rh)
847
526
        t.export(dest)
848
527
 
871
550
class cmd_commit(Command):
872
551
    """Commit changes into a new revision.
873
552
 
874
 
    If selected files are specified, only changes to those files are
875
 
    committed.  If a directory is specified then its contents are also
876
 
    committed.
877
 
 
878
 
    A selected-file commit may fail in some cases where the committed
879
 
    tree would be invalid, such as trying to commit a file in a
880
 
    newly-added directory that is not itself committed.
 
553
    TODO: Commit only selected files.
881
554
 
882
555
    TODO: Run hooks on tree to-be-committed, and after commit.
883
556
 
884
557
    TODO: Strict commit that fails if there are unknown or deleted files.
885
558
    """
886
 
    takes_args = ['selected*']
887
 
    takes_options = ['message', 'file', 'verbose']
 
559
    takes_options = ['message', 'verbose']
888
560
    aliases = ['ci', 'checkin']
889
561
 
890
 
    def run(self, message=None, file=None, verbose=True, selected_list=None):
891
 
        from bzrlib.commit import commit
892
 
 
893
 
        ## Warning: shadows builtin file()
894
 
        if not message and not file:
895
 
            raise BzrCommandError("please specify a commit message",
896
 
                                  ["use either --message or --file"])
897
 
        elif message and file:
898
 
            raise BzrCommandError("please specify either --message or --file")
899
 
        
900
 
        if file:
901
 
            import codecs
902
 
            message = codecs.open(file, 'rt', bzrlib.user_encoding).read()
903
 
 
904
 
        b = Branch('.')
905
 
        commit(b, message, verbose=verbose, specific_files=selected_list)
 
562
    def run(self, message=None, verbose=False):
 
563
        if not message:
 
564
            raise BzrCommandError("please specify a commit message")
 
565
        Branch('.').commit(message, verbose=verbose)
906
566
 
907
567
 
908
568
class cmd_check(Command):
914
574
    takes_args = ['dir?']
915
575
    def run(self, dir='.'):
916
576
        import bzrlib.check
917
 
        bzrlib.check.check(Branch(dir))
 
577
        bzrlib.check.check(Branch(dir, find_root=False))
918
578
 
919
579
 
920
580
 
933
593
    """Run internal test suite"""
934
594
    hidden = True
935
595
    def run(self):
936
 
        from bzrlib.selftest import selftest
937
 
        if selftest():
938
 
            return 0
 
596
        failures, tests = 0, 0
 
597
 
 
598
        import doctest, bzrlib.store, bzrlib.tests
 
599
        bzrlib.trace.verbose = False
 
600
 
 
601
        for m in bzrlib.store, bzrlib.inventory, bzrlib.branch, bzrlib.osutils, \
 
602
            bzrlib.tree, bzrlib.tests, bzrlib.commands, bzrlib.add:
 
603
            mf, mt = doctest.testmod(m)
 
604
            failures += mf
 
605
            tests += mt
 
606
            print '%-40s %3d tests' % (m.__name__, mt),
 
607
            if mf:
 
608
                print '%3d FAILED!' % mf
 
609
            else:
 
610
                print
 
611
 
 
612
        print '%-40s %3d tests' % ('total', tests),
 
613
        if failures:
 
614
            print '%3d FAILED!' % failures
939
615
        else:
940
 
            return 1
 
616
            print
941
617
 
942
618
 
943
619
 
948
624
 
949
625
def show_version():
950
626
    print "bzr (bazaar-ng) %s" % bzrlib.__version__
951
 
    # is bzrlib itself in a branch?
952
 
    bzrrev = bzrlib.get_bzr_revision()
953
 
    if bzrrev:
954
 
        print "  (bzr checkout, revision %d {%s})" % bzrrev
955
627
    print bzrlib.__copyright__
956
628
    print "http://bazaar-ng.org/"
957
629
    print
966
638
    def run(self):
967
639
        print "it sure does!"
968
640
 
969
 
def parse_spec(spec):
970
 
    """
971
 
    >>> parse_spec(None)
972
 
    [None, None]
973
 
    >>> parse_spec("./")
974
 
    ['./', None]
975
 
    >>> parse_spec("../@")
976
 
    ['..', -1]
977
 
    >>> parse_spec("../f/@35")
978
 
    ['../f', 35]
979
 
    """
980
 
    if spec is None:
981
 
        return [None, None]
982
 
    if '/@' in spec:
983
 
        parsed = spec.split('/@')
984
 
        assert len(parsed) == 2
985
 
        if parsed[1] == "":
986
 
            parsed[1] = -1
987
 
        else:
988
 
            parsed[1] = int(parsed[1])
989
 
            assert parsed[1] >=0
990
 
    else:
991
 
        parsed = [spec, None]
992
 
    return parsed
993
 
 
994
 
class cmd_merge(Command):
995
 
    """Perform a three-way merge of trees.
996
 
    
997
 
    The SPEC parameters are working tree or revision specifiers.  Working trees
998
 
    are specified using standard paths or urls.  No component of a directory
999
 
    path may begin with '@'.
1000
 
    
1001
 
    Working tree examples: '.', '..', 'foo@', but NOT 'foo/@bar'
1002
 
 
1003
 
    Revisions are specified using a dirname/@revno pair, where dirname is the
1004
 
    branch directory and revno is the revision within that branch.  If no revno
1005
 
    is specified, the latest revision is used.
1006
 
 
1007
 
    Revision examples: './@127', 'foo/@', '../@1'
1008
 
 
1009
 
    The OTHER_SPEC parameter is required.  If the BASE_SPEC parameter is
1010
 
    not supplied, the common ancestor of OTHER_SPEC the current branch is used
1011
 
    as the BASE.
1012
 
    """
1013
 
    takes_args = ['other_spec', 'base_spec?']
1014
 
 
1015
 
    def run(self, other_spec, base_spec=None):
1016
 
        from bzrlib.merge import merge
1017
 
        merge(parse_spec(other_spec), parse_spec(base_spec))
1018
 
 
1019
 
 
1020
 
class cmd_revert(Command):
1021
 
    """
1022
 
    Reverse all changes since the last commit.  Only versioned files are
1023
 
    affected.
1024
 
    """
1025
 
    takes_options = ['revision']
1026
 
 
1027
 
    def run(self, revision=-1):
1028
 
        merge.merge(('.', revision), parse_spec('.'), no_changes=False,
1029
 
                    ignore_zero=True)
1030
 
 
1031
641
 
1032
642
class cmd_assert_fail(Command):
1033
643
    """Test reporting of assertion failures"""
1048
658
        help.help(topic)
1049
659
 
1050
660
 
1051
 
class cmd_update_stat_cache(Command):
1052
 
    """Update stat-cache mapping inodes to SHA-1 hashes.
1053
 
 
1054
 
    For testing only."""
1055
 
    hidden = True
1056
 
    def run(self):
1057
 
        import statcache
1058
 
        b = Branch('.')
1059
 
        statcache.update_cache(b.base, b.read_working_inventory())
1060
 
 
 
661
######################################################################
 
662
# main routine
1061
663
 
1062
664
 
1063
665
# list of all available options; the rhs can be either None for an
1065
667
# the type.
1066
668
OPTIONS = {
1067
669
    'all':                    None,
1068
 
    'diff-options':           str,
1069
670
    'help':                   None,
1070
 
    'file':                   unicode,
1071
 
    'forward':                None,
1072
671
    'message':                unicode,
1073
 
    'no-recurse':             None,
1074
672
    'profile':                None,
1075
 
    'revision':               _parse_revision_str,
 
673
    'revision':               int,
1076
674
    'show-ids':               None,
1077
675
    'timezone':               str,
1078
676
    'verbose':                None,
1081
679
    }
1082
680
 
1083
681
SHORT_OPTIONS = {
1084
 
    'F':                      'file', 
1085
 
    'h':                      'help',
1086
682
    'm':                      'message',
1087
683
    'r':                      'revision',
1088
684
    'v':                      'verbose',
1222
818
            return 0
1223
819
        cmd = str(args.pop(0))
1224
820
    except IndexError:
1225
 
        import help
1226
 
        help.help()
 
821
        log_error('usage: bzr COMMAND')
 
822
        log_error('  try "bzr help"')
1227
823
        return 1
1228
 
          
1229
824
 
1230
825
    canonical_cmd, cmd_class = get_cmd_class(cmd)
1231
826
 
1240
835
    allowed = cmd_class.takes_options
1241
836
    for oname in opts:
1242
837
        if oname not in allowed:
1243
 
            raise BzrCommandError("option '--%s' is not allowed for command %r"
 
838
            raise BzrCommandError("option %r is not allowed for command %r"
1244
839
                                  % (oname, cmd))
1245
840
 
1246
841
    # mix arguments and options into one dictionary
1271
866
            os.close(pffileno)
1272
867
            os.remove(pfname)
1273
868
    else:
1274
 
        return cmd_class(cmdopts, cmdargs).status 
 
869
        cmdobj = cmd_class(cmdopts, cmdargs).status 
1275
870
 
1276
871
 
1277
872
def _report_exception(summary, quiet=False):
1319
914
            return 2
1320
915
        except Exception, e:
1321
916
            quiet = False
1322
 
            if (isinstance(e, IOError) 
1323
 
                and hasattr(e, 'errno')
1324
 
                and e.errno == errno.EPIPE):
 
917
            if isinstance(e, IOError) and e.errno == errno.EPIPE:
1325
918
                quiet = True
1326
919
                msg = 'broken pipe'
1327
920
            else: