1
# Copyright (C) 2004, 2005 by Canonical Ltd
 
 
3
# This program is free software; you can redistribute it and/or modify
 
 
4
# it under the terms of the GNU General Public License as published by
 
 
5
# the Free Software Foundation; either version 2 of the License, or
 
 
6
# (at your option) any later version.
 
 
8
# This program is distributed in the hope that it will be useful,
 
 
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
 
 
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 
 
11
# GNU General Public License for more details.
 
 
13
# You should have received a copy of the GNU General Public License
 
 
14
# along with this program; if not, write to the Free Software
 
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
 
22
from bzrlib.trace import mutter, note, log_error
 
 
23
from bzrlib.errors import bailout, BzrError, BzrCheckError, BzrCommandError
 
 
24
from bzrlib.osutils import quotefn
 
 
25
from bzrlib import Branch, Inventory, InventoryEntry, BZRDIR, \
 
 
29
def _squish_command_name(cmd):
 
 
30
    return 'cmd_' + cmd.replace('-', '_')
 
 
33
def _unsquish_command_name(cmd):
 
 
34
    assert cmd.startswith("cmd_")
 
 
35
    return cmd[4:].replace('_','-')
 
 
37
def _parse_revision_str(revstr):
 
 
38
    """This handles a revision string -> revno. 
 
 
40
    There are several possibilities:
 
 
43
        '234:345'   -> [234, 345]
 
 
47
    In the future we will also support:
 
 
48
        'uuid:blah-blah-blah'   -> ?
 
 
49
        'hash:blahblahblah'     -> ?
 
 
53
    if revstr.find(':') != -1:
 
 
54
        revs = revstr.split(':')
 
 
56
            raise ValueError('More than 2 pieces not supported for --revision: %r' % revstr)
 
 
61
            revs[0] = int(revs[0])
 
 
66
            revs[1] = int(revs[1])
 
 
72
    """Return canonical name and class for all registered commands."""
 
 
73
    for k, v in globals().iteritems():
 
 
74
        if k.startswith("cmd_"):
 
 
75
            yield _unsquish_command_name(k), v
 
 
77
def get_cmd_class(cmd):
 
 
78
    """Return the canonical name and command class for a command.
 
 
80
    cmd = str(cmd)                      # not unicode
 
 
82
    # first look up this command under the specified name
 
 
84
        return cmd, globals()[_squish_command_name(cmd)]
 
 
88
    # look for any command which claims this as an alias
 
 
89
    for cmdname, cmdclass in get_all_cmds():
 
 
90
        if cmd in cmdclass.aliases:
 
 
91
            return cmdname, cmdclass
 
 
93
    cmdclass = ExternalCommand.find_command(cmd)
 
 
97
    raise BzrCommandError("unknown command %r" % cmd)
 
 
100
class Command(object):
 
 
101
    """Base class for commands.
 
 
103
    The docstring for an actual command should give a single-line
 
 
104
    summary, then a complete description of the command.  A grammar
 
 
105
    description will be inserted.
 
 
108
        List of argument forms, marked with whether they are optional,
 
 
112
        List of options that may be given for this command.
 
 
115
        If true, this command isn't advertised.
 
 
124
    def __init__(self, options, arguments):
 
 
125
        """Construct and run the command.
 
 
127
        Sets self.status to the return value of run()."""
 
 
128
        assert isinstance(options, dict)
 
 
129
        assert isinstance(arguments, dict)
 
 
130
        cmdargs = options.copy()
 
 
131
        cmdargs.update(arguments)
 
 
132
        assert self.__doc__ != Command.__doc__, \
 
 
133
               ("No help message set for %r" % self)
 
 
134
        self.status = self.run(**cmdargs)
 
 
138
        """Override this in sub-classes.
 
 
140
        This is invoked with the options and arguments bound to
 
 
143
        Return 0 or None if the command was successful, or a shell
 
 
