/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to bzrlib/builtins.py

  • Committer: Aaron Bentley
  • Date: 2006-03-28 20:53:12 UTC
  • mto: (1634.1.1 integration)
  • mto: This revision was merged to the branch mainline in revision 1635.
  • Revision ID: abentley@panoramicfeedback.com-20060328205312-914ba2c0e85bda7c
Handle lockdirs over NFS properly

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/builtins.py
 
1
# Copyright (C) 2004, 2005, 2006 by Canonical Ltd
 
2
 
 
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.
 
7
 
 
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.
 
12
 
 
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
 
16
 
 
17
"""builtin bzr commands"""
 
18
 
 
19
 
 
20
import errno
 
21
import os
 
22
from shutil import rmtree
 
23
import sys
 
24
 
 
25
import bzrlib
 
26
import bzrlib.branch
 
27
from bzrlib.branch import Branch
 
28
import bzrlib.bzrdir as bzrdir
 
29
from bzrlib.commands import Command, display_command
 
30
from bzrlib.revision import common_ancestor
 
31
import bzrlib.errors as errors
 
32
from bzrlib.errors import (BzrError, BzrCheckError, BzrCommandError, 
 
33
                           NotBranchError, DivergedBranches, NotConflicted,
 
34
                           NoSuchFile, NoWorkingTree, FileInWrongBranch,
 
35
                           NotVersionedError)
 
36
from bzrlib.log import show_one_log
 
37
from bzrlib.merge import Merge3Merger
 
38
from bzrlib.option import Option
 
39
from bzrlib.progress import DummyProgress, ProgressPhase
 
40
from bzrlib.revisionspec import RevisionSpec
 
41
import bzrlib.trace
 
42
from bzrlib.trace import mutter, note, log_error, warning, is_quiet
 
43
from bzrlib.transport.local import LocalTransport
 
44
import bzrlib.ui
 
45
from bzrlib.workingtree import WorkingTree
 
46
 
 
47
 
 
48
def tree_files(file_list, default_branch=u'.'):
 
49
    try:
 
50
        return internal_tree_files(file_list, default_branch)
 
51
    except FileInWrongBranch, e:
 
52
        raise BzrCommandError("%s is not in the same branch as %s" %
 
53
                             (e.path, file_list[0]))
 
54
 
 
55
def internal_tree_files(file_list, default_branch=u'.'):
 
56
    """\
 
57
    Return a branch and list of branch-relative paths.
 
58
    If supplied file_list is empty or None, the branch default will be used,
 
59
    and returned file_list will match the original.
 
60
    """
 
61
    if file_list is None or len(file_list) == 0:
 
62
        return WorkingTree.open_containing(default_branch)[0], file_list
 
63
    tree = WorkingTree.open_containing(file_list[0])[0]
 
64
    new_list = []
 
65
    for filename in file_list:
 
66
        try:
 
67
            new_list.append(tree.relpath(filename))
 
68
        except errors.PathNotChild:
 
69
            raise FileInWrongBranch(tree.branch, filename)
 
70
    return tree, new_list
 
71
 
 
72
 
 
73
def get_format_type(typestring):
 
74
    """Parse and return a format specifier."""
 
75
    if typestring == "metadir":
 
76
        return bzrdir.BzrDirMetaFormat1()
 
77
    if typestring == "knit":
 
78
        format = bzrdir.BzrDirMetaFormat1()
 
79
        format.repository_format = bzrlib.repository.RepositoryFormatKnit1()
 
80
        return format
 
81
    msg = "No known bzr-dir format %s. Supported types are: metadir\n" %\
 
82
        (typestring)
 
83
    raise BzrCommandError(msg)
 
84
 
 
85
 
 
86
# TODO: Make sure no commands unconditionally use the working directory as a
 
87
# branch.  If a filename argument is used, the first of them should be used to
 
88
# specify the branch.  (Perhaps this can be factored out into some kind of
 
89
# Argument class, representing a file in a branch, where the first occurrence
 
90
# opens the branch?)
 
91
 
 
92
class cmd_status(Command):
 
93
    """Display status summary.
 
94
 
 
95
    This reports on versioned and unknown files, reporting them
 
96
    grouped by state.  Possible states are:
 
97
 
 
98
    added
 
99
        Versioned in the working copy but not in the previous revision.
 
100
 
 
101
    removed
 
102
        Versioned in the previous revision but removed or deleted
 
103
        in the working copy.
 
104
 
 
105
    renamed
 
106
        Path of this file changed from the previous revision;
 
107
        the text may also have changed.  This includes files whose
 
108
        parent directory was renamed.
 
109
 
 
110
    modified
 
111
        Text has changed since the previous revision.
 
112
 
 
113
    unchanged
 
114
        Nothing about this file has changed since the previous revision.
 
115
        Only shown with --all.
 
116
 
 
117
    unknown
 
118
        Not versioned and not matching an ignore pattern.
 
119
 
 
120
    To see ignored files use 'bzr ignored'.  For details in the
 
121
    changes to file texts, use 'bzr diff'.
 
122
 
 
123
    If no arguments are specified, the status of the entire working
 
124
    directory is shown.  Otherwise, only the status of the specified
 
125
    files or directories is reported.  If a directory is given, status
 
126
    is reported for everything inside that directory.
 
127
 
 
128
    If a revision argument is given, the status is calculated against
 
129
    that revision, or between two revisions if two are provided.
 
130
    """
 
131
    
 
132
    # TODO: --no-recurse, --recurse options
 
133
    
 
134
    takes_args = ['file*']
 
135
    takes_options = ['all', 'show-ids', 'revision']
 
136
    aliases = ['st', 'stat']
 
137
    
 
138
    @display_command
 
139
    def run(self, all=False, show_ids=False, file_list=None, revision=None):
 
140
        tree, file_list = tree_files(file_list)
 
141
            
 
142
        from bzrlib.status import show_tree_status
 
143
        show_tree_status(tree, show_unchanged=all, show_ids=show_ids,
 
144
                         specific_files=file_list, revision=revision)
 
145
 
 
146
 
 
147
class cmd_cat_revision(Command):
 
148
    """Write out metadata for a revision.
 
149
    
 
150
    The revision to print can either be specified by a specific
 
151
    revision identifier, or you can use --revision.
 
152
    """
 
153
 
 
154
    hidden = True
 
155
    takes_args = ['revision_id?']
 
156
    takes_options = ['revision']
 
157
    
 
158
    @display_command
 
159
    def run(self, revision_id=None, revision=None):
 
160
 
 
161
        if revision_id is not None and revision is not None:
 
162
            raise BzrCommandError('You can only supply one of revision_id or --revision')
 
163
        if revision_id is None and revision is None:
 
164
            raise BzrCommandError('You must supply either --revision or a revision_id')
 
165
        b = WorkingTree.open_containing(u'.')[0].branch
 
166
        if revision_id is not None:
 
167
            sys.stdout.write(b.repository.get_revision_xml(revision_id))
 
168
        elif revision is not None:
 
169
            for rev in revision:
 
170
                if rev is None:
 
171
                    raise BzrCommandError('You cannot specify a NULL revision.')
 
172
                revno, rev_id = rev.in_history(b)
 
173
                sys.stdout.write(b.repository.get_revision_xml(rev_id))
 
174
    
 
175
 
 
176
class cmd_revno(Command):
 
177
    """Show current revision number.
 
178
 
 
179
    This is equal to the number of revisions on this branch."""
 
180
    takes_args = ['location?']
 
181
    @display_command
 
182
    def run(self, location=u'.'):
 
183
        print Branch.open_containing(location)[0].revno()
 
184
 
 
185
 
 
186
class cmd_revision_info(Command):
 
187
    """Show revision number and revision id for a given revision identifier.
 
188
    """
 
189
    hidden = True
 
190
    takes_args = ['revision_info*']
 
191
    takes_options = ['revision']
 
192
    @display_command
 
193
    def run(self, revision=None, revision_info_list=[]):
 
194
 
 
195
        revs = []
 
196
        if revision is not None:
 
197
            revs.extend(revision)
 
198
        if revision_info_list is not None:
 
199
            for rev in revision_info_list:
 
200
                revs.append(RevisionSpec(rev))
 
201
        if len(revs) == 0:
 
202
            raise BzrCommandError('You must supply a revision identifier')
 
203
 
 
204
        b = WorkingTree.open_containing(u'.')[0].branch
 
205
 
 
206
        for rev in revs:
 
207
            revinfo = rev.in_history(b)
 
208
            if revinfo.revno is None:
 
209
                print '     %s' % revinfo.rev_id
 
210
            else:
 
211
                print '%4d %s' % (revinfo.revno, revinfo.rev_id)
 
212
 
 
213
    
 
214
class cmd_add(Command):
 
215
    """Add specified files or directories.
 
216
 
 
217
    In non-recursive mode, all the named items are added, regardless
 
218
    of whether they were previously ignored.  A warning is given if
 
219
    any of the named files are already versioned.
 
220
 
 
221
    In recursive mode (the default), files are treated the same way
 
222
    but the behaviour for directories is different.  Directories that
 
223
    are already versioned do not give a warning.  All directories,
 
224
    whether already versioned or not, are searched for files or
 
225
    subdirectories that are neither versioned or ignored, and these
 
226
    are added.  This search proceeds recursively into versioned
 
227
    directories.  If no names are given '.' is assumed.
 
228
 
 
229
    Therefore simply saying 'bzr add' will version all files that
 
230
    are currently unknown.
 
231
 
 
232
    Adding a file whose parent directory is not versioned will
 
233
    implicitly add the parent, and so on up to the root. This means
 
234
    you should never need to explictly add a directory, they'll just
 
235
    get added when you add a file in the directory.
 
236
 
 
237
    --dry-run will show which files would be added, but not actually 
 
238
    add them.
 
239
    """
 
240
    takes_args = ['file*']
 
241
    takes_options = ['no-recurse', 'dry-run', 'verbose']
 
242
 
 
243
    def run(self, file_list, no_recurse=False, dry_run=False, verbose=False):
 
244
        import bzrlib.add
 
245
 
 
246
        if dry_run:
 
247
            if is_quiet():
 
248
                # This is pointless, but I'd rather not raise an error
 
249
                action = bzrlib.add.add_action_null
 
250
            else:
 
251
                action = bzrlib.add.add_action_print
 
252
        elif is_quiet():
 
253
            action = bzrlib.add.add_action_add
 
254
        else:
 
255
            action = bzrlib.add.add_action_add_and_print
 
256
 
 
257
        added, ignored = bzrlib.add.smart_add(file_list, not no_recurse, 
 
258
                                              action)
 
259
        if len(ignored) > 0:
 
260
            for glob in sorted(ignored.keys()):
 
261
                match_len = len(ignored[glob])
 
262
                if verbose:
 
263
                    for path in ignored[glob]:
 
264
                        print "ignored %s matching \"%s\"" % (path, glob)
 
265
                else:
 
266
                    print "ignored %d file(s) matching \"%s\"" % (match_len,
 
267
                                                              glob)
 
268
            print "If you wish to add some of these files, please add them"\
 
269
                " by name."
 
270
 
 
271
 
 
272
class cmd_mkdir(Command):
 
273
    """Create a new versioned directory.
 
274
 
 
275
    This is equivalent to creating the directory and then adding it.
 
276
    """
 
277
    takes_args = ['dir+']
 
278
 
 
279
    def run(self, dir_list):
 
280
        for d in dir_list:
 
281
            os.mkdir(d)
 
282
            wt, dd = WorkingTree.open_containing(d)
 
283
            wt.add([dd])
 
284
            print 'added', d
 
285
 
 
286
 
 
287
class cmd_relpath(Command):
 
288
    """Show path of a file relative to root"""
 
289
    takes_args = ['filename']
 
290
    hidden = True
 
291
    
 
292
    @display_command
 
293
    def run(self, filename):
 
294
        tree, relpath = WorkingTree.open_containing(filename)
 
295
        print relpath
 
296
 
 
297
 
 
298
class cmd_inventory(Command):
 
299
    """Show inventory of the current working copy or a revision.
 
300
 
 
301
    It is possible to limit the output to a particular entry
 
302
    type using the --kind option.  For example; --kind file.
 
303
    """
 
304
    takes_options = ['revision', 'show-ids', 'kind']
 
305
    
 
306
    @display_command
 
307
    def run(self, revision=None, show_ids=False, kind=None):
 
308
        if kind and kind not in ['file', 'directory', 'symlink']:
 
309
            raise BzrCommandError('invalid kind specified')
 
310
        tree = WorkingTree.open_containing(u'.')[0]
 
311
        if revision is None:
 
312
            inv = tree.read_working_inventory()
 
313
        else:
 
314
            if len(revision) > 1:
 
