~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/builtins.py

  • Committer: Robey Pointer
  • Date: 2005-11-22 01:41:46 UTC
  • mfrom: (1185.40.1)
  • mto: (1185.33.37 bzr.dev)
  • mto: This revision was merged to the branch mainline in revision 1512.
  • Revision ID: robey@lag.net-20051122014146-5186f5e310a15202
make sftp put faster when using paramiko 1.5.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2004, 2005, 2006, 2007 Canonical Ltd
2
 
#
 
1
# Copyright (C) 2004, 2005 by 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
 
"""builtin bzr commands"""
18
 
 
19
 
import os
 
17
# DO NOT change this to cStringIO - it results in control files 
 
18
# written as UCS4
 
19
# FIXIT! (Only deal with byte streams OR unicode at any one layer.)
 
20
# RBC 20051018
20
21
from StringIO import StringIO
21
 
 
22
 
from bzrlib.lazy_import import lazy_import
23
 
lazy_import(globals(), """
24
 
import codecs
25
 
import errno
26
22
import sys
27
 
import tempfile
28
 
import time
 
23
import os
29
24
 
30
25
import bzrlib
31
 
from bzrlib import (
32
 
    branch,
33
 
    bugtracker,
34
 
    bundle,
35
 
    bzrdir,
36
 
    delta,
37
 
    config,
38
 
    errors,
39
 
    globbing,
40
 
    ignores,
41
 
    log,
42
 
    merge as _mod_merge,
43
 
    merge_directive,
44
 
    osutils,
45
 
    registry,
46
 
    repository,
47
 
    revision as _mod_revision,
48
 
    revisionspec,
49
 
    symbol_versioning,
50
 
    transport,
51
 
    tree as _mod_tree,
52
 
    ui,
53
 
    urlutils,
54
 
    )
 
26
from bzrlib import BZRDIR
 
27
from bzrlib.commands import Command, display_command
55
28
from bzrlib.branch import Branch
56
 
from bzrlib.bundle.apply_bundle import install_bundle, merge_bundle
57
 
from bzrlib.conflicts import ConflictList
 
29
from bzrlib.revision import common_ancestor
 
30
from bzrlib.errors import (BzrError, BzrCheckError, BzrCommandError, 
 
31
                           NotBranchError, DivergedBranches, NotConflicted,
 
32
                           NoSuchFile, NoWorkingTree, FileInWrongBranch)
 
33
from bzrlib.option import Option
58
34
from bzrlib.revisionspec import RevisionSpec
59
 
from bzrlib.smtp_connection import SMTPConnection
 
35
import bzrlib.trace
 
36
from bzrlib.trace import mutter, note, log_error, warning
60
37
from bzrlib.workingtree import WorkingTree
61
 
""")
62
 
 
63
 
from bzrlib.commands import Command, display_command
64
 
from bzrlib.option import ListOption, Option, RegistryOption
65
 
from bzrlib.progress import DummyProgress, ProgressPhase
66
 
from bzrlib.trace import mutter, note, log_error, warning, is_quiet, info
67
 
 
68
 
 
69
 
def tree_files(file_list, default_branch=u'.'):
 
38
 
 
39
 
 
40
def branch_files(file_list, default_branch='.'):
70
41
    try:
71
 
        return internal_tree_files(file_list, default_branch)
72
 
    except errors.FileInWrongBranch, e:
73
 
        raise errors.BzrCommandError("%s is not in the same branch as %s" %
74
 
                                     (e.path, file_list[0]))
75
 
 
76
 
 
77
 
# XXX: Bad function name; should possibly also be a class method of
78
 
# WorkingTree rather than a function.
79
 
def internal_tree_files(file_list, default_branch=u'.'):
80
 
    """Convert command-line paths to a WorkingTree and relative paths.
81
 
 
82
 
    This is typically used for command-line processors that take one or
83
 
    more filenames, and infer the workingtree that contains them.
84
 
 
85
 
    The filenames given are not required to exist.
86
 
 
87
 
    :param file_list: Filenames to convert.  
88
 
 
89
 
    :param default_branch: Fallback tree path to use if file_list is empty or
90
 
        None.
91
 
 
92
 
    :return: workingtree, [relative_paths]
 
42
        return inner_branch_files(file_list, default_branch)
 
43
    except FileInWrongBranch, e:
 
44
        print file_list
 
45
        raise BzrCommandError("%s is not in the same branch as %s" %
 
46
                             (e.path, file_list[0]))
 
47
 
 
48
def inner_branch_files(file_list, default_branch='.'):
 
49
    """\
 
50
    Return a branch and list of branch-relative paths.
 
51
    If supplied file_list is empty or None, the branch default will be used,
 
52
    and returned file_list will match the original.
93
53
    """
94
54
    if file_list is None or len(file_list) == 0:
95
 
        return WorkingTree.open_containing(default_branch)[0], file_list
96
 
    tree = WorkingTree.open_containing(osutils.realpath(file_list[0]))[0]
 
55
        return Branch.open_containing(default_branch)[0], file_list
 
56
    b = Branch.open_containing(file_list[0])[0]
 
57
    
 
58
    # note that if this is a remote branch, we would want
 
59
    # relpath against the transport. RBC 20051018
 
60
    # Most branch ops can't meaningfully operate on files in remote branches;
 
61
    # the above comment was in cmd_status.  ADHB 20051026
 
62
    tree = WorkingTree(b.base, b)
97
63
    new_list = []
98
64
    for filename in file_list:
99
65
        try:
100
 
            new_list.append(tree.relpath(osutils.dereference_path(filename)))
101
 
        except errors.PathNotChild:
102
 
            raise errors.FileInWrongBranch(tree.branch, filename)
103
 
    return tree, new_list
104
 
 
105
 
 
106
 
@symbol_versioning.deprecated_function(symbol_versioning.zero_fifteen)
107
 
def get_format_type(typestring):
108
 
    """Parse and return a format specifier."""
109
 
    # Have to use BzrDirMetaFormat1 directly, so that
110
 
    # RepositoryFormat.set_default_format works
111
 
    if typestring == "default":
112
 
        return bzrdir.BzrDirMetaFormat1()
113
 
    try:
114
 
        return bzrdir.format_registry.make_bzrdir(typestring)
115
 
    except KeyError:
116
 
        msg = 'Unknown bzr format "%s". See "bzr help formats".' % typestring
117
 
        raise errors.BzrCommandError(msg)
 
66
            new_list.append(tree.relpath(filename))
 
67
        except NotBranchError:
 
68
            raise FileInWrongBranch(b, filename)
 
69
    return b, new_list
118
70
 
119
71
 
120
72
# TODO: Make sure no commands unconditionally use the working directory as a
144
96
    modified
145
97
        Text has changed since the previous revision.
146
98
 
147
 
    kind changed
148
 
        File kind has been changed (e.g. from file to directory).
 
99
    unchanged
 
100
        Nothing about this file has changed since the previous revision.
 
101
        Only shown with --all.
149
102
 
150
103
    unknown
151
104
        Not versioned and not matching an ignore pattern.
152
105
 
153
 
    To see ignored files use 'bzr ignored'.  For details on the
 
106
    To see ignored files use 'bzr ignored'.  For details in the
154
107
    changes to file texts, use 'bzr diff'.
155
 
    
156
 
    --short gives a status flags for each item, similar to the SVN's status
157
 
    command.
158
108
 
159
109
    If no arguments are specified, the status of the entire working
160
110
    directory is shown.  Otherwise, only the status of the specified
168
118
    # TODO: --no-recurse, --recurse options
169
119
    
170
120
    takes_args = ['file*']
171
 
    takes_options = ['show-ids', 'revision',
172
 
                     Option('short', help='Give short SVN-style status lines.'),
173
 
                     Option('versioned', help='Only show versioned files.')]
 
121
    takes_options = ['all', 'show-ids', 'revision']
174
122
    aliases = ['st', 'stat']
175
 
 
176
 
    encoding_type = 'replace'
177
 
    _see_also = ['diff', 'revert', 'status-flags']
178
123
    
179
124
    @display_command
180
 
    def run(self, show_ids=False, file_list=None, revision=None, short=False,
181
 
            versioned=False):
182
 
        from bzrlib.status import show_tree_status
183
 
 
184
 
        tree, file_list = tree_files(file_list)
 
125
    def run(self, all=False, show_ids=False, file_list=None, revision=None):
 
126
        b, file_list = branch_files(file_list)
185
127
            
186
 
        show_tree_status(tree, show_ids=show_ids,
187
 
                         specific_files=file_list, revision=revision,
188
 
                         to_file=self.outf, short=short, versioned=versioned)
 
128
        from bzrlib.status import show_status
 
129
        show_status(b, show_unchanged=all, show_ids=show_ids,
 
130
                    specific_files=file_list, revision=revision)
189
131
 
190
132
 
191
133
class cmd_cat_revision(Command):
198
140
    hidden = True
199
141
    takes_args = ['revision_id?']
200
142
    takes_options = ['revision']
201
 
    # cat-revision is more for frontends so should be exact
202
 
    encoding = 'strict'
203
143
    
204
144
    @display_command
205
145
    def run(self, revision_id=None, revision=None):
206
146
 
207
 
        revision_id = osutils.safe_revision_id(revision_id, warn=False)
208
147
        if revision_id is not None and revision is not None:
209
 
            raise errors.BzrCommandError('You can only supply one of'
210
 
                                         ' revision_id or --revision')
 
148
            raise BzrCommandError('You can only supply one of revision_id or --revision')
211
149
        if revision_id is None and revision is None:
212
 
            raise errors.BzrCommandError('You must supply either'
213
 
                                         ' --revision or a revision_id')
214
 
        b = WorkingTree.open_containing(u'.')[0].branch
215
 
 
216
 
        # TODO: jam 20060112 should cat-revision always output utf-8?
 
150
            raise BzrCommandError('You must supply either --revision or a revision_id')
 
151
        b = Branch.open_containing('.')[0]
217
152
        if revision_id is not None:
218
 
            self.outf.write(b.repository.get_revision_xml(revision_id).decode('utf-8'))
 
153
            sys.stdout.write(b.get_revision_xml_file(revision_id).read())
219
154
        elif revision is not None:
220
155
            for rev in revision:
221
156
                if rev is None:
222
 
                    raise errors.BzrCommandError('You cannot specify a NULL'
223
 
                                                 ' revision.')
 
157
                    raise BzrCommandError('You cannot specify a NULL revision.')
224
158
                revno, rev_id = rev.in_history(b)
225
 
                self.outf.write(b.repository.get_revision_xml(rev_id).decode('utf-8'))
 
159
                sys.stdout.write(b.get_revision_xml_file(rev_id).read())
226
160
    
227
161
 
228
 
class cmd_remove_tree(Command):
229
 
    """Remove the working tree from a given branch/checkout.
230
 
 
231
 
    Since a lightweight checkout is little more than a working tree
232
 
    this will refuse to run against one.
233
 
 
234
 
    To re-create the working tree, use "bzr checkout".
235
 
    """
236
 
    _see_also = ['checkout', 'working-trees']
237
 
 
238
 
    takes_args = ['location?']
239
 
 
240
 
    def run(self, location='.'):
241
 
        d = bzrdir.BzrDir.open(location)
242
 
        
243
 
        try:
244
 
            working = d.open_workingtree()
245
 
        except errors.NoWorkingTree:
246
 
            raise errors.BzrCommandError("No working tree to remove")
247
 
        except errors.NotLocalUrl:
248
 
            raise errors.BzrCommandError("You cannot remove the working tree of a "
249
 
                                         "remote path")
250
 
        
251
 
        working_path = working.bzrdir.root_transport.base
252
 
        branch_path = working.branch.bzrdir.root_transport.base
253
 
        if working_path != branch_path:
254
 
            raise errors.BzrCommandError("You cannot remove the working tree from "
255
 
                                         "a lightweight checkout")
256
 
        
257
 
        d.destroy_workingtree()
258
 
        
259
 
 
260
162
class cmd_revno(Command):
261
163
    """Show current revision number.
262
164
 
263
 
    This is equal to the number of revisions on this branch.
264
 
    """
265
 
 
266
 
    _see_also = ['info']
267
 
    takes_args = ['location?']
268
 
 
 
165
    This is equal to the number of revisions on this branch."""
269
166
    @display_command
270
 
    def run(self, location=u'.'):
271
 
        self.outf.write(str(Branch.open_containing(location)[0].revno()))
272
 
        self.outf.write('\n')
 
167
    def run(self):
 
168
        print Branch.open_containing('.')[0].revno()
273
169
 
274
170
 
275
171
class cmd_revision_info(Command):
278
174
    hidden = True
279
175
    takes_args = ['revision_info*']
280
176
    takes_options = ['revision']
281
 
 
282
177
    @display_command
283
178
    def run(self, revision=None, revision_info_list=[]):
284
179
 
287
182
            revs.extend(revision)
288
183
        if revision_info_list is not None:
289
184
            for rev in revision_info_list:
290
 
                revs.append(RevisionSpec.from_string(rev))
291
 
 
292
 
        b = Branch.open_containing(u'.')[0]
293
 
 
 
185
                revs.append(RevisionSpec(rev))
294
186
        if len(revs) == 0:
295
 
            revs.append(RevisionSpec.from_string('-1'))
 
187
            raise BzrCommandError('You must supply a revision identifier')
 
188
 
 
189
        b = Branch.open_containing('.')[0]
296
190
 
297
191
        for rev in revs:
298
192
            revinfo = rev.in_history(b)
299
193
            if revinfo.revno is None:
300
 
                dotted_map = b.get_revision_id_to_revno_map()
301
 
                revno = '.'.join(str(i) for i in dotted_map[revinfo.rev_id])
302
 
                print '%s %s' % (revno, revinfo.rev_id)
 
194
                print '     %s' % revinfo.rev_id
303
195
            else:
304
196
                print '%4d %s' % (revinfo.revno, revinfo.rev_id)
305
197
 
324
216
 
325
217
    Adding a file whose parent directory is not versioned will
326
218
    implicitly add the parent, and so on up to the root. This means
327
 
    you should never need to explicitly add a directory, they'll just
 
219
    you should never need to explictly add a directory, they'll just
328
220
    get added when you add a file in the directory.
329
 
 
330
 
    --dry-run will show which files would be added, but not actually 
331
 
    add them.
332
 
 
333
 
    --file-ids-from will try to use the file ids from the supplied path.
334
 
    It looks up ids trying to find a matching parent directory with the
335
 
    same filename, and then by pure path. This option is rarely needed
336
 
    but can be useful when adding the same logical file into two
337
 
    branches that will be merged later (without showing the two different
338
 
    adds as a conflict). It is also useful when merging another project
339
 
    into a subdirectory of this one.
340
221
    """
341
222
    takes_args = ['file*']
342
 
    takes_options = [
343
 
        Option('no-recurse',
344
 
               help="Don't recursively add the contents of directories."),
345
 
        Option('dry-run',
346
 
               help="Show what would be done, but don't actually do anything."),
347
 
        'verbose',
348
 
        Option('file-ids-from',
349
 
               type=unicode,
350
 
               help='Lookup file ids from this tree.'),
351
 
        ]
352
 
    encoding_type = 'replace'
353
 
    _see_also = ['remove']
354
 
 
355
 
    def run(self, file_list, no_recurse=False, dry_run=False, verbose=False,
356
 
            file_ids_from=None):
357
 
        import bzrlib.add
358
 
 
359
 
        base_tree = None
360
 
        if file_ids_from is not None:
361
 
            try:
362
 
                base_tree, base_path = WorkingTree.open_containing(
363
 
                                            file_ids_from)
364
 
            except errors.NoWorkingTree:
365
 
                base_branch, base_path = Branch.open_containing(
366
 
                                            file_ids_from)
367
 
                base_tree = base_branch.basis_tree()
368
 
 
369
 
            action = bzrlib.add.AddFromBaseAction(base_tree, base_path,
370
 
                          to_file=self.outf, should_print=(not is_quiet()))
 
223
    takes_options = ['no-recurse', 'quiet']
 
224
    
 
225
    def run(self, file_list, no_recurse=False, quiet=False):
 
226
        from bzrlib.add import smart_add, add_reporter_print, add_reporter_null
 
227
        if quiet:
 
228
            reporter = add_reporter_null
371
229
        else:
372
 
            action = bzrlib.add.AddAction(to_file=self.outf,
373
 
                should_print=(not is_quiet()))
374
 
 
375
 
        if base_tree:
376
 
            base_tree.lock_read()
377
 
        try:
378
 
            file_list = self._maybe_expand_globs(file_list)
379
 
            if file_list:
380
 
                tree = WorkingTree.open_containing(file_list[0])[0]
381
 
            else:
382
 
                tree = WorkingTree.open_containing(u'.')[0]
383
 
            added, ignored = tree.smart_add(file_list, not
384
 
                no_recurse, action=action, save=not dry_run)
385
 
        finally:
386
 
            if base_tree is not None:
387
 
                base_tree.unlock()
388
 
        if len(ignored) > 0:
389
 
            if verbose:
390
 
                for glob in sorted(ignored.keys()):
391
 
                    for path in ignored[glob]:
392
 
                        self.outf.write("ignored %s matching \"%s\"\n" 
393
 
                                        % (path, glob))
394
 
            else:
395
 
                match_len = 0
396
 
                for glob, paths in ignored.items():
397
 
                    match_len += len(paths)
398
 
                self.outf.write("ignored %d file(s).\n" % match_len)
399
 
            self.outf.write("If you wish to add some of these files,"
400
 
                            " please add them by name.\n")
 
230
            reporter = add_reporter_print
 
231
        smart_add(file_list, not no_recurse, reporter)
401
232
 
402
233
 
403
234
class cmd_mkdir(Command):
405
236
 
406
237
    This is equivalent to creating the directory and then adding it.
407
238
    """
408
 
 
409
239
    takes_args = ['dir+']
410
 
    encoding_type = 'replace'
411
240
 
412
241
    def run(self, dir_list):
 
242
        b = None
 
243
        
413
244
        for d in dir_list:
414
245
            os.mkdir(d)
415
 
            wt, dd = WorkingTree.open_containing(d)
416
 
            wt.add([dd])
417
 
            self.outf.write('added %s\n' % d)
 
246
            b, dd = Branch.open_containing(d)
 
247
            b.add([dd])
 
248
            print 'added', d
418
249
 
419
250
 
420
251
class cmd_relpath(Command):
421
252
    """Show path of a file relative to root"""
422
 
 
423
253
    takes_args = ['filename']
424
254
    hidden = True
425
255
    
426
256
    @display_command
427
257
    def run(self, filename):
428
 
        # TODO: jam 20050106 Can relpath return a munged path if
429
 
        #       sys.stdout encoding cannot represent it?
430
 
        tree, relpath = WorkingTree.open_containing(filename)
431
 
        self.outf.write(relpath)
432
 
        self.outf.write('\n')
 
258
        branch, relpath = Branch.open_containing(filename)
 
259
        print relpath
433
260
 
434
261
 
435
262
class cmd_inventory(Command):
436
 
    """Show inventory of the current working copy or a revision.
437
 
 
438
 
    It is possible to limit the output to a particular entry
439
 
    type using the --kind option.  For example: --kind file.
440
 
 
441
 
    It is also possible to restrict the list of files to a specific
442
 
    set. For example: bzr inventory --show-ids this/file
443
 
    """
444
 
 
445
 
    hidden = True
446
 
    _see_also = ['ls']
447
 
    takes_options = [
448
 
        'revision',
449
 
        'show-ids',
450
 
        Option('kind',
451
 
               help='List entries of a particular kind: file, directory, symlink.',
452
 
               type=unicode),
453
 
        ]
454
 
    takes_args = ['file*']
455
 
 
 
263
    """Show inventory of the current working copy or a revision."""
 
264
    takes_options = ['revision', 'show-ids']
 
265
    
456
266
    @display_command
457
 
    def run(self, revision=None, show_ids=False, kind=None, file_list=None):
458
 
        if kind and kind not in ['file', 'directory', 'symlink']:
459
 
            raise errors.BzrCommandError('invalid kind %r specified' % (kind,))
460
 
 
461
 
        work_tree, file_list = tree_files(file_list)
462
 
        work_tree.lock_read()
463
 
        try:
464
 
            if revision is not None:
465
 
                if len(revision) > 1:
466
 
                    raise errors.BzrCommandError(
467
 
                        'bzr inventory --revision takes exactly one revision'
468
 
                        ' identifier')
469
 
                revision_id = revision[0].in_history(work_tree.branch).rev_id
470
 
                tree = work_tree.branch.repository.revision_tree(revision_id)
471
 
 
472
 
                extra_trees = [work_tree]
473
 
                tree.lock_read()
474
 
            else:
475
 
                tree = work_tree
476
 
                extra_trees = []
477
 
 
478
 
            if file_list is not None:
479
 
                file_ids = tree.paths2ids(file_list, trees=extra_trees,
480
 
                                          require_versioned=True)
481
 
                # find_ids_across_trees may include some paths that don't
482
 
                # exist in 'tree'.
483
 
                entries = sorted((tree.id2path(file_id), tree.inventory[file_id])
484
 
                                 for file_id in file_ids if file_id in tree)
485
 
            else:
486
 
                entries = tree.inventory.entries()
487
 
        finally:
488
 
            tree.unlock()
489
 
            if tree is not work_tree:
490
 
                work_tree.unlock()
491
 
 
492
 
        for path, entry in entries:
493
 
            if kind and kind != entry.kind:
494
 
                continue
 
267
    def run(self, revision=None, show_ids=False):
 
268
        b = Branch.open_containing('.')[0]
 
269
        if revision is None:
 
270
            inv = b.working_tree().read_working_inventory()
 
271
        else:
 
272
            if len(revision) > 1:
 
273
                raise BzrCommandError('bzr inventory --revision takes'
 
274
                    ' exactly one revision identifier')
 
275
            inv = b.get_revision_inventory(revision[0].in_history(b).rev_id)
 
276
 
 
277
        for path, entry in inv.entries():
495
278
            if show_ids:
496
 
                self.outf.write('%-50s %s\n' % (path, entry.file_id))
 
279
                print '%-50s %s' % (path, entry.file_id)
497
280
            else:
498
 
                self.outf.write(path)
499
 
                self.outf.write('\n')
 
281
                print path
 
282
 
 
283
 
 
284
class cmd_move(Command):
 
285
    """Move files to a different directory.
 
286
 
 
287
    examples:
 
288
        bzr move *.txt doc
 
289
 
 
290
    The destination must be a versioned directory in the same branch.
 
291
    """
 
292
    takes_args = ['source$', 'dest']
 
293
    def run(self, source_list, dest):
 
294
        b, source_list = branch_files(source_list)
 
295
 
 
296
        # TODO: glob expansion on windows?
 
297
        tree = WorkingTree(b.base, b)
 
298
        b.move(source_list, tree.relpath(dest))
 
299
 
 
300
 
 
301
class cmd_rename(Command):
 
302
    """Change the name of an entry.
 
303
 
 
304
    examples:
 
305
      bzr rename frob.c frobber.c
 
306
      bzr rename src/frob.c lib/frob.c
 
307
 
 
308
    It is an error if the destination name exists.
 
309
 
 
310
    See also the 'move' command, which moves files into a different
 
311
    directory without changing their name.
 
312
    """
 
313
    # TODO: Some way to rename multiple files without invoking 
 
314
    # bzr for each one?"""
 
315
    takes_args = ['from_name', 'to_name']
 
316
    
 
317
    def run(self, from_name, to_name):
 
318
        b, (from_name, to_name) = branch_files((from_name, to_name))
 
319
        b.rename_one(from_name, to_name)
500
320
 
501
321
 
502
322
class cmd_mv(Command):
508
328
 
509
329
    If the last argument is a versioned directory, all the other names
510
330
    are moved into it.  Otherwise, there must be exactly two arguments
511
 
    and the file is changed to a new name.
512
 
 
513
 
    If OLDNAME does not exist on the filesystem but is versioned and
514
 
    NEWNAME does exist on the filesystem but is not versioned, mv
515
 
    assumes that the file has been manually moved and only updates
516
 
    its internal inventory to reflect that change.
517
 
    The same is valid when moving many SOURCE files to a DESTINATION.
 
331
    and the file is changed to a new name, which must not already exist.
518
332
 
519
333
    Files cannot be moved between branches.
520
334
    """
521
 
 
522
335
    takes_args = ['names*']
523
 
    takes_options = [Option("after", help="Move only the bzr identifier"
524
 
        " of the file, because the file has already been moved."),
525
 
        ]
526
 
    aliases = ['move', 'rename']
527
 
    encoding_type = 'replace'
528
 
 
529
 
    def run(self, names_list, after=False):
530
 
        if names_list is None:
531
 
            names_list = []
532
 
 
 
336
    def run(self, names_list):
533
337
        if len(names_list) < 2:
534
 
            raise errors.BzrCommandError("missing file argument")
535
 
        tree, rel_names = tree_files(names_list)
 
338
            raise BzrCommandError("missing file argument")
 
339
        b, rel_names = branch_files(names_list)
536
340
        
537
341
        if os.path.isdir(names_list[-1]):
538
342
            # move into existing directory
539
 
            for pair in tree.move(rel_names[:-1], rel_names[-1], after=after):
540
 
                self.outf.write("%s => %s\n" % pair)
 
343
            for pair in b.move(rel_names[:-1], rel_names[-1]):
 
344
                print "%s => %s" % pair
541
345
        else:
542
346
            if len(names_list) != 2:
543
 
                raise errors.BzrCommandError('to mv multiple files the'
544
 
                                             ' destination must be a versioned'
545
 
                                             ' directory')
546
 
            tree.rename_one(rel_names[0], rel_names[1], after=after)
547
 
            self.outf.write("%s => %s\n" % (rel_names[0], rel_names[1]))
 
347
                raise BzrCommandError('to mv multiple files the destination '
 
348
                                      'must be a versioned directory')
 
349
            b.rename_one(rel_names[0], rel_names[1])
 
350
            print "%s => %s" % (rel_names[0], rel_names[1])
548
351
            
549
352
    
550
353
class cmd_pull(Command):
551
 
    """Turn this branch into a mirror of another branch.
 