149
class ExternalCommand(Command):
 
 
150
    """Class to wrap external commands.
 
 
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
 
 
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.
 
 
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.
 
 
164
    def find_command(cls, cmd):
 
 
166
        bzrpath = os.environ.get('BZRPATH', '')
 
 
168
        for dir in bzrpath.split(':'):
 
 
169
            path = os.path.join(dir, cmd)
 
 
170
            if os.path.isfile(path):
 
 
171
                return ExternalCommand(path)
 
 
175
    find_command = classmethod(find_command)
 
 
177
    def __init__(self, path):
 
 
180
        # TODO: If either of these fail, we should detect that and
 
 
181
        # assume that path is not really a bzr plugin after all.
 
 
183
        pipe = os.popen('%s --bzr-usage' % path, 'r')
 
 
184
        self.takes_options = pipe.readline().split()
 
 
185
        self.takes_args = pipe.readline().split()
 
 
188
        pipe = os.popen('%s --bzr-help' % path, 'r')
 
 
189
        self.__doc__ = pipe.read()
 
 
192
    def __call__(self, options, arguments):
 
 
193
        Command.__init__(self, options, arguments)
 
 
196
    def run(self, **kargs):
 
 
204
            if OPTIONS.has_key(name):
 
 
206
                opts.append('--%s' % name)
 
 
207
                if value is not None and value is not True:
 
 
208
                    opts.append(str(value))
 
 
210
                # it's an arg, or arg list
 
 
211
                if type(value) is not list:
 
 
217
        self.status = os.spawnv(os.P_WAIT, self.path, [self.path] + opts + args)
 
 
221
class cmd_status(Command):
 
 
222
    """Display status summary.
 
 
224
    This reports on versioned and unknown files, reporting them
 
 
225
    grouped by state.  Possible states are:
 
 
228
        Versioned in the working copy but not in the previous revision.
 
 
231
        Versioned in the previous revision but removed or deleted
 
 
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.
 
 
240
        Text has changed since the previous revision.
 
 
243
        Nothing about this file has changed since the previous revision.
 
 
244
        Only shown with --all.
 
 
247
        Not versioned and not matching an ignore pattern.
 
 
249
    To see ignored files use 'bzr ignored'.  For details in the
 
 
250
    changes to file texts, use 'bzr diff'.
 
 
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.
 
 
257
    takes_args = ['file*']
 
 
258
    takes_options = ['all', 'show-ids']
 
 
259
    aliases = ['st', 'stat']
 
 
261
    def run(self, all=False, show_ids=False, file_list=None):
 
 
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
 
 
267
            if file_list == ['']:
 
 
272
        status.show_status(b, show_unchanged=all, show_ids=show_ids,
 
 
273
                           specific_files=file_list)
 
 
276
class cmd_cat_revision(Command):
 
 
277
    """Write out metadata for a revision."""
 
 
280
    takes_args = ['revision_id']
 
 
282
    def run(self, revision_id):
 
 
283
        Branch('.').get_revision(revision_id).write_xml(sys.stdout)
 
 
286
class cmd_revno(Command):
 
 
287
    """Show current revision number.
 
 
289
    This is equal to the number of revisions on this branch."""
 
 
291
        print Branch('.').revno()
 
 