315
                raise BzrCommandError('bzr inventory --revision takes'
 
316
                    ' exactly one revision identifier')
 
317
            inv = tree.branch.repository.get_revision_inventory(
 
318
                revision[0].in_history(tree.branch).rev_id)
 
319
 
 
320
        for path, entry in inv.entries():
 
321
            if kind and kind != entry.kind:
 
322
                continue
 
323
            if show_ids:
 
324
                print '%-50s %s' % (path, entry.file_id)
 
325
            else:
 
326
                print path
 
327
 
 
328
 
 
329
class cmd_mv(Command):
 
330
    """Move or rename a file.
 
331
 
 
332
    usage:
 
333
        bzr mv OLDNAME NEWNAME
 
334
        bzr mv SOURCE... DESTINATION
 
335
 
 
336
    If the last argument is a versioned directory, all the other names
 
337
    are moved into it.  Otherwise, there must be exactly two arguments
 
338
    and the file is changed to a new name, which must not already exist.
 
339
 
 
340
    Files cannot be moved between branches.
 
341
    """
 
342
    takes_args = ['names*']
 
343
    aliases = ['move', 'rename']
 
344
 
 
345
    def run(self, names_list):
 
346
        if len(names_list) < 2:
 
347
            raise BzrCommandError("missing file argument")
 
348
        tree, rel_names = tree_files(names_list)
 
349
        
 
350
        if os.path.isdir(names_list[-1]):
 
351
            # move into existing directory
 
352
            for pair in tree.move(rel_names[:-1], rel_names[-1]):
 
353
                print "%s => %s" % pair
 
354
        else:
 
355
            if len(names_list) != 2:
 
356
                raise BzrCommandError('to mv multiple files the destination '
 
357
                                      'must be a versioned directory')
 
358
            tree.rename_one(rel_names[0], rel_names[1])
 
359
            print "%s => %s" % (rel_names[0], rel_names[1])
 
360
            
 
361
    
 
362
class cmd_pull(Command):
 
363
    """Pull any changes from another branch into the current one.
 
364
 
 
365
    If there is no default location set, the first pull will set it.  After
 
366
    that, you can omit the location to use the default.  To change the
 
367
    default, use --remember.
 
368
 
 
369
    This command only works on branches that have not diverged.  Branches are
 
370
    considered diverged if both branches have had commits without first
 
371
    pulling from the other.
 
372
 
 
373
    If branches have diverged, you can use 'bzr merge' to pull the text changes
 
374
    from one into the other.  Once one branch has merged, the other should
 
375
    be able to pull it again.
 
376
 
 
377
    If you want to forget your local changes and just update your branch to
 
378
    match the remote one, use --overwrite.
 
379
    """
 
380
    takes_options = ['remember', 'overwrite', 'revision', 'verbose']
 
381
    takes_args = ['location?']
 
382
 
 
383
    def run(self, location=None, remember=False, overwrite=False, revision=None, verbose=False):
 
384
        # FIXME: too much stuff is in the command class
 
385
        try:
 
386
            tree_to = WorkingTree.open_containing(u'.')[0]
 
387
            branch_to = tree_to.branch
 
388
        except NoWorkingTree:
 
389
            tree_to = None
 
390
            branch_to = Branch.open_containing(u'.')[0] 
 
391
        stored_loc = branch_to.get_parent()
 
392
        if location is None:
 
393
            if stored_loc is None:
 
394
                raise BzrCommandError("No pull location known or specified.")
 
395
            else:
 
396
                print "Using saved location: %s" % stored_loc
 
397
                location = stored_loc
 
398
 
 
399
        br_from = Branch.open(location)
 
400
 
 
401
        if revision is None:
 
402
            rev_id = None
 
403
        elif len(revision) == 1:
 
404
            rev_id = revision[0].in_history(br_from).rev_id
 
405
        else:
 
406
            raise BzrCommandError('bzr pull --revision takes one value.')
 
407
 
 
408
        old_rh = branch_to.revision_history()
 
409
        if tree_to is not None:
 
410
            count = tree_to.pull(br_from, overwrite, rev_id)
 
411
        else:
 
412
            count = branch_to.pull(br_from, overwrite, rev_id)
 
413
 
 
414
        if branch_to.get_parent() is None or remember:
 
415
            branch_to.set_parent(location)
 
416
        note('%d revision(s) pulled.' % (count,))
 
417
 
 
418
        if verbose:
 
419
            new_rh = branch_to.revision_history()
 
420
            if old_rh != new_rh:
 
421
                # Something changed
 
422
                from bzrlib.log import show_changed_revisions
 
423
                show_changed_revisions(branch_to, old_rh, new_rh)
 
424
 
 
425
 
 
426
class cmd_push(Command):
 
427
    """Push this branch into another branch.
 
428
    
 
429
    The remote branch will not have its working tree populated because this
 
430
    is both expensive, and may not be supported on the remote file system.
 
431
    
 
432
    Some smart servers or protocols *may* put the working tree in place.
 
433
 
 
434
    If there is no default push location set, the first push will set it.
 
435
    After that, you can omit the location to use the default.  To change the
 
436
    default, use --remember.
 
437
 
 
438
    This command only works on branches that have not diverged.  Branches are
 
439
    considered diverged if the branch being pushed to is not an older version
 
440
    of this branch.
 
441
 
 
442
    If branches have diverged, you can use 'bzr push --overwrite' to replace
 
443
    the other branch completely.
 
444
    
 
445
    If you want to ensure you have the different changes in the other branch,
 
446
    do a merge (see bzr help merge) from the other branch, and commit that
 
447
    before doing a 'push --overwrite'.
 
448
    """
 
449
    takes_options = ['remember', 'overwrite', 
 
450
                     Option('create-prefix', 
 
451
                            help='Create the path leading up to the branch '
 
452
                                 'if it does not already exist')]
 
453
    takes_args = ['location?']
 
454
 
 
455
    def run(self, location=None, remember=False, overwrite=False,
 
456
            create_prefix=False, verbose=False):
 
457
        # FIXME: Way too big!  Put this into a function called from the
 
458
        # command.
 
459
        from bzrlib.transport import get_transport
 
460
        
 
461
        tree_from = WorkingTree.open_containing(u'.')[0]
 
462
        br_from = tree_from.branch
 
463
        stored_loc = tree_from.branch.get_push_location()
 
464
        if location is None:
 
465
            if stored_loc is None:
 
466
                raise BzrCommandError("No push location known or specified.")
 
467
            else:
 
468
                print "Using saved location: %s" % stored_loc
 
469
                location = stored_loc
 
470
        try:
 
471
            dir_to = bzrlib.bzrdir.BzrDir.open(location)
 
472
            br_to = dir_to.open_branch()
 
473
        except NotBranchError:
 
474
            # create a branch.
 
475
            transport = get_transport(location).clone('..')
 
476
            if not create_prefix:
 
477
                try:
 
478
                    transport.mkdir(transport.relpath(location))
 
479
                except NoSuchFile:
 
480
                    raise BzrCommandError("Parent directory of %s "
 
481
                                          "does not exist." % location)
 
482
            else:
 
483
                current = transport.base
 
484
                needed = [(transport, transport.relpath(location))]
 
485
                while needed:
 
486
                    try:
 
487
                        transport, relpath = needed[-1]
 
488
                        transport.mkdir(relpath)
 
489
                        needed.pop()
 
490
                    except NoSuchFile:
 
491
                        new_transport = transport.clone('..')
 
492
                        needed.append((new_transport,
 
493
                                       new_transport.relpath(transport.base)))
 
494
                        if new_transport.base == transport.base:
 
495
                            raise BzrCommandError("Could not creeate "
 
496
                                                  "path prefix.")
 
497
            dir_to = br_from.bzrdir.clone(location)
 
498
            br_to = dir_to.open_branch()
 
499
        old_rh = br_to.revision_history()
 
500
        try:
 
501
            try:
 
502
                tree_to = dir_to.open_workingtree()
 
503
            except errors.NotLocalUrl:
 
504
                # TODO: This should be updated for branches which don't have a
 
505
                # working tree, as opposed to ones where we just couldn't 
 
506
                # update the tree.
 
507
                warning('This transport does not update the working '
 
508
                        'tree of: %s' % (br_to.base,))
 
509
                count = br_to.pull(br_from, overwrite)
 
510
            except NoWorkingTree:
 
511
                count = br_to.pull(br_from, overwrite)
 
512
            else:
 
513
                count = tree_to.pull(br_from, overwrite)
 
514
        except DivergedBranches:
 
515
            raise BzrCommandError("These branches have diverged."
 
516
                                  "  Try a merge then push with overwrite.")
 
517
        if br_from.get_push_location() is None or remember:
 
518
            br_from.set_push_location(location)
 
519
        note('%d revision(s) pushed.' % (count,))
 
520
 
 
521
        if verbose:
 
522
            new_rh = br_to.revision_history()
 
523
            if old_rh != new_rh:
 
524
                # Something changed
 
525
                from bzrlib.log import show_changed_revisions
 
526
                show_changed_revisions(br_to, old_rh, new_rh)
 
527
 
 
528
 
 
529
class cmd_branch(Command):
 
530
    """Create a new copy of a branch.
 
531
 
 
532
    If the TO_LOCATION is omitted, the last component of the FROM_LOCATION will
 
533
    be used.  In other words, "branch ../foo/bar" will attempt to create ./bar.
 
534
 
 
535
    To retrieve the branch as of a particular revision, supply the --revision
 
536
    parameter, as in "branch foo/bar -r 5".
 
537
 
 
538
    --basis is to speed up branching from remote branches.  When specified, it
 
539
    copies all the file-contents, inventory and revision data from the basis
 
540
    branch before copying anything from the remote branch.
 
541
    """
 
542
    takes_args = ['from_location', 'to_location?']
 
543
    takes_options = ['revision', 'basis']
 
544
    aliases = ['get', 'clone']
 
545
 
 
546
    def run(self, from_location, to_location=None, revision=None, basis=None):
 
547
        if revision is None:
 
548
            revision = [None]
 
549
        elif len(revision) > 1:
 
550
            raise BzrCommandError(
 
551
                'bzr branch --revision takes exactly 1 revision value')
 
552
        try:
 
553
            br_from = Branch.open(from_location)
 
554
        except OSError, e:
 
555
            if e.errno == errno.ENOENT:
 
556
                raise BzrCommandError('Source location "%s" does not'
 
557
                                      ' exist.' % to_location)
 
558
            else:
 
559
                raise
 
560
        br_from.lock_read()
 
561
        try:
 
562
            if basis is not None:
 
563
                basis_dir = bzrdir.BzrDir.open_containing(basis)[0]
 
564
            else:
 
565
                basis_dir = None
 
566
            if len(revision) == 1 and revision[0] is not None:
 
567
                revision_id = revision[0].in_history(br_from)[1]
 
568
            else:
 
569
                # FIXME - wt.last_revision, fallback to branch, fall back to
 
570
                # None or perhaps NULL_REVISION to mean copy nothing
 
571
                # RBC 20060209
 
572
                revision_id = br_from.last_revision()
 
573
            if to_location is None:
 
574
                to_location = os.path.basename(from_location.rstrip("/\\"))
 
575
                name = None
 
576
            else:
 
577
                name = os.path.basename(to_location) + '\n'
 
578
            try:
 
579
                os.mkdir(to_location)
 
580
            except OSError, e:
 
581
                if e.errno == errno.EEXIST:
 
582
                    raise BzrCommandError('Target directory "%s" already'
 
583
                                          ' exists.' % to_location)
 
584
                if e.errno == errno.ENOENT:
 
585
                    raise BzrCommandError('Parent of "%s" does not exist.' %
 
586
                                          to_location)
 
587
                else:
 
588
                    raise
 
589
            try:
 
590
                # preserve whatever source format we have.
 
591
                dir = br_from.bzrdir.sprout(to_location, revision_id, basis_dir)
 
592
                branch = dir.open_branch()
 
593
            except bzrlib.errors.NoSuchRevision:
 
594
                rmtree(to_location)
 
595
                msg = "The branch %s has no revision %s." % (from_location, revision[0])
 
596
                raise BzrCommandError(msg)
 
597
            except bzrlib.errors.UnlistableBranch:
 
598
                rmtree(to_location)
 
599
                msg = "The branch %s cannot be used as a --basis" % (basis,)
 
600
                raise BzrCommandError(msg)
 
601
            if name:
 
602
                branch.control_files.put_utf8('branch-name', name)
 
603
 
 
604
            note('Branched %d revision(s).' % branch.revno())
 
605
        finally:
 
606
            br_from.unlock()
 
607
 
 
608
 
 
609
class cmd_checkout(Command):
 