354
    """Pull any changes from another branch into the current one.
 
355
 
 
356
    If there is no default location set, the first pull will set it.  After
 
357
    that, you can omit the location to use the default.  To change the
 
358
    default, use --remember.
552
359
 
553
360
    This command only works on branches that have not diverged.  Branches are
554
 
    considered diverged if the destination branch's most recent commit is one
555
 
    that has not been merged (directly or indirectly) into the parent.
 
361
    considered diverged if both branches have had commits without first
 
362
    pulling from the other.
556
363
 
557
 
    If branches have diverged, you can use 'bzr merge' to integrate the changes
 
364
    If branches have diverged, you can use 'bzr merge' to pull the text changes
558
365
    from one into the other.  Once one branch has merged, the other should
559
366
    be able to pull it again.
560
367
 
561
368
    If you want to forget your local changes and just update your branch to
562
 
    match the remote one, use pull --overwrite.
563
 
 
564
 
    If there is no default location set, the first pull will set it.  After
565
 
    that, you can omit the location to use the default.  To change the
566
 
    default, use --remember. The value will only be saved if the remote
567
 
    location can be accessed.
 
369
    match the remote one, use --overwrite.
568
370
    """
569
 
 
570
 
    _see_also = ['push', 'update', 'status-flags']
571
 
    takes_options = ['remember', 'overwrite', 'revision', 'verbose',
572
 
        Option('directory',
573
 
            help='Branch to pull into, '
574
 
                 'rather than the one containing the working directory.',
575
 
            short_name='d',
576
 
            type=unicode,
577
 
            ),
578
 
        ]
 
371
    takes_options = ['remember', 'overwrite', 'verbose']
579
372
    takes_args = ['location?']
580
 
    encoding_type = 'replace'
581
 
 
582
 
    def run(self, location=None, remember=False, overwrite=False,
583
 
            revision=None, verbose=False,
584
 
            directory=None):
585
 
        from bzrlib.tag import _merge_tags_if_possible
586
 
        # FIXME: too much stuff is in the command class
587
 
        revision_id = None
588
 
        mergeable = None
589
 
        if directory is None:
590
 
            directory = u'.'
591
 
        try:
592
 
            tree_to = WorkingTree.open_containing(directory)[0]
593
 
            branch_to = tree_to.branch
594
 
        except errors.NoWorkingTree:
595
 
            tree_to = None
596
 
            branch_to = Branch.open_containing(directory)[0]
597
 
 
598
 
        reader = None
599
 
        if location is not None:
600
 
            try:
601
 
                mergeable = bundle.read_mergeable_from_url(
602
 
                    location)
603
 
            except errors.NotABundle:
604
 
                pass # Continue on considering this url a Branch
605
 
 
606
 
        stored_loc = branch_to.get_parent()
 
373
 
 
374
    def run(self, location=None, remember=False, overwrite=False, verbose=False):
 
375
        from bzrlib.merge import merge
 
376
        from shutil import rmtree
 
377
        import errno
 
378
        
 
379
        br_to = Branch.open_containing('.')[0]
 
380
        stored_loc = br_to.get_parent()
607
381
        if location is None:
608
382
            if stored_loc is None:
609
 
                raise errors.BzrCommandError("No pull location known or"
610
 
                                             " specified.")
 
383
                raise BzrCommandError("No pull location known or specified.")
611
384
            else:
612
 
                display_url = urlutils.unescape_for_display(stored_loc,
613
 
                        self.outf.encoding)
614
 
                self.outf.write("Using saved location: %s\n" % display_url)
 
385
                print "Using saved location: %s" % stored_loc
615
386
                location = stored_loc
616
 
 
617
 
        if mergeable is not None:
618
 
            if revision is not None:
619
 
                raise errors.BzrCommandError(
620
 
                    'Cannot use -r with merge directives or bundles')
621
 
            revision_id = mergeable.install_revisions(branch_to.repository)
622
 
            branch_from = branch_to
623
 
        else:
624
 
            branch_from = Branch.open(location)
625
 
 
626
 
            if branch_to.get_parent() is None or remember:
627
 
                branch_to.set_parent(branch_from.base)
628
 
 
629
 
        if revision is not None:
630
 
            if len(revision) == 1:
631
 
                revision_id = revision[0].in_history(branch_from).rev_id
632
 
            else:
633
 
                raise errors.BzrCommandError(
634
 
                    'bzr pull --revision takes one value.')
635
 
 
636
 
        old_rh = branch_to.revision_history()
637
 
        if tree_to is not None:
638
 
            result = tree_to.pull(branch_from, overwrite, revision_id,
639
 
                delta._ChangeReporter(unversioned_filter=tree_to.is_ignored))
640
 
        else:
641
 
            result = branch_to.pull(branch_from, overwrite, revision_id)
642
 
 
643
 
        result.report(self.outf)
 
387
        br_from = Branch.open(location)
 
388
        try:
 
389
            old_rh = br_to.revision_history()
 
390
            br_to.working_tree().pull(br_from, overwrite)
 
391
        except DivergedBranches:
 
392
            raise BzrCommandError("These branches have diverged."
 
393
                                  "  Try merge.")
 
394
        if br_to.get_parent() is None or remember:
 
395
            br_to.set_parent(location)
 
396
 
644
397
        if verbose:
645
 
            from bzrlib.log import show_changed_revisions
646
 
            new_rh = branch_to.revision_history()
647
 
            show_changed_revisions(branch_to, old_rh, new_rh,
648
 
                                   to_file=self.outf)
 
398
            new_rh = br_to.revision_history()
 
399
            if old_rh != new_rh:
 
400
                # Something changed
 
401
                from bzrlib.log import show_changed_revisions
 
402
                show_changed_revisions(br_to, old_rh, new_rh)
649
403
 
650
404
 
651
405
class cmd_push(Command):
652
 
    """Update a mirror of this branch.
653
 
    
654
 
    The target branch will not have its working tree populated because this
655
 
    is both expensive, and is not supported on remote file systems.
656
 
    
657
 
    Some smart servers or protocols *may* put the working tree in place in
658
 
    the future.
 
406
    """Push this branch into another branch.
 
407
    
 
408
    The remote branch will not have its working tree populated because this
 
409
    is both expensive, and may not be supported on the remote file system.
 
410
    
 
411
    Some smart servers or protocols *may* put the working tree in place.
 
412
 
 
413
    If there is no default push location set, the first push will set it.
 
414
    After that, you can omit the location to use the default.  To change the
 
415
    default, use --remember.
659
416
 
660
417
    This command only works on branches that have not diverged.  Branches are
661
 
    considered diverged if the destination branch's most recent commit is one
662
 
    that has not been merged (directly or indirectly) by the source branch.
 
418
    considered diverged if the branch being pushed to is not an older version
 
419
    of this branch.
663
420
 
664
421
    If branches have diverged, you can use 'bzr push --overwrite' to replace
665
 
    the other branch completely, discarding its unmerged changes.
 
422
    the other branch completely.
666
423
    
667
424
    If you want to ensure you have the different changes in the other branch,
668
 
    do a merge (see bzr help merge) from the other branch, and commit that.
669
 
    After that you will be able to do a push without '--overwrite'.
670
 
 
671
 
    If there is no default push location set, the first push will set it.
672
 
    After that, you can omit the location to use the default.  To change the
673
 
    default, use --remember. The value will only be saved if the remote
674
 
    location can be accessed.
 
425
    do a merge (see bzr help merge) from the other branch, and commit that
 
426
    before doing a 'push --overwrite'.
675
427
    """
676
 
 
677
 
    _see_also = ['pull', 'update', 'working-trees']
678
 
    takes_options = ['remember', 'overwrite', 'verbose',
679
 
        Option('create-prefix',
680
 
               help='Create the path leading up to the branch '
681
 
                    'if it does not already exist.'),
682
 
        Option('directory',
683
 
            help='Branch to push from, '
684
 
                 'rather than the one containing the working directory.',
685
 
            short_name='d',
686
 
            type=unicode,
687
 
            ),
688
 
        Option('use-existing-dir',
689
 
               help='By default push will fail if the target'
690
 
                    ' directory exists, but does not already'
691
 
                    ' have a control directory.  This flag will'
692
 
                    ' allow push to proceed.'),
693
 
        ]
 
428
    takes_options = ['remember', 'overwrite', 
 
429
                     Option('create-prefix', 
 
430
                            help='Create the path leading up to the branch '
 
431
                                 'if it does not already exist')]
694
432
    takes_args = ['location?']
695
 
    encoding_type = 'replace'
696
433
 
697
434
    def run(self, location=None, remember=False, overwrite=False,
698
 
            create_prefix=False, verbose=False,
699
 
            use_existing_dir=False,
700
 
            directory=None):
701
 
        # FIXME: Way too big!  Put this into a function called from the
702
 
        # command.
703
 
        if directory is None:
704
 
            directory = '.'
705
 
        br_from = Branch.open_containing(directory)[0]
 
435
            create_prefix=False, verbose=False):
 
436
        import errno
 
437
        from shutil import rmtree
 
438
        from bzrlib.transport import get_transport
 
439
        
 
440
        br_from = Branch.open_containing('.')[0]
706
441
        stored_loc = br_from.get_push_location()
707
442
        if location is None:
708
443
            if stored_loc is None:
709
 
                raise errors.BzrCommandError("No push location known or specified.")
 
444
                raise BzrCommandError("No push location known or specified.")
710
445
            else:
711
 
                display_url = urlutils.unescape_for_display(stored_loc,
712
 
                        self.outf.encoding)
713
 
                self.outf.write("Using saved location: %s\n" % display_url)
 
446
                print "Using saved location: %s" % stored_loc
714
447
                location = stored_loc
715
 
 
716
 
        to_transport = transport.get_transport(location)
717
 
 
718
 
        br_to = repository_to = dir_to = None
719
448
        try:
720
 
            dir_to = bzrdir.BzrDir.open_from_transport(to_transport)
721
 
        except errors.NotBranchError:
722
 
            pass # Didn't find anything
723
 
        else:
724
 
            # If we can open a branch, use its direct repository, otherwise see
725
 
            # if there is a repository without a branch.
726
 
            try:
727
 
                br_to = dir_to.open_branch()
728
 
            except errors.NotBranchError:
729
 
                # Didn't find a branch, can we find a repository?
730
 
                try:
731
 
                    repository_to = dir_to.find_repository()
732
 
                except errors.NoRepositoryPresent:
733
 
                    pass
734
 
            else:
735
 
                # Found a branch, so we must have found a repository
736
 
                repository_to = br_to.repository
737
 
        push_result = None
738
 
        old_rh = []
739
 
        if dir_to is None:
740
 
            # The destination doesn't exist; create it.
741
 
            # XXX: Refactor the create_prefix/no_create_prefix code into a
742
 
            #      common helper function
743
 
            try:
744
 
                to_transport.mkdir('.')
745
 
            except errors.FileExists:
746
 
                if not use_existing_dir:
747
 
                    raise errors.BzrCommandError("Target directory %s"
748
 
                         " already exists, but does not have a valid .bzr"
749
 
                         " directory. Supply --use-existing-dir to push"
750
 
                         " there anyway." % location)
751
 
            except errors.NoSuchFile:
752
 
                if not create_prefix:
753
 
                    raise errors.BzrCommandError("Parent directory of %s"
754
 
                        " does not exist."
755
 
                        "\nYou may supply --create-prefix to create all"
756
 
                        " leading parent directories."
757
 
                        % location)
758
 
                _create_prefix(to_transport)
759
 
 
760
 
            # Now the target directory exists, but doesn't have a .bzr
761
 
            # directory. So we need to create it, along with any work to create
762
 
            # all of the dependent branches, etc.
763
 
            dir_to = br_from.bzrdir.clone_on_transport(to_transport,
764
 
                revision_id=br_from.last_revision())
765
 
            br_to = dir_to.open_branch()
766
 
            # TODO: Some more useful message about what was copied
767
 
            note('Created new branch.')
768
 
            # We successfully created the target, remember it
769
 
            if br_from.get_push_location() is None or remember:
770
 
                br_from.set_push_location(br_to.base)
771
 
        elif repository_to is None:
772
 
            # we have a bzrdir but no branch or repository
773
 
            # XXX: Figure out what to do other than complain.
774
 
            raise errors.BzrCommandError("At %s you have a valid .bzr control"
775
 
                " directory, but not a branch or repository. This is an"
776
 
                " unsupported configuration. Please move the target directory"
777
 
                " out of the way and try again."
778
 
                % location)
779
 
        elif br_to is None:
780
 
            # We have a repository but no branch, copy the revisions, and then
 
449
            br_to = Branch.open(location)
 
450
        except NotBranchError:
781
451
            # create a branch.
782
 
            last_revision_id = br_from.last_revision()
783
 
            repository_to.fetch(br_from.repository,
784
 
                                revision_id=last_revision_id)
785
 
            br_to = br_from.clone(dir_to, revision_id=last_revision_id)
786
 
            note('Created new branch.')
787
 
            if br_from.get_push_location() is None or remember:
788
 
                br_from.set_push_location(br_to.base)
789
 
        else: # We have a valid to branch
790
 
            # We were able to connect to the remote location, so remember it
791
 
            # we don't need to successfully push because of possible divergence.
792
 
            if br_from.get_push_location() is None or remember:
793
 
                br_from.set_push_location(br_to.base)
794
 
            old_rh = br_to.revision_history()
795
 
            try:
 
452
            transport = get_transport(location).clone('..')
 
453
            if not create_prefix:
796
454
                try:
797
 
                    tree_to = dir_to.open_workingtree()
798
 
                except errors.NotLocalUrl:
799
 
                    warning("This transport does not update the working " 
800
 
                            "tree of: %s. See 'bzr help working-trees' for "
801
 
                            "more information." % br_to.base)
802
 
                    push_result = br_from.push(br_to, overwrite)
803
 
                except errors.NoWorkingTree:
804
 
                    push_result = br_from.push(br_to, overwrite)
805
 
                else:
806
 
                    tree_to.lock_write()
 
455
                    transport.mkdir(transport.relpath(location))
 
456
                except NoSuchFile:
 
457
                    raise BzrCommandError("Parent directory of %s "
 
458
                                          "does not exist." % location)
 
459
            else:
 
460
                current = transport.base
 
461
                needed = [(transport, transport.relpath(location))]
 
462
                while needed:
807
463
                    try:
808
 
                        push_result = br_from.push(tree_to.branch, overwrite)
809
 
                        tree_to.update()
810
 
                    finally:
811
 
                        tree_to.unlock()
812
 
            except errors.DivergedBranches:
813
 
                raise errors.BzrCommandError('These branches have diverged.'
814
 
                                        '  Try using "merge" and then "push".')
815
 
        if push_result is not None:
816
 
            push_result.report(self.outf)
817
 
        elif verbose:
 
464
                        transport, relpath = needed[-1]
 
465
                        transport.mkdir(relpath)
 
466
                        needed.pop()
 
467
                    except NoSuchFile:
 
468
                        new_transport = transport.clone('..')
 
469
                        needed.append((new_transport,
 
470
                                       new_transport.relpath(transport.base)))
 
471
                        if new_transport.base == transport.base:
 
472
                            raise BzrCommandError("Could not creeate "
 
473
                                                  "path prefix.")
 
474
                        
 
475
            NoSuchFile
 
476
            br_to = Branch.initialize(location)
 
477
        try:
 
478
            old_rh = br_to.revision_history()
 
479
            br_to.pull(br_from, overwrite)
 
480
        except DivergedBranches:
 
481
            raise BzrCommandError("These branches have diverged."
 
482
                                  "  Try a merge then push with overwrite.")
 
483
        if br_from.get_push_location() is None or remember:
 
484
            br_from.set_push_location(location)
 
485
 
 
486
        if verbose:
818
487
            new_rh = br_to.revision_history()
819
488
            if old_rh != new_rh:
820
489
                # Something changed
821
490
                from bzrlib.log import show_changed_revisions
822
 
                show_changed_revisions(br_to, old_rh, new_rh,
823
 
                                       to_file=self.outf)
824
 
        else:
825
 
            # we probably did a clone rather than a push, so a message was
826
 
            # emitted above
827
 
            pass
828
 
 
 
491
                show_changed_revisions(br_to, old_rh, new_rh)
829
492
 
830
493
class cmd_branch(Command):
831
494
    """Create a new copy of a branch.
832
495
 
833
496
    If the TO_LOCATION is omitted, the last component of the FROM_LOCATION will
834
497
    be used.  In other words, "branch ../foo/bar" will attempt to create ./bar.
835
 
    If the FROM_LOCATION has no / or path separator embedded, the TO_LOCATION
836
 
    is derived from the FROM_LOCATION by stripping a leading scheme or drive
837
 
    identifier, if any. For example, "branch lp:foo-bar" will attempt to
838
 
    create ./foo-bar.
839
498
 
840
499
    To retrieve the branch as of a particular revision, supply the --revision
841
500
    parameter, as in "branch foo/bar -r 5".
 
501
 
 
502
    --basis is to speed up branching from remote branches.  When specified, it
 
503
    copies all the file-contents, inventory and revision data from the basis
 
504
    branch before copying anything from the remote branch.
842
505
    """
843
 
 
844
 
    _see_also = ['checkout']
845
506
    takes_args = ['from_location', 'to_location?']
846
 
    takes_options = ['revision']
 
507
    takes_options = ['revision', 'basis']
847
508
    aliases = ['get', 'clone']
848
509
 
849
 
    def run(self, from_location, to_location=None, revision=None):
850
 
        from bzrlib.tag import _merge_tags_if_possible
 
510
    def run(self, from_location, to_location=None, revision=None, basis=None):
 
511
        from bzrlib.clone import copy_branch
 
512
        import errno
 
513
        from shutil import rmtree
851
514
        if revision is None:
852
515
            revision = [None]
853
516
        elif len(revision) > 1:
854
 
            raise errors.BzrCommandError(
 
517
            raise BzrCommandError(
855
518
                'bzr branch --revision takes exactly 1 revision value')
856
 
 
857
 
        br_from = Branch.open(from_location)
 
519
        try:
 
520
            br_from = Branch.open(from_location)
 
521
        except OSError, e:
 
522
            if e.errno == errno.ENOENT:
 
523
                raise BzrCommandError('Source location "%s" does not'
 
524
                                      ' exist.' % to_location)
 
525
            else:
 
526
                raise
858
527
        br_from.lock_read()
859
528
        try:
 
529
            if basis is not None:
 
530
                basis_branch = Branch.open_containing(basis)[0]
 
531
            else:
 
532
                basis_branch = None
860
533
            if len(revision) == 1 and revision[0] is not None:
861
534
                revision_id = revision[0].in_history(br_from)[1]
862
535
            else:
863
 
                # FIXME - wt.last_revision, fallback to branch, fall back to
864
 
                # None or perhaps NULL_REVISION to mean copy nothing
865
 
                # RBC 20060209
866
 
                revision_id = br_from.last_revision()
 
536
                revision_id = None
867
537
            if to_location is None:
868
 
                to_location = urlutils.derive_to_location(from_location)
 
538
                to_location = os.path.basename(from_location.rstrip("/\\"))
869
539
                name = None
870
540
            else:
871
541
                name = os.path.basename(to_location) + '\n'
872
 
 
873
 
            to_transport = transport.get_transport(to_location)
874
 
            try:
875
 
                to_transport.mkdir('.')
876
 
            except errors.FileExists:
877
 
                raise errors.BzrCommandError('Target directory "%s" already'
878
 
                                             ' exists.' % to_location)
879
 
            except errors.NoSuchFile:
880
 
                raise errors.BzrCommandError('Parent of "%s" does not exist.'
881
 
                                             % to_location)
882
 
            try:
883
 
                # preserve whatever source format we have.
884
 
                dir = br_from.bzrdir.sprout(to_transport.base, revision_id)
885
 
                branch = dir.open_branch()
886
 
            except errors.NoSuchRevision:
887
 
                to_transport.delete_tree('.')
 
542
            try:
 
543
                os.mkdir(to_location)
 
544
            except OSError, e:
 
545
                if e.errno == errno.EEXIST:
 
546
                    raise BzrCommandError('Target directory "%s" already'
 
547
                                          ' exists.' % to_location)
 
548
                if e.errno == errno.ENOENT:
 
549
                    raise BzrCommandError('Parent of "%s" does not exist.' %
 
550
                                          to_location)
 
551
                else:
 
552
                    raise
 
553
            try:
 
554
                copy_branch(br_from, to_location, revision_id, basis_branch)
 
555
            except bzrlib.errors.NoSuchRevision:
 
556
                rmtree(to_location)
888
557
                msg = "The branch %s has no revision %s." % (from_location, revision[0])
889
 
                raise errors.BzrCommandError(msg)
 
558
                raise BzrCommandError(msg)
 
559
            except bzrlib.errors.UnlistableBranch:
 
560
                rmtree(to_location)
 
561
                msg = "The branch %s cannot be used as a --basis"
 
562
                raise BzrCommandError(msg)
890
563
            if name:
891
 
                branch.control_files.put_utf8('branch-name', name)
892
 
            _merge_tags_if_possible(br_from, branch)
893
 
            note('Branched %d revision(s).' % branch.revno())
 
564
                branch = Branch.open(to_location)
 
565
                name = StringIO(name)
 
566
                branch.put_controlfile('branch-name', name)
894
567
        finally:
895
568
            br_from.unlock()
896
569
 
897
570
 
898
 
class cmd_checkout(Command):
899
 
    """Create a new checkout of an existing branch.
900
 
 
901
 
    If BRANCH_LOCATION is omitted, checkout will reconstitute a working tree for
902
 
    the branch found in '.'. This is useful if you have removed the working tree
903
 
    or if it was never created - i.e. if you pushed the branch to its current
904
 
    location using SFTP.
905
 
    
906
 
    If the TO_LOCATION is omitted, the last component of the BRANCH_LOCATION will
907
 
    be used.  In other words, "checkout ../foo/bar" will attempt to create ./bar.
908
 
    If the BRANCH_LOCATION has no / or path separator embedded, the TO_LOCATION
909
 
    is derived from the BRANCH_LOCATION by stripping a leading scheme or drive
910
 
    identifier, if any. For example, "checkout lp:foo-bar" will attempt to
911
 
    create ./foo-bar.
912
 
 
913
 
    To retrieve the branch as of a particular revision, supply the --revision
914
 
    parameter, as in "checkout foo/bar -r 5". Note that this will be immediately
915
 
    out of date [so you cannot commit] but it may be useful (i.e. to examine old
916
 
    code.)
917
 
    """
918
 
 
919
 
    _see_also = ['checkouts', 'branch']
920
 
    takes_args = ['branch_location?', 'to_location?']
921
 
    takes_options = ['revision',
922
 
                     Option('lightweight',
923
 
                            help="Perform a lightweight checkout.  Lightweight "
924
 
                                 "checkouts depend on access to the branch for "
925
 
                                 "every operation.  Normal checkouts can perform "
926
 
                                 "common operations like diff and status without "
927
 
                                 "such access, and also support local commits."
928
 
                            ),
929
 
                     ]
930
 
    aliases = ['co']
931
 
 
932
 
    def run(self, branch_location=None, to_location=None, revision=None,
933
 
            lightweight=False):
934
 
        if revision is None:
935
 
            revision = [None]
936
 
        elif len(revision) > 1:
937
 
            raise errors.BzrCommandError(
938
 
                'bzr checkout --revision takes exactly 1 revision value')
939
 
        if branch_location is None:
940
 
            branch_location = osutils.getcwd()
941
 
            to_location = branch_location
942
 
        source = Branch.open(branch_location)
943
 
        if len(revision) == 1 and revision[0] is not None:
944
 
            revision_id = revision[0].in_history(source)[1]
945
 
        else:
946
 
            revision_id = None
947
 
        if to_location is None:
948
 
            to_location = urlutils.derive_to_location(branch_location)
949
 
        # if the source and to_location are the same, 
950
 
        # and there is no working tree,
951
 
        # then reconstitute a branch
952
 
        if (osutils.abspath(to_location) ==
953
 
            osutils.abspath(branch_location)):
954
 
            try:
955
 
                source.bzrdir.open_workingtree()
956
 
            except errors.NoWorkingTree:
957
 
                source.bzrdir.create_workingtree()
958
 
                return
959
 
        try:
960
 
            os.mkdir(to_location)
961
 
        except OSError, e:
962
 
            if e.errno == errno.EEXIST:
963
 
                raise errors.BzrCommandError('Target directory "%s" already'
964
 
                                             ' exists.' % to_location)
965
 
            if e.errno == errno.ENOENT:
966
 
                raise errors.BzrCommandError('Parent of "%s" does not exist.'
967
 
                                             % to_location)
968
 
            else:
969
 
                raise
970
 
        source.create_checkout(to_location, revision_id, lightweight)
971
 
 
972
 
 
973
571
class cmd_renames(Command):
974
572
    """Show list of renamed files.