294
class cmd_add(Command):
 
 
295
    """Add specified files or directories.
 
 
297
    In non-recursive mode, all the named items are added, regardless
 
 
298
    of whether they were previously ignored.  A warning is given if
 
 
299
    any of the named files are already versioned.
 
 
301
    In recursive mode (the default), files are treated the same way
 
 
302
    but the behaviour for directories is different.  Directories that
 
 
303
    are already versioned do not give a warning.  All directories,
 
 
304
    whether already versioned or not, are searched for files or
 
 
305
    subdirectories that are neither versioned or ignored, and these
 
 
306
    are added.  This search proceeds recursively into versioned
 
 
309
    Therefore simply saying 'bzr add .' will version all files that
 
 
310
    are currently unknown.
 
 
312
    TODO: Perhaps adding a file whose directly is not versioned should
 
 
313
    recursively add that parent, rather than giving an error?
 
 
315
    takes_args = ['file+']
 
 
316
    takes_options = ['verbose', 'no-recurse']
 
 
318
    def run(self, file_list, verbose=False, no_recurse=False):
 
 
319
        bzrlib.add.smart_add(file_list, verbose, not no_recurse)
 
 
322
class cmd_relpath(Command):
 
 
323
    """Show path of a file relative to root"""
 
 
324
    takes_args = ['filename']
 
 
327
    def run(self, filename):
 
 
328
        print Branch(filename).relpath(filename)
 
 
332
class cmd_inventory(Command):
 
 
333
    """Show inventory of the current working copy or a revision."""
 
 
334
    takes_options = ['revision', 'show-ids']
 
 
336
    def run(self, revision=None, show_ids=False):
 
 
339
            inv = b.read_working_inventory()
 
 
341
            inv = b.get_revision_inventory(b.lookup_revision(revision))
 
 
343
        for path, entry in inv.entries():
 
 
345
                print '%-50s %s' % (path, entry.file_id)
 
 
350
class cmd_move(Command):
 
 
351
    """Move files to a different directory.
 
 
356
    The destination must be a versioned directory in the same branch.
 
 
358
    takes_args = ['source$', 'dest']
 
 
359
    def run(self, source_list, dest):
 
 
362
        b.move([b.relpath(s) for s in source_list], b.relpath(dest))
 
 
365
class cmd_rename(Command):
 
 
366
    """Change the name of an entry.
 
 
369
      bzr rename frob.c frobber.c
 
 
370
      bzr rename src/frob.c lib/frob.c
 
 
372
    It is an error if the destination name exists.
 
 
374
    See also the 'move' command, which moves files into a different
 
 
375
    directory without changing their name.
 
 
377
    TODO: Some way to rename multiple files without invoking bzr for each
 
 
379
    takes_args = ['from_name', 'to_name']
 
 
381
    def run(self, from_name, to_name):
 
 
383
        b.rename_one(b.relpath(from_name), b.relpath(to_name))
 
 
387
class cmd_renames(Command):
 
 
388
    """Show list of renamed files.
 
 
390
    TODO: Option to show renames between two historical versions.
 
 
392
    TODO: Only show renames under dir, rather than in the whole branch.
 
 
394
    takes_args = ['dir?']
 
 
396
    def run(self, dir='.'):
 
 
398
        old_inv = b.basis_tree().inventory
 
 
399
        new_inv = b.read_working_inventory()
 
 
401
        renames = list(bzrlib.tree.find_renames(old_inv, new_inv))
 
 
403
        for old_name, new_name in renames:
 
 
404
            print "%s => %s" % (old_name, new_name)        
 
 
407
class cmd_info(Command):
 
 
408
    """Show statistical information about a branch."""
 
 
409
    takes_args = ['branch?']
 
 
411
    def run(self, branch=None):
 
 
414
        from branch import find_branch
 
 
415
        b = find_branch(branch)
 
 
419
class cmd_remove(Command):
 
 
420
    """Make a file unversioned.
 
 
422
    This makes bzr stop tracking changes to a versioned file.  It does
 
 
423
    not delete the working copy.
 
 
425
    takes_args = ['file+']
 
 
426
    takes_options = ['verbose']
 
 
428
    def run(self, file_list, verbose=False):
 
 
429
        b = Branch(file_list[0])
 
 
430
        b.remove([b.relpath(f) for f in file_list], verbose=verbose)
 
 
433
class cmd_file_id(Command):
 
 
434
    """Print file_id of a particular file or directory.
 
 
436
    The file_id is assigned when the file is first added and remains the
 
 
437
    same through all revisions where the file exists, even when it is
 
 
441
    takes_args = ['filename']
 
 
442
    def run(self, filename):
 
 
444
        i = b.inventory.path2id(b.relpath(filename))
 
 
446
            bailout("%r is not a versioned file" % filename)
 
 
451
class cmd_file_path(Command):
 
 
452
    """Print path of file_ids to a file or directory.
 
 
454
    This prints one line for each directory down to the target,
 
 
455
    starting at the branch root."""
 
 
457
    takes_args = ['filename']
 
 
