~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/builtins.py

  • Committer: Aaron Bentley
  • Date: 2006-11-10 01:55:55 UTC
  • mto: This revision was merged to the branch mainline in revision 2127.
  • Revision ID: aaron.bentley@utoronto.ca-20061110015555-f48202744b630209
Ignore html docs (both kinds)

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2004, 2005 by Canonical Ltd
2
 
 
 
1
# Copyright (C) 2004, 2005, 2006 Canonical Ltd
 
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
5
5
# the Free Software Foundation; either version 2 of the License, or
6
6
# (at your option) any later version.
7
 
 
 
7
#
8
8
# This program is distributed in the hope that it will be useful,
9
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11
11
# GNU General Public License for more details.
12
 
 
 
12
#
13
13
# You should have received a copy of the GNU General Public License
14
14
# along with this program; if not, write to the Free Software
15
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
16
16
 
17
 
 
 
17
"""builtin bzr commands"""
 
18
 
 
19
import os
 
20
 
 
21
from bzrlib.lazy_import import lazy_import
 
22
lazy_import(globals(), """
 
23
import codecs
 
24
import errno
18
25
import sys
19
 
import os
 
26
import tempfile
20
27
 
21
28
import bzrlib
22
 
from bzrlib import BZRDIR
23
 
from bzrlib.commands import Command
 
29
from bzrlib import (
 
30
    branch,
 
31
    bundle,
 
32
    bzrdir,
 
33
    config,
 
34
    errors,
 
35
    ignores,
 
36
    log,
 
37
    merge as _mod_merge,
 
38
    osutils,
 
39
    repository,
 
40
    transport,
 
41
    tree as _mod_tree,
 
42
    ui,
 
43
    urlutils,
 
44
    )
24
45
from bzrlib.branch import Branch
25
 
from bzrlib.errors import BzrError, BzrCheckError, BzrCommandError, NotBranchError
26
 
from bzrlib.errors import DivergedBranches
27
 
from bzrlib.option import Option
 
46
from bzrlib.bundle.apply_bundle import install_bundle, merge_bundle
 
47
from bzrlib.conflicts import ConflictList
 
48
from bzrlib.revision import common_ancestor
28
49
from bzrlib.revisionspec import RevisionSpec
29
 
import bzrlib.trace
30
 
from bzrlib.trace import mutter, note, log_error, warning
31
50
from bzrlib.workingtree import WorkingTree
32
 
 
 
51
""")
 
52
 
 
53
from bzrlib.commands import Command, display_command
 
54
from bzrlib.option import Option
 
55
from bzrlib.progress import DummyProgress, ProgressPhase
 
56
from bzrlib.trace import mutter, note, log_error, warning, is_quiet, info
 
57
 
 
58
 
 
59
def tree_files(file_list, default_branch=u'.'):
 
60
    try:
 
61
        return internal_tree_files(file_list, default_branch)
 
62
    except errors.FileInWrongBranch, e:
 
63
        raise errors.BzrCommandError("%s is not in the same branch as %s" %
 
64
                                     (e.path, file_list[0]))
 
65
 
 
66
 
 
67
# XXX: Bad function name; should possibly also be a class method of
 
68
# WorkingTree rather than a function.
 
69
def internal_tree_files(file_list, default_branch=u'.'):
 
70
    """Convert command-line paths to a WorkingTree and relative paths.
 
71
 
 
72
    This is typically used for command-line processors that take one or
 
73
    more filenames, and infer the workingtree that contains them.
 
74
 
 
75
    The filenames given are not required to exist.
 
76
 
 
77
    :param file_list: Filenames to convert.  
 
78
 
 
79
    :param default_branch: Fallback tree path to use if file_list is empty or
 
80
        None.
 
81
 
 
82
    :return: workingtree, [relative_paths]
 
83
    """
 
84
    if file_list is None or len(file_list) == 0:
 
85
        return WorkingTree.open_containing(default_branch)[0], file_list
 
86
    tree = WorkingTree.open_containing(osutils.realpath(file_list[0]))[0]
 
87
    new_list = []
 
88
    for filename in file_list:
 
89
        try:
 
90
            new_list.append(tree.relpath(osutils.dereference_path(filename)))
 
91
        except errors.PathNotChild:
 
92
            raise errors.FileInWrongBranch(tree.branch, filename)
 
93
    return tree, new_list
 
94
 
 
95
 
 
96
def get_format_type(typestring):
 
97
    """Parse and return a format specifier."""
 
98
    if typestring == "weave":
 
99
        return bzrdir.BzrDirFormat6()
 
100
    if typestring == "default":
 
101
        return bzrdir.BzrDirMetaFormat1()
 
102
    if typestring == "metaweave":
 
103
        format = bzrdir.BzrDirMetaFormat1()
 
104
        format.repository_format = repository.RepositoryFormat7()
 
105
        return format
 
106
    if typestring == "knit":
 
107
        format = bzrdir.BzrDirMetaFormat1()
 
108
        format.repository_format = repository.RepositoryFormatKnit1()
 
109
        return format
 
110
    if typestring == "experimental-knit2":
 
111
        format = bzrdir.BzrDirMetaFormat1()
 
112
        format.repository_format = repository.RepositoryFormatKnit2()
 
113
        return format
 
114
    msg = "Unknown bzr format %s. Current formats are: default, knit,\n" \
 
115
          "metaweave and weave" % typestring
 
116
    raise errors.BzrCommandError(msg)
 
117
 
 
118
 
 
119
# TODO: Make sure no commands unconditionally use the working directory as a
 
120
# branch.  If a filename argument is used, the first of them should be used to
 
121
# specify the branch.  (Perhaps this can be factored out into some kind of
 
122
# Argument class, representing a file in a branch, where the first occurrence
 
123
# opens the branch?)
33
124
 
34
125
class cmd_status(Command):
35
126
    """Display status summary.
52
143
    modified
53
144
        Text has changed since the previous revision.
54
145
 
55
 
    unchanged
56
 
        Nothing about this file has changed since the previous revision.
57
 
        Only shown with --all.
58
 
 
59
146
    unknown
60
147
        Not versioned and not matching an ignore pattern.
61
148
 
71
158
    that revision, or between two revisions if two are provided.
72
159
    """
73
160
    
74
 
    # XXX: FIXME: bzr status should accept a -r option to show changes
75
 
    # relative to a revision, or between revisions
76
 
 
77
161
    # TODO: --no-recurse, --recurse options
78
162
    
79
163
    takes_args = ['file*']
80
 
    takes_options = ['all', 'show-ids']
 
164
    takes_options = ['show-ids', 'revision']
81
165
    aliases = ['st', 'stat']
 
166
 
 
167
    encoding_type = 'replace'
82
168
    
83
 
    def run(self, all=False, show_ids=False, file_list=None, revision=None):
84
 
        if file_list:
85
 
            b, relpath = Branch.open_containing(file_list[0])
86
 
            if relpath == '' and len(file_list) == 1:
87
 
                file_list = None
88
 
            else:
89
 
                # generate relative paths.
90
 
                # note that if this is a remote branch, we would want
91
 
                # relpath against the transport. RBC 20051018
92
 
                tree = WorkingTree(b.base, b)
93
 
                file_list = [tree.relpath(x) for x in file_list]
94
 
        else:
95
 
            b = Branch.open_containing('.')[0]
 
169
    @display_command
 
170
    def run(self, show_ids=False, file_list=None, revision=None):
 
171
        from bzrlib.status import show_tree_status
 
172
 
 
173
        tree, file_list = tree_files(file_list)
96
174
            
97
 
        from bzrlib.status import show_status
98
 
        show_status(b, show_unchanged=all, show_ids=show_ids,
99
 
                    specific_files=file_list, revision=revision)
 
175
        show_tree_status(tree, show_ids=show_ids,
 
176
                         specific_files=file_list, revision=revision,
 
177
                         to_file=self.outf)
100
178
 
101
179
 
102
180
class cmd_cat_revision(Command):
109
187
    hidden = True
110
188
    takes_args = ['revision_id?']
111
189
    takes_options = ['revision']
 
190
    # cat-revision is more for frontends so should be exact
 
191
    encoding = 'strict'
112
192
    
 
193
    @display_command
113
194
    def run(self, revision_id=None, revision=None):
114
195
 
115
196
        if revision_id is not None and revision is not None:
116
 
            raise BzrCommandError('You can only supply one of revision_id or --revision')
 
197
            raise errors.BzrCommandError('You can only supply one of'
 
198
                                         ' revision_id or --revision')
117
199
        if revision_id is None and revision is None:
118
 
            raise BzrCommandError('You must supply either --revision or a revision_id')
119
 
        b = Branch.open_containing('.')[0]
 
200
            raise errors.BzrCommandError('You must supply either'
 
201
                                         ' --revision or a revision_id')
 
202
        b = WorkingTree.open_containing(u'.')[0].branch
 
203
 
 
204
        # TODO: jam 20060112 should cat-revision always output utf-8?
120
205
        if revision_id is not None:
121
 
            sys.stdout.write(b.get_revision_xml_file(revision_id).read())
 
206
            self.outf.write(b.repository.get_revision_xml(revision_id).decode('utf-8'))
122
207
        elif revision is not None:
123
208
            for rev in revision:
124
209
                if rev is None:
125
 
                    raise BzrCommandError('You cannot specify a NULL revision.')
 
210
                    raise errors.BzrCommandError('You cannot specify a NULL'
 
211
                                                 ' revision.')
126
212
                revno, rev_id = rev.in_history(b)
127
 
                sys.stdout.write(b.get_revision_xml_file(rev_id).read())
 
213
                self.outf.write(b.repository.get_revision_xml(rev_id).decode('utf-8'))
128
214
    
129
215
 
130
216
class cmd_revno(Command):
131
217
    """Show current revision number.
132
218
 
133
 
    This is equal to the number of revisions on this branch."""
134
 
    def run(self):
135
 
        print Branch.open_containing('.')[0].revno()
 
219
    This is equal to the number of revisions on this branch.
 
220
    """
 
221
 
 
222
    takes_args = ['location?']
 
223
 
 
224
    @display_command
 
225
    def run(self, location=u'.'):
 
226
        self.outf.write(str(Branch.open_containing(location)[0].revno()))
 
227
        self.outf.write('\n')
136
228
 
137
229
 
138
230
class cmd_revision_info(Command):
141
233
    hidden = True
142
234
    takes_args = ['revision_info*']
143
235
    takes_options = ['revision']
 
236
 
 
237
    @display_command
144
238
    def run(self, revision=None, revision_info_list=[]):
145
239
 
146
240
        revs = []
148
242
            revs.extend(revision)
149
243
        if revision_info_list is not None:
150
244
            for rev in revision_info_list:
151
 
                revs.append(RevisionSpec(rev))
 
245
                revs.append(RevisionSpec.from_string(rev))
152
246
        if len(revs) == 0:
153
 
            raise BzrCommandError('You must supply a revision identifier')
 
247
            raise errors.BzrCommandError('You must supply a revision identifier')
154
248
 
155
 
        b = Branch.open_containing('.')[0]
 
249
        b = WorkingTree.open_containing(u'.')[0].branch
156
250
 
157
251
        for rev in revs:
158
252
            revinfo = rev.in_history(b)
182
276
 
183
277
    Adding a file whose parent directory is not versioned will
184
278
    implicitly add the parent, and so on up to the root. This means
185
 
    you should never need to explictly add a directory, they'll just
 
279
    you should never need to explicitly add a directory, they'll just
186
280
    get added when you add a file in the directory.
 
281
 
 
282
    --dry-run will show which files would be added, but not actually 
 
283
    add them.
 
284
 
 
285
    --file-ids-from will try to use the file ids from the supplied path.
 
286
    It looks up ids trying to find a matching parent directory with the
 
287
    same filename, and then by pure path.
187
288
    """
188
289
    takes_args = ['file*']
189
 
    takes_options = ['no-recurse', 'quiet']
190
 
    
191
 
    def run(self, file_list, no_recurse=False, quiet=False):
192
 
        from bzrlib.add import smart_add, add_reporter_print, add_reporter_null
193
 
        if quiet:
194
 
            reporter = add_reporter_null
 
290
    takes_options = ['no-recurse', 'dry-run', 'verbose',
 
291
                     Option('file-ids-from', type=unicode,
 
292
                            help='Lookup file ids from here')]
 
293
    encoding_type = 'replace'
 
294
 
 
295
    def run(self, file_list, no_recurse=False, dry_run=False, verbose=False,
 
296
            file_ids_from=None):
 
297
        import bzrlib.add
 
298
 
 
299
        if file_ids_from is not None:
 
300
            try:
 
301
                base_tree, base_path = WorkingTree.open_containing(
 
302
                                            file_ids_from)
 
303
            except errors.NoWorkingTree:
 
304
                base_branch, base_path = Branch.open_containing(
 
305
                                            file_ids_from)
 
306
                base_tree = base_branch.basis_tree()
 
307
 
 
308
            action = bzrlib.add.AddFromBaseAction(base_tree, base_path,
 
309
                          to_file=self.outf, should_print=(not is_quiet()))
195
310
        else:
196
 
            reporter = add_reporter_print
197
 
        smart_add(file_list, not no_recurse, reporter)
 
311
            action = bzrlib.add.AddAction(to_file=self.outf,
 
312
                should_print=(not is_quiet()))
 
313
 
 
314
        added, ignored = bzrlib.add.smart_add(file_list, not no_recurse,
 
315
                                              action=action, save=not dry_run)
 
316
        if len(ignored) > 0:
 
317
            if verbose:
 
318
                for glob in sorted(ignored.keys()):
 
319
                    for path in ignored[glob]:
 
320
                        self.outf.write("ignored %s matching \"%s\"\n" 
 
321
                                        % (path, glob))
 
322
            else:
 
323
                match_len = 0
 
324
                for glob, paths in ignored.items():
 
325
                    match_len += len(paths)
 
326
                self.outf.write("ignored %d file(s).\n" % match_len)
 
327
            self.outf.write("If you wish to add some of these files,"
 
328
                            " please add them by name.\n")
198
329
 
199
330
 
200
331
class cmd_mkdir(Command):
202
333
 
203
334
    This is equivalent to creating the directory and then adding it.
204
335
    """
 
336
 
205
337
    takes_args = ['dir+']
 
338
    encoding_type = 'replace'
206
339
 
207
340
    def run(self, dir_list):
208
 
        b = None
209
 
        
210
341
        for d in dir_list:
211
342
            os.mkdir(d)
212
 
            if not b:
213
 
                b = Branch.open_containing(d)[0]
214
 
            b.add([d])
215
 
            print 'added', d
 
343
            wt, dd = WorkingTree.open_containing(d)
 
344
            wt.add([dd])
 
345
            self.outf.write('added %s\n' % d)
216
346
 
217
347
 
218
348
class cmd_relpath(Command):
219
349
    """Show path of a file relative to root"""
 
350
 
220
351
    takes_args = ['filename']
221
352
    hidden = True
222
353
    
 
354
    @display_command
223
355
    def run(self, filename):
224
 
        branch, relpath = Branch.open_containing(filename)
225
 
        print relpath
 
356
        # TODO: jam 20050106 Can relpath return a munged path if
 
357
        #       sys.stdout encoding cannot represent it?
 
358
        tree, relpath = WorkingTree.open_containing(filename)
 
359
        self.outf.write(relpath)
 
360
        self.outf.write('\n')
226
361
 
227
362
 
228
363
class cmd_inventory(Command):
229
 
    """Show inventory of the current working copy or a revision."""
230
 
    takes_options = ['revision', 'show-ids']
231
 
    
232
 
    def run(self, revision=None, show_ids=False):
233
 
        b = Branch.open_containing('.')[0]
234
 
        if revision is None:
235
 
            inv = b.read_working_inventory()
236
 
        else:
 
364
    """Show inventory of the current working copy or a revision.
 
365
 
 
366
    It is possible to limit the output to a particular entry
 
367
    type using the --kind option.  For example: --kind file.
 
368
 
 
369
    It is also possible to restrict the list of files to a specific
 
370
    set. For example: bzr inventory --show-ids this/file
 
371
    """
 
372
 
 
373
    takes_options = ['revision', 'show-ids', 'kind']
 
374
    takes_args = ['file*']
 
375
 
 
376
    @display_command
 
377
    def run(self, revision=None, show_ids=False, kind=None, file_list=None):
 
378
        if kind and kind not in ['file', 'directory', 'symlink']:
 
379
            raise errors.BzrCommandError('invalid kind specified')
 
380
 
 
381
        work_tree, file_list = tree_files(file_list)
 
382
 
 
383
        if revision is not None:
237
384
            if len(revision) > 1:
238
 
                raise BzrCommandError('bzr inventory --revision takes'
239
 
                    ' exactly one revision identifier')
240
 
            inv = b.get_revision_inventory(revision[0].in_history(b).rev_id)
241
 
 
242
 
        for path, entry in inv.entries():
 
385
                raise errors.BzrCommandError('bzr inventory --revision takes'
 
386
                                             ' exactly one revision identifier')
 
387
            revision_id = revision[0].in_history(work_tree.branch).rev_id
 
388
            tree = work_tree.branch.repository.revision_tree(revision_id)
 
389
                        
 
390
            # We include work_tree as well as 'tree' here
 
391
            # So that doing '-r 10 path/foo' will lookup whatever file
 
392
            # exists now at 'path/foo' even if it has been renamed, as
 
393
            # well as whatever files existed in revision 10 at path/foo
 
394
            trees = [tree, work_tree]
 
395
        else:
 
396
            tree = work_tree
 
397
            trees = [tree]
 
398
 
 
399
        if file_list is not None:
 
400
            file_ids = _mod_tree.find_ids_across_trees(file_list, trees,
 
401
                                                      require_versioned=True)
 
402
            # find_ids_across_trees may include some paths that don't
 
403
            # exist in 'tree'.
 
404
            entries = sorted((tree.id2path(file_id), tree.inventory[file_id])
 
405
                             for file_id in file_ids if file_id in tree)
 
406
        else:
 
407
            entries = tree.inventory.entries()
 
408
 
 
409
        for path, entry in entries:
 
410
            if kind and kind != entry.kind:
 
411
                continue
243
412
            if show_ids:
244
 
                print '%-50s %s' % (path, entry.file_id)
 
413
                self.outf.write('%-50s %s\n' % (path, entry.file_id))
245
414
            else:
246
 
                print path
247
 
 
248
 
 
249
 
class cmd_move(Command):
250
 
    """Move files to a different directory.
251
 
 
252
 
    examples:
253
 
        bzr move *.txt doc
254
 
 
255
 
    The destination must be a versioned directory in the same branch.
256
 
    """
257
 
    takes_args = ['source$', 'dest']
258
 
    def run(self, source_list, dest):
259
 
        b = Branch.open_containing('.')[0]
260
 
 
261
 
        # TODO: glob expansion on windows?
262
 
        tree = WorkingTree(b.base, b)
263
 
        b.move([tree.relpath(s) for s in source_list], tree.relpath(dest))
264
 
 
265
 
 
266
 
class cmd_rename(Command):
267
 
    """Change the name of an entry.