610
    """Create a new checkout of an existing branch.
 
611
 
 
612
    If the TO_LOCATION is omitted, the last component of the BRANCH_LOCATION will
 
613
    be used.  In other words, "checkout ../foo/bar" will attempt to create ./bar.
 
614
 
 
615
    To retrieve the branch as of a particular revision, supply the --revision
 
616
    parameter, as in "checkout foo/bar -r 5". Note that this will be immediately
 
617
    out of date [so you cannot commit] but it may be useful (i.e. to examine old
 
618
    code.)
 
619
 
 
620
    --basis is to speed up checking out from remote branches.  When specified, it
 
621
    uses the inventory and file contents from the basis branch in preference to the
 
622
    branch being checked out. [Not implemented yet.]
 
623
    """
 
624
    takes_args = ['branch_location', 'to_location?']
 
625
    takes_options = ['revision', # , 'basis']
 
626
                     Option('lightweight',
 
627
                            help="perform a lightweight checkout. Lightweight "
 
628
                                 "checkouts depend on access to the branch for "
 
629
                                 "every operation. Normal checkouts can perform "
 
630
                                 "common operations like diff and status without "
 
631
                                 "such access, and also support local commits."
 
632
                            ),
 
633
                     ]
 
634
 
 
635
    def run(self, branch_location, to_location=None, revision=None, basis=None,
 
636
            lightweight=False):
 
637
        if revision is None:
 
638
            revision = [None]
 
639
        elif len(revision) > 1:
 
640
            raise BzrCommandError(
 
641
                'bzr checkout --revision takes exactly 1 revision value')
 
642
        source = Branch.open(branch_location)
 
643
        if len(revision) == 1 and revision[0] is not None:
 
644
            revision_id = revision[0].in_history(source)[1]
 
645
        else:
 
646
            revision_id = None
 
647
        if to_location is None:
 
648
            to_location = os.path.basename(branch_location.rstrip("/\\"))
 
649
        try:
 
650
            os.mkdir(to_location)
 
651
        except OSError, e:
 
652
            if e.errno == errno.EEXIST:
 
653
                raise BzrCommandError('Target directory "%s" already'
 
654
                                      ' exists.' % to_location)
 
655
            if e.errno == errno.ENOENT:
 
656
                raise BzrCommandError('Parent of "%s" does not exist.' %
 
657
                                      to_location)
 
658
            else:
 
659
                raise
 
660
        old_format = bzrlib.bzrdir.BzrDirFormat.get_default_format()
 
661
        bzrlib.bzrdir.BzrDirFormat.set_default_format(bzrdir.BzrDirMetaFormat1())
 
662
        try:
 
663
            if lightweight:
 
664
                checkout = bzrdir.BzrDirMetaFormat1().initialize(to_location)
 
665
                bzrlib.branch.BranchReferenceFormat().initialize(checkout, source)
 
666
            else:
 
667
                checkout_branch =  bzrlib.bzrdir.BzrDir.create_branch_convenience(
 
668
                    to_location, force_new_tree=False)
 
669
                checkout = checkout_branch.bzrdir
 
670
                checkout_branch.bind(source)
 
671
                if revision_id is not None:
 
672
                    rh = checkout_branch.revision_history()
 
673
                    checkout_branch.set_revision_history(rh[:rh.index(revision_id) + 1])
 
674
            checkout.create_workingtree(revision_id)
 
675
        finally:
 
676
            bzrlib.bzrdir.BzrDirFormat.set_default_format(old_format)
 
677
 
 
678
 
 
679
class cmd_renames(Command):
 
680
    """Show list of renamed files.
 
681
    """
 
682
    # TODO: Option to show renames between two historical versions.
 
683
 
 
684
    # TODO: Only show renames under dir, rather than in the whole branch.
 
685
    takes_args = ['dir?']
 
686
 
 
687
    @display_command
 
688
    def run(self, dir=u'.'):
 
689
        tree = WorkingTree.open_containing(dir)[0]
 
690
        old_inv = tree.basis_tree().inventory
 
691
        new_inv = tree.read_working_inventory()
 
692
 
 
693
        renames = list(bzrlib.tree.find_renames(old_inv, new_inv))
 
694
        renames.sort()
 
695
        for old_name, new_name in renames:
 
696
            print "%s => %s" % (old_name, new_name)        
 
697
 
 
698
 
 
699
class cmd_update(Command):
 
700
    """Update a tree to have the latest code committed to its branch.
 
701
    
 
702
    This will perform a merge into the working tree, and may generate
 
703
    conflicts. If you have any local changes, you will still 
 
704
    need to commit them after the update for the update to be complete.
 
705
    
 
706
    If you want to discard your local changes, you can just do a 
 
707
    'bzr revert' instead of 'bzr commit' after the update.
 
708
    """
 
709
    takes_args = ['dir?']
 
710
 
 
711
    def run(self, dir='.'):
 
712
        tree = WorkingTree.open_containing(dir)[0]
 
713
        tree.lock_write()
 
714
        try:
 
715
            if tree.last_revision() == tree.branch.last_revision():
 
716
                # may be up to date, check master too.
 
717
                master = tree.branch.get_master_branch()
 
718
                if master is None or master.last_revision == tree.last_revision():
 
719
                    note("Tree is up to date.")
 
720
                    return
 
721
            conflicts = tree.update()
 
722
            note('Updated to revision %d.' %
 
723
                 (tree.branch.revision_id_to_revno(tree.last_revision()),))
 
724
            if conflicts != 0:
 
725
                return 1
 
726
            else:
 
727
                return 0
 
728
        finally:
 
729
            tree.unlock()
 
730
 
 
731
 
 
732
class cmd_info(Command):
 
733
    """Show statistical information about a branch."""
 
734
    takes_args = ['branch?']
 
735
    
 
736
    @display_command
 
737
    def run(self, branch=None):
 
738
        import bzrlib.info
 
739
        bzrlib.info.show_bzrdir_info(bzrdir.BzrDir.open_containing(branch)[0])
 
740
 
 
741
 
 
742
class cmd_remove(Command):
 
743
    """Make a file unversioned.
 
744
 
 
745
    This makes bzr stop tracking changes to a versioned file.  It does
 
746
    not delete the working copy.
 
747
    """
 
748
    takes_args = ['file+']
 
749
    takes_options = ['verbose']
 
750
    aliases = ['rm']
 
751
    
 
752
    def run(self, file_list, verbose=False):
 
753
        tree, file_list = tree_files(file_list)
 
754
        tree.remove(file_list, verbose=verbose)
 
755
 
 
756
 
 
757
class cmd_file_id(Command):
 
758
    """Print file_id of a particular file or directory.
 
759
 
 
760
    The file_id is assigned when the file is first added and remains the
 
761
    same through all revisions where the file exists, even when it is
 
762
    moved or renamed.
 
763
    """
 
764
    hidden = True
 
765
    takes_args = ['filename']
 
766
    @display_command
 
767
    def run(self, filename):
 
768
        tree, relpath = WorkingTree.open_containing(filename)
 
769
        i = tree.inventory.path2id(relpath)
 
770
        if i == None:
 
771
            raise BzrError("%r is not a versioned file" % filename)
 
772
        else:
 
773
            print i
 
774
 
 
775
 
 
776
class cmd_file_path(Command):
 
777
    """Print path of file_ids to a file or directory.
 
778
 
 
779
    This prints one line for each directory down to the target,
 
780
    starting at the branch root."""
 
781
    hidden = True
 
782
    takes_args = ['filename']
 
783
    @display_command
 
784
    def run(self, filename):
 
785
        tree, relpath = WorkingTree.open_containing(filename)
 
786
        inv = tree.inventory
 
787
        fid = inv.path2id(relpath)
 
788
        if fid == None:
 
789
            raise BzrError("%r is not a versioned file" % filename)
 
790
        for fip in inv.get_idpath(fid):
 
791
            print fip
 
792
 
 
793
 
 
794
class cmd_reconcile(Command):
 
795
    """Reconcile bzr metadata in a branch.
 
796
 
 
797
    This can correct data mismatches that may have been caused by
 
798
    previous ghost operations or bzr upgrades. You should only
 
799
    need to run this command if 'bzr check' or a bzr developer 
 
800
    advises you to run it.
 
801
 
 
802
    If a second branch is provided, cross-branch reconciliation is
 
803
    also attempted, which will check that data like the tree root
 
804
    id which was not present in very early bzr versions is represented
 
805
    correctly in both branches.
 
806
 
 
807
    At the same time it is run it may recompress data resulting in 
 
808
    a potential saving in disk space or performance gain.
 
809
 
 
810
    The branch *MUST* be on a listable system such as local disk or sftp.
 
811
    """
 
812
    takes_args = ['branch?']
 
813
 
 
814
    def run(self, branch="."):
 
815
        from bzrlib.reconcile import reconcile
 
816
        dir = bzrlib.bzrdir.BzrDir.open(branch)
 
817
        reconcile(dir)
 
818
 
 
819
 
 
820
class cmd_revision_history(Command):
 
821
    """Display list of revision ids on this branch."""
 
822
    hidden = True
 
823
    @display_command
 
824
    def run(self):
 
825
        branch = WorkingTree.open_containing(u'.')[0].branch
 
826
        for patchid in branch.revision_history():
 
827
            print patchid
 
828
 
 
829
 
 
830
class cmd_ancestry(Command):
 
831
    """List all revisions merged into this branch."""
 
832
    hidden = True
 
833
    @display_command
 
834
    def run(self):
 
835
        tree = WorkingTree.open_containing(u'.')[0]
 
836
        b = tree.branch
 
837
        # FIXME. should be tree.last_revision
 
838
        for revision_id in b.repository.get_ancestry(b.last_revision()):
 
839
            print revision_id
 
840
 
 
841
 
 
842
class cmd_init(Command):
 
843
    """Make a directory into a versioned branch.
 
844
 
 
845
    Use this to create an empty branch, or before importing an
 
846
    existing project.
 
847
 
 
848
    Recipe for importing a tree of files:
 
849
        cd ~/project
 
850
        bzr init
 
851
        bzr add .
 
852
        bzr status
 
853
        bzr commit -m 'imported project'
 
854
    """
 
855
    takes_args = ['location?']
 
856
    takes_options = [
 
857
                     Option('format', 
 
858
                            help='Create a specific format rather than the'
 
859
                                 ' current default format. Currently this '
 
860
                                 ' option only accepts =metadir',
 
861
                            type=get_format_type),
 
862
                     ]
 
863
    def run(self, location=None, format=None):
 
864
        from bzrlib.branch import Branch
 
865
        if location is None:
 
866
            location = u'.'
 
867
        else:
 
868
            # The path has to exist to initialize a
 
869
            # branch inside of it.
 
870
            # Just using os.mkdir, since I don't
 
871
            # believe that we want to create a bunch of
 
872
            # locations if the user supplies an extended path
 
873
            if not os.path.exists(location):
 
874
                os.mkdir(location)
 
875
        bzrdir.BzrDir.create_branch_convenience(location, format=format)
 
876
 
 
877
 
 
878
class cmd_init_repository(Command):
 
879
    """Create a shared repository to keep branches in."""
 
880
    takes_args = ["location"] 
 
881
    takes_options = [Option('format', 
 
882
                            help='Use a specific format rather than the'
 
883
                            ' current default format. Currently this '
 
884
                            ' option only accepts "metadir" and "knit"',
 
885
                            type=get_format_type)]
 
886
    aliases = ["init-repo"]
 
887
    def run(self, location, format=None):
 
888
        from bzrlib.bzrdir import BzrDirMetaFormat1
 
889
        from bzrlib.transport import get_transport
 
890
        if format is None:
 
891
            format = BzrDirMetaFormat1()
 
892
        get_transport(location).mkdir('')
 
893
        newdir = format.initialize(location)
 
894
        repo = newdir.create_repository(shared=True)
 
895
        repo.set_make_working_trees(False)
 
896
 
 
897
 
 
898
class cmd_diff(Command):
 
899
    """Show differences in working tree.
 
900
    
 
901
    If files are listed, only the changes in those files are listed.
 
902
    Otherwise, all changes for the tree are listed.
 
903
 
 
904
    examples:
 
905
        bzr diff
 
906
        bzr diff -r1
 
907
        bzr diff -r1..2
 
908
    """
 
909
    # TODO: Allow diff across branches.
 
910
    # TODO: Option to use external diff command; could be GNU diff, wdiff,
 
911
    #       or a graphical diff.
 
912
 
 
913
    # TODO: Python difflib is not exactly the same as unidiff; should
 
914
    #       either fix it up or prefer to use an external diff.
 
915
 
 
916
    # TODO: If a directory is given, diff everything under that.
 
917
 
 
918
    # TODO: Selected-file diff is inefficient and doesn't show you
 
919
    #       deleted files.
 
920
 
 
921
    # TODO: This probably handles non-Unix newlines poorly.
 
922
    
 
923
    takes_args = ['file*']
 