458
    def run(self, filename):
 
 
461
        fid = inv.path2id(b.relpath(filename))
 
 
463
            bailout("%r is not a versioned file" % filename)
 
 
464
        for fip in inv.get_idpath(fid):
 
 
468
class cmd_revision_history(Command):
 
 
469
    """Display list of revision ids on this branch."""
 
 
472
        for patchid in Branch('.').revision_history():
 
 
476
class cmd_directories(Command):
 
 
477
    """Display list of versioned directories in this branch."""
 
 
479
        for name, ie in Branch('.').read_working_inventory().directories():
 
 
486
class cmd_init(Command):
 
 
487
    """Make a directory into a versioned branch.
 
 
489
    Use this to create an empty branch, or before importing an
 
 
492
    Recipe for importing a tree of files:
 
 
497
        bzr commit -m 'imported project'
 
 
500
        Branch('.', init=True)
 
 
503
class cmd_diff(Command):
 
 
504
    """Show differences in working tree.
 
 
506
    If files are listed, only the changes in those files are listed.
 
 
507
    Otherwise, all changes for the tree are listed.
 
 
509
    TODO: Given two revision arguments, show the difference between them.
 
 
511
    TODO: Allow diff across branches.
 
 
513
    TODO: Option to use external diff command; could be GNU diff, wdiff,
 
 
516
    TODO: Python difflib is not exactly the same as unidiff; should
 
 
517
          either fix it up or prefer to use an external diff.
 
 
519
    TODO: If a directory is given, diff everything under that.
 
 
521
    TODO: Selected-file diff is inefficient and doesn't show you
 
 
524
    TODO: This probably handles non-Unix newlines poorly.
 
 
527
    takes_args = ['file*']
 
 
528
    takes_options = ['revision', 'diff-options']
 
 
531
    def run(self, revision=None, file_list=None, diff_options=None):
 
 
532
        from bzrlib.diff import show_diff
 
 
533
        from bzrlib import find_branch
 
 
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
 
 
544
        show_diff(b, revision, specific_files=file_list,
 
 
545
                  external_diff_options=diff_options)
 
 
551
class cmd_deleted(Command):
 
 
552
    """List files deleted in the working tree.
 
 
554
    TODO: Show files deleted since a previous revision, or between two revisions.
 
 
556
    def run(self, show_ids=False):
 
 
559
        new = b.working_tree()
 
 
561
        ## TODO: Much more efficient way to do this: read in new
 
 
562
        ## directories with readdir, rather than stating each one.  Same
 
 
563
        ## level of effort but possibly much less IO.  (Or possibly not,
 
 
564
        ## if the directories are very large...)
 
 
566
        for path, ie in old.inventory.iter_entries():
 
 
567
            if not new.has_id(ie.file_id):
 
 
569
                    print '%-50s %s' % (path, ie.file_id)
 
 
574
class cmd_modified(Command):
 
 
575
    """List files modified in working tree."""
 
 
580
        inv = b.read_working_inventory()
 
 
581
        sc = statcache.update_cache(b, inv)
 
 
582
        basis = b.basis_tree()
 
 
583
        basis_inv = basis.inventory
 
 
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.
 
 
590
        for file_id in basis_inv:
 
 
591
            cacheentry = sc.get(file_id)
 
 
592
            if not cacheentry:                 # deleted
 
 
594
            ie = basis_inv[file_id]
 
 
595
            if cacheentry[statcache.SC_SHA1] != ie.text_sha1:
 
 
596
                path = inv.id2path(file_id)
 
 
601
class cmd_added(Command):
 
 
602
    """List files added in working tree."""
 
 
606
        wt = b.working_tree()
 
 
607
        basis_inv = b.basis_tree().inventory
 
 
610
            if file_id in basis_inv:
 
 
612
            path = inv.id2path(file_id)
 
 
613
            if not os.access(b.abspath(path), os.F_OK):
 
 
619
class cmd_root(Command):
 
 
620
    """Show the tree root directory.
 
 
622
    The root is the nearest enclosing directory with a .bzr control
 
 