268
 
 
269
 
    examples:
270
 
      bzr rename frob.c frobber.c
271
 
      bzr rename src/frob.c lib/frob.c
272
 
 
273
 
    It is an error if the destination name exists.
274
 
 
275
 
    See also the 'move' command, which moves files into a different
276
 
    directory without changing their name.
277
 
    """
278
 
    # TODO: Some way to rename multiple files without invoking 
279
 
    # bzr for each one?"""
280
 
    takes_args = ['from_name', 'to_name']
281
 
    
282
 
    def run(self, from_name, to_name):
283
 
        b = Branch.open_containing('.')[0]
284
 
        tree = WorkingTree(b.base, b)
285
 
        b.rename_one(tree.relpath(from_name), tree.relpath(to_name))
 
415
                self.outf.write(path)
 
416
                self.outf.write('\n')
286
417
 
287
418
 
288
419
class cmd_mv(Command):
298
429
 
299
430
    Files cannot be moved between branches.
300
431
    """
 
432
 
301
433
    takes_args = ['names*']
 
434
    aliases = ['move', 'rename']
 
435
    encoding_type = 'replace'
 
436
 
302
437
    def run(self, names_list):
 
438
        if names_list is None:
 
439
            names_list = []
 
440
 
303
441
        if len(names_list) < 2:
304
 
            raise BzrCommandError("missing file argument")
305
 
        b = Branch.open_containing(names_list[0])[0]
306
 
        tree = WorkingTree(b.base, b)
307
 
        rel_names = [tree.relpath(x) for x in names_list]
 
442
            raise errors.BzrCommandError("missing file argument")
 
443
        tree, rel_names = tree_files(names_list)
308
444
        
309
445
        if os.path.isdir(names_list[-1]):
310
446
            # move into existing directory
311
 
            for pair in b.move(rel_names[:-1], rel_names[-1]):
312
 
                print "%s => %s" % pair
 
447
            for pair in tree.move(rel_names[:-1], rel_names[-1]):
 
448
                self.outf.write("%s => %s\n" % pair)
313
449
        else:
314
450
            if len(names_list) != 2:
315
 
                raise BzrCommandError('to mv multiple files the destination '
316
 
                                      'must be a versioned directory')
317
 
            b.rename_one(rel_names[0], rel_names[1])
318
 
            print "%s => %s" % (rel_names[0], rel_names[1])
 
451
                raise errors.BzrCommandError('to mv multiple files the destination '
 
452
                                             'must be a versioned directory')
 
453
            tree.rename_one(rel_names[0], rel_names[1])
 
454
            self.outf.write("%s => %s\n" % (rel_names[0], rel_names[1]))
319
455
            
320
456
    
321
 
 
322
 
 
323
457
class cmd_pull(Command):
324
 
    """Pull any changes from another branch into the current one.
325
 
 
326
 
    If the location is omitted, the last-used location will be used.
327
 
    Both the revision history and the working directory will be
328
 
    updated.
329
 
 
330
 
    This command only works on branches that have not diverged.  Branches are
331
 
    considered diverged if both branches have had commits without first
332
 
    pulling from the other.
333
 
 
334
 
    If branches have diverged, you can use 'bzr merge' to pull the text changes
335
 
    from one into the other.
336
 
    """
337
 
    takes_options = ['remember', 'clobber']
338
 
    takes_args = ['location?']
339
 
 
340
 
    def run(self, location=None, remember=False, clobber=False):
341
 
        from bzrlib.merge import merge
342
 
        import tempfile
343
 
        from shutil import rmtree
344
 
        import errno
 
458
    """Turn this branch into a mirror of another branch.
 
459
 
 
460
    This command only works on branches that have not diverged.  Branches are
 
461
    considered diverged if the destination branch's most recent commit is one
 
462
    that has not been merged (directly or indirectly) into the parent.
 
463
 
 
464
    If branches have diverged, you can use 'bzr merge' to integrate the changes
 
465
    from one into the other.  Once one branch has merged, the other should
 
466
    be able to pull it again.
 
467
 
 
468
    If you want to forget your local changes and just update your branch to
 
469
    match the remote one, use pull --overwrite.
 
470
 
 
471
    If there is no default location set, the first pull will set it.  After
 
472
    that, you can omit the location to use the default.  To change the
 
473
    default, use --remember. The value will only be saved if the remote
 
474
    location can be accessed.
 
475
    """
 
476
 
 
477
    takes_options = ['remember', 'overwrite', 'revision', 'verbose']
 
478
    takes_args = ['location?']
 
479
    encoding_type = 'replace'
 
480
 
 
481
    def run(self, location=None, remember=False, overwrite=False, revision=None, verbose=False):
 
482
        # FIXME: too much stuff is in the command class
 
483
        try:
 
484
            tree_to = WorkingTree.open_containing(u'.')[0]
 
485
            branch_to = tree_to.branch
 
486
        except errors.NoWorkingTree:
 
487
            tree_to = None
 
488
            branch_to = Branch.open_containing(u'.')[0]
 
489
 
 
490
        reader = None
 
491
        if location is not None:
 
492
            try:
 
493
                reader = bundle.read_bundle_from_url(location)
 
494
            except errors.NotABundle:
 
495
                pass # Continue on considering this url a Branch
 
496
 
 
497
        stored_loc = branch_to.get_parent()
 
498
        if location is None:
 
499
            if stored_loc is None:
 
500
                raise errors.BzrCommandError("No pull location known or"
 
501
                                             " specified.")
 
502
            else:
 
503
                display_url = urlutils.unescape_for_display(stored_loc,
 
504
                        self.outf.encoding)
 
505
                self.outf.write("Using saved location: %s\n" % display_url)
 
506
                location = stored_loc
 
507
 
 
508
 
 
509
        if reader is not None:
 
510
            install_bundle(branch_to.repository, reader)
 
511
            branch_from = branch_to
 
512
        else:
 
513
            branch_from = Branch.open(location)
 
514
 
 
515
            if branch_to.get_parent() is None or remember:
 
516
                branch_to.set_parent(branch_from.base)
 
517
 
 
518
        rev_id = None
 
519
        if revision is None:
 
520
            if reader is not None:
 
521
                rev_id = reader.target
 
522
        elif len(revision) == 1:
 
523
            rev_id = revision[0].in_history(branch_from).rev_id
 
524
        else:
 
525
            raise errors.BzrCommandError('bzr pull --revision takes one value.')
 
526
 
 
527
        old_rh = branch_to.revision_history()
 
528
        if tree_to is not None:
 
529
            count = tree_to.pull(branch_from, overwrite, rev_id)
 
530
        else:
 
531
            count = branch_to.pull(branch_from, overwrite, rev_id)
 
532
        note('%d revision(s) pulled.' % (count,))
 
533
 
 
534
        if verbose:
 
535
            new_rh = branch_to.revision_history()
 
536
            if old_rh != new_rh:
 
537
                # Something changed
 
538
                from bzrlib.log import show_changed_revisions
 
539
                show_changed_revisions(branch_to, old_rh, new_rh,
 
540
                                       to_file=self.outf)
 
541
 
 
542
 
 
543
class cmd_push(Command):
 
544
    """Update a mirror of this branch.
 
545
    
 
546
    The target branch will not have its working tree populated because this
 
547
    is both expensive, and is not supported on remote file systems.
 
548
    
 
549
    Some smart servers or protocols *may* put the working tree in place in
 
550
    the future.
 
551
 
 
552
    This command only works on branches that have not diverged.  Branches are
 
553
    considered diverged if the destination branch's most recent commit is one
 
554
    that has not been merged (directly or indirectly) by the source branch.
 
555
 
 
556
    If branches have diverged, you can use 'bzr push --overwrite' to replace
 
557
    the other branch completely, discarding its unmerged changes.
 
558
    
 
559
    If you want to ensure you have the different changes in the other branch,
 
560
    do a merge (see bzr help merge) from the other branch, and commit that.
 
561
    After that you will be able to do a push without '--overwrite'.
 
562
 
 
563
    If there is no default push location set, the first push will set it.
 
564
    After that, you can omit the location to use the default.  To change the
 
565
    default, use --remember. The value will only be saved if the remote
 
566
    location can be accessed.
 
567
    """
 
568
 
 
569
    takes_options = ['remember', 'overwrite', 'verbose',
 
570
                     Option('create-prefix', 
 
571
                            help='Create the path leading up to the branch '
 
572
                                 'if it does not already exist')]
 
573
    takes_args = ['location?']
 
574
    encoding_type = 'replace'
 
575
 
 
576
    def run(self, location=None, remember=False, overwrite=False,
 
577
            create_prefix=False, verbose=False):
 
578
        # FIXME: Way too big!  Put this into a function called from the
 
579
        # command.
345
580
        
346
 
        br_to = Branch.open_containing('.')[0]
347
 
        stored_loc = br_to.get_parent()
 
581
        br_from = Branch.open_containing('.')[0]
 
582
        stored_loc = br_from.get_push_location()
348
583
        if location is None:
349
584
            if stored_loc is None:
350
 
                raise BzrCommandError("No pull location known or specified.")
 
585
                raise errors.BzrCommandError("No push location known or specified.")
351
586
            else:
352
 
                print "Using saved location: %s" % stored_loc
 
587
                display_url = urlutils.unescape_for_display(stored_loc,
 
588
                        self.outf.encoding)
 
589
                self.outf.write("Using saved location: %s\n" % display_url)
353
590
                location = stored_loc
354
 
        br_from = Branch.open(location)
 
591
 
 
592
        to_transport = transport.get_transport(location)
 
593
        location_url = to_transport.base
 
594
 
 
595
        old_rh = []
355
596
        try:
356
 
            br_to.working_tree().pull(br_from, remember, clobber)
357
 
        except DivergedBranches:
358
 
            raise BzrCommandError("These branches have diverged."
359
 
                                  "  Try merge.")
 
597
            dir_to = bzrdir.BzrDir.open(location_url)
 
598
            br_to = dir_to.open_branch()
 
599
        except errors.NotBranchError:
 
600
            # create a branch.
 
601
            to_transport = to_transport.clone('..')
 
602
            if not create_prefix:
 
603
                try:
 
604
                    relurl = to_transport.relpath(location_url)
 
605
                    mutter('creating directory %s => %s', location_url, relurl)
 
606
                    to_transport.mkdir(relurl)
 
607
                except errors.NoSuchFile:
 
608
                    raise errors.BzrCommandError("Parent directory of %s "
 
609
                                                 "does not exist." % location)
 
610
            else:
 
611
                current = to_transport.base
 
612
                needed = [(to_transport, to_transport.relpath(location_url))]
 
613
                while needed:
 
614
                    try:
 
615
                        to_transport, relpath = needed[-1]
 
616
                        to_transport.mkdir(relpath)
 
617
                        needed.pop()
 
618
                    except errors.NoSuchFile:
 
619
                        new_transport = to_transport.clone('..')
 
620
                        needed.append((new_transport,
 
621
                                       new_transport.relpath(to_transport.base)))
 
622
                        if new_transport.base == to_transport.base:
 
623
                            raise errors.BzrCommandError("Could not create "
 
624
                                                         "path prefix.")
 
625
            dir_to = br_from.bzrdir.clone(location_url,
 
626
                revision_id=br_from.last_revision())
 
627
            br_to = dir_to.open_branch()
 
628
            count = len(br_to.revision_history())
 
629
            # We successfully created the target, remember it
 
630
            if br_from.get_push_location() is None or remember:
 
631
                br_from.set_push_location(br_to.base)
 
632
        else:
 
633
            # We were able to connect to the remote location, so remember it
 
634
            # we don't need to successfully push because of possible divergence.
 
635
            if br_from.get_push_location() is None or remember:
 
636
                br_from.set_push_location(br_to.base)
 
637
            old_rh = br_to.revision_history()
 
638
            try:
 
639
                try:
 
640
                    tree_to = dir_to.open_workingtree()
 
641
                except errors.NotLocalUrl:
 
642
                    warning('This transport does not update the working '
 
643
                            'tree of: %s' % (br_to.base,))
 
644
                    count = br_to.pull(br_from, overwrite)
 
645
                except errors.NoWorkingTree:
 
646
                    count = br_to.pull(br_from, overwrite)
 
647
                else:
 
648
                    count = tree_to.pull(br_from, overwrite)
 
649
            except errors.DivergedBranches:
 
650
                raise errors.BzrCommandError('These branches have diverged.'
 
651
                                        '  Try using "merge" and then "push".')
 
652
        note('%d revision(s) pushed.' % (count,))
 
653
 
 
654
        if verbose:
 
655
            new_rh = br_to.revision_history()
 
656
            if old_rh != new_rh:
 
657
                # Something changed
 
658
                from bzrlib.log import show_changed_revisions
 
659
                show_changed_revisions(br_to, old_rh, new_rh,
 
660
                                       to_file=self.outf)
360
661
 
361
662
 
362
663
class cmd_branch(Command):
377
678
    aliases = ['get', 'clone']
378
679
 
379
680
    def run(self, from_location, to_location=None, revision=None, basis=None):
380
 
        from bzrlib.clone import copy_branch
381
 
        import tempfile
382
 
        import errno
383
 
        from shutil import rmtree
384
 
        cache_root = tempfile.mkdtemp()
385
681
        if revision is None:
386
682
            revision = [None]
387
683
        elif len(revision) > 1:
388
 
            raise BzrCommandError(
 
684
            raise errors.BzrCommandError(
389
685
                'bzr branch --revision takes exactly 1 revision value')
390
686
        try:
391
687
            br_from = Branch.open(from_location)
392
688
        except OSError, e:
393
689
            if e.errno == errno.ENOENT:
394
 
                raise BzrCommandError('Source location "%s" does not'
395
 
                                      ' exist.' % to_location)
 
690
                raise errors.BzrCommandError('Source location "%s" does not'
 
691
                                             ' exist.' % to_location)
396
692
            else:
397
693
                raise
398
694
        br_from.lock_read()
399
695
        try:
400
 
            br_from.setup_caching(cache_root)
401
696
            if basis is not None:
402
 
                basis_branch = Branch.open_containing(basis)[0]
 
697
                basis_dir = bzrdir.BzrDir.open_containing(basis)[0]
403
698
            else:
404
 
                basis_branch = None
 
699
                basis_dir = None
405
700
            if len(revision) == 1 and revision[0] is not None:
406
701
                revision_id = revision[0].in_history(br_from)[1]
407
702
            else:
408
 
                revision_id = None
 
703
                # FIXME - wt.last_revision, fallback to branch, fall back to
 
704
                # None or perhaps NULL_REVISION to mean copy nothing
 
705
                # RBC 20060209
 
706
                revision_id = br_from.last_revision()
409
707
            if to_location is None:
410
708
                to_location = os.path.basename(from_location.rstrip("/\\"))
411
 
            try:
412
 
                os.mkdir(to_location)
413
 
            except OSError, e:
414
 
                if e.errno == errno.EEXIST:
415
 
                    raise BzrCommandError('Target directory "%s" already'
416
 
                                          ' exists.' % to_location)
417
 
                if e.errno == errno.ENOENT:
418
 
                    raise BzrCommandError('Parent of "%s" does not exist.' %
419
 
                                          to_location)
420
 
                else:
421
 
                    raise
422
 
            try:
423
 
                copy_branch(br_from, to_location, revision_id, basis_branch)
424
 
            except bzrlib.errors.NoSuchRevision:
425
 
                rmtree(to_location)
 
709
                name = None
 
710
            else:
 
711
                name = os.path.basename(to_location) + '\n'
 
712
 
 
713
            to_transport = transport.get_transport(to_location)
 
714
            try:
 
715
                to_transport.mkdir('.')
 
716
            except errors.FileExists:
 
717
                raise errors.BzrCommandError('Target directory "%s" already'
 
718
                                             ' exists.' % to_location)
 
719
            except errors.NoSuchFile:
 
720
                raise errors.BzrCommandError('Parent of "%s" does not exist.'
 
721
                                             % to_location)
 
722
            try:
 
723
                # preserve whatever source format we have.
 
724
                dir = br_from.bzrdir.sprout(to_transport.base,
 
725
                        revision_id, basis_dir)
 
726
                branch = dir.open_branch()
 
727
            except errors.NoSuchRevision:
 
728
                to_transport.delete_tree('.')
426
729
                msg = "The branch %s has no revision %s." % (from_location, revision[0])
427
 
                raise BzrCommandError(msg)
428
 
            except bzrlib.errors.UnlistableBranch:
429
 
                msg = "The branch %s cannot be used as a --basis"
 
730
                raise errors.BzrCommandError(msg)
 
731
            except errors.UnlistableBranch:
 
732
                osutils.rmtree(to_location)
 
733
                msg = "The branch %s cannot be used as a --basis" % (basis,)
 
734
                raise errors.BzrCommandError(msg)
 
735
            if name:
 
736
                branch.control_files.put_utf8('branch-name', name)
 
737
            note('Branched %d revision(s).' % branch.revno())
430
738
        finally:
431
739
            br_from.unlock()
432
 
            rmtree(cache_root)
 
740
 
 
741
 
 
742
class cmd_checkout(Command):
 
743
    """Create a new checkout of an existing branch.
 
744
 
 
745
    If BRANCH_LOCATION is omitted, checkout will reconstitute a working tree for
 
746
    the branch found in '.'. This is useful if you have removed the working tree
 
747
    or if it was never created - i.e. if you pushed the branch to its current
 
748
    location using SFTP.
 
749
    
 
750
    If the TO_LOCATION is omitted, the last component of the BRANCH_LOCATION will
 
751
    be used.  In other words, "checkout ../foo/bar" will attempt to create ./bar.
 
752
 
 
753
    To retrieve the branch as of a particular revision, supply the --revision
 
754
    parameter, as in "checkout foo/bar -r 5". Note that this will be immediately
 
755
    out of date [so you cannot commit] but it may be useful (i.e. to examine old
 
756
    code.)
 
757
 
 
758
    --basis is to speed up checking out from remote branches.  When specified, it
 
759
    uses the inventory and file contents from the basis branch in preference to the
 
760
    branch being checked out.
 
