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 bzr commands"""
17
"""builtin brz commands"""
19
from __future__ import absolute_import
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,
41
50
merge as _mod_merge,
51
mergeable as _mod_mergeable,
46
56
revision as _mod_revision,
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
65
from breezy.branch import Branch
66
from breezy.conflicts import ConflictList
67
from breezy.transport import memory
68
from breezy.smtp_connection import SMTPConnection
69
from breezy.workingtree import WorkingTree
70
from breezy.i18n import gettext, ngettext
63
from bzrlib.commands import (
73
from .commands import (
65
75
builtin_command_registry,
68
from bzrlib.option import (
73
83
_parse_revision_str,
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]))
85
from .revisionspec import (
95
from .trace import mutter, note, warning, is_quiet, get_verbosity_level
98
def _get_branch_location(control_dir, possible_transports=None):
99
"""Return location of branch for this control dir."""
101
target = control_dir.get_branch_reference()
102
except errors.NotBranchError:
103
return control_dir.root_transport.base
104
if target is not None:
106
this_branch = control_dir.open_branch(
107
possible_transports=possible_transports)
108
# This may be a heavy checkout, where we want the master branch
109
master_location = this_branch.get_bound_location()
110
if master_location is not None:
111
return master_location
112
# If not, use a local sibling
113
return this_branch.base
116
def _is_colocated(control_dir, possible_transports=None):
117
"""Check if the branch in control_dir is colocated.
119
:param control_dir: Control directory
120
:return: Tuple with boolean indicating whether the branch is colocated
121
and the full URL to the actual branch
123
# This path is meant to be relative to the existing branch
124
this_url = _get_branch_location(
125
control_dir, possible_transports=possible_transports)
126
# Perhaps the target control dir supports colocated branches?
128
root = controldir.ControlDir.open(
129
this_url, possible_transports=possible_transports)
130
except errors.NotBranchError:
131
return (False, this_url)
134
control_dir.open_workingtree()
135
except (errors.NoWorkingTree, errors.NotLocalUrl):
136
return (False, this_url)
139
root._format.colocated_branches and
140
control_dir.control_url == root.control_url,
144
def lookup_new_sibling_branch(control_dir, location, possible_transports=None):
145
"""Lookup the location for a new sibling branch.
147
:param control_dir: Control directory to find sibling branches from
148
:param location: Name of the new branch
149
:return: Full location to the new branch
151
location = directory_service.directories.dereference(location)
152
if '/' not in location and '\\' not in location:
153
(colocated, this_url) = _is_colocated(control_dir, possible_transports)
156
return urlutils.join_segment_parameters(
157
this_url, {"branch": urlutils.escape(location)})
159
return urlutils.join(this_url, '..', urlutils.escape(location))
163
def open_sibling_branch(control_dir, location, possible_transports=None):
164
"""Open a branch, possibly a sibling of another.
166
:param control_dir: Control directory relative to which to lookup the
168
:param location: Location to look up
169
:return: branch to open
172
# Perhaps it's a colocated branch?
173
return control_dir.open_branch(
174
location, possible_transports=possible_transports)
175
except (errors.NotBranchError, errors.NoColocatedBranchSupport):
176
this_url = _get_branch_location(control_dir)
179
this_url, '..', urlutils.escape(location)))
182
def open_nearby_branch(near=None, location=None, possible_transports=None):
183
"""Open a nearby branch.
185
:param near: Optional location of container from which to open branch
186
:param location: Location of the branch
187
:return: Branch instance
194
location, possible_transports=possible_transports)
195
except errors.NotBranchError:
197
cdir = controldir.ControlDir.open(
198
near, possible_transports=possible_transports)
199
return open_sibling_branch(
200
cdir, location, possible_transports=possible_transports)
203
def iter_sibling_branches(control_dir, possible_transports=None):
204
"""Iterate over the siblings of a branch.
206
:param control_dir: Control directory for which to look up the siblings
207
:return: Iterator over tuples with branch name and branch object
210
reference = control_dir.get_branch_reference()
211
except errors.NotBranchError:
213
if reference is not None:
215
ref_branch = Branch.open(
216
reference, possible_transports=possible_transports)
217
except errors.NotBranchError:
221
if ref_branch is None or ref_branch.name:
222
if ref_branch is not None:
223
control_dir = ref_branch.controldir
224
for name, branch in viewitems(control_dir.get_branches()):
227
repo = ref_branch.controldir.find_repository()
228
for branch in repo.find_branches(using=True):
229
name = urlutils.relative_url(
230
repo.user_url, branch.user_url).rstrip("/")
88
234
def tree_files_for_add(file_list):
342
436
takes_args = ['revision_id?']
343
takes_options = ['revision']
437
takes_options = ['directory', 'revision']
344
438
# cat-revision is more for frontends so should be exact
345
439
encoding = 'strict'
347
441
def print_revision(self, revisions, revid):
348
442
stream = revisions.get_record_stream([(revid,)], 'unordered', True)
349
record = stream.next()
443
record = next(stream)
350
444
if record.storage_kind == 'absent':
351
445
raise errors.NoSuchRevision(revisions, revid)
352
446
revtext = record.get_bytes_as('fulltext')
353
447
self.outf.write(revtext.decode('utf-8'))
356
def run(self, revision_id=None, revision=None):
450
def run(self, revision_id=None, revision=None, directory=u'.'):
357
451
if revision_id is not None and revision is not None:
358
raise errors.BzrCommandError('You can only supply one of'
359
' revision_id or --revision')
452
raise errors.BzrCommandError(gettext('You can only supply one of'
453
' revision_id or --revision'))
360
454
if revision_id is None and revision is 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
455
raise errors.BzrCommandError(
456
gettext('You must supply either --revision or a revision_id'))
458
b = controldir.ControlDir.open_containing_tree_or_branch(directory)[1]
460
revisions = getattr(b.repository, "revisions", None)
366
461
if revisions is None:
367
raise errors.BzrCommandError('Repository %r does not support '
368
'access to raw revision texts')
462
raise errors.BzrCommandError(
463
gettext('Repository %r does not support '
464
'access to raw revision texts') % b.repository)
370
b.repository.lock_read()
466
with b.repository.lock_read():
372
467
# TODO: jam 20060112 should cat-revision always output utf-8?
373
468
if revision_id is not None:
374
revision_id = osutils.safe_revision_id(revision_id, warn=False)
469
revision_id = cache_utf8.encode(revision_id)
376
471
self.print_revision(revisions, revision_id)
377
472
except errors.NoSuchRevision:
378
msg = "The repository %s contains no revision %s." % (
379
b.repository.base, revision_id)
474
"The repository {0} contains no revision {1}.").format(
475
b.repository.base, revision_id.decode('utf-8'))
380
476
raise errors.BzrCommandError(msg)
381
477
elif revision is not None:
382
478
for rev in revision:
384
480
raise errors.BzrCommandError(
385
'You cannot specify a NULL revision.')
481
gettext('You cannot specify a NULL revision.'))
386
482
rev_id = rev.as_revision_id(b)
387
483
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,))
473
486
class cmd_remove_tree(Command):
476
489
Since a lightweight checkout is little more than a working tree
477
490
this will refuse to run against one.
479
To re-create the working tree, use "bzr checkout".
492
To re-create the working tree, use "brz checkout".
481
494
_see_also = ['checkout', 'working-trees']
482
495
takes_args = ['location*']
483
496
takes_options = [
485
498
help='Remove the working tree even if it has '
486
'uncommitted changes.'),
499
'uncommitted or shelved changes.'),
489
502
def run(self, location_list, force=False):
490
503
if not location_list:
504
location_list = ['.']
493
506
for location in location_list:
494
d = bzrdir.BzrDir.open(location)
507
d = controldir.ControlDir.open(location)
497
510
working = d.open_workingtree()
498
511
except errors.NoWorkingTree:
499
raise errors.BzrCommandError("No working tree to remove")
512
raise errors.BzrCommandError(
513
gettext("No working tree to remove"))
500
514
except errors.NotLocalUrl:
501
raise errors.BzrCommandError("You cannot remove the working tree"
515
raise errors.BzrCommandError(
516
gettext("You cannot remove the working tree"
517
" of a remote path"))
504
519
if (working.has_changes()):
505
520
raise errors.UncommittedChanges(working)
521
if working.get_shelf_manager().last_shelf() is not None:
522
raise errors.ShelvedChanges(working)
507
524
if working.user_url != working.branch.user_url:
508
raise errors.BzrCommandError("You cannot remove the working tree"
509
" from a lightweight checkout")
525
raise errors.BzrCommandError(
526
gettext("You cannot remove the working tree"
527
" from a lightweight checkout"))
511
529
d.destroy_workingtree()
532
class cmd_repair_workingtree(Command):
533
__doc__ = """Reset the working tree state file.
535
This is not meant to be used normally, but more as a way to recover from
536
filesystem corruption, etc. This rebuilds the working inventory back to a
537
'known good' state. Any new modifications (adding a file, renaming, etc)
538
will be lost, though modified files will still be detected as such.
540
Most users will want something more like "brz revert" or "brz update"
541
unless the state file has become corrupted.
543
By default this attempts to recover the current state by looking at the
544
headers of the state file. If the state file is too corrupted to even do
545
that, you can supply --revision to force the state of the tree.
549
'revision', 'directory',
551
help='Reset the tree even if it doesn\'t appear to be'
556
def run(self, revision=None, directory='.', force=False):
557
tree, _ = WorkingTree.open_containing(directory)
558
self.enter_context(tree.lock_tree_write())
562
except errors.BzrError:
563
pass # There seems to be a real error here, so we'll reset
566
raise errors.BzrCommandError(gettext(
567
'The tree does not appear to be corrupt. You probably'
568
' want "brz revert" instead. Use "--force" if you are'
569
' sure you want to reset the working tree.'))
573
revision_ids = [r.as_revision_id(tree.branch) for r in revision]
575
tree.reset_state(revision_ids)
576
except errors.BzrError:
577
if revision_ids is None:
578
extra = gettext(', the header appears corrupt, try passing '
579
'-r -1 to set the state to the last commit')
582
raise errors.BzrCommandError(
583
gettext('failed to reset the tree state{0}').format(extra))
514
586
class cmd_revno(Command):
515
587
__doc__ = """Show current revision number.
747
866
takes_options = [
869
Option('include-root',
870
help='Include the entry for the root of the tree, if any.'),
751
help='List entries of a particular kind: file, directory, symlink.',
872
help='List entries of a particular kind: file, directory, '
754
876
takes_args = ['file*']
757
def run(self, revision=None, show_ids=False, kind=None, file_list=None):
879
def run(self, revision=None, show_ids=False, kind=None, include_root=False,
758
881
if kind and kind not in ['file', 'directory', 'symlink']:
759
raise errors.BzrCommandError('invalid kind %r specified' % (kind,))
882
raise errors.BzrCommandError(
883
gettext('invalid kind %r specified') % (kind,))
761
885
revision = _get_one_revision('inventory', revision)
762
work_tree, file_list = tree_files(file_list)
763
work_tree.lock_read()
764
self.add_cleanup(work_tree.unlock)
886
work_tree, file_list = WorkingTree.open_containing_paths(file_list)
887
self.enter_context(work_tree.lock_read())
765
888
if revision is not None:
766
889
tree = revision.as_tree(work_tree.branch)
768
891
extra_trees = [work_tree]
770
self.add_cleanup(tree.unlock)
892
self.enter_context(tree.lock_read())
897
self.enter_context(tree.lock_read())
775
898
if file_list is not None:
776
file_ids = tree.paths2ids(file_list, trees=extra_trees,
777
require_versioned=True)
899
paths = tree.find_related_paths_across_trees(
900
file_list, extra_trees, require_versioned=True)
778
901
# find_ids_across_trees may include some paths that don't
779
902
# exist in 'tree'.
780
entries = sorted((tree.id2path(file_id), tree.inventory[file_id])
781
for file_id in file_ids if file_id in tree)
903
entries = tree.iter_entries_by_dir(specific_files=paths)
783
entries = tree.inventory.entries()
905
entries = tree.iter_entries_by_dir()
786
for path, entry in entries:
907
for path, entry in sorted(entries):
787
908
if kind and kind != entry.kind:
910
if path == "" and not include_root:
790
self.outf.write('%-50s %s\n' % (path, entry.file_id))
913
self.outf.write('%-50s %s\n' % (
914
path, entry.file_id.decode('utf-8')))
792
916
self.outf.write(path)
793
917
self.outf.write('\n')
920
class cmd_cp(Command):
921
__doc__ = """Copy a file.
924
brz cp OLDNAME NEWNAME
926
brz cp SOURCE... DESTINATION
928
If the last argument is a versioned directory, all the other names
929
are copied into it. Otherwise, there must be exactly two arguments
930
and the file is copied to a new name.
932
Files cannot be copied between branches. Only files can be copied
936
takes_args = ['names*']
939
encoding_type = 'replace'
941
def run(self, names_list):
942
if names_list is None:
944
if len(names_list) < 2:
945
raise errors.BzrCommandError(gettext("missing file argument"))
946
tree, rel_names = WorkingTree.open_containing_paths(
947
names_list, canonicalize=False)
948
for file_name in rel_names[0:-1]:
950
raise errors.BzrCommandError(
951
gettext("can not copy root of branch"))
952
self.enter_context(tree.lock_tree_write())
953
into_existing = osutils.isdir(names_list[-1])
954
if not into_existing:
956
(src, dst) = rel_names
958
raise errors.BzrCommandError(
959
gettext('to copy multiple files the'
960
' destination must be a versioned'
965
(n, osutils.joinpath([rel_names[-1], osutils.basename(n)]))
966
for n in rel_names[:-1]]
968
for src, dst in pairs:
970
src_kind = tree.stored_kind(src)
971
except errors.NoSuchFile:
972
raise errors.BzrCommandError(
973
gettext('Could not copy %s => %s: %s is not versioned.')
976
raise errors.BzrCommandError(
977
gettext('Could not copy %s => %s . %s is not versioned\\.'
979
if src_kind == 'directory':
980
raise errors.BzrCommandError(
981
gettext('Could not copy %s => %s . %s is a directory.'
983
dst_parent = osutils.split(dst)[0]
986
dst_parent_kind = tree.stored_kind(dst_parent)
987
except errors.NoSuchFile:
988
raise errors.BzrCommandError(
989
gettext('Could not copy %s => %s: %s is not versioned.')
990
% (src, dst, dst_parent))
991
if dst_parent_kind != 'directory':
992
raise errors.BzrCommandError(
993
gettext('Could not copy to %s: %s is not a directory.')
994
% (dst_parent, dst_parent))
996
tree.copy_one(src, dst)
796
999
class cmd_mv(Command):
797
1000
__doc__ = """Move or rename a file.
800
bzr mv OLDNAME NEWNAME
1003
brz mv OLDNAME NEWNAME
802
bzr mv SOURCE... DESTINATION
1005
brz mv SOURCE... DESTINATION
804
1007
If the last argument is a versioned directory, all the other names
805
1008
are moved into it. Otherwise, there must be exactly two arguments
1070
1299
considered diverged if the destination branch's most recent commit is one
1071
1300
that has not been merged (directly or indirectly) by the source branch.
1073
If branches have diverged, you can use 'bzr push --overwrite' to replace
1302
If branches have diverged, you can use 'brz push --overwrite' to replace
1074
1303
the other branch completely, discarding its unmerged changes.
1076
1305
If you want to ensure you have the different changes in the other branch,
1077
do a merge (see bzr help merge) from the other branch, and commit that.
1306
do a merge (see brz help merge) from the other branch, and commit that.
1078
1307
After that you will be able to do a push without '--overwrite'.
1080
If there is no default push location set, the first push will set it.
1081
After that, you can omit the location to use the default. To change the
1082
default, use --remember. The value will only be saved if the remote
1083
location can be accessed.
1309
If there is no default push location set, the first push will set it (use
1310
--no-remember to avoid setting it). After that, you can omit the
1311
location to use the default. To change the default, use --remember. The
1312
value will only be saved if the remote location can be accessed.
1314
The --verbose option will display the revisions pushed using the log_format
1315
configuration option. You can use a different format by overriding it with
1316
-Olog_format=<other_format>.
1086
1319
_see_also = ['pull', 'update', 'working-trees']
1087
1320
takes_options = ['remember', 'overwrite', 'verbose', 'revision',
1088
Option('create-prefix',
1089
help='Create the path leading up to the branch '
1090
'if it does not already exist.'),
1092
help='Branch to push from, '
1093
'rather than the one containing the working directory.',
1097
Option('use-existing-dir',
1098
help='By default push will fail if the target'
1099
' directory exists, but does not already'
1100
' have a control directory. This flag will'
1101
' allow push to proceed.'),
1103
help='Create a stacked branch that references the public location '
1104
'of the parent branch.'),
1105
Option('stacked-on',
1106
help='Create a stacked branch that refers to another branch '
1107
'for the commit history. Only the work not present in the '
1108
'referenced branch is included in the branch created.',
1111
help='Refuse to push if there are uncommitted changes in'
1112
' the working tree, --no-strict disables the check.'),
1321
Option('create-prefix',
1322
help='Create the path leading up to the branch '
1323
'if it does not already exist.'),
1324
custom_help('directory',
1325
help='Branch to push from, '
1326
'rather than the one containing the working directory.'),
1327
Option('use-existing-dir',
1328
help='By default push will fail if the target'
1329
' directory exists, but does not already'
1330
' have a control directory. This flag will'
1331
' allow push to proceed.'),
1333
help='Create a stacked branch that references the public location '
1334
'of the parent branch.'),
1335
Option('stacked-on',
1336
help='Create a stacked branch that refers to another branch '
1337
'for the commit history. Only the work not present in the '
1338
'referenced branch is included in the branch created.',
1341
help='Refuse to push if there are uncommitted changes in'
1342
' the working tree, --no-strict disables the check.'),
1344
help="Don't populate the working tree, even for protocols"
1345
" that support it."),
1346
Option('overwrite-tags',
1347
help="Overwrite tags only."),
1348
Option('lossy', help="Allow lossy push, i.e. dropping metadata "
1349
"that can't be represented in the target.")
1114
1351
takes_args = ['location?']
1115
1352
encoding_type = 'replace'
1117
def run(self, location=None, remember=False, overwrite=False,
1118
create_prefix=False, verbose=False, revision=None,
1119
use_existing_dir=False, directory=None, stacked_on=None,
1120
stacked=False, strict=None):
1121
from bzrlib.push import _show_push_branch
1354
def run(self, location=None, remember=None, overwrite=False,
1355
create_prefix=False, verbose=False, revision=None,
1356
use_existing_dir=False, directory=None, stacked_on=None,
1357
stacked=False, strict=None, no_tree=False,
1358
overwrite_tags=False, lossy=False):
1359
from .location import location_to_url
1360
from .push import _show_push_branch
1363
overwrite = ["history", "tags"]
1364
elif overwrite_tags:
1365
overwrite = ["tags"]
1123
1369
if directory is None:
1124
1370
directory = '.'
1125
1371
# Get the source branch
1126
1372
(tree, br_from,
1127
_unused) = bzrdir.BzrDir.open_containing_tree_or_branch(directory)
1373
_unused) = controldir.ControlDir.open_containing_tree_or_branch(directory)
1128
1374
# Get the tip's revision_id
1129
1375
revision = _get_one_revision('push', revision)
1130
1376
if revision is not None:
1186
1442
parameter, as in "branch foo/bar -r 5".
1189
1446
_see_also = ['checkout']
1190
1447
takes_args = ['from_location', 'to_location?']
1191
takes_options = ['revision', Option('hardlink',
1192
help='Hard-link working tree files where possible.'),
1194
help="Create a branch without a working-tree."),
1196
help="Switch the checkout in the current directory "
1197
"to the new branch."),
1199
help='Create a stacked branch referring to the source branch. '
1200
'The new branch will depend on the availability of the source '
1201
'branch for all operations.'),
1202
Option('standalone',
1203
help='Do not use a shared repository, even if available.'),
1204
Option('use-existing-dir',
1205
help='By default branch will fail if the target'
1206
' directory exists, but does not already'
1207
' have a control directory. This flag will'
1208
' allow branch to proceed.'),
1210
help="Bind new branch to from location."),
1212
aliases = ['get', 'clone']
1448
takes_options = ['revision',
1450
'hardlink', help='Hard-link working tree files where possible.'),
1451
Option('files-from', type=text_type,
1452
help="Get file contents from this tree."),
1454
help="Create a branch without a working-tree."),
1456
help="Switch the checkout in the current directory "
1457
"to the new branch."),
1459
help='Create a stacked branch referring to the source branch. '
1460
'The new branch will depend on the availability of the source '
1461
'branch for all operations.'),
1462
Option('standalone',
1463
help='Do not use a shared repository, even if available.'),
1464
Option('use-existing-dir',
1465
help='By default branch will fail if the target'
1466
' directory exists, but does not already'
1467
' have a control directory. This flag will'
1468
' allow branch to proceed.'),
1470
help="Bind new branch to from location."),
1471
Option('no-recurse-nested',
1472
help='Do not recursively check out nested trees.'),
1214
1475
def run(self, from_location, to_location=None, revision=None,
1215
1476
hardlink=False, stacked=False, standalone=False, no_tree=False,
1216
use_existing_dir=False, switch=False, bind=False):
1217
from bzrlib import switch as _mod_switch
1218
from bzrlib.tag import _merge_tags_if_possible
1219
accelerator_tree, br_from = bzrdir.BzrDir.open_tree_or_branch(
1477
use_existing_dir=False, switch=False, bind=False,
1478
files_from=None, no_recurse_nested=False):
1479
from breezy import switch as _mod_switch
1480
accelerator_tree, br_from = controldir.ControlDir.open_tree_or_branch(
1482
if no_recurse_nested:
1486
if not (hardlink or files_from):
1487
# accelerator_tree is usually slower because you have to read N
1488
# files (no readahead, lots of seeks, etc), but allow the user to
1489
# explicitly request it
1490
accelerator_tree = None
1491
if files_from is not None and files_from != from_location:
1492
accelerator_tree = WorkingTree.open(files_from)
1221
1493
revision = _get_one_revision('branch', revision)
1223
self.add_cleanup(br_from.unlock)
1494
self.enter_context(br_from.lock_read())
1224
1495
if revision is not None:
1225
1496
revision_id = revision.as_revision_id(br_from)
1230
1501
revision_id = br_from.last_revision()
1231
1502
if to_location is None:
1232
1503
to_location = urlutils.derive_to_location(from_location)
1233
to_transport = transport.get_transport(to_location)
1504
to_transport = transport.get_transport(to_location, purpose='write')
1235
1506
to_transport.mkdir('.')
1236
1507
except errors.FileExists:
1237
if not use_existing_dir:
1238
raise errors.BzrCommandError('Target directory "%s" '
1239
'already exists.' % to_location)
1509
to_dir = controldir.ControlDir.open_from_transport(
1511
except errors.NotBranchError:
1512
if not use_existing_dir:
1513
raise errors.BzrCommandError(gettext('Target directory "%s" '
1514
'already exists.') % to_location)
1242
bzrdir.BzrDir.open_from_transport(to_transport)
1519
to_dir.open_branch()
1243
1520
except errors.NotBranchError:
1246
1523
raise errors.AlreadyBranchError(to_location)
1247
1524
except errors.NoSuchFile:
1248
raise errors.BzrCommandError('Parent of "%s" does not exist.'
1525
raise errors.BzrCommandError(gettext('Parent of "%s" does not exist.')
1251
# preserve whatever source format we have.
1252
dir = br_from.bzrdir.sprout(to_transport.base, revision_id,
1253
possible_transports=[to_transport],
1254
accelerator_tree=accelerator_tree,
1255
hardlink=hardlink, stacked=stacked,
1256
force_new_repo=standalone,
1257
create_tree_if_local=not no_tree,
1258
source_branch=br_from)
1259
branch = dir.open_branch()
1260
except errors.NoSuchRevision:
1261
to_transport.delete_tree('.')
1262
msg = "The branch %s has no revision %s." % (from_location,
1264
raise errors.BzrCommandError(msg)
1265
_merge_tags_if_possible(br_from, branch)
1531
# preserve whatever source format we have.
1532
to_dir = br_from.controldir.sprout(
1533
to_transport.base, revision_id,
1534
possible_transports=[to_transport],
1535
accelerator_tree=accelerator_tree, hardlink=hardlink,
1536
stacked=stacked, force_new_repo=standalone,
1537
create_tree_if_local=not no_tree, source_branch=br_from,
1539
branch = to_dir.open_branch(
1540
possible_transports=[
1541
br_from.controldir.root_transport, to_transport])
1542
except errors.NoSuchRevision:
1543
to_transport.delete_tree('.')
1544
msg = gettext("The branch {0} has no revision {1}.").format(
1545
from_location, revision)
1546
raise errors.BzrCommandError(msg)
1549
to_repo = to_dir.open_repository()
1550
except errors.NoRepositoryPresent:
1551
to_repo = to_dir.create_repository()
1552
to_repo.fetch(br_from.repository, revision_id=revision_id)
1553
branch = br_from.sprout(
1554
to_dir, revision_id=revision_id)
1555
br_from.tags.merge_to(branch.tags)
1266
1557
# If the source branch is stacked, the new branch may
1267
1558
# be stacked whether we asked for that explicitly or not.
1268
1559
# We therefore need a try/except here and not just 'if stacked:'
1270
note('Created new stacked branch referring to %s.' %
1271
branch.get_stacked_on_url())
1272
except (errors.NotStacked, errors.UnstackableBranchFormat,
1273
errors.UnstackableRepositoryFormat), e:
1274
note('Branched %d revision(s).' % branch.revno())
1561
note(gettext('Created new stacked branch referring to %s.') %
1562
branch.get_stacked_on_url())
1563
except (errors.NotStacked, _mod_branch.UnstackableBranchFormat,
1564
errors.UnstackableRepositoryFormat) as e:
1565
revno = branch.revno()
1566
if revno is not None:
1567
note(ngettext('Branched %d revision.',
1568
'Branched %d revisions.',
1569
branch.revno()) % revno)
1571
note(gettext('Created new branch.'))
1276
1573
# Bind to the parent
1277
1574
parent_branch = Branch.open(from_location)
1278
1575
branch.bind(parent_branch)
1279
note('New branch bound to %s' % from_location)
1576
note(gettext('New branch bound to %s') % from_location)
1281
1578
# Switch to the new branch
1282
1579
wt, _ = WorkingTree.open_containing('.')
1283
_mod_switch.switch(wt.bzrdir, branch)
1284
note('Switched to branch: %s',
1285
urlutils.unescape_for_display(branch.base, 'utf-8'))
1580
_mod_switch.switch(wt.controldir, branch)
1581
note(gettext('Switched to branch: %s'),
1582
urlutils.unescape_for_display(branch.base, 'utf-8'))
1585
class cmd_branches(Command):
1586
__doc__ = """List the branches available at the current location.
1588
This command will print the names of all the branches at the current
1592
takes_args = ['location?']
1594
Option('recursive', short_name='R',
1595
help='Recursively scan for branches rather than '
1596
'just looking in the specified location.')]
1598
def run(self, location=".", recursive=False):
1600
t = transport.get_transport(location, purpose='read')
1601
if not t.listable():
1602
raise errors.BzrCommandError(
1603
"Can't scan this type of location.")
1604
for b in controldir.ControlDir.find_branches(t):
1605
self.outf.write("%s\n" % urlutils.unescape_for_display(
1606
urlutils.relative_url(t.base, b.base),
1607
self.outf.encoding).rstrip("/"))
1609
dir = controldir.ControlDir.open_containing(location)[0]
1611
active_branch = dir.open_branch(name="")
1612
except errors.NotBranchError:
1613
active_branch = None
1615
for name, branch in iter_sibling_branches(dir):
1618
active = (active_branch is not None and
1619
active_branch.user_url == branch.user_url)
1620
names[name] = active
1621
# Only mention the current branch explicitly if it's not
1622
# one of the colocated branches
1623
if not any(viewvalues(names)) and active_branch is not None:
1624
self.outf.write("* %s\n" % gettext("(default)"))
1625
for name in sorted(names):
1626
active = names[name]
1631
self.outf.write("%s %s\n" % (
1632
prefix, (name if PY3 else name.encode(self.outf.encoding))))
1288
1635
class cmd_checkout(Command):
1289
1636
__doc__ = """Create a new checkout of an existing branch.
1291
If BRANCH_LOCATION is omitted, checkout will reconstitute a working tree for
1292
the branch found in '.'. This is useful if you have removed the working tree
1293
or if it was never created - i.e. if you pushed the branch to its current
1294
location using SFTP.
1638
If BRANCH_LOCATION is omitted, checkout will reconstitute a working tree
1639
for the branch found in '.'. This is useful if you have removed the working
1640
tree or if it was never created - i.e. if you pushed the branch to its
1641
current location using SFTP.
1296
If the TO_LOCATION is omitted, the last component of the BRANCH_LOCATION will
1297
be used. In other words, "checkout ../foo/bar" will attempt to create ./bar.
1298
If the BRANCH_LOCATION has no / or path separator embedded, the TO_LOCATION
1299
is derived from the BRANCH_LOCATION by stripping a leading scheme or drive
1300
identifier, if any. For example, "checkout lp:foo-bar" will attempt to
1643
If the TO_LOCATION is omitted, the last component of the BRANCH_LOCATION
1644
will be used. In other words, "checkout ../foo/bar" will attempt to create
1645
./bar. If the BRANCH_LOCATION has no / or path separator embedded, the
1646
TO_LOCATION is derived from the BRANCH_LOCATION by stripping a leading
1647
scheme or drive identifier, if any. For example, "checkout lp:foo-bar" will
1648
attempt to create ./foo-bar.
1303
1650
To retrieve the branch as of a particular revision, supply the --revision
1304
parameter, as in "checkout foo/bar -r 5". Note that this will be immediately
1305
out of date [so you cannot commit] but it may be useful (i.e. to examine old
1651
parameter, as in "checkout foo/bar -r 5". Note that this will be
1652
immediately out of date [so you cannot commit] but it may be useful (i.e.
1653
to examine old code.)
1309
_see_also = ['checkouts', 'branch']
1656
_see_also = ['checkouts', 'branch', 'working-trees', 'remove-tree']
1310
1657
takes_args = ['branch_location?', 'to_location?']
1311
1658
takes_options = ['revision',
1312
1659
Option('lightweight',
1366
1749
@display_command
1367
1750
def run(self, dir=u'.'):
1368
1751
tree = WorkingTree.open_containing(dir)[0]
1370
self.add_cleanup(tree.unlock)
1371
new_inv = tree.inventory
1752
self.enter_context(tree.lock_read())
1372
1753
old_tree = tree.basis_tree()
1373
old_tree.lock_read()
1374
self.add_cleanup(old_tree.unlock)
1375
old_inv = old_tree.inventory
1754
self.enter_context(old_tree.lock_read())
1377
1756
iterator = tree.iter_changes(old_tree, include_unchanged=True)
1378
for f, paths, c, v, p, n, k, e in iterator:
1379
if paths[0] == paths[1]:
1383
renames.append(paths)
1757
for change in iterator:
1758
if change.path[0] == change.path[1]:
1760
if None in change.path:
1762
renames.append(change.path)
1385
1764
for old_name, new_name in renames:
1386
1765
self.outf.write("%s => %s\n" % (old_name, new_name))
1389
1768
class cmd_update(Command):
1390
__doc__ = """Update a tree to have the latest code committed to its branch.
1392
This will perform a merge into the working tree, and may generate
1393
conflicts. If you have any local changes, you will still
1394
need to commit them after the update for the update to be complete.
1396
If you want to discard your local changes, you can just do a
1397
'bzr revert' instead of 'bzr commit' after the update.
1399
If the tree's branch is bound to a master branch, it will also update
1769
__doc__ = """Update a working tree to a new revision.
1771
This will perform a merge of the destination revision (the tip of the
1772
branch, or the specified revision) into the working tree, and then make
1773
that revision the basis revision for the working tree.
1775
You can use this to visit an older revision, or to update a working tree
1776
that is out of date from its branch.
1778
If there are any uncommitted changes in the tree, they will be carried
1779
across and remain as uncommitted changes after the update. To discard
1780
these changes, use 'brz revert'. The uncommitted changes may conflict
1781
with the changes brought in by the change in basis revision.
1783
If the tree's branch is bound to a master branch, brz will also update
1400
1784
the branch from the master.
1786
You cannot update just a single file or directory, because each Breezy
1787
working tree has just a single basis revision. If you want to restore a
1788
file that has been removed locally, use 'brz revert' instead of 'brz
1789
update'. If you want to restore a file to its state in a previous
1790
revision, use 'brz revert' with a '-r' option, or use 'brz cat' to write
1791
out the old content of that file to a new location.
1793
The 'dir' argument, if given, must be the location of the root of a
1794
working tree to update. By default, the working tree that contains the
1795
current working directory is used.
1403
1798
_see_also = ['pull', 'working-trees', 'status-flags']
1404
1799
takes_args = ['dir?']
1405
takes_options = ['revision']
1800
takes_options = ['revision',
1802
help="Show base revision text in conflicts."),
1406
1804
aliases = ['up']
1408
def run(self, dir='.', revision=None):
1806
def run(self, dir=None, revision=None, show_base=None):
1409
1807
if revision is not None and len(revision) != 1:
1410
raise errors.BzrCommandError(
1411
"bzr update --revision takes exactly one revision")
1412
tree = WorkingTree.open_containing(dir)[0]
1808
raise errors.BzrCommandError(gettext(
1809
"brz update --revision takes exactly one revision"))
1811
tree = WorkingTree.open_containing('.')[0]
1813
tree, relpath = WorkingTree.open_containing(dir)
1816
raise errors.BzrCommandError(gettext(
1817
"brz update can only update a whole tree, "
1818
"not a file or subdirectory"))
1413
1819
branch = tree.branch
1414
1820
possible_transports = []
1415
1821
master = branch.get_master_branch(
1416
1822
possible_transports=possible_transports)
1417
1823
if master is not None:
1419
1824
branch_location = master.base
1825
self.enter_context(tree.lock_write())
1421
tree.lock_tree_write()
1422
1827
branch_location = tree.branch.base
1423
self.add_cleanup(tree.unlock)
1828
self.enter_context(tree.lock_tree_write())
1424
1829
# get rid of the final '/' and be ready for display
1425
1830
branch_location = urlutils.unescape_for_display(
1426
1831
branch_location.rstrip('/'),
1511
1917
noise_level = get_verbosity_level()
1513
1919
noise_level = 0
1514
from bzrlib.info import show_bzrdir_info
1515
show_bzrdir_info(bzrdir.BzrDir.open_containing(location)[0],
1920
from .info import show_bzrdir_info
1921
show_bzrdir_info(controldir.ControlDir.open_containing(location)[0],
1516
1922
verbose=noise_level, outfile=self.outf)
1519
1925
class cmd_remove(Command):
1520
1926
__doc__ = """Remove files or directories.
1522
This makes bzr stop tracking changes to the specified files. bzr will delete
1523
them if they can easily be recovered using revert. If no options or
1524
parameters are given bzr will scan for files that are being tracked by bzr
1525
but missing in your tree and stop tracking them for you.
1928
This makes Breezy stop tracking changes to the specified files. Breezy will
1929
delete them if they can easily be recovered using revert otherwise they
1930
will be backed up (adding an extension of the form .~#~). If no options or
1931
parameters are given Breezy will scan for files that are being tracked by
1932
Breezy but missing in your tree and stop tracking them for you.
1527
1934
takes_args = ['file*']
1528
1935
takes_options = ['verbose',
1529
Option('new', help='Only remove files that have never been committed.'),
1530
RegistryOption.from_kwargs('file-deletion-strategy',
1531
'The file deletion mode to be used.',
1532
title='Deletion Strategy', value_switches=True, enum_switch=False,
1533
safe='Only delete files if they can be'
1534
' safely recovered (default).',
1535
keep='Delete from bzr but leave the working copy.',
1536
force='Delete all the specified files, even if they can not be '
1537
'recovered and even if they are non-empty directories.')]
1937
'new', help='Only remove files that have never been committed.'),
1938
RegistryOption.from_kwargs('file-deletion-strategy',
1939
'The file deletion mode to be used.',
1940
title='Deletion Strategy', value_switches=True, enum_switch=False,
1941
safe='Backup changed files (default).',
1942
keep='Delete from brz but leave the working copy.',
1943
no_backup='Don\'t backup changed files.'),
1538
1945
aliases = ['rm', 'del']
1539
1946
encoding_type = 'replace'
1541
1948
def run(self, file_list, verbose=False, new=False,
1542
file_deletion_strategy='safe'):
1543
tree, file_list = tree_files(file_list)
1949
file_deletion_strategy='safe'):
1951
tree, file_list = WorkingTree.open_containing_paths(file_list)
1545
1953
if file_list is not None:
1546
1954
file_list = [f for f in file_list]
1549
self.add_cleanup(tree.unlock)
1956
self.enter_context(tree.lock_write())
1550
1957
# Heuristics should probably all move into tree.remove_smart or
1553
1960
added = tree.changes_from(tree.basis_tree(),
1554
specific_files=file_list).added
1555
file_list = sorted([f[0] for f in added], reverse=True)
1961
specific_files=file_list).added
1962
file_list = sorted([f.path[1] for f in added], reverse=True)
1556
1963
if len(file_list) == 0:
1557
raise errors.BzrCommandError('No matching files.')
1964
raise errors.BzrCommandError(gettext('No matching files.'))
1558
1965
elif file_list is None:
1559
1966
# missing files show up in iter_changes(basis) as
1560
1967
# versioned-with-no-kind.
1562
1969
for change in tree.iter_changes(tree.basis_tree()):
1563
1970
# Find paths in the working tree that have no kind:
1564
if change[1][1] is not None and change[6][1] is None:
1565
missing.append(change[1][1])
1971
if change.path[1] is not None and change.kind[1] is None:
1972
missing.append(change.path[1])
1566
1973
file_list = sorted(missing, reverse=True)
1567
1974
file_deletion_strategy = 'keep'
1568
1975
tree.remove(file_list, verbose=verbose, to_file=self.outf,
1569
keep_files=file_deletion_strategy=='keep',
1570
force=file_deletion_strategy=='force')
1573
class cmd_file_id(Command):
1574
__doc__ = """Print file_id of a particular file or directory.
1576
The file_id is assigned when the file is first added and remains the
1577
same through all revisions where the file exists, even when it is
1582
_see_also = ['inventory', 'ls']
1583
takes_args = ['filename']
1586
def run(self, filename):
1587
tree, relpath = WorkingTree.open_containing(filename)
1588
i = tree.path2id(relpath)
1590
raise errors.NotVersionedError(filename)
1592
self.outf.write(i + '\n')
1595
class cmd_file_path(Command):
1596
__doc__ = """Print path of file_ids to a file or directory.
1598
This prints one line for each directory down to the target,
1599
starting at the branch root.
1603
takes_args = ['filename']
1606
def run(self, filename):
1607
tree, relpath = WorkingTree.open_containing(filename)
1608
fid = tree.path2id(relpath)
1610
raise errors.NotVersionedError(filename)
1611
segments = osutils.splitpath(relpath)
1612
for pos in range(1, len(segments) + 1):
1613
path = osutils.joinpath(segments[:pos])
1614
self.outf.write("%s\n" % tree.path2id(path))
1976
keep_files=file_deletion_strategy == 'keep',
1977
force=(file_deletion_strategy == 'no-backup'))
1617
1980
class cmd_reconcile(Command):
1618
__doc__ = """Reconcile bzr metadata in a branch.
1981
__doc__ = """Reconcile brz metadata in a branch.
1620
1983
This can correct data mismatches that may have been caused by
1621
previous ghost operations or bzr upgrades. You should only
1622
need to run this command if 'bzr check' or a bzr developer
1984
previous ghost operations or brz upgrades. You should only
1985
need to run this command if 'brz check' or a brz developer
1623
1986
advises you to run it.
1625
1988
If a second branch is provided, cross-branch reconciliation is
1626
1989
also attempted, which will check that data like the tree root
1627
id which was not present in very early bzr versions is represented
1990
id which was not present in very early brz versions is represented
1628
1991
correctly in both branches.
1630
1993
At the same time it is run it may recompress data resulting in
1742
2123
to_transport.ensure_base()
1743
2124
except errors.NoSuchFile:
1744
2125
if not create_prefix:
1745
raise errors.BzrCommandError("Parent directory of %s"
1747
"\nYou may supply --create-prefix to create all"
1748
" leading parent directories."
2126
raise errors.BzrCommandError(gettext("Parent directory of %s"
2128
"\nYou may supply --create-prefix to create all"
2129
" leading parent directories.")
1750
2131
to_transport.create_prefix()
1753
a_bzrdir = bzrdir.BzrDir.open_from_transport(to_transport)
2134
a_controldir = controldir.ControlDir.open_from_transport(
1754
2136
except errors.NotBranchError:
1755
2137
# really a NotBzrDir error...
1756
create_branch = bzrdir.BzrDir.create_branch_convenience
2138
create_branch = controldir.ControlDir.create_branch_convenience
2140
force_new_tree = False
2142
force_new_tree = None
1757
2143
branch = create_branch(to_transport.base, format=format,
1758
possible_transports=[to_transport])
1759
a_bzrdir = branch.bzrdir
2144
possible_transports=[to_transport],
2145
force_new_tree=force_new_tree)
2146
a_controldir = branch.controldir
1761
from bzrlib.transport.local import LocalTransport
1762
if a_bzrdir.has_branch():
2148
from .transport.local import LocalTransport
2149
if a_controldir.has_branch():
1763
2150
if (isinstance(to_transport, LocalTransport)
1764
and not a_bzrdir.has_workingtree()):
1765
raise errors.BranchExistsWithoutWorkingTree(location)
2151
and not a_controldir.has_workingtree()):
2152
raise errors.BranchExistsWithoutWorkingTree(location)
1766
2153
raise errors.AlreadyBranchError(location)
1767
branch = a_bzrdir.create_branch()
1768
a_bzrdir.create_workingtree()
2154
branch = a_controldir.create_branch()
2155
if not no_tree and not a_controldir.has_workingtree():
2156
a_controldir.create_workingtree()
1769
2157
if append_revisions_only:
1771
2159
branch.set_append_revisions_only(True)
1772
2160
except errors.UpgradeRequired:
1773
raise errors.BzrCommandError('This branch format cannot be set'
1774
' to append-revisions-only. Try --default.')
2161
raise errors.BzrCommandError(gettext('This branch format cannot be set'
2162
' to append-revisions-only. Try --default.'))
1775
2163
if not is_quiet():
1776
from bzrlib.info import describe_layout, describe_format
2164
from .info import describe_layout, describe_format
1778
tree = a_bzrdir.open_workingtree(recommend_upgrade=False)
2166
tree = a_controldir.open_workingtree(recommend_upgrade=False)
1779
2167
except (errors.NoWorkingTree, errors.NotLocalUrl):
1781
2169
repository = branch.repository
1782
2170
layout = describe_layout(repository, branch, tree).lower()
1783
format = describe_format(a_bzrdir, repository, branch, tree)
1784
self.outf.write("Created a %s (format: %s)\n" % (layout, format))
2171
format = describe_format(a_controldir, repository, branch, tree)
2172
self.outf.write(gettext("Created a {0} (format: {1})\n").format(
1785
2174
if repository.is_shared():
1786
#XXX: maybe this can be refactored into transport.path_or_url()
1787
url = repository.bzrdir.root_transport.external_url()
2175
# XXX: maybe this can be refactored into transport.path_or_url()
2176
url = repository.controldir.root_transport.external_url()
1789
2178
url = urlutils.local_path_from_url(url)
1790
except errors.InvalidURL:
2179
except urlutils.InvalidURL:
1792
self.outf.write("Using shared repository: %s\n" % url)
1795
class cmd_init_repository(Command):
2181
self.outf.write(gettext("Using shared repository: %s\n") % url)
2184
class cmd_init_shared_repository(Command):
1796
2185
__doc__ = """Create a shared repository for branches to share storage space.
1798
2187
New branches created under the repository directory will store their
1799
2188
revisions in the repository, not in the branch directory. For branches
1800
with shared history, this reduces the amount of storage needed and
2189
with shared history, this reduces the amount of storage needed and
1801
2190
speeds up the creation of new branches.
1803
2192
If the --no-trees option is given then the branches in the repository
1804
will not have working trees by default. They will still exist as
1805
directories on disk, but they will not have separate copies of the
2193
will not have working trees by default. They will still exist as
2194
directories on disk, but they will not have separate copies of the
1806
2195
files at a certain revision. This can be useful for repositories that
1807
2196
store branches which are interacted with through checkouts or remote
1808
2197
branches, such as on a server.
1875
2280
Shows the difference in the working tree versus the last commit::
1879
2284
Difference between the working tree and revision 1::
1883
2288
Difference between revision 3 and revision 1::
1887
2292
Difference between revision 3 and revision 1 for branch xxx::
1891
To see the changes introduced in revision X::
2296
The changes introduced by revision 2 (equivalent to -r1..2)::
2300
To see the changes introduced by revision X::
1895
2304
Note that in the case of a merge, the -c option shows the changes
1896
2305
compared to the left hand parent. To see the changes against
1897
2306
another parent, use::
1899
bzr diff -r<chosen_parent>..X
1901
The changes introduced by revision 2 (equivalent to -r1..2)::
2308
brz diff -r<chosen_parent>..X
2310
The changes between the current revision and the previous revision
2311
(equivalent to -c-1 and -r-2..-1)
1905
2315
Show just the differences for file NEWS::
1909
2319
Show the differences in working tree xxx for file NEWS::
1913
2323
Show the differences from branch xxx to this working tree:
1917
2327
Show the differences between two branches for file NEWS::
1919
bzr diff --old xxx --new yyy NEWS
1921
Same as 'bzr diff' but prefix paths with old/ and new/::
1923
bzr diff --prefix old/:new/
2329
brz diff --old xxx --new yyy NEWS
2331
Same as 'brz diff' but prefix paths with old/ and new/::
2333
brz diff --prefix old/:new/
2335
Show the differences using a custom diff program with options::
2337
brz diff --using /usr/bin/diff --diff-options -wu
1925
2339
_see_also = ['status']
1926
2340
takes_args = ['file*']
1927
2341
takes_options = [
1928
Option('diff-options', type=str,
2342
Option('diff-options', type=text_type,
1929
2343
help='Pass these options to the external diff program.'),
1930
Option('prefix', type=str,
2344
Option('prefix', type=text_type,
1931
2345
short_name='p',
1932
2346
help='Set prefixes added to old and new filenames, as '
1933
2347
'two values separated by a colon. (eg "old/:new/").'),
1935
help='Branch/tree to compare from.',
2349
help='Branch/tree to compare from.',
1939
help='Branch/tree to compare to.',
2353
help='Branch/tree to compare to.',
1944
2358
Option('using',
1945
help='Use this command to compare files.',
2359
help='Use this command to compare files.',
1948
2362
RegistryOption('format',
1949
help='Diff format to use.',
1950
lazy_registry=('bzrlib.diff', 'format_registry'),
1951
value_switches=False, title='Diff format'),
2364
help='Diff format to use.',
2365
lazy_registry=('breezy.diff', 'format_registry'),
2366
title='Diff format'),
2368
help='How many lines of context to show.',
2371
RegistryOption.from_kwargs(
2373
help='Color mode to use.',
2374
title='Color Mode', value_switches=False, enum_switch=True,
2375
never='Never colorize output.',
2376
auto='Only colorize output if terminal supports it and STDOUT is a'
2378
always='Always colorize output (default).'),
2381
help=('Warn if trailing whitespace or spurious changes have been'
1953
2385
aliases = ['di', 'dif']
1954
2386
encoding_type = 'exact'
1956
2388
@display_command
1957
2389
def run(self, revision=None, file_list=None, diff_options=None,
1958
prefix=None, old=None, new=None, using=None, format=None):
1959
from bzrlib.diff import (get_trees_and_branches_to_diff_locked,
2390
prefix=None, old=None, new=None, using=None, format=None,
2391
context=None, color='never'):
2392
from .diff import (get_trees_and_branches_to_diff_locked,
1962
if (prefix is None) or (prefix == '0'):
1963
2396
# diff -p0 format
2399
elif prefix == u'1' or prefix is None:
1967
2400
old_label = 'old/'
1968
2401
new_label = 'new/'
1970
old_label, new_label = prefix.split(":")
2402
elif u':' in prefix:
2403
old_label, new_label = prefix.split(u":")
1972
raise errors.BzrCommandError(
2405
raise errors.BzrCommandError(gettext(
1973
2406
'--prefix expects two values separated by a colon'
1974
' (eg "old/:new/")')
2407
' (eg "old/:new/")'))
1976
2409
if revision and len(revision) > 2:
1977
raise errors.BzrCommandError('bzr diff --revision takes exactly'
1978
' one or two revision specifiers')
2410
raise errors.BzrCommandError(gettext('brz diff --revision takes exactly'
2411
' one or two revision specifiers'))
1980
2413
if using is not None and format is not None:
1981
raise errors.BzrCommandError('--using and --format are mutually '
2414
raise errors.BzrCommandError(gettext(
2415
'{0} and {1} are mutually exclusive').format(
2416
'--using', '--format'))
1984
2418
(old_tree, new_tree,
1985
2419
old_branch, new_branch,
1986
2420
specific_files, extra_trees) = get_trees_and_branches_to_diff_locked(
1987
file_list, revision, old, new, self.add_cleanup, apply_view=True)
1988
return show_diff_trees(old_tree, new_tree, sys.stdout,
2421
file_list, revision, old, new, self._exit_stack, apply_view=True)
2422
# GNU diff on Windows uses ANSI encoding for filenames
2423
path_encoding = osutils.get_diff_header_encoding()
2426
from .terminal import has_ansi_colors
2427
if has_ansi_colors():
2431
if 'always' == color:
2432
from .colordiff import DiffWriter
2433
outf = DiffWriter(outf)
2434
return show_diff_trees(old_tree, new_tree, outf,
1989
2435
specific_files=specific_files,
1990
2436
external_diff_options=diff_options,
1991
2437
old_label=old_label, new_label=new_label,
1992
extra_trees=extra_trees, using=using,
2438
extra_trees=extra_trees,
2439
path_encoding=path_encoding,
2440
using=using, context=context,
1993
2441
format_cls=format)
2522
3025
_see_also = ['status', 'cat']
2523
3026
takes_args = ['path?']
2524
3027
takes_options = [
2527
Option('recursive', short_name='R',
2528
help='Recurse into subdirectories.'),
2530
help='Print paths relative to the root of the branch.'),
2531
Option('unknown', help='Print unknown files.'),
2532
Option('versioned', help='Print versioned files.',
2534
Option('ignored', help='Print ignored files.'),
2536
help='Write an ascii NUL (\\0) separator '
2537
'between files rather than a newline.'),
2539
help='List entries of a particular kind: file, directory, symlink.',
3030
Option('recursive', short_name='R',
3031
help='Recurse into subdirectories.'),
3033
help='Print paths relative to the root of the branch.'),
3034
Option('unknown', short_name='u',
3035
help='Print unknown files.'),
3036
Option('versioned', help='Print versioned files.',
3038
Option('ignored', short_name='i',
3039
help='Print ignored files.'),
3040
Option('kind', short_name='k',
3041
help=('List entries of a particular kind: file, '
3042
'directory, symlink, tree-reference.'),
2543
3049
@display_command
2544
3050
def run(self, revision=None, verbose=False,
2545
3051
recursive=False, from_root=False,
2546
3052
unknown=False, versioned=False, ignored=False,
2547
null=False, kind=None, show_ids=False, path=None):
3053
null=False, kind=None, show_ids=False, path=None, directory=None):
2549
if kind and kind not in ('file', 'directory', 'symlink'):
2550
raise errors.BzrCommandError('invalid kind specified')
3055
if kind and kind not in ('file', 'directory', 'symlink', 'tree-reference'):
3056
raise errors.BzrCommandError(gettext('invalid kind specified'))
2552
3058
if verbose and null:
2553
raise errors.BzrCommandError('Cannot set both --verbose and --null')
3059
raise errors.BzrCommandError(
3060
gettext('Cannot set both --verbose and --null'))
2554
3061
all = not (unknown or versioned or ignored)
2556
selection = {'I':ignored, '?':unknown, 'V':versioned}
3063
selection = {'I': ignored, '?': unknown, 'V': versioned}
2558
3065
if path is None:
2562
raise errors.BzrCommandError('cannot specify both --from-root'
3069
raise errors.BzrCommandError(gettext('cannot specify both --from-root'
2565
tree, branch, relpath = bzrdir.BzrDir.open_containing_tree_or_branch(
3072
tree, branch, relpath = \
3073
_open_directory_or_containing_tree_or_branch(fs_path, directory)
2568
3075
# Calculate the prefix to use
2660
3167
After adding, editing or deleting that file either indirectly by
2661
3168
using this command or directly by using an editor, be sure to commit
2664
Bazaar also supports a global ignore file ~/.bazaar/ignore. On Windows
2665
the global ignore file can be found in the application data directory as
2666
C:\\Documents and Settings\\<user>\\Application Data\\Bazaar\\2.0\\ignore.
3171
Breezy also supports a global ignore file ~/.config/breezy/ignore. On
3172
Windows the global ignore file can be found in the application data
3174
C:\\Documents and Settings\\<user>\\Application Data\\Breezy\\3.0\\ignore.
2667
3175
Global ignores are not touched by this command. The global ignore file
2668
3176
can be edited directly using an editor.
2670
3178
Patterns prefixed with '!' are exceptions to ignore patterns and take
2671
3179
precedence over regular ignores. Such exceptions are used to specify
2672
3180
files that should be versioned which would otherwise be ignored.
2674
3182
Patterns prefixed with '!!' act as regular ignore patterns, but have
2675
3183
precedence over the '!' exception patterns.
2677
Note: ignore patterns containing shell wildcards must be quoted from
3187
* Ignore patterns containing shell wildcards must be quoted from
3190
* Ignore patterns starting with "#" act as comments in the ignore file.
3191
To ignore patterns that begin with that character, use the "RE:" prefix.
2681
3194
Ignore the top level Makefile::
2683
bzr ignore ./Makefile
3196
brz ignore ./Makefile
2685
3198
Ignore .class files in all directories...::
2687
bzr ignore "*.class"
3200
brz ignore "*.class"
2689
3202
...but do not ignore "special.class"::
2691
bzr ignore "!special.class"
2693
Ignore .o files under the lib directory::
2695
bzr ignore "lib/**/*.o"
2697
Ignore .o files under the lib directory::
2699
bzr ignore "RE:lib/.*\.o"
3204
brz ignore "!special.class"
3206
Ignore files whose name begins with the "#" character::
3210
Ignore .o files under the lib directory::
3212
brz ignore "lib/**/*.o"
3214
Ignore .o files under the lib directory::
3216
brz ignore "RE:lib/.*\\.o"
2701
3218
Ignore everything but the "debian" toplevel directory::
2703
bzr ignore "RE:(?!debian/).*"
3220
brz ignore "RE:(?!debian/).*"
2705
3222
Ignore everything except the "local" toplevel directory,
2706
but always ignore "*~" autosave files, even under local/::
2709
bzr ignore "!./local"
3223
but always ignore autosave files ending in ~, even under local/::
3226
brz ignore "!./local"
2713
3230
_see_also = ['status', 'ignored', 'patterns']
2714
3231
takes_args = ['name_pattern*']
2716
Option('default-rules',
2717
help='Display the default ignore rules that bzr uses.')
3232
takes_options = ['directory',
3233
Option('default-rules',
3234
help='Display the default ignore rules that brz uses.')
2720
def run(self, name_pattern_list=None, default_rules=None):
2721
from bzrlib import ignores
3237
def run(self, name_pattern_list=None, default_rules=None,
3239
from breezy import ignores
2722
3240
if default_rules is not None:
2723
3241
# dump the default rules and exit
2724
3242
for pattern in ignores.USER_DEFAULTS:
2725
3243
self.outf.write("%s\n" % pattern)
2727
3245
if not name_pattern_list:
2728
raise errors.BzrCommandError("ignore requires at least one "
2729
"NAME_PATTERN or --default-rules.")
3246
raise errors.BzrCommandError(gettext("ignore requires at least one "
3247
"NAME_PATTERN or --default-rules."))
2730
3248
name_pattern_list = [globbing.normalize_pattern(p)
2731
3249
for p in name_pattern_list]
3251
bad_patterns_count = 0
3252
for p in name_pattern_list:
3253
if not globbing.Globster.is_pattern_valid(p):
3254
bad_patterns_count += 1
3255
bad_patterns += ('\n %s' % p)
3257
msg = (ngettext('Invalid ignore pattern found. %s',
3258
'Invalid ignore patterns found. %s',
3259
bad_patterns_count) % bad_patterns)
3260
ui.ui_factory.show_error(msg)
3261
raise lazy_regex.InvalidPattern('')
2732
3262
for name_pattern in name_pattern_list:
2733
3263
if (name_pattern[0] == '/' or
2734
(len(name_pattern) > 1 and name_pattern[1] == ':')):
2735
raise errors.BzrCommandError(
2736
"NAME_PATTERN should not be an absolute path")
2737
tree, relpath = WorkingTree.open_containing(u'.')
3264
(len(name_pattern) > 1 and name_pattern[1] == ':')):
3265
raise errors.BzrCommandError(gettext(
3266
"NAME_PATTERN should not be an absolute path"))
3267
tree, relpath = WorkingTree.open_containing(directory)
2738
3268
ignores.tree_ignores_add_patterns(tree, name_pattern_list)
2739
3269
ignored = globbing.Globster(name_pattern_list)
2742
for entry in tree.list_files():
3271
self.enter_context(tree.lock_read())
3272
for filename, fc, fkind, entry in tree.list_files():
3273
id = getattr(entry, 'file_id', None)
2744
3274
if id is not None:
2746
3275
if ignored.match(filename):
2747
3276
matches.append(filename)
2749
3277
if len(matches) > 0:
2750
self.outf.write("Warning: the following files are version controlled and"
2751
" match your ignore pattern:\n%s"
2752
"\nThese files will continue to be version controlled"
2753
" unless you 'bzr remove' them.\n" % ("\n".join(matches),))
3278
self.outf.write(gettext("Warning: the following files are version "
3279
"controlled and match your ignore pattern:\n%s"
3280
"\nThese files will continue to be version controlled"
3281
" unless you 'brz remove' them.\n") % ("\n".join(matches),))
2756
3284
class cmd_ignored(Command):
2829
3359
================= =========================
3362
encoding_type = 'exact'
2831
3363
takes_args = ['dest', 'branch_or_subdir?']
2834
help="Type of file to export to.",
2837
Option('filters', help='Apply content filters to export the '
2838
'convenient form.'),
2841
help="Name of the root directory inside the exported file."),
2842
Option('per-file-timestamps',
2843
help='Set modification time of files to that of the last '
2844
'revision in which it was changed.'),
3364
takes_options = ['directory',
3366
help="Type of file to export to.",
3369
Option('filters', help='Apply content filters to export the '
3370
'convenient form.'),
3373
help="Name of the root directory inside the exported file."),
3374
Option('per-file-timestamps',
3375
help='Set modification time of files to that of the last '
3376
'revision in which it was changed.'),
3377
Option('uncommitted',
3378
help='Export the working tree contents rather than that of the '
2846
3382
def run(self, dest, branch_or_subdir=None, revision=None, format=None,
2847
root=None, filters=False, per_file_timestamps=False):
2848
from bzrlib.export import export
3383
root=None, filters=False, per_file_timestamps=False, uncommitted=False,
3385
from .export import export, guess_format, get_root_name
2850
3387
if branch_or_subdir is None:
2851
tree = WorkingTree.open_containing(u'.')[0]
2855
b, subdir = Branch.open_containing(branch_or_subdir)
2858
rev_tree = _get_one_revision_tree('export', revision, branch=b, tree=tree)
3388
branch_or_subdir = directory
3390
(tree, b, subdir) = controldir.ControlDir.open_containing_tree_or_branch(
3392
if tree is not None:
3393
self.enter_context(tree.lock_read())
3397
raise errors.BzrCommandError(
3398
gettext("--uncommitted requires a working tree"))
3401
export_tree = _get_one_revision_tree(
3402
'export', revision, branch=b,
3406
format = guess_format(dest)
3409
root = get_root_name(dest)
3411
if not per_file_timestamps:
3412
force_mtime = time.time()
3417
from breezy.filter_tree import ContentFilterTree
3418
export_tree = ContentFilterTree(
3419
export_tree, export_tree._content_filter_stack)
2860
export(rev_tree, dest, format, root, subdir, filtered=filters,
3422
export(export_tree, dest, format, root, subdir,
2861
3423
per_file_timestamps=per_file_timestamps)
2862
except errors.NoSuchExportFormat, e:
2863
raise errors.BzrCommandError('Unsupported export format: %s' % e.format)
3424
except errors.NoSuchExportFormat as e:
3425
raise errors.BzrCommandError(
3426
gettext('Unsupported export format: %s') % e.format)
2866
3429
class cmd_cat(Command):
2875
3438
_see_also = ['ls']
2877
Option('name-from-revision', help='The path name in the old tree.'),
2878
Option('filters', help='Apply content filters to display the '
2879
'convenience form.'),
3439
takes_options = ['directory',
3440
Option('name-from-revision',
3441
help='The path name in the old tree.'),
3442
Option('filters', help='Apply content filters to display the '
3443
'convenience form.'),
2882
3446
takes_args = ['filename']
2883
3447
encoding_type = 'exact'
2885
3449
@display_command
2886
3450
def run(self, filename, revision=None, name_from_revision=False,
3451
filters=False, directory=None):
2888
3452
if revision is not None and len(revision) != 1:
2889
raise errors.BzrCommandError("bzr cat --revision takes exactly"
2890
" one revision specifier")
3453
raise errors.BzrCommandError(gettext("brz cat --revision takes exactly"
3454
" one revision specifier"))
2891
3455
tree, branch, relpath = \
2892
bzrdir.BzrDir.open_containing_tree_or_branch(filename)
2894
self.add_cleanup(branch.unlock)
3456
_open_directory_or_containing_tree_or_branch(filename, directory)
3457
self.enter_context(branch.lock_read())
2895
3458
return self._run(tree, branch, relpath, filename, revision,
2896
3459
name_from_revision, filters)
2898
3461
def _run(self, tree, b, relpath, filename, revision, name_from_revision,
2900
3464
if tree is None:
2901
3465
tree = b.basis_tree()
2902
3466
rev_tree = _get_one_revision_tree('cat', revision, branch=b)
2903
rev_tree.lock_read()
2904
self.add_cleanup(rev_tree.unlock)
2906
old_file_id = rev_tree.path2id(relpath)
3467
self.enter_context(rev_tree.lock_read())
2908
3469
if name_from_revision:
2909
3470
# Try in revision if requested
2910
if old_file_id is None:
2911
raise errors.BzrCommandError(
2912
"%r is not present in revision %s" % (
3471
if not rev_tree.is_versioned(relpath):
3472
raise errors.BzrCommandError(gettext(
3473
"{0!r} is not present in revision {1}").format(
2913
3474
filename, rev_tree.get_revision_id()))
2915
content = rev_tree.get_file_text(old_file_id)
3475
rev_tree_path = relpath
2917
cur_file_id = tree.path2id(relpath)
2919
if cur_file_id is not None:
2920
# Then try with the actual file id
2922
content = rev_tree.get_file_text(cur_file_id)
2924
except errors.NoSuchId:
2925
# The actual file id didn't exist at that time
2927
if not found and old_file_id is not None:
2928
# Finally try with the old file id
2929
content = rev_tree.get_file_text(old_file_id)
2932
# Can't be found anywhere
2933
raise errors.BzrCommandError(
2934
"%r is not present in revision %s" % (
2935
filename, rev_tree.get_revision_id()))
3478
rev_tree_path = _mod_tree.find_previous_path(
3479
tree, rev_tree, relpath)
3480
except errors.NoSuchFile:
3481
rev_tree_path = None
3483
if rev_tree_path is None:
3484
# Path didn't exist in working tree
3485
if not rev_tree.is_versioned(relpath):
3486
raise errors.BzrCommandError(gettext(
3487
"{0!r} is not present in revision {1}").format(
3488
filename, rev_tree.get_revision_id()))
3490
# Fall back to the same path in the basis tree, if present.
3491
rev_tree_path = relpath
2937
from bzrlib.filters import (
2938
ContentFilterContext,
2939
filtered_output_bytes,
2941
filters = rev_tree._content_filter_stack(relpath)
2942
chunks = content.splitlines(True)
2943
content = filtered_output_bytes(chunks, filters,
2944
ContentFilterContext(relpath, rev_tree))
2946
self.outf.writelines(content)
3494
from .filter_tree import ContentFilterTree
3495
filter_tree = ContentFilterTree(
3496
rev_tree, rev_tree._content_filter_stack)
3497
fileobj = filter_tree.get_file(rev_tree_path)
2949
self.outf.write(content)
3499
fileobj = rev_tree.get_file(rev_tree_path)
3500
shutil.copyfileobj(fileobj, self.outf)
2952
3504
class cmd_local_time_offset(Command):
2953
3505
__doc__ = """Show the offset in seconds from GMT to local time."""
2955
3508
@display_command
2957
3510
self.outf.write("%s\n" % osutils.local_time_offset())
2961
3513
class cmd_commit(Command):
2962
3514
__doc__ = """Commit changes into a new revision.
2994
3546
"John Doe <jdoe@example.com>". If there is more than one author of
2995
3547
the change you can specify the option multiple times, once for each
3000
3552
A common mistake is to forget to add a new file or directory before
3001
3553
running the commit command. The --strict option checks for unknown
3002
3554
files and aborts the commit if any are found. More advanced pre-commit
3003
checks can be implemented by defining hooks. See ``bzr help hooks``
3555
checks can be implemented by defining hooks. See ``brz help hooks``
3006
3558
:Things to note:
3008
If you accidentially commit the wrong changes or make a spelling
3560
If you accidentally commit the wrong changes or make a spelling
3009
3561
mistake in the commit message say, you can use the uncommit command
3010
to undo it. See ``bzr help uncommit`` for details.
3562
to undo it. See ``brz help uncommit`` for details.
3012
3564
Hooks can also be configured to run after a commit. This allows you
3013
3565
to trigger updates to external systems like bug trackers. The --fixes
3014
3566
option can be used to record the association between a revision and
3015
one or more bugs. See ``bzr help bugs`` for details.
3017
A selective commit may fail in some cases where the committed
3018
tree would be invalid. Consider::
3023
bzr commit foo -m "committing foo"
3024
bzr mv foo/bar foo/baz
3027
bzr commit foo/bar -m "committing bar but not baz"
3029
In the example above, the last commit will fail by design. This gives
3030
the user the opportunity to decide whether they want to commit the
3031
rename at the same time, separately first, or not at all. (As a general
3032
rule, when in doubt, Bazaar has a policy of Doing the Safe Thing.)
3567
one or more bugs. See ``brz help bugs`` for details.
3034
# TODO: Run hooks on tree to-be-committed, and after commit.
3036
# TODO: Strict commit that fails if there are deleted files.
3037
# (what does "deleted files" mean ??)
3039
# TODO: Give better message for -s, --summary, used by tla people
3041
# XXX: verbose currently does nothing
3043
3570
_see_also = ['add', 'bugs', 'hooks', 'uncommit']
3044
3571
takes_args = ['selected*']
3045
3572
takes_options = [
3046
ListOption('exclude', type=str, short_name='x',
3047
help="Do not consider changes made to a given path."),
3048
Option('message', type=unicode,
3050
help="Description of the new revision."),
3053
help='Commit even if nothing has changed.'),
3054
Option('file', type=str,
3057
help='Take commit message from this file.'),
3059
help="Refuse to commit if there are unknown "
3060
"files in the working tree."),
3061
Option('commit-time', type=str,
3062
help="Manually set a commit time using commit date "
3063
"format, e.g. '2009-10-10 08:00:00 +0100'."),
3064
ListOption('fixes', type=str,
3065
help="Mark a bug as being fixed by this revision "
3066
"(see \"bzr help bugs\")."),
3067
ListOption('author', type=unicode,
3068
help="Set the author's name, if it's different "
3069
"from the committer."),
3071
help="Perform a local commit in a bound "
3072
"branch. Local commits are not pushed to "
3073
"the master branch until a normal commit "
3076
Option('show-diff', short_name='p',
3077
help='When no message is supplied, show the diff along'
3078
' with the status summary in the message editor.'),
3574
'exclude', type=text_type, short_name='x',
3575
help="Do not consider changes made to a given path."),
3576
Option('message', type=text_type,
3578
help="Description of the new revision."),
3581
help='Commit even if nothing has changed.'),
3582
Option('file', type=text_type,
3585
help='Take commit message from this file.'),
3587
help="Refuse to commit if there are unknown "
3588
"files in the working tree."),
3589
Option('commit-time', type=text_type,
3590
help="Manually set a commit time using commit date "
3591
"format, e.g. '2009-10-10 08:00:00 +0100'."),
3593
'bugs', type=text_type,
3594
help="Link to a related bug. (see \"brz help bugs\")."),
3596
'fixes', type=text_type,
3597
help="Mark a bug as being fixed by this revision "
3598
"(see \"brz help bugs\")."),
3600
'author', type=text_type,
3601
help="Set the author's name, if it's different "
3602
"from the committer."),
3604
help="Perform a local commit in a bound "
3605
"branch. Local commits are not pushed to "
3606
"the master branch until a normal commit "
3609
Option('show-diff', short_name='p',
3610
help='When no message is supplied, show the diff along'
3611
' with the status summary in the message editor.'),
3613
help='When committing to a foreign version control '
3614
'system do not push data that can not be natively '
3080
3616
aliases = ['ci', 'checkin']
3082
def _iter_bug_fix_urls(self, fixes, branch):
3618
def _iter_bug_urls(self, bugs, branch, status):
3619
default_bugtracker = None
3083
3620
# Configure the properties for bug fixing attributes.
3084
for fixed_bug in fixes:
3085
tokens = fixed_bug.split(':')
3086
if len(tokens) != 2:
3087
raise errors.BzrCommandError(
3622
tokens = bug.split(':')
3623
if len(tokens) == 1:
3624
if default_bugtracker is None:
3625
branch_config = branch.get_config_stack()
3626
default_bugtracker = branch_config.get(
3628
if default_bugtracker is None:
3629
raise errors.BzrCommandError(gettext(
3630
"No tracker specified for bug %s. Use the form "
3631
"'tracker:id' or specify a default bug tracker "
3632
"using the `bugtracker` option.\nSee "
3633
"\"brz help bugs\" for more information on this "
3634
"feature. Commit refused.") % bug)
3635
tag = default_bugtracker
3637
elif len(tokens) != 2:
3638
raise errors.BzrCommandError(gettext(
3088
3639
"Invalid bug %s. Must be in the form of 'tracker:id'. "
3089
"See \"bzr help bugs\" for more information on this "
3090
"feature.\nCommit refused." % fixed_bug)
3091
tag, bug_id = tokens
3640
"See \"brz help bugs\" for more information on this "
3641
"feature.\nCommit refused.") % bug)
3643
tag, bug_id = tokens
3093
yield bugtracker.get_bug_url(tag, branch, bug_id)
3094
except errors.UnknownBugTrackerAbbreviation:
3095
raise errors.BzrCommandError(
3096
'Unrecognized bug %s. Commit refused.' % fixed_bug)
3097
except errors.MalformedBugIdentifier, e:
3098
raise errors.BzrCommandError(
3099
"%s\nCommit refused." % (str(e),))
3645
yield bugtracker.get_bug_url(tag, branch, bug_id), status
3646
except bugtracker.UnknownBugTrackerAbbreviation:
3647
raise errors.BzrCommandError(gettext(
3648
'Unrecognized bug %s. Commit refused.') % bug)
3649
except bugtracker.MalformedBugIdentifier as e:
3650
raise errors.BzrCommandError(gettext(
3651
u"%s\nCommit refused.") % (e,))
3101
3653
def run(self, message=None, file=None, verbose=False, selected_list=None,
3102
unchanged=False, strict=False, local=False, fixes=None,
3103
author=None, show_diff=False, exclude=None, commit_time=None):
3104
from bzrlib.errors import (
3654
unchanged=False, strict=False, local=False, fixes=None, bugs=None,
3655
author=None, show_diff=False, exclude=None, commit_time=None,
3658
from .commit import (
3105
3659
PointlessCommit,
3661
from .errors import (
3106
3662
ConflictsInTree,
3107
3663
StrictCommitFailed
3109
from bzrlib.msgeditor import (
3665
from .msgeditor import (
3110
3666
edit_commit_message_encoded,
3111
3667
generate_commit_message_template,
3112
make_commit_message_template_encoded
3668
make_commit_message_template_encoded,
3115
3672
commit_stamp = offset = None
3116
3673
if commit_time is not None:
3118
3675
commit_stamp, offset = timestamp.parse_patch_date(commit_time)
3119
except ValueError, e:
3120
raise errors.BzrCommandError(
3121
"Could not parse --commit-time: " + str(e))
3123
# TODO: Need a blackbox test for invoking the external editor; may be
3124
# slightly problematic to run this cross-platform.
3126
# TODO: do more checks that the commit will succeed before
3127
# spending the user's valuable time typing a commit message.
3676
except ValueError as e:
3677
raise errors.BzrCommandError(gettext(
3678
"Could not parse --commit-time: " + str(e)))
3129
3680
properties = {}
3131
tree, selected_list = tree_files(selected_list)
3682
tree, selected_list = WorkingTree.open_containing_paths(selected_list)
3132
3683
if selected_list == ['']:
3133
3684
# workaround - commit of root of tree should be exactly the same
3134
3685
# as just default commit in that tree, and succeed even though
3297
3863
class cmd_upgrade(Command):
3298
__doc__ = """Upgrade branch storage to current format.
3300
The check command or bzr developers may sometimes advise you to run
3301
this command. When the default format has changed you may also be warned
3302
during other operations to upgrade.
3864
__doc__ = """Upgrade a repository, branch or working tree to a newer format.
3866
When the default format has changed after a major new release of
3867
Bazaar/Breezy, you may be informed during certain operations that you
3868
should upgrade. Upgrading to a newer format may improve performance
3869
or make new features available. It may however limit interoperability
3870
with older repositories or with older versions of Bazaar or Breezy.
3872
If you wish to upgrade to a particular format rather than the
3873
current default, that can be specified using the --format option.
3874
As a consequence, you can use the upgrade command this way to
3875
"downgrade" to an earlier format, though some conversions are
3876
a one way process (e.g. changing from the 1.x default to the
3877
2.x default) so downgrading is not always possible.
3879
A backup.bzr.~#~ directory is created at the start of the conversion
3880
process (where # is a number). By default, this is left there on
3881
completion. If the conversion fails, delete the new .bzr directory
3882
and rename this one back in its place. Use the --clean option to ask
3883
for the backup.bzr directory to be removed on successful conversion.
3884
Alternatively, you can delete it by hand if everything looks good
3887
If the location given is a shared repository, dependent branches
3888
are also converted provided the repository converts successfully.
3889
If the conversion of a branch fails, remaining branches are still
3892
For more information on upgrades, see the Breezy Upgrade Guide,
3893
https://www.breezy-vcs.org/doc/en/upgrade-guide/.
3305
_see_also = ['check']
3896
_see_also = ['check', 'reconcile', 'formats']
3306
3897
takes_args = ['url?']
3307
3898
takes_options = [
3308
RegistryOption('format',
3309
help='Upgrade to a specific format. See "bzr help'
3310
' formats" for details.',
3311
lazy_registry=('bzrlib.bzrdir', 'format_registry'),
3312
converter=lambda name: bzrdir.format_registry.make_bzrdir(name),
3313
value_switches=True, title='Branch format'),
3899
RegistryOption('format',
3900
help='Upgrade to a specific format. See "brz help'
3901
' formats" for details.',
3902
lazy_registry=('breezy.controldir', 'format_registry'),
3903
converter=lambda name: controldir.format_registry.make_controldir(
3905
value_switches=True, title='Branch format'),
3907
help='Remove the backup.bzr directory if successful.'),
3909
help="Show what would be done, but don't actually do anything."),
3316
def run(self, url='.', format=None):
3317
from bzrlib.upgrade import upgrade
3318
upgrade(url, format)
3912
def run(self, url='.', format=None, clean=False, dry_run=False):
3913
from .upgrade import upgrade
3914
exceptions = upgrade(url, format, clean_up=clean, dry_run=dry_run)
3916
if len(exceptions) == 1:
3917
# Compatibility with historical behavior
3321
3923
class cmd_whoami(Command):
3322
__doc__ = """Show or set bzr user id.
3924
__doc__ = """Show or set brz user id.
3325
3927
Show the email of the current user::
3329
3931
Set the current user::
3331
bzr whoami "Frank Chu <fchu@example.com>"
3933
brz whoami "Frank Chu <fchu@example.com>"
3333
takes_options = [ Option('email',
3334
help='Display email address only.'),
3336
help='Set identity for the current branch instead of '
3935
takes_options = ['directory',
3937
help='Display email address only.'),
3939
help='Set identity for the current branch instead of '
3339
3942
takes_args = ['name?']
3340
3943
encoding_type = 'replace'
3342
3945
@display_command
3343
def run(self, email=False, branch=False, name=None):
3946
def run(self, email=False, branch=False, name=None, directory=None):
3344
3947
if name is None:
3345
# use branch if we're inside one; otherwise global config
3347
c = Branch.open_containing('.')[0].get_config()
3348
except errors.NotBranchError:
3349
c = config.GlobalConfig()
3948
if directory is None:
3949
# use branch if we're inside one; otherwise global config
3951
c = Branch.open_containing(u'.')[0].get_config_stack()
3952
except errors.NotBranchError:
3953
c = _mod_config.GlobalStack()
3955
c = Branch.open(directory).get_config_stack()
3956
identity = c.get('email')
3351
self.outf.write(c.user_email() + '\n')
3958
self.outf.write(_mod_config.extract_email_address(identity)
3353
self.outf.write(c.username() + '\n')
3961
self.outf.write(identity + '\n')
3965
raise errors.BzrCommandError(gettext("--email can only be used to display existing "
3356
3968
# display a warning if an email address isn't included in the given name.
3358
config.extract_email_address(name)
3359
except errors.NoEmailInUsername, e:
3970
_mod_config.extract_email_address(name)
3971
except _mod_config.NoEmailInUsername:
3360
3972
warning('"%s" does not seem to contain an email address. '
3361
3973
'This is allowed, but not recommended.', name)
3363
3975
# use global config unless --branch given
3365
c = Branch.open_containing('.')[0].get_config()
3977
if directory is None:
3978
c = Branch.open_containing(u'.')[0].get_config_stack()
3980
b = Branch.open(directory)
3981
self.enter_context(b.lock_write())
3982
c = b.get_config_stack()
3367
c = config.GlobalConfig()
3368
c.set_user_option('email', name)
3984
c = _mod_config.GlobalStack()
3985
c.set('email', name)
3371
3988
class cmd_nick(Command):
3372
3989
__doc__ = """Print or set the branch nickname.
3374
If unset, the tree root directory name is used as the nickname.
3375
To print the current nickname, execute with no argument.
3991
If unset, the colocated branch name is used for colocated branches, and
3992
the branch directory name is used for other branches. To print the
3993
current nickname, execute with no argument.
3377
3995
Bound branches use the nickname of its master branch unless it is set
3586
4213
def run(self, testspecs_list=None, verbose=False, one=False,
3587
4214
transport=None, benchmark=None,
3588
lsprof_timed=None, cache_dir=None,
3589
4216
first=False, list_only=False,
3590
4217
randomize=None, exclude=None, strict=False,
3591
load_list=None, debugflag=None, starting_with=None, subunit=False,
3592
parallel=None, lsprof_tests=False):
3593
from bzrlib.tests import selftest
3594
import bzrlib.benchmarks as benchmarks
3595
from bzrlib.benchmarks import tree_creator
3597
# Make deprecation warnings visible, unless -Werror is set
3598
symbol_versioning.activate_deprecation_warnings(override=False)
3600
if cache_dir is not None:
3601
tree_creator.TreeCreator.CACHE_ROOT = osutils.abspath(cache_dir)
4218
load_list=None, debugflag=None, starting_with=None, subunit1=False,
4219
subunit2=False, parallel=None, lsprof_tests=False, sync=False):
4221
# During selftest, disallow proxying, as it can cause severe
4222
# performance penalties and is only needed for thread
4223
# safety. The selftest command is assumed to not use threads
4224
# too heavily. The call should be as early as possible, as
4225
# error reporting for past duplicate imports won't have useful
4227
if sys.version_info[0] < 3:
4228
# TODO(pad.lv/1696545): Allow proxying on Python 3, since
4229
# disallowing it currently leads to failures in many places.
4230
lazy_import.disallow_proxying()
4235
raise errors.BzrCommandError("tests not available. Install the "
4236
"breezy tests to run the breezy testsuite.")
3602
4238
if testspecs_list is not None:
3603
4239
pattern = '|'.join(testspecs_list)
3608
from bzrlib.tests import SubUnitBzrRunner
4244
from .tests import SubUnitBzrRunnerv1
3609
4245
except ImportError:
3610
raise errors.BzrCommandError("subunit not available. subunit "
3611
"needs to be installed to use --subunit.")
3612
self.additional_selftest_args['runner_class'] = SubUnitBzrRunner
4246
raise errors.BzrCommandError(gettext(
4247
"subunit not available. subunit needs to be installed "
4248
"to use --subunit."))
4249
self.additional_selftest_args['runner_class'] = SubUnitBzrRunnerv1
3613
4250
# On Windows, disable automatic conversion of '\n' to '\r\n' in
3614
# stdout, which would corrupt the subunit stream.
3615
if sys.platform == "win32" and sys.stdout.fileno() >= 0:
4251
# stdout, which would corrupt the subunit stream.
4252
# FIXME: This has been fixed in subunit trunk (>0.0.5) so the
4253
# following code can be deleted when it's sufficiently deployed
4254
# -- vila/mgz 20100514
4255
if (sys.platform == "win32"
4256
and getattr(sys.stdout, 'fileno', None) is not None):
3617
4258
msvcrt.setmode(sys.stdout.fileno(), os.O_BINARY)
4261
from .tests import SubUnitBzrRunnerv2
4263
raise errors.BzrCommandError(gettext(
4264
"subunit not available. subunit "
4265
"needs to be installed to use --subunit2."))
4266
self.additional_selftest_args['runner_class'] = SubUnitBzrRunnerv2
3619
4269
self.additional_selftest_args.setdefault(
3620
4270
'suite_decorators', []).append(parallel)
3622
test_suite_factory = benchmarks.test_suite
3623
# Unless user explicitly asks for quiet, be verbose in benchmarks
3624
verbose = not is_quiet()
3625
# TODO: should possibly lock the history file...
3626
benchfile = open(".perf_history", "at", buffering=1)
3627
self.add_cleanup(benchfile.close)
4272
raise errors.BzrCommandError(gettext(
4273
"--benchmark is no longer supported from brz 2.2; "
4274
"use bzr-usertest instead"))
4275
test_suite_factory = None
4277
exclude_pattern = None
3629
test_suite_factory = None
4279
exclude_pattern = '(' + '|'.join(exclude) + ')'
4281
self._disable_fsync()
3631
4282
selftest_kwargs = {"verbose": verbose,
3633
"stop_on_failure": one,
3634
"transport": transport,
3635
"test_suite_factory": test_suite_factory,
3636
"lsprof_timed": lsprof_timed,
3637
"lsprof_tests": lsprof_tests,
3638
"bench_history": benchfile,
3639
"matching_tests_first": first,
3640
"list_only": list_only,
3641
"random_seed": randomize,
3642
"exclude_pattern": exclude,
3644
"load_list": load_list,
3645
"debug_flags": debugflag,
3646
"starting_with": starting_with
4284
"stop_on_failure": one,
4285
"transport": transport,
4286
"test_suite_factory": test_suite_factory,
4287
"lsprof_timed": lsprof_timed,
4288
"lsprof_tests": lsprof_tests,
4289
"matching_tests_first": first,
4290
"list_only": list_only,
4291
"random_seed": randomize,
4292
"exclude_pattern": exclude_pattern,
4294
"load_list": load_list,
4295
"debug_flags": debugflag,
4296
"starting_with": starting_with
3648
4298
selftest_kwargs.update(self.additional_selftest_args)
3649
result = selftest(**selftest_kwargs)
4300
# Make deprecation warnings visible, unless -Werror is set
4301
cleanup = symbol_versioning.activate_deprecation_warnings(
4304
result = tests.selftest(**selftest_kwargs)
3650
4307
return int(not result)
4309
def _disable_fsync(self):
4310
"""Change the 'os' functionality to not synchronize."""
4311
self._orig_fsync = getattr(os, 'fsync', None)
4312
if self._orig_fsync is not None:
4313
os.fsync = lambda filedes: None
4314
self._orig_fdatasync = getattr(os, 'fdatasync', None)
4315
if self._orig_fdatasync is not None:
4316
os.fdatasync = lambda filedes: None
3653
4319
class cmd_version(Command):
3654
__doc__ = """Show version of bzr."""
4320
__doc__ = """Show version of brz."""
3656
4322
encoding_type = 'replace'
3657
4323
takes_options = [
3709
4374
The source of the merge can be specified either in the form of a branch,
3710
4375
or in the form of a path to a file containing a merge directive generated
3711
with bzr send. If neither is specified, the default is the upstream branch
3712
or the branch most recently merged using --remember.
3714
When merging a branch, by default the tip will be merged. To pick a different
3715
revision, pass --revision. If you specify two values, the first will be used as
3716
BASE and the second one as OTHER. Merging individual revisions, or a subset of
3717
available revisions, like this is commonly referred to as "cherrypicking".
3719
Revision numbers are always relative to the branch being merged.
3721
By default, bzr will try to merge in all new work from the other
3722
branch, automatically determining an appropriate base. If this
3723
fails, you may need to give an explicit base.
4376
with brz send. If neither is specified, the default is the upstream branch
4377
or the branch most recently merged using --remember. The source of the
4378
merge may also be specified in the form of a path to a file in another
4379
branch: in this case, only the modifications to that file are merged into
4380
the current working tree.
4382
When merging from a branch, by default brz will try to merge in all new
4383
work from the other branch, automatically determining an appropriate base
4384
revision. If this fails, you may need to give an explicit base.
4386
To pick a different ending revision, pass "--revision OTHER". brz will
4387
try to merge in all new work up to and including revision OTHER.
4389
If you specify two values, "--revision BASE..OTHER", only revisions BASE
4390
through OTHER, excluding BASE but including OTHER, will be merged. If this
4391
causes some revisions to be skipped, i.e. if the destination branch does
4392
not already contain revision BASE, such a merge is commonly referred to as
4393
a "cherrypick". Unlike a normal merge, Breezy does not currently track
4394
cherrypicks. The changes look like a normal commit, and the history of the
4395
changes from the other branch is not stored in the commit.
4397
Revision numbers are always relative to the source branch.
3725
4399
Merge will do its best to combine the changes in two branches, but there
3726
4400
are some kinds of problems only a human can fix. When it encounters those,
3727
4401
it will mark a conflict. A conflict means that you need to fix something,
3728
before you should commit.
3730
Use bzr resolve when you have fixed a problem. See also bzr conflicts.
3732
If there is no default branch set, the first merge will set it. After
3733
that, you can omit the branch to use the default. To change the
3734
default, use --remember. The value will only be saved if the remote
3735
location can be accessed.
4402
before you can commit.
4404
Use brz resolve when you have fixed a problem. See also brz conflicts.
4406
If there is no default branch set, the first merge will set it (use
4407
--no-remember to avoid setting it). After that, you can omit the branch
4408
to use the default. To change the default, use --remember. The value will
4409
only be saved if the remote location can be accessed.
3737
4411
The results of the merge are placed into the destination working
3738
directory, where they can be reviewed (with bzr diff), tested, and then
4412
directory, where they can be reviewed (with brz diff), tested, and then
3739
4413
committed to record the result of the merge.
3741
4415
merge refuses to run if there are any uncommitted changes, unless
3742
--force is given. The --force option can also be used to create a
4416
--force is given. If --force is given, then the changes from the source
4417
will be merged with the current working tree, including any uncommitted
4418
changes in the tree. The --force option can also be used to create a
3743
4419
merge revision which has more than two parents.
3745
4421
If one would like to merge changes from the working tree of the other
3836
4509
change_reporter = delta._ChangeReporter(
3837
4510
unversioned_filter=tree.is_ignored, view_info=view_info)
3838
4511
pb = ui.ui_factory.nested_progress_bar()
3839
self.add_cleanup(pb.finished)
3841
self.add_cleanup(tree.unlock)
4512
self.enter_context(pb)
4513
self.enter_context(tree.lock_write())
3842
4514
if location is not None:
3844
mergeable = bundle.read_mergeable_from_url(location,
3845
possible_transports=possible_transports)
4516
mergeable = _mod_mergeable.read_mergeable_from_url(
4517
location, possible_transports=possible_transports)
3846
4518
except errors.NotABundle:
3847
4519
mergeable = None
3849
4521
if uncommitted:
3850
raise errors.BzrCommandError('Cannot use --uncommitted'
3851
' with bundles or merge directives.')
4522
raise errors.BzrCommandError(gettext('Cannot use --uncommitted'
4523
' with bundles or merge directives.'))
3853
4525
if revision is not None:
3854
raise errors.BzrCommandError(
3855
'Cannot use -r with merge directives or bundles')
4526
raise errors.BzrCommandError(gettext(
4527
'Cannot use -r with merge directives or bundles'))
3856
4528
merger, verified = _mod_merge.Merger.from_mergeable(tree,
3859
4531
if merger is None and uncommitted:
3860
4532
if revision is not None and len(revision) > 0:
3861
raise errors.BzrCommandError('Cannot use --uncommitted and'
3862
' --revision at the same time.')
4533
raise errors.BzrCommandError(gettext('Cannot use --uncommitted and'
4534
' --revision at the same time.'))
3863
4535
merger = self.get_merger_from_uncommitted(tree, location, None)
3864
4536
allow_pending = False
3866
4538
if merger is None:
3867
4539
merger, allow_pending = self._get_merger_from_branch(tree,
3868
location, revision, remember, possible_transports, None)
4540
location, revision, remember, possible_transports, None)
3870
4542
merger.merge_type = merge_type
3871
4543
merger.reprocess = reprocess
3872
4544
merger.show_base = show_base
3873
4545
self.sanity_check_merger(merger)
3874
4546
if (merger.base_rev_id == merger.other_rev_id and
3875
merger.other_rev_id is not None):
3876
note('Nothing to do.')
4547
merger.other_rev_id is not None):
4548
# check if location is a nonexistent file (and not a branch) to
4549
# disambiguate the 'Nothing to do'
4550
if merger.interesting_files:
4551
if not merger.other_tree.has_filename(
4552
merger.interesting_files[0]):
4553
note(gettext("merger: ") + str(merger))
4554
raise errors.PathsDoNotExist([location])
4555
note(gettext('Nothing to do.'))
4557
if pull and not preview:
3879
4558
if merger.interesting_files is not None:
3880
raise errors.BzrCommandError('Cannot pull individual files')
4559
raise errors.BzrCommandError(
4560
gettext('Cannot pull individual files'))
3881
4561
if (merger.base_rev_id == tree.last_revision()):
3882
4562
result = tree.pull(merger.other_branch, False,
3883
4563
merger.other_rev_id)
3884
4564
result.report(self.outf)
3886
4566
if merger.this_basis is None:
3887
raise errors.BzrCommandError(
4567
raise errors.BzrCommandError(gettext(
3888
4568
"This branch has no commits."
3889
" (perhaps you would prefer 'bzr pull')")
4569
" (perhaps you would prefer 'brz pull')"))
3891
4571
return self._do_preview(merger)
3892
4572
elif interactive:
4079
4778
Re-do the merge of all conflicted files, and show the base text in
4080
4779
conflict regions, in addition to the usual THIS and OTHER texts::
4082
bzr remerge --show-base
4781
brz remerge --show-base
4084
4783
Re-do the merge of "foobar", using the weave merge algorithm, with
4085
4784
additional processing to reduce the size of conflict regions::
4087
bzr remerge --merge-type weave --reprocess foobar
4786
brz remerge --merge-type weave --reprocess foobar
4089
4788
takes_args = ['file*']
4090
4789
takes_options = [
4094
help="Show base revision text in conflicts."),
4793
help="Show base revision text in conflicts."),
4097
4796
def run(self, file_list=None, merge_type=None, show_base=False,
4098
4797
reprocess=False):
4099
from bzrlib.conflicts import restore
4798
from .conflicts import restore
4100
4799
if merge_type is None:
4101
4800
merge_type = _mod_merge.Merge3Merger
4102
tree, file_list = tree_files(file_list)
4104
self.add_cleanup(tree.unlock)
4801
tree, file_list = WorkingTree.open_containing_paths(file_list)
4802
self.enter_context(tree.lock_write())
4105
4803
parents = tree.get_parent_ids()
4106
4804
if len(parents) != 2:
4107
raise errors.BzrCommandError("Sorry, remerge only works after normal"
4108
" merges. Not cherrypicking or"
4110
repository = tree.branch.repository
4111
interesting_ids = None
4805
raise errors.BzrCommandError(
4806
gettext("Sorry, remerge only works after normal"
4807
" merges. Not cherrypicking or multi-merges."))
4808
interesting_files = None
4112
4809
new_conflicts = []
4113
4810
conflicts = tree.conflicts()
4114
4811
if file_list is not None:
4115
interesting_ids = set()
4812
interesting_files = set()
4116
4813
for filename in file_list:
4117
file_id = tree.path2id(filename)
4814
if not tree.is_versioned(filename):
4119
4815
raise errors.NotVersionedError(filename)
4120
interesting_ids.add(file_id)
4121
if tree.kind(file_id) != "directory":
4816
interesting_files.add(filename)
4817
if tree.kind(filename) != "directory":
4124
for name, ie in tree.inventory.iter_entries(file_id):
4125
interesting_ids.add(ie.file_id)
4820
for path, ie in tree.iter_entries_by_dir(
4821
specific_files=[filename]):
4822
interesting_files.add(path)
4126
4823
new_conflicts = conflicts.select_conflicts(tree, file_list)[0]
4128
4825
# Remerge only supports resolving contents conflicts
4129
4826
allowed_conflicts = ('text conflict', 'contents conflict')
4130
4827
restore_files = [c.path for c in conflicts
4131
4828
if c.typestring in allowed_conflicts]
4132
_mod_merge.transform_tree(tree, tree.basis_tree(), interesting_ids)
4829
_mod_merge.transform_tree(tree, tree.basis_tree(), interesting_files)
4133
4830
tree.set_conflicts(ConflictList(new_conflicts))
4134
4831
if file_list is not None:
4135
4832
restore_files = file_list
4578
5283
Option('long', help='Show commit date in annotations.'),
4582
5288
encoding_type = 'exact'
4584
5290
@display_command
4585
5291
def run(self, filename, all=False, long=False, revision=None,
4587
from bzrlib.annotate import annotate_file, annotate_file_tree
5292
show_ids=False, directory=None):
5293
from .annotate import (
4588
5296
wt, branch, relpath = \
4589
bzrdir.BzrDir.open_containing_tree_or_branch(filename)
5297
_open_directory_or_containing_tree_or_branch(filename, directory)
4590
5298
if wt is not None:
4592
self.add_cleanup(wt.unlock)
5299
self.enter_context(wt.lock_read())
4595
self.add_cleanup(branch.unlock)
5301
self.enter_context(branch.lock_read())
4596
5302
tree = _get_one_revision_tree('annotate', revision, branch=branch)
4598
self.add_cleanup(tree.unlock)
4600
file_id = wt.path2id(relpath)
4602
file_id = tree.path2id(relpath)
4604
raise errors.NotVersionedError(filename)
4605
file_version = tree.inventory[file_id].revision
5303
self.enter_context(tree.lock_read())
4606
5304
if wt is not None and revision is None:
5305
if not wt.is_versioned(relpath):
5306
raise errors.NotVersionedError(relpath)
4607
5307
# If there is a tree and we're not annotating historical
4608
5308
# versions, annotate the working tree's content.
4609
annotate_file_tree(wt, file_id, self.outf, long, all,
5309
annotate_file_tree(wt, relpath, self.outf, long, all,
4612
annotate_file(branch, file_version, file_id, long, all, self.outf,
5312
if not tree.is_versioned(relpath):
5313
raise errors.NotVersionedError(relpath)
5314
annotate_file_tree(tree, relpath, self.outf, long, all,
5315
show_ids=show_ids, branch=branch)
4616
5318
class cmd_re_sign(Command):
4617
5319
__doc__ = """Create a digital signature for an existing revision."""
4618
5320
# TODO be able to replace existing ones.
4620
hidden = True # is this right ?
5322
hidden = True # is this right ?
4621
5323
takes_args = ['revision_id*']
4622
takes_options = ['revision']
5324
takes_options = ['directory', 'revision']
4624
def run(self, revision_id_list=None, revision=None):
5326
def run(self, revision_id_list=None, revision=None, directory=u'.'):
4625
5327
if revision_id_list is not None and revision is not None:
4626
raise errors.BzrCommandError('You can only supply one of revision_id or --revision')
5328
raise errors.BzrCommandError(
5329
gettext('You can only supply one of revision_id or --revision'))
4627
5330
if revision_id_list is None and revision is None:
4628
raise errors.BzrCommandError('You must supply either --revision or a revision_id')
4629
b = WorkingTree.open_containing(u'.')[0].branch
4631
self.add_cleanup(b.unlock)
5331
raise errors.BzrCommandError(
5332
gettext('You must supply either --revision or a revision_id'))
5333
b = WorkingTree.open_containing(directory)[0].branch
5334
self.enter_context(b.lock_write())
4632
5335
return self._run(b, revision_id_list, revision)
4634
5337
def _run(self, b, revision_id_list, revision):
4635
import bzrlib.gpg as gpg
4636
gpg_strategy = gpg.GPGStrategy(b.get_config())
5338
from .repository import WriteGroup
5339
gpg_strategy = gpg.GPGStrategy(b.get_config_stack())
4637
5340
if revision_id_list is not None:
4638
b.repository.start_write_group()
5341
with WriteGroup(b.repository):
4640
5342
for revision_id in revision_id_list:
5343
revision_id = cache_utf8.encode(revision_id)
4641
5344
b.repository.sign_revision(revision_id, gpg_strategy)
4643
b.repository.abort_write_group()
4646
b.repository.commit_write_group()
4647
5345
elif revision is not None:
4648
5346
if len(revision) == 1:
4649
5347
revno, rev_id = revision[0].in_history(b)
4650
b.repository.start_write_group()
5348
with WriteGroup(b.repository):
4652
5349
b.repository.sign_revision(rev_id, gpg_strategy)
4654
b.repository.abort_write_group()
4657
b.repository.commit_write_group()
4658
5350
elif len(revision) == 2:
4659
5351
# are they both on rh- if so we can walk between them
4660
5352
# might be nice to have a range helper for arbitrary
4827
5520
end_revision=last_revno)
4830
self.outf.write('Dry-run, pretending to remove'
4831
' the above revisions.\n')
5523
self.outf.write(gettext('Dry-run, pretending to remove'
5524
' the above revisions.\n'))
4833
self.outf.write('The above revision(s) will be removed.\n')
5527
gettext('The above revision(s) will be removed.\n'))
4836
if not ui.ui_factory.get_boolean('Are you sure'):
4837
self.outf.write('Canceled')
5530
if not ui.ui_factory.confirm_action(
5531
gettext(u'Uncommit these revisions'),
5532
'breezy.builtins.uncommit',
5534
self.outf.write(gettext('Canceled\n'))
4840
5537
mutter('Uncommitting from {%s} to {%s}',
4841
5538
last_rev_id, rev_id)
4842
5539
uncommit(b, tree=tree, dry_run=dry_run, verbose=verbose,
4843
revno=revno, local=local)
4844
self.outf.write('You can restore the old tip by running:\n'
4845
' bzr pull . -r revid:%s\n' % last_rev_id)
5540
revno=revno, local=local, keep_tags=keep_tags)
5543
gettext('You can restore the old tip by running:\n'
5544
' brz pull -d %s %s -r revid:%s\n')
5545
% (location, location, last_rev_id.decode('utf-8')))
5548
gettext('You can restore the old tip by running:\n'
5549
' brz pull . -r revid:%s\n')
5550
% last_rev_id.decode('utf-8'))
4848
5553
class cmd_break_lock(Command):
4849
__doc__ = """Break a dead lock on a repository, branch or working directory.
5554
__doc__ = """Break a dead lock.
5556
This command breaks a lock on a repository, branch, working directory or
4851
5559
CAUTION: Locks should only be broken when you are sure that the process
4852
5560
holding the lock has been stopped.
4854
You can get information on what locks are open via the 'bzr info
5562
You can get information on what locks are open via the 'brz info
4855
5563
[location]' command.
4859
bzr break-lock bzr+ssh://example.com/bzr/foo
5567
brz break-lock brz+ssh://example.com/brz/foo
5568
brz break-lock --conf ~/.config/breezy
4861
5571
takes_args = ['location?']
5574
help='LOCATION is the directory where the config lock is.'),
5576
help='Do not ask for confirmation before breaking the lock.'),
4863
def run(self, location=None, show=False):
5579
def run(self, location=None, config=False, force=False):
4864
5580
if location is None:
4865
5581
location = u'.'
4866
control, relpath = bzrdir.BzrDir.open_containing(location)
4868
control.break_lock()
4869
except NotImplementedError:
5583
ui.ui_factory = ui.ConfirmationUserInterfacePolicy(ui.ui_factory,
5585
{'breezy.lockdir.break': True})
5587
conf = _mod_config.LockableConfig(file_name=location)
5590
control, relpath = controldir.ControlDir.open_containing(location)
5592
control.break_lock()
5593
except NotImplementedError:
4873
5597
class cmd_wait_until_signalled(Command):
4874
__doc__ = """Test helper for test_start_and_stop_bzr_subprocess_send_signal.
5598
__doc__ = """Test helper for test_start_and_stop_brz_subprocess_send_signal.
4876
5600
This just prints a line to signal when it is ready, then blocks on stdin.
4894
5618
help='Serve on stdin/out for use from inetd or sshd.'),
4895
5619
RegistryOption('protocol',
4896
help="Protocol to serve.",
4897
lazy_registry=('bzrlib.transport', 'transport_server_registry'),
4898
value_switches=True),
5620
help="Protocol to serve.",
5621
lazy_registry=('breezy.transport',
5622
'transport_server_registry'),
5623
value_switches=True),
5625
help='Listen for connections on nominated address.',
4900
help='Listen for connections on nominated port of the form '
4901
'[hostname:]portnumber. Passing 0 as the port number will '
4902
'result in a dynamically allocated port. The default port '
4903
'depends on the protocol.',
4906
help='Serve contents of this directory.',
5628
help='Listen for connections on nominated port. Passing 0 as '
5629
'the port number will result in a dynamically allocated '
5630
'port. The default port depends on the protocol.',
5632
custom_help('directory',
5633
help='Serve contents of this directory.'),
4908
5634
Option('allow-writes',
4909
5635
help='By default the server is a readonly server. Supplying '
4910
5636
'--allow-writes enables write access to the contents of '
4911
'the served directory and below. Note that ``bzr serve`` '
5637
'the served directory and below. Note that ``brz serve`` '
4912
5638
'does not perform authentication, so unless some form of '
4913
5639
'external authentication is arranged supplying this '
4914
5640
'option leads to global uncontrolled write access to your '
5643
Option('client-timeout', type=float,
5644
help='Override the default idle client timeout (5min).'),
4919
def get_host_and_port(self, port):
4920
"""Return the host and port to run the smart server on.
4922
If 'port' is None, None will be returned for the host and port.
4924
If 'port' has a colon in it, the string before the colon will be
4925
interpreted as the host.
4927
:param port: A string of the port to run the server on.
4928
:return: A tuple of (host, port), where 'host' is a host name or IP,
4929
and port is an integer TCP/IP port.
4932
if port is not None:
4934
host, port = port.split(':')
4938
def run(self, port=None, inet=False, directory=None, allow_writes=False,
4940
from bzrlib.transport import get_transport, transport_server_registry
5647
def run(self, listen=None, port=None, inet=False, directory=None,
5648
allow_writes=False, protocol=None, client_timeout=None):
5649
from . import location, transport
4941
5650
if directory is None:
4942
directory = os.getcwd()
5651
directory = osutils.getcwd()
4943
5652
if protocol is None:
4944
protocol = transport_server_registry.get()
4945
host, port = self.get_host_and_port(port)
4946
url = urlutils.local_path_to_url(directory)
5653
protocol = transport.transport_server_registry.get()
5654
url = location.location_to_url(directory)
4947
5655
if not allow_writes:
4948
5656
url = 'readonly+' + url
4949
transport = get_transport(url)
4950
protocol(transport, host, port, inet)
5657
t = transport.get_transport_from_url(url)
5658
protocol(t, listen, port, inet, client_timeout)
4953
5661
class cmd_join(Command):
5476
6197
takes_args = ['location?']
5477
6198
takes_options = [
5478
6199
RegistryOption.from_kwargs(
5480
title='Target type',
5481
help='The type to reconfigure the directory to.',
6202
help='The relation between branch and tree.',
5482
6203
value_switches=True, enum_switch=False,
5483
6204
branch='Reconfigure to be an unbound branch with no working tree.',
5484
6205
tree='Reconfigure to be an unbound branch with a working tree.',
5485
6206
checkout='Reconfigure to be a bound branch with a working tree.',
5486
6207
lightweight_checkout='Reconfigure to be a lightweight'
5487
' checkout (with no local history).',
6208
' checkout (with no local history).',
6210
RegistryOption.from_kwargs(
6212
title='Repository type',
6213
help='Location fo the repository.',
6214
value_switches=True, enum_switch=False,
5488
6215
standalone='Reconfigure to be a standalone branch '
5489
'(i.e. stop using shared repository).',
6216
'(i.e. stop using shared repository).',
5490
6217
use_shared='Reconfigure to use a shared repository.',
6219
RegistryOption.from_kwargs(
6221
title='Trees in Repository',
6222
help='Whether new branches in the repository have trees.',
6223
value_switches=True, enum_switch=False,
5491
6224
with_trees='Reconfigure repository to create '
5492
'working trees on branches by default.',
6225
'working trees on branches by default.',
5493
6226
with_no_trees='Reconfigure repository to not create '
5494
'working trees on branches by default.'
6227
'working trees on branches by default.'
5496
Option('bind-to', help='Branch to bind checkout to.', type=str),
6229
Option('bind-to', help='Branch to bind checkout to.', type=text_type),
5497
6230
Option('force',
5498
help='Perform reconfiguration even if local changes'
6231
help='Perform reconfiguration even if local changes'
5500
6233
Option('stacked-on',
5501
help='Reconfigure a branch to be stacked on another branch.',
6234
help='Reconfigure a branch to be stacked on another branch.',
5504
6237
Option('unstacked',
5505
help='Reconfigure a branch to be unstacked. This '
5506
'may require copying substantial data into it.',
6238
help='Reconfigure a branch to be unstacked. This '
6239
'may require copying substantial data into it.',
5510
def run(self, location=None, target_type=None, bind_to=None, force=False,
5513
directory = bzrdir.BzrDir.open(location)
6243
def run(self, location=None, bind_to=None, force=False,
6244
tree_type=None, repository_type=None, repository_trees=None,
6245
stacked_on=None, unstacked=None):
6246
directory = controldir.ControlDir.open(location)
5514
6247
if stacked_on and unstacked:
5515
raise BzrCommandError("Can't use both --stacked-on and --unstacked")
6248
raise errors.BzrCommandError(
6249
gettext("Can't use both --stacked-on and --unstacked"))
5516
6250
elif stacked_on is not None:
5517
6251
reconfigure.ReconfigureStackedOn().apply(directory, stacked_on)
5518
6252
elif unstacked:
5575
6320
takes_args = ['to_location?']
5576
takes_options = [Option('force',
5577
help='Switch even if local commits will be lost.'),
6321
takes_options = ['directory',
6323
help='Switch even if local commits will be lost.'),
5579
6325
Option('create-branch', short_name='b',
5580
help='Create the target branch from this one before'
5581
' switching to it.'),
6326
help='Create the target branch from this one before'
6327
' switching to it.'),
6329
help='Store and restore uncommitted changes in the'
5584
6333
def run(self, to_location=None, force=False, create_branch=False,
5586
from bzrlib import switch
6334
revision=None, directory=u'.', store=False):
6335
from . import switch
6336
tree_location = directory
5588
6337
revision = _get_one_revision('switch', revision)
5589
control_dir = bzrdir.BzrDir.open_containing(tree_location)[0]
6338
control_dir = controldir.ControlDir.open_containing(tree_location)[0]
6339
possible_transports = [control_dir.root_transport]
5590
6340
if to_location is None:
5591
6341
if revision is None:
5592
raise errors.BzrCommandError('You must supply either a'
5593
' revision or a location')
6342
raise errors.BzrCommandError(gettext('You must supply either a'
6343
' revision or a location'))
6344
to_location = tree_location
5596
branch = control_dir.open_branch()
6346
branch = control_dir.open_branch(
6347
possible_transports=possible_transports)
5597
6348
had_explicit_nick = branch.get_config().has_explicit_nickname()
5598
6349
except errors.NotBranchError:
5600
6351
had_explicit_nick = False
6353
possible_transports.append(branch.user_transport)
5601
6354
if create_branch:
5602
6355
if branch is None:
5603
raise errors.BzrCommandError('cannot create branch without'
5605
to_location = directory_service.directories.dereference(
5607
if '/' not in to_location and '\\' not in to_location:
5608
# This path is meant to be relative to the existing branch
5609
this_url = self._get_branch_location(control_dir)
5610
to_location = urlutils.join(this_url, '..', to_location)
5611
to_branch = branch.bzrdir.sprout(to_location,
5612
possible_transports=[branch.bzrdir.root_transport],
5613
source_branch=branch).open_branch()
6356
raise errors.BzrCommandError(
6357
gettext('cannot create branch without source branch'))
6358
to_location = lookup_new_sibling_branch(
6359
control_dir, to_location,
6360
possible_transports=possible_transports)
6361
if revision is not None:
6362
revision = revision.as_revision_id(branch)
6363
to_branch = branch.controldir.sprout(
6365
possible_transports=possible_transports,
6366
revision_id=revision,
6367
source_branch=branch).open_branch()
5616
to_branch = Branch.open(to_location)
5617
except errors.NotBranchError:
5618
this_url = self._get_branch_location(control_dir)
5619
6370
to_branch = Branch.open(
5620
urlutils.join(this_url, '..', to_location))
5621
if revision is not None:
5622
revision = revision.as_revision_id(to_branch)
5623
switch.switch(control_dir, to_branch, force, revision_id=revision)
6371
to_location, possible_transports=possible_transports)
6372
except errors.NotBranchError:
6373
to_branch = open_sibling_branch(
6374
control_dir, to_location,
6375
possible_transports=possible_transports)
6376
if revision is not None:
6377
revision = revision.as_revision_id(to_branch)
6378
possible_transports.append(to_branch.user_transport)
6380
switch.switch(control_dir, to_branch, force, revision_id=revision,
6381
store_uncommitted=store,
6382
possible_transports=possible_transports)
6383
except controldir.BranchReferenceLoop:
6384
raise errors.BzrCommandError(
6385
gettext('switching would create a branch reference loop. '
6386
'Use the "bzr up" command to switch to a '
6387
'different revision.'))
5624
6388
if had_explicit_nick:
5625
branch = control_dir.open_branch() #get the new branch!
6389
branch = control_dir.open_branch() # get the new branch!
5626
6390
branch.nick = to_branch.nick
5627
note('Switched to branch: %s',
5628
urlutils.unescape_for_display(to_branch.base, 'utf-8'))
5630
def _get_branch_location(self, control_dir):
5631
"""Return location of branch for this control dir."""
5633
this_branch = control_dir.open_branch()
5634
# This may be a heavy checkout, where we want the master branch
5635
master_location = this_branch.get_bound_location()
5636
if master_location is not None:
5637
return master_location
5638
# If not, use a local sibling
5639
return this_branch.base
5640
except errors.NotBranchError:
5641
format = control_dir.find_branch_format()
5642
if getattr(format, 'get_reference', None) is not None:
5643
return format.get_reference(control_dir)
6392
if to_branch.controldir.control_url != control_dir.control_url:
6393
note(gettext('Switched to branch %s at %s'),
6394
to_branch.name, urlutils.unescape_for_display(to_branch.base, 'utf-8'))
5645
return control_dir.root_transport.base
6396
note(gettext('Switched to branch %s'), to_branch.name)
6398
note(gettext('Switched to branch at %s'),
6399
urlutils.unescape_for_display(to_branch.base, 'utf-8'))
5648
6402
class cmd_view(Command):
5998
6786
takes_args = ['path?', 'location?']
6789
Option('force-unversioned',
6790
help='Set reference even if path is not versioned.'),
6000
def run(self, path=None, location=None):
6002
if path is not None:
6004
tree, branch, relpath =(
6005
bzrdir.BzrDir.open_containing_tree_or_branch(branchdir))
6006
if path is not None:
6793
def run(self, path=None, directory='.', location=None, force_unversioned=False):
6794
tree, branch, relpath = (
6795
controldir.ControlDir.open_containing_tree_or_branch(directory))
6008
6796
if tree is None:
6009
6797
tree = branch.basis_tree()
6010
6798
if path is None:
6011
info = branch._get_all_reference_info().iteritems()
6012
self._display_reference_info(tree, branch, info)
6799
with tree.lock_read():
6801
(path, tree.get_reference_info(path, branch))
6802
for path in tree.iter_references()]
6803
self._display_reference_info(tree, branch, info)
6014
file_id = tree.path2id(path)
6805
if not tree.is_versioned(path) and not force_unversioned:
6016
6806
raise errors.NotVersionedError(path)
6017
6807
if location is None:
6018
info = [(file_id, branch.get_reference_info(file_id))]
6808
info = [(path, tree.get_reference_info(path, branch))]
6019
6809
self._display_reference_info(tree, branch, info)
6021
branch.set_reference_info(file_id, path, location)
6811
tree.set_reference_info(path, location)
6023
6813
def _display_reference_info(self, tree, branch, info):
6025
for file_id, (path, location) in info:
6027
path = tree.id2path(file_id)
6028
except errors.NoSuchId:
6815
for path, location in info:
6030
6816
ref_list.append((path, location))
6031
6817
for path, location in sorted(ref_list):
6032
6818
self.outf.write('%s %s\n' % (path, location))
6821
class cmd_export_pot(Command):
6822
__doc__ = """Export command helps and error messages in po format."""
6825
takes_options = [Option('plugin',
6826
help='Export help text from named command '
6827
'(defaults to all built in commands).',
6829
Option('include-duplicates',
6830
help='Output multiple copies of the same msgid '
6831
'string if it appears more than once.'),
6834
def run(self, plugin=None, include_duplicates=False):
6835
from .export_pot import export_pot
6836
export_pot(self.outf, plugin, include_duplicates)
6839
class cmd_import(Command):
6840
__doc__ = """Import sources from a directory, tarball or zip file
6842
This command will import a directory, tarball or zip file into a bzr
6843
tree, replacing any versioned files already present. If a directory is
6844
specified, it is used as the target. If the directory does not exist, or
6845
is not versioned, it is created.
6847
Tarballs may be gzip or bzip2 compressed. This is autodetected.
6849
If the tarball or zip has a single root directory, that directory is
6850
stripped when extracting the tarball. This is not done for directories.
6853
takes_args = ['source', 'tree?']
6855
def run(self, source, tree=None):
6856
from .upstream_import import do_import
6857
do_import(source, tree)
6860
class cmd_link_tree(Command):
6861
__doc__ = """Hardlink matching files to another tree.
6863
Only files with identical content and execute bit will be linked.
6866
takes_args = ['location']
6868
def run(self, location):
6869
from .transform import link_tree
6870
target_tree = WorkingTree.open_containing(".")[0]
6871
source_tree = WorkingTree.open(location)
6872
with target_tree.lock_write(), source_tree.lock_read():
6873
link_tree(target_tree, source_tree)
6876
class cmd_fetch_ghosts(Command):
6877
__doc__ = """Attempt to retrieve ghosts from another branch.
6879
If the other branch is not supplied, the last-pulled branch is used.
6883
aliases = ['fetch-missing']
6884
takes_args = ['branch?']
6885
takes_options = [Option('no-fix', help="Skip additional synchonization.")]
6887
def run(self, branch=None, no_fix=False):
6888
from .fetch_ghosts import GhostFetcher
6889
installed, failed = GhostFetcher.from_cmdline(branch).run()
6890
if len(installed) > 0:
6891
self.outf.write("Installed:\n")
6892
for rev in installed:
6893
self.outf.write(rev.decode('utf-8') + "\n")
6895
self.outf.write("Still missing:\n")
6897
self.outf.write(rev.decode('utf-8') + "\n")
6898
if not no_fix and len(installed) > 0:
6899
cmd_reconcile().run(".")
6902
class cmd_grep(Command):
6903
"""Print lines matching PATTERN for specified files and revisions.
6905
This command searches the specified files and revisions for a given
6906
pattern. The pattern is specified as a Python regular expressions[1].
6908
If the file name is not specified, the revisions starting with the
6909
current directory are searched recursively. If the revision number is
6910
not specified, the working copy is searched. To search the last committed
6911
revision, use the '-r -1' or '-r last:1' option.
6913
Unversioned files are not searched unless explicitly specified on the
6914
command line. Unversioned directores are not searched.
6916
When searching a pattern, the output is shown in the 'filepath:string'
6917
format. If a revision is explicitly searched, the output is shown as
6918
'filepath~N:string', where N is the revision number.
6920
--include and --exclude options can be used to search only (or exclude
6921
from search) files with base name matches the specified Unix style GLOB
6922
pattern. The GLOB pattern an use *, ?, and [...] as wildcards, and \\
6923
to quote wildcard or backslash character literally. Note that the glob
6924
pattern is not a regular expression.
6926
[1] http://docs.python.org/library/re.html#regular-expression-syntax
6929
encoding_type = 'replace'
6930
takes_args = ['pattern', 'path*']
6934
Option('color', type=text_type, argname='when',
6935
help='Show match in color. WHEN is never, always or auto.'),
6936
Option('diff', short_name='p',
6937
help='Grep for pattern in changeset for each revision.'),
6938
ListOption('exclude', type=text_type, argname='glob', short_name='X',
6939
help="Skip files whose base name matches GLOB."),
6940
ListOption('include', type=text_type, argname='glob', short_name='I',
6941
help="Search only files whose base name matches GLOB."),
6942
Option('files-with-matches', short_name='l',
6943
help='Print only the name of each input file in '
6944
'which PATTERN is found.'),
6945
Option('files-without-match', short_name='L',
6946
help='Print only the name of each input file in '
6947
'which PATTERN is not found.'),
6948
Option('fixed-string', short_name='F',
6949
help='Interpret PATTERN is a single fixed string (not regex).'),
6951
help='Search for pattern starting from the root of the branch. '
6952
'(implies --recursive)'),
6953
Option('ignore-case', short_name='i',
6954
help='Ignore case distinctions while matching.'),
6956
help='Number of levels to display - 0 for all, 1 for collapsed '
6959
type=_parse_levels),
6960
Option('line-number', short_name='n',
6961
help='Show 1-based line number.'),
6962
Option('no-recursive',
6963
help="Don't recurse into subdirectories. (default is --recursive)"),
6964
Option('null', short_name='Z',
6965
help='Write an ASCII NUL (\\0) separator '
6966
'between output lines rather than a newline.'),
6970
def run(self, verbose=False, ignore_case=False, no_recursive=False,
6971
from_root=False, null=False, levels=None, line_number=False,
6972
path_list=None, revision=None, pattern=None, include=None,
6973
exclude=None, fixed_string=False, files_with_matches=False,
6974
files_without_match=False, color=None, diff=False):
6975
from breezy import _termcolor
6978
if path_list is None:
6982
raise errors.BzrCommandError(
6983
'cannot specify both --from-root and PATH.')
6985
if files_with_matches and files_without_match:
6986
raise errors.BzrCommandError(
6987
'cannot specify both '
6988
'-l/--files-with-matches and -L/--files-without-matches.')
6990
global_config = _mod_config.GlobalConfig()
6993
color = global_config.get_user_option('grep_color')
6998
if color not in ['always', 'never', 'auto']:
6999
raise errors.BzrCommandError('Valid values for --color are '
7000
'"always", "never" or "auto".')
7006
if revision is not None or levels == 0:
7007
# print revision numbers as we may be showing multiple revisions
7014
if not ignore_case and grep.is_fixed_string(pattern):
7015
# if the pattern isalnum, implicitly use to -F for faster grep
7017
elif ignore_case and fixed_string:
7018
# GZ 2010-06-02: Fall back to regexp rather than lowercasing
7019
# pattern and text which will cause pain later
7020
fixed_string = False
7021
pattern = re.escape(pattern)
7024
re_flags = re.MULTILINE
7026
re_flags |= re.IGNORECASE
7028
if not fixed_string:
7029
patternc = grep.compile_pattern(
7030
pattern.encode(grep._user_encoding), re_flags)
7032
if color == 'always':
7034
elif color == 'never':
7036
elif color == 'auto':
7037
show_color = _termcolor.allow_color()
7039
opts = grep.GrepOptions()
7041
opts.verbose = verbose
7042
opts.ignore_case = ignore_case
7043
opts.no_recursive = no_recursive
7044
opts.from_root = from_root
7046
opts.levels = levels
7047
opts.line_number = line_number
7048
opts.path_list = path_list
7049
opts.revision = revision
7050
opts.pattern = pattern
7051
opts.include = include
7052
opts.exclude = exclude
7053
opts.fixed_string = fixed_string
7054
opts.files_with_matches = files_with_matches
7055
opts.files_without_match = files_without_match
7059
opts.eol_marker = eol_marker
7060
opts.print_revno = print_revno
7061
opts.patternc = patternc
7062
opts.recursive = not no_recursive
7063
opts.fixed_string = fixed_string
7064
opts.outf = self.outf
7065
opts.show_color = show_color
7069
# files_with_matches, files_without_match
7070
# levels(?), line_number, from_root
7072
# These are silently ignored.
7073
grep.grep_diff(opts)
7074
elif revision is None:
7075
grep.workingtree_grep(opts)
7077
grep.versioned_grep(opts)
7080
class cmd_patch(Command):
7081
"""Apply a named patch to the current tree.
7085
takes_args = ['filename?']
7086
takes_options = [Option('strip', type=int, short_name='p',
7087
help=("Strip the smallest prefix containing num "
7088
"leading slashes from filenames.")),
7089
Option('silent', help='Suppress chatter.')]
7091
def run(self, filename=None, strip=None, silent=False):
7092
from .patch import patch_tree
7093
wt = WorkingTree.open_containing('.')[0]
7097
if filename is None:
7098
my_file = getattr(sys.stdin, 'buffer', sys.stdin)
7100
my_file = open(filename, 'rb')
7101
patches = [my_file.read()]
7102
return patch_tree(wt, patches, strip, quiet=is_quiet(), out=self.outf)
7105
class cmd_resolve_location(Command):
7106
__doc__ = """Expand a location to a full URL.
7109
Look up a Launchpad URL.
7111
brz resolve-location lp:brz
7113
takes_args = ['location']
7116
def run(self, location):
7117
from .location import location_to_url
7118
url = location_to_url(location)
7119
display_url = urlutils.unescape_for_display(url, self.outf.encoding)
7120
self.outf.write('%s\n' % display_url)
6035
7123
def _register_lazy_builtins():
6036
7124
# register lazy builtins from other modules; called at startup and should
6037
7125
# be only called once.
6038
7126
for (name, aliases, module_name) in [
6039
('cmd_bundle_info', [], 'bzrlib.bundle.commands'),
6040
('cmd_dpush', [], 'bzrlib.foreign'),
6041
('cmd_version_info', [], 'bzrlib.cmd_version_info'),
6042
('cmd_resolve', ['resolved'], 'bzrlib.conflicts'),
6043
('cmd_conflicts', [], 'bzrlib.conflicts'),
6044
('cmd_sign_my_commits', [], 'bzrlib.sign_my_commits'),
7127
('cmd_bisect', [], 'breezy.bisect'),
7128
('cmd_bundle_info', [], 'breezy.bzr.bundle.commands'),
7129
('cmd_config', [], 'breezy.config'),
7130
('cmd_dump_btree', [], 'breezy.bzr.debug_commands'),
7131
('cmd_file_id', [], 'breezy.bzr.debug_commands'),
7132
('cmd_file_path', [], 'breezy.bzr.debug_commands'),
7133
('cmd_version_info', [], 'breezy.cmd_version_info'),
7134
('cmd_resolve', ['resolved'], 'breezy.conflicts'),
7135
('cmd_conflicts', [], 'breezy.conflicts'),
7136
('cmd_ping', [], 'breezy.bzr.smart.ping'),
7137
('cmd_sign_my_commits', [], 'breezy.commit_signature_commands'),
7138
('cmd_verify_signatures', [], 'breezy.commit_signature_commands'),
7139
('cmd_test_script', [], 'breezy.cmd_test_script'),
6046
7141
builtin_command_registry.register_lazy(name, aliases, module_name)