624
    takes_args = ['filename?']
 
 
625
    def run(self, filename=None):
 
 
626
        """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')
 
 
632
class cmd_log(Command):
 
 
633
    """Show log of this branch.
 
 
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
 
 
639
    TODO: Make --revision support uuid: and hash: [future tag:] notation.
 
 
643
    takes_args = ['filename?']
 
 
644
    takes_options = ['forward', 'timezone', 'verbose', 'show-ids', 'revision']
 
 
646
    def run(self, filename=None, timezone='original',
 
 
651
        from bzrlib import show_log, find_branch
 
 
654
        direction = (forward and 'forward') or 'reverse'
 
 
657
            b = find_branch(filename)
 
 
658
            fp = b.relpath(filename)
 
 
660
                file_id = b.read_working_inventory().path2id(fp)
 
 
662
                file_id = None  # points to branch root
 
 
668
            revision = [None, None]
 
 
669
        elif isinstance(revision, int):
 
 
670
            revision = [revision, revision]
 
 
675
        assert len(revision) == 2
 
 
677
        mutter('encoding log as %r' % bzrlib.user_encoding)
 
 
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')
 
 
684
                 show_timezone=timezone,
 
 
689
                 start_revision=revision[0],
 
 
690
                 end_revision=revision[1])
 
 
694
class cmd_touching_revisions(Command):
 
 
695
    """Return revision-ids which affected a particular file.
 
 
697
    A more user-friendly interface is "bzr log FILE"."""
 
 
699
    takes_args = ["filename"]
 
 
700
    def run(self, 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)
 
 
708
class cmd_ls(Command):
 
 
709
    """List files in a tree.
 
 
711
    TODO: Take a revision or remote path and list that tree instead.
 
 
714
    def run(self, revision=None, verbose=False):
 
 
717
            tree = b.working_tree()
 
 
719
            tree = b.revision_tree(b.lookup_revision(revision))
 
 
721
        for fp, fc, kind, fid in tree.list_files():
 
 
723
                if kind == 'directory':
 
 
730
                print '%-8s %s%s' % (fc, fp, kindch)
 
 
736
class cmd_unknowns(Command):
 
 
737
    """List unknown files"""
 
 
739
        for f in Branch('.').unknowns():
 
 
744
class cmd_ignore(Command):
 
 
745
    """Ignore a command or pattern
 
 
747
    To remove patterns from the ignore list, edit the .bzrignore file.
 
 
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.
 
 
753
    Ignore patterns are case-insensitive on case-insensitive systems.
 
 
755
    Note: wildcards must be quoted from the shell on Unix.
 
 
758
        bzr ignore ./Makefile
 
 
761
    takes_args = ['name_pattern']
 
 
763
    def run(self, name_pattern):
 
 
764
        from bzrlib.atomicfile import AtomicFile
 
 
768
        ifn = b.abspath('.bzrignore')
 
 
770
        if os.path.exists(ifn):
 
 
773
                igns = f.read().decode('utf-8')
 
 
779
        # TODO: If the file already uses crlf-style termination, maybe
 
 
780
        # we should use that for the newly added lines?
 
 
782
        if igns and igns[-1] != '\n':
 
 
784
        igns += name_pattern + '\n'
 
 
787
            f = AtomicFile(ifn, 'wt')
 
 
788
            f.write(igns.encode('utf-8'))
 
 
793
        inv = b.working_tree().inventory
 
 
794
        if inv.path2id('.bzrignore'):
 
 
795
            mutter('.bzrignore is already versioned')
 
 
797
            mutter('need to make new .bzrignore file versioned')
 
 
798
            b.add(['.bzrignore'])
 
 
802
class cmd_ignored(Command):
 
 
803
    """List ignored files and the patterns that matched them.
 
 
805
    See also: bzr ignore"""
 
 
807
        tree = Branch('.').working_tree()
 
 
808
        for path, file_class, kind, file_id in tree.list_files():
 
 
809
            if file_class != 'I':
 
 
811
            ## XXX: Slightly inefficient since this was already calculated
 
 