761
    """
 
762
    takes_args = ['branch_location?', 'to_location?']
 
763
    takes_options = ['revision', # , 'basis']
 
764
                     Option('lightweight',
 
765
                            help="perform a lightweight checkout. Lightweight "
 
766
                                 "checkouts depend on access to the branch for "
 
767
                                 "every operation. Normal checkouts can perform "
 
768
                                 "common operations like diff and status without "
 
769
                                 "such access, and also support local commits."
 
770
                            ),
 
771
                     ]
 
772
    aliases = ['co']
 
773
 
 
774
    def run(self, branch_location=None, to_location=None, revision=None, basis=None,
 
775
            lightweight=False):
 
776
        if revision is None:
 
777
            revision = [None]
 
778
        elif len(revision) > 1:
 
779
            raise errors.BzrCommandError(
 
780
                'bzr checkout --revision takes exactly 1 revision value')
 
781
        if branch_location is None:
 
782
            branch_location = osutils.getcwd()
 
783
            to_location = branch_location
 
784
        source = Branch.open(branch_location)
 
785
        if len(revision) == 1 and revision[0] is not None:
 
786
            revision_id = revision[0].in_history(source)[1]
 
787
        else:
 
788
            revision_id = None
 
789
        if to_location is None:
 
790
            to_location = os.path.basename(branch_location.rstrip("/\\"))
 
791
        # if the source and to_location are the same, 
 
792
        # and there is no working tree,
 
793
        # then reconstitute a branch
 
794
        if (osutils.abspath(to_location) ==
 
795
            osutils.abspath(branch_location)):
 
796
            try:
 
797
                source.bzrdir.open_workingtree()
 
798
            except errors.NoWorkingTree:
 
799
                source.bzrdir.create_workingtree()
 
800
                return
 
801
        try:
 
802
            os.mkdir(to_location)
 
803
        except OSError, e:
 
804
            if e.errno == errno.EEXIST:
 
805
                raise errors.BzrCommandError('Target directory "%s" already'
 
806
                                             ' exists.' % to_location)
 
807
            if e.errno == errno.ENOENT:
 
808
                raise errors.BzrCommandError('Parent of "%s" does not exist.'
 
809
                                             % to_location)
 
810
            else:
 
811
                raise
 
812
        old_format = bzrdir.BzrDirFormat.get_default_format()
 
813
        bzrdir.BzrDirFormat.set_default_format(bzrdir.BzrDirMetaFormat1())
 
814
        try:
 
815
            source.create_checkout(to_location, revision_id, lightweight)
 
816
        finally:
 
817
            bzrdir.BzrDirFormat.set_default_format(old_format)
433
818
 
434
819
 
435
820
class cmd_renames(Command):
440
825
    # TODO: Only show renames under dir, rather than in the whole branch.
441
826
    takes_args = ['dir?']
442
827
 
443
 
    def run(self, dir='.'):
444
 
        b = Branch.open_containing(dir)[0]
445
 
        old_inv = b.basis_tree().inventory
446
 
        new_inv = b.read_working_inventory()
447
 
 
448
 
        renames = list(bzrlib.tree.find_renames(old_inv, new_inv))
 
828
    @display_command
 
829
    def run(self, dir=u'.'):
 
830
        tree = WorkingTree.open_containing(dir)[0]
 
831
        old_inv = tree.basis_tree().inventory
 
832
        new_inv = tree.read_working_inventory()
 
833
        renames = list(_mod_tree.find_renames(old_inv, new_inv))
449
834
        renames.sort()
450
835
        for old_name, new_name in renames:
451
 
            print "%s => %s" % (old_name, new_name)        
 
836
            self.outf.write("%s => %s\n" % (old_name, new_name))
 
837
 
 
838
 
 
839
class cmd_update(Command):
 
840
    """Update a tree to have the latest code committed to its branch.
 
841
    
 
842
    This will perform a merge into the working tree, and may generate
 
843
    conflicts. If you have any local changes, you will still 
 
844
    need to commit them after the update for the update to be complete.
 
845
    
 
846
    If you want to discard your local changes, you can just do a 
 
847
    'bzr revert' instead of 'bzr commit' after the update.
 
848
    """
 
849
    takes_args = ['dir?']
 
850
    aliases = ['up']
 
851
 
 
852
    def run(self, dir='.'):
 
853
        tree = WorkingTree.open_containing(dir)[0]
 
854
        master = tree.branch.get_master_branch()
 
855
        if master is not None:
 
856
            tree.lock_write()
 
857
        else:
 
858
            tree.lock_tree_write()
 
859
        try:
 
860
            existing_pending_merges = tree.get_parent_ids()[1:]
 
861
            last_rev = tree.last_revision()
 
862
            if last_rev == tree.branch.last_revision():
 
863
                # may be up to date, check master too.
 
864
                master = tree.branch.get_master_branch()
 
865
                if master is None or last_rev == master.last_revision():
 
866
                    revno = tree.branch.revision_id_to_revno(last_rev)
 
867
                    note("Tree is up to date at revision %d." % (revno,))
 
868
                    return 0
 
869
            conflicts = tree.update()
 
870
            revno = tree.branch.revision_id_to_revno(tree.last_revision())
 
871
            note('Updated to revision %d.' % (revno,))
 
872
            if tree.get_parent_ids()[1:] != existing_pending_merges:
 
873
                note('Your local commits will now show as pending merges with '
 
874
                     "'bzr status', and can be committed with 'bzr commit'.")
 
875
            if conflicts != 0:
 
876
                return 1
 
877
            else:
 
878
                return 0
 
879
        finally:
 
880
            tree.unlock()
452
881
 
453
882
 
454
883
class cmd_info(Command):
455
 
    """Show statistical information about a branch."""
456
 
    takes_args = ['branch?']
457
 
    
458
 
    def run(self, branch=None):
459
 
        import info
460
 
        b = Branch.open_containing(branch)[0]
461
 
        info.show_info(b)
 
884
    """Show information about a working tree, branch or repository.
 
885
 
 
886
    This command will show all known locations and formats associated to the
 
887
    tree, branch or repository.  Statistical information is included with
 
888
    each report.
 
889
 
 
890
    Branches and working trees will also report any missing revisions.
 
891
    """
 
892
    takes_args = ['location?']
 
893
    takes_options = ['verbose']
 
894
 
 
895
    @display_command
 
896
    def run(self, location=None, verbose=False):
 
897
        from bzrlib.info import show_bzrdir_info
 
898
        show_bzrdir_info(bzrdir.BzrDir.open_containing(location)[0],
 
899
                         verbose=verbose)
462
900
 
463
901
 
464
902
class cmd_remove(Command):
466
904
 
467
905
    This makes bzr stop tracking changes to a versioned file.  It does
468
906
    not delete the working copy.
 
907
 
 
908
    You can specify one or more files, and/or --new.  If you specify --new,
 
909
    only 'added' files will be removed.  If you specify both, then new files
 
910
    in the specified directories will be removed.  If the directories are
 
911
    also new, they will also be removed.
469
912
    """
470
 
    takes_args = ['file+']
471
 
    takes_options = ['verbose']
 
913
    takes_args = ['file*']
 
914
    takes_options = ['verbose', Option('new', help='remove newly-added files')]
472
915
    aliases = ['rm']
 
916
    encoding_type = 'replace'
473
917
    
474
 
    def run(self, file_list, verbose=False):
475
 
        b = Branch.open_containing(file_list[0])[0]
476
 
        tree = WorkingTree(b.base, b)
477
 
        tree.remove([tree.relpath(f) for f in file_list], verbose=verbose)
 
918
    def run(self, file_list, verbose=False, new=False):
 
919
        tree, file_list = tree_files(file_list)
 
920
        if new is False:
 
921
            if file_list is None:
 
922
                raise errors.BzrCommandError('Specify one or more files to'
 
923
                                             ' remove, or use --new.')
 
924
        else:
 
925
            added = tree.changes_from(tree.basis_tree(),
 
926
                specific_files=file_list).added
 
927
            file_list = sorted([f[0] for f in added], reverse=True)
 
928
            if len(file_list) == 0:
 
929
                raise errors.BzrCommandError('No matching files.')
 
930
        tree.remove(file_list, verbose=verbose, to_file=self.outf)
478
931
 
479
932
 
480
933
class cmd_file_id(Command):
484
937
    same through all revisions where the file exists, even when it is
485
938
    moved or renamed.
486
939
    """
 
940
 
487
941
    hidden = True
488
942
    takes_args = ['filename']
 
943
 
 
944
    @display_command
489
945
    def run(self, filename):
490
 
        b, relpath = Branch.open_containing(filename)
491
 
        i = b.inventory.path2id(relpath)
492
 
        if i == None:
493
 
            raise BzrError("%r is not a versioned file" % filename)
 
946
        tree, relpath = WorkingTree.open_containing(filename)
 
947
        i = tree.inventory.path2id(relpath)
 
948
        if i is None:
 
949
            raise errors.NotVersionedError(filename)
494
950
        else:
495
 
            print i
 
951
            self.outf.write(i + '\n')
496
952
 
497
953
 
498
954
class cmd_file_path(Command):
499
955
    """Print path of file_ids to a file or directory.
500
956
 
501
957
    This prints one line for each directory down to the target,
502
 
    starting at the branch root."""
 
958
    starting at the branch root.
 
959
    """
 
960
 
503
961
    hidden = True
504
962
    takes_args = ['filename']
 
963
 
 
964
    @display_command
505
965
    def run(self, filename):
506
 
        b, relpath = Branch.open_containing(filename)
507
 
        inv = b.inventory
 
966
        tree, relpath = WorkingTree.open_containing(filename)
 
967
        inv = tree.inventory
508
968
        fid = inv.path2id(relpath)
509
 
        if fid == None:
510
 
            raise BzrError("%r is not a versioned file" % filename)
 
969
        if fid is None:
 
970
            raise errors.NotVersionedError(filename)
511
971
        for fip in inv.get_idpath(fid):
512
 
            print fip
 
972
            self.outf.write(fip + '\n')
 
973
 
 
974
 
 
975
class cmd_reconcile(Command):
 
976
    """Reconcile bzr metadata in a branch.
 
977
 
 
978
    This can correct data mismatches that may have been caused by
 
979
    previous ghost operations or bzr upgrades. You should only
 
980
    need to run this command if 'bzr check' or a bzr developer 
 
981
    advises you to run it.
 
982
 
 
983
    If a second branch is provided, cross-branch reconciliation is
 
984
    also attempted, which will check that data like the tree root
 
985
    id which was not present in very early bzr versions is represented
 
986
    correctly in both branches.
 
987
 
 
988
    At the same time it is run it may recompress data resulting in 
 
989
    a potential saving in disk space or performance gain.
 
990
 
 
991
    The branch *MUST* be on a listable system such as local disk or sftp.
 
992
    """
 
993
    takes_args = ['branch?']
 
994
 
 
995
    def run(self, branch="."):
 
996
        from bzrlib.reconcile import reconcile
 
997
        dir = bzrdir.BzrDir.open(branch)
 
998
        reconcile(dir)
513
999
 
514
1000
 
515
1001
class cmd_revision_history(Command):
516
 
    """Display list of revision ids on this branch."""
 
1002
    """Display the list of revision ids on a branch."""
 
1003
    takes_args = ['location?']
 
1004
 
517
1005
    hidden = True
518
 
    def run(self):
519
 
        for patchid in Branch.open_containing('.')[0].revision_history():
520
 
            print patchid
 
1006
 
 
1007
    @display_command
 
1008
    def run(self, location="."):
 
1009
        branch = Branch.open_containing(location)[0]
 
1010
        for revid in branch.revision_history():
 
1011
            self.outf.write(revid)
 
1012
            self.outf.write('\n')
521
1013
 
522
1014
 
523
1015
class cmd_ancestry(Command):
524
1016
    """List all revisions merged into this branch."""
 
1017
    takes_args = ['location?']
 
1018
 
525
1019
    hidden = True
526
 
    def run(self):
527
 
        b = find_branch('.')
528
 
        for revision_id in b.get_ancestry(b.last_revision()):
529
 
            print revision_id
530
 
 
531
 
 
532
 
class cmd_directories(Command):
533
 
    """Display list of versioned directories in this branch."""
534
 
    def run(self):
535
 
        for name, ie in Branch.open_containing('.')[0].read_working_inventory().directories():
536
 
            if name == '':
537
 
                print '.'
538
 
            else:
539
 
                print name
 
1020
 
 
1021
    @display_command
 
1022
    def run(self, location="."):
 
1023
        try:
 
1024
            wt = WorkingTree.open_containing(location)[0]
 
1025
        except errors.NoWorkingTree:
 
1026
            b = Branch.open(location)
 
1027
            last_revision = b.last_revision()
 
1028
        else:
 
1029
            b = wt.branch
 
1030
            last_revision = wt.last_revision()
 
1031
 
 
1032
        revision_ids = b.repository.get_ancestry(last_revision)
 
1033
        assert revision_ids[0] is None
 
1034
        revision_ids.pop(0)
 
1035
        for revision_id in revision_ids:
 
1036
            self.outf.write(revision_id + '\n')
540
1037
 
541
1038
 
542
1039
class cmd_init(Command):
545
1042
    Use this to create an empty branch, or before importing an
546
1043
    existing project.
547
1044
 
 
1045
    If there is a repository in a parent directory of the location, then 
 
1046
    the history of the branch will be stored in the repository.  Otherwise
 
1047
    init creates a standalone branch which carries its own history in 
 
1048
    .bzr.
 
1049
 
 
1050
    If there is already a branch at the location but it has no working tree,
 
1051
    the tree can be populated with 'bzr checkout'.
 
1052
 
548
1053
    Recipe for importing a tree of files:
549
1054
        cd ~/project
550
1055
        bzr init
551
 
        bzr add -v .
 
1056
        bzr add .
552
1057
        bzr status
553
1058
        bzr commit -m 'imported project'
554
1059
    """
555
 
    def run(self):
556
 
        Branch.initialize('.')
 
1060
    takes_args = ['location?']
 
1061
    takes_options = [
 
1062
                     Option('format', 
 
1063
                            help='Specify a format for this branch. Current'
 
1064
                                 ' formats are: default, knit, metaweave and'
 
1065
                                 ' weave. Default is knit; metaweave and'
 
1066
                                 ' weave are deprecated',
 
1067
                            type=get_format_type),
 
1068
                     ]
 
1069
    def run(self, location=None, format=None):
 
1070
        if format is None:
 
1071
            format = get_format_type('default')
 
1072
        if location is None:
 
1073
            location = u'.'
 
1074
 
 
1075
        to_transport = transport.get_transport(location)
 
1076
 
 
1077
        # The path has to exist to initialize a
 
1078
        # branch inside of it.
 
1079
        # Just using os.mkdir, since I don't
 
1080
        # believe that we want to create a bunch of
 
1081
        # locations if the user supplies an extended path
 
1082
        # TODO: create-prefix
 
1083
        try:
 
1084
            to_transport.mkdir('.')
 
1085
        except errors.FileExists:
 
1086
            pass
 
1087
                    
 
1088
        try:
 
1089
            existing_bzrdir = bzrdir.BzrDir.open(location)
 
1090
        except errors.NotBranchError:
 
1091
            # really a NotBzrDir error...
 
1092
            bzrdir.BzrDir.create_branch_convenience(location, format=format)
 
1093
        else:
 
1094
            from bzrlib.transport.local import LocalTransport
 
1095
            if existing_bzrdir.has_branch():
 
1096
                if (isinstance(to_transport, LocalTransport)
 
1097
                    and not existing_bzrdir.has_workingtree()):
 
1098
                        raise errors.BranchExistsWithoutWorkingTree(location)
 
1099
                raise errors.AlreadyBranchError(location)
 
1100
            else:
 
1101
                existing_bzrdir.create_branch()
 
1102
                existing_bzrdir.create_workingtree()
 
1103
 
 
1104
 
 
1105
class cmd_init_repository(Command):
 
1106
    """Create a shared repository to hold branches.
 
1107
 
 
1108
    New branches created under the repository directory will store their revisions
 
1109
    in the repository, not in the branch directory, if the branch format supports
 
1110
    shared storage.
 
1111
 
 
1112
    example:
 
1113
        bzr init-repo repo
 
1114
        bzr init repo/trunk
 
1115
        bzr checkout --lightweight repo/trunk trunk-checkout
 
1116
        cd trunk-checkout
 
1117
        (add files here)
 
1118
    """
 
1119
    takes_args = ["location"] 
 
1120
    takes_options = [Option('format', 
 
1121
                            help='Specify a format for this repository.'
 
1122
                                 ' Current formats are: default, knit,'
 
1123
                                 ' metaweave and weave. Default is knit;'
 
1124
                                 ' metaweave and weave are deprecated',
 
1125
                            type=get_format_type),
 
1126
                     Option('trees',
 
1127
                             help='Allows branches in repository to have'
 
1128
                             ' a working tree')]
 
1129
    aliases = ["init-repo"]
 
1130
    def run(self, location, format=None, trees=False):
 
1131
        if format is None:
 
1132
            format = get_format_type('default')
 
1133
 
 
1134
        if location is None:
 
1135
            location = '.'
 
1136
 
 
1137
        to_transport = transport.get_transport(location)
 
1138
        try:
 
1139
            to_transport.mkdir('.')
 
1140
        except errors.FileExists:
 
1141
            pass
 
1142
 
 
1143
        newdir = format.initialize_on_transport(to_transport)
 
1144
        repo = newdir.create_repository(shared=True)
 
1145
        repo.set_make_working_trees(trees)
557
1146
 
558
1147
 
559
1148
class cmd_diff(Command):
560
 
    """Show differences in working tree.
 
1149
    """Show differences in the working tree or between revisions.
561
1150
    
562
1151
    If files are listed, only the changes in those files are listed.
563
1152
    Otherwise, all changes for the tree are listed.
564
1153
 
 
1154
    "bzr diff -p1" is equivalent to "bzr diff --prefix old/:new/", and
 
1155
    produces patches suitable for "patch -p1".
 
1156
 
565
1157
    examples:
566
1158
        bzr diff
 
1159
            Shows the difference in the working tree versus the last commit
567
1160
        bzr diff -r1
 
1161
            Difference between the working tree and revision 1
568
1162
        bzr diff -r1..2
 
1163
            Difference between revision 2 and revision 1
 
1164
        bzr diff --diff-prefix old/:new/
 
1165
            Same as 'bzr diff' but prefix paths with old/ and new/
 
1166
        bzr diff bzr.mine bzr.dev
 
1167
            Show the differences between the two working trees
 
1168
        bzr diff foo.c
 
1169
            Show just the differences for 'foo.c'
569
1170
    """
570
 
    # TODO: Allow diff across branches.
571
1171
    # TODO: Option to use external diff command; could be GNU diff, wdiff,
572
1172
    #       or a graphical diff.
573
1173
 
574
1174
    # TODO: Python difflib is not exactly the same as unidiff; should
575
1175
    #       either fix it up or prefer to use an external diff.
576
1176
 
577
 
    # TODO: If a directory is given, diff everything under that.
578
 
 
579
1177
    # TODO: Selected-file diff is inefficient and doesn't show you
580
1178
    #       deleted files.
581
1179
 
582
1180
    # TODO: This probably handles non-Unix newlines poorly.
583
1181
    
584
1182
    takes_args = ['file*']
585
 
    takes_options = ['revision', 'diff-options']
 
1183
    takes_options = ['revision', 'diff-options', 'prefix']
586
1184
    aliases = ['di', 'dif']
587
 
 
588
 
    def run(self, revision=None, file_list=None, diff_options=None):
589
 
        from bzrlib.diff import show_diff
590
 
 
591
 
        if file_list:
592
 
            b = Branch.open_containing(file_list[0])[0]
593
 
            tree = WorkingTree(b.base, b)