975
573
    """
976
574
    # TODO: Option to show renames between two historical versions.
977
575
 
978
576
    # TODO: Only show renames under dir, rather than in the whole branch.
979
 
    _see_also = ['status']
980
577
    takes_args = ['dir?']
981
578
 
982
579
    @display_command
983
 
    def run(self, dir=u'.'):
984
 
        tree = WorkingTree.open_containing(dir)[0]
985
 
        tree.lock_read()
986
 
        try:
987
 
            new_inv = tree.inventory
988
 
            old_tree = tree.basis_tree()
989
 
            old_tree.lock_read()
990
 
            try:
991
 
                old_inv = old_tree.inventory
992
 
                renames = list(_mod_tree.find_renames(old_inv, new_inv))
993
 
                renames.sort()
994
 
                for old_name, new_name in renames:
995
 
                    self.outf.write("%s => %s\n" % (old_name, new_name))
996
 
            finally:
997
 
                old_tree.unlock()
998
 
        finally:
999
 
            tree.unlock()
1000
 
 
1001
 
 
1002
 
class cmd_update(Command):
1003
 
    """Update a tree to have the latest code committed to its branch.
1004
 
    
1005
 
    This will perform a merge into the working tree, and may generate
1006
 
    conflicts. If you have any local changes, you will still 
1007
 
    need to commit them after the update for the update to be complete.
1008
 
    
1009
 
    If you want to discard your local changes, you can just do a 
1010
 
    'bzr revert' instead of 'bzr commit' after the update.
1011
 
    """
1012
 
 
1013
 
    _see_also = ['pull', 'working-trees']
1014
 
    takes_args = ['dir?']
1015
 
    aliases = ['up']
1016
 
 
1017
580
    def run(self, dir='.'):
1018
 
        tree = WorkingTree.open_containing(dir)[0]
1019
 
        master = tree.branch.get_master_branch()
1020
 
        if master is not None:
1021
 
            tree.lock_write()
1022
 
        else:
1023
 
            tree.lock_tree_write()
1024
 
        try:
1025
 
            existing_pending_merges = tree.get_parent_ids()[1:]
1026
 
            last_rev = _mod_revision.ensure_null(tree.last_revision())
1027
 
            if last_rev == _mod_revision.ensure_null(
1028
 
                tree.branch.last_revision()):
1029
 
                # may be up to date, check master too.
1030
 
                master = tree.branch.get_master_branch()
1031
 
                if master is None or last_rev == _mod_revision.ensure_null(
1032
 
                    master.last_revision()):
1033
 
                    revno = tree.branch.revision_id_to_revno(last_rev)
1034
 
                    note("Tree is up to date at revision %d." % (revno,))
1035
 
                    return 0
1036
 
            conflicts = tree.update(delta._ChangeReporter(
1037
 
                                        unversioned_filter=tree.is_ignored))
1038
 
            revno = tree.branch.revision_id_to_revno(
1039
 
                _mod_revision.ensure_null(tree.last_revision()))
1040
 
            note('Updated to revision %d.' % (revno,))
1041
 
            if tree.get_parent_ids()[1:] != existing_pending_merges:
1042
 
                note('Your local commits will now show as pending merges with '
1043
 
                     "'bzr status', and can be committed with 'bzr commit'.")
1044
 
            if conflicts != 0:
1045
 
                return 1
1046
 
            else:
1047
 
                return 0
1048
 
        finally:
1049
 
            tree.unlock()
 
581
        b = Branch.open_containing(dir)[0]
 
582
        old_inv = b.basis_tree().inventory
 
583
        new_inv = b.working_tree().read_working_inventory()
 
584
 
 
585
        renames = list(bzrlib.tree.find_renames(old_inv, new_inv))
 
586
        renames.sort()
 
587
        for old_name, new_name in renames:
 
588
            print "%s => %s" % (old_name, new_name)        
1050
589
 
1051
590
 
1052
591
class cmd_info(Command):
1053
 
    """Show information about a working tree, branch or repository.
1054
 
 
1055
 
    This command will show all known locations and formats associated to the
1056
 
    tree, branch or repository.  Statistical information is included with
1057
 
    each report.
1058
 
 
1059
 
    Branches and working trees will also report any missing revisions.
1060
 
    """
1061
 
    _see_also = ['revno', 'working-trees', 'repositories']
1062
 
    takes_args = ['location?']
1063
 
    takes_options = ['verbose']
1064
 
 
 
592
    """Show statistical information about a branch."""
 
593
    takes_args = ['branch?']
 
594
    
1065
595
    @display_command
1066
 
    def run(self, location=None, verbose=0):
1067
 
        from bzrlib.info import show_bzrdir_info
1068
 
        show_bzrdir_info(bzrdir.BzrDir.open_containing(location)[0],
1069
 
                         verbose=verbose)
 
596
    def run(self, branch=None):
 
597
        import info
 
598
        b = Branch.open_containing(branch)[0]
 
599
        info.show_info(b)
1070
600
 
1071
601
 
1072
602
class cmd_remove(Command):
1073
 
    """Remove files or directories.
1074
 
 
1075
 
    This makes bzr stop tracking changes to the specified files and
1076
 
    delete them if they can easily be recovered using revert.
1077
 
 
1078
 
    You can specify one or more files, and/or --new.  If you specify --new,
1079
 
    only 'added' files will be removed.  If you specify both, then new files
1080
 
    in the specified directories will be removed.  If the directories are
1081
 
    also new, they will also be removed.
 
603
    """Make a file unversioned.
 
604
 
 
605
    This makes bzr stop tracking changes to a versioned file.  It does
 
606
    not delete the working copy.
1082
607
    """
1083
 
    takes_args = ['file*']
1084
 
    takes_options = ['verbose',
1085
 
        Option('new', help='Remove newly-added files.'),
1086
 
        RegistryOption.from_kwargs('file-deletion-strategy',
1087
 
            'The file deletion mode to be used',
1088
 
            title='Deletion Strategy', value_switches=True, enum_switch=False,
1089
 
            safe='Only delete files if they can be'
1090
 
                 ' safely recovered (default).',
1091
 
            keep="Don't delete any files.",
1092
 
            force='Delete all the specified files, even if they can not be '
1093
 
                'recovered and even if they are non-empty directories.')]
 
608
    takes_args = ['file+']
 
609
    takes_options = ['verbose']
1094
610
    aliases = ['rm']
1095
 
    encoding_type = 'replace'
1096
 
 
1097
 
    def run(self, file_list, verbose=False, new=False,
1098
 
        file_deletion_strategy='safe'):
1099
 
        tree, file_list = tree_files(file_list)
1100
 
 
1101
 
        if file_list is not None:
1102
 
            file_list = [f for f in file_list if f != '']
1103
 
        elif not new:
1104
 
            raise errors.BzrCommandError('Specify one or more files to'
1105
 
            ' remove, or use --new.')
1106
 
 
1107
 
        if new:
1108
 
            added = tree.changes_from(tree.basis_tree(),
1109
 
                specific_files=file_list).added
1110
 
            file_list = sorted([f[0] for f in added], reverse=True)
1111
 
            if len(file_list) == 0:
1112
 
                raise errors.BzrCommandError('No matching files.')
1113
 
        tree.remove(file_list, verbose=verbose, to_file=self.outf,
1114
 
            keep_files=file_deletion_strategy=='keep',
1115
 
            force=file_deletion_strategy=='force')
 
611
    
 
612
    def run(self, file_list, verbose=False):
 
613
        b, file_list = branch_files(file_list)
 
614
        tree = b.working_tree()
 
615
        tree.remove(file_list, verbose=verbose)
1116
616
 
1117
617
 
1118
618
class cmd_file_id(Command):
1122
622
    same through all revisions where the file exists, even when it is
1123
623
    moved or renamed.
1124
624
    """
1125
 
 
1126
625
    hidden = True
1127
 
    _see_also = ['inventory', 'ls']
1128
626
    takes_args = ['filename']
1129
 
 
1130
627
    @display_command
1131
628
    def run(self, filename):
1132
 
        tree, relpath = WorkingTree.open_containing(filename)
1133
 
        i = tree.path2id(relpath)
1134
 
        if i is None:
1135
 
            raise errors.NotVersionedError(filename)
 
629
        b, relpath = Branch.open_containing(filename)
 
630
        i = b.working_tree().inventory.path2id(relpath)
 
631
        if i == None:
 
632
            raise BzrError("%r is not a versioned file" % filename)
1136
633
        else:
1137
 
            self.outf.write(i + '\n')
 
634
            print i
1138
635
 
1139
636
 
1140
637
class cmd_file_path(Command):
1141
638
    """Print path of file_ids to a file or directory.
1142
639
 
1143
640
    This prints one line for each directory down to the target,
1144
 
    starting at the branch root.
1145
 
    """
1146
 
 
 
641
    starting at the branch root."""
1147
642
    hidden = True
1148
643
    takes_args = ['filename']
1149
 
 
1150
644
    @display_command
1151
645
    def run(self, filename):
1152
 
        tree, relpath = WorkingTree.open_containing(filename)
1153
 
        fid = tree.path2id(relpath)
1154
 
        if fid is None:
1155
 
            raise errors.NotVersionedError(filename)
1156
 
        segments = osutils.splitpath(relpath)
1157
 
        for pos in range(1, len(segments) + 1):
1158
 
            path = osutils.joinpath(segments[:pos])
1159
 
            self.outf.write("%s\n" % tree.path2id(path))
1160
 
 
1161
 
 
1162
 
class cmd_reconcile(Command):
1163
 
    """Reconcile bzr metadata in a branch.
1164
 
 
1165
 
    This can correct data mismatches that may have been caused by
1166
 
    previous ghost operations or bzr upgrades. You should only
1167
 
    need to run this command if 'bzr check' or a bzr developer 
1168
 
    advises you to run it.
1169
 
 
1170
 
    If a second branch is provided, cross-branch reconciliation is
1171
 
    also attempted, which will check that data like the tree root
1172
 
    id which was not present in very early bzr versions is represented
1173
 
    correctly in both branches.
1174
 
 
1175
 
    At the same time it is run it may recompress data resulting in 
1176
 
    a potential saving in disk space or performance gain.
1177
 
 
1178
 
    The branch *MUST* be on a listable system such as local disk or sftp.
1179
 
    """
1180
 
 
1181
 
    _see_also = ['check']
1182
 
    takes_args = ['branch?']
1183
 
 
1184
 
    def run(self, branch="."):
1185
 
        from bzrlib.reconcile import reconcile
1186
 
        dir = bzrdir.BzrDir.open(branch)
1187
 
        reconcile(dir)
 
646
        b, relpath = Branch.open_containing(filename)
 
647
        inv = b.inventory
 
648
        fid = inv.path2id(relpath)
 
649
        if fid == None:
 
650
            raise BzrError("%r is not a versioned file" % filename)
 
651
        for fip in inv.get_idpath(fid):
 
652
            print fip
1188
653
 
1189
654
 
1190
655
class cmd_revision_history(Command):
1191
 
    """Display the list of revision ids on a branch."""
1192
 
 
1193
 
    _see_also = ['log']
1194
 
    takes_args = ['location?']
1195
 
 
 
656
    """Display list of revision ids on this branch."""
1196
657
    hidden = True
1197
 
 
1198
658
    @display_command
1199
 
    def run(self, location="."):
1200
 
        branch = Branch.open_containing(location)[0]
1201
 
        for revid in branch.revision_history():
1202
 
            self.outf.write(revid)
1203
 
            self.outf.write('\n')
 
659
    def run(self):
 
660
        for patchid in Branch.open_containing('.')[0].revision_history():
 
661
            print patchid
1204
662
 
1205
663
 
1206
664
class cmd_ancestry(Command):
1207
665
    """List all revisions merged into this branch."""
1208
 
 
1209
 
    _see_also = ['log', 'revision-history']
1210
 
    takes_args = ['location?']
1211
 
 
1212
666
    hidden = True
1213
 
 
1214
 
    @display_command
1215
 
    def run(self, location="."):
1216
 
        try:
1217
 
            wt = WorkingTree.open_containing(location)[0]
1218
 
        except errors.NoWorkingTree:
1219
 
            b = Branch.open(location)
1220
 
            last_revision = b.last_revision()
1221
 
        else:
1222
 
            b = wt.branch
1223
 
            last_revision = wt.last_revision()
1224
 
 
1225
 
        revision_ids = b.repository.get_ancestry(last_revision)
1226
 
        assert revision_ids[0] is None
1227
 
        revision_ids.pop(0)
1228
 
        for revision_id in revision_ids:
1229
 
            self.outf.write(revision_id + '\n')
 
667
    @display_command
 
668
    def run(self):
 
669
        b = Branch.open_containing('.')[0]
 
670
        for revision_id in b.get_ancestry(b.last_revision()):
 
671
            print revision_id
 
672
 
 
673
 
 
674
class cmd_directories(Command):
 
675
    """Display list of versioned directories in this branch."""
 
676
    @display_command
 
677
    def run(self):
 
678
        for name, ie in (Branch.open_containing('.')[0].working_tree().
 
679
                         read_working_inventory().directories()):
 
680
            if name == '':
 
681
                print '.'
 
682
            else:
 
683
                print name
1230
684
 
1231
685
 
1232
686
class cmd_init(Command):
1235
689
    Use this to create an empty branch, or before importing an
1236
690
    existing project.
1237
691
 
1238
 
    If there is a repository in a parent directory of the location, then 
1239
 
    the history of the branch will be stored in the repository.  Otherwise
1240
 
    init creates a standalone branch which carries its own history
1241
 
    in the .bzr directory.
1242
 
 
1243
 
    If there is already a branch at the location but it has no working tree,
1244
 
    the tree can be populated with 'bzr checkout'.
1245
 
 
1246
692
    Recipe for importing a tree of files:
1247
693
        cd ~/project
1248
694
        bzr init
1250
696
        bzr status
1251
697
        bzr commit -m 'imported project'
1252
698
    """
1253
 
 
1254
 
    _see_also = ['init-repo', 'branch', 'checkout']
1255
699
    takes_args = ['location?']
1256
 
    takes_options = [
1257
 
        Option('create-prefix',
1258
 
               help='Create the path leading up to the branch '
1259
 
                    'if it does not already exist.'),
1260
 
         RegistryOption('format',
1261
 
                help='Specify a format for this branch. '
1262
 
                'See "help formats".',
1263
 
                registry=bzrdir.format_registry,
1264
 
                converter=bzrdir.format_registry.make_bzrdir,
1265
 
                value_switches=True,
1266
 
                title="Branch Format",
1267
 
                ),
1268
 
         Option('append-revisions-only',
1269
 
                help='Never change revnos or the existing log.'
1270
 
                '  Append revisions to it only.')
1271
 
         ]
1272
 
    def run(self, location=None, format=None, append_revisions_only=False,
1273
 
            create_prefix=False):
1274
 
        if format is None:
1275
 
            format = bzrdir.format_registry.make_bzrdir('default')
1276
 
        if location is None:
1277
 
            location = u'.'
1278
 
 
1279
 
        to_transport = transport.get_transport(location)
1280
 
 
1281
 
        # The path has to exist to initialize a
1282
 
        # branch inside of it.
1283
 
        # Just using os.mkdir, since I don't
1284
 
        # believe that we want to create a bunch of
1285
 
        # locations if the user supplies an extended path
1286
 
        try:
1287
 
            to_transport.ensure_base()
1288
 
        except errors.NoSuchFile:
1289
 
            if not create_prefix:
1290
 
                raise errors.BzrCommandError("Parent directory of %s"
1291
 
                    " does not exist."
1292
 
                    "\nYou may supply --create-prefix to create all"
1293
 
                    " leading parent directories."
1294
 
                    % location)
1295
 
            _create_prefix(to_transport)
1296
 
 
1297
 
        try:
1298
 
            existing_bzrdir = bzrdir.BzrDir.open(location)
1299
 
        except errors.NotBranchError:
1300
 
            # really a NotBzrDir error...
1301
 
            branch = bzrdir.BzrDir.create_branch_convenience(to_transport.base,
1302
 
                                                             format=format)
1303
 
        else:
1304
 
            from bzrlib.transport.local import LocalTransport
1305
 
            if existing_bzrdir.has_branch():
1306
 
                if (isinstance(to_transport, LocalTransport)
1307
 
                    and not existing_bzrdir.has_workingtree()):
1308
 
                        raise errors.BranchExistsWithoutWorkingTree(location)
1309
 
                raise errors.AlreadyBranchError(location)
1310
 
            else:
1311
 
                branch = existing_bzrdir.create_branch()
1312
 
                existing_bzrdir.create_workingtree()
1313
 
        if append_revisions_only:
1314
 
            try:
1315
 
                branch.set_append_revisions_only(True)
1316
 
            except errors.UpgradeRequired:
1317
 
                raise errors.BzrCommandError('This branch format cannot be set'
1318
 
                    ' to append-revisions-only.  Try --experimental-branch6')
1319
 
 
1320
 
 
1321
 
class cmd_init_repository(Command):
1322
 
    """Create a shared repository to hold branches.
1323
 
 
1324
 
    New branches created under the repository directory will store their
1325
 
    revisions in the repository, not in the branch directory.
1326
 
 
1327
 
    If the --no-trees option is used then the branches in the repository
1328
 
    will not have working trees by default.
1329
 
 
1330
 
    example:
1331
 
        bzr init-repo --no-trees repo
1332
 
        bzr init repo/trunk
1333
 
        bzr checkout --lightweight repo/trunk trunk-checkout
1334
 
        cd trunk-checkout
1335
 
        (add files here)
1336
 
 
1337
 
    See 'bzr help repositories' for more information.
1338
 
    """
1339
 
 
1340
 
    _see_also = ['init', 'branch', 'checkout']
1341
 
    takes_args = ["location"]
1342
 
    takes_options = [RegistryOption('format',
1343
 
                            help='Specify a format for this repository. See'
1344
 
                                 ' "bzr help formats" for details.',
1345
 
                            registry=bzrdir.format_registry,
1346
 
                            converter=bzrdir.format_registry.make_bzrdir,
1347
 
                            value_switches=True, title='Repository format'),
1348
 
                     Option('no-trees',
1349
 
                             help='Branches in the repository will default to'
1350
 
                                  ' not having a working tree.'),
1351
 
                    ]
1352
 
    aliases = ["init-repo"]
1353
 
 
1354
 
    def run(self, location, format=None, no_trees=False):
1355
 
        if format is None:
1356
 
            format = bzrdir.format_registry.make_bzrdir('default')
1357
 
 
 
700
    def run(self, location=None):
 
701
        from bzrlib.branch import Branch
1358
702
        if location is None:
1359
703
            location = '.'
1360
 
 
1361
 
        to_transport = transport.get_transport(location)
1362
 
        to_transport.ensure_base()
1363
 
 
1364
 
        newdir = format.initialize_on_transport(to_transport)
1365
 
        repo = newdir.create_repository(shared=True)
1366
 
        repo.set_make_working_trees(not no_trees)
 
704
        else:
 
705
            # The path has to exist to initialize a
 
706
            # branch inside of it.
 
707
            # Just using os.mkdir, since I don't
 
708
            # believe that we want to create a bunch of
 
709
            # locations if the user supplies an extended path
 
710
            if not os.path.exists(location):
 
711
                os.mkdir(location)
 
712
        Branch.initialize(location)
1367
713
 
1368
714
 
1369
715
class cmd_diff(Command):
1370
 
    """Show differences in the working tree or between revisions.
 
716
    """Show differences in working tree.
1371
717
    
1372
718
    If files are listed, only the changes in those files are listed.
1373
719
    Otherwise, all changes for the tree are listed.
1374
720
 
1375
 
    "bzr diff -p1" is equivalent to "bzr diff --prefix old/:new/", and
1376
 
    produces patches suitable for "patch -p1".
1377
 
 
1378
721
    examples:
1379
722
        bzr diff
1380
 
            Shows the difference in the working tree versus the last commit
1381
723
        bzr diff -r1
1382
 
            Difference between the working tree and revision 1
1383
724
        bzr diff -r1..2
1384
 
            Difference between revision 2 and revision 1
1385
 
        bzr diff --prefix old/:new/
1386
 
            Same as 'bzr diff' but prefix paths with old/ and new/
1387
 
        bzr diff bzr.mine bzr.dev
1388
 
            Show the differences between the two working trees
1389
 
        bzr diff foo.c
1390
 
            Show just the differences for 'foo.c'
1391
725
    """
 
726
    # TODO: Allow diff across branches.
1392
727
    # TODO: Option to use external diff command; could be GNU diff, wdiff,
1393
728
    #       or a graphical diff.
1394
729
 
1395
730
    # TODO: Python difflib is not exactly the same as unidiff; should
1396
731
    #       either fix it up or prefer to use an external diff.
1397
732
 
 
733
    # TODO: If a directory is given, diff everything under that.
 
734
 
1398
735
    # TODO: Selected-file diff is inefficient and doesn't show you
1399
736
    #       deleted files.
1400
737
 
1401
738
    # TODO: This probably handles non-Unix newlines poorly.
1402
 
 
1403
 
    _see_also = ['status']
 
739
    
1404
740
    takes_args = ['file*']
1405
 
    takes_options = [
1406
 
        Option('diff-options', type=str,
1407
 
               help='Pass these options to the external diff program.'),
1408
 
        Option('prefix', type=str,
1409
 
               short_name='p',
1410
 
               help='Set prefixes to added to old and new filenames, as '
1411
 
                    'two values separated by a colon. (eg "old/:new/").'),
1412
 
        'revision',
1413
 
        ]
 
741
    takes_options = ['revision', 'diff-options']
1414
742
    aliases = ['di', 'dif']
1415
 
    encoding_type = 'exact'
1416
743
 
1417
744
    @display_command
1418
 
    def run(self, revision=None, file_list=None, diff_options=None,
1419
 
            prefix=None):
1420
 
        from bzrlib.diff import diff_cmd_helper, show_diff_trees
1421
 
 
1422
 
        if (prefix is None) or (prefix == '0'):
1423
 
            # diff -p0 format
1424
 
            old_label = ''
1425
 
            new_label = ''
1426
 
        elif prefix == '1':
1427
 
            old_label = 'old/'
1428
 
            new_label = 'new/'
1429
 
        elif ':' in prefix:
1430
 
            old_label, new_label = prefix.split(":")
1431
 
        else:
1432
 
            raise errors.BzrCommandError(
1433
 
                '--prefix expects two values separated by a colon'
1434
 
                ' (eg "old/:new/")')
1435
 
 
1436
 
        if revision and len(revision) > 2:
1437
 
            raise errors.BzrCommandError('bzr diff --revision takes exactly'
1438
 
                                         ' one or two revision specifiers')
1439
 
 
 
745
    def run(self, revision=None, file_list=None, diff_options=None):
 
746
        from bzrlib.diff import show_diff
1440
747
        try:
1441
 
            tree1, file_list = internal_tree_files(file_list)
1442
 
            tree2 = None
1443
 
            b = None
 
748
            b, file_list = inner_branch_files(file_list)
1444
749
            b2 = None
1445
 
        except errors.FileInWrongBranch:
 
750
        except FileInWrongBranch:
1446
751
            if len(file_list) != 2:
1447
 
                raise errors.BzrCommandError("Files are in different branches")
 
752
                raise BzrCommandError("Files are in different branches")
1448
753
 
1449
 
            tree1, file1 = WorkingTree.open_containing(file_list[0])
1450
 
            tree2, file2 = WorkingTree.open_containing(file_list[1])
 
754
            b, file1 = Branch.open_containing(file_list[0])
 
755
            b2, file2 = Branch.open_containing(file_list[1])
1451
756
            if file1 != "" or file2 != "":
1452
 
                # FIXME diff those two files. rbc 20051123
1453
 
                raise errors.BzrCommandError("Files are in different branches")
 
757
                raise BzrCommandError("Files are in different branches")
1454
758
            file_list = None
1455
 
        except errors.NotBranchError:
1456
 
            if (revision is not None and len(revision) == 2
1457
 
                and not revision[0].needs_branch()
1458
 
                and not revision[1].needs_branch()):
1459
 
                # If both revision specs include a branch, we can
1460
 
                # diff them without needing a local working tree
1461
 
                tree1, tree2 = None, None
 
759
        if revision is not None:
 
760
            if b2 is not None:
 
761
                raise BzrCommandError("Can't specify -r with two branches")
 
762
            if len(revision) == 1:
 
763
                return show_diff(b, revision[0], specific_files=file_list,
 
764
                                 external_diff_options=diff_options)
 
765
            elif len(revision) == 2:
 
766
                return show_diff(b, revision[0], specific_files=file_list,
 
767
                                 external_diff_options=diff_options,
 
768
                                 revision2=revision[1])
1462
769
            else:
1463
 
                raise
1464
 
 
1465
 
        if tree2 is not None:
1466
 
            if revision is not None:
1467
 
                # FIXME: but there should be a clean way to diff between
1468
 
                # non-default versions of two trees, it's not hard to do
1469
 
                # internally...
1470
 
                raise errors.BzrCommandError(
1471
 
                        "Sorry, diffing arbitrary revisions across branches "
1472
 
                        "is not implemented yet")