812
            pat = tree.is_ignored(path)
 
 
813
            print '%-50s %s' % (path, pat)
 
 
816
class cmd_lookup_revision(Command):
 
 
817
    """Lookup the revision-id from a revision-number
 
 
820
        bzr lookup-revision 33
 
 
823
    takes_args = ['revno']
 
 
825
    def run(self, revno):
 
 
829
            raise BzrCommandError("not a valid revision-number: %r" % revno)
 
 
831
        print Branch('.').lookup_revision(revno)
 
 
834
class cmd_export(Command):
 
 
835
    """Export past revision to destination directory.
 
 
837
    If no revision is specified this exports the last committed revision."""
 
 
838
    takes_args = ['dest']
 
 
839
    takes_options = ['revision']
 
 
840
    def run(self, dest, revision=None):
 
 
843
            rh = b.revision_history()[-1]
 
 
845
            rh = b.lookup_revision(int(revision))
 
 
846
        t = b.revision_tree(rh)
 
 
850
class cmd_cat(Command):
 
 
851
    """Write a file's text from a previous revision."""
 
 
853
    takes_options = ['revision']
 
 
854
    takes_args = ['filename']
 
 
856
    def run(self, filename, revision=None):
 
 
858
            raise BzrCommandError("bzr cat requires a revision number")
 
 
860
        b.print_file(b.relpath(filename), int(revision))
 
 
863
class cmd_local_time_offset(Command):
 
 
864
    """Show the offset in seconds from GMT to local time."""
 
 
867
        print bzrlib.osutils.local_time_offset()
 
 
871
class cmd_commit(Command):
 
 
872
    """Commit changes into a new revision.
 
 
874
    If selected files are specified, only changes to those files are
 
 
875
    committed.  If a directory is specified then its contents are also
 
 
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.
 
 
882
    TODO: Run hooks on tree to-be-committed, and after commit.
 
 
884
    TODO: Strict commit that fails if there are unknown or deleted files.
 
 
886
    takes_args = ['selected*']
 
 
887
    takes_options = ['message', 'file', 'verbose']
 
 
888
    aliases = ['ci', 'checkin']
 
 
890
    def run(self, message=None, file=None, verbose=True, selected_list=None):
 
 
891
        from bzrlib.commit import commit
 
 
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")
 
 
902
            message = codecs.open(file, 'rt', bzrlib.user_encoding).read()
 
 
905
        commit(b, message, verbose=verbose, specific_files=selected_list)
 
 
908
class cmd_check(Command):
 
 
909
    """Validate consistency of branch history.
 
 
911
    This command checks various invariants about the branch storage to
 
 
912
    detect data corruption or bzr bugs.
 
 
914
    takes_args = ['dir?']
 
 
915
    def run(self, dir='.'):
 
 
917
        bzrlib.check.check(Branch(dir))
 
 
921
class cmd_whoami(Command):
 
 
922
    """Show bzr user id."""
 
 
923
    takes_options = ['email']
 
 
925
    def run(self, email=False):
 
 
927
            print bzrlib.osutils.user_email()
 
 
929
            print bzrlib.osutils.username()
 
 
932
class cmd_selftest(Command):
 
 
933
    """Run internal test suite"""
 
 
936
        from bzrlib.selftest import selftest
 
 
944
class cmd_version(Command):
 
 
945
    """Show version of bzr"""
 
 
950
    print "bzr (bazaar-ng) %s" % bzrlib.__version__
 
 
951
    # is bzrlib itself in a branch?
 
 
952
    bzrrev = bzrlib.get_bzr_revision()
 
 
954
        print "  (bzr checkout, revision %d {%s})" % bzrrev
 
 
955
    print bzrlib.__copyright__
 
 
956
    print "http://bazaar-ng.org/"
 
 
958
    print "bzr comes with ABSOLUTELY NO WARRANTY.  bzr is free software, and"
 
 
959
    print "you may use, modify and redistribute it under the terms of the GNU"
 
 
960
    print "General Public License version 2 or later."
 
 