924
    takes_options = ['revision', 'diff-options']
 
925
    aliases = ['di', 'dif']
 
926
 
 
927
    @display_command
 
928
    def run(self, revision=None, file_list=None, diff_options=None):
 
929
        from bzrlib.diff import diff_cmd_helper, show_diff_trees
 
930
        try:
 
931
            tree1, file_list = internal_tree_files(file_list)
 
932
            tree2 = None
 
933
            b = None
 
934
            b2 = None
 
935
        except FileInWrongBranch:
 
936
            if len(file_list) != 2:
 
937
                raise BzrCommandError("Files are in different branches")
 
938
 
 
939
            tree1, file1 = WorkingTree.open_containing(file_list[0])
 
940
            tree2, file2 = WorkingTree.open_containing(file_list[1])
 
941
            if file1 != "" or file2 != "":
 
942
                # FIXME diff those two files. rbc 20051123
 
943
                raise BzrCommandError("Files are in different branches")
 
944
            file_list = None
 
945
        if revision is not None:
 
946
            if tree2 is not None:
 
947
                raise BzrCommandError("Can't specify -r with two branches")
 
948
            if (len(revision) == 1) or (revision[1].spec is None):
 
949
                return diff_cmd_helper(tree1, file_list, diff_options,
 
950
                                       revision[0])
 
951
            elif len(revision) == 2:
 
952
                return diff_cmd_helper(tree1, file_list, diff_options,
 
953
                                       revision[0], revision[1])
 
954
            else:
 
955
                raise BzrCommandError('bzr diff --revision takes exactly one or two revision identifiers')
 
956
        else:
 
957
            if tree2 is not None:
 
958
                return show_diff_trees(tree1, tree2, sys.stdout, 
 
959
                                       specific_files=file_list,
 
960
                                       external_diff_options=diff_options)
 
961
            else:
 
962
                return diff_cmd_helper(tree1, file_list, diff_options)
 
963
 
 
964
 
 
965
class cmd_deleted(Command):
 
966
    """List files deleted in the working tree.
 
967
    """
 
968
    # TODO: Show files deleted since a previous revision, or
 
969
    # between two revisions.
 
970
    # TODO: Much more efficient way to do this: read in new
 
971
    # directories with readdir, rather than stating each one.  Same
 
972
    # level of effort but possibly much less IO.  (Or possibly not,
 
973
    # if the directories are very large...)
 
974
    @display_command
 
975
    def run(self, show_ids=False):
 
976
        tree = WorkingTree.open_containing(u'.')[0]
 
977
        old = tree.basis_tree()
 
978
        for path, ie in old.inventory.iter_entries():
 
979
            if not tree.has_id(ie.file_id):
 
980
                if show_ids:
 
981
                    print '%-50s %s' % (path, ie.file_id)
 
982
                else:
 
983
                    print path
 
984
 
 
985
 
 
986
class cmd_modified(Command):
 
987
    """List files modified in working tree."""
 
988
    hidden = True
 
989
    @display_command
 
990
    def run(self):
 
991
        from bzrlib.delta import compare_trees
 
992
 
 
993
        tree = WorkingTree.open_containing(u'.')[0]
 
994
        td = compare_trees(tree.basis_tree(), tree)
 
995
 
 
996
        for path, id, kind, text_modified, meta_modified in td.modified:
 
997
            print path
 
998
 
 
999
 
 
1000
 
 
1001
class cmd_added(Command):
 
1002
    """List files added in working tree."""
 
1003
    hidden = True
 
1004
    @display_command
 
1005
    def run(self):
 
1006
        wt = WorkingTree.open_containing(u'.')[0]
 
1007
        basis_inv = wt.basis_tree().inventory
 
1008
        inv = wt.inventory
 
1009
        for file_id in inv:
 
1010
            if file_id in basis_inv:
 
1011
                continue
 
1012
            path = inv.id2path(file_id)
 
1013
            if not os.access(bzrlib.osutils.abspath(path), os.F_OK):
 
1014
                continue
 
1015
            print path
 
1016
                
 
1017
        
 
1018
 
 
1019
class cmd_root(Command):
 
1020
    """Show the tree root directory.
 
1021
 
 
1022
    The root is the nearest enclosing directory with a .bzr control
 
1023
    directory."""
 
1024
    takes_args = ['filename?']
 
1025
    @display_command
 
1026
    def run(self, filename=None):
 
1027
        """Print the branch root."""
 
1028
        tree = WorkingTree.open_containing(filename)[0]
 
1029
        print tree.basedir
 
1030
 
 
1031
 
 
1032
class cmd_log(Command):
 
1033
    """Show log of this branch.
 
1034
 
 
1035
    To request a range of logs, you can use the command -r begin..end
 
1036
    -r revision requests a specific revision, -r ..end or -r begin.. are
 
1037
    also valid.
 
1038
    """
 
1039
 
 
1040
    # TODO: Make --revision support uuid: and hash: [future tag:] notation.
 
1041
 
 
1042
    takes_args = ['filename?']
 
1043
    takes_options = [Option('forward', 
 
1044
                            help='show from oldest to newest'),
 
1045
                     'timezone', 'verbose', 
 
1046
                     'show-ids', 'revision',
 
1047
                     'log-format',
 
1048
                     'line', 'long', 
 
1049
                     Option('message',
 
1050
                            help='show revisions whose message matches this regexp',
 
1051
                            type=str),
 
1052
                     'short',
 
1053
                     ]
 
1054
    @display_command
 
1055
    def run(self, filename=None, timezone='original',
 
1056
            verbose=False,
 
1057
            show_ids=False,
 
1058
            forward=False,
 
1059
            revision=None,
 
1060
            log_format=None,
 
1061
            message=None,
 
1062
            long=False,
 
1063
            short=False,
 
1064
            line=False):
 
1065
        from bzrlib.log import log_formatter, show_log
 
1066
        import codecs
 
1067
        assert message is None or isinstance(message, basestring), \
 
1068
            "invalid message argument %r" % message
 
1069
        direction = (forward and 'forward') or 'reverse'
 
1070
        
 
1071
        # log everything
 
1072
        file_id = None
 
1073
        if filename:
 
1074
            # find the file id to log:
 
1075
 
 
1076
            dir, fp = bzrdir.BzrDir.open_containing(filename)
 
1077
            b = dir.open_branch()
 
1078
            if fp != '':
 
1079
                try:
 
1080
                    # might be a tree:
 
1081
                    inv = dir.open_workingtree().inventory
 
1082
                except (errors.NotBranchError, errors.NotLocalUrl):
 
1083
                    # either no tree, or is remote.
 
1084
                    inv = b.basis_tree().inventory
 
1085
                file_id = inv.path2id(fp)
 
1086
        else:
 
1087
            # local dir only
 
1088
            # FIXME ? log the current subdir only RBC 20060203 
 
1089
            dir, relpath = bzrdir.BzrDir.open_containing('.')
 
1090
            b = dir.open_branch()
 
1091
 
 
1092
        if revision is None:
 
1093
            rev1 = None
 
1094
            rev2 = None
 
1095
        elif len(revision) == 1:
 
1096
            rev1 = rev2 = revision[0].in_history(b).revno
 
1097
        elif len(revision) == 2:
 
1098
            if revision[0].spec is None:
 
1099
                # missing begin-range means first revision
 
1100
                rev1 = 1
 
1101
            else:
 
1102
                rev1 = revision[0].in_history(b).revno
 
1103
 
 
1104
            if revision[1].spec is None:
 
1105
                # missing end-range means last known revision
 
1106
                rev2 = b.revno()
 
1107
            else:
 
1108
                rev2 = revision[1].in_history(b).revno
 
1109
        else:
 
1110
            raise BzrCommandError('bzr log --revision takes one or two values.')
 
1111
 
 
1112
        # By this point, the revision numbers are converted to the +ve
 
1113
        # form if they were supplied in the -ve form, so we can do
 
1114
        # this comparison in relative safety
 
1115
        if rev1 > rev2:
 
1116
            (rev2, rev1) = (rev1, rev2)
 
1117
 
 
1118
        mutter('encoding log as %r', bzrlib.user_encoding)
 
1119
 
 
1120
        # use 'replace' so that we don't abort if trying to write out
 
1121
        # in e.g. the default C locale.
 
1122
        outf = codecs.getwriter(bzrlib.user_encoding)(sys.stdout, errors='replace')
 
1123
 
 
1124
        if (log_format == None):
 
1125
            default = bzrlib.config.BranchConfig(b).log_format()
 
1126
            log_format = get_log_format(long=long, short=short, line=line, default=default)
 
1127
 
 
1128
        lf = log_formatter(log_format,
 
1129
                           show_ids=show_ids,
 
1130
                           to_file=outf,
 
1131
                           show_timezone=timezone)
 
1132
 
 
1133
        show_log(b,
 
1134
                 lf,
 
1135
                 file_id,
 
1136
                 verbose=verbose,
 
1137
                 direction=direction,
 
1138
                 start_revision=rev1,
 
1139
                 end_revision=rev2,
 
1140
                 search=message)
 
1141
 
 
1142
 
 
1143
def get_log_format(long=False, short=False, line=False, default='long'):
 
1144
    log_format = default
 
1145
    if long:
 
1146
        log_format = 'long'
 
1147
    if short:
 
1148
        log_format = 'short'
 
1149
    if line:
 
1150
        log_format = 'line'
 
1151
    return log_format
 
1152
 
 
1153
 
 
1154
class cmd_touching_revisions(Command):
 
1155
    """Return revision-ids which affected a particular file.
 
1156
 
 
1157
    A more user-friendly interface is "bzr log FILE"."""
 
1158
    hidden = True
 
1159
    takes_args = ["filename"]
 
1160
    @display_command
 
1161
    def run(self, filename):
 
1162
        tree, relpath = WorkingTree.open_containing(filename)
 
1163
        b = tree.branch
 
1164
        inv = tree.read_working_inventory()
 
1165
        file_id = inv.path2id(relpath)
 
1166
        for revno, revision_id, what in bzrlib.log.find_touching_revisions(b, file_id):
 
1167
            print "%6d %s" % (revno, what)
 
1168
 
 
1169
 
 
1170
class cmd_ls(Command):
 
1171
    """List files in a tree.
 
1172
    """
 
1173
    # TODO: Take a revision or remote path and list that tree instead.
 
1174
    hidden = True
 
1175
    takes_options = ['verbose', 'revision',
 
1176
                     Option('non-recursive',
 
1177
                            help='don\'t recurse into sub-directories'),
 
1178
                     Option('from-root',
 
1179
                            help='Print all paths from the root of the branch.'),
 
1180
                     Option('unknown', help='Print unknown files'),
 
1181
                     Option('versioned', help='Print versioned files'),
 
1182
                     Option('ignored', help='Print ignored files'),
 
1183
 
 
1184
                     Option('null', help='Null separate the files'),
 
1185
                    ]
 
1186
    @display_command
 
1187
    def run(self, revision=None, verbose=False, 
 
1188
            non_recursive=False, from_root=False,
 
1189
            unknown=False, versioned=False, ignored=False,
 
1190
            null=False):
 
1191
 
 
1192
        if verbose and null:
 
1193
            raise BzrCommandError('Cannot set both --verbose and --null')
 
1194
        all = not (unknown or versioned or ignored)
 
1195
 
 
1196
        selection = {'I':ignored, '?':unknown, 'V':versioned}
 
1197
 
 
1198
        tree, relpath = WorkingTree.open_containing(u'.')
 
1199
        if from_root:
 
1200
            relpath = u''
 
1201
        elif relpath:
 
1202
            relpath += '/'
 
1203
        if revision is not None:
 
1204
            tree = tree.branch.repository.revision_tree(
 
1205
                revision[0].in_history(tree.branch).rev_id)
 
1206
        for fp, fc, kind, fid, entry in tree.list_files():
 
1207
            if fp.startswith(relpath):
 
1208
                fp = fp[len(relpath):]
 
1209
                if non_recursive and '/' in fp:
 
1210
                    continue
 
1211
                if not all and not selection[fc]:
 
1212
                    continue
 
1213
                if verbose:
 
1214
                    kindch = entry.kind_character()
 
1215
                    print '%-8s %s%s' % (fc, fp, kindch)
 
1216
                elif null:
 
1217
                    sys.stdout.write(fp)
 
1218
                    sys.stdout.write('\0')
 
1219
                    sys.stdout.flush()
 
1220
                else:
 
1221
                    print fp
 
1222
 
 
1223
 
 
1224
class cmd_unknowns(Command):
 
1225
    """List unknown files."""
 
1226
    @display_command
 
1227
    def run(self):
 
1228
        from bzrlib.osutils import quotefn
 
1229
        for f in WorkingTree.open_containing(u'.')[0].unknowns():
 