594
 
            file_list = [tree.relpath(f) for f in file_list]
595
 
            if file_list == ['']:
596
 
                # just pointing to top-of-tree
597
 
                file_list = None
 
1185
    encoding_type = 'exact'
 
1186
 
 
1187
    @display_command
 
1188
    def run(self, revision=None, file_list=None, diff_options=None,
 
1189
            prefix=None):
 
1190
        from bzrlib.diff import diff_cmd_helper, show_diff_trees
 
1191
 
 
1192
        if (prefix is None) or (prefix == '0'):
 
1193
            # diff -p0 format
 
1194
            old_label = ''
 
1195
            new_label = ''
 
1196
        elif prefix == '1':
 
1197
            old_label = 'old/'
 
1198
            new_label = 'new/'
598
1199
        else:
599
 
            b = Branch.open_containing('.')[0]
 
1200
            if not ':' in prefix:
 
1201
                 raise BzrCommandError(
 
1202
                     "--diff-prefix expects two values separated by a colon")
 
1203
            old_label, new_label = prefix.split(":")
 
1204
        
 
1205
        try:
 
1206
            tree1, file_list = internal_tree_files(file_list)
 
1207
            tree2 = None
 
1208
            b = None
 
1209
            b2 = None
 
1210
        except errors.FileInWrongBranch:
 
1211
            if len(file_list) != 2:
 
1212
                raise errors.BzrCommandError("Files are in different branches")
600
1213
 
 
1214
            tree1, file1 = WorkingTree.open_containing(file_list[0])
 
1215
            tree2, file2 = WorkingTree.open_containing(file_list[1])
 
1216
            if file1 != "" or file2 != "":
 
1217
                # FIXME diff those two files. rbc 20051123
 
1218
                raise errors.BzrCommandError("Files are in different branches")
 
1219
            file_list = None
 
1220
        except errors.NotBranchError:
 
1221
            if (revision is not None and len(revision) == 2
 
1222
                and not revision[0].needs_branch()
 
1223
                and not revision[1].needs_branch()):
 
1224
                # If both revision specs include a branch, we can
 
1225
                # diff them without needing a local working tree
 
1226
                tree1, tree2 = None, None
 
1227
            else:
 
1228
                raise
601
1229
        if revision is not None:
602
 
            if len(revision) == 1:
603
 
                show_diff(b, revision[0], specific_files=file_list,
604
 
                          external_diff_options=diff_options)
 
1230
            if tree2 is not None:
 
1231
                raise errors.BzrCommandError("Can't specify -r with two branches")
 
1232
            if (len(revision) == 1) or (revision[1].spec is None):
 
1233
                return diff_cmd_helper(tree1, file_list, diff_options,
 
1234
                                       revision[0], 
 
1235
                                       old_label=old_label, new_label=new_label)
605
1236
            elif len(revision) == 2:
606
 
                show_diff(b, revision[0], specific_files=file_list,
607
 
                          external_diff_options=diff_options,
608
 
                          revision2=revision[1])
 
1237
                return diff_cmd_helper(tree1, file_list, diff_options,
 
1238
                                       revision[0], revision[1],
 
1239
                                       old_label=old_label, new_label=new_label)
609
1240
            else:
610
 
                raise BzrCommandError('bzr diff --revision takes exactly one or two revision identifiers')
 
1241
                raise errors.BzrCommandError('bzr diff --revision takes exactly'
 
1242
                                             ' one or two revision identifiers')
611
1243
        else:
612
 
            show_diff(b, None, specific_files=file_list,
613
 
                      external_diff_options=diff_options)
614
 
 
615
 
        
 
1244
            if tree2 is not None:
 
1245
                return show_diff_trees(tree1, tree2, sys.stdout, 
 
1246
                                       specific_files=file_list,
 
1247
                                       external_diff_options=diff_options,
 
1248
                                       old_label=old_label, new_label=new_label)
 
1249
            else:
 
1250
                return diff_cmd_helper(tree1, file_list, diff_options,
 
1251
                                       old_label=old_label, new_label=new_label)
616
1252
 
617
1253
 
618
1254
class cmd_deleted(Command):
624
1260
    # directories with readdir, rather than stating each one.  Same
625
1261
    # level of effort but possibly much less IO.  (Or possibly not,
626
1262
    # if the directories are very large...)
 
1263
    takes_options = ['show-ids']
 
1264
 
 
1265
    @display_command
627
1266
    def run(self, show_ids=False):
628
 
        b = Branch.open_containing('.')[0]
629
 
        old = b.basis_tree()
630
 
        new = b.working_tree()
 
1267
        tree = WorkingTree.open_containing(u'.')[0]
 
1268
        old = tree.basis_tree()
631
1269
        for path, ie in old.inventory.iter_entries():
632
 
            if not new.has_id(ie.file_id):
 
1270
            if not tree.has_id(ie.file_id):
 
1271
                self.outf.write(path)
633
1272
                if show_ids:
634
 
                    print '%-50s %s' % (path, ie.file_id)
635
 
                else:
636
 
                    print path
 
1273
                    self.outf.write(' ')
 
1274
                    self.outf.write(ie.file_id)
 
1275
                self.outf.write('\n')
637
1276
 
638
1277
 
639
1278
class cmd_modified(Command):
640
1279
    """List files modified in working tree."""
641
1280
    hidden = True
 
1281
    @display_command
642
1282
    def run(self):
643
 
        from bzrlib.delta import compare_trees
644
 
 
645
 
        b = Branch.open_containing('.')[0]
646
 
        td = compare_trees(b.basis_tree(), b.working_tree())
647
 
 
 
1283
        tree = WorkingTree.open_containing(u'.')[0]
 
1284
        td = tree.changes_from(tree.basis_tree())
648
1285
        for path, id, kind, text_modified, meta_modified in td.modified:
649
 
            print path
650
 
 
 
1286
            self.outf.write(path + '\n')
651
1287
 
652
1288
 
653
1289
class cmd_added(Command):
654
1290
    """List files added in working tree."""
655
1291
    hidden = True
 
1292
    @display_command
656
1293
    def run(self):
657
 
        b = Branch.open_containing('.')[0]
658
 
        wt = b.working_tree()
659
 
        basis_inv = b.basis_tree().inventory
 
1294
        wt = WorkingTree.open_containing(u'.')[0]
 
1295
        basis_inv = wt.basis_tree().inventory
660
1296
        inv = wt.inventory
661
1297
        for file_id in inv:
662
1298
            if file_id in basis_inv:
663
1299
                continue
 
1300
            if inv.is_root(file_id) and len(basis_inv) == 0:
 
1301
                continue
664
1302
            path = inv.id2path(file_id)
665
 
            if not os.access(b.abspath(path), os.F_OK):
 
1303
            if not os.access(osutils.abspath(path), os.F_OK):
666
1304
                continue
667
 
            print path
668
 
                
669
 
        
 
1305
            self.outf.write(path + '\n')
 
1306
 
670
1307
 
671
1308
class cmd_root(Command):
672
1309
    """Show the tree root directory.
674
1311
    The root is the nearest enclosing directory with a .bzr control
675
1312
    directory."""
676
1313
    takes_args = ['filename?']
 
1314
    @display_command
677
1315
    def run(self, filename=None):
678
1316
        """Print the branch root."""
679
 
        b = Branch.open_containing(filename)[0]
680
 
        print b.base
 
1317
        tree = WorkingTree.open_containing(filename)[0]
 
1318
        self.outf.write(tree.basedir + '\n')
681
1319
 
682
1320
 
683
1321
class cmd_log(Command):
684
 
    """Show log of this branch.
685
 
 
686
 
    To request a range of logs, you can use the command -r begin:end
687
 
    -r revision requests a specific revision, -r :end or -r begin: are
 
1322
    """Show log of a branch, file, or directory.
 
1323
 
 
1324
    By default show the log of the branch containing the working directory.
 
1325
 
 
1326
    To request a range of logs, you can use the command -r begin..end
 
1327
    -r revision requests a specific revision, -r ..end or -r begin.. are
688
1328
    also valid.
 
1329
 
 
1330
    examples:
 
1331
        bzr log
 
1332
        bzr log foo.c
 
1333
        bzr log -r -10.. http://server/branch
689
1334
    """
690
1335
 
691
1336
    # TODO: Make --revision support uuid: and hash: [future tag:] notation.
692
1337
 
693
 
    takes_args = ['filename?']
 
1338
    takes_args = ['location?']
694
1339
    takes_options = [Option('forward', 
695
1340
                            help='show from oldest to newest'),
696
 
                     'timezone', 'verbose', 
 
1341
                     'timezone', 
 
1342
                     Option('verbose', 
 
1343
                             help='show files changed in each revision'),
697
1344
                     'show-ids', 'revision',
698
 
                     Option('line', help='format with one line per revision'),
699
 
                     'long', 
 
1345
                     'log-format',
 
1346
                     'line', 'long', 
700
1347
                     Option('message',
701
1348
                            help='show revisions whose message matches this regexp',
702
1349
                            type=str),
703
 
                     Option('short', help='use moderately short format'),
 
1350
                     'short',
704
1351
                     ]
705
 
    
706
 
    def run(self, filename=None, timezone='original',
 
1352
    encoding_type = 'replace'
 
1353
 
 
1354
    @display_command
 
1355
    def run(self, location=None, timezone='original',
707
1356
            verbose=False,
708
1357
            show_ids=False,
709
1358
            forward=False,
710
1359
            revision=None,
 
1360
            log_format=None,
711
1361
            message=None,
712
1362
            long=False,
713
1363
            short=False,
714
1364
            line=False):
715
1365
        from bzrlib.log import log_formatter, show_log
716
 
        import codecs
717
1366
        assert message is None or isinstance(message, basestring), \
718
1367
            "invalid message argument %r" % message
719
1368
        direction = (forward and 'forward') or 'reverse'
720
1369
        
721
 
        if filename:
722
 
            b, fp = Branch.open_containing(filename)
 
1370
        # log everything
 
1371
        file_id = None
 
1372
        if location:
 
1373
            # find the file id to log:
 
1374
 
 
1375
            dir, fp = bzrdir.BzrDir.open_containing(location)
 
1376
            b = dir.open_branch()
723
1377
            if fp != '':
724
 
                file_id = b.read_working_inventory().path2id(fp)
 
1378
                try:
 
1379
                    # might be a tree:
 
1380
                    inv = dir.open_workingtree().inventory
 
1381
                except (errors.NotBranchError, errors.NotLocalUrl):
 
1382
                    # either no tree, or is remote.
 
1383
                    inv = b.basis_tree().inventory
 
1384
                file_id = inv.path2id(fp)
 
1385
                if file_id is None:
 
1386
                    raise errors.BzrCommandError(
 
1387
                        "Path does not have any revision history: %s" %
 
1388
                        location)
 
1389
        else:
 
1390
            # local dir only
 
1391
            # FIXME ? log the current subdir only RBC 20060203 
 
1392
            if revision is not None \
 
1393
                    and len(revision) > 0 and revision[0].get_branch():
 
1394
                location = revision[0].get_branch()
725
1395
            else:
726
 
                file_id = None  # points to branch root
727
 
        else:
728
 
            b, relpath = Branch.open_containing('.')
729
 
            file_id = None
 
1396
                location = '.'
 
1397
            dir, relpath = bzrdir.BzrDir.open_containing(location)
 
1398
            b = dir.open_branch()
730
1399
 
731
1400
        if revision is None:
732
1401
            rev1 = None
734
1403
        elif len(revision) == 1:
735
1404
            rev1 = rev2 = revision[0].in_history(b).revno
736
1405
        elif len(revision) == 2:
737
 
            rev1 = revision[0].in_history(b).revno
738
 
            rev2 = revision[1].in_history(b).revno
 
1406
            if revision[1].get_branch() != revision[0].get_branch():
 
1407
                # b is taken from revision[0].get_branch(), and
 
1408
                # show_log will use its revision_history. Having
 
1409
                # different branches will lead to weird behaviors.
 
1410
                raise errors.BzrCommandError(
 
1411
                    "Log doesn't accept two revisions in different branches.")
 
1412
            if revision[0].spec is None:
 
1413
                # missing begin-range means first revision
 
1414
                rev1 = 1
 
1415
            else:
 
1416
                rev1 = revision[0].in_history(b).revno
 
1417
 
 
1418
            if revision[1].spec is None:
 
1419
                # missing end-range means last known revision
 
1420
                rev2 = b.revno()
 
1421
            else:
 
1422
                rev2 = revision[1].in_history(b).revno
739
1423
        else:
740
 
            raise BzrCommandError('bzr log --revision takes one or two values.')
741
 
 
742
 
        if rev1 == 0:
743
 
            rev1 = None
744
 
        if rev2 == 0:
745
 
            rev2 = None
746
 
 
747
 
        mutter('encoding log as %r' % bzrlib.user_encoding)
748
 
 
749
 
        # use 'replace' so that we don't abort if trying to write out
750
 
        # in e.g. the default C locale.
751
 
        outf = codecs.getwriter(bzrlib.user_encoding)(sys.stdout, errors='replace')
752
 
 
753
 
        log_format = 'long'
754
 
        if short:
755
 
            log_format = 'short'
756
 
        if line:
757
 
            log_format = 'line'
 
1424
            raise errors.BzrCommandError('bzr log --revision takes one or two values.')
 
1425
 
 
1426
        # By this point, the revision numbers are converted to the +ve
 
1427
        # form if they were supplied in the -ve form, so we can do
 
1428
        # this comparison in relative safety
 
1429
        if rev1 > rev2:
 
1430
            (rev2, rev1) = (rev1, rev2)
 
1431
 
 
1432
        if (log_format is None):
 
1433
            default = b.get_config().log_format()
 
1434
            log_format = get_log_format(long=long, short=short, line=line, 
 
1435
                                        default=default)
758
1436
        lf = log_formatter(log_format,
759
1437
                           show_ids=show_ids,
760
 
                           to_file=outf,
 
1438
                           to_file=self.outf,
761
1439
                           show_timezone=timezone)
762
1440
 
763
1441
        show_log(b,
770
1448
                 search=message)
771
1449
 
772
1450
 
 
1451
def get_log_format(long=False, short=False, line=False, default='long'):
 
1452
    log_format = default
 
1453
    if long:
 
1454
        log_format = 'long'
 
1455
    if short:
 
1456
        log_format = 'short'
 
1457
    if line:
 
1458
        log_format = 'line'
 
1459
    return log_format
 
1460
 
773
1461
 
774
1462
class cmd_touching_revisions(Command):
775
1463
    """Return revision-ids which affected a particular file.
776
1464
 
777
 
    A more user-friendly interface is "bzr log FILE"."""
 
1465
    A more user-friendly interface is "bzr log FILE".
 
1466
    """
 
1467
 
778
1468
    hidden = True
779
1469
    takes_args = ["filename"]
 
1470
 
 
1471
    @display_command
780
1472
    def run(self, filename):
781
 
        b, relpath = Branch.open_containing(filename)[0]
782
 
        inv = b.read_working_inventory()
 
1473
        tree, relpath = WorkingTree.open_containing(filename)
 
1474
        b = tree.branch
 
1475
        inv = tree.read_working_inventory()
783
1476
        file_id = inv.path2id(relpath)
784
 
        for revno, revision_id, what in bzrlib.log.find_touching_revisions(b, file_id):
785
 
            print "%6d %s" % (revno, what)
 
1477
        for revno, revision_id, what in log.find_touching_revisions(b, file_id):
 
1478
            self.outf.write("%6d %s\n" % (revno, what))
786
1479
 
787
1480
 
788
1481
class cmd_ls(Command):
790
1483
    """
791
1484
    # TODO: Take a revision or remote path and list that tree instead.
792
1485
    hidden = True
793
 
    def run(self, revision=None, verbose=False):
794
 
        b, relpath = Branch.open_containing('.')[0]
795
 
        if revision == None:
796
 
            tree = b.working_tree()
797
 
        else:
798
 
            tree = b.revision_tree(revision.in_history(b).rev_id)
799
 
        for fp, fc, kind, fid, entry in tree.list_files():
800
 
            if verbose:
801
 
                kindch = entry.kind_character()
802
 
                print '%-8s %s%s' % (fc, fp, kindch)
803
 
            else:
804
 
                print fp
805
 
 
 
1486
    takes_options = ['verbose', 'revision',
 
1487
                     Option('non-recursive',
 
1488
                            help='don\'t recurse into sub-directories'),
 
1489
                     Option('from-root',
 
1490
                            help='Print all paths from the root of the branch.'),
 
1491
                     Option('unknown', help='Print unknown files'),
 
1492
                     Option('versioned', help='Print versioned files'),
 
1493
                     Option('ignored', help='Print ignored files'),
 
1494
 
 
1495
                     Option('null', help='Null separate the files'),
 
1496
                    ]
 
1497
    @display_command
 
1498
    def run(self, revision=None, verbose=False, 
 
1499
            non_recursive=False, from_root=False,
 
1500
            unknown=False, versioned=False, ignored=False,
 
1501
            null=False):
 
1502
 
 
1503
        if verbose and null:
 
1504
            raise errors.BzrCommandError('Cannot set both --verbose and --null')
 
1505
        all = not (unknown or versioned or ignored)
 
1506
 
 
1507
        selection = {'I':ignored, '?':unknown, 'V':versioned}
 
1508
 
 
1509
        tree, relpath = WorkingTree.open_containing(u'.')
 
1510
        if from_root:
 
1511
            relpath = u''
 
1512
        elif relpath:
 
1513
            relpath += '/'
 
1514
        if revision is not None:
 
1515
            tree = tree.branch.repository.revision_tree(
 
1516
                revision[0].in_history(tree.branch).rev_id)
 
1517
 
 
1518
        for fp, fc, kind, fid, entry in tree.list_files(include_root=False):
 
1519
            if fp.startswith(relpath):
 
1520
                fp = fp[len(relpath):]
 
1521
                if non_recursive and '/' in fp:
 
1522
                    continue
 
1523
                if not all and not selection[fc]:
 
1524
                    continue
 
1525
                if verbose:
 
1526
                    kindch = entry.kind_character()
 
1527
                    self.outf.write('%-8s %s%s\n' % (fc, fp, kindch))
 
1528
                elif null:
 
1529
                    self.outf.write(fp + '\0')
 
1530
                    self.outf.flush()
 
1531
                else:
 
1532
                    self.outf.write(fp + '\n')
806
1533
 
807
1534
 
808
1535
class cmd_unknowns(Command):
809
1536
    """List unknown files."""
 
1537
    @display_command
810
1538
    def run(self):
811
 
        from bzrlib.osutils import quotefn
812
 
        for f in Branch.open_containing('.')[0].unknowns():
813
 
            print quotefn(f)
814
 
 
 
1539
        for f in WorkingTree.open_containing(u'.')[0].unknowns():
 
1540
            self.outf.write(osutils.quotefn(f) + '\n')
815
1541
 
816
1542
 
817
1543
class cmd_ignore(Command):
818
 
    """Ignore a command or pattern.
 