963
class cmd_rocks(Command):
 
 
964
    """Statement of optimism."""
 
 
967
        print "it sure does!"
 
 
969
def parse_spec(spec):
 
 
971
        parsed = spec.split('/@')
 
 
972
        assert len(parsed) == 2
 
 
976
            parsed[1] = int(parsed[1])
 
 
979
        parsed = [spec, None]
 
 
982
class cmd_merge(Command):
 
 
983
    """Perform a three-way merge of trees."""
 
 
984
    takes_args = ['other_spec', 'base_spec']
 
 
986
    def run(self, other_spec, base_spec):
 
 
987
        from bzrlib.merge import merge
 
 
988
        merge(parse_spec(other_spec), parse_spec(base_spec))
 
 
990
class cmd_assert_fail(Command):
 
 
991
    """Test reporting of assertion failures"""
 
 
994
        assert False, "always fails"
 
 
997
class cmd_help(Command):
 
 
998
    """Show help on a command or other topic.
 
 
1000
    For a list of all available commands, say 'bzr help commands'."""
 
 
1001
    takes_args = ['topic?']
 
 
1004
    def run(self, topic=None):
 
 
1009
class cmd_update_stat_cache(Command):
 
 
1010
    """Update stat-cache mapping inodes to SHA-1 hashes.
 
 
1012
    For testing only."""
 
 
1017
        statcache.update_cache(b.base, b.read_working_inventory())
 
 
1021
# list of all available options; the rhs can be either None for an
 
 
1022
# option that takes no argument, or a constructor function that checks
 
 
1026
    'diff-options':           str,
 
 
1033
    'revision':               _parse_revision_str,
 
 
1050
def parse_args(argv):
 
 
1051
    """Parse command line.
 
 
1053
    Arguments and options are parsed at this level before being passed
 
 
1054
    down to specific command handlers.  This routine knows, from a
 
 
1055
    lookup table, something about the available options, what optargs
 
 
1056
    they take, and which commands will accept them.
 
 
1058
    >>> parse_args('--help'.split())
 
 
1059
    ([], {'help': True})
 
 
1060
    >>> parse_args('--version'.split())
 
 
1061
    ([], {'version': True})
 
 
1062
    >>> parse_args('status --all'.split())
 
 
1063
    (['status'], {'all': True})
 
 
1064
    >>> parse_args('commit --message=biter'.split())
 
 
1065
    (['commit'], {'message': u'biter'})
 
 
1070
    # TODO: Maybe handle '--' to end options?
 
 
1075
            # option names must not be unicode
 
 
1079
                mutter("  got option %r" % a)
 
 
1081
                    optname, optarg = a[2:].split('=', 1)
 
 
1084
                if optname not in OPTIONS:
 
 
1085
                    bailout('unknown long option %r' % a)
 
 
1088
                if shortopt not in SHORT_OPTIONS:
 
 
1089
                    bailout('unknown short option %r' % a)
 
 
1090
                optname = SHORT_OPTIONS[shortopt]
 
 
1093
                # XXX: Do we ever want to support this, e.g. for -r?
 
 
1094
                bailout('repeated option %r' % a)
 
 
1096
            optargfn = OPTIONS[optname]
 
 
1100
                        bailout('option %r needs an argument' % a)
 
 
1102
                        optarg = argv.pop(0)
 
 
1103
                opts[optname] = optargfn(optarg)
 
 
1106
                    bailout('option %r takes no argument' % optname)
 
 
1107
                opts[optname] = True
 
 
1116
def _match_argform(cmd, takes_args, args):
 
 
1119
    # step through args and takes_args, allowing appropriate 0-many matches
 
 
1120
    for ap in takes_args:
 
 
1124
                argdict[argname] = args.pop(0)
 
 
1125
        elif ap[-1] == '*': # all remaining arguments
 
 
1127
                argdict[argname + '_list'] = args[:]
 
 
1130
                argdict[argname + '_list'] = None
 
 
1133
                raise BzrCommandError("command %r needs one or more %s"
 
 
1134
                        % (cmd, argname.upper()))
 
 
1136
                argdict[argname + '_list'] = args[:]
 
 
1138
        elif ap[-1] == '$': # all but one
 
 
1140
                raise BzrCommandError("command %r needs one or more %s"
 
 
1141
                        % (cmd, argname.upper()))
 
 
1142
            argdict[argname + '_list'] = args[:-1]
 
 
1148
                raise BzrCommandError("command %r requires argument %s"
 
 
1149
                        % (cmd, argname.upper()))
 
 
1151
                argdict[argname] = args.pop(0)
 
 
1154
        raise BzrCommandError("extra argument to command %s: %s"
 
 
1162
    """Execute a command.
 
 