1473
 
            return show_diff_trees(tree1, tree2, sys.stdout, 
1474
 
                                   specific_files=file_list,
1475
 
                                   external_diff_options=diff_options,
1476
 
                                   old_label=old_label, new_label=new_label)
1477
 
 
1478
 
        return diff_cmd_helper(tree1, file_list, diff_options,
1479
 
                               revision_specs=revision,
1480
 
                               old_label=old_label, new_label=new_label)
 
770
                raise BzrCommandError('bzr diff --revision takes exactly one or two revision identifiers')
 
771
        else:
 
772
            return show_diff(b, None, specific_files=file_list,
 
773
                             external_diff_options=diff_options, b2=b2)
1481
774
 
1482
775
 
1483
776
class cmd_deleted(Command):
1489
782
    # directories with readdir, rather than stating each one.  Same
1490
783
    # level of effort but possibly much less IO.  (Or possibly not,
1491
784
    # if the directories are very large...)
1492
 
    _see_also = ['status', 'ls']
1493
 
    takes_options = ['show-ids']
1494
 
 
1495
785
    @display_command
1496
786
    def run(self, show_ids=False):
1497
 
        tree = WorkingTree.open_containing(u'.')[0]
1498
 
        tree.lock_read()
1499
 
        try:
1500
 
            old = tree.basis_tree()
1501
 
            old.lock_read()
1502
 
            try:
1503
 
                for path, ie in old.inventory.iter_entries():
1504
 
                    if not tree.has_id(ie.file_id):
1505
 
                        self.outf.write(path)
1506
 
                        if show_ids:
1507
 
                            self.outf.write(' ')
1508
 
                            self.outf.write(ie.file_id)
1509
 
                        self.outf.write('\n')
1510
 
            finally:
1511
 
                old.unlock()
1512
 
        finally:
1513
 
            tree.unlock()
 
787
        b = Branch.open_containing('.')[0]
 
788
        old = b.basis_tree()
 
789
        new = b.working_tree()
 
790
        for path, ie in old.inventory.iter_entries():
 
791
            if not new.has_id(ie.file_id):
 
792
                if show_ids:
 
793
                    print '%-50s %s' % (path, ie.file_id)
 
794
                else:
 
795
                    print path
1514
796
 
1515
797
 
1516
798
class cmd_modified(Command):
1517
 
    """List files modified in working tree.
1518
 
    """
1519
 
 
 
799
    """List files modified in working tree."""
1520
800
    hidden = True
1521
 
    _see_also = ['status', 'ls']
1522
 
 
1523
801
    @display_command
1524
802
    def run(self):
1525
 
        tree = WorkingTree.open_containing(u'.')[0]
1526
 
        td = tree.changes_from(tree.basis_tree())
 
803
        from bzrlib.delta import compare_trees
 
804
 
 
805
        b = Branch.open_containing('.')[0]
 
806
        td = compare_trees(b.basis_tree(), b.working_tree())
 
807
 
1527
808
        for path, id, kind, text_modified, meta_modified in td.modified:
1528
 
            self.outf.write(path + '\n')
 
809
            print path
 
810
 
1529
811
 
1530
812
 
1531
813
class cmd_added(Command):
1532
 
    """List files added in working tree.
1533
 
    """
1534
 
 
 
814
    """List files added in working tree."""
1535
815
    hidden = True
1536
 
    _see_also = ['status', 'ls']
1537
 
 
1538
816
    @display_command
1539
817
    def run(self):
1540
 
        wt = WorkingTree.open_containing(u'.')[0]
1541
 
        wt.lock_read()
1542
 
        try:
1543
 
            basis = wt.basis_tree()
1544
 
            basis.lock_read()
1545
 
            try:
1546
 
                basis_inv = basis.inventory
1547
 
                inv = wt.inventory
1548
 
                for file_id in inv:
1549
 
                    if file_id in basis_inv:
1550
 
                        continue
1551
 
                    if inv.is_root(file_id) and len(basis_inv) == 0:
1552
 
                        continue
1553
 
                    path = inv.id2path(file_id)
1554
 
                    if not os.access(osutils.abspath(path), os.F_OK):
1555
 
                        continue
1556
 
                    self.outf.write(path + '\n')
1557
 
            finally:
1558
 
                basis.unlock()
1559
 
        finally:
1560
 
            wt.unlock()
1561
 
 
 
818
        b = Branch.open_containing('.')[0]
 
819
        wt = b.working_tree()
 
820
        basis_inv = b.basis_tree().inventory
 
821
        inv = wt.inventory
 
822
        for file_id in inv:
 
823
            if file_id in basis_inv:
 
824
                continue
 
825
            path = inv.id2path(file_id)
 
826
            if not os.access(b.abspath(path), os.F_OK):
 
827
                continue
 
828
            print path
 
829
                
 
830
        
1562
831
 
1563
832
class cmd_root(Command):
1564
833
    """Show the tree root directory.
1565
834
 
1566
835
    The root is the nearest enclosing directory with a .bzr control
1567
836
    directory."""
1568
 
 
1569
837
    takes_args = ['filename?']
1570
838
    @display_command
1571
839
    def run(self, filename=None):
1572
840
        """Print the branch root."""
1573
 
        tree = WorkingTree.open_containing(filename)[0]
1574
 
        self.outf.write(tree.basedir + '\n')
1575
 
 
1576
 
 
1577
 
def _parse_limit(limitstring):
1578
 
    try:
1579
 
        return int(limitstring)
1580
 
    except ValueError:
1581
 
        msg = "The limit argument must be an integer."
1582
 
        raise errors.BzrCommandError(msg)
 
841
        b = Branch.open_containing(filename)[0]
 
842
        print b.base
1583
843
 
1584
844
 
1585
845
class cmd_log(Command):
1586
 
    """Show log of a branch, file, or directory.
1587
 
 
1588
 
    By default show the log of the branch containing the working directory.
 
846
    """Show log of this branch.
1589
847
 
1590
848
    To request a range of logs, you can use the command -r begin..end
1591
849
    -r revision requests a specific revision, -r ..end or -r begin.. are
1592
850
    also valid.
1593
 
 
1594
 
    examples:
1595
 
        bzr log
1596
 
        bzr log foo.c
1597
 
        bzr log -r -10.. http://server/branch
1598
851
    """
1599
852
 
1600
853
    # TODO: Make --revision support uuid: and hash: [future tag:] notation.
1601
854
 
1602
 
    takes_args = ['location?']
1603
 
    takes_options = [
1604
 
            Option('forward',
1605
 
                   help='Show from oldest to newest.'),
1606
 
            Option('timezone',
1607
 
                   type=str,
1608
 
                   help='Display timezone as local, original, or utc.'),
1609
 
            Option('verbose',
1610
 
                   short_name='v',
1611
 
                   help='Show files changed in each revision.'),
1612
 
            'show-ids',
1613
 
            'revision',
1614
 
            'log-format',
1615
 
            Option('message',
1616
 
                   short_name='m',
1617
 
                   help='Show revisions whose message matches this '
1618
 
                        'regular expression.',
1619
 
                   type=str),
1620
 
            Option('limit',
1621
 
                   help='Limit the output to the first N revisions.',
1622
 
                   argname='N',
1623
 
                   type=_parse_limit),
1624
 
            ]
1625
 
    encoding_type = 'replace'
1626
 
 
 
855
    takes_args = ['filename?']
 
856
    takes_options = [Option('forward', 
 
857
                            help='show from oldest to newest'),
 
858
                     'timezone', 'verbose', 
 
859
                     'show-ids', 'revision',
 
860
                     Option('line', help='format with one line per revision'),
 
861
                     'long', 
 
862
                     Option('message',
 
863
                            help='show revisions whose message matches this regexp',
 
864
                            type=str),
 
865
                     Option('short', help='use moderately short format'),
 
866
                     ]
1627
867
    @display_command
1628
 
    def run(self, location=None, timezone='original',
 
868
    def run(self, filename=None, timezone='original',
1629
869
            verbose=False,
1630
870
            show_ids=False,
1631
871
            forward=False,
1632
872
            revision=None,
1633
 
            log_format=None,
1634
873
            message=None,
1635
 
            limit=None):
1636
 
        from bzrlib.log import show_log
 
874
            long=False,
 
875
            short=False,
 
876
            line=False):
 
877
        from bzrlib.log import log_formatter, show_log
 
878
        import codecs
1637
879
        assert message is None or isinstance(message, basestring), \
1638
880
            "invalid message argument %r" % message
1639
881
        direction = (forward and 'forward') or 'reverse'
1640
882
        
1641
 
        # log everything
1642
 
        file_id = None
1643
 
        if location:
1644
 
            # find the file id to log:
1645
 
 
1646
 
            tree, b, fp = bzrdir.BzrDir.open_containing_tree_or_branch(
1647
 
                location)
 
883
        if filename:
 
884
            b, fp = Branch.open_containing(filename)
1648
885
            if fp != '':
1649
 
                if tree is None:
1650
 
                    tree = b.basis_tree()
1651
 
                file_id = tree.path2id(fp)
1652
 
                if file_id is None:
1653
 
                    raise errors.BzrCommandError(
1654
 
                        "Path does not have any revision history: %s" %
1655
 
                        location)
1656
 
        else:
1657
 
            # local dir only
1658
 
            # FIXME ? log the current subdir only RBC 20060203 
1659
 
            if revision is not None \
1660
 
                    and len(revision) > 0 and revision[0].get_branch():
1661
 
                location = revision[0].get_branch()
1662
 
            else:
1663
 
                location = '.'
1664
 
            dir, relpath = bzrdir.BzrDir.open_containing(location)
1665
 
            b = dir.open_branch()
1666
 
 
1667
 
        b.lock_read()
1668
 
        try:
1669
 
            if revision is None:
1670
 
                rev1 = None
1671
 
                rev2 = None
1672
 
            elif len(revision) == 1:
1673
 
                rev1 = rev2 = revision[0].in_history(b)
1674
 
            elif len(revision) == 2:
1675
 
                if revision[1].get_branch() != revision[0].get_branch():
1676
 
                    # b is taken from revision[0].get_branch(), and
1677
 
                    # show_log will use its revision_history. Having
1678
 
                    # different branches will lead to weird behaviors.
1679
 
                    raise errors.BzrCommandError(
1680
 
                        "Log doesn't accept two revisions in different"
1681
 
                        " branches.")
1682
 
                rev1 = revision[0].in_history(b)
1683
 
                rev2 = revision[1].in_history(b)
1684
 
            else:
1685
 
                raise errors.BzrCommandError(
1686
 
                    'bzr log --revision takes one or two values.')
1687
 
 
1688
 
            if log_format is None:
1689
 
                log_format = log.log_formatter_registry.get_default(b)
1690
 
 
1691
 
            lf = log_format(show_ids=show_ids, to_file=self.outf,
1692
 
                            show_timezone=timezone)
1693
 
 
1694
 
            show_log(b,
1695
 
                     lf,
1696
 
                     file_id,
1697
 
                     verbose=verbose,
1698
 
                     direction=direction,
1699
 
                     start_revision=rev1,
1700
 
                     end_revision=rev2,
1701
 
                     search=message,
1702
 
                     limit=limit)
1703
 
        finally:
1704
 
            b.unlock()
1705
 
 
1706
 
 
1707
 
def get_log_format(long=False, short=False, line=False, default='long'):
1708
 
    log_format = default
1709
 
    if long:
 
886
                try:
 
887
                    inv = b.working_tree().read_working_inventory()
 
888
                except NoWorkingTree:
 
889
                    inv = b.get_inventory(b.last_revision())
 
890
                file_id = inv.path2id(fp)
 
891
            else:
 
892
                file_id = None  # points to branch root
 
893
        else:
 
894
            b, relpath = Branch.open_containing('.')
 
895
            file_id = None
 
896
 
 
897
        if revision is None:
 
898
            rev1 = None
 
899
            rev2 = None
 
900
        elif len(revision) == 1:
 
901
            rev1 = rev2 = revision[0].in_history(b).revno
 
902
        elif len(revision) == 2:
 
903
            rev1 = revision[0].in_history(b).revno
 
904
            rev2 = revision[1].in_history(b).revno
 
905
        else:
 
906
            raise BzrCommandError('bzr log --revision takes one or two values.')
 
907
 
 
908
        # By this point, the revision numbers are converted to the +ve
 
909
        # form if they were supplied in the -ve form, so we can do
 
910
        # this comparison in relative safety
 
911
        if rev1 > rev2:
 
912
            (rev2, rev1) = (rev1, rev2)
 
913
 
 
914
        mutter('encoding log as %r', bzrlib.user_encoding)
 
915
 
 
916
        # use 'replace' so that we don't abort if trying to write out
 
917
        # in e.g. the default C locale.
 
918
        outf = codecs.getwriter(bzrlib.user_encoding)(sys.stdout, errors='replace')
 
919
 
1710
920
        log_format = 'long'
1711
 
    if short:
1712
 
        log_format = 'short'
1713
 
    if line:
1714
 
        log_format = 'line'
1715
 
    return log_format
 
921
        if short:
 
922
            log_format = 'short'
 
923
        if line:
 
924
            log_format = 'line'
 
925
        lf = log_formatter(log_format,
 
926
                           show_ids=show_ids,
 
927
                           to_file=outf,
 
928
                           show_timezone=timezone)
 
929
 
 
930
        show_log(b,
 
931
                 lf,
 
932
                 file_id,
 
933
                 verbose=verbose,
 
934
                 direction=direction,
 
935
                 start_revision=rev1,
 
936
                 end_revision=rev2,
 
937
                 search=message)
 
938
 
1716
939
 
1717
940
 
1718
941
class cmd_touching_revisions(Command):
1719
942
    """Return revision-ids which affected a particular file.
1720
943
 
1721
 
    A more user-friendly interface is "bzr log FILE".
1722
 
    """
1723
 
 
 
944
    A more user-friendly interface is "bzr log FILE"."""
1724
945
    hidden = True
1725
946
    takes_args = ["filename"]
1726
 
 
1727
947
    @display_command
1728
948
    def run(self, filename):
1729
 
        tree, relpath = WorkingTree.open_containing(filename)
1730
 
        b = tree.branch
1731
 
        file_id = tree.path2id(relpath)
1732
 
        for revno, revision_id, what in log.find_touching_revisions(b, file_id):
1733
 
            self.outf.write("%6d %s\n" % (revno, what))
 
949
        b, relpath = Branch.open_containing(filename)[0]
 
950
        inv = b.working_tree().read_working_inventory()
 
951
        file_id = inv.path2id(relpath)
 
952
        for revno, revision_id, what in bzrlib.log.find_touching_revisions(b, file_id):
 
953
            print "%6d %s" % (revno, what)
1734
954
 
1735
955
 
1736
956
class cmd_ls(Command):
1737
957
    """List files in a tree.
1738
958
    """
1739
 
 
1740
 
    _see_also = ['status', 'cat']
1741
 
    takes_args = ['path?']
1742
959
    # TODO: Take a revision or remote path and list that tree instead.
1743
 
    takes_options = [
1744
 
            'verbose',
1745
 
            'revision',
1746
 
            Option('non-recursive',
1747
 
                   help='Don\'t recurse into subdirectories.'),
1748
 
            Option('from-root',
1749
 
                   help='Print paths relative to the root of the branch.'),
1750
 
            Option('unknown', help='Print unknown files.'),
1751
 
            Option('versioned', help='Print versioned files.'),
1752
 
            Option('ignored', help='Print ignored files.'),
1753
 
            Option('null',
1754
 
                   help='Write an ascii NUL (\\0) separator '
1755
 
                   'between files rather than a newline.'),
1756
 
            Option('kind',
1757
 
                   help='List entries of a particular kind: file, directory, symlink.',
1758
 
                   type=unicode),
1759
 
            'show-ids',
1760
 
            ]
 
960
    hidden = True
 
961
    takes_options = ['verbose', 'revision',
 
962
                     Option('non-recursive',
 
963
                            help='don\'t recurse into sub-directories'),
 
964
                     Option('from-root',
 
965
                            help='Print all paths from the root of the branch.'),
 
966
                     Option('unknown', help='Print unknown files'),
 
967
                     Option('versioned', help='Print versioned files'),
 
968
                     Option('ignored', help='Print ignored files'),
 
969
 
 
970
                     Option('null', help='Null separate the files'),
 
971
                    ]
1761
972
    @display_command
1762
 
    def run(self, revision=None, verbose=False,
 
973
    def run(self, revision=None, verbose=False, 
1763
974
            non_recursive=False, from_root=False,
1764
975
            unknown=False, versioned=False, ignored=False,
1765
 
            null=False, kind=None, show_ids=False, path=None):
1766
 
 
1767
 
        if kind and kind not in ('file', 'directory', 'symlink'):
1768
 
            raise errors.BzrCommandError('invalid kind specified')
 
976
            null=False):
1769
977
 
1770
978
        if verbose and null:
1771
 
            raise errors.BzrCommandError('Cannot set both --verbose and --null')
 
979
            raise BzrCommandError('Cannot set both --verbose and --null')
1772
980
        all = not (unknown or versioned or ignored)
1773
981
 
1774
982
        selection = {'I':ignored, '?':unknown, 'V':versioned}
1775
983
 
1776
 
        if path is None:
1777
 
            fs_path = '.'
1778
 
            prefix = ''
1779
 
        else:
1780
 
            if from_root:
1781
 
                raise errors.BzrCommandError('cannot specify both --from-root'
1782
 
                                             ' and PATH')
1783
 
            fs_path = path
1784
 
            prefix = path
1785
 
        tree, branch, relpath = bzrdir.BzrDir.open_containing_tree_or_branch(
1786
 
            fs_path)
 
984
        b, relpath = Branch.open_containing('.')
1787
985
        if from_root:
1788
 
            relpath = u''
 
986
            relpath = ''
1789
987
        elif relpath:
1790
988
            relpath += '/'
1791
 
        if revision is not None:
1792
 
            tree = branch.repository.revision_tree(
1793
 
                revision[0].in_history(branch).rev_id)
1794
 
        elif tree is None:
1795
 
            tree = branch.basis_tree()
 
989
        if revision == None:
 
990
            tree = b.working_tree()
 
991
        else:
 
992
            tree = b.revision_tree(revision[0].in_history(b).rev_id)
 
993
        for fp, fc, kind, fid, entry in tree.list_files():
 
994
            if fp.startswith(relpath):
 
995
                fp = fp[len(relpath):]
 
996
                if non_recursive and '/' in fp:
 
997
                    continue
 
998
                if not all and not selection[fc]:
 
999
                    continue
 
1000
                if verbose:
 
1001
                    kindch = entry.kind_character()
 
1002
                    print '%-8s %s%s' % (fc, fp, kindch)
 
1003
                elif null:
 
1004
                    sys.stdout.write(fp)
 
1005
                    sys.stdout.write('\0')
 
1006
                    sys.stdout.flush()
 
1007
                else:
 
1008
                    print fp
1796
1009
 
1797
 
        tree.lock_read()
1798
 
        try:
1799
 
            for fp, fc, fkind, fid, entry in tree.list_files(include_root=False):
1800
 
                if fp.startswith(relpath):
1801
 
                    fp = osutils.pathjoin(prefix, fp[len(relpath):])
1802
 
                    if non_recursive and '/' in fp:
1803
 
                        continue
1804
 
                    if not all and not selection[fc]:
1805
 
                        continue
1806
 
                    if kind is not None and fkind != kind:
1807
 
                        continue
1808
 
                    if verbose:
1809
 
                        kindch = entry.kind_character()
1810
 
                        outstring = '%-8s %s%s' % (fc, fp, kindch)
1811
 
                        if show_ids and fid is not None:
1812
 
                            outstring = "%-50s %s" % (outstring, fid)
1813
 
                        self.outf.write(outstring + '\n')
1814
 
                    elif null:
1815
 
                        self.outf.write(fp + '\0')
1816
 
                        if show_ids:
1817
 
                            if fid is not None:
1818
 
                                self.outf.write(fid)
1819
 
                            self.outf.write('\0')
1820
 
                        self.outf.flush()
1821
 
                    else:
1822
 
                        if fid is not None:
1823
 
                            my_id = fid
1824
 
                        else:
1825
 
                            my_id = ''
1826
 
                        if show_ids:
1827
 
                            self.outf.write('%-50s %s\n' % (fp, my_id))
1828
 
                        else:
1829
 
                            self.outf.write(fp + '\n')
1830
 
        finally:
1831
 
            tree.unlock()
1832
1010
 
1833
1011
 
1834
1012
class cmd_unknowns(Command):
1835
 
    """List unknown files.
1836
 
    """
1837
 
 
1838
 
    hidden = True
1839
 
    _see_also = ['ls']
1840
 
 
 
1013
    """List unknown files."""
1841
1014
    @display_command
1842
1015
    def run(self):
1843
 
        for f in WorkingTree.open_containing(u'.')[0].unknowns():
1844
 
            self.outf.write(osutils.quotefn(f) + '\n')
 
1016
        from bzrlib.osutils import quotefn
 
1017
        for f in Branch.open_containing('.')[0].unknowns():
 
1018
            print quotefn(f)
 
1019
 
1845
1020
 
1846
1021
 
1847
1022
class cmd_ignore(Command):
1848
 
    """Ignore specified files or patterns.
 
1023
    """Ignore a command or pattern.
1849
1024
 
1850
1025
    To remove patterns from the ignore list, edit the .bzrignore file.
1851
1026
 
1852
 
    Trailing slashes on patterns are ignored. 
1853
 
    If the pattern contains a slash or is a regular expression, it is compared 
1854
 
    to the whole path from the branch root.  Otherwise, it is compared to only
1855
 
    the last component of the path.  To match a file only in the root 
1856
 
    directory, prepend './'.
1857
 
 
1858
 
    Ignore patterns specifying absolute paths are not allowed.
1859
 
 
1860
 
    Ignore patterns may include globbing wildcards such as:
1861
 
      ? - Matches any single character except '/'
1862
 
      * - Matches 0 or more characters except '/'
1863
 
      /**/ - Matches 0 or more directories in a path
1864
 
      [a-z] - Matches a single character from within a group of characters
1865
 
 
1866
 
    Ignore patterns may also be Python regular expressions.  
1867
 
    Regular expression ignore patterns are identified by a 'RE:' prefix 
1868
 
    followed by the regular expression.  Regular expression ignore patterns
1869
 
    may not include named or numbered groups.
1870
 
 
1871
 
    Note: ignore patterns containing shell wildcards must be quoted from 
1872
 
    the shell on Unix.
 
1027
    If the pattern contains a slash, it is compared to the whole path
 
1028
    from the branch root.  Otherwise, it is compared to only the last
 
1029
    component of the path.  To match a file only in the root directory,
 
1030
    prepend './'.
 
1031
 
 
1032
    Ignore patterns are case-insensitive on case-insensitive systems.
 
1033
 
 
1034
    Note: wildcards must be quoted from the shell on Unix.
1873
1035
 
1874
1036
    examples:
1875
1037
        bzr ignore ./Makefile
1876
1038
        bzr ignore '*.class'
1877
 
        bzr ignore 'lib/**/*.o'
1878
 
        bzr ignore 'RE:lib/.*\.o'
1879
1039
    """
1880
 
 
1881
 
    _see_also = ['status', 'ignored']
1882
 
    takes_args = ['name_pattern*']
1883
 
    takes_options = [
1884
 
        Option('old-default-rules',
1885
 
               help='Write out the ignore rules bzr < 0.9 always used.')
1886
 
        ]
 
1040
    # TODO: Complain if the filename is absolute
 
1041
    takes_args = ['name_pattern']
1887
1042
    
1888
 
    def run(self, name_pattern_list=None, old_default_rules=None):
 
1043
    def run(self, name_pattern):
1889
1044
        from bzrlib.atomicfile import AtomicFile
1890
 
        if old_default_rules is not None:
1891
 
            # dump the rules and exit
1892
 
            for pattern in ignores.OLD_DEFAULTS:
1893
 
                print pattern
1894
 
            return
1895
 
        if not name_pattern_list:
1896
 
            raise errors.BzrCommandError("ignore requires at least one "
1897
 
                                  "NAME_PATTERN or --old-default-rules")
1898
 
        name_pattern_list = [globbing.normalize_pattern(p) 
1899
 
                             for p in name_pattern_list]
1900
 
        for name_pattern in name_pattern_list:
1901
 
            if (name_pattern[0] == '/' or 
1902
 
                (len(name_pattern) > 1 and name_pattern[1] == ':')):
1903
 
                raise errors.BzrCommandError(
1904
 
                    "NAME_PATTERN should not be an absolute path")
1905
 
        tree, relpath = WorkingTree.open_containing(u'.')
1906
 
        ifn = tree.abspath('.bzrignore')
 
1045
        import os.path
 
1046
 
 
1047
        b, relpath = Branch.open_containing('.')
 
1048
        ifn = b.abspath('.bzrignore')
 
1049
 
1907
1050
        if os.path.exists(ifn):
1908
1051
            f = open(ifn, 'rt')
1909
1052
            try:
1918
1061
 
1919
1062
        if igns and igns[-1] != '\n':
1920
1063
            igns += '\n'
1921
 
        for name_pattern in name_pattern_list:
1922
 
            igns += name_pattern + '\n'
 
1064
        igns += name_pattern + '\n'
1923
1065
 
1924
 
        f = AtomicFile(ifn, 'wb')
1925
1066
        try:
 
1067
            f = AtomicFile(ifn, 'wt')
1926
1068
            f.write(igns.encode('utf-8'))
1927
1069
            f.commit()
1928
1070
        finally:
1929
1071
            f.close()
1930
1072
 
1931
 
        if not tree.path2id('.bzrignore'):
1932
 
            tree.add(['.bzrignore'])
 
1073
        inv = b.working_tree().inventory
 
1074
        if inv.path2id('.bzrignore'):
 
1075
            mutter('.bzrignore is already versioned')
 
1076
        else:
 
1077
            mutter('need to make new .bzrignore file versioned')
 
1078
            b.add(['.bzrignore'])
 
1079
 
1933
1080
 
1934
1081
 
1935
1082
class cmd_ignored(Command):
1936
1083
    """List ignored files and the patterns that matched them.