1544
    """Ignore specified files or patterns.
819
1545
 
820
1546
    To remove patterns from the ignore list, edit the .bzrignore file.
821
1547
 
 
1548
    Trailing slashes on patterns are ignored. 
822
1549
    If the pattern contains a slash, it is compared to the whole path
823
1550
    from the branch root.  Otherwise, it is compared to only the last
824
1551
    component of the path.  To match a file only in the root directory,
825
1552
    prepend './'.
826
1553
 
 
1554
    Ignore patterns specifying absolute paths are not allowed.
 
1555
 
827
1556
    Ignore patterns are case-insensitive on case-insensitive systems.
828
1557
 
829
1558
    Note: wildcards must be quoted from the shell on Unix.
832
1561
        bzr ignore ./Makefile
833
1562
        bzr ignore '*.class'
834
1563
    """
835
 
    # TODO: Complain if the filename is absolute
836
 
    takes_args = ['name_pattern']
 
1564
    takes_args = ['name_pattern*']
 
1565
    takes_options = [
 
1566
                     Option('old-default-rules',
 
1567
                            help='Out the ignore rules bzr < 0.9 always used.')
 
1568
                     ]
837
1569
    
838
 
    def run(self, name_pattern):
 
1570
    def run(self, name_pattern_list=None, old_default_rules=None):
839
1571
        from bzrlib.atomicfile import AtomicFile
840
 
        import os.path
841
 
 
842
 
        b, relpath = Branch.open_containing('.')
843
 
        ifn = b.abspath('.bzrignore')
844
 
 
 
1572
        if old_default_rules is not None:
 
1573
            # dump the rules and exit
 
1574
            for pattern in ignores.OLD_DEFAULTS:
 
1575
                print pattern
 
1576
            return
 
1577
        if not name_pattern_list:
 
1578
            raise errors.BzrCommandError("ignore requires at least one "
 
1579
                                  "NAME_PATTERN or --old-default-rules")
 
1580
        for name_pattern in name_pattern_list:
 
1581
            if name_pattern[0] == '/':
 
1582
                raise errors.BzrCommandError(
 
1583
                    "NAME_PATTERN should not be an absolute path")
 
1584
        tree, relpath = WorkingTree.open_containing(u'.')
 
1585
        ifn = tree.abspath('.bzrignore')
845
1586
        if os.path.exists(ifn):
846
1587
            f = open(ifn, 'rt')
847
1588
            try:
856
1597
 
857
1598
        if igns and igns[-1] != '\n':
858
1599
            igns += '\n'
859
 
        igns += name_pattern + '\n'
 
1600
        for name_pattern in name_pattern_list:
 
1601
            igns += name_pattern.rstrip('/') + '\n'
860
1602
 
 
1603
        f = AtomicFile(ifn, 'wb')
861
1604
        try:
862
 
            f = AtomicFile(ifn, 'wt')
863
1605
            f.write(igns.encode('utf-8'))
864
1606
            f.commit()
865
1607
        finally:
866
1608
            f.close()
867
1609
 
868
 
        inv = b.working_tree().inventory
 
1610
        inv = tree.inventory
869
1611
        if inv.path2id('.bzrignore'):
870
1612
            mutter('.bzrignore is already versioned')
871
1613
        else:
872
1614
            mutter('need to make new .bzrignore file versioned')
873
 
            b.add(['.bzrignore'])
874
 
 
 
1615
            tree.add(['.bzrignore'])
875
1616
 
876
1617
 
877
1618
class cmd_ignored(Command):
878
1619
    """List ignored files and the patterns that matched them.
879
1620
 
880
1621
    See also: bzr ignore"""
 
1622
    @display_command
881
1623
    def run(self):
882
 
        tree = Branch.open_containing('.')[0].working_tree()
 
1624
        tree = WorkingTree.open_containing(u'.')[0]
883
1625
        for path, file_class, kind, file_id, entry in tree.list_files():
884
1626
            if file_class != 'I':
885
1627
                continue
897
1639
    hidden = True
898
1640
    takes_args = ['revno']
899
1641
    
 
1642
    @display_command
900
1643
    def run(self, revno):
901
1644
        try:
902
1645
            revno = int(revno)
903
1646
        except ValueError:
904
 
            raise BzrCommandError("not a valid revision-number: %r" % revno)
 
1647
            raise errors.BzrCommandError("not a valid revision-number: %r" % revno)
905
1648
 
906
 
        print Branch.open_containing('.')[0].get_rev_id(revno)
 
1649
        print WorkingTree.open_containing(u'.')[0].branch.get_rev_id(revno)
907
1650
 
908
1651
 
909
1652
class cmd_export(Command):
916
1659
    is found exports to a directory (equivalent to --format=dir).
917
1660
 
918
1661
    Root may be the top directory for tar, tgz and tbz2 formats. If none
919
 
    is given, the top directory will be the root name of the file."""
920
 
    # TODO: list known exporters
921
 
    takes_args = ['dest']
 
1662
    is given, the top directory will be the root name of the file.
 
1663
 
 
1664
    If branch is omitted then the branch containing the CWD will be used.
 
1665
 
 
1666
    Note: export of tree with non-ascii filenames to zip is not supported.
 
1667
 
 
1668
     Supported formats       Autodetected by extension
 
1669
     -----------------       -------------------------
 
1670
         dir                            -
 
1671
         tar                          .tar
 
1672
         tbz2                    .tar.bz2, .tbz2
 
1673
         tgz                      .tar.gz, .tgz
 
1674
         zip                          .zip
 
1675
    """
 
1676
    takes_args = ['dest', 'branch?']
922
1677
    takes_options = ['revision', 'format', 'root']
923
 
    def run(self, dest, revision=None, format=None, root=None):
924
 
        import os.path
925
 
        b = Branch.open_containing('.')[0]
 
1678
    def run(self, dest, branch=None, revision=None, format=None, root=None):
 
1679
        from bzrlib.export import export
 
1680
 
 
1681
        if branch is None:
 
1682
            tree = WorkingTree.open_containing(u'.')[0]
 
1683
            b = tree.branch
 
1684
        else:
 
1685
            b = Branch.open(branch)
 
1686
            
926
1687
        if revision is None:
 
1688
            # should be tree.last_revision  FIXME
927
1689
            rev_id = b.last_revision()
928
1690
        else:
929
1691
            if len(revision) != 1:
930
 
                raise BzrError('bzr export --revision takes exactly 1 argument')
 
1692
                raise errors.BzrCommandError('bzr export --revision takes exactly 1 argument')
931
1693
            rev_id = revision[0].in_history(b).rev_id
932
 
        t = b.revision_tree(rev_id)
933
 
        arg_root, ext = os.path.splitext(os.path.basename(dest))
934
 
        if ext in ('.gz', '.bz2'):
935
 
            new_root, new_ext = os.path.splitext(arg_root)
936
 
            if new_ext == '.tar':
937
 
                arg_root = new_root
938
 
                ext = new_ext + ext
939
 
        if root is None:
940
 
            root = arg_root
941
 
        if not format:
942
 
            if ext in (".tar",):
943
 
                format = "tar"
944
 
            elif ext in (".tar.gz", ".tgz"):
945
 
                format = "tgz"
946
 
            elif ext in (".tar.bz2", ".tbz2"):
947
 
                format = "tbz2"
948
 
            else:
949
 
                format = "dir"
950
 
        t.export(dest, format, root)
 
1694
        t = b.repository.revision_tree(rev_id)
 
1695
        try:
 
1696
            export(t, dest, format, root)
 
1697
        except errors.NoSuchExportFormat, e:
 
1698
            raise errors.BzrCommandError('Unsupported export format: %s' % e.format)
951
1699
 
952
1700
 
953
1701
class cmd_cat(Command):
954
1702
    """Write a file's text from a previous revision."""
955
1703
 
956
 
    takes_options = ['revision']
 
1704
    takes_options = ['revision', 'name-from-revision']
957
1705
    takes_args = ['filename']
958
1706
 
959
 
    def run(self, filename, revision=None):
 
1707
    @display_command
 
1708
    def run(self, filename, revision=None, name_from_revision=False):
 
1709
        if revision is not None and len(revision) != 1:
 
1710
            raise errors.BzrCommandError("bzr cat --revision takes exactly"
 
1711
                                        " one number")
 
1712
 
 
1713
        tree = None
 
1714
        try:
 
1715
            tree, relpath = WorkingTree.open_containing(filename)
 
1716
            b = tree.branch
 
1717
        except errors.NotBranchError:
 
1718
            pass
 
1719
 
 
1720
        if tree is None:
 
1721
            b, relpath = Branch.open_containing(filename)
 
1722
        if revision is not None and revision[0].get_branch() is not None:
 
1723
            b = Branch.open(revision[0].get_branch())
960
1724
        if revision is None:
961
 
            raise BzrCommandError("bzr cat requires a revision number")
962
 
        elif len(revision) != 1:
963
 
            raise BzrCommandError("bzr cat --revision takes exactly one number")
964
 
        b, relpath = Branch.open_containing(filename)
965
 
        b.print_file(relpath, revision[0].in_history(b).revno)
 
1725
            revision_id = b.last_revision()
 
1726
        else:
 
1727
            revision_id = revision[0].in_history(b).rev_id
 
1728
 
 
1729
        cur_file_id = tree.path2id(relpath)
 
1730
        rev_tree = b.repository.revision_tree(revision_id)
 
1731
        old_file_id = rev_tree.path2id(relpath)
 
1732
        
 
1733
        if name_from_revision:
 
1734
            if old_file_id is None:
 
1735
                raise errors.BzrCommandError("%r is not present in revision %s"
 
1736
                                                % (filename, revision_id))
 
1737
            else:
 
1738
                rev_tree.print_file(old_file_id)
 
1739
        elif cur_file_id is not None:
 
1740
            rev_tree.print_file(cur_file_id)
 
1741
        elif old_file_id is not None:
 
1742
            rev_tree.print_file(old_file_id)
 
1743
        else:
 
1744
            raise errors.BzrCommandError("%r is not present in revision %s" %
 
1745
                                         (filename, revision_id))
966
1746
 
967
1747
 
968
1748
class cmd_local_time_offset(Command):
969
1749
    """Show the offset in seconds from GMT to local time."""
970
1750
    hidden = True    
 
1751
    @display_command
971
1752
    def run(self):
972
 
        print bzrlib.osutils.local_time_offset()
 
1753
        print osutils.local_time_offset()
973
1754
 
974
1755
 
975
1756
 
1005
1786
                     Option('strict',
1006
1787
                            help="refuse to commit if there are unknown "
1007
1788
                            "files in the working tree."),
 
1789
                     Option('local',
 
1790
                            help="perform a local only commit in a bound "
 
1791
                                 "branch. Such commits are not pushed to "
 
1792
                                 "the master branch until a normal commit "
 
1793
                                 "is performed."
 
1794
                            ),
1008
1795
                     ]
1009
1796
    aliases = ['ci', 'checkin']
1010
1797
 
1011
1798
    def run(self, message=None, file=None, verbose=True, selected_list=None,
1012
 
            unchanged=False, strict=False):
 
1799
            unchanged=False, strict=False, local=False):
 
1800
        from bzrlib.commit import (NullCommitReporter, ReportCommitToLog)
1013
1801
        from bzrlib.errors import (PointlessCommit, ConflictsInTree,
1014
1802
                StrictCommitFailed)
1015
 
        from bzrlib.msgeditor import edit_commit_message
1016
 
        from bzrlib.status import show_status
1017
 
        from cStringIO import StringIO
1018
 
 
1019
 
        b = Branch.open_containing('.')[0]
1020
 
        tree = WorkingTree(b.base, b)
1021
 
        if selected_list:
1022
 
            selected_list = [tree.relpath(s) for s in selected_list]
 
1803
        from bzrlib.msgeditor import edit_commit_message, \
 
1804
                make_commit_message_template
 
1805
 
 
1806
        # TODO: Need a blackbox test for invoking the external editor; may be
 
1807
        # slightly problematic to run this cross-platform.
 
1808
 
 
1809
        # TODO: do more checks that the commit will succeed before 
 
1810
        # spending the user's valuable time typing a commit message.
 
1811
        tree, selected_list = tree_files(selected_list)
 
1812
        if selected_list == ['']:
 
1813
            # workaround - commit of root of tree should be exactly the same
 
1814
            # as just default commit in that tree, and succeed even though
 
1815
            # selected-file merge commit is not done yet
 
1816
            selected_list = []
 
1817
 
 
1818
        if local and not tree.branch.get_bound_location():
 
1819
            raise errors.LocalRequiresBoundBranch()
1023
1820
        if message is None and not file:
1024
 
            catcher = StringIO()
1025
 
            show_status(b, specific_files=selected_list,
1026
 
                        to_file=catcher)
1027
 
            message = edit_commit_message(catcher.getvalue())
1028
 
 
 
1821
            template = make_commit_message_template(tree, selected_list)
 
1822
            message = edit_commit_message(template)
1029
1823
            if message is None:
1030
 
                raise BzrCommandError("please specify a commit message"
1031
 
                                      " with either --message or --file")
 
1824
                raise errors.BzrCommandError("please specify a commit message"
 
1825
                                             " with either --message or --file")
1032
1826
        elif message and file:
1033
 
            raise BzrCommandError("please specify either --message or --file")
 
1827
            raise errors.BzrCommandError("please specify either --message or --file")
1034
1828
        
1035
1829
        if file:
1036
 
            import codecs
1037
1830
            message = codecs.open(file, 'rt', bzrlib.user_encoding).read()
1038
1831
 
1039
1832
        if message == "":
1040
 
                raise BzrCommandError("empty commit message specified")
1041
 
            
 
1833
            raise errors.BzrCommandError("empty commit message specified")
 
1834
        
 
1835
        if verbose:
 
1836
            reporter = ReportCommitToLog()
 
1837
        else:
 
1838
            reporter = NullCommitReporter()
 
1839
 
 
1840
        msgfilename = self._save_commit_message(message, tree.basedir)
1042
1841
        try:
1043
 
            b.commit(message, specific_files=selected_list,
1044
 
                     allow_pointless=unchanged, strict=strict)
 
1842
            tree.commit(message, specific_files=selected_list,
 
1843
                        allow_pointless=unchanged, strict=strict, local=local,
 
1844
                        reporter=reporter)
 
1845
            if msgfilename is not None:
 
1846
                try:
 
1847
                    os.unlink(msgfilename)
 
1848
                except IOError, e:
 
1849
                    warning("failed to unlink %s: %s; ignored", msgfilename, e)
1045
1850
        except PointlessCommit:
1046
1851
            # FIXME: This should really happen before the file is read in;
1047
1852
            # perhaps prepare the commit; get the message; then actually commit
1048
 
            raise BzrCommandError("no changes to commit",
1049
 
                                  ["use --unchanged to commit anyhow"])
 
1853
            if msgfilename is not None:
 
1854
                raise errors.BzrCommandError("no changes to commit."
 
1855
                                  " use --unchanged to commit anyhow\n"
 
1856
                                  "Commit message saved. To reuse the message,"
 
1857
                                  " do\nbzr commit --file " + msgfilename)
 
1858
            else:
 
1859
                raise errors.BzrCommandError("no changes to commit."
 
1860
                                  " use --unchanged to commit anyhow")
1050
1861
        except ConflictsInTree:
1051
 
            raise BzrCommandError("Conflicts detected in working tree.  "
1052
 
                'Use "bzr conflicts" to list, "bzr resolve FILE" to resolve.')
 
1862
            if msgfilename is not None:
 
1863
                raise errors.BzrCommandError('Conflicts detected in working '
 
1864
                    'tree.  Use "bzr conflicts" to list, "bzr resolve FILE" to'
 
1865
                    ' resolve.\n'
 
1866
                    'Commit message saved. To reuse the message,'
 
1867
                    ' do\nbzr commit --file ' + msgfilename)
 
1868
            else:
 
1869
                raise errors.BzrCommandError('Conflicts detected in working '
 
1870
                    'tree.  Use "bzr conflicts" to list, "bzr resolve FILE" to'
 
1871
                    ' resolve.')
1053
1872
        except StrictCommitFailed:
1054
 
            raise BzrCommandError("Commit refused because there are unknown "
1055
 
                                  "files in the working tree.")
 
1873
            if msgfilename is not None:
 
1874
                raise errors.BzrCommandError("Commit refused because there are"
 
1875
                                  " unknown files in the working tree.\n"
 
1876
                                  "Commit message saved. To reuse the message,"
 
1877
                                  " do\nbzr commit --file " + msgfilename)
 
1878
            else:
 
1879
                raise errors.BzrCommandError("Commit refused because there are"
 
1880
                                  " unknown files in the working tree.")
 
1881
        except errors.BoundBranchOutOfDate, e:
 
1882
            if msgfilename is not None:
 
1883
                raise errors.BzrCommandError(str(e) + "\n"
 
1884
                'To commit to master branch, run update and then commit.\n'
 
1885
                'You can also pass --local to commit to continue working '
 
1886
                'disconnected.\n'
 
1887
                'Commit message saved. To reuse the message,'
 
1888
                ' do\nbzr commit --file ' + msgfilename)
 
1889
            else:
 
1890
                raise errors.BzrCommandError(str(e) + "\n"
 
1891
                'To commit to master branch, run update and then commit.\n'
 
1892
                'You can also pass --local to commit to continue working '
 
1893
                'disconnected.')
 
1894
 
 
1895
    def _save_commit_message(self, message, basedir):
 
1896
        # save the commit message and only unlink it if the commit was
 
1897
        # successful
 
1898
        msgfilename = None
 
1899
        try:
 
1900
            tmp_fileno, msgfilename = tempfile.mkstemp(prefix='bzr-commit-',
 
1901
                                                       dir=basedir)
 
1902
        except OSError:
 
1903
            try:
 
1904
                # No access to working dir, try $TMP
 
1905
                tmp_fileno, msgfilename = tempfile.mkstemp(prefix='bzr-commit-')
 
1906
            except OSError:
 
1907
                # We can't create a temp file, try to work without it
 
1908
                return None
 
1909
        try:
 
1910
            os.write(tmp_fileno, message.encode(bzrlib.user_encoding, 'replace'))
 
1911
        finally:
 
1912
            os.close(tmp_fileno)
 
1913
        return msgfilename
1056
1914
 
1057
1915
 
1058
1916
class cmd_check(Command):
1061
1919
    This command checks various invariants about the branch storage to
1062
1920
    detect data corruption or bzr bugs.