1230
            print quotefn(f)
 
1231
 
 
1232
 
 
1233
class cmd_ignore(Command):
 
1234
    """Ignore a command or pattern.
 
1235
 
 
1236
    To remove patterns from the ignore list, edit the .bzrignore file.
 
1237
 
 
1238
    If the pattern contains a slash, it is compared to the whole path
 
1239
    from the branch root.  Otherwise, it is compared to only the last
 
1240
    component of the path.  To match a file only in the root directory,
 
1241
    prepend './'.
 
1242
 
 
1243
    Ignore patterns are case-insensitive on case-insensitive systems.
 
1244
 
 
1245
    Note: wildcards must be quoted from the shell on Unix.
 
1246
 
 
1247
    examples:
 
1248
        bzr ignore ./Makefile
 
1249
        bzr ignore '*.class'
 
1250
    """
 
1251
    # TODO: Complain if the filename is absolute
 
1252
    takes_args = ['name_pattern']
 
1253
    
 
1254
    def run(self, name_pattern):
 
1255
        from bzrlib.atomicfile import AtomicFile
 
1256
        import os.path
 
1257
 
 
1258
        tree, relpath = WorkingTree.open_containing(u'.')
 
1259
        ifn = tree.abspath('.bzrignore')
 
1260
 
 
1261
        if os.path.exists(ifn):
 
1262
            f = open(ifn, 'rt')
 
1263
            try:
 
1264
                igns = f.read().decode('utf-8')
 
1265
            finally:
 
1266
                f.close()
 
1267
        else:
 
1268
            igns = ''
 
1269
 
 
1270
        # TODO: If the file already uses crlf-style termination, maybe
 
1271
        # we should use that for the newly added lines?
 
1272
 
 
1273
        if igns and igns[-1] != '\n':
 
1274
            igns += '\n'
 
1275
        igns += name_pattern + '\n'
 
1276
 
 
1277
        try:
 
1278
            f = AtomicFile(ifn, 'wt')
 
1279
            f.write(igns.encode('utf-8'))
 
1280
            f.commit()
 
1281
        finally:
 
1282
            f.close()
 
1283
 
 
1284
        inv = tree.inventory
 
1285
        if inv.path2id('.bzrignore'):
 
1286
            mutter('.bzrignore is already versioned')
 
1287
        else:
 
1288
            mutter('need to make new .bzrignore file versioned')
 
1289
            tree.add(['.bzrignore'])
 
1290
 
 
1291
 
 
1292
class cmd_ignored(Command):
 
1293
    """List ignored files and the patterns that matched them.
 
1294
 
 
1295
    See also: bzr ignore"""
 
1296
    @display_command
 
1297
    def run(self):
 
1298
        tree = WorkingTree.open_containing(u'.')[0]
 
1299
        for path, file_class, kind, file_id, entry in tree.list_files():
 
1300
            if file_class != 'I':
 
1301
                continue
 
1302
            ## XXX: Slightly inefficient since this was already calculated
 
1303
            pat = tree.is_ignored(path)
 
1304
            print '%-50s %s' % (path, pat)
 
1305
 
 
1306
 
 
1307
class cmd_lookup_revision(Command):
 
1308
    """Lookup the revision-id from a revision-number
 
1309
 
 
1310
    example:
 
1311
        bzr lookup-revision 33
 
1312
    """
 
1313
    hidden = True
 
1314
    takes_args = ['revno']
 
1315
    
 
1316
    @display_command
 
1317
    def run(self, revno):
 
1318
        try:
 
1319
            revno = int(revno)
 
1320
        except ValueError:
 
1321
            raise BzrCommandError("not a valid revision-number: %r" % revno)
 
1322
 
 
1323
        print WorkingTree.open_containing(u'.')[0].branch.get_rev_id(revno)
 
1324
 
 
1325
 
 
1326
class cmd_export(Command):
 
1327
    """Export past revision to destination directory.
 
1328
 
 
1329
    If no revision is specified this exports the last committed revision.
 
1330
 
 
1331
    Format may be an "exporter" name, such as tar, tgz, tbz2.  If none is
 
1332
    given, try to find the format with the extension. If no extension
 
1333
    is found exports to a directory (equivalent to --format=dir).
 
1334
 
 
1335
    Root may be the top directory for tar, tgz and tbz2 formats. If none
 
1336
    is given, the top directory will be the root name of the file.
 
1337
 
 
1338
    Note: export of tree with non-ascii filenames to zip is not supported.
 
1339
 
 
1340
     Supported formats       Autodetected by extension
 
1341
     -----------------       -------------------------
 
1342
         dir                            -
 
1343
         tar                          .tar
 
1344
         tbz2                    .tar.bz2, .tbz2
 
1345
         tgz                      .tar.gz, .tgz
 
1346
         zip                          .zip
 
1347
    """
 
1348
    takes_args = ['dest']
 
1349
    takes_options = ['revision', 'format', 'root']
 
1350
    def run(self, dest, revision=None, format=None, root=None):
 
1351
        import os.path
 
1352
        from bzrlib.export import export
 
1353
        tree = WorkingTree.open_containing(u'.')[0]
 
1354
        b = tree.branch
 
1355
        if revision is None:
 
1356
            # should be tree.last_revision  FIXME
 
1357
            rev_id = b.last_revision()
 
1358
        else:
 
1359
            if len(revision) != 1:
 
1360
                raise BzrError('bzr export --revision takes exactly 1 argument')
 
1361
            rev_id = revision[0].in_history(b).rev_id
 
1362
        t = b.repository.revision_tree(rev_id)
 
1363
        try:
 
1364
            export(t, dest, format, root)
 
1365
        except errors.NoSuchExportFormat, e:
 
1366
            raise BzrCommandError('Unsupported export format: %s' % e.format)
 
1367
 
 
1368
 
 
1369
class cmd_cat(Command):
 
1370
    """Write a file's text from a previous revision."""
 
1371
 
 
1372
    takes_options = ['revision']
 
1373
    takes_args = ['filename']
 
1374
 
 
1375
    @display_command
 
1376
    def run(self, filename, revision=None):
 
1377
        if revision is not None and len(revision) != 1:
 
1378
            raise BzrCommandError("bzr cat --revision takes exactly one number")
 
1379
        tree = None
 
1380
        try:
 
1381
            tree, relpath = WorkingTree.open_containing(filename)
 
1382
            b = tree.branch
 
1383
        except NotBranchError:
 
1384
            pass
 
1385
 
 
1386
        if tree is None:
 
1387
            b, relpath = Branch.open_containing(filename)
 
1388
        if revision is None:
 
1389
            revision_id = b.last_revision()
 
1390
        else:
 
1391
            revision_id = revision[0].in_history(b).rev_id
 
1392
        b.print_file(relpath, revision_id)
 
1393
 
 
1394
 
 
1395
class cmd_local_time_offset(Command):
 
1396
    """Show the offset in seconds from GMT to local time."""
 
1397
    hidden = True    
 
1398
    @display_command
 
1399
    def run(self):
 
1400
        print bzrlib.osutils.local_time_offset()
 
1401
 
 
1402
 
 
1403
 
 
1404
class cmd_commit(Command):
 
1405
    """Commit changes into a new revision.
 
1406
    
 
1407
    If no arguments are given, the entire tree is committed.
 
1408
 
 
1409
    If selected files are specified, only changes to those files are
 
1410
    committed.  If a directory is specified then the directory and everything 
 
1411
    within it is committed.
 
1412
 
 
1413
    A selected-file commit may fail in some cases where the committed
 
1414
    tree would be invalid, such as trying to commit a file in a
 
1415
    newly-added directory that is not itself committed.
 
1416
    """
 
1417
    # TODO: Run hooks on tree to-be-committed, and after commit.
 
1418
 
 
1419
    # TODO: Strict commit that fails if there are deleted files.
 
1420
    #       (what does "deleted files" mean ??)
 
1421
 
 
1422
    # TODO: Give better message for -s, --summary, used by tla people
 
1423
 
 
1424
    # XXX: verbose currently does nothing
 
1425
 
 
1426
    takes_args = ['selected*']
 
1427
    takes_options = ['message', 'verbose', 
 
1428
                     Option('unchanged',
 
1429
                            help='commit even if nothing has changed'),
 
1430
                     Option('file', type=str, 
 
1431
                            argname='msgfile',
 
1432
                            help='file containing commit message'),
 
1433
                     Option('strict',
 
1434
                            help="refuse to commit if there are unknown "
 
1435
                            "files in the working tree."),
 
1436
                     Option('local',
 
1437
                            help="perform a local only commit in a bound "
 
1438
                                 "branch. Such commits are not pushed to "
 
1439
                                 "the master branch until a normal commit "
 
1440
                                 "is performed."
 
1441
                            ),
 
1442
                     ]
 
1443
    aliases = ['ci', 'checkin']
 
1444
 
 
1445
    def run(self, message=None, file=None, verbose=True, selected_list=None,
 
1446
            unchanged=False, strict=False, local=False):
 
1447
        from bzrlib.commit import (NullCommitReporter, ReportCommitToLog)
 
1448
        from bzrlib.errors import (PointlessCommit, ConflictsInTree,
 
1449
                StrictCommitFailed)
 
1450
        from bzrlib.msgeditor import edit_commit_message, \
 
1451
                make_commit_message_template
 
1452
        from tempfile import TemporaryFile
 
1453
        import codecs
 
1454
 
 
1455
        # TODO: Need a blackbox test for invoking the external editor; may be
 
1456
        # slightly problematic to run this cross-platform.
 
1457
 
 
1458
        # TODO: do more checks that the commit will succeed before 
 
1459
        # spending the user's valuable time typing a commit message.
 
1460
        #
 
1461
        # TODO: if the commit *does* happen to fail, then save the commit 
 
1462
        # message to a temporary file where it can be recovered
 
1463
        tree, selected_list = tree_files(selected_list)
 
1464
        if local and not tree.branch.get_bound_location():
 
1465
            raise errors.LocalRequiresBoundBranch()
 
1466
        if message is None and not file:
 
1467
            template = make_commit_message_template(tree, selected_list)
 
1468
            message = edit_commit_message(template)
 
1469
            if message is None:
 
1470
                raise BzrCommandError("please specify a commit message"
 
1471
                                      " with either --message or --file")
 
1472
        elif message and file:
 
1473
            raise BzrCommandError("please specify either --message or --file")
 
1474
        
 
1475
        if file:
 
1476
            import codecs
 
1477
            message = codecs.open(file, 'rt', bzrlib.user_encoding).read()
 
1478
 
 
1479
        if message == "":
 
1480
                raise BzrCommandError("empty commit message specified")
 
1481
        
 
1482
        if verbose:
 
1483
            reporter = ReportCommitToLog()
 
1484
        else:
 
1485
            reporter = NullCommitReporter()
 
1486
        
 
1487
        try:
 
1488
            tree.commit(message, specific_files=selected_list,
 
1489
                        allow_pointless=unchanged, strict=strict, local=local,
 
1490
                        reporter=reporter)
 
1491
        except PointlessCommit:
 
1492
            # FIXME: This should really happen before the file is read in;
 
1493
            # perhaps prepare the commit; get the message; then actually commit
 
1494
            raise BzrCommandError("no changes to commit",
 
1495
                                  ["use --unchanged to commit anyhow"])
 
1496
        except ConflictsInTree:
 
1497
            raise BzrCommandError("Conflicts detected in working tree.  "
 
1498
                'Use "bzr conflicts" to list, "bzr resolve FILE" to resolve.')
 
1499
        except StrictCommitFailed:
 
1500
            raise BzrCommandError("Commit refused because there are unknown "
 
1501
                                  "files in the working tree.")
 
1502
        except errors.BoundBranchOutOfDate, e:
 
1503
            raise BzrCommandError(str(e)
 
1504
                                  + ' Either unbind, update, or'
 
1505
                                    ' pass --local to commit.')
 
1506
 
 
1507
 
 
1508
class cmd_check(Command):
 
1509
    """Validate consistency of branch history.
 
1510
 
 
1511
    This command checks various invariants about the branch storage to
 
1512
    detect data corruption or bzr bugs.
 
1513
    """
 
1514
    takes_args = ['branch?']
 
1515
    takes_options = ['verbose']
 
1516
 
 
1517
    def run(self, branch=None, verbose=False):
 
1518
        from bzrlib.check import check
 
1519
        if branch is None:
 
1520
            tree = WorkingTree.open_containing()[0]
 
1521
            branch = tree.branch
 
1522
        else:
 
1523
            branch = Branch.open(branch)
 
1524
        check(branch, verbose)
 
1525
 
 
1526
 
 
1527
class cmd_scan_cache(Command):
 
1528
    hidden = True
 
1529
    def run(self):
 
1530
        from bzrlib.hashcache import HashCache
 