1937
 
    """
1938
1084
 
1939
 
    _see_also = ['ignore']
 
1085
    See also: bzr ignore"""
1940
1086
    @display_command
1941
1087
    def run(self):
1942
 
        tree = WorkingTree.open_containing(u'.')[0]
1943
 
        tree.lock_read()
1944
 
        try:
1945
 
            for path, file_class, kind, file_id, entry in tree.list_files():
1946
 
                if file_class != 'I':
1947
 
                    continue
1948
 
                ## XXX: Slightly inefficient since this was already calculated
1949
 
                pat = tree.is_ignored(path)
1950
 
                print '%-50s %s' % (path, pat)
1951
 
        finally:
1952
 
            tree.unlock()
 
1088
        tree = Branch.open_containing('.')[0].working_tree()
 
1089
        for path, file_class, kind, file_id, entry in tree.list_files():
 
1090
            if file_class != 'I':
 
1091
                continue
 
1092
            ## XXX: Slightly inefficient since this was already calculated
 
1093
            pat = tree.is_ignored(path)
 
1094
            print '%-50s %s' % (path, pat)
1953
1095
 
1954
1096
 
1955
1097
class cmd_lookup_revision(Command):
1966
1108
        try:
1967
1109
            revno = int(revno)
1968
1110
        except ValueError:
1969
 
            raise errors.BzrCommandError("not a valid revision-number: %r" % revno)
 
1111
            raise BzrCommandError("not a valid revision-number: %r" % revno)
1970
1112
 
1971
 
        print WorkingTree.open_containing(u'.')[0].branch.get_rev_id(revno)
 
1113
        print Branch.open_containing('.')[0].get_rev_id(revno)
1972
1114
 
1973
1115
 
1974
1116
class cmd_export(Command):
1975
 
    """Export current or past revision to a destination directory or archive.
 
1117
    """Export past revision to destination directory.
1976
1118
 
1977
1119
    If no revision is specified this exports the last committed revision.
1978
1120
 
1980
1122
    given, try to find the format with the extension. If no extension
1981
1123
    is found exports to a directory (equivalent to --format=dir).
1982
1124
 
1983
 
    If root is supplied, it will be used as the root directory inside
1984
 
    container formats (tar, zip, etc). If it is not supplied it will default
1985
 
    to the exported filename. The root option has no effect for 'dir' format.
1986
 
 
1987
 
    If branch is omitted then the branch containing the current working
1988
 
    directory will be used.
1989
 
 
1990
 
    Note: Export of tree with non-ASCII filenames to zip is not supported.
1991
 
 
1992
 
     Supported formats       Autodetected by extension
1993
 
     -----------------       -------------------------
1994
 
         dir                            -
1995
 
         tar                          .tar
1996
 
         tbz2                    .tar.bz2, .tbz2
1997
 
         tgz                      .tar.gz, .tgz
1998
 
         zip                          .zip
1999
 
    """
2000
 
    takes_args = ['dest', 'branch?']
2001
 
    takes_options = [
2002
 
        Option('format',
2003
 
               help="Type of file to export to.",
2004
 
               type=unicode),
2005
 
        'revision',
2006
 
        Option('root',
2007
 
               type=str,
2008
 
               help="Name of the root directory inside the exported file."),
2009
 
        ]
2010
 
    def run(self, dest, branch=None, revision=None, format=None, root=None):
2011
 
        from bzrlib.export import export
2012
 
 
2013
 
        if branch is None:
2014
 
            tree = WorkingTree.open_containing(u'.')[0]
2015
 
            b = tree.branch
2016
 
        else:
2017
 
            b = Branch.open(branch)
2018
 
            
 
1125
    Root may be the top directory for tar, tgz and tbz2 formats. If none
 
1126
    is given, the top directory will be the root name of the file."""
 
1127
    # TODO: list known exporters
 
1128
    takes_args = ['dest']
 
1129
    takes_options = ['revision', 'format', 'root']
 
1130
    def run(self, dest, revision=None, format=None, root=None):
 
1131
        import os.path
 
1132
        b = Branch.open_containing('.')[0]
2019
1133
        if revision is None:
2020
 
            # should be tree.last_revision  FIXME
2021
1134
            rev_id = b.last_revision()
2022
1135
        else:
2023
1136
            if len(revision) != 1:
2024
 
                raise errors.BzrCommandError('bzr export --revision takes exactly 1 argument')
 
1137
                raise BzrError('bzr export --revision takes exactly 1 argument')
2025
1138
            rev_id = revision[0].in_history(b).rev_id
2026
 
        t = b.repository.revision_tree(rev_id)
2027
 
        try:
2028
 
            export(t, dest, format, root)
2029
 
        except errors.NoSuchExportFormat, e:
2030
 
            raise errors.BzrCommandError('Unsupported export format: %s' % e.format)
 
1139
        t = b.revision_tree(rev_id)
 
1140
        arg_root, ext = os.path.splitext(os.path.basename(dest))
 
1141
        if ext in ('.gz', '.bz2'):
 
1142
            new_root, new_ext = os.path.splitext(arg_root)
 
1143
            if new_ext == '.tar':
 
1144
                arg_root = new_root
 
1145
                ext = new_ext + ext
 
1146
        if root is None:
 
1147
            root = arg_root
 
1148
        if not format:
 
1149
            if ext in (".tar",):
 
1150
                format = "tar"
 
1151
            elif ext in (".tar.gz", ".tgz"):
 
1152
                format = "tgz"
 
1153
            elif ext in (".tar.bz2", ".tbz2"):
 
1154
                format = "tbz2"
 
1155
            else:
 
1156
                format = "dir"
 
1157
        t.export(dest, format, root)
2031
1158
 
2032
1159
 
2033
1160
class cmd_cat(Command):
2034
 
    """Write the contents of a file as of a given revision to standard output.
2035
 
 
2036
 
    If no revision is nominated, the last revision is used.
2037
 
 
2038
 
    Note: Take care to redirect standard output when using this command on a
2039
 
    binary file. 
2040
 
    """
2041
 
 
2042
 
    _see_also = ['ls']
2043
 
    takes_options = [
2044
 
        Option('name-from-revision', help='The path name in the old tree.'),
2045
 
        'revision',
2046
 
        ]
 
1161
    """Write a file's text from a previous revision."""
 
1162
 
 
1163
    takes_options = ['revision']
2047
1164
    takes_args = ['filename']
2048
 
    encoding_type = 'exact'
2049
1165
 
2050
1166
    @display_command
2051
 
    def run(self, filename, revision=None, name_from_revision=False):
2052
 
        if revision is not None and len(revision) != 1:
2053
 
            raise errors.BzrCommandError("bzr cat --revision takes exactly"
2054
 
                                        " one number")
2055
 
 
2056
 
        tree = None
2057
 
        try:
2058
 
            tree, b, relpath = \
2059
 
                    bzrdir.BzrDir.open_containing_tree_or_branch(filename)
2060
 
        except errors.NotBranchError:
2061
 
            pass
2062
 
 
2063
 
        if revision is not None and revision[0].get_branch() is not None:
2064
 
            b = Branch.open(revision[0].get_branch())
2065
 
        if tree is None:
2066
 
            tree = b.basis_tree()
 
1167
    def run(self, filename, revision=None):
2067
1168
        if revision is None:
2068
 
            revision_id = b.last_revision()
2069
 
        else:
2070
 
            revision_id = revision[0].in_history(b).rev_id
2071
 
 
2072
 
        cur_file_id = tree.path2id(relpath)
2073
 
        rev_tree = b.repository.revision_tree(revision_id)
2074
 
        old_file_id = rev_tree.path2id(relpath)
2075
 
        
2076
 
        if name_from_revision:
2077
 
            if old_file_id is None:
2078
 
                raise errors.BzrCommandError("%r is not present in revision %s"
2079
 
                                                % (filename, revision_id))
2080
 
            else:
2081
 
                rev_tree.print_file(old_file_id)
2082
 
        elif cur_file_id is not None:
2083
 
            rev_tree.print_file(cur_file_id)
2084
 
        elif old_file_id is not None:
2085
 
            rev_tree.print_file(old_file_id)
2086
 
        else:
2087
 
            raise errors.BzrCommandError("%r is not present in revision %s" %
2088
 
                                         (filename, revision_id))
 
1169
            raise BzrCommandError("bzr cat requires a revision number")
 
1170
        elif len(revision) != 1:
 
1171
            raise BzrCommandError("bzr cat --revision takes exactly one number")
 
1172
        b, relpath = Branch.open_containing(filename)
 
1173
        b.print_file(relpath, revision[0].in_history(b).revno)
2089
1174
 
2090
1175
 
2091
1176
class cmd_local_time_offset(Command):
2093
1178
    hidden = True    
2094
1179
    @display_command
2095
1180
    def run(self):
2096
 
        print osutils.local_time_offset()
 
1181
        print bzrlib.osutils.local_time_offset()
2097
1182
 
2098
1183
 
2099
1184
 
2107
1192
    within it is committed.
2108
1193
 
2109
1194
    A selected-file commit may fail in some cases where the committed
2110
 
    tree would be invalid. Consider::
2111
 
 
2112
 
      bzr init foo
2113
 
      mkdir foo/bar
2114
 
      bzr add foo/bar
2115
 
      bzr commit foo -m "committing foo"
2116
 
      bzr mv foo/bar foo/baz
2117
 
      mkdir foo/bar
2118
 
      bzr add foo/bar
2119
 
      bzr commit foo/bar -m "committing bar but not baz"
2120
 
 
2121
 
    In the example above, the last commit will fail by design. This gives
2122
 
    the user the opportunity to decide whether they want to commit the
2123
 
    rename at the same time, separately first, or not at all. (As a general
2124
 
    rule, when in doubt, Bazaar has a policy of Doing the Safe Thing.)
2125
 
 
2126
 
    Note: A selected-file commit after a merge is not yet supported.
 
1195
    tree would be invalid, such as trying to commit a file in a
 
1196
    newly-added directory that is not itself committed.
2127
1197
    """
2128
1198
    # TODO: Run hooks on tree to-be-committed, and after commit.
2129
1199
 
2134
1204
 
2135
1205
    # XXX: verbose currently does nothing
2136
1206
 
2137
 
    _see_also = ['bugs', 'uncommit']
2138
1207
    takes_args = ['selected*']
2139
 
    takes_options = [
2140
 
            Option('message', type=unicode,
2141
 
                   short_name='m',
2142
 
                   help="Description of the new revision."),
2143
 
            'verbose',
2144
 
             Option('unchanged',
2145
 
                    help='Commit even if nothing has changed.'),
2146
 
             Option('file', type=str,
2147
 
                    short_name='F',
2148
 
                    argname='msgfile',
2149
 
                    help='Take commit message from this file.'),
2150
 
             Option('strict',
2151
 
                    help="Refuse to commit if there are unknown "
2152
 
                    "files in the working tree."),
2153
 
             ListOption('fixes', type=str,
2154
 
                    help="Mark a bug as being fixed by this revision."),
2155
 
             Option('local',
2156
 
                    help="Perform a local commit in a bound "
2157
 
                         "branch.  Local commits are not pushed to "
2158
 
                         "the master branch until a normal commit "
2159
 
                         "is performed."
2160
 
                    ),
2161
 
             ]
 
1208
    takes_options = ['message', 'verbose', 
 
1209
                     Option('unchanged',
 
1210
                            help='commit even if nothing has changed'),
 
1211
                     Option('file', type=str, 
 
1212
                            argname='msgfile',
 
1213
                            help='file containing commit message'),
 
1214
                     Option('strict',
 
1215
                            help="refuse to commit if there are unknown "
 
1216
                            "files in the working tree."),
 
1217
                     ]
2162
1218
    aliases = ['ci', 'checkin']
2163
1219
 
2164
 
    def _get_bug_fix_properties(self, fixes, branch):
2165
 
        properties = []
2166
 
        # Configure the properties for bug fixing attributes.
2167
 
        for fixed_bug in fixes:
2168
 
            tokens = fixed_bug.split(':')
2169
 
            if len(tokens) != 2:
2170
 
                raise errors.BzrCommandError(
2171
 
                    "Invalid bug %s. Must be in the form of 'tag:id'. "
2172
 
                    "Commit refused." % fixed_bug)
2173
 
            tag, bug_id = tokens
2174
 
            try:
2175
 
                bug_url = bugtracker.get_bug_url(tag, branch, bug_id)
2176
 
            except errors.UnknownBugTrackerAbbreviation:
2177
 
                raise errors.BzrCommandError(
2178
 
                    'Unrecognized bug %s. Commit refused.' % fixed_bug)
2179
 
            except errors.MalformedBugIdentifier:
2180
 
                raise errors.BzrCommandError(
2181
 
                    "Invalid bug identifier for %s. Commit refused."
2182
 
                    % fixed_bug)
2183
 
            properties.append('%s fixed' % bug_url)
2184
 
        return '\n'.join(properties)
2185
 
 
2186
1220
    def run(self, message=None, file=None, verbose=True, selected_list=None,
2187
 
            unchanged=False, strict=False, local=False, fixes=None):
2188
 
        from bzrlib.commit import (NullCommitReporter, ReportCommitToLog)
 
1221
            unchanged=False, strict=False):
2189
1222
        from bzrlib.errors import (PointlessCommit, ConflictsInTree,
2190
1223
                StrictCommitFailed)
2191
 
        from bzrlib.msgeditor import edit_commit_message, \
2192
 
                make_commit_message_template
2193
 
 
2194
 
        # TODO: Need a blackbox test for invoking the external editor; may be
2195
 
        # slightly problematic to run this cross-platform.
2196
 
 
2197
 
        # TODO: do more checks that the commit will succeed before 
2198
 
        # spending the user's valuable time typing a commit message.
2199
 
 
2200
 
        properties = {}
2201
 
 
2202
 
        tree, selected_list = tree_files(selected_list)
2203
 
        if selected_list == ['']:
2204
 
            # workaround - commit of root of tree should be exactly the same
2205
 
            # as just default commit in that tree, and succeed even though
2206
 
            # selected-file merge commit is not done yet
2207
 
            selected_list = []
2208
 
 
2209
 
        bug_property = self._get_bug_fix_properties(fixes, tree.branch)
2210
 
        if bug_property:
2211
 
            properties['bugs'] = bug_property
2212
 
 
2213
 
        if local and not tree.branch.get_bound_location():
2214
 
            raise errors.LocalRequiresBoundBranch()
2215
 
 
2216
 
        def get_message(commit_obj):
2217
 
            """Callback to get commit message"""
2218
 
            my_message = message
2219
 
            if my_message is None and not file:
2220
 
                template = make_commit_message_template(tree, selected_list)
2221
 
                my_message = edit_commit_message(template)
2222
 
                if my_message is None:
2223
 
                    raise errors.BzrCommandError("please specify a commit"
2224
 
                        " message with either --message or --file")
2225
 
            elif my_message and file:
2226
 
                raise errors.BzrCommandError(
2227
 
                    "please specify either --message or --file")
2228
 
            if file:
2229
 
                my_message = codecs.open(file, 'rt', 
2230
 
                                         bzrlib.user_encoding).read()
2231
 
            if my_message == "":
2232
 
                raise errors.BzrCommandError("empty commit message specified")
2233
 
            return my_message
2234
 
 
2235
 
        if verbose:
2236
 
            reporter = ReportCommitToLog()
2237
 
        else:
2238
 
            reporter = NullCommitReporter()
2239
 
 
 
1224
        from bzrlib.msgeditor import edit_commit_message
 
1225
        from bzrlib.status import show_status
 
1226
        from cStringIO import StringIO
 
1227
 
 
1228
        b, selected_list = branch_files(selected_list)
 
1229
        if message is None and not file:
 
1230
            catcher = StringIO()
 
1231
            show_status(b, specific_files=selected_list,
 
1232
                        to_file=catcher)
 
1233
            message = edit_commit_message(catcher.getvalue())
 
1234
 
 
1235
            if message is None:
 
1236
                raise BzrCommandError("please specify a commit message"
 
1237
                                      " with either --message or --file")
 
1238
        elif message and file:
 
1239
            raise BzrCommandError("please specify either --message or --file")
 
1240
        
 
1241
        if file:
 
1242
            import codecs
 
1243
            message = codecs.open(file, 'rt', bzrlib.user_encoding).read()
 
1244
 
 
1245
        if message == "":
 
1246
                raise BzrCommandError("empty commit message specified")
 
1247
            
2240
1248
        try:
2241
 
            tree.commit(message_callback=get_message,
2242
 
                        specific_files=selected_list,
2243
 
                        allow_pointless=unchanged, strict=strict, local=local,
2244
 
                        reporter=reporter, revprops=properties)
 
1249
            b.working_tree().commit(message, specific_files=selected_list,
 
1250
                     allow_pointless=unchanged, strict=strict)
2245
1251
        except PointlessCommit:
2246
1252
            # FIXME: This should really happen before the file is read in;
2247
1253
            # perhaps prepare the commit; get the message; then actually commit
2248
 
            raise errors.BzrCommandError("no changes to commit."
2249
 
                              " use --unchanged to commit anyhow")
 
1254
            raise BzrCommandError("no changes to commit",
 
1255
                                  ["use --unchanged to commit anyhow"])
2250
1256
        except ConflictsInTree:
2251
 
            raise errors.BzrCommandError('Conflicts detected in working '
2252
 
                'tree.  Use "bzr conflicts" to list, "bzr resolve FILE" to'
2253
 
                ' resolve.')
 
1257
            raise BzrCommandError("Conflicts detected in working tree.  "
 
1258
                'Use "bzr conflicts" to list, "bzr resolve FILE" to resolve.')
2254
1259
        except StrictCommitFailed:
2255
 
            raise errors.BzrCommandError("Commit refused because there are"
2256
 
                              " unknown files in the working tree.")
2257
 
        except errors.BoundBranchOutOfDate, e:
2258
 
            raise errors.BzrCommandError(str(e) + "\n"
2259
 
            'To commit to master branch, run update and then commit.\n'
2260
 
            'You can also pass --local to commit to continue working '
2261
 
            'disconnected.')
 
1260
            raise BzrCommandError("Commit refused because there are unknown "
 
1261
                                  "files in the working tree.")
2262
1262
 
2263
1263
 
2264
1264
class cmd_check(Command):
2267
1267
    This command checks various invariants about the branch storage to
2268
1268
    detect data corruption or bzr bugs.
2269
1269
    """
2270
 
 
2271
 
    _see_also = ['reconcile']
2272
 
    takes_args = ['branch?']
 
1270
    takes_args = ['dir?']
2273
1271
    takes_options = ['verbose']
2274
1272
 
2275
 
    def run(self, branch=None, verbose=False):
 
1273
    def run(self, dir='.', verbose=False):
2276
1274
        from bzrlib.check import check
2277
 
        if branch is None:
2278
 
            tree = WorkingTree.open_containing()[0]
2279
 
            branch = tree.branch
2280
 
        else:
2281
 
            branch = Branch.open(branch)
2282
 
        check(branch, verbose)
 
1275
        check(Branch.open_containing(dir)[0], verbose)
 
1276
 
 
1277
 
 
1278
class cmd_scan_cache(Command):
 
1279
    hidden = True
 
1280
    def run(self):
 
1281
        from bzrlib.hashcache import HashCache
 
1282
 
 
1283
        c = HashCache('.')
 
1284
        c.read()
 
1285
        c.scan()
 
1286
            
 
1287
        print '%6d stats' % c.stat_count
 
1288
        print '%6d in hashcache' % len(c._cache)
 
1289
        print '%6d files removed from cache' % c.removed_count
 
1290
        print '%6d hashes updated' % c.update_count
 
1291
        print '%6d files changed too recently to cache' % c.danger_count
 
1292
 
 
1293
        if c.needs_write:
 
1294
            c.write()
 
1295
            
2283
1296
 
2284
1297
 
2285
1298
class cmd_upgrade(Command):
2286
1299
    """Upgrade branch storage to current format.
2287
1300
 
2288
1301
    The check command or bzr developers may sometimes advise you to run
2289
 
    this command. When the default format has changed you may also be warned
2290
 
    during other operations to upgrade.
 
1302
    this command.
 
1303
 
 
1304
    This version of this command upgrades from the full-text storage
 
1305
    used by bzr 0.0.8 and earlier to the weave format (v5).
2291
1306
    """
2292
 
 
2293
 
    _see_also = ['check']
2294
 
    takes_args = ['url?']
2295
 
    takes_options = [
2296
 
                    RegistryOption('format',
2297
 
                        help='Upgrade to a specific format.  See "bzr help'
2298
 
                             ' formats" for details.',
2299
 
                        registry=bzrdir.format_registry,
2300
 
                        converter=bzrdir.format_registry.make_bzrdir,
2301
 
                        value_switches=True, title='Branch format'),
2302
 
                    ]
2303
 
 
2304
 
    def run(self, url='.', format=None):
 
1307
    takes_args = ['dir?']
 
1308
 
 
1309
    def run(self, dir='.'):
2305
1310
        from bzrlib.upgrade import upgrade
2306
 
        if format is None:
2307
 
            format = bzrdir.format_registry.make_bzrdir('default')
2308
 
        upgrade(url, format)
 
1311
        upgrade(dir)
2309
1312
 
2310
1313
 
2311
1314
class cmd_whoami(Command):
2312
 
    """Show or set bzr user id.
2313
 
    
2314
 
    examples:
2315
 
        bzr whoami --email
2316
 
        bzr whoami 'Frank Chu <fchu@example.com>'
2317
 
    """
2318
 
    takes_options = [ Option('email',
2319
 
                             help='Display email address only.'),
2320
 
                      Option('branch',
2321
 
                             help='Set identity for the current branch instead of '
2322
 
                                  'globally.'),
2323
 
                    ]
2324
 
    takes_args = ['name?']
2325
 
    encoding_type = 'replace'
 
1315
    """Show bzr user id."""
 
1316
    takes_options = ['email']
2326
1317
    
2327
1318
    @display_command
2328
 
    def run(self, email=False, branch=False, name=None):
2329
 
        if name is None:
2330
 
            # use branch if we're inside one; otherwise global config
2331
 
            try:
2332
 
                c = Branch.open_containing('.')[0].get_config()
2333
 
            except errors.NotBranchError:
2334
 
                c = config.GlobalConfig()
2335
 
            if email:
2336
 
                self.outf.write(c.user_email() + '\n')
2337
 
            else:
2338
 
                self.outf.write(c.username() + '\n')
2339
 
            return
2340
 
 
2341
 
        # display a warning if an email address isn't included in the given name.
 
1319
    def run(self, email=False):
2342
1320
        try:
2343
 
            config.extract_email_address(name)
2344
 
        except errors.NoEmailInUsername, e:
2345
 
            warning('"%s" does not seem to contain an email address.  '
2346
 
                    'This is allowed, but not recommended.', name)
 
1321
            b = bzrlib.branch.Branch.open_containing('.')[0]
 
1322
            config = bzrlib.config.BranchConfig(b)
 
1323
        except NotBranchError:
 
1324
            config = bzrlib.config.GlobalConfig()
2347
1325
        
2348
 
        # use global config unless --branch given
2349
 
        if branch:
2350
 
            c = Branch.open_containing('.')[0].get_config()
 
1326
        if email:
 
1327
            print config.user_email()
2351
1328
        else:
2352
 
            c = config.GlobalConfig()
2353
 
        c.set_user_option('email', name)
2354
 
 
 
1329
            print config.username()
2355
1330
 
2356
1331
class cmd_nick(Command):
2357
 
    """Print or set the branch nickname.  
2358
 
 
 
1332
    """\
 
1333
    Print or set the branch nickname.  
2359
1334
    If unset, the tree root directory name is used as the nickname
2360
1335
    To print the current nickname, execute with no argument.  
2361
1336
    """
2362
 
 
2363
 
    _see_also = ['info']
2364
1337
    takes_args = ['nickname?']
2365
1338
    def run(self, nickname=None):
2366
 
        branch = Branch.open_containing(u'.')[0]
 
1339
        branch = Branch.open_containing('.')[0]
2367
1340
        if nickname is None:
2368
1341
            self.printme(branch)
2369
1342
        else:
2371
1344
 
2372
1345
    @display_command
2373
1346
    def printme(self, branch):
2374
 
        print branch.nick
2375
 
 
 
1347
        print branch.nick 
2376
1348
 
2377
1349
class cmd_selftest(Command):
2378
1350
    """Run internal test suite.
2379
1351
    
2380
 
    If arguments are given, they are regular expressions that say which tests
2381
 
    should run.  Tests matching any expression are run, and other tests are
2382
 
    not run.
2383
 
 
2384
 
    Alternatively if --first is given, matching tests are run first and then
2385
 
    all other tests are run.  This is useful if you have been working in a