1063
1921
    """
1064
 
    takes_args = ['dir?']
 
1922
    takes_args = ['branch?']
1065
1923
    takes_options = ['verbose']
1066
1924
 
1067
 
    def run(self, dir='.', verbose=False):
 
1925
    def run(self, branch=None, verbose=False):
1068
1926
        from bzrlib.check import check
1069
 
        check(Branch.open_containing(dir)[0], verbose)
1070
 
 
1071
 
 
1072
 
class cmd_scan_cache(Command):
1073
 
    hidden = True
1074
 
    def run(self):
1075
 
        from bzrlib.hashcache import HashCache
1076
 
 
1077
 
        c = HashCache('.')
1078
 
        c.read()
1079
 
        c.scan()
1080
 
            
1081
 
        print '%6d stats' % c.stat_count
1082
 
        print '%6d in hashcache' % len(c._cache)
1083
 
        print '%6d files removed from cache' % c.removed_count
1084
 
        print '%6d hashes updated' % c.update_count
1085
 
        print '%6d files changed too recently to cache' % c.danger_count
1086
 
 
1087
 
        if c.needs_write:
1088
 
            c.write()
1089
 
            
 
1927
        if branch is None:
 
1928
            tree = WorkingTree.open_containing()[0]
 
1929
            branch = tree.branch
 
1930
        else:
 
1931
            branch = Branch.open(branch)
 
1932
        check(branch, verbose)
1090
1933
 
1091
1934
 
1092
1935
class cmd_upgrade(Command):
1093
1936
    """Upgrade branch storage to current format.
1094
1937
 
1095
1938
    The check command or bzr developers may sometimes advise you to run
1096
 
    this command.
1097
 
 
1098
 
    This version of this command upgrades from the full-text storage
1099
 
    used by bzr 0.0.8 and earlier to the weave format (v5).
 
1939
    this command. When the default format has changed you may also be warned
 
1940
    during other operations to upgrade.
1100
1941
    """
1101
 
    takes_args = ['dir?']
1102
 
 
1103
 
    def run(self, dir='.'):
 
1942
    takes_args = ['url?']
 
1943
    takes_options = [
 
1944
                     Option('format', 
 
1945
                            help='Upgrade to a specific format. Current formats'
 
1946
                                 ' are: default, knit, metaweave and weave.'
 
1947
                                 ' Default is knit; metaweave and weave are'
 
1948
                                 ' deprecated',
 
1949
                            type=get_format_type),
 
1950
                    ]
 
1951
 
 
1952
 
 
1953
    def run(self, url='.', format=None):
1104
1954
        from bzrlib.upgrade import upgrade
1105
 
        upgrade(dir)
 
1955
        if format is None:
 
1956
            format = get_format_type('default')
 
1957
        upgrade(url, format)
1106
1958
 
1107
1959
 
1108
1960
class cmd_whoami(Command):
1109
 
    """Show bzr user id."""
1110
 
    takes_options = ['email']
1111
 
    
1112
 
    def run(self, email=False):
 
1961
    """Show or set bzr user id.
 
1962
    
 
1963
    examples:
 
1964
        bzr whoami --email
 
1965
        bzr whoami 'Frank Chu <fchu@example.com>'
 
1966
    """
 
1967
    takes_options = [ Option('email',
 
1968
                             help='display email address only'),
 
1969
                      Option('branch',
 
1970
                             help='set identity for the current branch instead of '
 
1971
                                  'globally'),
 
1972
                    ]
 
1973
    takes_args = ['name?']
 
1974
    encoding_type = 'replace'
 
1975
    
 
1976
    @display_command
 
1977
    def run(self, email=False, branch=False, name=None):
 
1978
        if name is None:
 
1979
            # use branch if we're inside one; otherwise global config
 
1980
            try:
 
1981
                c = Branch.open_containing('.')[0].get_config()
 
1982
            except errors.NotBranchError:
 
1983
                c = config.GlobalConfig()
 
1984
            if email:
 
1985
                self.outf.write(c.user_email() + '\n')
 
1986
            else:
 
1987
                self.outf.write(c.username() + '\n')
 
1988
            return
 
1989
 
 
1990
        # display a warning if an email address isn't included in the given name.
1113
1991
        try:
1114
 
            b = bzrlib.branch.Branch.open_containing('.')[0]
1115
 
            config = bzrlib.config.BranchConfig(b)
1116
 
        except NotBranchError:
1117
 
            config = bzrlib.config.GlobalConfig()
 
1992
            config.extract_email_address(name)
 
1993
        except errors.NoEmailInUsername, e:
 
1994
            warning('"%s" does not seem to contain an email address.  '
 
1995
                    'This is allowed, but not recommended.', name)
1118
1996
        
1119
 
        if email:
1120
 
            print config.user_email()
1121
 
        else:
1122
 
            print config.username()
 
1997
        # use global config unless --branch given
 
1998
        if branch:
 
1999
            c = Branch.open_containing('.')[0].get_config()
 
2000
        else:
 
2001
            c = config.GlobalConfig()
 
2002
        c.set_user_option('email', name)
 
2003
 
 
2004
 
 
2005
class cmd_nick(Command):
 
2006
    """Print or set the branch nickname.  
 
2007
 
 
2008
    If unset, the tree root directory name is used as the nickname
 
2009
    To print the current nickname, execute with no argument.  
 
2010
    """
 
2011
    takes_args = ['nickname?']
 
2012
    def run(self, nickname=None):
 
2013
        branch = Branch.open_containing(u'.')[0]
 
2014
        if nickname is None:
 
2015
            self.printme(branch)
 
2016
        else:
 
2017
            branch.nick = nickname
 
2018
 
 
2019
    @display_command
 
2020
    def printme(self, branch):
 
2021
        print branch.nick 
1123
2022
 
1124
2023
 
1125
2024
class cmd_selftest(Command):
1128
2027
    This creates temporary test directories in the working directory,
1129
2028
    but not existing data is affected.  These directories are deleted
1130
2029
    if the tests pass, or left behind to help in debugging if they
1131
 
    fail.
 
2030
    fail and --keep-output is specified.
1132
2031
    
1133
2032
    If arguments are given, they are regular expressions that say
1134
2033
    which tests should run.
 
2034
 
 
2035
    If the global option '--no-plugins' is given, plugins are not loaded
 
2036
    before running the selftests.  This has two effects: features provided or
 
2037
    modified by plugins will not be tested, and tests provided by plugins will
 
2038
    not be run.
 
2039
 
 
2040
    examples:
 
2041
        bzr selftest ignore
 
2042
        bzr --no-plugins selftest -v
1135
2043
    """
1136
2044
    # TODO: --list should give a list of all available tests
 
2045
 
 
2046
    # NB: this is used from the class without creating an instance, which is
 
2047
    # why it does not have a self parameter.
 
2048
    def get_transport_type(typestring):
 
2049
        """Parse and return a transport specifier."""
 
2050
        if typestring == "sftp":
 
2051
            from bzrlib.transport.sftp import SFTPAbsoluteServer
 
2052
            return SFTPAbsoluteServer
 
2053
        if typestring == "memory":
 
2054
            from bzrlib.transport.memory import MemoryServer
 
2055
            return MemoryServer
 
2056
        if typestring == "fakenfs":
 
2057
            from bzrlib.transport.fakenfs import FakeNFSServer
 
2058
            return FakeNFSServer
 
2059
        msg = "No known transport type %s. Supported types are: sftp\n" %\
 
2060
            (typestring)
 
2061
        raise errors.BzrCommandError(msg)
 
2062
 
1137
2063
    hidden = True
1138
2064
    takes_args = ['testspecs*']
1139
 
    takes_options = ['verbose', 
 
2065
    takes_options = ['verbose',
1140
2066
                     Option('one', help='stop when one test fails'),
1141
 
                    ]
 
2067
                     Option('keep-output', 
 
2068
                            help='keep output directories when tests fail'),
 
2069
                     Option('transport', 
 
2070
                            help='Use a different transport by default '
 
2071
                                 'throughout the test suite.',
 
2072
                            type=get_transport_type),
 
2073
                     Option('benchmark', help='run the bzr bencharks.'),
 
2074
                     Option('lsprof-timed',
 
2075
                            help='generate lsprof output for benchmarked'
 
2076
                                 ' sections of code.'),
 
2077
                     Option('cache-dir', type=str,
 
2078
                            help='a directory to cache intermediate'
 
2079
                                 ' benchmark steps'),
 
2080
                     ]
1142
2081
 
1143
 
    def run(self, testspecs_list=None, verbose=False, one=False):
 
2082
    def run(self, testspecs_list=None, verbose=None, one=False,
 
2083
            keep_output=False, transport=None, benchmark=None,
 
2084
            lsprof_timed=None, cache_dir=None):
1144
2085
        import bzrlib.ui
1145
 
        from bzrlib.selftest import selftest
1146
 
        # we don't want progress meters from the tests to go to the
1147
 
        # real output; and we don't want log messages cluttering up
1148
 
        # the real logs.
1149
 
        save_ui = bzrlib.ui.ui_factory
1150
 
        bzrlib.trace.info('running tests...')
 
2086
        from bzrlib.tests import selftest
 
2087
        import bzrlib.benchmarks as benchmarks
 
2088
        from bzrlib.benchmarks import tree_creator
 
2089
 
 
2090
        if cache_dir is not None:
 
2091
            tree_creator.TreeCreator.CACHE_ROOT = osutils.abspath(cache_dir)
 
2092
        print '%10s: %s' % ('bzr', osutils.realpath(sys.argv[0]))
 
2093
        print '%10s: %s' % ('bzrlib', bzrlib.__path__[0])
 
2094
        print
 
2095
        if testspecs_list is not None:
 
2096
            pattern = '|'.join(testspecs_list)
 
2097
        else:
 
2098
            pattern = ".*"
 
2099
        if benchmark:
 
2100
            test_suite_factory = benchmarks.test_suite
 
2101
            if verbose is None:
 
2102
                verbose = True
 
2103
            # TODO: should possibly lock the history file...
 
2104
            benchfile = open(".perf_history", "at")
 
2105
        else:
 
2106
            test_suite_factory = None
 
2107
            if verbose is None:
 
2108
                verbose = False
 
2109
            benchfile = None
1151
2110
        try:
1152
 
            bzrlib.ui.ui_factory = bzrlib.ui.SilentUIFactory()
1153
 
            if testspecs_list is not None:
1154
 
                pattern = '|'.join(testspecs_list)
1155
 
            else:
1156
 
                pattern = ".*"
1157
2111
            result = selftest(verbose=verbose, 
1158
2112
                              pattern=pattern,
1159
 
                              stop_on_failure=one)
1160
 
            if result:
1161
 
                bzrlib.trace.info('tests passed')
1162
 
            else:
1163
 
                bzrlib.trace.info('tests failed')
1164
 
            return int(not result)
 
2113
                              stop_on_failure=one, 
 
2114
                              keep_output=keep_output,
 
2115
                              transport=transport,
 
2116
                              test_suite_factory=test_suite_factory,
 
2117
                              lsprof_timed=lsprof_timed,
 
2118
                              bench_history=benchfile)
1165
2119
        finally:
1166
 
            bzrlib.ui.ui_factory = save_ui
1167
 
 
1168
 
 
1169
 
def show_version():
1170
 
    print "bzr (bazaar-ng) %s" % bzrlib.__version__
1171
 
    # is bzrlib itself in a branch?
1172
 
    bzrrev = bzrlib.get_bzr_revision()
1173
 
    if bzrrev:
1174
 
        print "  (bzr checkout, revision %d {%s})" % bzrrev
1175
 
    print bzrlib.__copyright__
1176
 
    print "http://bazaar-ng.org/"
1177
 
    print
1178
 
    print "bzr comes with ABSOLUTELY NO WARRANTY.  bzr is free software, and"
1179
 
    print "you may use, modify and redistribute it under the terms of the GNU"
1180
 
    print "General Public License version 2 or later."
 
2120
            if benchfile is not None:
 
2121
                benchfile.close()
 
2122
        if result:
 
2123
            info('tests passed')
 
2124
        else:
 
2125
            info('tests failed')
 
2126
        return int(not result)
1181
2127
 
1182
2128
 
1183
2129
class cmd_version(Command):
1184
2130
    """Show version of bzr."""
 
2131
 
 
2132
    @display_command
1185
2133
    def run(self):
 
2134
        from bzrlib.version import show_version
1186
2135
        show_version()
1187
2136
 
 
2137
 
1188
2138
class cmd_rocks(Command):
1189
2139
    """Statement of optimism."""
 
2140
 
1190
2141
    hidden = True
 
2142
 
 
2143
    @display_command
1191
2144
    def run(self):
1192
2145
        print "it sure does!"
1193
2146
 
1194
2147
 
1195
2148
class cmd_find_merge_base(Command):
1196
 
    """Find and print a base revision for merging two branches.
1197
 
    """
 
2149
    """Find and print a base revision for merging two branches."""
1198
2150
    # TODO: Options to specify revisions on either side, as if
1199
2151
    #       merging only part of the history.
1200
2152
    takes_args = ['branch', 'other']
1201
2153
    hidden = True
1202
2154
    
 
2155
    @display_command
1203
2156
    def run(self, branch, other):
1204
 
        from bzrlib.revision import common_ancestor, MultipleRevisionSources
 
2157
        from bzrlib.revision import MultipleRevisionSources
1205
2158
        
1206
2159
        branch1 = Branch.open_containing(branch)[0]
1207
2160
        branch2 = Branch.open_containing(other)[0]
1212
2165
        last1 = branch1.last_revision()
1213
2166
        last2 = branch2.last_revision()
1214
2167
 
1215
 
        source = MultipleRevisionSources(branch1, branch2)
 
2168
        source = MultipleRevisionSources(branch1.repository, 
 
2169
                                         branch2.repository)
1216
2170
        
1217
2171
        base_rev_id = common_ancestor(last1, last2, source)
1218
2172
 
1219
2173
        print 'merge base is revision %s' % base_rev_id
1220
 
        
1221
 
        return
1222
 
 
1223
 
        if base_revno is None:
1224
 
            raise bzrlib.errors.UnrelatedBranches()
1225
 
 
1226
 
        print ' r%-6d in %s' % (base_revno, branch)
1227
 
 
1228
 
        other_revno = branch2.revision_id_to_revno(base_revid)
1229
 
        
1230
 
        print ' r%-6d in %s' % (other_revno, other)
1231
 
 
1232
2174
 
1233
2175
 
1234
2176
class cmd_merge(Command):
1235
2177
    """Perform a three-way merge.
1236
2178
    
1237
 
    The branch is the branch you will merge from.  By default, it will
1238
 
    merge the latest revision.  If you specify a revision, that
1239
 
    revision will be merged.  If you specify two revisions, the first
1240
 
    will be used as a BASE, and the second one as OTHER.  Revision
1241
 
    numbers are always relative to the specified branch.
 
2179
    The branch is the branch you will merge from.  By default, it will merge
 
2180
    the latest revision.  If you specify a revision, that revision will be
 
2181
    merged.  If you specify two revisions, the first will be used as a BASE,
 
2182
    and the second one as OTHER.  Revision numbers are always relative to the
 
2183
    specified branch.
1242
2184
 
1243
 
    By default bzr will try to merge in all new work from the other
 
2185
    By default, bzr will try to merge in all new work from the other
1244
2186
    branch, automatically determining an appropriate base.  If this
1245
2187
    fails, you may need to give an explicit base.
1246
2188
    
 
2189
    Merge will do its best to combine the changes in two branches, but there
 
2190
    are some kinds of problems only a human can fix.  When it encounters those,
 
2191
    it will mark a conflict.  A conflict means that you need to fix something,
 
2192
    before you should commit.
 
2193
 
 
2194
    Use bzr resolve when you have fixed a problem.  See also bzr conflicts.
 
2195
 
 
2196
    If there is no default branch set, the first merge will set it. After
 
2197
    that, you can omit the branch to use the default.  To change the
 
2198
    default, use --remember. The value will only be saved if the remote
 
2199
    location can be accessed.
 
2200
 
1247
2201
    Examples:
1248
2202
 
1249
2203
    To merge the latest revision from bzr.dev
1257
2211
    
1258
2212
    merge refuses to run if there are any uncommitted changes, unless
1259
2213
    --force is given.
 
2214
 
 
2215
    The following merge types are available:
1260
2216
    """
1261
2217
    takes_args = ['branch?']
1262
 
    takes_options = ['revision', 'force', 'merge-type']
1263
 
 
1264
 
    def run(self, branch=None, revision=None, force=False, 
1265
 
            merge_type=None):
1266
 
        from bzrlib.merge import merge
1267
 
        from bzrlib.merge_core import ApplyMerge3
 
2218
    takes_options = ['revision', 'force', 'merge-type', 'reprocess', 'remember',
 
2219
                     Option('show-base', help="Show base revision text in "
 
2220
                            "conflicts"), 
 
2221
                     Option('uncommitted', help='Apply uncommitted changes'
 
2222
                            ' from a working copy, instead of branch changes')]
 
2223
 
 
2224
    def help(self):
 
2225
        from inspect import getdoc
 
2226
        return getdoc(self) + '\n' + _mod_merge.merge_type_help()
 
2227
 
 
2228
    def run(self, branch=None, revision=None, force=False, merge_type=None,
 
2229
            show_base=False, reprocess=False, remember=False, 
 
2230
            uncommitted=False):
1268
2231
        if merge_type is None:
1269
 
            merge_type = ApplyMerge3
1270
 
        if branch is None:
1271
 
            branch = Branch.open_containing('.')[0].get_parent()
1272
 
            if branch is None:
1273
 
                raise BzrCommandError("No merge location known or specified.")
 
2232
            merge_type = _mod_merge.Merge3Merger
 
2233
 
 
2234
        tree = WorkingTree.open_containing(u'.')[0]
 
2235
 
 
2236
        if branch is not None:
 
2237
            try:
 
2238
                reader = bundle.read_bundle_from_url(branch)
 
2239
            except errors.NotABundle:
 
2240
                pass # Continue on considering this url a Branch
1274
2241
            else:
1275
 
                print "Using saved location: %s" % branch 
 
2242
                conflicts = merge_bundle(reader, tree, not force, merge_type,
 
2243
                                            reprocess, show_base)
 
2244
                if conflicts == 0:
 
2245
                    return 0
 
2246
                else:
 
2247
                    return 1
 
2248
 
 
2249
        if revision is None \
 
2250
                or len(revision) < 1 or revision[0].needs_branch():
 
2251
            branch = self._get_remembered_parent(tree, branch, 'Merging from')
 
2252
 
1276
2253
        if revision is None or len(revision) < 1:
1277
 
            base = [None, None]
1278
 
            other = [branch, -1]
 
2254
            if uncommitted:
 
2255
                base = [branch, -1]
 
2256
                other = [branch, None]
 
2257
            else:
 
2258
                base = [None, None]
 
2259
                other = [branch, -1]
 
2260
            other_branch, path = Branch.open_containing(branch)
1279
2261
        else:
 
2262
            if uncommitted:
 
2263
                raise errors.BzrCommandError('Cannot use --uncommitted and'
 
2264
                                             ' --revision at the same time.')
 
2265
            branch = revision[0].get_branch() or branch
1280
2266
            if len(revision) == 1:
1281
2267
                base = [None, None]
1282
 
                other = [branch, revision[0].in_history(branch).revno]
 
2268
                other_branch, path = Branch.open_containing(branch)
 
2269
                revno = revision[0].in_history(other_branch).revno
 
2270
                other = [branch, revno]
1283
2271
            else:
1284
2272
                assert len(revision) == 2
1285
2273
                if None in revision:
1286
 
                    raise BzrCommandError(
1287
 
                        "Merge doesn't permit that revision specifier.")
1288
 
                b = Branch.open(branch)
1289
 
 
1290
 
                base = [branch, revision[0].in_history(b).revno]
1291
 
                other = [branch, revision[1].in_history(b).revno]
1292
 
 
 
2274
                    raise errors.BzrCommandError(
 
2275
                        "Merge doesn't permit empty revision specifier.")
 
2276
                base_branch, path = Branch.open_containing(branch)
 
2277
                branch1 = revision[1].get_branch() or branch
 
2278
                other_branch, path1 = Branch.open_containing(branch1)
 
2279
                if revision[0].get_branch() is not None:
 
2280
                    # then path was obtained from it, and is None.
 
2281
                    path = path1
 
2282
 
 
2283
                base = [branch, revision[0].in_history(base_branch).revno]
 
2284
                other = [branch1, revision[1].in_history(other_branch).revno]
 
2285
 
 
2286
        if tree.branch.get_parent() is None or remember:
 
2287
            tree.branch.set_parent(other_branch.base)
 
2288
 
 
2289
        if path != "":
 
2290
            interesting_files = [path]
 
2291
        else:
 
2292
            interesting_files = None
 
2293
        pb = ui.ui_factory.nested_progress_bar()
1293
2294
        try:
1294
 
            merge(other, base, check_clean=(not force), merge_type=merge_type)
1295
 
        except bzrlib.errors.AmbiguousBase, e:
 
2295
            try:
 
2296
                conflict_count = _merge_helper(
 
2297
                    other, base, check_clean=(not force),
 
2298
                    merge_type=merge_type,
 
2299
                    reprocess=reprocess,
 
2300
                    show_base=show_base,
 
2301
                    pb=pb, file_list=interesting_files)
 
2302
            finally:
 
2303
                pb.finished()
 
2304
            if conflict_count != 0:
 
2305
                return 1
 
2306
            else:
 
2307
                return 0
 
2308
        except errors.AmbiguousBase, e:
1296
2309
            m = ("sorry, bzr can't determine the right merge base yet\n"
1297
2310
                 "candidates are:\n  "
1298
2311
                 + "\n  ".join(e.bases)
1301
2314
                 "and (if you want) report this to the bzr developers\n")
1302
2315
            log_error(m)
1303
2316
 
 
2317
    # TODO: move up to common parent; this isn't merge-specific anymore. 
 
2318
    def _get_remembered_parent(self, tree, supplied_location, verb_string):
 
2319
        """Use tree.branch's parent if none was supplied.
 
2320
 
 
2321
        Report if the remembered location was used.
 
2322
        """
 
2323
        if supplied_location is not None:
 
2324
            return supplied_location
 
2325
        stored_location = tree.branch.get_parent()
 
2326
        mutter("%s", stored_location)
 
2327
        if stored_location is None:
 
2328
            raise errors.BzrCommandError("No location specified or remembered")
 
2329
        display_url = urlutils.unescape_for_display(stored_location, self.outf.encoding)
 
2330
        self.outf.write("%s remembered location %s\n" % (verb_string, display_url))
 
2331
        return stored_location
 
2332
 
 
2333
 
 
2334
class cmd_remerge(Command):
 
2335
    """Redo a merge.
 
2336
 
 
2337
    Use this if you want to try a different merge technique while resolving
 
2338
    conflicts.  Some merge techniques are better than others, and remerge 
 
2339
    lets you try different ones on different files.
 
2340
 
 
2341
    The options for remerge have the same meaning and defaults as the ones for
 
2342
    merge.  The difference is that remerge can (only) be run when there is a
 
2343
    pending merge, and it lets you specify particular files.
 
2344
 
 
2345
    Examples:
 
2346
    $ bzr remerge --show-base
 
2347
        Re-do the merge of all conflicted files, and show the base text in
 
2348
        conflict regions, in addition to the usual THIS and OTHER texts.
 
2349
 
 
2350
    $ bzr remerge --merge-type weave --reprocess foobar
 
2351
        Re-do the merge of "foobar", using the weave merge algorithm, with
 
2352
        additional processing to reduce the size of conflict regions.
 
2353
    
 
2354
    The following merge types are available:"""
 
2355
    takes_args = ['file*']
 
2356
    takes_options = ['merge-type', 'reprocess',
 
2357
                     Option('show-base', help="Show base revision text in "
 
2358
                            "conflicts")]
 
2359
 
 
2360
    def help(self):
 
2361
        from inspect import getdoc
 
2362
        return getdoc(self) + '\n' + _mod_merge.merge_type_help()
 
2363
 
 
2364
    def run(self, file_list=None, merge_type=None, show_base=False,
 
2365
            reprocess=False):
 
2366
        if merge_type is None:
 
2367
            merge_type = _mod_merge.Merge3Merger
 
2368
        tree, file_list = tree_files(file_list)
 
2369
        tree.lock_write()
 
2370
        try:
 
2371
            parents = tree.get_parent_ids()
 
2372
            if len(parents) != 2:
 
2373
                raise errors.BzrCommandError("Sorry, remerge only works after normal"
 
2374
                                             " merges.  Not cherrypicking or"
 
2375
                                             " multi-merges.")
 
2376
            repository = tree.branch.repository
 
2377
            base_revision = common_ancestor(parents[0],
 
2378
                                            parents[1], repository)
 
2379
            base_tree = repository.revision_tree(base_revision)
 
2380
            other_tree = repository.revision_tree(parents[1])
 
2381
            interesting_ids = None
 
2382
            new_conflicts = []
 
2383
            conflicts = tree.conflicts()
 
2384
            if file_list is not None:
 
2385
                interesting_ids = set()
 
2386
                for filename in file_list:
 
2387
                    file_id = tree.path2id(filename)
 
2388
                    if file_id is None:
 
2389
                        raise errors.NotVersionedError(filename)
 
2390
                    interesting_ids.add(file_id)
 
2391
                    if tree.kind(file_id) != "directory":
 
2392
                        continue
 
2393
                    
 
2394
                    for name, ie in tree.inventory.iter_entries(file_id):
 
2395
                        interesting_ids.add(ie.file_id)
 
2396
                new_conflicts = conflicts.select_conflicts(tree, file_list)[0]
 
2397
            else:
 
2398
                # Remerge only supports resolving contents conflicts
 
2399
                allowed_conflicts = ('text conflict', 'contents conflict')
 
2400
                restore_files = [c.path for c in conflicts
 
2401
                                 if c.typestring in allowed_conflicts]
 
2402
            _mod_merge.transform_tree(tree, tree.basis_tree(), interesting_ids)
 
2403
            tree.set_conflicts(ConflictList(new_conflicts))
 
2404
            if file_list is not None:
 
2405
                restore_files = file_list
 
2406
            for filename in restore_files:
 
2407
                try:
 
2408
                    restore(tree.abspath(filename))
 
2409
                except errors.NotConflicted:
 
2410
                    pass
 
2411
            conflicts = _mod_merge.merge_inner(
 
2412
                                      tree.branch, other_tree, base_tree,
 
2413
                                      this_tree=tree,
 
2414
                                      interesting_ids=interesting_ids,
 
2415
                                      other_rev_id=parents[1],
 
2416
                                      merge_type=merge_type,
 
2417
                                      show_base=show_base,
 
2418
                                      reprocess=reprocess)
 
2419
        finally:
 
2420
            tree.unlock()
 
2421
        if conflicts > 0:
 
2422
            return 1
 
2423
        else:
 
2424
            return 0
1304
2425
 
1305
2426
class cmd_revert(Command):
1306
 
    """Reverse all changes since the last commit.
1307
 
 
1308
 
    Only versioned files are affected.  Specify filenames to revert only 
1309
 
    those files.  By default, any files that are changed will be backed up
1310
 
    first.  Backup files have a '~' appended to their name.
 
2427
    """Revert files to a previous revision.
 
2428
 
 
2429
    Giving a list of files will revert only those files.  Otherwise, all files
 
2430
    will be reverted.  If the revision is not specified with '--revision', the
 
2431
    last committed revision is used.
 
2432
 
 
2433
    To remove only some changes, without reverting to a prior version, use
 
2434
    merge instead.  For example, "merge . --r-2..-3" will remove the changes
 
2435
    introduced by -2, without affecting the changes introduced by -1.  Or
 
2436
    to remove certain changes on a hunk-by-hunk basis, see the Shelf plugin.
 
2437
    
 
2438
    By default, any files that have been manually changed will be backed up
 
2439
    first.  (Files changed only by merge are not backed up.)  Backup files have
 
2440
    '.~#~' appended to their name, where # is a number.
 
2441
 
 
2442
    When you provide files, you can use their current pathname or the pathname
 
2443
    from the target revision.  So you can use revert to "undelete" a file by
 
2444
    name.  If you name a directory, all the contents of that directory will be
 
2445
    reverted.
1311
2446
    """
1312
2447
    takes_options = ['revision', 'no-backup']
1313
2448
    takes_args = ['file*']
1314
2449
    aliases = ['merge-revert']
1315
2450
 
1316
2451
    def run(self, revision=None, no_backup=False, file_list=None):
1317
 
        from bzrlib.merge import merge
1318
 
        from bzrlib.commands import parse_spec
1319
 
 
1320
2452
        if file_list is not None:
1321
2453
            if len(file_list) == 0:
1322
 
                raise BzrCommandError("No files specified")
 
2454
                raise errors.BzrCommandError("No files specified")
 
2455
        else:
 
2456
            file_list = []
 
2457
        
 
2458
        tree, file_list = tree_files(file_list)
1323
2459
        if revision is None:
1324
 
            revno = -1
 
2460
            # FIXME should be tree.last_revision
 
2461
            rev_id = tree.last_revision()
1325
2462
        elif len(revision) != 1:
1326
 
            raise BzrCommandError('bzr revert --revision takes exactly 1 argument')
 
2463
            raise errors.BzrCommandError('bzr revert --revision takes exactly 1 argument')
1327
2464
        else:
1328
 
            b = Branch.open_containing('.')[0]
1329
 
            revno = revision[0].in_history(b).revno
1330
 
        merge(('.', revno), parse_spec('.'),
1331
 
              check_clean=False,
1332
 
              ignore_zero=True,
1333
 
              backup_files=not no_backup,
1334
 
              file_list=file_list)
1335
 
        if not file_list:
1336
 
            Branch.open_containing('.')[0].set_pending_merges([])
 
2465
            rev_id = revision[0].in_history(tree.branch).rev_id
 
2466
        pb = ui.ui_factory.nested_progress_bar()
 
2467
        try:
 
2468
            tree.revert(file_list, 
 
2469
                        tree.branch.repository.revision_tree(rev_id),
 
2470
                        not no_backup, pb)
 
2471
        finally:
 
2472
            pb.finished()
1337
2473
 
1338
2474
 
1339
2475
class cmd_assert_fail(Command):
1340
2476
    """Test reporting of assertion failures"""
 
2477
    # intended just for use in testing
 
2478
 
1341
2479
    hidden = True
 
2480
 
1342
2481
    def run(self):
1343
 
        assert False, "always fails"
 
2482
        raise AssertionError("always fails")
1344
2483
 
1345
2484
 
1346
2485
class cmd_help(Command):
1347
2486
    """Show help on a command or other topic.
1348
2487
 
1349
2488
    For a list of all available commands, say 'bzr help commands'."""
1350
 
    takes_options = ['long']
 
2489
    takes_options = [Option('long', 'show help on all commands')]
1351
2490
    takes_args = ['topic?']
1352
 
    aliases = ['?']
 
2491
    aliases = ['?', '--help', '-?', '-h']
1353
2492
    
 
2493
    @display_command
1354
2494
    def run(self, topic=None, long=False):
1355
2495
        import help
1356
2496
        if topic is None and long:
1366
2506
    aliases = ['s-c']
1367
2507
    hidden = True
1368
2508
    
 
2509
    @display_command
1369
2510
    def run(self, context=None):
1370
2511
        import shellcomplete
1371
2512
        shellcomplete.shellcomplete(context)
1379
2520
    takes_args = ['from_branch', 'to_branch']
1380
2521
    def run(self, from_branch, to_branch):
1381
2522
        from bzrlib.fetch import Fetcher
1382
 
        from bzrlib.branch import Branch
1383
 
        from_b = Branch(from_branch)
1384
 
        to_b = Branch(to_branch)
 
2523
        from_b = Branch.open(from_branch)
 
2524
        to_b = Branch.open(to_branch)
1385
2525
        Fetcher(to_b, from_b)
1386
 
        
1387
2526
 
1388
2527
 
1389
2528
class cmd_missing(Command):
1390
 
    """What is missing in this branch relative to other branch.
1391
 
    """
1392
 
    # TODO: rewrite this in terms of ancestry so that it shows only
1393
 
    # unmerged things
1394
 
    
1395
 
    takes_args = ['remote?']
1396
 
    aliases = ['mis', 'miss']
1397
 
    # We don't have to add quiet to the list, because 
1398
 
    # unknown options are parsed as booleans
1399
 
    takes_options = ['verbose', 'quiet']
1400
 
 
1401
 
    def run(self, remote=None, verbose=False, quiet=False):
1402
 
        from bzrlib.errors import BzrCommandError
1403
 
        from bzrlib.missing import show_missing
1404
 
 
1405
 
        if verbose and quiet:
1406
 
            raise BzrCommandError('Cannot pass both quiet and verbose')
1407
 
 
1408
 
        b = Branch.open_containing('.')[0]
1409
 
        parent = b.get_parent()
1410
 
        if remote is None:
1411
 
            if parent is None:
1412
 
                raise BzrCommandError("No missing location known or specified.")
1413
 
            else:
1414
 
                if not quiet:
1415
 
                    print "Using last location: %s" % parent
1416
 
                remote = parent
1417
 
        elif parent is None:
1418
 
            # We only update parent if it did not exist, missing
1419
 
            # should not change the parent
1420
 
            b.set_parent(remote)
1421
 
        br_remote = Branch.open_containing(remote)[0]
1422
 
        return show_missing(b, br_remote, verbose=verbose, quiet=quiet)
 
2529
    """Show unmerged/unpulled revisions between two branches.
 
2530
 
 
2531
    OTHER_BRANCH may be local or remote."""
 
2532
    takes_args = ['other_branch?']
 
2533
    takes_options = [Option('reverse', 'Reverse the order of revisions'),
 
2534
                     Option('mine-only', 
 
2535
                            'Display changes in the local branch only'),
 
2536
                     Option('theirs-only', 
 
2537
                            'Display changes in the remote branch only'), 
 
2538
                     'log-format',
 
2539
                     'line',
 
2540
                     'long', 
 
2541
                     'short',
 
2542
                     'show-ids',
 
2543
                     'verbose'
 
2544
                     ]
 
2545
    encoding_type = 'replace'
 
2546
 
 
2547
    @display_command
 
2548
    def run(self, other_branch=None, reverse=False, mine_only=False,
 
2549
            theirs_only=False, log_format=None, long=False, short=False, line=False, 
 
2550
            show_ids=False, verbose=False):
 
2551
        from bzrlib.missing import find_unmerged, iter_log_data
 
2552
        from bzrlib.log import log_formatter
 
2553
        local_branch = Branch.open_containing(u".")[0]
 
2554
        parent = local_branch.get_parent()
 
2555
        if other_branch is None:
 
2556
            other_branch = parent
 
2557
            if other_branch is None:
 
2558
                raise errors.BzrCommandError("No peer location known or specified.")
 
2559
            print "Using last location: " + local_branch.get_parent()
 
2560
        remote_branch = Branch.open(other_branch)
 
2561
        if remote_branch.base == local_branch.base:
 
2562
            remote_branch = local_branch
 
2563
        local_branch.lock_read()
 
2564
        try:
 
2565
            remote_branch.lock_read()
 
2566
            try:
 
2567
                local_extra, remote_extra = find_unmerged(local_branch, remote_branch)
 
2568
                if (log_format is None):
 
2569
                    default = local_branch.get_config().log_format()
 
2570
                    log_format = get_log_format(long=long, short=short, 
 
2571
                                                line=line, default=default)
 
2572
                lf = log_formatter(log_format,
 
2573
                                   to_file=self.outf,
 
2574
                                   show_ids=show_ids,
 
2575
                                   show_timezone='original')
 
2576
                if reverse is False:
 
2577
                    local_extra.reverse()
 
2578
                    remote_extra.reverse()
 
2579
                if local_extra and not theirs_only:
 
2580
                    print "You have %d extra revision(s):" % len(local_extra)
 
2581
                    for data in iter_log_data(local_extra, local_branch.repository,
 
2582
                                              verbose):
 
2583
                        lf.show(*data)
 
2584
                    printed_local = True
 
2585
                else:
 
2586
                    printed_local = False
 
2587
                if remote_extra and not mine_only:
 
2588
                    if printed_local is True:
 
2589
                        print "\n\n"
 
2590
                    print "You are missing %d revision(s):" % len(remote_extra)
 
2591
                    for data in iter_log_data(remote_extra, remote_branch.repository, 
 
2592
                                              verbose):
 
2593
                        lf.show(*data)
 
2594
                if not remote_extra and not local_extra:
 
2595
                    status_code = 0
 
2596
                    print "Branches are up to date."
 
2597
                else:
 
2598
                    status_code = 1
 
2599
            finally:
 
2600
                remote_branch.unlock()
 
2601
        finally:
 
2602
            local_branch.unlock()
 
2603
        if not status_code and parent is None and other_branch is not None:
 
2604
            local_branch.lock_write()
 
2605
            try:
 
2606
                # handle race conditions - a parent might be set while we run.
 
2607
                if local_branch.get_parent() is None:
 
2608
                    local_branch.set_parent(remote_branch.base)
 
2609
            finally:
 
2610
                local_branch.unlock()
 
2611
        return status_code
1423
2612
 
1424
2613
 
1425
2614
class cmd_plugins(Command):
1426
2615
    """List plugins"""
1427
2616
    hidden = True
 
2617
    @display_command
1428
2618
    def run(self):
1429
2619
        import bzrlib.plugin
1430
2620
        from inspect import getdoc
1431
 
        for plugin in bzrlib.plugin.all_plugins:
1432
 
            if hasattr(plugin, '__path__'):
 
2621
        for name, plugin in bzrlib.plugin.all_plugins().items():
 
2622
            if getattr(plugin, '__path__', None) is not None:
1433
2623
                print plugin.__path__[0]
1434
 
            elif hasattr(plugin, '__file__'):
 
2624
            elif getattr(plugin, '__file__', None) is not None:
1435
2625
                print plugin.__file__
1436
2626
            else:
1437
 
                print `plugin`
 
2627
                print repr(plugin)
1438
2628
                
1439
2629
            d = getdoc(plugin)
1440
2630
            if d:
1443
2633
 
1444
2634
class cmd_testament(Command):
1445
2635
    """Show testament (signing-form) of a revision."""
1446
 
    takes_options = ['revision', 'long']
 
2636
    takes_options = ['revision', 
 
2637
                     Option('long', help='Produce long-format testament'), 
 
2638
                     Option('strict', help='Produce a strict-format'
 
2639
                            ' testament')]
1447
2640
    takes_args = ['branch?']
1448
 
    def run(self, branch='.', revision=None, long=False):
1449
 
        from bzrlib.testament import Testament
1450
 
        b = Branch.open_containing(branch)[0]
 
2641
    @display_command
 
2642
    def run(self, branch=u'.', revision=None, long=False, strict=False):
 
2643
        from bzrlib.testament import Testament, StrictTestament
 
2644
        if strict is True:
 
2645
            testament_class = StrictTestament
 
2646
        else:
 
2647
            testament_class = Testament
 
2648
        b = WorkingTree.open_containing(branch)[0].branch
1451
2649
        b.lock_read()
1452
2650
        try:
1453
2651
            if revision is None:
1454
2652
                rev_id = b.last_revision()
1455
2653
            else:
1456
2654
                rev_id = revision[0].in_history(b).rev_id
1457
 
            t = Testament.from_revision(b, rev_id)
 
2655
            t = testament_class.from_revision(b.repository, rev_id)
1458
2656
            if long:
1459
2657
                sys.stdout.writelines(t.as_text_lines())
1460
2658
            else:
1473
2671
    shown only at the top, unless the --all option is given.
1474
2672
    """