1531
 
 
1532
        c = HashCache(u'.')
 
1533
        c.read()
 
1534
        c.scan()
 
1535
            
 
1536
        print '%6d stats' % c.stat_count
 
1537
        print '%6d in hashcache' % len(c._cache)
 
1538
        print '%6d files removed from cache' % c.removed_count
 
1539
        print '%6d hashes updated' % c.update_count
 
1540
        print '%6d files changed too recently to cache' % c.danger_count
 
1541
 
 
1542
        if c.needs_write:
 
1543
            c.write()
 
1544
 
 
1545
 
 
1546
class cmd_upgrade(Command):
 
1547
    """Upgrade branch storage to current format.
 
1548
 
 
1549
    The check command or bzr developers may sometimes advise you to run
 
1550
    this command. When the default format has changed you may also be warned
 
1551
    during other operations to upgrade.
 
1552
    """
 
1553
    takes_args = ['url?']
 
1554
    takes_options = [
 
1555
                     Option('format', 
 
1556
                            help='Upgrade to a specific format rather than the'
 
1557
                                 ' current default format. Currently this '
 
1558
                                 ' option only accepts =metadir',
 
1559
                            type=get_format_type),
 
1560
                    ]
 
1561
 
 
1562
 
 
1563
    def run(self, url='.', format=None):
 
1564
        from bzrlib.upgrade import upgrade
 
1565
        upgrade(url, format)
 
1566
 
 
1567
 
 
1568
class cmd_whoami(Command):
 
1569
    """Show bzr user id."""
 
1570
    takes_options = ['email']
 
1571
    
 
1572
    @display_command
 
1573
    def run(self, email=False):
 
1574
        try:
 
1575
            b = WorkingTree.open_containing(u'.')[0].branch
 
1576
            config = bzrlib.config.BranchConfig(b)
 
1577
        except NotBranchError:
 
1578
            config = bzrlib.config.GlobalConfig()
 
1579
        
 
1580
        if email:
 
1581
            print config.user_email()
 
1582
        else:
 
1583
            print config.username()
 
1584
 
 
1585
 
 
1586
class cmd_nick(Command):
 
1587
    """Print or set the branch nickname.  
 
1588
 
 
1589
    If unset, the tree root directory name is used as the nickname
 
1590
    To print the current nickname, execute with no argument.  
 
1591
    """
 
1592
    takes_args = ['nickname?']
 
1593
    def run(self, nickname=None):
 
1594
        branch = Branch.open_containing(u'.')[0]
 
1595
        if nickname is None:
 
1596
            self.printme(branch)
 
1597
        else:
 
1598
            branch.nick = nickname
 
1599
 
 
1600
    @display_command
 
1601
    def printme(self, branch):
 
1602
        print branch.nick 
 
1603
 
 
1604
 
 
1605
class cmd_selftest(Command):
 
1606
    """Run internal test suite.
 
1607
    
 
1608
    This creates temporary test directories in the working directory,
 
1609
    but not existing data is affected.  These directories are deleted
 
1610
    if the tests pass, or left behind to help in debugging if they
 
1611
    fail and --keep-output is specified.
 
1612
    
 
1613
    If arguments are given, they are regular expressions that say
 
1614
    which tests should run.
 
1615
 
 
1616
    If the global option '--no-plugins' is given, plugins are not loaded
 
1617
    before running the selftests.  This has two effects: features provided or
 
1618
    modified by plugins will not be tested, and tests provided by plugins will
 
1619
    not be run.
 
1620
 
 
1621
    examples:
 
1622
        bzr selftest ignore
 
1623
        bzr --no-plugins selftest -v
 
1624
    """
 
1625
    # TODO: --list should give a list of all available tests
 
1626
 
 
1627
    # NB: this is used from the class without creating an instance, which is
 
1628
    # why it does not have a self parameter.
 
1629
    def get_transport_type(typestring):
 
1630
        """Parse and return a transport specifier."""
 
1631
        if typestring == "sftp":
 
1632
            from bzrlib.transport.sftp import SFTPAbsoluteServer
 
1633
            return SFTPAbsoluteServer
 
1634
        if typestring == "memory":
 
1635
            from bzrlib.transport.memory import MemoryServer
 
1636
            return MemoryServer
 
1637
        if typestring == "fakenfs":
 
1638
            from bzrlib.transport.memory import FakeNFSServer
 
1639
            return FakeNFSServer
 
1640
        msg = "No known transport type %s. Supported types are: sftp\n" %\
 
1641
            (typestring)
 
1642
        raise BzrCommandError(msg)
 
1643
 
 
1644
    hidden = True
 
1645
    takes_args = ['testspecs*']
 
1646
    takes_options = ['verbose',
 
1647
                     Option('one', help='stop when one test fails'),
 
1648
                     Option('keep-output', 
 
1649
                            help='keep output directories when tests fail'),
 
1650
                     Option('transport', 
 
1651
                            help='Use a different transport by default '
 
1652
                                 'throughout the test suite.',
 
1653
                            type=get_transport_type),
 
1654
                    ]
 
1655
 
 
1656
    def run(self, testspecs_list=None, verbose=False, one=False,
 
1657
            keep_output=False, transport=None):
 
1658
        import bzrlib.ui
 
1659
        from bzrlib.tests import selftest
 
1660
        # we don't want progress meters from the tests to go to the
 
1661
        # real output; and we don't want log messages cluttering up
 
1662
        # the real logs.
 
1663
        save_ui = bzrlib.ui.ui_factory
 
1664
        bzrlib.trace.info('running tests...')
 
1665
        try:
 
1666
            bzrlib.ui.ui_factory = bzrlib.ui.SilentUIFactory()
 
1667
            if testspecs_list is not None:
 
1668
                pattern = '|'.join(testspecs_list)
 
1669
            else:
 
1670
                pattern = ".*"
 
1671
            result = selftest(verbose=verbose, 
 
1672
                              pattern=pattern,
 
1673
                              stop_on_failure=one, 
 
1674
                              keep_output=keep_output,
 
1675
                              transport=transport)
 
1676
            if result:
 
1677
                bzrlib.trace.info('tests passed')
 
1678
            else:
 
1679
                bzrlib.trace.info('tests failed')
 
1680
            return int(not result)
 
1681
        finally:
 
1682
            bzrlib.ui.ui_factory = save_ui
 
1683
 
 
1684
 
 
1685
def _get_bzr_branch():
 
1686
    """If bzr is run from a branch, return Branch or None"""
 
1687
    import bzrlib.errors
 
1688
    from bzrlib.branch import Branch
 
1689
    from bzrlib.osutils import abspath
 
1690
    from os.path import dirname
 
1691
    
 
1692
    try:
 
1693
        branch = Branch.open(dirname(abspath(dirname(__file__))))
 
1694
        return branch
 
1695
    except bzrlib.errors.BzrError:
 
1696
        return None
 
1697
    
 
1698
 
 
1699
def show_version():
 
1700
    print "bzr (bazaar-ng) %s" % bzrlib.__version__
 
1701
    # is bzrlib itself in a branch?
 
1702
    branch = _get_bzr_branch()
 
1703
    if branch:
 
1704
        rh = branch.revision_history()
 
1705
        revno = len(rh)
 
1706
        print "  bzr checkout, revision %d" % (revno,)
 
1707
        print "  nick: %s" % (branch.nick,)
 
1708
        if rh:
 
1709
            print "  revid: %s" % (rh[-1],)
 
1710
    print bzrlib.__copyright__
 
1711
    print "http://bazaar-ng.org/"
 
1712
    print
 
1713
    print "bzr comes with ABSOLUTELY NO WARRANTY.  bzr is free software, and"
 
1714
    print "you may use, modify and redistribute it under the terms of the GNU"
 
1715
    print "General Public License version 2 or later."
 
1716
 
 
1717
 
 
1718
class cmd_version(Command):
 
1719
    """Show version of bzr."""
 
1720
    @display_command
 
1721
    def run(self):
 
1722
        show_version()
 
1723
 
 
1724
class cmd_rocks(Command):
 
1725
    """Statement of optimism."""
 
1726
    hidden = True
 
1727
    @display_command
 
1728
    def run(self):
 
1729
        print "it sure does!"
 
1730
 
 
1731
 
 
1732
class cmd_find_merge_base(Command):
 
1733
    """Find and print a base revision for merging two branches.
 
1734
    """
 
1735
    # TODO: Options to specify revisions on either side, as if
 
1736
    #       merging only part of the history.
 
1737
    takes_args = ['branch', 'other']
 
1738
    hidden = True
 
1739
    
 
1740
    @display_command
 
1741
    def run(self, branch, other):
 
1742
        from bzrlib.revision import common_ancestor, MultipleRevisionSources
 
1743
        
 
1744
        branch1 = Branch.open_containing(branch)[0]
 
1745
        branch2 = Branch.open_containing(other)[0]
 
1746
 
 
1747
        history_1 = branch1.revision_history()
 
1748
        history_2 = branch2.revision_history()
 
1749
 
 
1750
        last1 = branch1.last_revision()
 
1751
        last2 = branch2.last_revision()
 
1752
 
 
1753
        source = MultipleRevisionSources(branch1.repository, 
 
1754
                                         branch2.repository)
 
1755
        
 
1756
        base_rev_id = common_ancestor(last1, last2, source)
 
1757
 
 
1758
        print 'merge base is revision %s' % base_rev_id
 
1759
        
 
1760
        return
 
1761
 
 
1762
        if base_revno is None:
 
1763
            raise bzrlib.errors.UnrelatedBranches()
 
1764
 
 
1765
        print ' r%-6d in %s' % (base_revno, branch)
 
1766
 
 
1767
        other_revno = branch2.revision_id_to_revno(base_revid)
 
1768
        
 
1769
        print ' r%-6d in %s' % (other_revno, other)
 
1770
 
 
1771
 
 
1772
 
 
1773
class cmd_merge(Command):
 
1774
    """Perform a three-way merge.
 
1775
    
 
1776
    The branch is the branch you will merge from.  By default, it will
 
1777
    merge the latest revision.  If you specify a revision, that
 
1778
    revision will be merged.  If you specify two revisions, the first
 
1779
    will be used as a BASE, and the second one as OTHER.  Revision
 
1780
    numbers are always relative to the specified branch.
 
1781
 
 
1782
    By default, bzr will try to merge in all new work from the other
 
1783
    branch, automatically determining an appropriate base.  If this
 
1784
    fails, you may need to give an explicit base.
 
1785
    
 
1786
    Merge will do its best to combine the changes in two branches, but there
 
1787
    are some kinds of problems only a human can fix.  When it encounters those,
 
1788
    it will mark a conflict.  A conflict means that you need to fix something,
 
1789
    before you should commit.
 
1790
 
 
1791
    Use bzr resolve when you have fixed a problem.  See also bzr conflicts.
 
1792
 
 
1793
    Examples:
 
1794
 
 
1795
    To merge the latest revision from bzr.dev
 
1796
    bzr merge ../bzr.dev
 
1797
 
 
1798
    To merge changes up to and including revision 82 from bzr.dev
 
1799
    bzr merge -r 82 ../bzr.dev
 
1800
 
 
1801
    To merge the changes introduced by 82, without previous changes:
 
1802
    bzr merge -r 81..82 ../bzr.dev
 
1803
    
 
1804
    merge refuses to run if there are any uncommitted changes, unless
 
1805
    --force is given.
 
1806
    """
 
1807
    takes_args = ['branch?']
 
1808
    takes_options = ['revision', 'force', 'merge-type', 'reprocess',
 
1809
                     Option('show-base', help="Show base revision text in "
 
1810
                            "conflicts")]
 
1811
 
 
1812
    def run(self, branch=None, revision=None, force=False, merge_type=None,
 
1813
            show_base=False, reprocess=False):
 
1814
        if merge_type is None:
 
1815
            merge_type = Merge3Merger
 
1816
        if branch is None:
 
1817
            branch = WorkingTree.open_containing(u'.')[0].branch.get_parent()
 
1818
            if branch is None:
 
1819
                raise BzrCommandError("No merge location known or specified.")
 
1820
            else:
 
1821
                print "Using saved location: %s" % branch 
 
1822
        if revision is None or len(revision) < 1:
 
1823
            base = [None, None]
 
1824
            other = [branch, -1]
 
1825
        else:
 
1826
            if len(revision) == 1:
 
1827
                base = [None, None]
 
1828
                other_branch = Branch.open_containing(branch)[0]
 
1829
                revno = revision[0].in_history(other_branch).revno
 
1830
                other = [branch, revno]
 
1831
            else:
 
1832
                assert len(revision) == 2
 
1833
                if None in revision:
 
1834
                    raise BzrCommandError(
 
1835
                        "Merge doesn't permit that revision specifier.")
 