2386
 
    particular area, but want to make sure nothing else was broken.
2387
 
 
2388
 
    If --exclude is given, tests that match that regular expression are
2389
 
    excluded, regardless of whether they match --first or not.
2390
 
 
2391
 
    To help catch accidential dependencies between tests, the --randomize
2392
 
    option is useful. In most cases, the argument used is the word 'now'.
2393
 
    Note that the seed used for the random number generator is displayed
2394
 
    when this option is used. The seed can be explicitly passed as the
2395
 
    argument to this option if required. This enables reproduction of the
2396
 
    actual ordering used if and when an order sensitive problem is encountered.
2397
 
 
2398
 
    If --list-only is given, the tests that would be run are listed. This is
2399
 
    useful when combined with --first, --exclude and/or --randomize to
2400
 
    understand their impact. The test harness reports "Listed nn tests in ..."
2401
 
    instead of "Ran nn tests in ..." when list mode is enabled.
2402
 
 
2403
 
    If the global option '--no-plugins' is given, plugins are not loaded
2404
 
    before running the selftests.  This has two effects: features provided or
2405
 
    modified by plugins will not be tested, and tests provided by plugins will
2406
 
    not be run.
2407
 
 
2408
 
    Tests that need working space on disk use a common temporary directory, 
2409
 
    typically inside $TMPDIR or /tmp.
2410
 
 
2411
 
    examples::
2412
 
        bzr selftest ignore
2413
 
            run only tests relating to 'ignore'
2414
 
        bzr --no-plugins selftest -v
2415
 
            disable plugins and list tests as they're run
 
1352
    This creates temporary test directories in the working directory,
 
1353
    but not existing data is affected.  These directories are deleted
 
1354
    if the tests pass, or left behind to help in debugging if they
 
1355
    fail and --keep-output is specified.
 
1356
    
 
1357
    If arguments are given, they are regular expressions that say
 
1358
    which tests should run.
2416
1359
    """
2417
 
    # NB: this is used from the class without creating an instance, which is
2418
 
    # why it does not have a self parameter.
2419
 
    def get_transport_type(typestring):
2420
 
        """Parse and return a transport specifier."""
2421
 
        if typestring == "sftp":
2422
 
            from bzrlib.transport.sftp import SFTPAbsoluteServer
2423
 
            return SFTPAbsoluteServer
2424
 
        if typestring == "memory":
2425
 
            from bzrlib.transport.memory import MemoryServer
2426
 
            return MemoryServer
2427
 
        if typestring == "fakenfs":
2428
 
            from bzrlib.transport.fakenfs import FakeNFSServer
2429
 
            return FakeNFSServer
2430
 
        msg = "No known transport type %s. Supported types are: sftp\n" %\
2431
 
            (typestring)
2432
 
        raise errors.BzrCommandError(msg)
2433
 
 
 
1360
    # TODO: --list should give a list of all available tests
2434
1361
    hidden = True
2435
1362
    takes_args = ['testspecs*']
2436
 
    takes_options = ['verbose',
2437
 
                     Option('one',
2438
 
                             help='Stop when one test fails.',
2439
 
                             short_name='1',
2440
 
                             ),
2441
 
                     Option('transport',
2442
 
                            help='Use a different transport by default '
2443
 
                                 'throughout the test suite.',
2444
 
                            type=get_transport_type),
2445
 
                     Option('benchmark',
2446
 
                            help='Run the benchmarks rather than selftests.'),
2447
 
                     Option('lsprof-timed',
2448
 
                            help='Generate lsprof output for benchmarked'
2449
 
                                 ' sections of code.'),
2450
 
                     Option('cache-dir', type=str,
2451
 
                            help='Cache intermediate benchmark output in this '
2452
 
                                 'directory.'),
2453
 
                     Option('first',
2454
 
                            help='Run all tests, but run specified tests first.',
2455
 
                            short_name='f',
2456
 
                            ),
2457
 
                     Option('list-only',
2458
 
                            help='List the tests instead of running them.'),
2459
 
                     Option('randomize', type=str, argname="SEED",
2460
 
                            help='Randomize the order of tests using the given'
2461
 
                                 ' seed or "now" for the current time.'),
2462
 
                     Option('exclude', type=str, argname="PATTERN",
2463
 
                            short_name='x',
2464
 
                            help='Exclude tests that match this regular'
2465
 
                                 ' expression.'),
2466
 
                     ]
2467
 
    encoding_type = 'replace'
 
1363
    takes_options = ['verbose', 
 
1364
                     Option('one', help='stop when one test fails'),
 
1365
                     Option('keep-output', 
 
1366
                            help='keep output directories when tests fail')
 
1367
                    ]
2468
1368
 
2469
 
    def run(self, testspecs_list=None, verbose=None, one=False,
2470
 
            transport=None, benchmark=None,
2471
 
            lsprof_timed=None, cache_dir=None,
2472
 
            first=False, list_only=False,
2473
 
            randomize=None, exclude=None):
 
1369
    def run(self, testspecs_list=None, verbose=False, one=False,
 
1370
            keep_output=False):
2474
1371
        import bzrlib.ui
2475
 
        from bzrlib.tests import selftest
2476
 
        import bzrlib.benchmarks as benchmarks
2477
 
        from bzrlib.benchmarks import tree_creator
2478
 
        from bzrlib.version import show_version
2479
 
 
2480
 
        if cache_dir is not None:
2481
 
            tree_creator.TreeCreator.CACHE_ROOT = osutils.abspath(cache_dir)
2482
 
        if not list_only:
2483
 
            show_version(show_config=False, show_copyright=False)
2484
 
        print
2485
 
        if testspecs_list is not None:
2486
 
            pattern = '|'.join(testspecs_list)
2487
 
        else:
2488
 
            pattern = ".*"
2489
 
        if benchmark:
2490
 
            test_suite_factory = benchmarks.test_suite
2491
 
            if verbose is None:
2492
 
                verbose = True
2493
 
            # TODO: should possibly lock the history file...
2494
 
            benchfile = open(".perf_history", "at", buffering=1)
2495
 
        else:
2496
 
            test_suite_factory = None
2497
 
            if verbose is None:
2498
 
                verbose = False
2499
 
            benchfile = None
 
1372
        from bzrlib.selftest import selftest
 
1373
        # we don't want progress meters from the tests to go to the
 
1374
        # real output; and we don't want log messages cluttering up
 
1375
        # the real logs.
 
1376
        save_ui = bzrlib.ui.ui_factory
 
1377
        bzrlib.trace.info('running tests...')
2500
1378
        try:
2501
 
            result = selftest(verbose=verbose,
 
1379
            bzrlib.ui.ui_factory = bzrlib.ui.SilentUIFactory()
 
1380
            if testspecs_list is not None:
 
1381
                pattern = '|'.join(testspecs_list)
 
1382
            else:
 
1383
                pattern = ".*"
 
1384
            result = selftest(verbose=verbose, 
2502
1385
                              pattern=pattern,
2503
 
                              stop_on_failure=one,
2504
 
                              transport=transport,
2505
 
                              test_suite_factory=test_suite_factory,
2506
 
                              lsprof_timed=lsprof_timed,
2507
 
                              bench_history=benchfile,
2508
 
                              matching_tests_first=first,
2509
 
                              list_only=list_only,
2510
 
                              random_seed=randomize,
2511
 
                              exclude_pattern=exclude
2512
 
                              )
 
1386
                              stop_on_failure=one, 
 
1387
                              keep_output=keep_output)
 
1388
            if result:
 
1389
                bzrlib.trace.info('tests passed')
 
1390
            else:
 
1391
                bzrlib.trace.info('tests failed')
 
1392
            return int(not result)
2513
1393
        finally:
2514
 
            if benchfile is not None:
2515
 
                benchfile.close()
2516
 
        if result:
2517
 
            info('tests passed')
2518
 
        else:
2519
 
            info('tests failed')
2520
 
        return int(not result)
 
1394
            bzrlib.ui.ui_factory = save_ui
 
1395
 
 
1396
 
 
1397
def show_version():
 
1398
    print "bzr (bazaar-ng) %s" % bzrlib.__version__
 
1399
    # is bzrlib itself in a branch?
 
1400
    bzrrev = bzrlib.get_bzr_revision()
 
1401
    if bzrrev:
 
1402
        print "  (bzr checkout, revision %d {%s})" % bzrrev
 
1403
    print bzrlib.__copyright__
 
1404
    print "http://bazaar-ng.org/"
 
1405
    print
 
1406
    print "bzr comes with ABSOLUTELY NO WARRANTY.  bzr is free software, and"
 
1407
    print "you may use, modify and redistribute it under the terms of the GNU"
 
1408
    print "General Public License version 2 or later."
2521
1409
 
2522
1410
 
2523
1411
class cmd_version(Command):
2524
1412
    """Show version of bzr."""
2525
 
 
2526
1413
    @display_command
2527
1414
    def run(self):
2528
 
        from bzrlib.version import show_version
2529
1415
        show_version()
2530
1416
 
2531
 
 
2532
1417
class cmd_rocks(Command):
2533
1418
    """Statement of optimism."""
2534
 
 
2535
1419
    hidden = True
2536
 
 
2537
1420
    @display_command
2538
1421
    def run(self):
2539
 
        print "It sure does!"
 
1422
        print "it sure does!"
2540
1423
 
2541
1424
 
2542
1425
class cmd_find_merge_base(Command):
2543
 
    """Find and print a base revision for merging two branches."""
 
1426
    """Find and print a base revision for merging two branches.
 
1427
    """
2544
1428
    # TODO: Options to specify revisions on either side, as if
2545
1429
    #       merging only part of the history.
2546
1430
    takes_args = ['branch', 'other']
2548
1432
    
2549
1433
    @display_command
2550
1434
    def run(self, branch, other):
2551
 
        from bzrlib.revision import ensure_null, MultipleRevisionSources
 
1435
        from bzrlib.revision import common_ancestor, MultipleRevisionSources
2552
1436
        
2553
1437
        branch1 = Branch.open_containing(branch)[0]
2554
1438
        branch2 = Branch.open_containing(other)[0]
2555
1439
 
2556
 
        last1 = ensure_null(branch1.last_revision())
2557
 
        last2 = ensure_null(branch2.last_revision())
2558
 
 
2559
 
        graph = branch1.repository.get_graph(branch2.repository)
2560
 
        base_rev_id = graph.find_unique_lca(last1, last2)
 
1440
        history_1 = branch1.revision_history()
 
1441
        history_2 = branch2.revision_history()
 
1442
 
 
1443
        last1 = branch1.last_revision()
 
1444
        last2 = branch2.last_revision()
 
1445
 
 
1446
        source = MultipleRevisionSources(branch1, branch2)
 
1447
        
 
1448
        base_rev_id = common_ancestor(last1, last2, source)
2561
1449
 
2562
1450
        print 'merge base is revision %s' % base_rev_id
 
1451
        
 
1452
        return
 
1453
 
 
1454
        if base_revno is None:
 
1455
            raise bzrlib.errors.UnrelatedBranches()
 
1456
 
 
1457
        print ' r%-6d in %s' % (base_revno, branch)
 
1458
 
 
1459
        other_revno = branch2.revision_id_to_revno(base_revid)
 
1460
        
 
1461
        print ' r%-6d in %s' % (other_revno, other)
 
1462
 
2563
1463
 
2564
1464
 
2565
1465
class cmd_merge(Command):
2566
1466
    """Perform a three-way merge.
2567
1467
    
2568
 
    The branch is the branch you will merge from.  By default, it will merge
2569
 
    the latest revision.  If you specify a revision, that revision will be
2570
 
    merged.  If you specify two revisions, the first will be used as a BASE,
2571
 
    and the second one as OTHER.  Revision numbers are always relative to the
2572
 
    specified branch.
 
1468
    The branch is the branch you will merge from.  By default, it will
 
1469
    merge the latest revision.  If you specify a revision, that
 
1470
    revision will be merged.  If you specify two revisions, the first
 
1471
    will be used as a BASE, and the second one as OTHER.  Revision
 
1472
    numbers are always relative to the specified branch.
2573
1473
 
2574
 
    By default, bzr will try to merge in all new work from the other
 
1474
    By default bzr will try to merge in all new work from the other
2575
1475
    branch, automatically determining an appropriate base.  If this
2576
1476
    fails, you may need to give an explicit base.
2577
1477
    
2578
 
    Merge will do its best to combine the changes in two branches, but there
2579
 
    are some kinds of problems only a human can fix.  When it encounters those,
2580
 
    it will mark a conflict.  A conflict means that you need to fix something,
2581
 
    before you should commit.
2582
 
 
2583
 
    Use bzr resolve when you have fixed a problem.  See also bzr conflicts.
2584
 
 
2585
 
    If there is no default branch set, the first merge will set it. After
2586
 
    that, you can omit the branch to use the default.  To change the
2587
 
    default, use --remember. The value will only be saved if the remote
2588
 
    location can be accessed.
2589
 
 
2590
 
    The results of the merge are placed into the destination working
2591
 
    directory, where they can be reviewed (with bzr diff), tested, and then
2592
 
    committed to record the result of the merge.
2593
 
 
2594
1478
    Examples:
2595
1479
 
2596
 
    To merge the latest revision from bzr.dev:
2597
 
        bzr merge ../bzr.dev
 
1480
    To merge the latest revision from bzr.dev
 
1481
    bzr merge ../bzr.dev
2598
1482
 
2599
 
    To merge changes up to and including revision 82 from bzr.dev:
2600
 
        bzr merge -r 82 ../bzr.dev
 
1483
    To merge changes up to and including revision 82 from bzr.dev
 
1484
    bzr merge -r 82 ../bzr.dev
2601
1485
 
2602
1486
    To merge the changes introduced by 82, without previous changes:
2603
 
        bzr merge -r 81..82 ../bzr.dev
 
1487
    bzr merge -r 81..82 ../bzr.dev
2604
1488
    
2605
1489
    merge refuses to run if there are any uncommitted changes, unless
2606
1490
    --force is given.
2607
1491
    """
2608
 
 
2609
 
    _see_also = ['update', 'remerge', 'status-flags']
2610
1492
    takes_args = ['branch?']
2611
 
    takes_options = [
2612
 
        'revision',
2613
 
        Option('force',
2614
 
               help='Merge even if the destination tree has uncommitted changes.'),
2615
 
        'merge-type',
2616
 
        'reprocess',
2617
 
        'remember',
2618
 
        Option('show-base', help="Show base revision text in "
2619
 
               "conflicts."),
2620
 
        Option('uncommitted', help='Apply uncommitted changes'
2621
 
               ' from a working copy, instead of branch changes.'),
2622
 
        Option('pull', help='If the destination is already'
2623
 
                ' completely merged into the source, pull from the'
2624
 
                ' source rather than merging.  When this happens,'
2625
 
                ' you do not need to commit the result.'),
2626
 
        Option('directory',
2627
 
               help='Branch to merge into, '
2628
 
                    'rather than the one containing the working directory.',
2629
 
               short_name='d',
2630
 
               type=unicode,
2631
 
               ),
2632
 
    ]
 
1493
    takes_options = ['revision', 'force', 'merge-type', 'reprocess',
 
1494
                     Option('show-base', help="Show base revision text in "
 
1495
                            "conflicts")]
2633
1496
 
2634
1497
    def run(self, branch=None, revision=None, force=False, merge_type=None,
2635
 
            show_base=False, reprocess=False, remember=False,
2636
 
            uncommitted=False, pull=False,
2637
 
            directory=None,
2638
 
            ):
2639
 
        from bzrlib.tag import _merge_tags_if_possible
2640
 
        other_revision_id = None
 
1498
            show_base=False, reprocess=False):
 
1499
        from bzrlib.merge import merge
 
1500
        from bzrlib.merge_core import ApplyMerge3
2641
1501
        if merge_type is None:
2642
 
            merge_type = _mod_merge.Merge3Merger
2643
 
 
2644
 
        if directory is None: directory = u'.'
2645
 
        # XXX: jam 20070225 WorkingTree should be locked before you extract its
2646
 
        #      inventory. Because merge is a mutating operation, it really
2647
 
        #      should be a lock_write() for the whole cmd_merge operation.
2648
 
        #      However, cmd_merge open's its own tree in _merge_helper, which
2649
 
        #      means if we lock here, the later lock_write() will always block.
2650
 
        #      Either the merge helper code should be updated to take a tree,
2651
 
        #      (What about tree.merge_from_branch?)
2652
 
        tree = WorkingTree.open_containing(directory)[0]
2653
 
        change_reporter = delta._ChangeReporter(
2654
 
            unversioned_filter=tree.is_ignored)
2655
 
 
2656
 
        if branch is not None:
2657
 
            try:
2658
 
                mergeable = bundle.read_mergeable_from_url(
2659
 
                    branch)
2660
 
            except errors.NotABundle:
2661
 
                pass # Continue on considering this url a Branch
 
1502
            merge_type = ApplyMerge3
 
1503
        if branch is None:
 
1504
            branch = Branch.open_containing('.')[0].get_parent()
 
1505
            if branch is None:
 
1506
                raise BzrCommandError("No merge location known or specified.")
2662
1507
            else:
2663
 
                if revision is not None:
2664
 
                    raise errors.BzrCommandError(
2665
 
                        'Cannot use -r with merge directives or bundles')
2666
 
                other_revision_id = mergeable.install_revisions(
2667
 
                    tree.branch.repository)
2668
 
                revision = [RevisionSpec.from_string(
2669
 
                    'revid:' + other_revision_id)]
2670
 
 
2671
 
        if revision is None \
2672
 
                or len(revision) < 1 or revision[0].needs_branch():
2673
 
            branch = self._get_remembered_parent(tree, branch, 'Merging from')
2674
 
 
 
1508
                print "Using saved location: %s" % branch 
2675
1509
        if revision is None or len(revision) < 1:
2676
 
            if uncommitted:
2677
 
                base = [branch, -1]
2678
 
                other = [branch, None]
2679
 
            else:
2680
 
                base = [None, None]
2681
 
                other = [branch, -1]
2682
 
            other_branch, path = Branch.open_containing(branch)
 
1510
            base = [None, None]
 
1511
            other = [branch, -1]
2683
1512
        else:
2684
 
            if uncommitted:
2685
 
                raise errors.BzrCommandError('Cannot use --uncommitted and'
2686
 
                                             ' --revision at the same time.')
2687
 
            branch = revision[0].get_branch() or branch
2688
1513
            if len(revision) == 1:
2689
1514
                base = [None, None]
2690
 
                if other_revision_id is not None:
2691
 
                    other_branch = None
2692
 
                    path = ""
2693
 
                    other = None
2694
 
                else:
2695
 
                    other_branch, path = Branch.open_containing(branch)
2696
 
                    revno = revision[0].in_history(other_branch).revno
2697
 
                    other = [branch, revno]
 
1515
                other_branch = Branch.open_containing(branch)[0]
 
1516
                revno = revision[0].in_history(other_branch).revno
 
1517
                other = [branch, revno]
2698
1518
            else:
2699
1519
                assert len(revision) == 2
2700
1520
                if None in revision:
2701
 
                    raise errors.BzrCommandError(
2702
 
                        "Merge doesn't permit empty revision specifier.")
2703
 
                base_branch, path = Branch.open_containing(branch)
2704
 
                branch1 = revision[1].get_branch() or branch
2705
 
                other_branch, path1 = Branch.open_containing(branch1)
2706
 
                if revision[0].get_branch() is not None:
2707
 
                    # then path was obtained from it, and is None.
2708
 
                    path = path1
2709
 
 
2710
 
                base = [branch, revision[0].in_history(base_branch).revno]
2711
 
                other = [branch1, revision[1].in_history(other_branch).revno]
2712
 
 
2713
 
        if ((tree.branch.get_parent() is None or remember) and
2714
 
            other_branch is not None):
2715
 
            tree.branch.set_parent(other_branch.base)
2716
 
 
2717
 
        # pull tags now... it's a bit inconsistent to do it ahead of copying
2718
 
        # the history but that's done inside the merge code
2719
 
        if other_branch is not None:
2720
 
            _merge_tags_if_possible(other_branch, tree.branch)
2721
 
 
2722
 
        if path != "":
2723
 
            interesting_files = [path]
2724
 
        else:
2725
 
            interesting_files = None
2726
 
        pb = ui.ui_factory.nested_progress_bar()
 
1521
                    raise BzrCommandError(
 
1522
                        "Merge doesn't permit that revision specifier.")
 
1523
                b = Branch.open_containing(branch)[0]
 
1524
 
 
1525
                base = [branch, revision[0].in_history(b).revno]
 
1526
                other = [branch, revision[1].in_history(b).revno]
 
1527
 
2727
1528
        try:
2728
 
            try:
2729
 
                conflict_count = _merge_helper(
2730
 
                    other, base, other_rev_id=other_revision_id,
2731
 
                    check_clean=(not force),
2732
 
                    merge_type=merge_type,
2733
 
                    reprocess=reprocess,
2734
 
                    show_base=show_base,
2735
 
                    pull=pull,
2736
 
                    this_dir=directory,
2737
 
                    pb=pb, file_list=interesting_files,
2738
 
                    change_reporter=change_reporter)
2739
 
            finally:
2740
 
                pb.finished()
 
1529
            conflict_count = merge(other, base, check_clean=(not force),
 
1530
                                   merge_type=merge_type, reprocess=reprocess,
 
1531
                                   show_base=show_base)
2741
1532
            if conflict_count != 0:
2742
1533
                return 1
2743
1534
            else:
2744
1535
                return 0
2745
 
        except errors.AmbiguousBase, e:
 
1536
        except bzrlib.errors.AmbiguousBase, e:
2746
1537
            m = ("sorry, bzr can't determine the right merge base yet\n"
2747
1538
                 "candidates are:\n  "
2748
1539
                 + "\n  ".join(e.bases)
2751
1542
                 "and (if you want) report this to the bzr developers\n")
2752
1543
            log_error(m)
2753
1544
 
2754
 
    # TODO: move up to common parent; this isn't merge-specific anymore. 
2755
 
    def _get_remembered_parent(self, tree, supplied_location, verb_string):
2756
 
        """Use tree.branch's parent if none was supplied.
2757
 
 
2758
 
        Report if the remembered location was used.
2759
 
        """
2760
 
        if supplied_location is not None:
2761
 
            return supplied_location
2762
 
        stored_location = tree.branch.get_parent()
2763
 
        mutter("%s", stored_location)
2764
 
        if stored_location is None:
2765
 
            raise errors.BzrCommandError("No location specified or remembered")
2766
 
        display_url = urlutils.unescape_for_display(stored_location, self.outf.encoding)
2767
 
        self.outf.write("%s remembered location %s\n" % (verb_string, display_url))
2768
 
        return stored_location
2769
 
 
2770
1545
 
2771
1546
class cmd_remerge(Command):
2772
1547
    """Redo a merge.
2773
 
 
2774
 
    Use this if you want to try a different merge technique while resolving
2775
 
    conflicts.  Some merge techniques are better than others, and remerge 
2776
 
    lets you try different ones on different files.
2777
 
 
2778
 
    The options for remerge have the same meaning and defaults as the ones for
2779
 
    merge.  The difference is that remerge can (only) be run when there is a
2780
 
    pending merge, and it lets you specify particular files.
2781
 
 
2782
 
    Examples:
2783
 
 
2784
 
    $ bzr remerge --show-base
2785
 
        Re-do the merge of all conflicted files, and show the base text in
2786
 
        conflict regions, in addition to the usual THIS and OTHER texts.
2787
 
 
2788
 
    $ bzr remerge --merge-type weave --reprocess foobar
2789
 
        Re-do the merge of "foobar", using the weave merge algorithm, with
2790
 
        additional processing to reduce the size of conflict regions.