1475
2673
    # TODO: annotate directories; showing when each file was last changed
1476
 
    # TODO: annotate a previous version of a file
1477
2674
    # TODO: if the working copy is modified, show annotations on that 
1478
2675
    #       with new uncommitted lines marked
1479
 
    aliases = ['blame', 'praise']
 
2676
    aliases = ['ann', 'blame', 'praise']
1480
2677
    takes_args = ['filename']
1481
2678
    takes_options = [Option('all', help='show annotations on all lines'),
1482
2679
                     Option('long', help='show date in annotations'),
 
2680
                     'revision'
1483
2681
                     ]
1484
2682
 
1485
 
    def run(self, filename, all=False, long=False):
 
2683
    @display_command
 
2684
    def run(self, filename, all=False, long=False, revision=None):
1486
2685
        from bzrlib.annotate import annotate_file
1487
 
        b, relpath = Branch.open_containing(filename)
1488
 
        b.lock_read()
 
2686
        tree, relpath = WorkingTree.open_containing(filename)
 
2687
        branch = tree.branch
 
2688
        branch.lock_read()
1489
2689
        try:
1490
 
            tree = WorkingTree(b.base, b)
1491
 
            tree = b.revision_tree(b.last_revision())
 
2690
            if revision is None:
 
2691
                revision_id = branch.last_revision()
 
2692
            elif len(revision) != 1:
 
2693
                raise errors.BzrCommandError('bzr annotate --revision takes exactly 1 argument')
 
2694
            else:
 
2695
                revision_id = revision[0].in_history(branch).rev_id
1492
2696
            file_id = tree.inventory.path2id(relpath)
 
2697
            tree = branch.repository.revision_tree(revision_id)
1493
2698
            file_version = tree.inventory[file_id].revision
1494
 
            annotate_file(b, file_version, file_id, long, all, sys.stdout)
 
2699
            annotate_file(branch, file_version, file_id, long, all, sys.stdout)
1495
2700
        finally:
1496
 
            b.unlock()
 
2701
            branch.unlock()
1497
2702
 
1498
2703
 
1499
2704
class cmd_re_sign(Command):
1501
2706
    # TODO be able to replace existing ones.
1502
2707
 
1503
2708
    hidden = True # is this right ?
1504
 
    takes_args = ['revision_id?']
 
2709
    takes_args = ['revision_id*']
1505
2710
    takes_options = ['revision']
1506
2711
    
1507
 
    def run(self, revision_id=None, revision=None):
1508
 
        import bzrlib.config as config
 
2712
    def run(self, revision_id_list=None, revision=None):
1509
2713
        import bzrlib.gpg as gpg
1510
 
        if revision_id is not None and revision is not None:
1511
 
            raise BzrCommandError('You can only supply one of revision_id or --revision')
1512
 
        if revision_id is None and revision is None:
1513
 
            raise BzrCommandError('You must supply either --revision or a revision_id')
1514
 
        b = Branch.open_containing('.')[0]
1515
 
        gpg_strategy = gpg.GPGStrategy(config.BranchConfig(b))
1516
 
        if revision_id is not None:
1517
 
            b.sign_revision(revision_id, gpg_strategy)
 
2714
        if revision_id_list is not None and revision is not None:
 
2715
            raise errors.BzrCommandError('You can only supply one of revision_id or --revision')
 
2716
        if revision_id_list is None and revision is None:
 
2717
            raise errors.BzrCommandError('You must supply either --revision or a revision_id')
 
2718
        b = WorkingTree.open_containing(u'.')[0].branch
 
2719
        gpg_strategy = gpg.GPGStrategy(b.get_config())
 
2720
        if revision_id_list is not None:
 
2721
            for revision_id in revision_id_list:
 
2722
                b.repository.sign_revision(revision_id, gpg_strategy)
1518
2723
        elif revision is not None:
1519
 
            for rev in revision:
1520
 
                if rev is None:
1521
 
                    raise BzrCommandError('You cannot specify a NULL revision.')
1522
 
                revno, rev_id = rev.in_history(b)
1523
 
                b.sign_revision(rev_id, gpg_strategy)
 
2724
            if len(revision) == 1:
 
2725
                revno, rev_id = revision[0].in_history(b)
 
2726
                b.repository.sign_revision(rev_id, gpg_strategy)
 
2727
            elif len(revision) == 2:
 
2728
                # are they both on rh- if so we can walk between them
 
2729
                # might be nice to have a range helper for arbitrary
 
2730
                # revision paths. hmm.
 
2731
                from_revno, from_revid = revision[0].in_history(b)
 
2732
                to_revno, to_revid = revision[1].in_history(b)
 
2733
                if to_revid is None:
 
2734
                    to_revno = b.revno()
 
2735
                if from_revno is None or to_revno is None:
 
2736
                    raise errors.BzrCommandError('Cannot sign a range of non-revision-history revisions')
 
2737
                for revno in range(from_revno, to_revno + 1):
 
2738
                    b.repository.sign_revision(b.get_rev_id(revno), 
 
2739
                                               gpg_strategy)
 
2740
            else:
 
2741
                raise errors.BzrCommandError('Please supply either one revision, or a range.')
 
2742
 
 
2743
 
 
2744
class cmd_bind(Command):
 
2745
    """Bind the current branch to a master branch.
 
2746
 
 
2747
    After binding, commits must succeed on the master branch
 
2748
    before they are executed on the local one.
 
2749
    """
 
2750
 
 
2751
    takes_args = ['location']
 
2752
    takes_options = []
 
2753
 
 
2754
    def run(self, location=None):
 
2755
        b, relpath = Branch.open_containing(u'.')
 
2756
        b_other = Branch.open(location)
 
2757
        try:
 
2758
            b.bind(b_other)
 
2759
        except errors.DivergedBranches:
 
2760
            raise errors.BzrCommandError('These branches have diverged.'
 
2761
                                         ' Try merging, and then bind again.')
 
2762
 
 
2763
 
 
2764
class cmd_unbind(Command):
 
2765
    """Unbind the current branch from its master branch.
 
2766
 
 
2767
    After unbinding, the local branch is considered independent.
 
2768
    All subsequent commits will be local.
 
2769
    """
 
2770
 
 
2771
    takes_args = []
 
2772
    takes_options = []
 
2773
 
 
2774
    def run(self):
 
2775
        b, relpath = Branch.open_containing(u'.')
 
2776
        if not b.unbind():
 
2777
            raise errors.BzrCommandError('Local branch is not bound')
 
2778
 
 
2779
 
 
2780
class cmd_uncommit(Command):
 
2781
    """Remove the last committed revision.
 
2782
 
 
2783
    --verbose will print out what is being removed.
 
2784
    --dry-run will go through all the motions, but not actually
 
2785
    remove anything.
 
2786
    
 
2787
    In the future, uncommit will create a revision bundle, which can then
 
2788
    be re-applied.
 
2789
    """
 
2790
 
 
2791
    # TODO: jam 20060108 Add an option to allow uncommit to remove
 
2792
    # unreferenced information in 'branch-as-repository' branches.
 
2793
    # TODO: jam 20060108 Add the ability for uncommit to remove unreferenced
 
2794
    # information in shared branches as well.
 
2795
    takes_options = ['verbose', 'revision',
 
2796
                    Option('dry-run', help='Don\'t actually make changes'),
 
2797
                    Option('force', help='Say yes to all questions.')]
 
2798
    takes_args = ['location?']
 
2799
    aliases = []
 
2800
 
 
2801
    def run(self, location=None,
 
2802
            dry_run=False, verbose=False,
 
2803
            revision=None, force=False):
 
2804
        from bzrlib.log import log_formatter, show_log
 
2805
        import sys
 
2806
        from bzrlib.uncommit import uncommit
 
2807
 
 
2808
        if location is None:
 
2809
            location = u'.'
 
2810
        control, relpath = bzrdir.BzrDir.open_containing(location)
 
2811
        try:
 
2812
            tree = control.open_workingtree()
 
2813
            b = tree.branch
 
2814
        except (errors.NoWorkingTree, errors.NotLocalUrl):
 
2815
            tree = None
 
2816
            b = control.open_branch()
 
2817
 
 
2818
        rev_id = None
 
2819
        if revision is None:
 
2820
            revno = b.revno()
 
2821
        else:
 
2822
            # 'bzr uncommit -r 10' actually means uncommit
 
2823
            # so that the final tree is at revno 10.
 
2824
            # but bzrlib.uncommit.uncommit() actually uncommits
 
2825
            # the revisions that are supplied.
 
2826
            # So we need to offset it by one
 
2827
            revno = revision[0].in_history(b).revno+1
 
2828
 
 
2829
        if revno <= b.revno():
 
2830
            rev_id = b.get_rev_id(revno)
 
2831
        if rev_id is None:
 
2832
            self.outf.write('No revisions to uncommit.\n')
 
2833
            return 1
 
2834
 
 
2835
        lf = log_formatter('short',
 
2836
                           to_file=self.outf,
 
2837
                           show_timezone='original')
 
2838
 
 
2839
        show_log(b,
 
2840
                 lf,
 
2841
                 verbose=False,
 
2842
                 direction='forward',
 
2843
                 start_revision=revno,
 
2844
                 end_revision=b.revno())
 
2845
 
 
2846
        if dry_run:
 
2847
            print 'Dry-run, pretending to remove the above revisions.'
 
2848
            if not force:
 
2849
                val = raw_input('Press <enter> to continue')
 
2850
        else:
 
2851
            print 'The above revision(s) will be removed.'
 
2852
            if not force:
 
2853
                val = raw_input('Are you sure [y/N]? ')
 
2854
                if val.lower() not in ('y', 'yes'):
 
2855
                    print 'Canceled'
 
2856
                    return 0
 
2857
 
 
2858
        uncommit(b, tree=tree, dry_run=dry_run, verbose=verbose,
 
2859
                revno=revno)
 
2860
 
 
2861
 
 
2862
class cmd_break_lock(Command):
 
2863
    """Break a dead lock on a repository, branch or working directory.
 
2864
 
 
2865
    CAUTION: Locks should only be broken when you are sure that the process
 
2866
    holding the lock has been stopped.
 
2867
 
 
2868
    You can get information on what locks are open via the 'bzr info' command.
 
2869
    
 
2870
    example:
 
2871
        bzr break-lock
 
2872
    """
 
2873
    takes_args = ['location?']
 
2874
 
 
2875
    def run(self, location=None, show=False):
 
2876
        if location is None:
 
2877
            location = u'.'
 
2878
        control, relpath = bzrdir.BzrDir.open_containing(location)
 
2879
        try:
 
2880
            control.break_lock()
 
2881
        except NotImplementedError:
 
2882
            pass
 
2883
        
 
2884
 
 
2885
class cmd_wait_until_signalled(Command):
 
2886
    """Test helper for test_start_and_stop_bzr_subprocess_send_signal.
 
2887
 
 
2888
    This just prints a line to signal when it is ready, then blocks on stdin.
 
2889
    """
 
2890
 
 
2891
    hidden = True
 
2892
 
 
2893
    def run(self):
 
2894
        sys.stdout.write("running\n")
 
2895
        sys.stdout.flush()
 
2896
        sys.stdin.readline()
 
2897
 
 
2898
 
 
2899
class cmd_serve(Command):
 
2900
    """Run the bzr server."""
 
2901
 
 
2902
    aliases = ['server']
 
2903
 
 
2904
    takes_options = [
 
2905
        Option('inet',
 
2906
               help='serve on stdin/out for use from inetd or sshd'),
 
2907
        Option('port',
 
2908
               help='listen for connections on nominated port of the form '
 
2909
                    '[hostname:]portnumber. Passing 0 as the port number will '
 
2910
                    'result in a dynamically allocated port.',
 
2911
               type=str),
 
2912
        Option('directory',
 
2913
               help='serve contents of directory',
 
2914
               type=unicode),
 
2915
        Option('allow-writes',
 
2916
               help='By default the server is a readonly server. Supplying '
 
2917
                    '--allow-writes enables write access to the contents of '
 
2918
                    'the served directory and below. '
 
2919
                ),
 
2920
        ]
 
2921
 
 
2922
    def run(self, port=None, inet=False, directory=None, allow_writes=False):
 
2923
        from bzrlib.transport import smart
 
2924
        from bzrlib.transport import get_transport
 
2925
        if directory is None:
 
2926
            directory = os.getcwd()
 
2927
        url = urlutils.local_path_to_url(directory)
 
2928
        if not allow_writes:
 
2929
            url = 'readonly+' + url
 
2930
        t = get_transport(url)
 
2931
        if inet:
 
2932
            server = smart.SmartServerPipeStreamMedium(sys.stdin, sys.stdout, t)
 
2933
        elif port is not None:
 
2934
            if ':' in port:
 
2935
                host, port = port.split(':')
 
2936
            else:
 
2937
                host = '127.0.0.1'
 
2938
            server = smart.SmartTCPServer(t, host=host, port=int(port))
 
2939
            print 'listening on port: ', server.port
 
2940
            sys.stdout.flush()
 
2941
        else:
 
2942
            raise errors.BzrCommandError("bzr serve requires one of --inet or --port")
 
2943
        server.serve()
 
2944
 
 
2945
 
 
2946
# command-line interpretation helper for merge-related commands
 
2947
def _merge_helper(other_revision, base_revision,
 
2948
                  check_clean=True, ignore_zero=False,
 
2949
                  this_dir=None, backup_files=False,
 
2950
                  merge_type=None,
 
2951
                  file_list=None, show_base=False, reprocess=False,
 
2952
                  pb=DummyProgress()):
 
2953
    """Merge changes into a tree.
 
2954
 
 
2955
    base_revision
 
2956
        list(path, revno) Base for three-way merge.  
 
2957
        If [None, None] then a base will be automatically determined.
 
2958
    other_revision
 
2959
        list(path, revno) Other revision for three-way merge.
 
2960
    this_dir
 
2961
        Directory to merge changes into; '.' by default.
 
2962
    check_clean
 
2963
        If true, this_dir must have no uncommitted changes before the
 
2964
        merge begins.
 
2965
    ignore_zero - If true, suppress the "zero conflicts" message when 
 
2966
        there are no conflicts; should be set when doing something we expect
 
2967
        to complete perfectly.
 
2968
    file_list - If supplied, merge only changes to selected files.
 
2969
 
 
2970
    All available ancestors of other_revision and base_revision are
 
2971
    automatically pulled into the branch.
 
2972
 
 
2973
    The revno may be -1 to indicate the last revision on the branch, which is
 
2974
    the typical case.
 
2975
 
 
2976
    This function is intended for use from the command line; programmatic
 
2977
    clients might prefer to call merge.merge_inner(), which has less magic 
 
2978
    behavior.
 
2979
    """
 
2980
    # Loading it late, so that we don't always have to import bzrlib.merge
 
2981
    if merge_type is None:
 
2982
        merge_type = _mod_merge.Merge3Merger
 
2983
    if this_dir is None:
 
2984
        this_dir = u'.'
 
2985
    this_tree = WorkingTree.open_containing(this_dir)[0]
 
2986
    if show_base and not merge_type is _mod_merge.Merge3Merger:
 
2987
        raise errors.BzrCommandError("Show-base is not supported for this merge"
 
2988
                                     " type. %s" % merge_type)
 
2989
    if reprocess and not merge_type.supports_reprocess:
 
2990
        raise errors.BzrCommandError("Conflict reduction is not supported for merge"
 
2991
                                     " type %s." % merge_type)
 
2992
    if reprocess and show_base:
 
2993
        raise errors.BzrCommandError("Cannot do conflict reduction and show base.")
 
2994
    try:
 
2995
        merger = _mod_merge.Merger(this_tree.branch, this_tree=this_tree,
 
2996
                                   pb=pb)
 
2997
        merger.pp = ProgressPhase("Merge phase", 5, pb)
 
2998
        merger.pp.next_phase()
 
2999
        merger.check_basis(check_clean)
 
3000
        merger.set_other(other_revision)
 
3001
        merger.pp.next_phase()
 
3002
        merger.set_base(base_revision)
 
3003
        if merger.base_rev_id == merger.other_rev_id:
 
3004
            note('Nothing to do.')
 
3005
            return 0
 
3006
        merger.backup_files = backup_files
 
3007
        merger.merge_type = merge_type 
 
3008
        merger.set_interesting_files(file_list)
 
3009
        merger.show_base = show_base 
 
3010
        merger.reprocess = reprocess
 
3011
        conflicts = merger.do_merge()
 
3012
        if file_list is None:
 
3013
            merger.set_pending()
 
3014
    finally:
 
3015
        pb.clear()
 
3016
    return conflicts
 
3017
 
 
3018
 
 
3019
# Compatibility
 
3020
merge = _merge_helper
1524
3021
 
1525
3022
 
1526
3023
# these get imported and then picked up by the scan for cmd_*
1527
3024
# TODO: Some more consistent way to split command definitions across files;
1528
3025
# we do need to load at least some information about them to know of 
1529
 
# aliases.
1530
 
from bzrlib.conflicts import cmd_resolve, cmd_conflicts
 
3026
# aliases.  ideally we would avoid loading the implementation until the
 
3027
# details were needed.
 
3028
from bzrlib.cmd_version_info import cmd_version_info
 
3029
from bzrlib.conflicts import cmd_resolve, cmd_conflicts, restore
 
3030
from bzrlib.bundle.commands import cmd_bundle_revisions
 
3031
from bzrlib.sign_my_commits import cmd_sign_my_commits
 
3032
from bzrlib.weave_commands import cmd_weave_list, cmd_weave_join, \
 
3033
        cmd_weave_plan_merge, cmd_weave_merge_text