1836
                b = Branch.open_containing(branch)[0]
 
1837
 
 
1838
                base = [branch, revision[0].in_history(b).revno]
 
1839
                other = [branch, revision[1].in_history(b).revno]
 
1840
        pb = bzrlib.ui.ui_factory.nested_progress_bar()
 
1841
        try:
 
1842
            try:
 
1843
                conflict_count = merge(other, base, check_clean=(not force),
 
1844
                                       merge_type=merge_type, 
 
1845
                                       reprocess=reprocess,
 
1846
                                       show_base=show_base, 
 
1847
                                       pb=pb)
 
1848
            finally:
 
1849
                pb.finished()
 
1850
            if conflict_count != 0:
 
1851
                return 1
 
1852
            else:
 
1853
                return 0
 
1854
        except bzrlib.errors.AmbiguousBase, e:
 
1855
            m = ("sorry, bzr can't determine the right merge base yet\n"
 
1856
                 "candidates are:\n  "
 
1857
                 + "\n  ".join(e.bases)
 
1858
                 + "\n"
 
1859
                 "please specify an explicit base with -r,\n"
 
1860
                 "and (if you want) report this to the bzr developers\n")
 
1861
            log_error(m)
 
1862
 
 
1863
 
 
1864
class cmd_remerge(Command):
 
1865
    """Redo a merge.
 
1866
    """
 
1867
    takes_args = ['file*']
 
1868
    takes_options = ['merge-type', 'reprocess',
 
1869
                     Option('show-base', help="Show base revision text in "
 
1870
                            "conflicts")]
 
1871
 
 
1872
    def run(self, file_list=None, merge_type=None, show_base=False,
 
1873
            reprocess=False):
 
1874
        from bzrlib.merge import merge_inner, transform_tree
 
1875
        if merge_type is None:
 
1876
            merge_type = Merge3Merger
 
1877
        tree, file_list = tree_files(file_list)
 
1878
        tree.lock_write()
 
1879
        try:
 
1880
            pending_merges = tree.pending_merges() 
 
1881
            if len(pending_merges) != 1:
 
1882
                raise BzrCommandError("Sorry, remerge only works after normal"
 
1883
                                      + " merges.  Not cherrypicking or"
 
1884
                                      + "multi-merges.")
 
1885
            repository = tree.branch.repository
 
1886
            base_revision = common_ancestor(tree.branch.last_revision(), 
 
1887
                                            pending_merges[0], repository)
 
1888
            base_tree = repository.revision_tree(base_revision)
 
1889
            other_tree = repository.revision_tree(pending_merges[0])
 
1890
            interesting_ids = None
 
1891
            if file_list is not None:
 
1892
                interesting_ids = set()
 
1893
                for filename in file_list:
 
1894
                    file_id = tree.path2id(filename)
 
1895
                    if file_id is None:
 
1896
                        raise NotVersionedError(filename)
 
1897
                    interesting_ids.add(file_id)
 
1898
                    if tree.kind(file_id) != "directory":
 
1899
                        continue
 
1900
                    
 
1901
                    for name, ie in tree.inventory.iter_entries(file_id):
 
1902
                        interesting_ids.add(ie.file_id)
 
1903
            transform_tree(tree, tree.basis_tree(), interesting_ids)
 
1904
            if file_list is None:
 
1905
                restore_files = list(tree.iter_conflicts())
 
1906
            else:
 
1907
                restore_files = file_list
 
1908
            for filename in restore_files:
 
1909
                try:
 
1910
                    restore(tree.abspath(filename))
 
1911
                except NotConflicted:
 
1912
                    pass
 
1913
            conflicts =  merge_inner(tree.branch, other_tree, base_tree,
 
1914
                                     this_tree=tree,
 
1915
                                     interesting_ids = interesting_ids, 
 
1916
                                     other_rev_id=pending_merges[0], 
 
1917
                                     merge_type=merge_type, 
 
1918
                                     show_base=show_base,
 
1919
                                     reprocess=reprocess)
 
1920
        finally:
 
1921
            tree.unlock()
 
1922
        if conflicts > 0:
 
1923
            return 1
 
1924
        else:
 
1925
            return 0
 
1926
 
 
1927
class cmd_revert(Command):
 
1928
    """Reverse all changes since the last commit.
 
1929
 
 
1930
    Only versioned files are affected.  Specify filenames to revert only 
 
1931
    those files.  By default, any files that are changed will be backed up
 
1932
    first.  Backup files have a '~' appended to their name.
 
1933
    """
 
1934
    takes_options = ['revision', 'no-backup']
 
1935
    takes_args = ['file*']
 
1936
    aliases = ['merge-revert']
 
1937
 
 
1938
    def run(self, revision=None, no_backup=False, file_list=None):
 
1939
        from bzrlib.commands import parse_spec
 
1940
        if file_list is not None:
 
1941
            if len(file_list) == 0:
 
1942
                raise BzrCommandError("No files specified")
 
1943
        else:
 
1944
            file_list = []
 
1945
        
 
1946
        tree, file_list = tree_files(file_list)
 
1947
        if revision is None:
 
1948
            # FIXME should be tree.last_revision
 
1949
            rev_id = tree.last_revision()
 
1950
        elif len(revision) != 1:
 
1951
            raise BzrCommandError('bzr revert --revision takes exactly 1 argument')
 
1952
        else:
 
1953
            rev_id = revision[0].in_history(tree.branch).rev_id
 
1954
        pb = bzrlib.ui.ui_factory.nested_progress_bar()
 
1955
        try:
 
1956
            tree.revert(file_list, 
 
1957
                        tree.branch.repository.revision_tree(rev_id),
 
1958
                        not no_backup, pb)
 
1959
        finally:
 
1960
            pb.finished()
 
1961
 
 
1962
 
 
1963
class cmd_assert_fail(Command):
 
1964
    """Test reporting of assertion failures"""
 
1965
    hidden = True
 
1966
    def run(self):
 
1967
        assert False, "always fails"
 
1968
 
 
1969
 
 
1970
class cmd_help(Command):
 
1971
    """Show help on a command or other topic.
 
1972
 
 
1973
    For a list of all available commands, say 'bzr help commands'."""
 
1974
    takes_options = [Option('long', 'show help on all commands')]
 
1975
    takes_args = ['topic?']
 
1976
    aliases = ['?']
 
1977
    
 
1978
    @display_command
 
1979
    def run(self, topic=None, long=False):
 
1980
        import help
 
1981
        if topic is None and long:
 
1982
            topic = "commands"
 
1983
        help.help(topic)
 
1984
 
 
1985
 
 
1986
class cmd_shell_complete(Command):
 
1987
    """Show appropriate completions for context.
 
1988
 
 
1989
    For a list of all available commands, say 'bzr shell-complete'."""
 
1990
    takes_args = ['context?']
 
1991
    aliases = ['s-c']
 
1992
    hidden = True
 
1993
    
 
1994
    @display_command
 
1995
    def run(self, context=None):
 
1996
        import shellcomplete
 
1997
        shellcomplete.shellcomplete(context)
 
1998
 
 
1999
 
 
2000
class cmd_fetch(Command):
 
2001
    """Copy in history from another branch but don't merge it.
 
2002
 
 
2003
    This is an internal method used for pull and merge."""
 
2004
    hidden = True
 
2005
    takes_args = ['from_branch', 'to_branch']
 
2006
    def run(self, from_branch, to_branch):
 
2007
        from bzrlib.fetch import Fetcher
 
2008
        from bzrlib.branch import Branch
 
2009
        from_b = Branch.open(from_branch)
 
2010
        to_b = Branch.open(to_branch)
 
2011
        Fetcher(to_b, from_b)
 
2012
 
 
2013
 
 
2014
class cmd_missing(Command):
 
2015
    """Show unmerged/unpulled revisions between two branches.
 
2016
 
 
2017
    OTHER_BRANCH may be local or remote."""
 
2018
    takes_args = ['other_branch?']
 
2019
    takes_options = [Option('reverse', 'Reverse the order of revisions'),
 
2020
                     Option('mine-only', 
 
2021
                            'Display changes in the local branch only'),
 
2022
                     Option('theirs-only', 
 
2023
                            'Display changes in the remote branch only'), 
 
2024
                     'log-format',
 
2025
                     'line',
 
2026
                     'long', 
 
2027
                     'short',
 
2028
                     'show-ids',
 
2029
                     'verbose'
 
2030
                     ]
 
2031
 
 
2032
    def run(self, other_branch=None, reverse=False, mine_only=False,
 
2033
            theirs_only=False, log_format=None, long=False, short=False, line=False, 
 
2034
            show_ids=False, verbose=False):
 
2035
        from bzrlib.missing import find_unmerged, iter_log_data
 
2036
        from bzrlib.log import log_formatter
 
2037
        local_branch = bzrlib.branch.Branch.open_containing(u".")[0]
 
2038
        parent = local_branch.get_parent()
 
2039
        if other_branch is None:
 
2040
            other_branch = parent
 
2041
            if other_branch is None:
 
2042
                raise BzrCommandError("No missing location known or specified.")
 
2043
            print "Using last location: " + local_branch.get_parent()
 
2044
        remote_branch = bzrlib.branch.Branch.open(other_branch)
 
2045
        remote_branch.lock_read()
 
2046
        try:
 
2047
            local_branch.lock_write()
 
2048
            try:
 
2049
                local_extra, remote_extra = find_unmerged(local_branch, remote_branch)
 
2050
                if (log_format == None):
 
2051
                    default = bzrlib.config.BranchConfig(local_branch).log_format()
 
2052
                    log_format = get_log_format(long=long, short=short, line=line, default=default)
 
2053
                lf = log_formatter(log_format, sys.stdout,
 
2054
                                   show_ids=show_ids,
 
2055
                                   show_timezone='original')
 
2056
                if reverse is False:
 
2057
                    local_extra.reverse()
 
2058
                    remote_extra.reverse()
 
2059
                if local_extra and not theirs_only:
 
2060
                    print "You have %d extra revision(s):" % len(local_extra)
 
2061
                    for data in iter_log_data(local_extra, local_branch.repository,
 
2062
                                              verbose):
 
2063
                        lf.show(*data)
 
2064
                    printed_local = True
 
2065
                else:
 
2066
                    printed_local = False
 
2067
                if remote_extra and not mine_only:
 
2068
                    if printed_local is True:
 
2069
                        print "\n\n"
 
2070
                    print "You are missing %d revision(s):" % len(remote_extra)
 
2071
                    for data in iter_log_data(remote_extra, remote_branch.repository, 
 
2072
                                              verbose):
 
2073
                        lf.show(*data)
 
2074
                if not remote_extra and not local_extra:
 
2075
                    status_code = 0
 
2076
                    print "Branches are up to date."
 
2077
                else:
 
2078
                    status_code = 1
 
2079
                if parent is None and other_branch is not None:
 
2080
                    local_branch.set_parent(other_branch)
 
2081
                return status_code
 
2082
            finally:
 
2083
                local_branch.unlock()
 
2084
        finally:
 
2085
            remote_branch.unlock()
 
2086
 
 
2087
 
 
2088
class cmd_plugins(Command):
 
2089
    """List plugins"""
 
2090
    hidden = True
 
2091
    @display_command
 
2092
    def run(self):
 
2093
        import bzrlib.plugin
 
2094
        from inspect import getdoc
 
2095
        for name, plugin in bzrlib.plugin.all_plugins().items():
 
2096
            if hasattr(plugin, '__path__'):
 
2097
                print plugin.__path__[0]
 
2098
            elif hasattr(plugin, '__file__'):
 
2099
                print plugin.__file__
 
2100
            else:
 
2101
                print `plugin`
 
2102
                
 
2103
            d = getdoc(plugin)
 
2104
            if d:
 
2105
                print '\t', d.split('\n')[0]
 
2106
 
 
2107
 
 
2108
class cmd_testament(Command):
 
2109
    """Show testament (signing-form) of a revision."""
 
2110
    takes_options = ['revision', 'long']
 
2111
    takes_args = ['branch?']
 
2112
    @display_command
 
2113
    def run(self, branch=u'.', revision=None, long=False):
 
2114
        from bzrlib.testament import Testament
 
2115
        b = WorkingTree.open_containing(branch)[0].branch
 
2116
        b.lock_read()
 
2117
        try:
 
2118
            if revision is None:
 
2119
                rev_id = b.last_revision()
 
2120
            else:
 
2121
                rev_id = revision[0].in_history(b).rev_id
 
2122
            t = Testament.from_revision(b.repository, rev_id)
 
2123
            if long:
 
2124
                sys.stdout.writelines(t.as_text_lines())
 
2125
            else:
 
2126
                sys.stdout.write(t.as_short_text())
 
2127
        finally:
 
2128
            b.unlock()
 
