14
14
# along with this program; if not, write to the Free Software
15
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17
"""builtin brz commands"""
19
from __future__ import absolute_import
17
"""builtin bzr commands"""
21
from bzrlib.lazy_import import lazy_import
22
lazy_import(globals(), """
32
from . import lazy_import
33
lazy_import.lazy_import(globals(), """
38
branch as _mod_branch,
44
config as _mod_config,
50
41
merge as _mod_merge,
51
mergeable as _mod_mergeable,
56
46
revision as _mod_revision,
65
from breezy.branch import Branch
66
from breezy.transport import memory
67
from breezy.smtp_connection import SMTPConnection
68
from breezy.workingtree import WorkingTree
69
from breezy.i18n import gettext, ngettext
55
from bzrlib.branch import Branch
56
from bzrlib.conflicts import ConflictList
57
from bzrlib.transport import memory
58
from bzrlib.revisionspec import RevisionSpec, RevisionInfo
59
from bzrlib.smtp_connection import SMTPConnection
60
from bzrlib.workingtree import WorkingTree
72
from .commands import (
63
from bzrlib.commands import (
74
65
builtin_command_registry,
68
from bzrlib.option import (
82
73
_parse_revision_str,
84
from .revisionspec import (
94
from .trace import mutter, note, warning, is_quiet, get_verbosity_level
97
def _get_branch_location(control_dir, possible_transports=None):
98
"""Return location of branch for this control dir."""
100
target = control_dir.get_branch_reference()
101
except errors.NotBranchError:
102
return control_dir.root_transport.base
103
if target is not None:
105
this_branch = control_dir.open_branch(
106
possible_transports=possible_transports)
107
# This may be a heavy checkout, where we want the master branch
108
master_location = this_branch.get_bound_location()
109
if master_location is not None:
110
return master_location
111
# If not, use a local sibling
112
return this_branch.base
115
def _is_colocated(control_dir, possible_transports=None):
116
"""Check if the branch in control_dir is colocated.
118
:param control_dir: Control directory
119
:return: Tuple with boolean indicating whether the branch is colocated
120
and the full URL to the actual branch
122
# This path is meant to be relative to the existing branch
123
this_url = _get_branch_location(
124
control_dir, possible_transports=possible_transports)
125
# Perhaps the target control dir supports colocated branches?
127
root = controldir.ControlDir.open(
128
this_url, possible_transports=possible_transports)
129
except errors.NotBranchError:
130
return (False, this_url)
133
control_dir.open_workingtree()
134
except (errors.NoWorkingTree, errors.NotLocalUrl):
135
return (False, this_url)
138
root._format.colocated_branches and
139
control_dir.control_url == root.control_url,
143
def lookup_new_sibling_branch(control_dir, location, possible_transports=None):
144
"""Lookup the location for a new sibling branch.
146
:param control_dir: Control directory to find sibling branches from
147
:param location: Name of the new branch
148
:return: Full location to the new branch
150
location = directory_service.directories.dereference(location)
151
if '/' not in location and '\\' not in location:
152
(colocated, this_url) = _is_colocated(control_dir, possible_transports)
155
return urlutils.join_segment_parameters(
156
this_url, {"branch": urlutils.escape(location)})
158
return urlutils.join(this_url, '..', urlutils.escape(location))
162
def open_sibling_branch(control_dir, location, possible_transports=None):
163
"""Open a branch, possibly a sibling of another.
165
:param control_dir: Control directory relative to which to lookup the
167
:param location: Location to look up
168
:return: branch to open
171
# Perhaps it's a colocated branch?
172
return control_dir.open_branch(
173
location, possible_transports=possible_transports)
174
except (errors.NotBranchError, errors.NoColocatedBranchSupport):
175
this_url = _get_branch_location(control_dir)
178
this_url, '..', urlutils.escape(location)))
181
def open_nearby_branch(near=None, location=None, possible_transports=None):
182
"""Open a nearby branch.
184
:param near: Optional location of container from which to open branch
185
:param location: Location of the branch
186
:return: Branch instance
193
location, possible_transports=possible_transports)
194
except errors.NotBranchError:
196
cdir = controldir.ControlDir.open(
197
near, possible_transports=possible_transports)
198
return open_sibling_branch(
199
cdir, location, possible_transports=possible_transports)
202
def iter_sibling_branches(control_dir, possible_transports=None):
203
"""Iterate over the siblings of a branch.
205
:param control_dir: Control directory for which to look up the siblings
206
:return: Iterator over tuples with branch name and branch object
209
reference = control_dir.get_branch_reference()
210
except errors.NotBranchError:
212
if reference is not None:
214
ref_branch = Branch.open(
215
reference, possible_transports=possible_transports)
216
except errors.NotBranchError:
220
if ref_branch is None or ref_branch.name:
221
if ref_branch is not None:
222
control_dir = ref_branch.controldir
223
for name, branch in viewitems(control_dir.get_branches()):
226
repo = ref_branch.controldir.find_repository()
227
for branch in repo.find_branches(using=True):
228
name = urlutils.relative_url(
229
repo.user_url, branch.user_url).rstrip("/")
75
from bzrlib.trace import mutter, note, warning, is_quiet, get_verbosity_level
78
def tree_files(file_list, default_branch=u'.', canonicalize=True,
81
return internal_tree_files(file_list, default_branch, canonicalize,
83
except errors.FileInWrongBranch, e:
84
raise errors.BzrCommandError("%s is not in the same branch as %s" %
85
(e.path, file_list[0]))
233
88
def tree_files_for_add(file_list):
435
342
takes_args = ['revision_id?']
436
takes_options = ['directory', 'revision']
343
takes_options = ['revision']
437
344
# cat-revision is more for frontends so should be exact
438
345
encoding = 'strict'
440
347
def print_revision(self, revisions, revid):
441
348
stream = revisions.get_record_stream([(revid,)], 'unordered', True)
442
record = next(stream)
349
record = stream.next()
443
350
if record.storage_kind == 'absent':
444
351
raise errors.NoSuchRevision(revisions, revid)
445
352
revtext = record.get_bytes_as('fulltext')
446
353
self.outf.write(revtext.decode('utf-8'))
449
def run(self, revision_id=None, revision=None, directory=u'.'):
356
def run(self, revision_id=None, revision=None):
450
357
if revision_id is not None and revision is not None:
451
raise errors.CommandError(gettext('You can only supply one of'
452
' revision_id or --revision'))
358
raise errors.BzrCommandError('You can only supply one of'
359
' revision_id or --revision')
453
360
if revision_id is None and revision is None:
454
raise errors.CommandError(
455
gettext('You must supply either --revision or a revision_id'))
457
b = controldir.ControlDir.open_containing_tree_or_branch(directory)[1]
459
revisions = getattr(b.repository, "revisions", None)
361
raise errors.BzrCommandError('You must supply either'
362
' --revision or a revision_id')
363
b = WorkingTree.open_containing(u'.')[0].branch
365
revisions = b.repository.revisions
460
366
if revisions is None:
461
raise errors.CommandError(
462
gettext('Repository %r does not support '
463
'access to raw revision texts') % b.repository)
367
raise errors.BzrCommandError('Repository %r does not support '
368
'access to raw revision texts')
465
with b.repository.lock_read():
370
b.repository.lock_read()
466
372
# TODO: jam 20060112 should cat-revision always output utf-8?
467
373
if revision_id is not None:
468
revision_id = cache_utf8.encode(revision_id)
374
revision_id = osutils.safe_revision_id(revision_id, warn=False)
470
376
self.print_revision(revisions, revision_id)
471
377
except errors.NoSuchRevision:
473
"The repository {0} contains no revision {1}.").format(
474
b.repository.base, revision_id.decode('utf-8'))
475
raise errors.CommandError(msg)
378
msg = "The repository %s contains no revision %s." % (
379
b.repository.base, revision_id)
380
raise errors.BzrCommandError(msg)
476
381
elif revision is not None:
477
382
for rev in revision:
479
raise errors.CommandError(
480
gettext('You cannot specify a NULL revision.'))
384
raise errors.BzrCommandError(
385
'You cannot specify a NULL revision.')
481
386
rev_id = rev.as_revision_id(b)
482
387
self.print_revision(revisions, rev_id)
389
b.repository.unlock()
392
class cmd_dump_btree(Command):
393
__doc__ = """Dump the contents of a btree index file to stdout.
395
PATH is a btree index file, it can be any URL. This includes things like
396
.bzr/repository/pack-names, or .bzr/repository/indices/a34b3a...ca4a4.iix
398
By default, the tuples stored in the index file will be displayed. With
399
--raw, we will uncompress the pages, but otherwise display the raw bytes
403
# TODO: Do we want to dump the internal nodes as well?
404
# TODO: It would be nice to be able to dump the un-parsed information,
405
# rather than only going through iter_all_entries. However, this is
406
# good enough for a start
408
encoding_type = 'exact'
409
takes_args = ['path']
410
takes_options = [Option('raw', help='Write the uncompressed bytes out,'
411
' rather than the parsed tuples.'),
414
def run(self, path, raw=False):
415
dirname, basename = osutils.split(path)
416
t = transport.get_transport(dirname)
418
self._dump_raw_bytes(t, basename)
420
self._dump_entries(t, basename)
422
def _get_index_and_bytes(self, trans, basename):
423
"""Create a BTreeGraphIndex and raw bytes."""
424
bt = btree_index.BTreeGraphIndex(trans, basename, None)
425
bytes = trans.get_bytes(basename)
426
bt._file = cStringIO.StringIO(bytes)
427
bt._size = len(bytes)
430
def _dump_raw_bytes(self, trans, basename):
433
# We need to parse at least the root node.
434
# This is because the first page of every row starts with an
435
# uncompressed header.
436
bt, bytes = self._get_index_and_bytes(trans, basename)
437
for page_idx, page_start in enumerate(xrange(0, len(bytes),
438
btree_index._PAGE_SIZE)):
439
page_end = min(page_start + btree_index._PAGE_SIZE, len(bytes))
440
page_bytes = bytes[page_start:page_end]
442
self.outf.write('Root node:\n')
443
header_end, data = bt._parse_header_from_bytes(page_bytes)
444
self.outf.write(page_bytes[:header_end])
446
self.outf.write('\nPage %d\n' % (page_idx,))
447
decomp_bytes = zlib.decompress(page_bytes)
448
self.outf.write(decomp_bytes)
449
self.outf.write('\n')
451
def _dump_entries(self, trans, basename):
453
st = trans.stat(basename)
454
except errors.TransportNotPossible:
455
# We can't stat, so we'll fake it because we have to do the 'get()'
457
bt, _ = self._get_index_and_bytes(trans, basename)
459
bt = btree_index.BTreeGraphIndex(trans, basename, st.st_size)
460
for node in bt.iter_all_entries():
461
# Node is made up of:
462
# (index, key, value, [references])
466
refs_as_tuples = None
468
refs_as_tuples = static_tuple.as_tuples(refs)
469
as_tuple = (tuple(node[1]), node[2], refs_as_tuples)
470
self.outf.write('%s\n' % (as_tuple,))
485
473
class cmd_remove_tree(Command):
488
476
Since a lightweight checkout is little more than a working tree
489
477
this will refuse to run against one.
491
To re-create the working tree, use "brz checkout".
479
To re-create the working tree, use "bzr checkout".
493
481
_see_also = ['checkout', 'working-trees']
494
482
takes_args = ['location*']
495
483
takes_options = [
497
485
help='Remove the working tree even if it has '
498
'uncommitted or shelved changes.'),
486
'uncommitted changes.'),
501
489
def run(self, location_list, force=False):
502
490
if not location_list:
503
location_list = ['.']
505
493
for location in location_list:
506
d = controldir.ControlDir.open(location)
494
d = bzrdir.BzrDir.open(location)
509
497
working = d.open_workingtree()
510
498
except errors.NoWorkingTree:
511
raise errors.CommandError(
512
gettext("No working tree to remove"))
499
raise errors.BzrCommandError("No working tree to remove")
513
500
except errors.NotLocalUrl:
514
raise errors.CommandError(
515
gettext("You cannot remove the working tree"
516
" of a remote path"))
501
raise errors.BzrCommandError("You cannot remove the working tree"
518
504
if (working.has_changes()):
519
505
raise errors.UncommittedChanges(working)
520
if working.get_shelf_manager().last_shelf() is not None:
521
raise errors.ShelvedChanges(working)
523
507
if working.user_url != working.branch.user_url:
524
raise errors.CommandError(
525
gettext("You cannot remove the working tree"
526
" from a lightweight checkout"))
508
raise errors.BzrCommandError("You cannot remove the working tree"
509
" from a lightweight checkout")
528
511
d.destroy_workingtree()
531
class cmd_repair_workingtree(Command):
532
__doc__ = """Reset the working tree state file.
534
This is not meant to be used normally, but more as a way to recover from
535
filesystem corruption, etc. This rebuilds the working inventory back to a
536
'known good' state. Any new modifications (adding a file, renaming, etc)
537
will be lost, though modified files will still be detected as such.
539
Most users will want something more like "brz revert" or "brz update"
540
unless the state file has become corrupted.
542
By default this attempts to recover the current state by looking at the
543
headers of the state file. If the state file is too corrupted to even do
544
that, you can supply --revision to force the state of the tree.
548
'revision', 'directory',
550
help='Reset the tree even if it doesn\'t appear to be'
555
def run(self, revision=None, directory='.', force=False):
556
tree, _ = WorkingTree.open_containing(directory)
557
self.enter_context(tree.lock_tree_write())
561
except errors.BzrError:
562
pass # There seems to be a real error here, so we'll reset
565
raise errors.CommandError(gettext(
566
'The tree does not appear to be corrupt. You probably'
567
' want "brz revert" instead. Use "--force" if you are'
568
' sure you want to reset the working tree.'))
572
revision_ids = [r.as_revision_id(tree.branch) for r in revision]
574
tree.reset_state(revision_ids)
575
except errors.BzrError:
576
if revision_ids is None:
577
extra = gettext(', the header appears corrupt, try passing '
578
'-r -1 to set the state to the last commit')
581
raise errors.CommandError(
582
gettext('failed to reset the tree state{0}').format(extra))
585
514
class cmd_revno(Command):
586
515
__doc__ = """Show current revision number.
865
742
takes_options = [
868
Option('include-root',
869
help='Include the entry for the root of the tree, if any.'),
871
help='List entries of a particular kind: file, directory, '
746
help='List entries of a particular kind: file, directory, symlink.',
875
749
takes_args = ['file*']
878
def run(self, revision=None, show_ids=False, kind=None, include_root=False,
752
def run(self, revision=None, show_ids=False, kind=None, file_list=None):
880
753
if kind and kind not in ['file', 'directory', 'symlink']:
881
raise errors.CommandError(
882
gettext('invalid kind %r specified') % (kind,))
754
raise errors.BzrCommandError('invalid kind %r specified' % (kind,))
884
756
revision = _get_one_revision('inventory', revision)
885
work_tree, file_list = WorkingTree.open_containing_paths(file_list)
886
self.enter_context(work_tree.lock_read())
757
work_tree, file_list = tree_files(file_list)
758
self.add_cleanup(work_tree.lock_read().unlock)
887
759
if revision is not None:
888
760
tree = revision.as_tree(work_tree.branch)
890
762
extra_trees = [work_tree]
891
self.enter_context(tree.lock_read())
763
self.add_cleanup(tree.lock_read().unlock)
896
self.enter_context(tree.lock_read())
897
768
if file_list is not None:
898
paths = tree.find_related_paths_across_trees(
899
file_list, extra_trees, require_versioned=True)
769
file_ids = tree.paths2ids(file_list, trees=extra_trees,
770
require_versioned=True)
900
771
# find_ids_across_trees may include some paths that don't
901
772
# exist in 'tree'.
902
entries = tree.iter_entries_by_dir(specific_files=paths)
773
entries = sorted((tree.id2path(file_id), tree.inventory[file_id])
774
for file_id in file_ids if file_id in tree)
904
entries = tree.iter_entries_by_dir()
776
entries = tree.inventory.entries()
906
for path, entry in sorted(entries):
779
for path, entry in entries:
907
780
if kind and kind != entry.kind:
909
if path == "" and not include_root:
912
self.outf.write('%-50s %s\n' % (
913
path, entry.file_id.decode('utf-8')))
783
self.outf.write('%-50s %s\n' % (path, entry.file_id))
915
785
self.outf.write(path)
916
786
self.outf.write('\n')
919
class cmd_cp(Command):
920
__doc__ = """Copy a file.
923
brz cp OLDNAME NEWNAME
925
brz cp SOURCE... DESTINATION
927
If the last argument is a versioned directory, all the other names
928
are copied into it. Otherwise, there must be exactly two arguments
929
and the file is copied to a new name.
931
Files cannot be copied between branches. Only files can be copied
935
takes_args = ['names*']
938
encoding_type = 'replace'
940
def run(self, names_list):
941
if names_list is None:
943
if len(names_list) < 2:
944
raise errors.CommandError(gettext("missing file argument"))
945
tree, rel_names = WorkingTree.open_containing_paths(
946
names_list, canonicalize=False)
947
for file_name in rel_names[0:-1]:
949
raise errors.CommandError(
950
gettext("can not copy root of branch"))
951
self.enter_context(tree.lock_tree_write())
952
into_existing = osutils.isdir(names_list[-1])
953
if not into_existing:
955
(src, dst) = rel_names
957
raise errors.CommandError(
958
gettext('to copy multiple files the'
959
' destination must be a versioned'
964
(n, osutils.joinpath([rel_names[-1], osutils.basename(n)]))
965
for n in rel_names[:-1]]
967
for src, dst in pairs:
969
src_kind = tree.stored_kind(src)
970
except errors.NoSuchFile:
971
raise errors.CommandError(
972
gettext('Could not copy %s => %s: %s is not versioned.')
975
raise errors.CommandError(
976
gettext('Could not copy %s => %s . %s is not versioned\\.'
978
if src_kind == 'directory':
979
raise errors.CommandError(
980
gettext('Could not copy %s => %s . %s is a directory.'
982
dst_parent = osutils.split(dst)[0]
985
dst_parent_kind = tree.stored_kind(dst_parent)
986
except errors.NoSuchFile:
987
raise errors.CommandError(
988
gettext('Could not copy %s => %s: %s is not versioned.')
989
% (src, dst, dst_parent))
990
if dst_parent_kind != 'directory':
991
raise errors.CommandError(
992
gettext('Could not copy to %s: %s is not a directory.')
993
% (dst_parent, dst_parent))
995
tree.copy_one(src, dst)
998
789
class cmd_mv(Command):
999
790
__doc__ = """Move or rename a file.
1002
brz mv OLDNAME NEWNAME
793
bzr mv OLDNAME NEWNAME
1004
brz mv SOURCE... DESTINATION
795
bzr mv SOURCE... DESTINATION
1006
797
If the last argument is a versioned directory, all the other names
1007
798
are moved into it. Otherwise, there must be exactly two arguments
1298
1058
considered diverged if the destination branch's most recent commit is one
1299
1059
that has not been merged (directly or indirectly) by the source branch.
1301
If branches have diverged, you can use 'brz push --overwrite' to replace
1061
If branches have diverged, you can use 'bzr push --overwrite' to replace
1302
1062
the other branch completely, discarding its unmerged changes.
1304
1064
If you want to ensure you have the different changes in the other branch,
1305
do a merge (see brz help merge) from the other branch, and commit that.
1065
do a merge (see bzr help merge) from the other branch, and commit that.
1306
1066
After that you will be able to do a push without '--overwrite'.
1308
If there is no default push location set, the first push will set it (use
1309
--no-remember to avoid setting it). After that, you can omit the
1310
location to use the default. To change the default, use --remember. The
1311
value will only be saved if the remote location can be accessed.
1313
The --verbose option will display the revisions pushed using the log_format
1314
configuration option. You can use a different format by overriding it with
1315
-Olog_format=<other_format>.
1068
If there is no default push location set, the first push will set it.
1069
After that, you can omit the location to use the default. To change the
1070
default, use --remember. The value will only be saved if the remote
1071
location can be accessed.
1318
1074
_see_also = ['pull', 'update', 'working-trees']
1319
1075
takes_options = ['remember', 'overwrite', 'verbose', 'revision',
1320
Option('create-prefix',
1321
help='Create the path leading up to the branch '
1322
'if it does not already exist.'),
1323
custom_help('directory',
1324
help='Branch to push from, '
1325
'rather than the one containing the working directory.'),
1326
Option('use-existing-dir',
1327
help='By default push will fail if the target'
1328
' directory exists, but does not already'
1329
' have a control directory. This flag will'
1330
' allow push to proceed.'),
1332
help='Create a stacked branch that references the public location '
1333
'of the parent branch.'),
1334
Option('stacked-on',
1335
help='Create a stacked branch that refers to another branch '
1336
'for the commit history. Only the work not present in the '
1337
'referenced branch is included in the branch created.',
1340
help='Refuse to push if there are uncommitted changes in'
1341
' the working tree, --no-strict disables the check.'),
1343
help="Don't populate the working tree, even for protocols"
1344
" that support it."),
1345
Option('overwrite-tags',
1346
help="Overwrite tags only."),
1347
Option('lossy', help="Allow lossy push, i.e. dropping metadata "
1348
"that can't be represented in the target.")
1076
Option('create-prefix',
1077
help='Create the path leading up to the branch '
1078
'if it does not already exist.'),
1080
help='Branch to push from, '
1081
'rather than the one containing the working directory.',
1085
Option('use-existing-dir',
1086
help='By default push will fail if the target'
1087
' directory exists, but does not already'
1088
' have a control directory. This flag will'
1089
' allow push to proceed.'),
1091
help='Create a stacked branch that references the public location '
1092
'of the parent branch.'),
1093
Option('stacked-on',
1094
help='Create a stacked branch that refers to another branch '
1095
'for the commit history. Only the work not present in the '
1096
'referenced branch is included in the branch created.',
1099
help='Refuse to push if there are uncommitted changes in'
1100
' the working tree, --no-strict disables the check.'),
1350
1102
takes_args = ['location?']
1351
1103
encoding_type = 'replace'
1353
def run(self, location=None, remember=None, overwrite=False,
1354
create_prefix=False, verbose=False, revision=None,
1355
use_existing_dir=False, directory=None, stacked_on=None,
1356
stacked=False, strict=None, no_tree=False,
1357
overwrite_tags=False, lossy=False):
1358
from .location import location_to_url
1359
from .push import _show_push_branch
1362
overwrite = ["history", "tags"]
1363
elif overwrite_tags:
1364
overwrite = ["tags"]
1105
def run(self, location=None, remember=False, overwrite=False,
1106
create_prefix=False, verbose=False, revision=None,
1107
use_existing_dir=False, directory=None, stacked_on=None,
1108
stacked=False, strict=None):
1109
from bzrlib.push import _show_push_branch
1368
1111
if directory is None:
1369
1112
directory = '.'
1370
1113
# Get the source branch
1371
1114
(tree, br_from,
1372
_unused) = controldir.ControlDir.open_containing_tree_or_branch(directory)
1115
_unused) = bzrdir.BzrDir.open_containing_tree_or_branch(directory)
1373
1116
# Get the tip's revision_id
1374
1117
revision = _get_one_revision('push', revision)
1375
1118
if revision is not None:
1441
1174
parameter, as in "branch foo/bar -r 5".
1445
1177
_see_also = ['checkout']
1446
1178
takes_args = ['from_location', 'to_location?']
1447
takes_options = ['revision',
1449
'hardlink', help='Hard-link working tree files where possible.'),
1450
Option('files-from', type=text_type,
1451
help="Get file contents from this tree."),
1453
help="Create a branch without a working-tree."),
1455
help="Switch the checkout in the current directory "
1456
"to the new branch."),
1458
help='Create a stacked branch referring to the source branch. '
1459
'The new branch will depend on the availability of the source '
1460
'branch for all operations.'),
1461
Option('standalone',
1462
help='Do not use a shared repository, even if available.'),
1463
Option('use-existing-dir',
1464
help='By default branch will fail if the target'
1465
' directory exists, but does not already'
1466
' have a control directory. This flag will'
1467
' allow branch to proceed.'),
1469
help="Bind new branch to from location."),
1470
Option('no-recurse-nested',
1471
help='Do not recursively check out nested trees.'),
1472
Option('colocated-branch', short_name='b',
1473
type=str, help='Name of colocated branch to sprout.'),
1179
takes_options = ['revision', Option('hardlink',
1180
help='Hard-link working tree files where possible.'),
1182
help="Create a branch without a working-tree."),
1184
help="Switch the checkout in the current directory "
1185
"to the new branch."),
1187
help='Create a stacked branch referring to the source branch. '
1188
'The new branch will depend on the availability of the source '
1189
'branch for all operations.'),
1190
Option('standalone',
1191
help='Do not use a shared repository, even if available.'),
1192
Option('use-existing-dir',
1193
help='By default branch will fail if the target'
1194
' directory exists, but does not already'
1195
' have a control directory. This flag will'
1196
' allow branch to proceed.'),
1198
help="Bind new branch to from location."),
1200
aliases = ['get', 'clone']
1476
1202
def run(self, from_location, to_location=None, revision=None,
1477
1203
hardlink=False, stacked=False, standalone=False, no_tree=False,
1478
use_existing_dir=False, switch=False, bind=False,
1479
files_from=None, no_recurse_nested=False, colocated_branch=None):
1480
from breezy import switch as _mod_switch
1481
accelerator_tree, br_from = controldir.ControlDir.open_tree_or_branch(
1482
from_location, name=colocated_branch)
1483
if no_recurse_nested:
1487
if not (hardlink or files_from):
1488
# accelerator_tree is usually slower because you have to read N
1489
# files (no readahead, lots of seeks, etc), but allow the user to
1490
# explicitly request it
1491
accelerator_tree = None
1492
if files_from is not None and files_from != from_location:
1493
accelerator_tree = WorkingTree.open(files_from)
1204
use_existing_dir=False, switch=False, bind=False):
1205
from bzrlib import switch as _mod_switch
1206
from bzrlib.tag import _merge_tags_if_possible
1207
accelerator_tree, br_from = bzrdir.BzrDir.open_tree_or_branch(
1494
1209
revision = _get_one_revision('branch', revision)
1495
self.enter_context(br_from.lock_read())
1210
self.add_cleanup(br_from.lock_read().unlock)
1496
1211
if revision is not None:
1497
1212
revision_id = revision.as_revision_id(br_from)
1502
1217
revision_id = br_from.last_revision()
1503
1218
if to_location is None:
1504
1219
to_location = urlutils.derive_to_location(from_location)
1505
to_transport = transport.get_transport(to_location, purpose='write')
1220
to_transport = transport.get_transport(to_location)
1507
1222
to_transport.mkdir('.')
1508
1223
except errors.FileExists:
1510
to_dir = controldir.ControlDir.open_from_transport(
1512
except errors.NotBranchError:
1513
if not use_existing_dir:
1514
raise errors.CommandError(gettext('Target directory "%s" '
1515
'already exists.') % to_location)
1224
if not use_existing_dir:
1225
raise errors.BzrCommandError('Target directory "%s" '
1226
'already exists.' % to_location)
1520
to_dir.open_branch()
1229
bzrdir.BzrDir.open_from_transport(to_transport)
1521
1230
except errors.NotBranchError:
1524
1233
raise errors.AlreadyBranchError(to_location)
1525
1234
except errors.NoSuchFile:
1526
raise errors.CommandError(gettext('Parent of "%s" does not exist.')
1235
raise errors.BzrCommandError('Parent of "%s" does not exist.'
1532
# preserve whatever source format we have.
1533
to_dir = br_from.controldir.sprout(
1534
to_transport.base, revision_id,
1535
possible_transports=[to_transport],
1536
accelerator_tree=accelerator_tree, hardlink=hardlink,
1537
stacked=stacked, force_new_repo=standalone,
1538
create_tree_if_local=not no_tree, source_branch=br_from,
1540
branch = to_dir.open_branch(
1541
possible_transports=[
1542
br_from.controldir.root_transport, to_transport])
1543
except errors.NoSuchRevision:
1544
to_transport.delete_tree('.')
1545
msg = gettext("The branch {0} has no revision {1}.").format(
1546
from_location, revision)
1547
raise errors.CommandError(msg)
1550
to_repo = to_dir.open_repository()
1551
except errors.NoRepositoryPresent:
1552
to_repo = to_dir.create_repository()
1553
to_repo.fetch(br_from.repository, revision_id=revision_id)
1554
branch = br_from.sprout(
1555
to_dir, revision_id=revision_id)
1556
br_from.tags.merge_to(branch.tags)
1238
# preserve whatever source format we have.
1239
dir = br_from.bzrdir.sprout(to_transport.base, revision_id,
1240
possible_transports=[to_transport],
1241
accelerator_tree=accelerator_tree,
1242
hardlink=hardlink, stacked=stacked,
1243
force_new_repo=standalone,
1244
create_tree_if_local=not no_tree,
1245
source_branch=br_from)
1246
branch = dir.open_branch()
1247
except errors.NoSuchRevision:
1248
to_transport.delete_tree('.')
1249
msg = "The branch %s has no revision %s." % (from_location,
1251
raise errors.BzrCommandError(msg)
1252
_merge_tags_if_possible(br_from, branch)
1558
1253
# If the source branch is stacked, the new branch may
1559
1254
# be stacked whether we asked for that explicitly or not.
1560
1255
# We therefore need a try/except here and not just 'if stacked:'
1562
note(gettext('Created new stacked branch referring to %s.') %
1563
branch.get_stacked_on_url())
1564
except (errors.NotStacked, _mod_branch.UnstackableBranchFormat,
1565
errors.UnstackableRepositoryFormat) as e:
1566
revno = branch.revno()
1567
if revno is not None:
1568
note(ngettext('Branched %d revision.',
1569
'Branched %d revisions.',
1570
branch.revno()) % revno)
1572
note(gettext('Created new branch.'))
1257
note('Created new stacked branch referring to %s.' %
1258
branch.get_stacked_on_url())
1259
except (errors.NotStacked, errors.UnstackableBranchFormat,
1260
errors.UnstackableRepositoryFormat), e:
1261
note('Branched %d revision(s).' % branch.revno())
1574
1263
# Bind to the parent
1575
1264
parent_branch = Branch.open(from_location)
1576
1265
branch.bind(parent_branch)
1577
note(gettext('New branch bound to %s') % from_location)
1266
note('New branch bound to %s' % from_location)
1579
1268
# Switch to the new branch
1580
1269
wt, _ = WorkingTree.open_containing('.')
1581
_mod_switch.switch(wt.controldir, branch)
1582
note(gettext('Switched to branch: %s'),
1583
urlutils.unescape_for_display(branch.base, 'utf-8'))
1586
class cmd_branches(Command):
1587
__doc__ = """List the branches available at the current location.
1589
This command will print the names of all the branches at the current
1593
takes_args = ['location?']
1595
Option('recursive', short_name='R',
1596
help='Recursively scan for branches rather than '
1597
'just looking in the specified location.')]
1599
def run(self, location=".", recursive=False):
1601
t = transport.get_transport(location, purpose='read')
1602
if not t.listable():
1603
raise errors.CommandError(
1604
"Can't scan this type of location.")
1605
for b in controldir.ControlDir.find_branches(t):
1606
self.outf.write("%s\n" % urlutils.unescape_for_display(
1607
urlutils.relative_url(t.base, b.base),
1608
self.outf.encoding).rstrip("/"))
1610
dir = controldir.ControlDir.open_containing(location)[0]
1612
active_branch = dir.open_branch(name="")
1613
except errors.NotBranchError:
1614
active_branch = None
1616
for name, branch in iter_sibling_branches(dir):
1619
active = (active_branch is not None and
1620
active_branch.user_url == branch.user_url)
1621
names[name] = active
1622
# Only mention the current branch explicitly if it's not
1623
# one of the colocated branches
1624
if not any(viewvalues(names)) and active_branch is not None:
1625
self.outf.write("* %s\n" % gettext("(default)"))
1626
for name in sorted(names):
1627
active = names[name]
1632
self.outf.write("%s %s\n" % (
1633
prefix, (name if PY3 else name.encode(self.outf.encoding))))
1270
_mod_switch.switch(wt.bzrdir, branch)
1271
note('Switched to branch: %s',
1272
urlutils.unescape_for_display(branch.base, 'utf-8'))
1636
1275
class cmd_checkout(Command):
1637
1276
__doc__ = """Create a new checkout of an existing branch.
1639
If BRANCH_LOCATION is omitted, checkout will reconstitute a working tree
1640
for the branch found in '.'. This is useful if you have removed the working
1641
tree or if it was never created - i.e. if you pushed the branch to its
1642
current location using SFTP.
1278
If BRANCH_LOCATION is omitted, checkout will reconstitute a working tree for
1279
the branch found in '.'. This is useful if you have removed the working tree
1280
or if it was never created - i.e. if you pushed the branch to its current
1281
location using SFTP.
1644
If the TO_LOCATION is omitted, the last component of the BRANCH_LOCATION
1645
will be used. In other words, "checkout ../foo/bar" will attempt to create
1646
./bar. If the BRANCH_LOCATION has no / or path separator embedded, the
1647
TO_LOCATION is derived from the BRANCH_LOCATION by stripping a leading
1648
scheme or drive identifier, if any. For example, "checkout lp:foo-bar" will
1649
attempt to create ./foo-bar.
1283
If the TO_LOCATION is omitted, the last component of the BRANCH_LOCATION will
1284
be used. In other words, "checkout ../foo/bar" will attempt to create ./bar.
1285
If the BRANCH_LOCATION has no / or path separator embedded, the TO_LOCATION
1286
is derived from the BRANCH_LOCATION by stripping a leading scheme or drive
1287
identifier, if any. For example, "checkout lp:foo-bar" will attempt to
1651
1290
To retrieve the branch as of a particular revision, supply the --revision
1652
parameter, as in "checkout foo/bar -r 5". Note that this will be
1653
immediately out of date [so you cannot commit] but it may be useful (i.e.
1654
to examine old code.)
1291
parameter, as in "checkout foo/bar -r 5". Note that this will be immediately
1292
out of date [so you cannot commit] but it may be useful (i.e. to examine old
1657
_see_also = ['checkouts', 'branch', 'working-trees', 'remove-tree']
1296
_see_also = ['checkouts', 'branch']
1658
1297
takes_args = ['branch_location?', 'to_location?']
1659
1298
takes_options = ['revision',
1660
1299
Option('lightweight',
1750
1353
@display_command
1751
1354
def run(self, dir=u'.'):
1752
1355
tree = WorkingTree.open_containing(dir)[0]
1753
self.enter_context(tree.lock_read())
1356
self.add_cleanup(tree.lock_read().unlock)
1357
new_inv = tree.inventory
1754
1358
old_tree = tree.basis_tree()
1755
self.enter_context(old_tree.lock_read())
1359
self.add_cleanup(old_tree.lock_read().unlock)
1360
old_inv = old_tree.inventory
1757
1362
iterator = tree.iter_changes(old_tree, include_unchanged=True)
1758
for change in iterator:
1759
if change.path[0] == change.path[1]:
1761
if None in change.path:
1763
renames.append(change.path)
1363
for f, paths, c, v, p, n, k, e in iterator:
1364
if paths[0] == paths[1]:
1368
renames.append(paths)
1765
1370
for old_name, new_name in renames:
1766
1371
self.outf.write("%s => %s\n" % (old_name, new_name))
1769
1374
class cmd_update(Command):
1770
__doc__ = """Update a working tree to a new revision.
1772
This will perform a merge of the destination revision (the tip of the
1773
branch, or the specified revision) into the working tree, and then make
1774
that revision the basis revision for the working tree.
1776
You can use this to visit an older revision, or to update a working tree
1777
that is out of date from its branch.
1779
If there are any uncommitted changes in the tree, they will be carried
1780
across and remain as uncommitted changes after the update. To discard
1781
these changes, use 'brz revert'. The uncommitted changes may conflict
1782
with the changes brought in by the change in basis revision.
1784
If the tree's branch is bound to a master branch, brz will also update
1375
__doc__ = """Update a tree to have the latest code committed to its branch.
1377
This will perform a merge into the working tree, and may generate
1378
conflicts. If you have any local changes, you will still
1379
need to commit them after the update for the update to be complete.
1381
If you want to discard your local changes, you can just do a
1382
'bzr revert' instead of 'bzr commit' after the update.
1384
If the tree's branch is bound to a master branch, it will also update
1785
1385
the branch from the master.
1787
You cannot update just a single file or directory, because each Breezy
1788
working tree has just a single basis revision. If you want to restore a
1789
file that has been removed locally, use 'brz revert' instead of 'brz
1790
update'. If you want to restore a file to its state in a previous
1791
revision, use 'brz revert' with a '-r' option, or use 'brz cat' to write
1792
out the old content of that file to a new location.
1794
The 'dir' argument, if given, must be the location of the root of a
1795
working tree to update. By default, the working tree that contains the
1796
current working directory is used.
1799
1388
_see_also = ['pull', 'working-trees', 'status-flags']
1800
1389
takes_args = ['dir?']
1801
takes_options = ['revision',
1803
help="Show base revision text in conflicts."),
1390
takes_options = ['revision']
1805
1391
aliases = ['up']
1807
def run(self, dir=None, revision=None, show_base=None):
1393
def run(self, dir='.', revision=None):
1808
1394
if revision is not None and len(revision) != 1:
1809
raise errors.CommandError(gettext(
1810
"brz update --revision takes exactly one revision"))
1812
tree = WorkingTree.open_containing('.')[0]
1814
tree, relpath = WorkingTree.open_containing(dir)
1817
raise errors.CommandError(gettext(
1818
"brz update can only update a whole tree, "
1819
"not a file or subdirectory"))
1395
raise errors.BzrCommandError(
1396
"bzr update --revision takes exactly one revision")
1397
tree = WorkingTree.open_containing(dir)[0]
1820
1398
branch = tree.branch
1821
1399
possible_transports = []
1822
1400
master = branch.get_master_branch(
1823
1401
possible_transports=possible_transports)
1824
1402
if master is not None:
1825
1403
branch_location = master.base
1826
self.enter_context(tree.lock_write())
1828
1406
branch_location = tree.branch.base
1829
self.enter_context(tree.lock_tree_write())
1407
tree.lock_tree_write()
1408
self.add_cleanup(tree.unlock)
1830
1409
# get rid of the final '/' and be ready for display
1831
1410
branch_location = urlutils.unescape_for_display(
1832
1411
branch_location.rstrip('/'),
1918
1496
noise_level = get_verbosity_level()
1920
1498
noise_level = 0
1921
from .info import show_bzrdir_info
1922
show_bzrdir_info(controldir.ControlDir.open_containing(location)[0],
1499
from bzrlib.info import show_bzrdir_info
1500
show_bzrdir_info(bzrdir.BzrDir.open_containing(location)[0],
1923
1501
verbose=noise_level, outfile=self.outf)
1926
1504
class cmd_remove(Command):
1927
1505
__doc__ = """Remove files or directories.
1929
This makes Breezy stop tracking changes to the specified files. Breezy will
1930
delete them if they can easily be recovered using revert otherwise they
1931
will be backed up (adding an extension of the form .~#~). If no options or
1932
parameters are given Breezy will scan for files that are being tracked by
1933
Breezy but missing in your tree and stop tracking them for you.
1507
This makes bzr stop tracking changes to the specified files. bzr will delete
1508
them if they can easily be recovered using revert. If no options or
1509
parameters are given bzr will scan for files that are being tracked by bzr
1510
but missing in your tree and stop tracking them for you.
1935
1512
takes_args = ['file*']
1936
1513
takes_options = ['verbose',
1938
'new', help='Only remove files that have never been committed.'),
1939
RegistryOption.from_kwargs('file-deletion-strategy',
1940
'The file deletion mode to be used.',
1941
title='Deletion Strategy', value_switches=True, enum_switch=False,
1942
safe='Backup changed files (default).',
1943
keep='Delete from brz but leave the working copy.',
1944
no_backup='Don\'t backup changed files.'),
1514
Option('new', help='Only remove files that have never been committed.'),
1515
RegistryOption.from_kwargs('file-deletion-strategy',
1516
'The file deletion mode to be used.',
1517
title='Deletion Strategy', value_switches=True, enum_switch=False,
1518
safe='Only delete files if they can be'
1519
' safely recovered (default).',
1520
keep='Delete from bzr but leave the working copy.',
1521
force='Delete all the specified files, even if they can not be '
1522
'recovered and even if they are non-empty directories.')]
1946
1523
aliases = ['rm', 'del']
1947
1524
encoding_type = 'replace'
1949
1526
def run(self, file_list, verbose=False, new=False,
1950
file_deletion_strategy='safe'):
1952
tree, file_list = WorkingTree.open_containing_paths(file_list)
1527
file_deletion_strategy='safe'):
1528
tree, file_list = tree_files(file_list)
1954
1530
if file_list is not None:
1955
1531
file_list = [f for f in file_list]
1957
self.enter_context(tree.lock_write())
1533
self.add_cleanup(tree.lock_write().unlock)
1958
1534
# Heuristics should probably all move into tree.remove_smart or
1961
1537
added = tree.changes_from(tree.basis_tree(),
1962
specific_files=file_list).added
1963
file_list = sorted([f.path[1] for f in added], reverse=True)
1538
specific_files=file_list).added
1539
file_list = sorted([f[0] for f in added], reverse=True)
1964
1540
if len(file_list) == 0:
1965
raise errors.CommandError(gettext('No matching files.'))
1541
raise errors.BzrCommandError('No matching files.')
1966
1542
elif file_list is None:
1967
1543
# missing files show up in iter_changes(basis) as
1968
1544
# versioned-with-no-kind.
1970
1546
for change in tree.iter_changes(tree.basis_tree()):
1971
1547
# Find paths in the working tree that have no kind:
1972
if change.path[1] is not None and change.kind[1] is None:
1973
missing.append(change.path[1])
1548
if change[1][1] is not None and change[6][1] is None:
1549
missing.append(change[1][1])
1974
1550
file_list = sorted(missing, reverse=True)
1975
1551
file_deletion_strategy = 'keep'
1976
1552
tree.remove(file_list, verbose=verbose, to_file=self.outf,
1977
keep_files=file_deletion_strategy == 'keep',
1978
force=(file_deletion_strategy == 'no-backup'))
1553
keep_files=file_deletion_strategy=='keep',
1554
force=file_deletion_strategy=='force')
1557
class cmd_file_id(Command):
1558
__doc__ = """Print file_id of a particular file or directory.
1560
The file_id is assigned when the file is first added and remains the
1561
same through all revisions where the file exists, even when it is
1566
_see_also = ['inventory', 'ls']
1567
takes_args = ['filename']
1570
def run(self, filename):
1571
tree, relpath = WorkingTree.open_containing(filename)
1572
i = tree.path2id(relpath)
1574
raise errors.NotVersionedError(filename)
1576
self.outf.write(i + '\n')
1579
class cmd_file_path(Command):
1580
__doc__ = """Print path of file_ids to a file or directory.
1582
This prints one line for each directory down to the target,
1583
starting at the branch root.
1587
takes_args = ['filename']
1590
def run(self, filename):
1591
tree, relpath = WorkingTree.open_containing(filename)
1592
fid = tree.path2id(relpath)
1594
raise errors.NotVersionedError(filename)
1595
segments = osutils.splitpath(relpath)
1596
for pos in range(1, len(segments) + 1):
1597
path = osutils.joinpath(segments[:pos])
1598
self.outf.write("%s\n" % tree.path2id(path))
1981
1601
class cmd_reconcile(Command):
1982
__doc__ = """Reconcile brz metadata in a branch.
1602
__doc__ = """Reconcile bzr metadata in a branch.
1984
1604
This can correct data mismatches that may have been caused by
1985
previous ghost operations or brz upgrades. You should only
1986
need to run this command if 'brz check' or a brz developer
1605
previous ghost operations or bzr upgrades. You should only
1606
need to run this command if 'bzr check' or a bzr developer
1987
1607
advises you to run it.
1989
1609
If a second branch is provided, cross-branch reconciliation is
1990
1610
also attempted, which will check that data like the tree root
1991
id which was not present in very early brz versions is represented
1611
id which was not present in very early bzr versions is represented
1992
1612
correctly in both branches.
1994
1614
At the same time it is run it may recompress data resulting in
2124
1726
to_transport.ensure_base()
2125
1727
except errors.NoSuchFile:
2126
1728
if not create_prefix:
2127
raise errors.CommandError(gettext("Parent directory of %s"
2129
"\nYou may supply --create-prefix to create all"
2130
" leading parent directories.")
1729
raise errors.BzrCommandError("Parent directory of %s"
1731
"\nYou may supply --create-prefix to create all"
1732
" leading parent directories."
2132
1734
to_transport.create_prefix()
2135
a_controldir = controldir.ControlDir.open_from_transport(
1737
a_bzrdir = bzrdir.BzrDir.open_from_transport(to_transport)
2137
1738
except errors.NotBranchError:
2138
1739
# really a NotBzrDir error...
2139
create_branch = controldir.ControlDir.create_branch_convenience
2141
force_new_tree = False
2143
force_new_tree = None
1740
create_branch = bzrdir.BzrDir.create_branch_convenience
2144
1741
branch = create_branch(to_transport.base, format=format,
2145
possible_transports=[to_transport],
2146
force_new_tree=force_new_tree)
2147
a_controldir = branch.controldir
1742
possible_transports=[to_transport])
1743
a_bzrdir = branch.bzrdir
2149
from .transport.local import LocalTransport
2150
if a_controldir.has_branch():
1745
from bzrlib.transport.local import LocalTransport
1746
if a_bzrdir.has_branch():
2151
1747
if (isinstance(to_transport, LocalTransport)
2152
and not a_controldir.has_workingtree()):
2153
raise errors.BranchExistsWithoutWorkingTree(location)
1748
and not a_bzrdir.has_workingtree()):
1749
raise errors.BranchExistsWithoutWorkingTree(location)
2154
1750
raise errors.AlreadyBranchError(location)
2155
branch = a_controldir.create_branch()
2156
if not no_tree and not a_controldir.has_workingtree():
2157
a_controldir.create_workingtree()
1751
branch = a_bzrdir.create_branch()
1752
a_bzrdir.create_workingtree()
2158
1753
if append_revisions_only:
2160
1755
branch.set_append_revisions_only(True)
2161
1756
except errors.UpgradeRequired:
2162
raise errors.CommandError(gettext('This branch format cannot be set'
2163
' to append-revisions-only. Try --default.'))
1757
raise errors.BzrCommandError('This branch format cannot be set'
1758
' to append-revisions-only. Try --default.')
2164
1759
if not is_quiet():
2165
from .info import describe_layout, describe_format
1760
from bzrlib.info import describe_layout, describe_format
2167
tree = a_controldir.open_workingtree(recommend_upgrade=False)
1762
tree = a_bzrdir.open_workingtree(recommend_upgrade=False)
2168
1763
except (errors.NoWorkingTree, errors.NotLocalUrl):
2170
1765
repository = branch.repository
2171
1766
layout = describe_layout(repository, branch, tree).lower()
2172
format = describe_format(a_controldir, repository, branch, tree)
2173
self.outf.write(gettext("Created a {0} (format: {1})\n").format(
1767
format = describe_format(a_bzrdir, repository, branch, tree)
1768
self.outf.write("Created a %s (format: %s)\n" % (layout, format))
2175
1769
if repository.is_shared():
2176
# XXX: maybe this can be refactored into transport.path_or_url()
2177
url = repository.controldir.root_transport.external_url()
1770
#XXX: maybe this can be refactored into transport.path_or_url()
1771
url = repository.bzrdir.root_transport.external_url()
2179
1773
url = urlutils.local_path_from_url(url)
2180
except urlutils.InvalidURL:
1774
except errors.InvalidURL:
2182
self.outf.write(gettext("Using shared repository: %s\n") % url)
2185
class cmd_init_shared_repository(Command):
1776
self.outf.write("Using shared repository: %s\n" % url)
1779
class cmd_init_repository(Command):
2186
1780
__doc__ = """Create a shared repository for branches to share storage space.
2188
1782
New branches created under the repository directory will store their
2189
1783
revisions in the repository, not in the branch directory. For branches
2190
with shared history, this reduces the amount of storage needed and
1784
with shared history, this reduces the amount of storage needed and
2191
1785
speeds up the creation of new branches.
2193
1787
If the --no-trees option is given then the branches in the repository
2194
will not have working trees by default. They will still exist as
2195
directories on disk, but they will not have separate copies of the
1788
will not have working trees by default. They will still exist as
1789
directories on disk, but they will not have separate copies of the
2196
1790
files at a certain revision. This can be useful for repositories that
2197
1791
store branches which are interacted with through checkouts or remote
2198
1792
branches, such as on a server.
2281
1859
Shows the difference in the working tree versus the last commit::
2285
1863
Difference between the working tree and revision 1::
2289
1867
Difference between revision 3 and revision 1::
2293
1871
Difference between revision 3 and revision 1 for branch xxx::
2297
The changes introduced by revision 2 (equivalent to -r1..2)::
2301
To see the changes introduced by revision X::
1875
To see the changes introduced in revision X::
2305
1879
Note that in the case of a merge, the -c option shows the changes
2306
1880
compared to the left hand parent. To see the changes against
2307
1881
another parent, use::
2309
brz diff -r<chosen_parent>..X
2311
The changes between the current revision and the previous revision
2312
(equivalent to -c-1 and -r-2..-1)
1883
bzr diff -r<chosen_parent>..X
1885
The changes introduced by revision 2 (equivalent to -r1..2)::
2316
1889
Show just the differences for file NEWS::
2320
1893
Show the differences in working tree xxx for file NEWS::
2324
1897
Show the differences from branch xxx to this working tree:
2328
1901
Show the differences between two branches for file NEWS::
2330
brz diff --old xxx --new yyy NEWS
2332
Same as 'brz diff' but prefix paths with old/ and new/::
2334
brz diff --prefix old/:new/
2336
Show the differences using a custom diff program with options::
2338
brz diff --using /usr/bin/diff --diff-options -wu
1903
bzr diff --old xxx --new yyy NEWS
1905
Same as 'bzr diff' but prefix paths with old/ and new/::
1907
bzr diff --prefix old/:new/
2340
1909
_see_also = ['status']
2341
1910
takes_args = ['file*']
2342
1911
takes_options = [
2343
Option('diff-options', type=text_type,
1912
Option('diff-options', type=str,
2344
1913
help='Pass these options to the external diff program.'),
2345
Option('prefix', type=text_type,
1914
Option('prefix', type=str,
2346
1915
short_name='p',
2347
1916
help='Set prefixes added to old and new filenames, as '
2348
1917
'two values separated by a colon. (eg "old/:new/").'),
2350
help='Branch/tree to compare from.',
1919
help='Branch/tree to compare from.',
2354
help='Branch/tree to compare to.',
1923
help='Branch/tree to compare to.',
2359
1928
Option('using',
2360
help='Use this command to compare files.',
1929
help='Use this command to compare files.',
2363
1932
RegistryOption('format',
2365
help='Diff format to use.',
2366
lazy_registry=('breezy.diff', 'format_registry'),
2367
title='Diff format'),
2369
help='How many lines of context to show.',
2372
RegistryOption.from_kwargs(
2374
help='Color mode to use.',
2375
title='Color Mode', value_switches=False, enum_switch=True,
2376
never='Never colorize output.',
2377
auto='Only colorize output if terminal supports it and STDOUT is a'
2379
always='Always colorize output (default).'),
2382
help=('Warn if trailing whitespace or spurious changes have been'
1933
help='Diff format to use.',
1934
lazy_registry=('bzrlib.diff', 'format_registry'),
1935
value_switches=False, title='Diff format'),
2386
1937
aliases = ['di', 'dif']
2387
1938
encoding_type = 'exact'
2389
1940
@display_command
2390
1941
def run(self, revision=None, file_list=None, diff_options=None,
2391
prefix=None, old=None, new=None, using=None, format=None,
2392
context=None, color='never'):
2393
from .diff import (get_trees_and_branches_to_diff_locked,
1942
prefix=None, old=None, new=None, using=None, format=None):
1943
from bzrlib.diff import (get_trees_and_branches_to_diff_locked,
1946
if (prefix is None) or (prefix == '0'):
2397
1947
# diff -p0 format
2400
elif prefix == u'1' or prefix is None:
2401
1951
old_label = 'old/'
2402
1952
new_label = 'new/'
2403
elif u':' in prefix:
2404
old_label, new_label = prefix.split(u":")
1954
old_label, new_label = prefix.split(":")
2406
raise errors.CommandError(gettext(
1956
raise errors.BzrCommandError(
2407
1957
'--prefix expects two values separated by a colon'
2408
' (eg "old/:new/")'))
1958
' (eg "old/:new/")')
2410
1960
if revision and len(revision) > 2:
2411
raise errors.CommandError(gettext('brz diff --revision takes exactly'
2412
' one or two revision specifiers'))
1961
raise errors.BzrCommandError('bzr diff --revision takes exactly'
1962
' one or two revision specifiers')
2414
1964
if using is not None and format is not None:
2415
raise errors.CommandError(gettext(
2416
'{0} and {1} are mutually exclusive').format(
2417
'--using', '--format'))
1965
raise errors.BzrCommandError('--using and --format are mutually '
2419
1968
(old_tree, new_tree,
2420
1969
old_branch, new_branch,
2421
1970
specific_files, extra_trees) = get_trees_and_branches_to_diff_locked(
2422
file_list, revision, old, new, self._exit_stack, apply_view=True)
2423
# GNU diff on Windows uses ANSI encoding for filenames
2424
path_encoding = osutils.get_diff_header_encoding()
2427
from .terminal import has_ansi_colors
2428
if has_ansi_colors():
2432
if 'always' == color:
2433
from .colordiff import DiffWriter
2434
outf = DiffWriter(outf)
2435
return show_diff_trees(old_tree, new_tree, outf,
1971
file_list, revision, old, new, self.add_cleanup, apply_view=True)
1972
return show_diff_trees(old_tree, new_tree, sys.stdout,
2436
1973
specific_files=specific_files,
2437
1974
external_diff_options=diff_options,
2438
1975
old_label=old_label, new_label=new_label,
2439
extra_trees=extra_trees,
2440
path_encoding=path_encoding,
2441
using=using, context=context,
1976
extra_trees=extra_trees, using=using,
2442
1977
format_cls=format)
3026
2499
_see_also = ['status', 'cat']
3027
2500
takes_args = ['path?']
3028
2501
takes_options = [
3031
Option('recursive', short_name='R',
3032
help='Recurse into subdirectories.'),
3034
help='Print paths relative to the root of the branch.'),
3035
Option('unknown', short_name='u',
3036
help='Print unknown files.'),
3037
Option('versioned', help='Print versioned files.',
3039
Option('ignored', short_name='i',
3040
help='Print ignored files.'),
3041
Option('kind', short_name='k',
3042
help=('List entries of a particular kind: file, '
3043
'directory, symlink, tree-reference.'),
2504
Option('recursive', short_name='R',
2505
help='Recurse into subdirectories.'),
2507
help='Print paths relative to the root of the branch.'),
2508
Option('unknown', help='Print unknown files.'),
2509
Option('versioned', help='Print versioned files.',
2511
Option('ignored', help='Print ignored files.'),
2513
help='Write an ascii NUL (\\0) separator '
2514
'between files rather than a newline.'),
2516
help='List entries of a particular kind: file, directory, symlink.',
3050
2520
@display_command
3051
2521
def run(self, revision=None, verbose=False,
3052
2522
recursive=False, from_root=False,
3053
2523
unknown=False, versioned=False, ignored=False,
3054
null=False, kind=None, show_ids=False, path=None, directory=None):
2524
null=False, kind=None, show_ids=False, path=None):
3056
if kind and kind not in ('file', 'directory', 'symlink', 'tree-reference'):
3057
raise errors.CommandError(gettext('invalid kind specified'))
2526
if kind and kind not in ('file', 'directory', 'symlink'):
2527
raise errors.BzrCommandError('invalid kind specified')
3059
2529
if verbose and null:
3060
raise errors.CommandError(
3061
gettext('Cannot set both --verbose and --null'))
2530
raise errors.BzrCommandError('Cannot set both --verbose and --null')
3062
2531
all = not (unknown or versioned or ignored)
3064
selection = {'I': ignored, '?': unknown, 'V': versioned}
2533
selection = {'I':ignored, '?':unknown, 'V':versioned}
3066
2535
if path is None:
3070
raise errors.CommandError(gettext('cannot specify both --from-root'
2539
raise errors.BzrCommandError('cannot specify both --from-root'
3073
tree, branch, relpath = \
3074
_open_directory_or_containing_tree_or_branch(fs_path, directory)
2542
tree, branch, relpath = bzrdir.BzrDir.open_containing_tree_or_branch(
3076
2545
# Calculate the prefix to use
3168
2636
After adding, editing or deleting that file either indirectly by
3169
2637
using this command or directly by using an editor, be sure to commit
3172
Breezy also supports a global ignore file ~/.config/breezy/ignore. On
3173
Windows the global ignore file can be found in the application data
3175
C:\\Documents and Settings\\<user>\\Application Data\\Breezy\\3.0\\ignore.
2640
Bazaar also supports a global ignore file ~/.bazaar/ignore. On Windows
2641
the global ignore file can be found in the application data directory as
2642
C:\\Documents and Settings\\<user>\\Application Data\\Bazaar\\2.0\\ignore.
3176
2643
Global ignores are not touched by this command. The global ignore file
3177
2644
can be edited directly using an editor.
3179
2646
Patterns prefixed with '!' are exceptions to ignore patterns and take
3180
2647
precedence over regular ignores. Such exceptions are used to specify
3181
2648
files that should be versioned which would otherwise be ignored.
3183
2650
Patterns prefixed with '!!' act as regular ignore patterns, but have
3184
2651
precedence over the '!' exception patterns.
3188
* Ignore patterns containing shell wildcards must be quoted from
3191
* Ignore patterns starting with "#" act as comments in the ignore file.
3192
To ignore patterns that begin with that character, use the "RE:" prefix.
2653
Note: ignore patterns containing shell wildcards must be quoted from
3195
2657
Ignore the top level Makefile::
3197
brz ignore ./Makefile
2659
bzr ignore ./Makefile
3199
2661
Ignore .class files in all directories...::
3201
brz ignore "*.class"
2663
bzr ignore "*.class"
3203
2665
...but do not ignore "special.class"::
3205
brz ignore "!special.class"
3207
Ignore files whose name begins with the "#" character::
3211
Ignore .o files under the lib directory::
3213
brz ignore "lib/**/*.o"
3215
Ignore .o files under the lib directory::
3217
brz ignore "RE:lib/.*\\.o"
2667
bzr ignore "!special.class"
2669
Ignore .o files under the lib directory::
2671
bzr ignore "lib/**/*.o"
2673
Ignore .o files under the lib directory::
2675
bzr ignore "RE:lib/.*\.o"
3219
2677
Ignore everything but the "debian" toplevel directory::
3221
brz ignore "RE:(?!debian/).*"
2679
bzr ignore "RE:(?!debian/).*"
3223
2681
Ignore everything except the "local" toplevel directory,
3224
but always ignore autosave files ending in ~, even under local/::
3227
brz ignore "!./local"
2682
but always ignore "*~" autosave files, even under local/::
2685
bzr ignore "!./local"
3231
2689
_see_also = ['status', 'ignored', 'patterns']
3232
2690
takes_args = ['name_pattern*']
3233
takes_options = ['directory',
3234
Option('default-rules',
3235
help='Display the default ignore rules that brz uses.')
2692
Option('default-rules',
2693
help='Display the default ignore rules that bzr uses.')
3238
def run(self, name_pattern_list=None, default_rules=None,
3240
from breezy import ignores
2696
def run(self, name_pattern_list=None, default_rules=None):
2697
from bzrlib import ignores
3241
2698
if default_rules is not None:
3242
2699
# dump the default rules and exit
3243
2700
for pattern in ignores.USER_DEFAULTS:
3244
2701
self.outf.write("%s\n" % pattern)
3246
2703
if not name_pattern_list:
3247
raise errors.CommandError(gettext("ignore requires at least one "
3248
"NAME_PATTERN or --default-rules."))
2704
raise errors.BzrCommandError("ignore requires at least one "
2705
"NAME_PATTERN or --default-rules.")
3249
2706
name_pattern_list = [globbing.normalize_pattern(p)
3250
2707
for p in name_pattern_list]
3252
bad_patterns_count = 0
3253
for p in name_pattern_list:
3254
if not globbing.Globster.is_pattern_valid(p):
3255
bad_patterns_count += 1
3256
bad_patterns += ('\n %s' % p)
3258
msg = (ngettext('Invalid ignore pattern found. %s',
3259
'Invalid ignore patterns found. %s',
3260
bad_patterns_count) % bad_patterns)
3261
ui.ui_factory.show_error(msg)
3262
raise lazy_regex.InvalidPattern('')
3263
2708
for name_pattern in name_pattern_list:
3264
2709
if (name_pattern[0] == '/' or
3265
(len(name_pattern) > 1 and name_pattern[1] == ':')):
3266
raise errors.CommandError(gettext(
3267
"NAME_PATTERN should not be an absolute path"))
3268
tree, relpath = WorkingTree.open_containing(directory)
2710
(len(name_pattern) > 1 and name_pattern[1] == ':')):
2711
raise errors.BzrCommandError(
2712
"NAME_PATTERN should not be an absolute path")
2713
tree, relpath = WorkingTree.open_containing(u'.')
3269
2714
ignores.tree_ignores_add_patterns(tree, name_pattern_list)
3270
2715
ignored = globbing.Globster(name_pattern_list)
3272
self.enter_context(tree.lock_read())
3273
for filename, fc, fkind, entry in tree.list_files():
3274
id = getattr(entry, 'file_id', None)
2718
for entry in tree.list_files():
3275
2720
if id is not None:
3276
2722
if ignored.match(filename):
3277
2723
matches.append(filename)
3278
2725
if len(matches) > 0:
3279
self.outf.write(gettext("Warning: the following files are version "
3280
"controlled and match your ignore pattern:\n%s"
3281
"\nThese files will continue to be version controlled"
3282
" unless you 'brz remove' them.\n") % ("\n".join(matches),))
2726
self.outf.write("Warning: the following files are version controlled and"
2727
" match your ignore pattern:\n%s"
2728
"\nThese files will continue to be version controlled"
2729
" unless you 'bzr remove' them.\n" % ("\n".join(matches),))
3285
2732
class cmd_ignored(Command):
3360
2804
================= =========================
3363
encoding_type = 'exact'
3364
2806
takes_args = ['dest', 'branch_or_subdir?']
3365
takes_options = ['directory',
3367
help="Type of file to export to.",
3370
Option('filters', help='Apply content filters to export the '
3371
'convenient form.'),
3374
help="Name of the root directory inside the exported file."),
3375
Option('per-file-timestamps',
3376
help='Set modification time of files to that of the last '
3377
'revision in which it was changed.'),
3378
Option('uncommitted',
3379
help='Export the working tree contents rather than that of the '
2809
help="Type of file to export to.",
2812
Option('filters', help='Apply content filters to export the '
2813
'convenient form.'),
2816
help="Name of the root directory inside the exported file."),
2817
Option('per-file-timestamps',
2818
help='Set modification time of files to that of the last '
2819
'revision in which it was changed.'),
3383
2821
def run(self, dest, branch_or_subdir=None, revision=None, format=None,
3384
root=None, filters=False, per_file_timestamps=False, uncommitted=False,
3386
from .export import export, guess_format, get_root_name
2822
root=None, filters=False, per_file_timestamps=False):
2823
from bzrlib.export import export
3388
2825
if branch_or_subdir is None:
3389
branch_or_subdir = directory
3391
(tree, b, subdir) = controldir.ControlDir.open_containing_tree_or_branch(
3393
if tree is not None:
3394
self.enter_context(tree.lock_read())
3398
raise errors.CommandError(
3399
gettext("--uncommitted requires a working tree"))
3402
export_tree = _get_one_revision_tree(
3403
'export', revision, branch=b,
3407
format = guess_format(dest)
3410
root = get_root_name(dest)
3412
if not per_file_timestamps:
3413
force_mtime = time.time()
3418
from breezy.filter_tree import ContentFilterTree
3419
export_tree = ContentFilterTree(
3420
export_tree, export_tree._content_filter_stack)
2826
tree = WorkingTree.open_containing(u'.')[0]
2830
b, subdir = Branch.open_containing(branch_or_subdir)
2833
rev_tree = _get_one_revision_tree('export', revision, branch=b, tree=tree)
3423
export(export_tree, dest, format, root, subdir,
2835
export(rev_tree, dest, format, root, subdir, filtered=filters,
3424
2836
per_file_timestamps=per_file_timestamps)
3425
except errors.NoSuchExportFormat as e:
3426
raise errors.CommandError(
3427
gettext('Unsupported export format: %s') % e.format)
2837
except errors.NoSuchExportFormat, e:
2838
raise errors.BzrCommandError('Unsupported export format: %s' % e.format)
3430
2841
class cmd_cat(Command):
3439
2850
_see_also = ['ls']
3440
takes_options = ['directory',
3441
Option('name-from-revision',
3442
help='The path name in the old tree.'),
3443
Option('filters', help='Apply content filters to display the '
3444
'convenience form.'),
2852
Option('name-from-revision', help='The path name in the old tree.'),
2853
Option('filters', help='Apply content filters to display the '
2854
'convenience form.'),
3447
2857
takes_args = ['filename']
3448
2858
encoding_type = 'exact'
3450
2860
@display_command
3451
2861
def run(self, filename, revision=None, name_from_revision=False,
3452
filters=False, directory=None):
3453
2863
if revision is not None and len(revision) != 1:
3454
raise errors.CommandError(gettext("brz cat --revision takes exactly"
3455
" one revision specifier"))
2864
raise errors.BzrCommandError("bzr cat --revision takes exactly"
2865
" one revision specifier")
3456
2866
tree, branch, relpath = \
3457
_open_directory_or_containing_tree_or_branch(filename, directory)
3458
self.enter_context(branch.lock_read())
2867
bzrdir.BzrDir.open_containing_tree_or_branch(filename)
2868
self.add_cleanup(branch.lock_read().unlock)
3459
2869
return self._run(tree, branch, relpath, filename, revision,
3460
2870
name_from_revision, filters)
3462
2872
def _run(self, tree, b, relpath, filename, revision, name_from_revision,
3465
2874
if tree is None:
3466
2875
tree = b.basis_tree()
3467
2876
rev_tree = _get_one_revision_tree('cat', revision, branch=b)
3468
self.enter_context(rev_tree.lock_read())
2877
self.add_cleanup(rev_tree.lock_read().unlock)
2879
old_file_id = rev_tree.path2id(relpath)
3470
2881
if name_from_revision:
3471
2882
# Try in revision if requested
3472
if not rev_tree.is_versioned(relpath):
3473
raise errors.CommandError(gettext(
3474
"{0!r} is not present in revision {1}").format(
2883
if old_file_id is None:
2884
raise errors.BzrCommandError(
2885
"%r is not present in revision %s" % (
3475
2886
filename, rev_tree.get_revision_id()))
3476
rev_tree_path = relpath
2888
content = rev_tree.get_file_text(old_file_id)
3479
rev_tree_path = _mod_tree.find_previous_path(
3480
tree, rev_tree, relpath)
3481
except errors.NoSuchFile:
3482
rev_tree_path = None
3484
if rev_tree_path is None:
3485
# Path didn't exist in working tree
3486
if not rev_tree.is_versioned(relpath):
3487
raise errors.CommandError(gettext(
3488
"{0!r} is not present in revision {1}").format(
3489
filename, rev_tree.get_revision_id()))
3491
# Fall back to the same path in the basis tree, if present.
3492
rev_tree_path = relpath
2890
cur_file_id = tree.path2id(relpath)
2892
if cur_file_id is not None:
2893
# Then try with the actual file id
2895
content = rev_tree.get_file_text(cur_file_id)
2897
except errors.NoSuchId:
2898
# The actual file id didn't exist at that time
2900
if not found and old_file_id is not None:
2901
# Finally try with the old file id
2902
content = rev_tree.get_file_text(old_file_id)
2905
# Can't be found anywhere
2906
raise errors.BzrCommandError(
2907
"%r is not present in revision %s" % (
2908
filename, rev_tree.get_revision_id()))
3495
from .filter_tree import ContentFilterTree
3496
filter_tree = ContentFilterTree(
3497
rev_tree, rev_tree._content_filter_stack)
3498
fileobj = filter_tree.get_file(rev_tree_path)
2910
from bzrlib.filters import (
2911
ContentFilterContext,
2912
filtered_output_bytes,
2914
filters = rev_tree._content_filter_stack(relpath)
2915
chunks = content.splitlines(True)
2916
content = filtered_output_bytes(chunks, filters,
2917
ContentFilterContext(relpath, rev_tree))
2919
self.outf.writelines(content)
3500
fileobj = rev_tree.get_file(rev_tree_path)
3501
shutil.copyfileobj(fileobj, self.outf)
2922
self.outf.write(content)
3505
2925
class cmd_local_time_offset(Command):
3506
2926
__doc__ = """Show the offset in seconds from GMT to local time."""
3509
2928
@display_command
3511
2930
self.outf.write("%s\n" % osutils.local_time_offset())
3514
2934
class cmd_commit(Command):
3515
2935
__doc__ = """Commit changes into a new revision.
3547
2967
"John Doe <jdoe@example.com>". If there is more than one author of
3548
2968
the change you can specify the option multiple times, once for each
3553
2973
A common mistake is to forget to add a new file or directory before
3554
2974
running the commit command. The --strict option checks for unknown
3555
2975
files and aborts the commit if any are found. More advanced pre-commit
3556
checks can be implemented by defining hooks. See ``brz help hooks``
2976
checks can be implemented by defining hooks. See ``bzr help hooks``
3559
2979
:Things to note:
3561
If you accidentally commit the wrong changes or make a spelling
2981
If you accidentially commit the wrong changes or make a spelling
3562
2982
mistake in the commit message say, you can use the uncommit command
3563
to undo it. See ``brz help uncommit`` for details.
2983
to undo it. See ``bzr help uncommit`` for details.
3565
2985
Hooks can also be configured to run after a commit. This allows you
3566
2986
to trigger updates to external systems like bug trackers. The --fixes
3567
2987
option can be used to record the association between a revision and
3568
one or more bugs. See ``brz help bugs`` for details.
2988
one or more bugs. See ``bzr help bugs`` for details.
2990
A selective commit may fail in some cases where the committed
2991
tree would be invalid. Consider::
2996
bzr commit foo -m "committing foo"
2997
bzr mv foo/bar foo/baz
3000
bzr commit foo/bar -m "committing bar but not baz"
3002
In the example above, the last commit will fail by design. This gives
3003
the user the opportunity to decide whether they want to commit the
3004
rename at the same time, separately first, or not at all. (As a general
3005
rule, when in doubt, Bazaar has a policy of Doing the Safe Thing.)
3007
# TODO: Run hooks on tree to-be-committed, and after commit.
3009
# TODO: Strict commit that fails if there are deleted files.
3010
# (what does "deleted files" mean ??)
3012
# TODO: Give better message for -s, --summary, used by tla people
3014
# XXX: verbose currently does nothing
3571
3016
_see_also = ['add', 'bugs', 'hooks', 'uncommit']
3572
3017
takes_args = ['selected*']
3573
3018
takes_options = [
3575
'exclude', type=text_type, short_name='x',
3576
help="Do not consider changes made to a given path."),
3577
Option('message', type=text_type,
3579
help="Description of the new revision."),
3582
help='Commit even if nothing has changed.'),
3583
Option('file', type=text_type,
3586
help='Take commit message from this file.'),
3588
help="Refuse to commit if there are unknown "
3589
"files in the working tree."),
3590
Option('commit-time', type=text_type,
3591
help="Manually set a commit time using commit date "
3592
"format, e.g. '2009-10-10 08:00:00 +0100'."),
3594
'bugs', type=text_type,
3595
help="Link to a related bug. (see \"brz help bugs\")."),
3597
'fixes', type=text_type,
3598
help="Mark a bug as being fixed by this revision "
3599
"(see \"brz help bugs\")."),
3601
'author', type=text_type,
3602
help="Set the author's name, if it's different "
3603
"from the committer."),
3605
help="Perform a local commit in a bound "
3606
"branch. Local commits are not pushed to "
3607
"the master branch until a normal commit "
3610
Option('show-diff', short_name='p',
3611
help='When no message is supplied, show the diff along'
3612
' with the status summary in the message editor.'),
3614
help='When committing to a foreign version control '
3615
'system do not push data that can not be natively '
3019
ListOption('exclude', type=str, short_name='x',
3020
help="Do not consider changes made to a given path."),
3021
Option('message', type=unicode,
3023
help="Description of the new revision."),
3026
help='Commit even if nothing has changed.'),
3027
Option('file', type=str,
3030
help='Take commit message from this file.'),
3032
help="Refuse to commit if there are unknown "
3033
"files in the working tree."),
3034
Option('commit-time', type=str,
3035
help="Manually set a commit time using commit date "
3036
"format, e.g. '2009-10-10 08:00:00 +0100'."),
3037
ListOption('fixes', type=str,
3038
help="Mark a bug as being fixed by this revision "
3039
"(see \"bzr help bugs\")."),
3040
ListOption('author', type=unicode,
3041
help="Set the author's name, if it's different "
3042
"from the committer."),
3044
help="Perform a local commit in a bound "
3045
"branch. Local commits are not pushed to "
3046
"the master branch until a normal commit "
3049
Option('show-diff', short_name='p',
3050
help='When no message is supplied, show the diff along'
3051
' with the status summary in the message editor.'),
3617
3053
aliases = ['ci', 'checkin']
3619
def _iter_bug_urls(self, bugs, branch, status):
3620
default_bugtracker = None
3055
def _iter_bug_fix_urls(self, fixes, branch):
3621
3056
# Configure the properties for bug fixing attributes.
3623
tokens = bug.split(':')
3624
if len(tokens) == 1:
3625
if default_bugtracker is None:
3626
branch_config = branch.get_config_stack()
3627
default_bugtracker = branch_config.get(
3629
if default_bugtracker is None:
3630
raise errors.CommandError(gettext(
3631
"No tracker specified for bug %s. Use the form "
3632
"'tracker:id' or specify a default bug tracker "
3633
"using the `bugtracker` option.\nSee "
3634
"\"brz help bugs\" for more information on this "
3635
"feature. Commit refused.") % bug)
3636
tag = default_bugtracker
3638
elif len(tokens) != 2:
3639
raise errors.CommandError(gettext(
3057
for fixed_bug in fixes:
3058
tokens = fixed_bug.split(':')
3059
if len(tokens) != 2:
3060
raise errors.BzrCommandError(
3640
3061
"Invalid bug %s. Must be in the form of 'tracker:id'. "
3641
"See \"brz help bugs\" for more information on this "
3642
"feature.\nCommit refused.") % bug)
3644
tag, bug_id = tokens
3062
"See \"bzr help bugs\" for more information on this "
3063
"feature.\nCommit refused." % fixed_bug)
3064
tag, bug_id = tokens
3646
yield bugtracker.get_bug_url(tag, branch, bug_id), status
3647
except bugtracker.UnknownBugTrackerAbbreviation:
3648
raise errors.CommandError(gettext(
3649
'Unrecognized bug %s. Commit refused.') % bug)
3650
except bugtracker.MalformedBugIdentifier as e:
3651
raise errors.CommandError(gettext(
3652
u"%s\nCommit refused.") % (e,))
3066
yield bugtracker.get_bug_url(tag, branch, bug_id)
3067
except errors.UnknownBugTrackerAbbreviation:
3068
raise errors.BzrCommandError(
3069
'Unrecognized bug %s. Commit refused.' % fixed_bug)
3070
except errors.MalformedBugIdentifier, e:
3071
raise errors.BzrCommandError(
3072
"%s\nCommit refused." % (str(e),))
3654
3074
def run(self, message=None, file=None, verbose=False, selected_list=None,
3655
unchanged=False, strict=False, local=False, fixes=None, bugs=None,
3656
author=None, show_diff=False, exclude=None, commit_time=None,
3659
from .commit import (
3075
unchanged=False, strict=False, local=False, fixes=None,
3076
author=None, show_diff=False, exclude=None, commit_time=None):
3077
from bzrlib.errors import (
3660
3078
PointlessCommit,
3662
from .errors import (
3663
3079
ConflictsInTree,
3664
3080
StrictCommitFailed
3666
from .msgeditor import (
3082
from bzrlib.msgeditor import (
3667
3083
edit_commit_message_encoded,
3668
3084
generate_commit_message_template,
3669
make_commit_message_template_encoded,
3085
make_commit_message_template_encoded
3673
3088
commit_stamp = offset = None
3674
3089
if commit_time is not None:
3676
3091
commit_stamp, offset = timestamp.parse_patch_date(commit_time)
3677
except ValueError as e:
3678
raise errors.CommandError(gettext(
3679
"Could not parse --commit-time: " + str(e)))
3092
except ValueError, e:
3093
raise errors.BzrCommandError(
3094
"Could not parse --commit-time: " + str(e))
3096
# TODO: Need a blackbox test for invoking the external editor; may be
3097
# slightly problematic to run this cross-platform.
3099
# TODO: do more checks that the commit will succeed before
3100
# spending the user's valuable time typing a commit message.
3681
3102
properties = {}
3683
tree, selected_list = WorkingTree.open_containing_paths(selected_list)
3104
tree, selected_list = tree_files(selected_list)
3684
3105
if selected_list == ['']:
3685
3106
# workaround - commit of root of tree should be exactly the same
3686
3107
# as just default commit in that tree, and succeed even though
3864
3270
class cmd_upgrade(Command):
3865
__doc__ = """Upgrade a repository, branch or working tree to a newer format.
3867
When the default format has changed after a major new release of
3868
Bazaar/Breezy, you may be informed during certain operations that you
3869
should upgrade. Upgrading to a newer format may improve performance
3870
or make new features available. It may however limit interoperability
3871
with older repositories or with older versions of Bazaar or Breezy.
3873
If you wish to upgrade to a particular format rather than the
3874
current default, that can be specified using the --format option.
3875
As a consequence, you can use the upgrade command this way to
3876
"downgrade" to an earlier format, though some conversions are
3877
a one way process (e.g. changing from the 1.x default to the
3878
2.x default) so downgrading is not always possible.
3880
A backup.bzr.~#~ directory is created at the start of the conversion
3881
process (where # is a number). By default, this is left there on
3882
completion. If the conversion fails, delete the new .bzr directory
3883
and rename this one back in its place. Use the --clean option to ask
3884
for the backup.bzr directory to be removed on successful conversion.
3885
Alternatively, you can delete it by hand if everything looks good
3888
If the location given is a shared repository, dependent branches
3889
are also converted provided the repository converts successfully.
3890
If the conversion of a branch fails, remaining branches are still
3893
For more information on upgrades, see the Breezy Upgrade Guide,
3894
https://www.breezy-vcs.org/doc/en/upgrade-guide/.
3271
__doc__ = """Upgrade branch storage to current format.
3273
The check command or bzr developers may sometimes advise you to run
3274
this command. When the default format has changed you may also be warned
3275
during other operations to upgrade.
3897
_see_also = ['check', 'reconcile', 'formats']
3278
_see_also = ['check']
3898
3279
takes_args = ['url?']
3899
3280
takes_options = [
3900
RegistryOption('format',
3901
help='Upgrade to a specific format. See "brz help'
3902
' formats" for details.',
3903
lazy_registry=('breezy.controldir', 'format_registry'),
3904
converter=lambda name: controldir.format_registry.make_controldir(
3906
value_switches=True, title='Branch format'),
3908
help='Remove the backup.bzr directory if successful.'),
3910
help="Show what would be done, but don't actually do anything."),
3281
RegistryOption('format',
3282
help='Upgrade to a specific format. See "bzr help'
3283
' formats" for details.',
3284
lazy_registry=('bzrlib.bzrdir', 'format_registry'),
3285
converter=lambda name: bzrdir.format_registry.make_bzrdir(name),
3286
value_switches=True, title='Branch format'),
3913
def run(self, url='.', format=None, clean=False, dry_run=False):
3914
from .upgrade import upgrade
3915
exceptions = upgrade(url, format, clean_up=clean, dry_run=dry_run)
3917
if len(exceptions) == 1:
3918
# Compatibility with historical behavior
3289
def run(self, url='.', format=None):
3290
from bzrlib.upgrade import upgrade
3291
upgrade(url, format)
3924
3294
class cmd_whoami(Command):
3925
__doc__ = """Show or set brz user id.
3295
__doc__ = """Show or set bzr user id.
3928
3298
Show the email of the current user::
3932
3302
Set the current user::
3934
brz whoami "Frank Chu <fchu@example.com>"
3304
bzr whoami "Frank Chu <fchu@example.com>"
3936
takes_options = ['directory',
3938
help='Display email address only.'),
3940
help='Set identity for the current branch instead of '
3306
takes_options = [ Option('email',
3307
help='Display email address only.'),
3309
help='Set identity for the current branch instead of '
3943
3312
takes_args = ['name?']
3944
3313
encoding_type = 'replace'
3946
3315
@display_command
3947
def run(self, email=False, branch=False, name=None, directory=None):
3316
def run(self, email=False, branch=False, name=None):
3948
3317
if name is None:
3949
if directory is None:
3950
# use branch if we're inside one; otherwise global config
3952
c = Branch.open_containing(u'.')[0].get_config_stack()
3953
except errors.NotBranchError:
3954
c = _mod_config.GlobalStack()
3956
c = Branch.open(directory).get_config_stack()
3957
identity = c.get('email')
3318
# use branch if we're inside one; otherwise global config
3320
c = Branch.open_containing('.')[0].get_config()
3321
except errors.NotBranchError:
3322
c = config.GlobalConfig()
3959
self.outf.write(_mod_config.extract_email_address(identity)
3324
self.outf.write(c.user_email() + '\n')
3962
self.outf.write(identity + '\n')
3326
self.outf.write(c.username() + '\n')
3966
raise errors.CommandError(gettext("--email can only be used to display existing "
3969
3329
# display a warning if an email address isn't included in the given name.
3971
_mod_config.extract_email_address(name)
3972
except _mod_config.NoEmailInUsername:
3331
config.extract_email_address(name)
3332
except errors.NoEmailInUsername, e:
3973
3333
warning('"%s" does not seem to contain an email address. '
3974
3334
'This is allowed, but not recommended.', name)
3976
3336
# use global config unless --branch given
3978
if directory is None:
3979
c = Branch.open_containing(u'.')[0].get_config_stack()
3981
b = Branch.open(directory)
3982
self.enter_context(b.lock_write())
3983
c = b.get_config_stack()
3338
c = Branch.open_containing('.')[0].get_config()
3985
c = _mod_config.GlobalStack()
3986
c.set('email', name)
3340
c = config.GlobalConfig()
3341
c.set_user_option('email', name)
3989
3344
class cmd_nick(Command):
3990
3345
__doc__ = """Print or set the branch nickname.
3992
If unset, the colocated branch name is used for colocated branches, and
3993
the branch directory name is used for other branches. To print the
3994
current nickname, execute with no argument.
3347
If unset, the tree root directory name is used as the nickname.
3348
To print the current nickname, execute with no argument.
3996
3350
Bound branches use the nickname of its master branch unless it is set
4214
3559
def run(self, testspecs_list=None, verbose=False, one=False,
4215
3560
transport=None, benchmark=None,
3561
lsprof_timed=None, cache_dir=None,
4217
3562
first=False, list_only=False,
4218
3563
randomize=None, exclude=None, strict=False,
4219
load_list=None, debugflag=None, starting_with=None, subunit1=False,
4220
subunit2=False, parallel=None, lsprof_tests=False, sync=False):
4222
# During selftest, disallow proxying, as it can cause severe
4223
# performance penalties and is only needed for thread
4224
# safety. The selftest command is assumed to not use threads
4225
# too heavily. The call should be as early as possible, as
4226
# error reporting for past duplicate imports won't have useful
4228
if sys.version_info[0] < 3:
4229
# TODO(pad.lv/1696545): Allow proxying on Python 3, since
4230
# disallowing it currently leads to failures in many places.
4231
lazy_import.disallow_proxying()
4235
except ImportError as e:
4236
raise errors.CommandError("tests not available. Install the "
4237
"breezy tests to run the breezy testsuite.")
3564
load_list=None, debugflag=None, starting_with=None, subunit=False,
3565
parallel=None, lsprof_tests=False):
3566
from bzrlib.tests import selftest
3567
import bzrlib.benchmarks as benchmarks
3568
from bzrlib.benchmarks import tree_creator
3570
# Make deprecation warnings visible, unless -Werror is set
3571
symbol_versioning.activate_deprecation_warnings(override=False)
3573
if cache_dir is not None:
3574
tree_creator.TreeCreator.CACHE_ROOT = osutils.abspath(cache_dir)
4239
3575
if testspecs_list is not None:
4240
3576
pattern = '|'.join(testspecs_list)
4245
from .tests import SubUnitBzrRunnerv1
3581
from bzrlib.tests import SubUnitBzrRunner
4246
3582
except ImportError:
4247
raise errors.CommandError(gettext(
4248
"subunit not available. subunit needs to be installed "
4249
"to use --subunit."))
4250
self.additional_selftest_args['runner_class'] = SubUnitBzrRunnerv1
3583
raise errors.BzrCommandError("subunit not available. subunit "
3584
"needs to be installed to use --subunit.")
3585
self.additional_selftest_args['runner_class'] = SubUnitBzrRunner
4251
3586
# On Windows, disable automatic conversion of '\n' to '\r\n' in
4252
# stdout, which would corrupt the subunit stream.
4253
# FIXME: This has been fixed in subunit trunk (>0.0.5) so the
4254
# following code can be deleted when it's sufficiently deployed
4255
# -- vila/mgz 20100514
4256
if (sys.platform == "win32"
4257
and getattr(sys.stdout, 'fileno', None) is not None):
3587
# stdout, which would corrupt the subunit stream.
3588
if sys.platform == "win32" and sys.stdout.fileno() >= 0:
4259
3590
msvcrt.setmode(sys.stdout.fileno(), os.O_BINARY)
4262
from .tests import SubUnitBzrRunnerv2
4264
raise errors.CommandError(gettext(
4265
"subunit not available. subunit "
4266
"needs to be installed to use --subunit2."))
4267
self.additional_selftest_args['runner_class'] = SubUnitBzrRunnerv2
4270
3592
self.additional_selftest_args.setdefault(
4271
3593
'suite_decorators', []).append(parallel)
4273
raise errors.CommandError(gettext(
4274
"--benchmark is no longer supported from brz 2.2; "
4275
"use bzr-usertest instead"))
4276
test_suite_factory = None
4278
exclude_pattern = None
3595
test_suite_factory = benchmarks.test_suite
3596
# Unless user explicitly asks for quiet, be verbose in benchmarks
3597
verbose = not is_quiet()
3598
# TODO: should possibly lock the history file...
3599
benchfile = open(".perf_history", "at", buffering=1)
3600
self.add_cleanup(benchfile.close)
4280
exclude_pattern = '(' + '|'.join(exclude) + ')'
4282
self._disable_fsync()
3602
test_suite_factory = None
4283
3604
selftest_kwargs = {"verbose": verbose,
4285
"stop_on_failure": one,
4286
"transport": transport,
4287
"test_suite_factory": test_suite_factory,
4288
"lsprof_timed": lsprof_timed,
4289
"lsprof_tests": lsprof_tests,
4290
"matching_tests_first": first,
4291
"list_only": list_only,
4292
"random_seed": randomize,
4293
"exclude_pattern": exclude_pattern,
4295
"load_list": load_list,
4296
"debug_flags": debugflag,
4297
"starting_with": starting_with
3606
"stop_on_failure": one,
3607
"transport": transport,
3608
"test_suite_factory": test_suite_factory,
3609
"lsprof_timed": lsprof_timed,
3610
"lsprof_tests": lsprof_tests,
3611
"bench_history": benchfile,
3612
"matching_tests_first": first,
3613
"list_only": list_only,
3614
"random_seed": randomize,
3615
"exclude_pattern": exclude,
3617
"load_list": load_list,
3618
"debug_flags": debugflag,
3619
"starting_with": starting_with
4299
3621
selftest_kwargs.update(self.additional_selftest_args)
4301
# Make deprecation warnings visible, unless -Werror is set
4302
cleanup = symbol_versioning.activate_deprecation_warnings(
4305
result = tests.selftest(**selftest_kwargs)
3622
result = selftest(**selftest_kwargs)
4308
3623
return int(not result)
4310
def _disable_fsync(self):
4311
"""Change the 'os' functionality to not synchronize."""
4312
self._orig_fsync = getattr(os, 'fsync', None)
4313
if self._orig_fsync is not None:
4314
os.fsync = lambda filedes: None
4315
self._orig_fdatasync = getattr(os, 'fdatasync', None)
4316
if self._orig_fdatasync is not None:
4317
os.fdatasync = lambda filedes: None
4320
3626
class cmd_version(Command):
4321
__doc__ = """Show version of brz."""
3627
__doc__ = """Show version of bzr."""
4323
3629
encoding_type = 'replace'
4324
3630
takes_options = [
4375
3680
The source of the merge can be specified either in the form of a branch,
4376
3681
or in the form of a path to a file containing a merge directive generated
4377
with brz send. If neither is specified, the default is the upstream branch
4378
or the branch most recently merged using --remember. The source of the
4379
merge may also be specified in the form of a path to a file in another
4380
branch: in this case, only the modifications to that file are merged into
4381
the current working tree.
4383
When merging from a branch, by default brz will try to merge in all new
4384
work from the other branch, automatically determining an appropriate base
4385
revision. If this fails, you may need to give an explicit base.
4387
To pick a different ending revision, pass "--revision OTHER". brz will
4388
try to merge in all new work up to and including revision OTHER.
4390
If you specify two values, "--revision BASE..OTHER", only revisions BASE
4391
through OTHER, excluding BASE but including OTHER, will be merged. If this
4392
causes some revisions to be skipped, i.e. if the destination branch does
4393
not already contain revision BASE, such a merge is commonly referred to as
4394
a "cherrypick". Unlike a normal merge, Breezy does not currently track
4395
cherrypicks. The changes look like a normal commit, and the history of the
4396
changes from the other branch is not stored in the commit.
4398
Revision numbers are always relative to the source branch.
3682
with bzr send. If neither is specified, the default is the upstream branch
3683
or the branch most recently merged using --remember.
3685
When merging a branch, by default the tip will be merged. To pick a different
3686
revision, pass --revision. If you specify two values, the first will be used as
3687
BASE and the second one as OTHER. Merging individual revisions, or a subset of
3688
available revisions, like this is commonly referred to as "cherrypicking".
3690
Revision numbers are always relative to the branch being merged.
3692
By default, bzr will try to merge in all new work from the other
3693
branch, automatically determining an appropriate base. If this
3694
fails, you may need to give an explicit base.
4400
3696
Merge will do its best to combine the changes in two branches, but there
4401
3697
are some kinds of problems only a human can fix. When it encounters those,
4402
3698
it will mark a conflict. A conflict means that you need to fix something,
4403
before you can commit.
4405
Use brz resolve when you have fixed a problem. See also brz conflicts.
4407
If there is no default branch set, the first merge will set it (use
4408
--no-remember to avoid setting it). After that, you can omit the branch
4409
to use the default. To change the default, use --remember. The value will
4410
only be saved if the remote location can be accessed.
3699
before you should commit.
3701
Use bzr resolve when you have fixed a problem. See also bzr conflicts.
3703
If there is no default branch set, the first merge will set it. After
3704
that, you can omit the branch to use the default. To change the
3705
default, use --remember. The value will only be saved if the remote
3706
location can be accessed.
4412
3708
The results of the merge are placed into the destination working
4413
directory, where they can be reviewed (with brz diff), tested, and then
3709
directory, where they can be reviewed (with bzr diff), tested, and then
4414
3710
committed to record the result of the merge.
4416
3712
merge refuses to run if there are any uncommitted changes, unless
4417
--force is given. If --force is given, then the changes from the source
4418
will be merged with the current working tree, including any uncommitted
4419
changes in the tree. The --force option can also be used to create a
3713
--force is given. The --force option can also be used to create a
4420
3714
merge revision which has more than two parents.
4422
3716
If one would like to merge changes from the working tree of the other
4510
3807
change_reporter = delta._ChangeReporter(
4511
3808
unversioned_filter=tree.is_ignored, view_info=view_info)
4512
3809
pb = ui.ui_factory.nested_progress_bar()
4513
self.enter_context(pb)
4514
self.enter_context(tree.lock_write())
3810
self.add_cleanup(pb.finished)
3811
self.add_cleanup(tree.lock_write().unlock)
4515
3812
if location is not None:
4517
mergeable = _mod_mergeable.read_mergeable_from_url(
4518
location, possible_transports=possible_transports)
3814
mergeable = bundle.read_mergeable_from_url(location,
3815
possible_transports=possible_transports)
4519
3816
except errors.NotABundle:
4520
3817
mergeable = None
4522
3819
if uncommitted:
4523
raise errors.CommandError(gettext('Cannot use --uncommitted'
4524
' with bundles or merge directives.'))
3820
raise errors.BzrCommandError('Cannot use --uncommitted'
3821
' with bundles or merge directives.')
4526
3823
if revision is not None:
4527
raise errors.CommandError(gettext(
4528
'Cannot use -r with merge directives or bundles'))
3824
raise errors.BzrCommandError(
3825
'Cannot use -r with merge directives or bundles')
4529
3826
merger, verified = _mod_merge.Merger.from_mergeable(tree,
4532
3829
if merger is None and uncommitted:
4533
3830
if revision is not None and len(revision) > 0:
4534
raise errors.CommandError(gettext('Cannot use --uncommitted and'
4535
' --revision at the same time.'))
3831
raise errors.BzrCommandError('Cannot use --uncommitted and'
3832
' --revision at the same time.')
4536
3833
merger = self.get_merger_from_uncommitted(tree, location, None)
4537
3834
allow_pending = False
4539
3836
if merger is None:
4540
3837
merger, allow_pending = self._get_merger_from_branch(tree,
4541
location, revision, remember, possible_transports, None)
3838
location, revision, remember, possible_transports, None)
4543
3840
merger.merge_type = merge_type
4544
3841
merger.reprocess = reprocess
4545
3842
merger.show_base = show_base
4546
3843
self.sanity_check_merger(merger)
4547
3844
if (merger.base_rev_id == merger.other_rev_id and
4548
merger.other_rev_id is not None):
4549
# check if location is a nonexistent file (and not a branch) to
4550
# disambiguate the 'Nothing to do'
4551
if merger.interesting_files:
4552
if not merger.other_tree.has_filename(
4553
merger.interesting_files[0]):
4554
note(gettext("merger: ") + str(merger))
4555
raise errors.PathsDoNotExist([location])
4556
note(gettext('Nothing to do.'))
3845
merger.other_rev_id is not None):
3846
note('Nothing to do.')
4558
if pull and not preview:
4559
3849
if merger.interesting_files is not None:
4560
raise errors.CommandError(
4561
gettext('Cannot pull individual files'))
3850
raise errors.BzrCommandError('Cannot pull individual files')
4562
3851
if (merger.base_rev_id == tree.last_revision()):
4563
3852
result = tree.pull(merger.other_branch, False,
4564
3853
merger.other_rev_id)
4565
3854
result.report(self.outf)
4567
3856
if merger.this_basis is None:
4568
raise errors.CommandError(gettext(
3857
raise errors.BzrCommandError(
4569
3858
"This branch has no commits."
4570
" (perhaps you would prefer 'brz pull')"))
3859
" (perhaps you would prefer 'bzr pull')")
4572
3861
return self._do_preview(merger)
4573
3862
elif interactive:
4779
4049
Re-do the merge of all conflicted files, and show the base text in
4780
4050
conflict regions, in addition to the usual THIS and OTHER texts::
4782
brz remerge --show-base
4052
bzr remerge --show-base
4784
4054
Re-do the merge of "foobar", using the weave merge algorithm, with
4785
4055
additional processing to reduce the size of conflict regions::
4787
brz remerge --merge-type weave --reprocess foobar
4057
bzr remerge --merge-type weave --reprocess foobar
4789
4059
takes_args = ['file*']
4790
4060
takes_options = [
4794
help="Show base revision text in conflicts."),
4064
help="Show base revision text in conflicts."),
4797
4067
def run(self, file_list=None, merge_type=None, show_base=False,
4798
4068
reprocess=False):
4799
from .conflicts import restore
4069
from bzrlib.conflicts import restore
4800
4070
if merge_type is None:
4801
4071
merge_type = _mod_merge.Merge3Merger
4802
tree, file_list = WorkingTree.open_containing_paths(file_list)
4803
self.enter_context(tree.lock_write())
4072
tree, file_list = tree_files(file_list)
4073
self.add_cleanup(tree.lock_write().unlock)
4804
4074
parents = tree.get_parent_ids()
4805
4075
if len(parents) != 2:
4806
raise errors.CommandError(
4807
gettext("Sorry, remerge only works after normal"
4808
" merges. Not cherrypicking or multi-merges."))
4809
interesting_files = None
4076
raise errors.BzrCommandError("Sorry, remerge only works after normal"
4077
" merges. Not cherrypicking or"
4079
repository = tree.branch.repository
4080
interesting_ids = None
4810
4081
new_conflicts = []
4811
4082
conflicts = tree.conflicts()
4812
4083
if file_list is not None:
4813
interesting_files = set()
4084
interesting_ids = set()
4814
4085
for filename in file_list:
4815
if not tree.is_versioned(filename):
4086
file_id = tree.path2id(filename)
4816
4088
raise errors.NotVersionedError(filename)
4817
interesting_files.add(filename)
4818
if tree.kind(filename) != "directory":
4089
interesting_ids.add(file_id)
4090
if tree.kind(file_id) != "directory":
4821
for path, ie in tree.iter_entries_by_dir(
4822
specific_files=[filename]):
4823
interesting_files.add(path)
4093
for name, ie in tree.inventory.iter_entries(file_id):
4094
interesting_ids.add(ie.file_id)
4824
4095
new_conflicts = conflicts.select_conflicts(tree, file_list)[0]
4826
4097
# Remerge only supports resolving contents conflicts
4827
4098
allowed_conflicts = ('text conflict', 'contents conflict')
4828
4099
restore_files = [c.path for c in conflicts
4829
4100
if c.typestring in allowed_conflicts]
4830
_mod_merge.transform_tree(tree, tree.basis_tree(), interesting_files)
4831
tree.set_conflicts(new_conflicts)
4101
_mod_merge.transform_tree(tree, tree.basis_tree(), interesting_ids)
4102
tree.set_conflicts(ConflictList(new_conflicts))
4832
4103
if file_list is not None:
4833
4104
restore_files = file_list
4834
4105
for filename in restore_files:
5284
4542
Option('long', help='Show commit date in annotations.'),
5289
4546
encoding_type = 'exact'
5291
4548
@display_command
5292
4549
def run(self, filename, all=False, long=False, revision=None,
5293
show_ids=False, directory=None):
5294
from .annotate import (
4551
from bzrlib.annotate import annotate_file, annotate_file_tree
5297
4552
wt, branch, relpath = \
5298
_open_directory_or_containing_tree_or_branch(filename, directory)
4553
bzrdir.BzrDir.open_containing_tree_or_branch(filename)
5299
4554
if wt is not None:
5300
self.enter_context(wt.lock_read())
4555
self.add_cleanup(wt.lock_read().unlock)
5302
self.enter_context(branch.lock_read())
4557
self.add_cleanup(branch.lock_read().unlock)
5303
4558
tree = _get_one_revision_tree('annotate', revision, branch=branch)
5304
self.enter_context(tree.lock_read())
4559
self.add_cleanup(tree.lock_read().unlock)
4561
file_id = wt.path2id(relpath)
4563
file_id = tree.path2id(relpath)
4565
raise errors.NotVersionedError(filename)
4566
file_version = tree.inventory[file_id].revision
5305
4567
if wt is not None and revision is None:
5306
if not wt.is_versioned(relpath):
5307
raise errors.NotVersionedError(relpath)
5308
4568
# If there is a tree and we're not annotating historical
5309
4569
# versions, annotate the working tree's content.
5310
annotate_file_tree(wt, relpath, self.outf, long, all,
4570
annotate_file_tree(wt, file_id, self.outf, long, all,
5313
if not tree.is_versioned(relpath):
5314
raise errors.NotVersionedError(relpath)
5315
annotate_file_tree(tree, relpath, self.outf, long, all,
5316
show_ids=show_ids, branch=branch)
4573
annotate_file(branch, file_version, file_id, long, all, self.outf,
5319
4577
class cmd_re_sign(Command):
5320
4578
__doc__ = """Create a digital signature for an existing revision."""
5321
4579
# TODO be able to replace existing ones.
5323
hidden = True # is this right ?
4581
hidden = True # is this right ?
5324
4582
takes_args = ['revision_id*']
5325
takes_options = ['directory', 'revision']
4583
takes_options = ['revision']
5327
def run(self, revision_id_list=None, revision=None, directory=u'.'):
4585
def run(self, revision_id_list=None, revision=None):
5328
4586
if revision_id_list is not None and revision is not None:
5329
raise errors.CommandError(
5330
gettext('You can only supply one of revision_id or --revision'))
4587
raise errors.BzrCommandError('You can only supply one of revision_id or --revision')
5331
4588
if revision_id_list is None and revision is None:
5332
raise errors.CommandError(
5333
gettext('You must supply either --revision or a revision_id'))
5334
b = WorkingTree.open_containing(directory)[0].branch
5335
self.enter_context(b.lock_write())
4589
raise errors.BzrCommandError('You must supply either --revision or a revision_id')
4590
b = WorkingTree.open_containing(u'.')[0].branch
4591
self.add_cleanup(b.lock_write().unlock)
5336
4592
return self._run(b, revision_id_list, revision)
5338
4594
def _run(self, b, revision_id_list, revision):
5339
from .repository import WriteGroup
5340
gpg_strategy = gpg.GPGStrategy(b.get_config_stack())
4595
import bzrlib.gpg as gpg
4596
gpg_strategy = gpg.GPGStrategy(b.get_config())
5341
4597
if revision_id_list is not None:
5342
with WriteGroup(b.repository):
4598
b.repository.start_write_group()
5343
4600
for revision_id in revision_id_list:
5344
revision_id = cache_utf8.encode(revision_id)
5345
4601
b.repository.sign_revision(revision_id, gpg_strategy)
4603
b.repository.abort_write_group()
4606
b.repository.commit_write_group()
5346
4607
elif revision is not None:
5347
4608
if len(revision) == 1:
5348
4609
revno, rev_id = revision[0].in_history(b)
5349
with WriteGroup(b.repository):
4610
b.repository.start_write_group()
5350
4612
b.repository.sign_revision(rev_id, gpg_strategy)
4614
b.repository.abort_write_group()
4617
b.repository.commit_write_group()
5351
4618
elif len(revision) == 2:
5352
4619
# are they both on rh- if so we can walk between them
5353
4620
# might be nice to have a range helper for arbitrary
5521
4785
end_revision=last_revno)
5524
self.outf.write(gettext('Dry-run, pretending to remove'
5525
' the above revisions.\n'))
4788
self.outf.write('Dry-run, pretending to remove'
4789
' the above revisions.\n')
5528
gettext('The above revision(s) will be removed.\n'))
4791
self.outf.write('The above revision(s) will be removed.\n')
5531
if not ui.ui_factory.confirm_action(
5532
gettext(u'Uncommit these revisions'),
5533
'breezy.builtins.uncommit',
5535
self.outf.write(gettext('Canceled\n'))
4794
if not ui.ui_factory.get_boolean('Are you sure'):
4795
self.outf.write('Canceled')
5538
4798
mutter('Uncommitting from {%s} to {%s}',
5539
4799
last_rev_id, rev_id)
5540
4800
uncommit(b, tree=tree, dry_run=dry_run, verbose=verbose,
5541
revno=revno, local=local, keep_tags=keep_tags)
5544
gettext('You can restore the old tip by running:\n'
5545
' brz pull -d %s %s -r revid:%s\n')
5546
% (location, location, last_rev_id.decode('utf-8')))
5549
gettext('You can restore the old tip by running:\n'
5550
' brz pull . -r revid:%s\n')
5551
% last_rev_id.decode('utf-8'))
4801
revno=revno, local=local)
4802
self.outf.write('You can restore the old tip by running:\n'
4803
' bzr pull . -r revid:%s\n' % last_rev_id)
5554
4806
class cmd_break_lock(Command):
5555
__doc__ = """Break a dead lock.
5557
This command breaks a lock on a repository, branch, working directory or
4807
__doc__ = """Break a dead lock on a repository, branch or working directory.
5560
4809
CAUTION: Locks should only be broken when you are sure that the process
5561
4810
holding the lock has been stopped.
5563
You can get information on what locks are open via the 'brz info
4812
You can get information on what locks are open via the 'bzr info
5564
4813
[location]' command.
5568
brz break-lock brz+ssh://example.com/brz/foo
5569
brz break-lock --conf ~/.config/breezy
4817
bzr break-lock bzr+ssh://example.com/bzr/foo
5572
4819
takes_args = ['location?']
5575
help='LOCATION is the directory where the config lock is.'),
5577
help='Do not ask for confirmation before breaking the lock.'),
5580
def run(self, location=None, config=False, force=False):
4821
def run(self, location=None, show=False):
5581
4822
if location is None:
5582
4823
location = u'.'
5584
ui.ui_factory = ui.ConfirmationUserInterfacePolicy(ui.ui_factory,
5586
{'breezy.lockdir.break': True})
5588
conf = _mod_config.LockableConfig(file_name=location)
5591
control, relpath = controldir.ControlDir.open_containing(location)
5593
control.break_lock()
5594
except NotImplementedError:
4824
control, relpath = bzrdir.BzrDir.open_containing(location)
4826
control.break_lock()
4827
except NotImplementedError:
5598
4831
class cmd_wait_until_signalled(Command):
5599
__doc__ = """Test helper for test_start_and_stop_brz_subprocess_send_signal.
4832
__doc__ = """Test helper for test_start_and_stop_bzr_subprocess_send_signal.
5601
4834
This just prints a line to signal when it is ready, then blocks on stdin.
5619
4852
help='Serve on stdin/out for use from inetd or sshd.'),
5620
4853
RegistryOption('protocol',
5621
help="Protocol to serve.",
5622
lazy_registry=('breezy.transport',
5623
'transport_server_registry'),
5624
value_switches=True),
5626
help='Listen for connections on nominated address.',
4854
help="Protocol to serve.",
4855
lazy_registry=('bzrlib.transport', 'transport_server_registry'),
4856
value_switches=True),
5629
help='Listen for connections on nominated port. Passing 0 as '
5630
'the port number will result in a dynamically allocated '
5631
'port. The default port depends on the protocol.',
5633
custom_help('directory',
5634
help='Serve contents of this directory.'),
4858
help='Listen for connections on nominated port of the form '
4859
'[hostname:]portnumber. Passing 0 as the port number will '
4860
'result in a dynamically allocated port. The default port '
4861
'depends on the protocol.',
4864
help='Serve contents of this directory.',
5635
4866
Option('allow-writes',
5636
4867
help='By default the server is a readonly server. Supplying '
5637
4868
'--allow-writes enables write access to the contents of '
5638
'the served directory and below. Note that ``brz serve`` '
4869
'the served directory and below. Note that ``bzr serve`` '
5639
4870
'does not perform authentication, so unless some form of '
5640
4871
'external authentication is arranged supplying this '
5641
4872
'option leads to global uncontrolled write access to your '
5644
Option('client-timeout', type=float,
5645
help='Override the default idle client timeout (5min).'),
5648
def run(self, listen=None, port=None, inet=False, directory=None,
5649
allow_writes=False, protocol=None, client_timeout=None):
5650
from . import location, transport
4877
def get_host_and_port(self, port):
4878
"""Return the host and port to run the smart server on.
4880
If 'port' is None, None will be returned for the host and port.
4882
If 'port' has a colon in it, the string before the colon will be
4883
interpreted as the host.
4885
:param port: A string of the port to run the server on.
4886
:return: A tuple of (host, port), where 'host' is a host name or IP,
4887
and port is an integer TCP/IP port.
4890
if port is not None:
4892
host, port = port.split(':')
4896
def run(self, port=None, inet=False, directory=None, allow_writes=False,
4898
from bzrlib.transport import get_transport, transport_server_registry
5651
4899
if directory is None:
5652
directory = osutils.getcwd()
4900
directory = os.getcwd()
5653
4901
if protocol is None:
5654
protocol = transport.transport_server_registry.get()
5655
url = location.location_to_url(directory)
4902
protocol = transport_server_registry.get()
4903
host, port = self.get_host_and_port(port)
4904
url = urlutils.local_path_to_url(directory)
5656
4905
if not allow_writes:
5657
4906
url = 'readonly+' + url
5658
t = transport.get_transport_from_url(url)
5659
protocol(t, listen, port, inet, client_timeout)
4907
transport = get_transport(url)
4908
protocol(transport, host, port, inet)
5662
4911
class cmd_join(Command):
6198
5432
takes_args = ['location?']
6199
5433
takes_options = [
6200
5434
RegistryOption.from_kwargs(
6203
help='The relation between branch and tree.',
5436
title='Target type',
5437
help='The type to reconfigure the directory to.',
6204
5438
value_switches=True, enum_switch=False,
6205
5439
branch='Reconfigure to be an unbound branch with no working tree.',
6206
5440
tree='Reconfigure to be an unbound branch with a working tree.',
6207
5441
checkout='Reconfigure to be a bound branch with a working tree.',
6208
5442
lightweight_checkout='Reconfigure to be a lightweight'
6209
' checkout (with no local history).',
6211
RegistryOption.from_kwargs(
6213
title='Repository type',
6214
help='Location fo the repository.',
6215
value_switches=True, enum_switch=False,
5443
' checkout (with no local history).',
6216
5444
standalone='Reconfigure to be a standalone branch '
6217
'(i.e. stop using shared repository).',
5445
'(i.e. stop using shared repository).',
6218
5446
use_shared='Reconfigure to use a shared repository.',
6220
RegistryOption.from_kwargs(
6222
title='Trees in Repository',
6223
help='Whether new branches in the repository have trees.',
6224
value_switches=True, enum_switch=False,
6225
5447
with_trees='Reconfigure repository to create '
6226
'working trees on branches by default.',
5448
'working trees on branches by default.',
6227
5449
with_no_trees='Reconfigure repository to not create '
6228
'working trees on branches by default.'
5450
'working trees on branches by default.'
6230
Option('bind-to', help='Branch to bind checkout to.', type=text_type),
5452
Option('bind-to', help='Branch to bind checkout to.', type=str),
6231
5453
Option('force',
6232
help='Perform reconfiguration even if local changes'
5454
help='Perform reconfiguration even if local changes'
6234
5456
Option('stacked-on',
6235
help='Reconfigure a branch to be stacked on another branch.',
5457
help='Reconfigure a branch to be stacked on another branch.',
6238
5460
Option('unstacked',
6239
help='Reconfigure a branch to be unstacked. This '
6240
'may require copying substantial data into it.',
5461
help='Reconfigure a branch to be unstacked. This '
5462
'may require copying substantial data into it.',
6244
def run(self, location=None, bind_to=None, force=False,
6245
tree_type=None, repository_type=None, repository_trees=None,
6246
stacked_on=None, unstacked=None):
6247
directory = controldir.ControlDir.open(location)
5466
def run(self, location=None, target_type=None, bind_to=None, force=False,
5469
directory = bzrdir.BzrDir.open(location)
6248
5470
if stacked_on and unstacked:
6249
raise errors.CommandError(
6250
gettext("Can't use both --stacked-on and --unstacked"))
5471
raise BzrCommandError("Can't use both --stacked-on and --unstacked")
6251
5472
elif stacked_on is not None:
6252
5473
reconfigure.ReconfigureStackedOn().apply(directory, stacked_on)
6253
5474
elif unstacked:
6321
5531
takes_args = ['to_location?']
6322
takes_options = ['directory',
6324
help='Switch even if local commits will be lost.'),
5532
takes_options = [Option('force',
5533
help='Switch even if local commits will be lost.'),
6326
5535
Option('create-branch', short_name='b',
6327
help='Create the target branch from this one before'
6328
' switching to it.'),
6330
help='Store and restore uncommitted changes in the'
5536
help='Create the target branch from this one before'
5537
' switching to it.'),
6334
5540
def run(self, to_location=None, force=False, create_branch=False,
6335
revision=None, directory=u'.', store=False):
6336
from . import switch
6337
tree_location = directory
5542
from bzrlib import switch
6338
5544
revision = _get_one_revision('switch', revision)
6339
control_dir = controldir.ControlDir.open_containing(tree_location)[0]
6340
possible_transports = [control_dir.root_transport]
5545
control_dir = bzrdir.BzrDir.open_containing(tree_location)[0]
6341
5546
if to_location is None:
6342
5547
if revision is None:
6343
raise errors.CommandError(gettext('You must supply either a'
6344
' revision or a location'))
6345
to_location = tree_location
5548
raise errors.BzrCommandError('You must supply either a'
5549
' revision or a location')
6347
branch = control_dir.open_branch(
6348
possible_transports=possible_transports)
5552
branch = control_dir.open_branch()
6349
5553
had_explicit_nick = branch.get_config().has_explicit_nickname()
6350
5554
except errors.NotBranchError:
6352
5556
had_explicit_nick = False
6354
possible_transports.append(branch.user_transport)
6355
5557
if create_branch:
6356
5558
if branch is None:
6357
raise errors.CommandError(
6358
gettext('cannot create branch without source branch'))
6359
to_location = lookup_new_sibling_branch(
6360
control_dir, to_location,
6361
possible_transports=possible_transports)
6362
if revision is not None:
6363
revision = revision.as_revision_id(branch)
6364
to_branch = branch.controldir.sprout(
6366
possible_transports=possible_transports,
6367
revision_id=revision,
6368
source_branch=branch).open_branch()
5559
raise errors.BzrCommandError('cannot create branch without'
5561
to_location = directory_service.directories.dereference(
5563
if '/' not in to_location and '\\' not in to_location:
5564
# This path is meant to be relative to the existing branch
5565
this_url = self._get_branch_location(control_dir)
5566
to_location = urlutils.join(this_url, '..', to_location)
5567
to_branch = branch.bzrdir.sprout(to_location,
5568
possible_transports=[branch.bzrdir.root_transport],
5569
source_branch=branch).open_branch()
5572
to_branch = Branch.open(to_location)
5573
except errors.NotBranchError:
5574
this_url = self._get_branch_location(control_dir)
6371
5575
to_branch = Branch.open(
6372
to_location, possible_transports=possible_transports)
6373
except errors.NotBranchError:
6374
to_branch = open_sibling_branch(
6375
control_dir, to_location,
6376
possible_transports=possible_transports)
6377
if revision is not None:
6378
revision = revision.as_revision_id(to_branch)
6379
possible_transports.append(to_branch.user_transport)
6381
switch.switch(control_dir, to_branch, force, revision_id=revision,
6382
store_uncommitted=store,
6383
possible_transports=possible_transports)
6384
except controldir.BranchReferenceLoop:
6385
raise errors.CommandError(
6386
gettext('switching would create a branch reference loop. '
6387
'Use the "bzr up" command to switch to a '
6388
'different revision.'))
5576
urlutils.join(this_url, '..', to_location))
5577
if revision is not None:
5578
revision = revision.as_revision_id(to_branch)
5579
switch.switch(control_dir, to_branch, force, revision_id=revision)
6389
5580
if had_explicit_nick:
6390
branch = control_dir.open_branch() # get the new branch!
5581
branch = control_dir.open_branch() #get the new branch!
6391
5582
branch.nick = to_branch.nick
6393
if to_branch.controldir.control_url != control_dir.control_url:
6394
note(gettext('Switched to branch %s at %s'),
6395
to_branch.name, urlutils.unescape_for_display(to_branch.base, 'utf-8'))
5583
note('Switched to branch: %s',
5584
urlutils.unescape_for_display(to_branch.base, 'utf-8'))
5586
def _get_branch_location(self, control_dir):
5587
"""Return location of branch for this control dir."""
5589
this_branch = control_dir.open_branch()
5590
# This may be a heavy checkout, where we want the master branch
5591
master_location = this_branch.get_bound_location()
5592
if master_location is not None:
5593
return master_location
5594
# If not, use a local sibling
5595
return this_branch.base
5596
except errors.NotBranchError:
5597
format = control_dir.find_branch_format()
5598
if getattr(format, 'get_reference', None) is not None:
5599
return format.get_reference(control_dir)
6397
note(gettext('Switched to branch %s'), to_branch.name)
6399
note(gettext('Switched to branch at %s'),
6400
urlutils.unescape_for_display(to_branch.base, 'utf-8'))
5601
return control_dir.root_transport.base
6403
5604
class cmd_view(Command):
6787
5953
takes_args = ['path?', 'location?']
6790
Option('force-unversioned',
6791
help='Set reference even if path is not versioned.'),
6794
def run(self, path=None, directory='.', location=None, force_unversioned=False):
6795
tree, branch, relpath = (
6796
controldir.ControlDir.open_containing_tree_or_branch(directory))
5955
def run(self, path=None, location=None):
5957
if path is not None:
5959
tree, branch, relpath =(
5960
bzrdir.BzrDir.open_containing_tree_or_branch(branchdir))
5961
if path is not None:
6797
5963
if tree is None:
6798
5964
tree = branch.basis_tree()
6799
5965
if path is None:
6800
with tree.lock_read():
6802
(path, tree.get_reference_info(path, branch))
6803
for path in tree.iter_references()]
6804
self._display_reference_info(tree, branch, info)
5966
info = branch._get_all_reference_info().iteritems()
5967
self._display_reference_info(tree, branch, info)
6806
if not tree.is_versioned(path) and not force_unversioned:
5969
file_id = tree.path2id(path)
6807
5971
raise errors.NotVersionedError(path)
6808
5972
if location is None:
6809
info = [(path, tree.get_reference_info(path, branch))]
5973
info = [(file_id, branch.get_reference_info(file_id))]
6810
5974
self._display_reference_info(tree, branch, info)
6812
tree.set_reference_info(path, location)
5976
branch.set_reference_info(file_id, path, location)
6814
5978
def _display_reference_info(self, tree, branch, info):
6816
for path, location in info:
5980
for file_id, (path, location) in info:
5982
path = tree.id2path(file_id)
5983
except errors.NoSuchId:
6817
5985
ref_list.append((path, location))
6818
5986
for path, location in sorted(ref_list):
6819
5987
self.outf.write('%s %s\n' % (path, location))
6822
class cmd_export_pot(Command):
6823
__doc__ = """Export command helps and error messages in po format."""
6826
takes_options = [Option('plugin',
6827
help='Export help text from named command '
6828
'(defaults to all built in commands).',
6830
Option('include-duplicates',
6831
help='Output multiple copies of the same msgid '
6832
'string if it appears more than once.'),
6835
def run(self, plugin=None, include_duplicates=False):
6836
from .export_pot import export_pot
6837
export_pot(self.outf, plugin, include_duplicates)
6840
class cmd_import(Command):
6841
__doc__ = """Import sources from a directory, tarball or zip file
6843
This command will import a directory, tarball or zip file into a bzr
6844
tree, replacing any versioned files already present. If a directory is
6845
specified, it is used as the target. If the directory does not exist, or
6846
is not versioned, it is created.
6848
Tarballs may be gzip or bzip2 compressed. This is autodetected.
6850
If the tarball or zip has a single root directory, that directory is
6851
stripped when extracting the tarball. This is not done for directories.
6854
takes_args = ['source', 'tree?']
6856
def run(self, source, tree=None):
6857
from .upstream_import import do_import
6858
do_import(source, tree)
6861
class cmd_link_tree(Command):
6862
__doc__ = """Hardlink matching files to another tree.
6864
Only files with identical content and execute bit will be linked.
6867
takes_args = ['location']
6869
def run(self, location):
6870
from .transform import link_tree
6871
target_tree = WorkingTree.open_containing(".")[0]
6872
source_tree = WorkingTree.open(location)
6873
with target_tree.lock_write(), source_tree.lock_read():
6874
link_tree(target_tree, source_tree)
6877
class cmd_fetch_ghosts(Command):
6878
__doc__ = """Attempt to retrieve ghosts from another branch.
6880
If the other branch is not supplied, the last-pulled branch is used.
6884
aliases = ['fetch-missing']
6885
takes_args = ['branch?']
6886
takes_options = [Option('no-fix', help="Skip additional synchonization.")]
6888
def run(self, branch=None, no_fix=False):
6889
from .fetch_ghosts import GhostFetcher
6890
installed, failed = GhostFetcher.from_cmdline(branch).run()
6891
if len(installed) > 0:
6892
self.outf.write("Installed:\n")
6893
for rev in installed:
6894
self.outf.write(rev.decode('utf-8') + "\n")
6896
self.outf.write("Still missing:\n")
6898
self.outf.write(rev.decode('utf-8') + "\n")
6899
if not no_fix and len(installed) > 0:
6900
cmd_reconcile().run(".")
6903
class cmd_grep(Command):
6904
"""Print lines matching PATTERN for specified files and revisions.
6906
This command searches the specified files and revisions for a given
6907
pattern. The pattern is specified as a Python regular expressions[1].
6909
If the file name is not specified, the revisions starting with the
6910
current directory are searched recursively. If the revision number is
6911
not specified, the working copy is searched. To search the last committed
6912
revision, use the '-r -1' or '-r last:1' option.
6914
Unversioned files are not searched unless explicitly specified on the
6915
command line. Unversioned directores are not searched.
6917
When searching a pattern, the output is shown in the 'filepath:string'
6918
format. If a revision is explicitly searched, the output is shown as
6919
'filepath~N:string', where N is the revision number.
6921
--include and --exclude options can be used to search only (or exclude
6922
from search) files with base name matches the specified Unix style GLOB
6923
pattern. The GLOB pattern an use *, ?, and [...] as wildcards, and \\
6924
to quote wildcard or backslash character literally. Note that the glob
6925
pattern is not a regular expression.
6927
[1] http://docs.python.org/library/re.html#regular-expression-syntax
6930
encoding_type = 'replace'
6931
takes_args = ['pattern', 'path*']
6935
Option('color', type=text_type, argname='when',
6936
help='Show match in color. WHEN is never, always or auto.'),
6937
Option('diff', short_name='p',
6938
help='Grep for pattern in changeset for each revision.'),
6939
ListOption('exclude', type=text_type, argname='glob', short_name='X',
6940
help="Skip files whose base name matches GLOB."),
6941
ListOption('include', type=text_type, argname='glob', short_name='I',
6942
help="Search only files whose base name matches GLOB."),
6943
Option('files-with-matches', short_name='l',
6944
help='Print only the name of each input file in '
6945
'which PATTERN is found.'),
6946
Option('files-without-match', short_name='L',
6947
help='Print only the name of each input file in '
6948
'which PATTERN is not found.'),
6949
Option('fixed-string', short_name='F',
6950
help='Interpret PATTERN is a single fixed string (not regex).'),
6952
help='Search for pattern starting from the root of the branch. '
6953
'(implies --recursive)'),
6954
Option('ignore-case', short_name='i',
6955
help='Ignore case distinctions while matching.'),
6957
help='Number of levels to display - 0 for all, 1 for collapsed '
6960
type=_parse_levels),
6961
Option('line-number', short_name='n',
6962
help='Show 1-based line number.'),
6963
Option('no-recursive',
6964
help="Don't recurse into subdirectories. (default is --recursive)"),
6965
Option('null', short_name='Z',
6966
help='Write an ASCII NUL (\\0) separator '
6967
'between output lines rather than a newline.'),
6971
def run(self, verbose=False, ignore_case=False, no_recursive=False,
6972
from_root=False, null=False, levels=None, line_number=False,
6973
path_list=None, revision=None, pattern=None, include=None,
6974
exclude=None, fixed_string=False, files_with_matches=False,
6975
files_without_match=False, color=None, diff=False):
6976
from breezy import _termcolor
6979
if path_list is None:
6983
raise errors.CommandError(
6984
'cannot specify both --from-root and PATH.')
6986
if files_with_matches and files_without_match:
6987
raise errors.CommandError(
6988
'cannot specify both '
6989
'-l/--files-with-matches and -L/--files-without-matches.')
6991
global_config = _mod_config.GlobalConfig()
6994
color = global_config.get_user_option('grep_color')
6999
if color not in ['always', 'never', 'auto']:
7000
raise errors.CommandError('Valid values for --color are '
7001
'"always", "never" or "auto".')
7007
if revision is not None or levels == 0:
7008
# print revision numbers as we may be showing multiple revisions
7015
if not ignore_case and grep.is_fixed_string(pattern):
7016
# if the pattern isalnum, implicitly use to -F for faster grep
7018
elif ignore_case and fixed_string:
7019
# GZ 2010-06-02: Fall back to regexp rather than lowercasing
7020
# pattern and text which will cause pain later
7021
fixed_string = False
7022
pattern = re.escape(pattern)
7025
re_flags = re.MULTILINE
7027
re_flags |= re.IGNORECASE
7029
if not fixed_string:
7030
patternc = grep.compile_pattern(
7031
pattern.encode(grep._user_encoding), re_flags)
7033
if color == 'always':
7035
elif color == 'never':
7037
elif color == 'auto':
7038
show_color = _termcolor.allow_color()
7040
opts = grep.GrepOptions()
7042
opts.verbose = verbose
7043
opts.ignore_case = ignore_case
7044
opts.no_recursive = no_recursive
7045
opts.from_root = from_root
7047
opts.levels = levels
7048
opts.line_number = line_number
7049
opts.path_list = path_list
7050
opts.revision = revision
7051
opts.pattern = pattern
7052
opts.include = include
7053
opts.exclude = exclude
7054
opts.fixed_string = fixed_string
7055
opts.files_with_matches = files_with_matches
7056
opts.files_without_match = files_without_match
7060
opts.eol_marker = eol_marker
7061
opts.print_revno = print_revno
7062
opts.patternc = patternc
7063
opts.recursive = not no_recursive
7064
opts.fixed_string = fixed_string
7065
opts.outf = self.outf
7066
opts.show_color = show_color
7070
# files_with_matches, files_without_match
7071
# levels(?), line_number, from_root
7073
# These are silently ignored.
7074
grep.grep_diff(opts)
7075
elif revision is None:
7076
grep.workingtree_grep(opts)
7078
grep.versioned_grep(opts)
7081
class cmd_patch(Command):
7082
"""Apply a named patch to the current tree.
7086
takes_args = ['filename?']
7087
takes_options = [Option('strip', type=int, short_name='p',
7088
help=("Strip the smallest prefix containing num "
7089
"leading slashes from filenames.")),
7090
Option('silent', help='Suppress chatter.')]
7092
def run(self, filename=None, strip=None, silent=False):
7093
from .patch import patch_tree
7094
wt = WorkingTree.open_containing('.')[0]
7098
if filename is None:
7099
my_file = getattr(sys.stdin, 'buffer', sys.stdin)
7101
my_file = open(filename, 'rb')
7102
patches = [my_file.read()]
7103
return patch_tree(wt, patches, strip, quiet=is_quiet(), out=self.outf)
7106
class cmd_resolve_location(Command):
7107
__doc__ = """Expand a location to a full URL.
7110
Look up a Launchpad URL.
7112
brz resolve-location lp:brz
7114
takes_args = ['location']
7117
def run(self, location):
7118
from .location import location_to_url
7119
url = location_to_url(location)
7120
display_url = urlutils.unescape_for_display(url, self.outf.encoding)
7121
self.outf.write('%s\n' % display_url)
7124
5990
def _register_lazy_builtins():
7125
5991
# register lazy builtins from other modules; called at startup and should
7126
5992
# be only called once.
7127
5993
for (name, aliases, module_name) in [
7128
('cmd_bisect', [], 'breezy.bisect'),
7129
('cmd_bundle_info', [], 'breezy.bzr.bundle.commands'),
7130
('cmd_config', [], 'breezy.config'),
7131
('cmd_dump_btree', [], 'breezy.bzr.debug_commands'),
7132
('cmd_file_id', [], 'breezy.bzr.debug_commands'),
7133
('cmd_file_path', [], 'breezy.bzr.debug_commands'),
7134
('cmd_version_info', [], 'breezy.cmd_version_info'),
7135
('cmd_resolve', ['resolved'], 'breezy.conflicts'),
7136
('cmd_conflicts', [], 'breezy.conflicts'),
7137
('cmd_ping', [], 'breezy.bzr.smart.ping'),
7138
('cmd_sign_my_commits', [], 'breezy.commit_signature_commands'),
7139
('cmd_verify_signatures', [], 'breezy.commit_signature_commands'),
7140
('cmd_test_script', [], 'breezy.cmd_test_script'),
5994
('cmd_bundle_info', [], 'bzrlib.bundle.commands'),
5995
('cmd_dpush', [], 'bzrlib.foreign'),
5996
('cmd_version_info', [], 'bzrlib.cmd_version_info'),
5997
('cmd_resolve', ['resolved'], 'bzrlib.conflicts'),
5998
('cmd_conflicts', [], 'bzrlib.conflicts'),
5999
('cmd_sign_my_commits', [], 'bzrlib.sign_my_commits'),
7142
6001
builtin_command_registry.register_lazy(name, aliases, module_name)