2791
1548
    """
2792
1549
    takes_args = ['file*']
2793
 
    takes_options = [
2794
 
            'merge-type',
2795
 
            'reprocess',
2796
 
            Option('show-base',
2797
 
                   help="Show base revision text in conflicts."),
2798
 
            ]
 
1550
    takes_options = ['merge-type', 'reprocess',
 
1551
                     Option('show-base', help="Show base revision text in "
 
1552
                            "conflicts")]
2799
1553
 
2800
1554
    def run(self, file_list=None, merge_type=None, show_base=False,
2801
1555
            reprocess=False):
 
1556
        from bzrlib.merge import merge_inner, transform_tree
 
1557
        from bzrlib.merge_core import ApplyMerge3
2802
1558
        if merge_type is None:
2803
 
            merge_type = _mod_merge.Merge3Merger
2804
 
        tree, file_list = tree_files(file_list)
2805
 
        tree.lock_write()
 
1559
            merge_type = ApplyMerge3
 
1560
        b, file_list = branch_files(file_list)
 
1561
        b.lock_write()
2806
1562
        try:
2807
 
            parents = tree.get_parent_ids()
2808
 
            if len(parents) != 2:
2809
 
                raise errors.BzrCommandError("Sorry, remerge only works after normal"
2810
 
                                             " merges.  Not cherrypicking or"
2811
 
                                             " multi-merges.")
2812
 
            repository = tree.branch.repository
2813
 
            graph = repository.get_graph()
2814
 
            base_revision = graph.find_unique_lca(parents[0], parents[1])
2815
 
            base_tree = repository.revision_tree(base_revision)
2816
 
            other_tree = repository.revision_tree(parents[1])
 
1563
            pending_merges = b.working_tree().pending_merges() 
 
1564
            if len(pending_merges) != 1:
 
1565
                raise BzrCommandError("Sorry, remerge only works after normal"
 
1566
                                      + " merges.  Not cherrypicking or"
 
1567
                                      + "multi-merges.")
 
1568
            this_tree = b.working_tree()
 
1569
            base_revision = common_ancestor(b.last_revision(), 
 
1570
                                            pending_merges[0], b)
 
1571
            base_tree = b.revision_tree(base_revision)
 
1572
            other_tree = b.revision_tree(pending_merges[0])
2817
1573
            interesting_ids = None
2818
 
            new_conflicts = []
2819
 
            conflicts = tree.conflicts()
2820
1574
            if file_list is not None:
2821
1575
                interesting_ids = set()
2822
1576
                for filename in file_list:
2823
 
                    file_id = tree.path2id(filename)
2824
 
                    if file_id is None:
2825
 
                        raise errors.NotVersionedError(filename)
 
1577
                    file_id = this_tree.path2id(filename)
2826
1578
                    interesting_ids.add(file_id)
2827
 
                    if tree.kind(file_id) != "directory":
 
1579
                    if this_tree.kind(file_id) != "directory":
2828
1580
                        continue
2829
1581
                    
2830
 
                    for name, ie in tree.inventory.iter_entries(file_id):
 
1582
                    for name, ie in this_tree.inventory.iter_entries(file_id):
2831
1583
                        interesting_ids.add(ie.file_id)
2832
 
                new_conflicts = conflicts.select_conflicts(tree, file_list)[0]
 
1584
            transform_tree(this_tree, b.basis_tree(), interesting_ids)
 
1585
            if file_list is None:
 
1586
                restore_files = list(this_tree.iter_conflicts())
2833
1587
            else:
2834
 
                # Remerge only supports resolving contents conflicts
2835
 
                allowed_conflicts = ('text conflict', 'contents conflict')
2836
 
                restore_files = [c.path for c in conflicts
2837
 
                                 if c.typestring in allowed_conflicts]
2838
 
            _mod_merge.transform_tree(tree, tree.basis_tree(), interesting_ids)
2839
 
            tree.set_conflicts(ConflictList(new_conflicts))
2840
 
            if file_list is not None:
2841
1588
                restore_files = file_list
2842
1589
            for filename in restore_files:
2843
1590
                try:
2844
 
                    restore(tree.abspath(filename))
2845
 
                except errors.NotConflicted:
 
1591
                    restore(this_tree.abspath(filename))
 
1592
                except NotConflicted:
2846
1593
                    pass
2847
 
            conflicts = _mod_merge.merge_inner(
2848
 
                                      tree.branch, other_tree, base_tree,
2849
 
                                      this_tree=tree,
2850
 
                                      interesting_ids=interesting_ids,
2851
 
                                      other_rev_id=parents[1],
2852
 
                                      merge_type=merge_type,
2853
 
                                      show_base=show_base,
2854
 
                                      reprocess=reprocess)
 
1594
            conflicts =  merge_inner(b, other_tree, base_tree, 
 
1595
                                     interesting_ids = interesting_ids, 
 
1596
                                     other_rev_id=pending_merges[0], 
 
1597
                                     merge_type=merge_type, 
 
1598
                                     show_base=show_base,
 
1599
                                     reprocess=reprocess)
2855
1600
        finally:
2856
 
            tree.unlock()
 
1601
            b.unlock()
2857
1602
        if conflicts > 0:
2858
1603
            return 1
2859
1604
        else:
2860
1605
            return 0
2861
1606
 
2862
 
 
2863
1607
class cmd_revert(Command):
2864
 
    """Revert files to a previous revision.
2865
 
 
2866
 
    Giving a list of files will revert only those files.  Otherwise, all files
2867
 
    will be reverted.  If the revision is not specified with '--revision', the
2868
 
    last committed revision is used.
2869
 
 
2870
 
    To remove only some changes, without reverting to a prior version, use
2871
 
    merge instead.  For example, "merge . --r-2..-3" will remove the changes
2872
 
    introduced by -2, without affecting the changes introduced by -1.  Or
2873
 
    to remove certain changes on a hunk-by-hunk basis, see the Shelf plugin.
2874
 
    
2875
 
    By default, any files that have been manually changed will be backed up
2876
 
    first.  (Files changed only by merge are not backed up.)  Backup files have
2877
 
    '.~#~' appended to their name, where # is a number.
2878
 
 
2879
 
    When you provide files, you can use their current pathname or the pathname
2880
 
    from the target revision.  So you can use revert to "undelete" a file by
2881
 
    name.  If you name a directory, all the contents of that directory will be
2882
 
    reverted.
 
1608
    """Reverse all changes since the last commit.
 
1609
 
 
1610
    Only versioned files are affected.  Specify filenames to revert only 
 
1611
    those files.  By default, any files that are changed will be backed up
 
1612
    first.  Backup files have a '~' appended to their name.
2883
1613
    """
2884
 
 
2885
 
    _see_also = ['cat', 'export']
2886
 
    takes_options = [
2887
 
            'revision',
2888
 
            Option('no-backup', "Do not save backups of reverted files."),
2889
 
            ]
 
1614
    takes_options = ['revision', 'no-backup']
2890
1615
    takes_args = ['file*']
 
1616
    aliases = ['merge-revert']
2891
1617
 
2892
1618
    def run(self, revision=None, no_backup=False, file_list=None):
 
1619
        from bzrlib.merge import merge_inner
 
1620
        from bzrlib.commands import parse_spec
2893
1621
        if file_list is not None:
2894
1622
            if len(file_list) == 0:
2895
 
                raise errors.BzrCommandError("No files specified")
 
1623
                raise BzrCommandError("No files specified")
2896
1624
        else:
2897
1625
            file_list = []
2898
 
        
2899
 
        tree, file_list = tree_files(file_list)
2900
1626
        if revision is None:
2901
 
            # FIXME should be tree.last_revision
2902
 
            rev_id = tree.last_revision()
 
1627
            revno = -1
 
1628
            b = Branch.open_containing('.')[0]
 
1629
            rev_id = b.last_revision()
2903
1630
        elif len(revision) != 1:
2904
 
            raise errors.BzrCommandError('bzr revert --revision takes exactly 1 argument')
 
1631
            raise BzrCommandError('bzr revert --revision takes exactly 1 argument')
2905
1632
        else:
2906
 
            rev_id = revision[0].in_history(tree.branch).rev_id
2907
 
        pb = ui.ui_factory.nested_progress_bar()
2908
 
        try:
2909
 
            tree.revert(file_list, 
2910
 
                        tree.branch.repository.revision_tree(rev_id),
2911
 
                        not no_backup, pb, report_changes=True)
2912
 
        finally:
2913
 
            pb.finished()
 
1633
            b, file_list = branch_files(file_list)
 
1634
            rev_id = revision[0].in_history(b).rev_id
 
1635
        b.working_tree().revert(file_list, b.revision_tree(rev_id),
 
1636
                                not no_backup)
2914
1637
 
2915
1638
 
2916
1639
class cmd_assert_fail(Command):
2917
1640
    """Test reporting of assertion failures"""
2918
 
    # intended just for use in testing
2919
 
 
2920
1641
    hidden = True
2921
 
 
2922
1642
    def run(self):
2923
 
        raise AssertionError("always fails")
 
1643
        assert False, "always fails"
2924
1644
 
2925
1645
 
2926
1646
class cmd_help(Command):
2927
1647
    """Show help on a command or other topic.
2928
 
    """
2929
1648
 
2930
 
    _see_also = ['topics']
2931
 
    takes_options = [
2932
 
            Option('long', 'Show help on all commands.'),
2933
 
            ]
 
1649
    For a list of all available commands, say 'bzr help commands'."""
 
1650
    takes_options = ['long']
2934
1651
    takes_args = ['topic?']
2935
 
    aliases = ['?', '--help', '-?', '-h']
 
1652
    aliases = ['?']
2936
1653
    
2937
1654
    @display_command
2938
1655
    def run(self, topic=None, long=False):
2939
 
        import bzrlib.help
 
1656
        import help
2940
1657
        if topic is None and long:
2941
1658
            topic = "commands"
2942
 
        bzrlib.help.help(topic)
 
1659
        help.help(topic)
2943
1660
 
2944
1661
 
2945
1662
class cmd_shell_complete(Command):
2946
1663
    """Show appropriate completions for context.
2947
1664
 
2948
 
    For a list of all available commands, say 'bzr shell-complete'.
2949
 
    """
 
1665
    For a list of all available commands, say 'bzr shell-complete'."""
2950
1666
    takes_args = ['context?']
2951
1667
    aliases = ['s-c']
2952
1668
    hidden = True
2960
1676
class cmd_fetch(Command):
2961
1677
    """Copy in history from another branch but don't merge it.
2962
1678
 
2963
 
    This is an internal method used for pull and merge.
2964
 
    """
 
1679
    This is an internal method used for pull and merge."""
2965
1680
    hidden = True
2966
1681
    takes_args = ['from_branch', 'to_branch']
2967
1682
    def run(self, from_branch, to_branch):
2968
1683
        from bzrlib.fetch import Fetcher
 
1684
        from bzrlib.branch import Branch
2969
1685
        from_b = Branch.open(from_branch)
2970
1686
        to_b = Branch.open(to_branch)
2971
 
        Fetcher(to_b, from_b)
 
1687
        from_b.lock_read()
 
1688
        try:
 
1689
            to_b.lock_write()
 
1690
            try:
 
1691
                Fetcher(to_b, from_b)
 
1692
            finally:
 
1693
                to_b.unlock()
 
1694
        finally:
 
1695
            from_b.unlock()
2972
1696
 
2973
1697
 
2974
1698
class cmd_missing(Command):
2975
 
    """Show unmerged/unpulled revisions between two branches.
 
1699
    """What is missing in this branch relative to other branch.
 
1700
    """
 
1701
    # TODO: rewrite this in terms of ancestry so that it shows only
 
1702
    # unmerged things
2976
1703
    
2977
 
    OTHER_BRANCH may be local or remote.
2978
 
    """
2979
 
 
2980
 
    _see_also = ['merge', 'pull']
2981
 
    takes_args = ['other_branch?']
2982
 
    takes_options = [
2983
 
            Option('reverse', 'Reverse the order of revisions.'),
2984
 
            Option('mine-only',
2985
 
                   'Display changes in the local branch only.'),
2986
 
            Option('this' , 'Same as --mine-only.'),
2987
 
            Option('theirs-only',
2988
 
                   'Display changes in the remote branch only.'),
2989
 
            Option('other', 'Same as --theirs-only.'),
2990
 
            'log-format',
2991
 
            'show-ids',
2992
 
            'verbose'
2993
 
            ]
2994
 
    encoding_type = 'replace'
 
1704
    takes_args = ['remote?']
 
1705
    aliases = ['mis', 'miss']
 
1706
    # We don't have to add quiet to the list, because 
 
1707
    # unknown options are parsed as booleans
 
1708
    takes_options = ['verbose', 'quiet']
2995
1709
 
2996
1710
    @display_command
2997
 
    def run(self, other_branch=None, reverse=False, mine_only=False,
2998
 
            theirs_only=False, log_format=None, long=False, short=False, line=False, 
2999
 
            show_ids=False, verbose=False, this=False, other=False):
3000
 
        from bzrlib.missing import find_unmerged, iter_log_revisions
3001
 
        from bzrlib.log import log_formatter
3002
 
 
3003
 
        if this:
3004
 
          mine_only = this
3005
 
        if other:
3006
 
          theirs_only = other
3007
 
 
3008
 
        local_branch = Branch.open_containing(u".")[0]
3009
 
        parent = local_branch.get_parent()
3010
 
        if other_branch is None:
3011
 
            other_branch = parent
3012
 
            if other_branch is None:
3013
 
                raise errors.BzrCommandError("No peer location known or specified.")
3014
 
            display_url = urlutils.unescape_for_display(parent,
3015
 
                                                        self.outf.encoding)
3016
 
            print "Using last location: " + display_url
3017
 
 
3018
 
        remote_branch = Branch.open(other_branch)
3019
 
        if remote_branch.base == local_branch.base:
3020
 
            remote_branch = local_branch
3021
 
        local_branch.lock_read()
3022
 
        try:
3023
 
            remote_branch.lock_read()
3024
 
            try:
3025
 
                local_extra, remote_extra = find_unmerged(local_branch, remote_branch)
3026
 
                if (log_format is None):
3027
 
                    log_format = log.log_formatter_registry.get_default(
3028
 
                        local_branch)
3029
 
                lf = log_format(to_file=self.outf,
3030
 
                                show_ids=show_ids,
3031
 
                                show_timezone='original')
3032
 
                if reverse is False:
3033
 
                    local_extra.reverse()
3034
 
                    remote_extra.reverse()
3035
 
                if local_extra and not theirs_only:
3036
 
                    print "You have %d extra revision(s):" % len(local_extra)
3037
 
                    for revision in iter_log_revisions(local_extra, 
3038
 
                                        local_branch.repository,
3039
 
                                        verbose):
3040
 
                        lf.log_revision(revision)
3041
 
                    printed_local = True
3042
 
                else:
3043
 
                    printed_local = False
3044
 
                if remote_extra and not mine_only:
3045
 
                    if printed_local is True:
3046
 
                        print "\n\n"
3047
 
                    print "You are missing %d revision(s):" % len(remote_extra)
3048
 
                    for revision in iter_log_revisions(remote_extra, 
3049
 
                                        remote_branch.repository, 
3050
 
                                        verbose):
3051
 
                        lf.log_revision(revision)
3052
 
                if not remote_extra and not local_extra:
3053
 
                    status_code = 0
3054
 
                    print "Branches are up to date."
3055
 
                else:
3056
 
                    status_code = 1
3057
 
            finally:
3058
 
                remote_branch.unlock()
3059
 
        finally:
3060
 
            local_branch.unlock()
3061
 
        if not status_code and parent is None and other_branch is not None:
3062
 
            local_branch.lock_write()
3063
 
            try:
3064
 
                # handle race conditions - a parent might be set while we run.
3065
 
                if local_branch.get_parent() is None:
3066
 
                    local_branch.set_parent(remote_branch.base)
3067
 
            finally:
3068
 
                local_branch.unlock()
3069
 
        return status_code
3070
 
 
3071
 
 
3072
 
class cmd_pack(Command):
3073
 
    """Compress the data within a repository."""
3074
 
 
3075
 
    _see_also = ['repositories']
3076
 
    takes_args = ['branch_or_repo?']
3077
 
 
3078
 
    def run(self, branch_or_repo='.'):
3079
 
        dir = bzrdir.BzrDir.open_containing(branch_or_repo)[0]
3080
 
        try:
3081
 
            branch = dir.open_branch()
3082
 
            repository = branch.repository
3083
 
        except errors.NotBranchError:
3084
 
            repository = dir.open_repository()
3085
 
        repository.pack()
 
1711
    def run(self, remote=None, verbose=False, quiet=False):
 
1712
        from bzrlib.errors import BzrCommandError
 
1713
        from bzrlib.missing import show_missing
 
1714
 
 
1715
        if verbose and quiet:
 
1716
            raise BzrCommandError('Cannot pass both quiet and verbose')
 
1717
 
 
1718
        b = Branch.open_containing('.')[0]
 
1719
        parent = b.get_parent()
 
1720
        if remote is None:
 
1721
            if parent is None:
 
1722
                raise BzrCommandError("No missing location known or specified.")
 
1723
            else:
 
1724
                if not quiet:
 
1725
                    print "Using last location: %s" % parent
 
1726
                remote = parent
 
1727
        elif parent is None:
 
1728
            # We only update parent if it did not exist, missing
 
1729
            # should not change the parent
 
1730
            b.set_parent(remote)
 
1731
        br_remote = Branch.open_containing(remote)[0]
 
1732
        return show_missing(b, br_remote, verbose=verbose, quiet=quiet)
3086
1733
 
3087
1734
 
3088
1735
class cmd_plugins(Command):
3092
1739
    def run(self):
3093
1740
        import bzrlib.plugin
3094
1741
        from inspect import getdoc
3095
 
        for name, plugin in bzrlib.plugin.all_plugins().items():
3096
 
            if getattr(plugin, '__path__', None) is not None:
 
1742
        for plugin in bzrlib.plugin.all_plugins:
 
1743
            if hasattr(plugin, '__path__'):
3097
1744
                print plugin.__path__[0]
3098
 
            elif getattr(plugin, '__file__', None) is not None:
 
1745
            elif hasattr(plugin, '__file__'):
3099
1746
                print plugin.__file__
3100
1747
            else:
3101
 
                print repr(plugin)
 
1748
                print `plugin`
3102
1749
                
3103
1750
            d = getdoc(plugin)
3104
1751
            if d:
3107
1754
 
3108
1755
class cmd_testament(Command):
3109
1756
    """Show testament (signing-form) of a revision."""
3110
 
    takes_options = [
3111
 
            'revision',
3112
 
            Option('long', help='Produce long-format testament.'),
3113
 
            Option('strict',
3114
 
                   help='Produce a strict-format testament.')]
 
1757
    takes_options = ['revision', 'long']
3115
1758
    takes_args = ['branch?']
3116
1759
    @display_command
3117
 
    def run(self, branch=u'.', revision=None, long=False, strict=False):
3118
 
        from bzrlib.testament import Testament, StrictTestament
3119
 
        if strict is True:
3120
 
            testament_class = StrictTestament
3121
 
        else:
3122
 
            testament_class = Testament
3123
 
        b = WorkingTree.open_containing(branch)[0].branch
 
1760
    def run(self, branch='.', revision=None, long=False):
 
1761
        from bzrlib.testament import Testament
 
1762
        b = Branch.open_containing(branch)[0]
3124
1763
        b.lock_read()
3125
1764
        try:
3126
1765
            if revision is None:
3127
1766
                rev_id = b.last_revision()
3128
1767
            else:
3129
1768
                rev_id = revision[0].in_history(b).rev_id
3130
 
            t = testament_class.from_revision(b.repository, rev_id)
 
1769
            t = Testament.from_revision(b, rev_id)
3131
1770
            if long:
3132
1771
                sys.stdout.writelines(t.as_text_lines())
3133
1772
            else:
3146
1785
    shown only at the top, unless the --all option is given.
3147
1786
    """
3148
1787
    # TODO: annotate directories; showing when each file was last changed
 
1788
    # TODO: annotate a previous version of a file
3149
1789
    # TODO: if the working copy is modified, show annotations on that 
3150
1790
    #       with new uncommitted lines marked
3151
 
    aliases = ['ann', 'blame', 'praise']
 
1791
    aliases = ['blame', 'praise']
3152
1792
    takes_args = ['filename']