2129
 
 
2130
 
 
2131
class cmd_annotate(Command):
 
2132
    """Show the origin of each line in a file.
 
2133
 
 
2134
    This prints out the given file with an annotation on the left side
 
2135
    indicating which revision, author and date introduced the change.
 
2136
 
 
2137
    If the origin is the same for a run of consecutive lines, it is 
 
2138
    shown only at the top, unless the --all option is given.
 
2139
    """
 
2140
    # TODO: annotate directories; showing when each file was last changed
 
2141
    # TODO: annotate a previous version of a file
 
2142
    # TODO: if the working copy is modified, show annotations on that 
 
2143
    #       with new uncommitted lines marked
 
2144
    aliases = ['blame', 'praise']
 
2145
    takes_args = ['filename']
 
2146
    takes_options = [Option('all', help='show annotations on all lines'),
 
2147
                     Option('long', help='show date in annotations'),
 
2148
                     ]
 
2149
 
 
2150
    @display_command
 
2151
    def run(self, filename, all=False, long=False):
 
2152
        from bzrlib.annotate import annotate_file
 
2153
        tree, relpath = WorkingTree.open_containing(filename)
 
2154
        branch = tree.branch
 
2155
        branch.lock_read()
 
2156
        try:
 
2157
            file_id = tree.inventory.path2id(relpath)
 
2158
            tree = branch.repository.revision_tree(branch.last_revision())
 
2159
            file_version = tree.inventory[file_id].revision
 
2160
            annotate_file(branch, file_version, file_id, long, all, sys.stdout)
 
2161
        finally:
 
2162
            branch.unlock()
 
2163
 
 
2164
 
 
2165
class cmd_re_sign(Command):
 
2166
    """Create a digital signature for an existing revision."""
 
2167
    # TODO be able to replace existing ones.
 
2168
 
 
2169
    hidden = True # is this right ?
 
2170
    takes_args = ['revision_id*']
 
2171
    takes_options = ['revision']
 
2172
    
 
2173
    def run(self, revision_id_list=None, revision=None):
 
2174
        import bzrlib.config as config
 
2175
        import bzrlib.gpg as gpg
 
2176
        if revision_id_list is not None and revision is not None:
 
2177
            raise BzrCommandError('You can only supply one of revision_id or --revision')
 
2178
        if revision_id_list is None and revision is None:
 
2179
            raise BzrCommandError('You must supply either --revision or a revision_id')
 
2180
        b = WorkingTree.open_containing(u'.')[0].branch
 
2181
        gpg_strategy = gpg.GPGStrategy(config.BranchConfig(b))
 
2182
        if revision_id_list is not None:
 
2183
            for revision_id in revision_id_list:
 
2184
                b.repository.sign_revision(revision_id, gpg_strategy)
 
2185
        elif revision is not None:
 
2186
            if len(revision) == 1:
 
2187
                revno, rev_id = revision[0].in_history(b)
 
2188
                b.repository.sign_revision(rev_id, gpg_strategy)
 
2189
            elif len(revision) == 2:
 
2190
                # are they both on rh- if so we can walk between them
 
2191
                # might be nice to have a range helper for arbitrary
 
2192
                # revision paths. hmm.
 
2193
                from_revno, from_revid = revision[0].in_history(b)
 
2194
                to_revno, to_revid = revision[1].in_history(b)
 
2195
                if to_revid is None:
 
2196
                    to_revno = b.revno()
 
2197
                if from_revno is None or to_revno is None:
 
2198
                    raise BzrCommandError('Cannot sign a range of non-revision-history revisions')
 
2199
                for revno in range(from_revno, to_revno + 1):
 
2200
                    b.repository.sign_revision(b.get_rev_id(revno), 
 
2201
                                               gpg_strategy)
 
2202
            else:
 
2203
                raise BzrCommandError('Please supply either one revision, or a range.')
 
2204
 
 
2205
 
 
2206
class cmd_bind(Command):
 
2207
    """Bind the current branch to a master branch.
 
2208
 
 
2209
    After binding, commits must succeed on the master branch
 
2210
    before they are executed on the local one.
 
2211
    """
 
2212
 
 
2213
    takes_args = ['location']
 
2214
    takes_options = []
 
2215
 
 
2216
    def run(self, location=None):
 
2217
        b, relpath = Branch.open_containing(u'.')
 
2218
        b_other = Branch.open(location)
 
2219
        try:
 
2220
            b.bind(b_other)
 
2221
        except DivergedBranches:
 
2222
            raise BzrCommandError('These branches have diverged.'
 
2223
                                  ' Try merging, and then bind again.')
 
2224
 
 
2225
 
 
2226
class cmd_unbind(Command):
 
2227
    """Bind the current branch to its parent.
 
2228
 
 
2229
    After unbinding, the local branch is considered independent.
 
2230
    """
 
2231
 
 
2232
    takes_args = []
 
2233
    takes_options = []
 
2234
 
 
2235
    def run(self):
 
2236
        b, relpath = Branch.open_containing(u'.')
 
2237
        if not b.unbind():
 
2238
            raise BzrCommandError('Local branch is not bound')
 
2239
 
 
2240
 
 
2241
class cmd_uncommit(bzrlib.commands.Command):
 
2242
    """Remove the last committed revision.
 
2243
 
 
2244
    By supplying the --all flag, it will not only remove the entry 
 
2245
    from revision_history, but also remove all of the entries in the
 
2246
    stores.
 
2247
 
 
2248
    --verbose will print out what is being removed.
 
2249
    --dry-run will go through all the motions, but not actually
 
2250
    remove anything.
 
2251
    
 
2252
    In the future, uncommit will create a changeset, which can then
 
2253
    be re-applied.
 
2254
    """
 
2255
 
 
2256
    # TODO: jam 20060108 Add an option to allow uncommit to remove
 
2257
    # unreferenced information in 'branch-as-repostory' branches.
 
2258
    # TODO: jam 20060108 Add the ability for uncommit to remove unreferenced
 
2259
    # information in shared branches as well.
 
2260
    takes_options = ['verbose', 'revision',
 
2261
                    Option('dry-run', help='Don\'t actually make changes'),
 
2262
                    Option('force', help='Say yes to all questions.')]
 
2263
    takes_args = ['location?']
 
2264
    aliases = []
 
2265
 
 
2266
    def run(self, location=None, 
 
2267
            dry_run=False, verbose=False,
 
2268
            revision=None, force=False):
 
2269
        from bzrlib.branch import Branch
 
2270
        from bzrlib.log import log_formatter
 
2271
        import sys
 
2272
        from bzrlib.uncommit import uncommit
 
2273
 
 
2274
        if location is None:
 
2275
            location = u'.'
 
2276
        control, relpath = bzrdir.BzrDir.open_containing(location)
 
2277
        b = control.open_branch()
 
2278
        try:
 
2279
            tree = control.open_workingtree()
 
2280
        except (errors.NoWorkingTree, errors.NotLocalUrl):
 
2281
            tree = None
 
2282
 
 
2283
        if revision is None:
 
2284
            revno = b.revno()
 
2285
            rev_id = b.last_revision()
 
2286
        else:
 
2287
            revno, rev_id = revision[0].in_history(b)
 
2288
        if rev_id is None:
 
2289
            print 'No revisions to uncommit.'
 
2290
 
 
2291
        for r in range(revno, b.revno()+1):
 
2292
            rev_id = b.get_rev_id(r)
 
2293
            lf = log_formatter('short', to_file=sys.stdout,show_timezone='original')
 
2294
            lf.show(r, b.repository.get_revision(rev_id), None)
 
2295
 
 
2296
        if dry_run:
 
2297
            print 'Dry-run, pretending to remove the above revisions.'
 
2298
            if not force:
 
2299
                val = raw_input('Press <enter> to continue')
 
2300
        else:
 
2301
            print 'The above revision(s) will be removed.'
 
2302
            if not force:
 
2303
                val = raw_input('Are you sure [y/N]? ')
 
2304
                if val.lower() not in ('y', 'yes'):
 
2305
                    print 'Canceled'
 
2306
                    return 0
 
2307
 
 
2308
        uncommit(b, tree=tree, dry_run=dry_run, verbose=verbose,
 
2309
                revno=revno)
 
2310
 
 
2311
 
 
2312
class cmd_break_lock(Command):
 
2313
    """Break a dead lock on a repository, branch or working directory.
 
2314
 
 
2315
    CAUTION: Locks should only be broken when you are sure that the process
 
2316
    holding the lock has been stopped.
 
2317
    
 
2318
    example:
 
2319
        bzr break-lock .
 
2320
    """
 
2321
    takes_args = ['location']
 
2322
    takes_options = [Option('show',
 
2323
                            help="just show information on the lock, " \
 
2324
                                 "don't break it"),
 
2325
                    ]
 
2326
    def run(self, location, show=False):
 
2327
        d = bzrdir.BzrDir.open(location)
 
2328
        repo = d.open_repository()
 
2329
        if not repo.is_locked():
 
2330
            raise errors.ObjectNotLocked(repo)
 
2331
 
 
2332
 
 
2333
# command-line interpretation helper for merge-related commands
 
2334
def merge(other_revision, base_revision,
 
2335
          check_clean=True, ignore_zero=False,
 
2336
          this_dir=None, backup_files=False, merge_type=Merge3Merger,
 
2337
          file_list=None, show_base=False, reprocess=False,
 
2338
          pb=DummyProgress()):
 
2339
    """Merge changes into a tree.
 
2340
 
 
2341
    base_revision
 
2342
        list(path, revno) Base for three-way merge.  
 
2343
        If [None, None] then a base will be automatically determined.
 
2344
    other_revision
 
2345
        list(path, revno) Other revision for three-way merge.
 
2346
    this_dir
 
2347
        Directory to merge changes into; '.' by default.
 
2348
    check_clean
 
2349
        If true, this_dir must have no uncommitted changes before the
 
2350
        merge begins.
 
2351
    ignore_zero - If true, suppress the "zero conflicts" message when 
 
2352
        there are no conflicts; should be set when doing something we expect
 
2353
        to complete perfectly.
 
2354
    file_list - If supplied, merge only changes to selected files.
 
2355
 
 
2356
    All available ancestors of other_revision and base_revision are
 
2357
    automatically pulled into the branch.
 
2358
 
 
2359
    The revno may be -1 to indicate the last revision on the branch, which is
 
2360
    the typical case.
 
2361
 
 
2362
    This function is intended for use from the command line; programmatic
 
2363
    clients might prefer to call merge.merge_inner(), which has less magic 
 
2364
    behavior.
 
2365
    """
 
2366
    from bzrlib.merge import Merger
 
2367
    if this_dir is None:
 
2368
        this_dir = u'.'
 
2369
    this_tree = WorkingTree.open_containing(this_dir)[0]
 
2370
    if show_base and not merge_type is Merge3Merger:
 
2371
        raise BzrCommandError("Show-base is not supported for this merge"
 
2372
                              " type. %s" % merge_type)
 
2373
    if reprocess and not merge_type is Merge3Merger:
 
2374
        raise BzrCommandError("Reprocess is not supported for this merge"
 
2375
                              " type. %s" % merge_type)
 
2376
    if reprocess and show_base:
 
2377
        raise BzrCommandError("Cannot reprocess and show base.")
 
2378
    try:
 
2379
        merger = Merger(this_tree.branch, this_tree=this_tree, pb=pb)
 
2380
        merger.pp = ProgressPhase("Merge phase", 5, pb)
 
2381
        merger.pp.next_phase()
 
2382
        merger.check_basis(check_clean)
 
2383
        merger.set_other(other_revision)
 
2384
        merger.pp.next_phase()
 
2385
        merger.set_base(base_revision)
 
2386
        if merger.base_rev_id == merger.other_rev_id:
 
2387
            note('Nothing to do.')
 
2388
            return 0
 
2389
        merger.backup_files = backup_files
 
2390
        merger.merge_type = merge_type 
 
2391
        merger.set_interesting_files(file_list)
 
2392
        merger.show_base = show_base 
 
2393
        merger.reprocess = reprocess
 
2394
        conflicts = merger.do_merge()
 
2395
        merger.set_pending()
 
2396
    finally:
 
2397
        pb.clear()
 
2398
    return conflicts
 
2399
 
 
2400
 
 
2401
# these get imported and then picked up by the scan for cmd_*
 
2402
# TODO: Some more consistent way to split command definitions across files;
 
2403
# we do need to load at least some information about them to know of 
 
2404
# aliases.  ideally we would avoid loading the implementation until the
 
2405
# details were needed.
 
2406
from bzrlib.conflicts import cmd_resolve, cmd_conflicts, restore
 
2407
from bzrlib.sign_my_commits import cmd_sign_my_commits
 
2408
from bzrlib.weave_commands import cmd_weave_list, cmd_weave_join