1164
    This is similar to main(), but without all the trappings for
 
 
1165
    logging and error handling.  
 
 
1167
    argv = [a.decode(bzrlib.user_encoding) for a in argv]
 
 
1170
        args, opts = parse_args(argv[1:])
 
 
1178
        elif 'version' in opts:
 
 
1181
        cmd = str(args.pop(0))
 
 
1188
    canonical_cmd, cmd_class = get_cmd_class(cmd)
 
 
1191
    if 'profile' in opts:
 
 
1197
    # check options are reasonable
 
 
1198
    allowed = cmd_class.takes_options
 
 
1200
        if oname not in allowed:
 
 
1201
            raise BzrCommandError("option '--%s' is not allowed for command %r"
 
 
1204
    # mix arguments and options into one dictionary
 
 
1205
    cmdargs = _match_argform(cmd, cmd_class.takes_args, args)
 
 
1207
    for k, v in opts.items():
 
 
1208
        cmdopts[k.replace('-', '_')] = v
 
 
1211
        import hotshot, tempfile
 
 
1212
        pffileno, pfname = tempfile.mkstemp()
 
 
1214
            prof = hotshot.Profile(pfname)
 
 
1215
            ret = prof.runcall(cmd_class, cmdopts, cmdargs) or 0
 
 
1218
            import hotshot.stats
 
 
1219
            stats = hotshot.stats.load(pfname)
 
 
1221
            stats.sort_stats('time')
 
 
1222
            ## XXX: Might like to write to stderr or the trace file instead but
 
 
1223
            ## print_stats seems hardcoded to stdout
 
 
1224
            stats.print_stats(20)
 
 
1232
        return cmd_class(cmdopts, cmdargs).status 
 
 
1235
def _report_exception(summary, quiet=False):
 
 
1237
    log_error('bzr: ' + summary)
 
 
1238
    bzrlib.trace.log_exception()
 
 
1241
        tb = sys.exc_info()[2]
 
 
1242
        exinfo = traceback.extract_tb(tb)
 
 
1244
            sys.stderr.write('  at %s:%d in %s()\n' % exinfo[-1][:3])
 
 
1245
        sys.stderr.write('  see ~/.bzr.log for debug information\n')
 
 
1252
    bzrlib.open_tracefile(argv)
 
 
1257
                return run_bzr(argv)
 
 
1259
                # do this here inside the exception wrappers to catch EPIPE
 
 
1262
            quiet = isinstance(e, (BzrCommandError))
 
 
1263
            _report_exception('error: ' + e.args[0], quiet=quiet)
 
 
1266
                    # some explanation or hints
 
 
1269
        except AssertionError, e:
 
 
1270
            msg = 'assertion failed'
 
 
1272
                msg += ': ' + str(e)
 
 
1273
            _report_exception(msg)
 
 
1275
        except KeyboardInterrupt, e:
 
 
1276
            _report_exception('interrupted', quiet=True)
 
 
1278
        except Exception, e:
 
 
1280
            if (isinstance(e, IOError) 
 
 
1281
                and hasattr(e, 'errno')
 
 
1282
                and e.errno == errno.EPIPE):
 
 
1286
                msg = str(e).rstrip('\n')
 
 
1287
            _report_exception(msg, quiet)
 
 
1290
        bzrlib.trace.close_trace()
 
 
1293
if __name__ == '__main__':
 
 
1294
    sys.exit(main(sys.argv))