3153
 
    takes_options = [Option('all', help='Show annotations on all lines.'),
3154
 
                     Option('long', help='Show commit date in annotations.'),
3155
 
                     'revision',
3156
 
                     'show-ids',
 
1793
    takes_options = [Option('all', help='show annotations on all lines'),
 
1794
                     Option('long', help='show date in annotations'),
3157
1795
                     ]
3158
 
    encoding_type = 'exact'
3159
1796
 
3160
1797
    @display_command
3161
 
    def run(self, filename, all=False, long=False, revision=None,
3162
 
            show_ids=False):
 
1798
    def run(self, filename, all=False, long=False):
3163
1799
        from bzrlib.annotate import annotate_file
3164
 
        tree, relpath = WorkingTree.open_containing(filename)
3165
 
        branch = tree.branch
3166
 
        branch.lock_read()
 
1800
        b, relpath = Branch.open_containing(filename)
 
1801
        b.lock_read()
3167
1802
        try:
3168
 
            if revision is None:
3169
 
                revision_id = branch.last_revision()
3170
 
            elif len(revision) != 1:
3171
 
                raise errors.BzrCommandError('bzr annotate --revision takes exactly 1 argument')
3172
 
            else:
3173
 
                revision_id = revision[0].in_history(branch).rev_id
3174
 
            file_id = tree.path2id(relpath)
3175
 
            if file_id is None:
3176
 
                raise errors.NotVersionedError(filename)
3177
 
            tree = branch.repository.revision_tree(revision_id)
 
1803
            tree = WorkingTree(b.base, b)
 
1804
            tree = b.revision_tree(b.last_revision())
 
1805
            file_id = tree.inventory.path2id(relpath)
3178
1806
            file_version = tree.inventory[file_id].revision
3179
 
            annotate_file(branch, file_version, file_id, long, all, self.outf,
3180
 
                          show_ids=show_ids)
 
1807
            annotate_file(b, file_version, file_id, long, all, sys.stdout)
3181
1808
        finally:
3182
 
            branch.unlock()
 
1809
            b.unlock()
3183
1810
 
3184
1811
 
3185
1812
class cmd_re_sign(Command):
3187
1814
    # TODO be able to replace existing ones.
3188
1815
 
3189
1816
    hidden = True # is this right ?
3190
 
    takes_args = ['revision_id*']
 
1817
    takes_args = ['revision_id?']
3191
1818
    takes_options = ['revision']
3192
1819
    
3193
 
    def run(self, revision_id_list=None, revision=None):
 
1820
    def run(self, revision_id=None, revision=None):
 
1821
        import bzrlib.config as config
3194
1822
        import bzrlib.gpg as gpg
3195
 
        if revision_id_list is not None and revision is not None:
3196
 
            raise errors.BzrCommandError('You can only supply one of revision_id or --revision')
3197
 
        if revision_id_list is None and revision is None:
3198
 
            raise errors.BzrCommandError('You must supply either --revision or a revision_id')
3199
 
        b = WorkingTree.open_containing(u'.')[0].branch
3200
 
        gpg_strategy = gpg.GPGStrategy(b.get_config())
3201
 
        if revision_id_list is not None:
3202
 
            for revision_id in revision_id_list:
3203
 
                b.repository.sign_revision(revision_id, gpg_strategy)
 
1823
        if revision_id is not None and revision is not None:
 
1824
            raise BzrCommandError('You can only supply one of revision_id or --revision')
 
1825
        if revision_id is None and revision is None:
 
1826
            raise BzrCommandError('You must supply either --revision or a revision_id')
 
1827
        b = Branch.open_containing('.')[0]
 
1828
        gpg_strategy = gpg.GPGStrategy(config.BranchConfig(b))
 
1829
        if revision_id is not None:
 
1830
            b.sign_revision(revision_id, gpg_strategy)
3204
1831
        elif revision is not None:
3205
1832
            if len(revision) == 1:
3206
1833
                revno, rev_id = revision[0].in_history(b)
3207
 
                b.repository.sign_revision(rev_id, gpg_strategy)
 
1834
                b.sign_revision(rev_id, gpg_strategy)
3208
1835
            elif len(revision) == 2:
3209
1836
                # are they both on rh- if so we can walk between them
3210
1837
                # might be nice to have a range helper for arbitrary
3214
1841
                if to_revid is None:
3215
1842
                    to_revno = b.revno()
3216
1843
                if from_revno is None or to_revno is None:
3217
 
                    raise errors.BzrCommandError('Cannot sign a range of non-revision-history revisions')
 
1844
                    raise BzrCommandError('Cannot sign a range of non-revision-history revisions')
3218
1845
                for revno in range(from_revno, to_revno + 1):
3219
 
                    b.repository.sign_revision(b.get_rev_id(revno), 
3220
 
                                               gpg_strategy)
3221
 
            else:
3222
 
                raise errors.BzrCommandError('Please supply either one revision, or a range.')
3223
 
 
3224
 
 
3225
 
class cmd_bind(Command):
3226
 
    """Convert the current branch into a checkout of the supplied branch.
3227
 
 
3228
 
    Once converted into a checkout, commits must succeed on the master branch
3229
 
    before they will be applied to the local branch.
3230
 
    """
3231
 
 
3232
 
    _see_also = ['checkouts', 'unbind']
3233
 
    takes_args = ['location?']
3234
 
    takes_options = []
3235
 
 
3236
 
    def run(self, location=None):
3237
 
        b, relpath = Branch.open_containing(u'.')
3238
 
        if location is None:
3239
 
            try:
3240
 
                location = b.get_old_bound_location()
3241
 
            except errors.UpgradeRequired:
3242
 
                raise errors.BzrCommandError('No location supplied.  '
3243
 
                    'This format does not remember old locations.')
3244
 
            else:
3245
 
                if location is None:
3246
 
                    raise errors.BzrCommandError('No location supplied and no '
3247
 
                        'previous location known')
3248
 
        b_other = Branch.open(location)
3249
 
        try:
3250
 
            b.bind(b_other)
3251
 
        except errors.DivergedBranches:
3252
 
            raise errors.BzrCommandError('These branches have diverged.'
3253
 
                                         ' Try merging, and then bind again.')
3254
 
 
3255
 
 
3256
 
class cmd_unbind(Command):
3257
 
    """Convert the current checkout into a regular branch.
3258
 
 
3259
 
    After unbinding, the local branch is considered independent and subsequent
3260
 
    commits will be local only.
3261
 
    """
3262
 
 
3263
 
    _see_also = ['checkouts', 'bind']
3264
 
    takes_args = []
3265
 
    takes_options = []
3266
 
 
3267
 
    def run(self):
3268
 
        b, relpath = Branch.open_containing(u'.')
3269
 
        if not b.unbind():
3270
 
            raise errors.BzrCommandError('Local branch is not bound')
3271
 
 
3272
 
 
3273
 
class cmd_uncommit(Command):
3274
 
    """Remove the last committed revision.
3275
 
 
3276
 
    --verbose will print out what is being removed.
3277
 
    --dry-run will go through all the motions, but not actually
3278
 
    remove anything.
3279
 
    
3280
 
    In the future, uncommit will create a revision bundle, which can then
3281
 
    be re-applied.
3282
 
    """
3283
 
 
3284
 
    # TODO: jam 20060108 Add an option to allow uncommit to remove
3285
 
    # unreferenced information in 'branch-as-repository' branches.
3286
 
    # TODO: jam 20060108 Add the ability for uncommit to remove unreferenced
3287
 
    # information in shared branches as well.
3288
 
    _see_also = ['commit']
3289
 
    takes_options = ['verbose', 'revision',
3290
 
                    Option('dry-run', help='Don\'t actually make changes.'),
3291
 
                    Option('force', help='Say yes to all questions.')]
3292
 
    takes_args = ['location?']
3293
 
    aliases = []
3294
 
 
3295
 
    def run(self, location=None,
3296
 
            dry_run=False, verbose=False,
3297
 
            revision=None, force=False):
3298
 
        from bzrlib.log import log_formatter, show_log
3299
 
        import sys
3300
 
        from bzrlib.uncommit import uncommit
3301
 
 
3302
 
        if location is None:
3303
 
            location = u'.'
3304
 
        control, relpath = bzrdir.BzrDir.open_containing(location)
3305
 
        try:
3306
 
            tree = control.open_workingtree()
3307
 
            b = tree.branch
3308
 
        except (errors.NoWorkingTree, errors.NotLocalUrl):
3309
 
            tree = None
3310
 
            b = control.open_branch()
3311
 
 
3312
 
        rev_id = None
3313
 
        if revision is None:
3314
 
            revno = b.revno()
3315
 
        else:
3316
 
            # 'bzr uncommit -r 10' actually means uncommit
3317
 
            # so that the final tree is at revno 10.
3318
 
            # but bzrlib.uncommit.uncommit() actually uncommits
3319
 
            # the revisions that are supplied.
3320
 
            # So we need to offset it by one
3321
 
            revno = revision[0].in_history(b).revno+1
3322
 
 
3323
 
        if revno <= b.revno():
3324
 
            rev_id = b.get_rev_id(revno)
3325
 
        if rev_id is None:
3326
 
            self.outf.write('No revisions to uncommit.\n')
3327
 
            return 1
3328
 
 
3329
 
        lf = log_formatter('short',
3330
 
                           to_file=self.outf,
3331
 
                           show_timezone='original')
3332
 
 
3333
 
        show_log(b,
3334
 
                 lf,
3335
 
                 verbose=False,
3336
 
                 direction='forward',
3337
 
                 start_revision=revno,
3338
 
                 end_revision=b.revno())
3339
 
 
3340
 
        if dry_run:
3341
 
            print 'Dry-run, pretending to remove the above revisions.'
3342
 
            if not force:
3343
 
                val = raw_input('Press <enter> to continue')
3344
 
        else:
3345
 
            print 'The above revision(s) will be removed.'
3346
 
            if not force:
3347
 
                val = raw_input('Are you sure [y/N]? ')
3348
 
                if val.lower() not in ('y', 'yes'):
3349
 
                    print 'Canceled'
3350
 
                    return 0
3351
 
 
3352
 
        uncommit(b, tree=tree, dry_run=dry_run, verbose=verbose,
3353
 
                revno=revno)
3354
 
 
3355
 
 
3356
 
class cmd_break_lock(Command):
3357
 
    """Break a dead lock on a repository, branch or working directory.
3358
 
 
3359
 
    CAUTION: Locks should only be broken when you are sure that the process
3360
 
    holding the lock has been stopped.
3361
 
 
3362
 
    You can get information on what locks are open via the 'bzr info' command.
3363
 
    
3364
 
    example:
3365
 
        bzr break-lock
3366
 
    """
3367
 
    takes_args = ['location?']
3368
 
 
3369
 
    def run(self, location=None, show=False):
3370
 
        if location is None:
3371
 
            location = u'.'
3372
 
        control, relpath = bzrdir.BzrDir.open_containing(location)
3373
 
        try:
3374
 
            control.break_lock()
3375
 
        except NotImplementedError:
3376
 
            pass
3377
 
        
3378
 
 
3379
 
class cmd_wait_until_signalled(Command):
3380
 
    """Test helper for test_start_and_stop_bzr_subprocess_send_signal.
3381
 
 
3382
 
    This just prints a line to signal when it is ready, then blocks on stdin.
3383
 
    """
3384
 
 
3385
 
    hidden = True
3386
 
 
3387
 
    def run(self):
3388
 
        sys.stdout.write("running\n")
3389
 
        sys.stdout.flush()
3390
 
        sys.stdin.readline()
3391
 
 
3392
 
 
3393
 
class cmd_serve(Command):
3394
 
    """Run the bzr server."""
3395
 
 
3396
 
    aliases = ['server']
3397
 
 
3398
 
    takes_options = [
3399
 
        Option('inet',
3400
 
               help='Serve on stdin/out for use from inetd or sshd.'),
3401
 
        Option('port',
3402
 
               help='Listen for connections on nominated port of the form '
3403
 
                    '[hostname:]portnumber.  Passing 0 as the port number will '
3404
 
                    'result in a dynamically allocated port.  The default port is '
3405
 
                    '4155.',
3406
 
               type=str),
3407
 
        Option('directory',
3408
 
               help='Serve contents of this directory.',
3409
 
               type=unicode),
3410
 
        Option('allow-writes',
3411
 
               help='By default the server is a readonly server.  Supplying '
3412
 
                    '--allow-writes enables write access to the contents of '
3413
 
                    'the served directory and below.'
3414
 
                ),
3415
 
        ]
3416
 
 
3417
 
    def run(self, port=None, inet=False, directory=None, allow_writes=False):
3418
 
        from bzrlib.smart import medium, server
3419
 
        from bzrlib.transport import get_transport
3420
 
        from bzrlib.transport.chroot import ChrootServer
3421
 
        from bzrlib.transport.remote import BZR_DEFAULT_PORT, BZR_DEFAULT_INTERFACE
3422
 
        if directory is None:
3423
 
            directory = os.getcwd()
3424
 
        url = urlutils.local_path_to_url(directory)
3425
 
        if not allow_writes:
3426
 
            url = 'readonly+' + url
3427
 
        chroot_server = ChrootServer(get_transport(url))
3428
 
        chroot_server.setUp()
3429
 
        t = get_transport(chroot_server.get_url())
3430
 
        if inet:
3431
 
            smart_server = medium.SmartServerPipeStreamMedium(
3432
 
                sys.stdin, sys.stdout, t)
3433
 
        else:
3434
 
            host = BZR_DEFAULT_INTERFACE
3435
 
            if port is None:
3436
 
                port = BZR_DEFAULT_PORT
3437
 
            else:
3438
 
                if ':' in port:
3439
 
                    host, port = port.split(':')
3440
 
                port = int(port)
3441
 
            smart_server = server.SmartTCPServer(t, host=host, port=port)
3442
 
            print 'listening on port: ', smart_server.port
3443
 
            sys.stdout.flush()
3444
 
        # for the duration of this server, no UI output is permitted.
3445
 
        # note that this may cause problems with blackbox tests. This should
3446
 
        # be changed with care though, as we dont want to use bandwidth sending
3447
 
        # progress over stderr to smart server clients!
3448
 
        old_factory = ui.ui_factory
3449
 
        try:
3450
 
            ui.ui_factory = ui.SilentUIFactory()
3451
 
            smart_server.serve()
3452
 
        finally:
3453
 
            ui.ui_factory = old_factory
3454
 
 
3455
 
 
3456
 
class cmd_join(Command):
3457
 
    """Combine a subtree into its containing tree.
3458
 
    
3459
 
    This command is for experimental use only.  It requires the target tree
3460
 
    to be in dirstate-with-subtree format, which cannot be converted into
3461
 
    earlier formats.
3462
 
 
3463
 
    The TREE argument should be an independent tree, inside another tree, but
3464
 
    not part of it.  (Such trees can be produced by "bzr split", but also by
3465
 
    running "bzr branch" with the target inside a tree.)
3466
 
 
3467
 
    The result is a combined tree, with the subtree no longer an independant
3468
 
    part.  This is marked as a merge of the subtree into the containing tree,
3469
 
    and all history is preserved.
3470
 
 
3471
 
    If --reference is specified, the subtree retains its independence.  It can
3472
 
    be branched by itself, and can be part of multiple projects at the same
3473
 
    time.  But operations performed in the containing tree, such as commit
3474
 
    and merge, will recurse into the subtree.
3475
 
    """
3476
 
 
3477
 
    _see_also = ['split']
3478
 
    takes_args = ['tree']
3479
 
    takes_options = [
3480
 
            Option('reference', help='Join by reference.'),
3481
 
            ]
3482
 
    hidden = True
3483
 
 
3484
 
    def run(self, tree, reference=False):
3485
 
        sub_tree = WorkingTree.open(tree)
3486
 
        parent_dir = osutils.dirname(sub_tree.basedir)
3487
 
        containing_tree = WorkingTree.open_containing(parent_dir)[0]
3488
 
        repo = containing_tree.branch.repository
3489
 
        if not repo.supports_rich_root():
3490
 
            raise errors.BzrCommandError(
3491
 
                "Can't join trees because %s doesn't support rich root data.\n"
3492
 
                "You can use bzr upgrade on the repository."
3493
 
                % (repo,))
3494
 
        if reference:
3495
 
            try:
3496
 
                containing_tree.add_reference(sub_tree)
3497
 
            except errors.BadReferenceTarget, e:
3498
 
                # XXX: Would be better to just raise a nicely printable
3499
 
                # exception from the real origin.  Also below.  mbp 20070306
3500
 
                raise errors.BzrCommandError("Cannot join %s.  %s" %
3501
 
                                             (tree, e.reason))
3502
 
        else:
3503
 
            try:
3504
 
                containing_tree.subsume(sub_tree)
3505
 
            except errors.BadSubsumeSource, e:
3506
 
                raise errors.BzrCommandError("Cannot join %s.  %s" % 
3507
 
                                             (tree, e.reason))
3508
 
 
3509
 
 
3510
 
class cmd_split(Command):
3511
 
    """Split a tree into two trees.
3512
 
 
3513
 
    This command is for experimental use only.  It requires the target tree
3514
 
    to be in dirstate-with-subtree format, which cannot be converted into
3515
 
    earlier formats.
3516
 
 
3517
 
    The TREE argument should be a subdirectory of a working tree.  That
3518
 
    subdirectory will be converted into an independent tree, with its own
3519
 
    branch.  Commits in the top-level tree will not apply to the new subtree.
3520
 
    If you want that behavior, do "bzr join --reference TREE".
3521
 
    """
3522
 
 
3523
 
    _see_also = ['join']
3524
 
    takes_args = ['tree']
3525
 
 
3526
 
    hidden = True
3527
 
 
3528
 
    def run(self, tree):
3529
 
        containing_tree, subdir = WorkingTree.open_containing(tree)
3530
 
        sub_id = containing_tree.path2id(subdir)
3531
 
        if sub_id is None:
3532
 
            raise errors.NotVersionedError(subdir)
3533
 
        try:
3534
 
            containing_tree.extract(sub_id)
3535
 
        except errors.RootNotRich:
3536
 
            raise errors.UpgradeRequired(containing_tree.branch.base)
3537
 
 
3538
 
 
3539
 
 
3540
 
class cmd_merge_directive(Command):
3541
 
    """Generate a merge directive for auto-merge tools.
3542
 
 
3543
 
    A directive requests a merge to be performed, and also provides all the
3544
 
    information necessary to do so.  This means it must either include a
3545
 
    revision bundle, or the location of a branch containing the desired
3546
 
    revision.
3547
 
 
3548
 
    A submit branch (the location to merge into) must be supplied the first
3549
 
    time the command is issued.  After it has been supplied once, it will
3550
 
    be remembered as the default.
3551
 
 
3552
 
    A public branch is optional if a revision bundle is supplied, but required
3553
 
    if --diff or --plain is specified.  It will be remembered as the default
3554
 
    after the first use.
3555
 
    """
3556
 
 
3557
 
    takes_args = ['submit_branch?', 'public_branch?']
3558
 
 
3559
 
    takes_options = [
3560
 
        RegistryOption.from_kwargs('patch-type',
3561
 
            'The type of patch to include in the directive',
3562
 
            title='Patch type',
3563
 
            value_switches=True,
3564
 
            enum_switch=False,
3565
 
            bundle='Bazaar revision bundle (default).',
3566
 
            diff='Normal unified diff.',
3567
 
            plain='No patch, just directive.'),
3568
 
        Option('sign', help='GPG-sign the directive.'), 'revision',
3569
 
        Option('mail-to', type=str,
3570
 
            help='Instead of printing the directive, email to this address.'),
3571
 
        Option('message', type=str, short_name='m',
3572
 
            help='Message to use when committing this merge.')
3573
 
        ]
3574
 
 
3575
 
    encoding_type = 'exact'
3576
 
 
3577
 
    def run(self, submit_branch=None, public_branch=None, patch_type='bundle',
3578
 
            sign=False, revision=None, mail_to=None, message=None):
3579
 
        from bzrlib.revision import ensure_null, NULL_REVISION
3580
 
        if patch_type == 'plain':
3581
 
            patch_type = None
3582
 
        branch = Branch.open('.')
3583
 
        stored_submit_branch = branch.get_submit_branch()
3584
 
        if submit_branch is None:
3585
 
            submit_branch = stored_submit_branch
3586
 
        else:
3587
 
            if stored_submit_branch is None:
3588
 
                branch.set_submit_branch(submit_branch)
3589
 
        if submit_branch is None:
3590
 
            submit_branch = branch.get_parent()
3591
 
        if submit_branch is None:
3592
 
            raise errors.BzrCommandError('No submit branch specified or known')
3593
 
 
3594
 
        stored_public_branch = branch.get_public_branch()
3595
 
        if public_branch is None:
3596
 
            public_branch = stored_public_branch
3597
 
        elif stored_public_branch is None:
3598
 
            branch.set_public_branch(public_branch)
3599
 
        if patch_type != "bundle" and public_branch is None:
3600
 
            raise errors.BzrCommandError('No public branch specified or'
3601
 
                                         ' known')
3602
 
        if revision is not None:
3603
 
            if len(revision) != 1:
3604
 
                raise errors.BzrCommandError('bzr merge-directive takes '
3605
 
                    'exactly one revision identifier')
3606
 
            else:
3607
 
                revision_id = revision[0].in_history(branch).rev_id
3608
 
        else:
3609
 
            revision_id = branch.last_revision()
3610
 
        revision_id = ensure_null(revision_id)
3611
 
        if revision_id == NULL_REVISION:
3612
 
            raise errors.BzrCommandError('No revisions to bundle.')
3613
 
        directive = merge_directive.MergeDirective.from_objects(
3614
 
            branch.repository, revision_id, time.time(),
3615
 
            osutils.local_time_offset(), submit_branch,
3616
 
            public_branch=public_branch, patch_type=patch_type,
3617
 
            message=message)
3618
 
        if mail_to is None:
3619
 
            if sign:
3620
 
                self.outf.write(directive.to_signed(branch))
3621
 
            else:
3622
 
                self.outf.writelines(directive.to_lines())
3623
 
        else:
3624
 
            message = directive.to_email(mail_to, branch, sign)
3625
 
            s = SMTPConnection(branch.get_config())
3626
 
            s.send_email(message)
3627
 
 
3628
 
 
3629
 
class cmd_tag(Command):
3630
 
    """Create a tag naming a revision.
3631
 
    
3632
 
    Tags give human-meaningful names to revisions.  Commands that take a -r
3633
 
    (--revision) option can be given -rtag:X, where X is any previously
3634
 
    created tag.
3635
 
 
3636
 
    Tags are stored in the branch.  Tags are copied from one branch to another
3637
 
    along when you branch, push, pull or merge.
3638
 
 
3639
 
    It is an error to give a tag name that already exists unless you pass 
3640
 
    --force, in which case the tag is moved to point to the new revision.
3641
 
    """
3642
 
 
3643
 
    _see_also = ['commit', 'tags']
3644
 
    takes_args = ['tag_name']
3645
 
    takes_options = [
3646
 
        Option('delete',
3647
 
            help='Delete this tag rather than placing it.',
3648
 
            ),
3649
 
        Option('directory',
3650
 
            help='Branch in which to place the tag.',
3651
 
            short_name='d',
3652
 
            type=unicode,
3653
 
            ),
3654
 
        Option('force',
3655
 
            help='Replace existing tags.',
3656
 
            ),
3657
 
        'revision',
3658
 
        ]
3659
 
 
3660
 
    def run(self, tag_name,
3661
 
            delete=None,
3662
 
            directory='.',
3663
 
            force=None,
3664
 
            revision=None,
3665
 
            ):
3666
 
        branch, relpath = Branch.open_containing(directory)
3667
 
        branch.lock_write()
3668
 
        try:
3669
 
            if delete:
3670
 
                branch.tags.delete_tag(tag_name)
3671
 
                self.outf.write('Deleted tag %s.\n' % tag_name)
3672
 
            else:
3673
 
                if revision:
3674
 
                    if len(revision) != 1:
3675
 
                        raise errors.BzrCommandError(
3676
 
                            "Tags can only be placed on a single revision, "
3677
 
                            "not on a range")
3678
 
                    revision_id = revision[0].in_history(branch).rev_id
3679
 
                else:
3680
 
                    revision_id = branch.last_revision()
3681
 
                if (not force) and branch.tags.has_tag(tag_name):
3682
 
                    raise errors.TagAlreadyExists(tag_name)
3683
 
                branch.tags.set_tag(tag_name, revision_id)
3684
 
                self.outf.write('Created tag %s.\n' % tag_name)
3685
 
        finally:
3686
 
            branch.unlock()
3687
 
 
3688
 
 
3689
 
class cmd_tags(Command):
3690
 
    """List tags.
3691
 
 
3692
 
    This tag shows a table of tag names and the revisions they reference.
3693
 
    """
3694
 
 
3695
 
    _see_also = ['tag']
3696
 
    takes_options = [
3697
 
        Option('directory',
3698
 
            help='Branch whose tags should be displayed.',
3699
 
            short_name='d',
3700
 
            type=unicode,
3701
 
            ),
3702
 
    ]
3703
 
 
3704
 
    @display_command
3705
 
    def run(self,
3706
 
            directory='.',
3707
 
            ):
3708
 
        branch, relpath = Branch.open_containing(directory)
3709
 
        for tag_name, target in sorted(branch.tags.get_tag_dict().items()):
3710
 
            self.outf.write('%-20s %s\n' % (tag_name, target))
3711
 
 
3712
 
 
3713
 
# command-line interpretation helper for merge-related commands
3714
 
def _merge_helper(other_revision, base_revision,
3715
 
                  check_clean=True, ignore_zero=False,
3716
 
                  this_dir=None, backup_files=False,
3717
 
                  merge_type=None,
3718
 
                  file_list=None, show_base=False, reprocess=False,
3719
 
                  pull=False,
3720
 
                  pb=DummyProgress(),
3721
 
                  change_reporter=None,
3722
 
                  other_rev_id=None):
3723
 
    """Merge changes into a tree.
3724
 
 
3725
 
    base_revision
3726
 
        list(path, revno) Base for three-way merge.  
3727
 
        If [None, None] then a base will be automatically determined.
3728
 
    other_revision
3729
 
        list(path, revno) Other revision for three-way merge.
3730
 
    this_dir
3731
 
        Directory to merge changes into; '.' by default.
3732
 
    check_clean
3733
 
        If true, this_dir must have no uncommitted changes before the
3734
 
        merge begins.
3735
 
    ignore_zero - If true, suppress the "zero conflicts" message when 
3736
 
        there are no conflicts; should be set when doing something we expect
3737
 
        to complete perfectly.
3738
 
    file_list - If supplied, merge only changes to selected files.
3739
 
 
3740
 
    All available ancestors of other_revision and base_revision are
3741
 
    automatically pulled into the branch.
3742
 
 
3743
 
    The revno may be -1 to indicate the last revision on the branch, which is
3744
 
    the typical case.
3745
 
 
3746
 
    This function is intended for use from the command line; programmatic
3747
 
    clients might prefer to call merge.merge_inner(), which has less magic 
3748
 
    behavior.
3749
 
    """
3750
 
    # Loading it late, so that we don't always have to import bzrlib.merge
3751
 
    if merge_type is None:
3752
 
        merge_type = _mod_merge.Merge3Merger
3753
 
    if this_dir is None:
3754
 
        this_dir = u'.'
3755
 
    this_tree = WorkingTree.open_containing(this_dir)[0]
3756
 
    if show_base and not merge_type is _mod_merge.Merge3Merger:
3757
 
        raise errors.BzrCommandError("Show-base is not supported for this merge"
3758
 
                                     " type. %s" % merge_type)
3759
 
    if reprocess and not merge_type.supports_reprocess:
3760
 
        raise errors.BzrCommandError("Conflict reduction is not supported for merge"
3761
 
                                     " type %s." % merge_type)
3762
 
    if reprocess and show_base:
3763
 
        raise errors.BzrCommandError("Cannot do conflict reduction and show base.")
3764
 
    # TODO: jam 20070226 We should really lock these trees earlier. However, we
3765
 
    #       only want to take out a lock_tree_write() if we don't have to pull
3766
 
    #       any ancestry. But merge might fetch ancestry in the middle, in
3767
 
    #       which case we would need a lock_write().
3768
 
    #       Because we cannot upgrade locks, for now we live with the fact that
3769
 
    #       the tree will be locked multiple times during a merge. (Maybe
3770
 
    #       read-only some of the time, but it means things will get read
3771
 
    #       multiple times.)
3772
 
    try:
3773
 
        merger = _mod_merge.Merger(this_tree.branch, this_tree=this_tree,
3774
 
                                   pb=pb, change_reporter=change_reporter)
3775
 
        merger.pp = ProgressPhase("Merge phase", 5, pb)
3776
 
        merger.pp.next_phase()
3777
 
        merger.check_basis(check_clean)
3778
 
        if other_rev_id is not None:
3779
 
            merger.set_other_revision(other_rev_id, this_tree.branch)
3780
 
        else:
3781
 
            merger.set_other(other_revision)
3782
 
        merger.pp.next_phase()
3783
 
        merger.set_base(base_revision)
3784
 
        if merger.base_rev_id == merger.other_rev_id:
3785
 
            note('Nothing to do.')
3786
 
            return 0
3787
 
        if file_list is None:
3788
 
            if pull and merger.base_rev_id == merger.this_rev_id:
3789
 
                # FIXME: deduplicate with pull
3790
 
                result = merger.this_tree.pull(merger.this_branch,
3791
 
                        False, merger.other_rev_id)
3792
 
                if result.old_revid == result.new_revid:
3793
 
                    note('No revisions to pull.')
3794
 
                else:
3795
 
                    note('Now on revision %d.' % result.new_revno)
3796
 
                return 0
3797
 
        merger.backup_files = backup_files
3798
 
        merger.merge_type = merge_type 
3799
 
        merger.set_interesting_files(file_list)
3800
 
        merger.show_base = show_base 
3801
 
        merger.reprocess = reprocess
3802
 
        conflicts = merger.do_merge()
3803
 
        if file_list is None:
3804
 
            merger.set_pending()
3805
 
    finally:
3806
 
        pb.clear()
3807
 
    return conflicts
3808
 
 
3809
 
 
3810
 
def _create_prefix(cur_transport):
3811
 
    needed = [cur_transport]
3812
 
    # Recurse upwards until we can create a directory successfully
3813
 
    while True:
3814
 
        new_transport = cur_transport.clone('..')
3815
 
        if new_transport.base == cur_transport.base:
3816
 
            raise errors.BzrCommandError(
3817
 
                "Failed to create path prefix for %s."
3818
 
                % cur_transport.base)
3819
 
        try:
3820
 
            new_transport.mkdir('.')
3821
 
        except errors.NoSuchFile:
3822
 
            needed.append(new_transport)
3823
 
            cur_transport = new_transport
3824
 
        else:
3825
 
            break
3826
 
    # Now we only need to create child directories
3827
 
    while needed:
3828
 
        cur_transport = needed.pop()
3829
 
        cur_transport.ensure_base()
3830
 
 
3831
 
 
3832
 
# Compatibility
3833
 
merge = _merge_helper
 
1846
                    b.sign_revision(b.get_rev_id(revno), gpg_strategy)
 
1847
            else:
 
1848
                raise BzrCommandError('Please supply either one revision, or a range.')
3834
1849
 
3835
1850
 
3836
1851
# these get imported and then picked up by the scan for cmd_*
3837
1852
# TODO: Some more consistent way to split command definitions across files;
3838
1853
# we do need to load at least some information about them to know of 
3839
 
# aliases.  ideally we would avoid loading the implementation until the
3840
 
# details were needed.
3841
 
from bzrlib.cmd_version_info import cmd_version_info
 
1854
# aliases.
3842
1855
from bzrlib.conflicts import cmd_resolve, cmd_conflicts, restore
3843
 
from bzrlib.bundle.commands import cmd_bundle_revisions
3844
 
from bzrlib.sign_my_commits import cmd_sign_my_commits
3845
 
from bzrlib.weave_commands import cmd_versionedfile_list, cmd_weave_join, \
3846
 
        cmd_weave_plan_merge, cmd_weave_merge_text