14
14
# along with this program; if not, write to the Free Software
15
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17
"""builtin brz commands"""
19
from __future__ import absolute_import
17
"""builtin bzr commands"""
21
from bzrlib.lazy_import import lazy_import
22
lazy_import(globals(), """
32
from . import lazy_import
33
lazy_import.lazy_import(globals(), """
38
branch as _mod_branch,
44
config as _mod_config,
50
41
merge as _mod_merge,
51
mergeable as _mod_mergeable,
56
46
revision as _mod_revision,
65
from breezy.branch import Branch
66
from breezy.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
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
73
from .commands import (
63
from bzrlib.commands import (
75
65
builtin_command_registry,
68
from bzrlib.option import (
83
73
_parse_revision_str,
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("/")
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]))
234
88
def tree_files_for_add(file_list):
450
364
def run(self, revision_id=None, revision=None, directory=u'.'):
451
365
if revision_id is not None and revision is not None:
452
raise errors.BzrCommandError(gettext('You can only supply one of'
453
' revision_id or --revision'))
366
raise errors.BzrCommandError('You can only supply one of'
367
' revision_id or --revision')
454
368
if revision_id is None and revision is None:
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)
369
raise errors.BzrCommandError('You must supply either'
370
' --revision or a revision_id')
371
b = WorkingTree.open_containing(directory)[0].branch
373
revisions = b.repository.revisions
461
374
if revisions is None:
462
raise errors.BzrCommandError(
463
gettext('Repository %r does not support '
464
'access to raw revision texts') % b.repository)
375
raise errors.BzrCommandError('Repository %r does not support '
376
'access to raw revision texts')
466
with b.repository.lock_read():
378
b.repository.lock_read()
467
380
# TODO: jam 20060112 should cat-revision always output utf-8?
468
381
if revision_id is not None:
469
revision_id = cache_utf8.encode(revision_id)
382
revision_id = osutils.safe_revision_id(revision_id, warn=False)
471
384
self.print_revision(revisions, revision_id)
472
385
except errors.NoSuchRevision:
474
"The repository {0} contains no revision {1}.").format(
475
b.repository.base, revision_id.decode('utf-8'))
386
msg = "The repository %s contains no revision %s." % (
387
b.repository.base, revision_id)
476
388
raise errors.BzrCommandError(msg)
477
389
elif revision is not None:
478
390
for rev in revision:
480
392
raise errors.BzrCommandError(
481
gettext('You cannot specify a NULL revision.'))
393
'You cannot specify a NULL revision.')
482
394
rev_id = rev.as_revision_id(b)
483
395
self.print_revision(revisions, rev_id)
397
b.repository.unlock()
400
class cmd_dump_btree(Command):
401
__doc__ = """Dump the contents of a btree index file to stdout.
403
PATH is a btree index file, it can be any URL. This includes things like
404
.bzr/repository/pack-names, or .bzr/repository/indices/a34b3a...ca4a4.iix
406
By default, the tuples stored in the index file will be displayed. With
407
--raw, we will uncompress the pages, but otherwise display the raw bytes
411
# TODO: Do we want to dump the internal nodes as well?
412
# TODO: It would be nice to be able to dump the un-parsed information,
413
# rather than only going through iter_all_entries. However, this is
414
# good enough for a start
416
encoding_type = 'exact'
417
takes_args = ['path']
418
takes_options = [Option('raw', help='Write the uncompressed bytes out,'
419
' rather than the parsed tuples.'),
422
def run(self, path, raw=False):
423
dirname, basename = osutils.split(path)
424
t = transport.get_transport(dirname)
426
self._dump_raw_bytes(t, basename)
428
self._dump_entries(t, basename)
430
def _get_index_and_bytes(self, trans, basename):
431
"""Create a BTreeGraphIndex and raw bytes."""
432
bt = btree_index.BTreeGraphIndex(trans, basename, None)
433
bytes = trans.get_bytes(basename)
434
bt._file = cStringIO.StringIO(bytes)
435
bt._size = len(bytes)
438
def _dump_raw_bytes(self, trans, basename):
441
# We need to parse at least the root node.
442
# This is because the first page of every row starts with an
443
# uncompressed header.
444
bt, bytes = self._get_index_and_bytes(trans, basename)
445
for page_idx, page_start in enumerate(xrange(0, len(bytes),
446
btree_index._PAGE_SIZE)):
447
page_end = min(page_start + btree_index._PAGE_SIZE, len(bytes))
448
page_bytes = bytes[page_start:page_end]
450
self.outf.write('Root node:\n')
451
header_end, data = bt._parse_header_from_bytes(page_bytes)
452
self.outf.write(page_bytes[:header_end])
454
self.outf.write('\nPage %d\n' % (page_idx,))
455
decomp_bytes = zlib.decompress(page_bytes)
456
self.outf.write(decomp_bytes)
457
self.outf.write('\n')
459
def _dump_entries(self, trans, basename):
461
st = trans.stat(basename)
462
except errors.TransportNotPossible:
463
# We can't stat, so we'll fake it because we have to do the 'get()'
465
bt, _ = self._get_index_and_bytes(trans, basename)
467
bt = btree_index.BTreeGraphIndex(trans, basename, st.st_size)
468
for node in bt.iter_all_entries():
469
# Node is made up of:
470
# (index, key, value, [references])
474
refs_as_tuples = None
476
refs_as_tuples = static_tuple.as_tuples(refs)
477
as_tuple = (tuple(node[1]), node[2], refs_as_tuples)
478
self.outf.write('%s\n' % (as_tuple,))
486
481
class cmd_remove_tree(Command):
489
484
Since a lightweight checkout is little more than a working tree
490
485
this will refuse to run against one.
492
To re-create the working tree, use "brz checkout".
487
To re-create the working tree, use "bzr checkout".
494
489
_see_also = ['checkout', 'working-trees']
495
490
takes_args = ['location*']
496
491
takes_options = [
498
493
help='Remove the working tree even if it has '
499
'uncommitted or shelved changes.'),
494
'uncommitted changes.'),
502
497
def run(self, location_list, force=False):
503
498
if not location_list:
504
location_list = ['.']
506
501
for location in location_list:
507
d = controldir.ControlDir.open(location)
502
d = bzrdir.BzrDir.open(location)
510
505
working = d.open_workingtree()
511
506
except errors.NoWorkingTree:
512
raise errors.BzrCommandError(
513
gettext("No working tree to remove"))
507
raise errors.BzrCommandError("No working tree to remove")
514
508
except errors.NotLocalUrl:
515
raise errors.BzrCommandError(
516
gettext("You cannot remove the working tree"
517
" of a remote path"))
509
raise errors.BzrCommandError("You cannot remove the working tree"
519
512
if (working.has_changes()):
520
513
raise errors.UncommittedChanges(working)
521
if working.get_shelf_manager().last_shelf() is not None:
522
raise errors.ShelvedChanges(working)
524
515
if working.user_url != working.branch.user_url:
525
raise errors.BzrCommandError(
526
gettext("You cannot remove the working tree"
527
" from a lightweight checkout"))
516
raise errors.BzrCommandError("You cannot remove the working tree"
517
" from a lightweight checkout")
529
519
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))
586
522
class cmd_revno(Command):
587
523
__doc__ = """Show current revision number.
866
747
takes_options = [
869
Option('include-root',
870
help='Include the entry for the root of the tree, if any.'),
872
help='List entries of a particular kind: file, directory, '
751
help='List entries of a particular kind: file, directory, symlink.',
876
754
takes_args = ['file*']
879
def run(self, revision=None, show_ids=False, kind=None, include_root=False,
757
def run(self, revision=None, show_ids=False, kind=None, file_list=None):
881
758
if kind and kind not in ['file', 'directory', 'symlink']:
882
raise errors.BzrCommandError(
883
gettext('invalid kind %r specified') % (kind,))
759
raise errors.BzrCommandError('invalid kind %r specified' % (kind,))
885
761
revision = _get_one_revision('inventory', revision)
886
work_tree, file_list = WorkingTree.open_containing_paths(file_list)
887
self.enter_context(work_tree.lock_read())
762
work_tree, file_list = tree_files(file_list)
763
self.add_cleanup(work_tree.lock_read().unlock)
888
764
if revision is not None:
889
765
tree = revision.as_tree(work_tree.branch)
891
767
extra_trees = [work_tree]
892
self.enter_context(tree.lock_read())
768
self.add_cleanup(tree.lock_read().unlock)
897
self.enter_context(tree.lock_read())
898
773
if file_list is not None:
899
paths = tree.find_related_paths_across_trees(
900
file_list, extra_trees, require_versioned=True)
774
file_ids = tree.paths2ids(file_list, trees=extra_trees,
775
require_versioned=True)
901
776
# find_ids_across_trees may include some paths that don't
902
777
# exist in 'tree'.
903
entries = tree.iter_entries_by_dir(specific_files=paths)
778
entries = sorted((tree.id2path(file_id), tree.inventory[file_id])
779
for file_id in file_ids if file_id in tree)
905
entries = tree.iter_entries_by_dir()
781
entries = tree.inventory.entries()
907
for path, entry in sorted(entries):
784
for path, entry in entries:
908
785
if kind and kind != entry.kind:
910
if path == "" and not include_root:
913
self.outf.write('%-50s %s\n' % (
914
path, entry.file_id.decode('utf-8')))
788
self.outf.write('%-50s %s\n' % (path, entry.file_id))
916
790
self.outf.write(path)
917
791
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)
999
794
class cmd_mv(Command):
1000
795
__doc__ = """Move or rename a file.
1003
brz mv OLDNAME NEWNAME
798
bzr mv OLDNAME NEWNAME
1005
brz mv SOURCE... DESTINATION
800
bzr mv SOURCE... DESTINATION
1007
802
If the last argument is a versioned directory, all the other names
1008
803
are moved into it. Otherwise, there must be exactly two arguments
1299
1060
considered diverged if the destination branch's most recent commit is one
1300
1061
that has not been merged (directly or indirectly) by the source branch.
1302
If branches have diverged, you can use 'brz push --overwrite' to replace
1063
If branches have diverged, you can use 'bzr push --overwrite' to replace
1303
1064
the other branch completely, discarding its unmerged changes.
1305
1066
If you want to ensure you have the different changes in the other branch,
1306
do a merge (see brz help merge) from the other branch, and commit that.
1067
do a merge (see bzr help merge) from the other branch, and commit that.
1307
1068
After that you will be able to do a push without '--overwrite'.
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>.
1070
If there is no default push location set, the first push will set it.
1071
After that, you can omit the location to use the default. To change the
1072
default, use --remember. The value will only be saved if the remote
1073
location can be accessed.
1319
1076
_see_also = ['pull', 'update', 'working-trees']
1320
1077
takes_options = ['remember', 'overwrite', 'verbose', 'revision',
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.")
1078
Option('create-prefix',
1079
help='Create the path leading up to the branch '
1080
'if it does not already exist.'),
1081
custom_help('directory',
1082
help='Branch to push from, '
1083
'rather than the one containing the working directory.'),
1084
Option('use-existing-dir',
1085
help='By default push will fail if the target'
1086
' directory exists, but does not already'
1087
' have a control directory. This flag will'
1088
' allow push to proceed.'),
1090
help='Create a stacked branch that references the public location '
1091
'of the parent branch.'),
1092
Option('stacked-on',
1093
help='Create a stacked branch that refers to another branch '
1094
'for the commit history. Only the work not present in the '
1095
'referenced branch is included in the branch created.',
1098
help='Refuse to push if there are uncommitted changes in'
1099
' the working tree, --no-strict disables the check.'),
1351
1101
takes_args = ['location?']
1352
1102
encoding_type = 'replace'
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"]
1104
def run(self, location=None, remember=False, overwrite=False,
1105
create_prefix=False, verbose=False, revision=None,
1106
use_existing_dir=False, directory=None, stacked_on=None,
1107
stacked=False, strict=None):
1108
from bzrlib.push import _show_push_branch
1369
1110
if directory is None:
1370
1111
directory = '.'
1371
1112
# Get the source branch
1372
1113
(tree, br_from,
1373
_unused) = controldir.ControlDir.open_containing_tree_or_branch(directory)
1114
_unused) = bzrdir.BzrDir.open_containing_tree_or_branch(directory)
1374
1115
# Get the tip's revision_id
1375
1116
revision = _get_one_revision('push', revision)
1376
1117
if revision is not None:
1442
1173
parameter, as in "branch foo/bar -r 5".
1446
1176
_see_also = ['checkout']
1447
1177
takes_args = ['from_location', 'to_location?']
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.'),
1473
Option('colocated-branch', short_name='b',
1474
type=str, help='Name of colocated branch to sprout.'),
1178
takes_options = ['revision', Option('hardlink',
1179
help='Hard-link working tree files where possible.'),
1181
help="Create a branch without a working-tree."),
1183
help="Switch the checkout in the current directory "
1184
"to the new branch."),
1186
help='Create a stacked branch referring to the source branch. '
1187
'The new branch will depend on the availability of the source '
1188
'branch for all operations.'),
1189
Option('standalone',
1190
help='Do not use a shared repository, even if available.'),
1191
Option('use-existing-dir',
1192
help='By default branch will fail if the target'
1193
' directory exists, but does not already'
1194
' have a control directory. This flag will'
1195
' allow branch to proceed.'),
1197
help="Bind new branch to from location."),
1199
aliases = ['get', 'clone']
1477
1201
def run(self, from_location, to_location=None, revision=None,
1478
1202
hardlink=False, stacked=False, standalone=False, no_tree=False,
1479
use_existing_dir=False, switch=False, bind=False,
1480
files_from=None, no_recurse_nested=False, colocated_branch=None):
1481
from breezy import switch as _mod_switch
1482
accelerator_tree, br_from = controldir.ControlDir.open_tree_or_branch(
1483
from_location, name=colocated_branch)
1484
if no_recurse_nested:
1488
if not (hardlink or files_from):
1489
# accelerator_tree is usually slower because you have to read N
1490
# files (no readahead, lots of seeks, etc), but allow the user to
1491
# explicitly request it
1492
accelerator_tree = None
1493
if files_from is not None and files_from != from_location:
1494
accelerator_tree = WorkingTree.open(files_from)
1203
use_existing_dir=False, switch=False, bind=False):
1204
from bzrlib import switch as _mod_switch
1205
from bzrlib.tag import _merge_tags_if_possible
1206
accelerator_tree, br_from = bzrdir.BzrDir.open_tree_or_branch(
1495
1208
revision = _get_one_revision('branch', revision)
1496
self.enter_context(br_from.lock_read())
1209
self.add_cleanup(br_from.lock_read().unlock)
1497
1210
if revision is not None:
1498
1211
revision_id = revision.as_revision_id(br_from)
1503
1216
revision_id = br_from.last_revision()
1504
1217
if to_location is None:
1505
1218
to_location = urlutils.derive_to_location(from_location)
1506
to_transport = transport.get_transport(to_location, purpose='write')
1219
to_transport = transport.get_transport(to_location)
1508
1221
to_transport.mkdir('.')
1509
1222
except errors.FileExists:
1511
to_dir = controldir.ControlDir.open_from_transport(
1513
except errors.NotBranchError:
1514
if not use_existing_dir:
1515
raise errors.BzrCommandError(gettext('Target directory "%s" '
1516
'already exists.') % to_location)
1223
if not use_existing_dir:
1224
raise errors.BzrCommandError('Target directory "%s" '
1225
'already exists.' % to_location)
1521
to_dir.open_branch()
1228
bzrdir.BzrDir.open_from_transport(to_transport)
1522
1229
except errors.NotBranchError:
1525
1232
raise errors.AlreadyBranchError(to_location)
1526
1233
except errors.NoSuchFile:
1527
raise errors.BzrCommandError(gettext('Parent of "%s" does not exist.')
1234
raise errors.BzrCommandError('Parent of "%s" does not exist.'
1533
# preserve whatever source format we have.
1534
to_dir = br_from.controldir.sprout(
1535
to_transport.base, revision_id,
1536
possible_transports=[to_transport],
1537
accelerator_tree=accelerator_tree, hardlink=hardlink,
1538
stacked=stacked, force_new_repo=standalone,
1539
create_tree_if_local=not no_tree, source_branch=br_from,
1541
branch = to_dir.open_branch(
1542
possible_transports=[
1543
br_from.controldir.root_transport, to_transport])
1544
except errors.NoSuchRevision:
1545
to_transport.delete_tree('.')
1546
msg = gettext("The branch {0} has no revision {1}.").format(
1547
from_location, revision)
1548
raise errors.BzrCommandError(msg)
1551
to_repo = to_dir.open_repository()
1552
except errors.NoRepositoryPresent:
1553
to_repo = to_dir.create_repository()
1554
to_repo.fetch(br_from.repository, revision_id=revision_id)
1555
branch = br_from.sprout(
1556
to_dir, revision_id=revision_id)
1557
br_from.tags.merge_to(branch.tags)
1237
# preserve whatever source format we have.
1238
dir = br_from.bzrdir.sprout(to_transport.base, revision_id,
1239
possible_transports=[to_transport],
1240
accelerator_tree=accelerator_tree,
1241
hardlink=hardlink, stacked=stacked,
1242
force_new_repo=standalone,
1243
create_tree_if_local=not no_tree,
1244
source_branch=br_from)
1245
branch = dir.open_branch()
1246
except errors.NoSuchRevision:
1247
to_transport.delete_tree('.')
1248
msg = "The branch %s has no revision %s." % (from_location,
1250
raise errors.BzrCommandError(msg)
1251
_merge_tags_if_possible(br_from, branch)
1559
1252
# If the source branch is stacked, the new branch may
1560
1253
# be stacked whether we asked for that explicitly or not.
1561
1254
# We therefore need a try/except here and not just 'if stacked:'
1563
note(gettext('Created new stacked branch referring to %s.') %
1564
branch.get_stacked_on_url())
1565
except (errors.NotStacked, _mod_branch.UnstackableBranchFormat,
1566
errors.UnstackableRepositoryFormat) as e:
1567
revno = branch.revno()
1568
if revno is not None:
1569
note(ngettext('Branched %d revision.',
1570
'Branched %d revisions.',
1571
branch.revno()) % revno)
1573
note(gettext('Created new branch.'))
1256
note('Created new stacked branch referring to %s.' %
1257
branch.get_stacked_on_url())
1258
except (errors.NotStacked, errors.UnstackableBranchFormat,
1259
errors.UnstackableRepositoryFormat), e:
1260
note('Branched %d revision(s).' % branch.revno())
1575
1262
# Bind to the parent
1576
1263
parent_branch = Branch.open(from_location)
1577
1264
branch.bind(parent_branch)
1578
note(gettext('New branch bound to %s') % from_location)
1265
note('New branch bound to %s' % from_location)
1580
1267
# Switch to the new branch
1581
1268
wt, _ = WorkingTree.open_containing('.')
1582
_mod_switch.switch(wt.controldir, branch)
1583
note(gettext('Switched to branch: %s'),
1584
urlutils.unescape_for_display(branch.base, 'utf-8'))
1587
class cmd_branches(Command):
1588
__doc__ = """List the branches available at the current location.
1590
This command will print the names of all the branches at the current
1594
takes_args = ['location?']
1596
Option('recursive', short_name='R',
1597
help='Recursively scan for branches rather than '
1598
'just looking in the specified location.')]
1600
def run(self, location=".", recursive=False):
1602
t = transport.get_transport(location, purpose='read')
1603
if not t.listable():
1604
raise errors.BzrCommandError(
1605
"Can't scan this type of location.")
1606
for b in controldir.ControlDir.find_branches(t):
1607
self.outf.write("%s\n" % urlutils.unescape_for_display(
1608
urlutils.relative_url(t.base, b.base),
1609
self.outf.encoding).rstrip("/"))
1611
dir = controldir.ControlDir.open_containing(location)[0]
1613
active_branch = dir.open_branch(name="")
1614
except errors.NotBranchError:
1615
active_branch = None
1617
for name, branch in iter_sibling_branches(dir):
1620
active = (active_branch is not None and
1621
active_branch.user_url == branch.user_url)
1622
names[name] = active
1623
# Only mention the current branch explicitly if it's not
1624
# one of the colocated branches
1625
if not any(viewvalues(names)) and active_branch is not None:
1626
self.outf.write("* %s\n" % gettext("(default)"))
1627
for name in sorted(names):
1628
active = names[name]
1633
self.outf.write("%s %s\n" % (
1634
prefix, (name if PY3 else name.encode(self.outf.encoding))))
1269
_mod_switch.switch(wt.bzrdir, branch)
1270
note('Switched to branch: %s',
1271
urlutils.unescape_for_display(branch.base, 'utf-8'))
1637
1274
class cmd_checkout(Command):
1638
1275
__doc__ = """Create a new checkout of an existing branch.
1640
If BRANCH_LOCATION is omitted, checkout will reconstitute a working tree
1641
for the branch found in '.'. This is useful if you have removed the working
1642
tree or if it was never created - i.e. if you pushed the branch to its
1643
current location using SFTP.
1277
If BRANCH_LOCATION is omitted, checkout will reconstitute a working tree for
1278
the branch found in '.'. This is useful if you have removed the working tree
1279
or if it was never created - i.e. if you pushed the branch to its current
1280
location using SFTP.
1645
If the TO_LOCATION is omitted, the last component of the BRANCH_LOCATION
1646
will be used. In other words, "checkout ../foo/bar" will attempt to create
1647
./bar. If the BRANCH_LOCATION has no / or path separator embedded, the
1648
TO_LOCATION is derived from the BRANCH_LOCATION by stripping a leading
1649
scheme or drive identifier, if any. For example, "checkout lp:foo-bar" will
1650
attempt to create ./foo-bar.
1282
If the TO_LOCATION is omitted, the last component of the BRANCH_LOCATION will
1283
be used. In other words, "checkout ../foo/bar" will attempt to create ./bar.
1284
If the BRANCH_LOCATION has no / or path separator embedded, the TO_LOCATION
1285
is derived from the BRANCH_LOCATION by stripping a leading scheme or drive
1286
identifier, if any. For example, "checkout lp:foo-bar" will attempt to
1652
1289
To retrieve the branch as of a particular revision, supply the --revision
1653
parameter, as in "checkout foo/bar -r 5". Note that this will be
1654
immediately out of date [so you cannot commit] but it may be useful (i.e.
1655
to examine old code.)
1290
parameter, as in "checkout foo/bar -r 5". Note that this will be immediately
1291
out of date [so you cannot commit] but it may be useful (i.e. to examine old
1658
_see_also = ['checkouts', 'branch', 'working-trees', 'remove-tree']
1295
_see_also = ['checkouts', 'branch']
1659
1296
takes_args = ['branch_location?', 'to_location?']
1660
1297
takes_options = ['revision',
1661
1298
Option('lightweight',
1751
1352
@display_command
1752
1353
def run(self, dir=u'.'):
1753
1354
tree = WorkingTree.open_containing(dir)[0]
1754
self.enter_context(tree.lock_read())
1355
self.add_cleanup(tree.lock_read().unlock)
1356
new_inv = tree.inventory
1755
1357
old_tree = tree.basis_tree()
1756
self.enter_context(old_tree.lock_read())
1358
self.add_cleanup(old_tree.lock_read().unlock)
1359
old_inv = old_tree.inventory
1758
1361
iterator = tree.iter_changes(old_tree, include_unchanged=True)
1759
for change in iterator:
1760
if change.path[0] == change.path[1]:
1762
if None in change.path:
1764
renames.append(change.path)
1362
for f, paths, c, v, p, n, k, e in iterator:
1363
if paths[0] == paths[1]:
1367
renames.append(paths)
1766
1369
for old_name, new_name in renames:
1767
1370
self.outf.write("%s => %s\n" % (old_name, new_name))
1770
1373
class cmd_update(Command):
1771
__doc__ = """Update a working tree to a new revision.
1773
This will perform a merge of the destination revision (the tip of the
1774
branch, or the specified revision) into the working tree, and then make
1775
that revision the basis revision for the working tree.
1777
You can use this to visit an older revision, or to update a working tree
1778
that is out of date from its branch.
1780
If there are any uncommitted changes in the tree, they will be carried
1781
across and remain as uncommitted changes after the update. To discard
1782
these changes, use 'brz revert'. The uncommitted changes may conflict
1783
with the changes brought in by the change in basis revision.
1785
If the tree's branch is bound to a master branch, brz will also update
1374
__doc__ = """Update a tree to have the latest code committed to its branch.
1376
This will perform a merge into the working tree, and may generate
1377
conflicts. If you have any local changes, you will still
1378
need to commit them after the update for the update to be complete.
1380
If you want to discard your local changes, you can just do a
1381
'bzr revert' instead of 'bzr commit' after the update.
1383
If the tree's branch is bound to a master branch, it will also update
1786
1384
the branch from the master.
1788
You cannot update just a single file or directory, because each Breezy
1789
working tree has just a single basis revision. If you want to restore a
1790
file that has been removed locally, use 'brz revert' instead of 'brz
1791
update'. If you want to restore a file to its state in a previous
1792
revision, use 'brz revert' with a '-r' option, or use 'brz cat' to write
1793
out the old content of that file to a new location.
1795
The 'dir' argument, if given, must be the location of the root of a
1796
working tree to update. By default, the working tree that contains the
1797
current working directory is used.
1800
1387
_see_also = ['pull', 'working-trees', 'status-flags']
1801
1388
takes_args = ['dir?']
1802
takes_options = ['revision',
1804
help="Show base revision text in conflicts."),
1389
takes_options = ['revision']
1806
1390
aliases = ['up']
1808
def run(self, dir=None, revision=None, show_base=None):
1392
def run(self, dir='.', revision=None):
1809
1393
if revision is not None and len(revision) != 1:
1810
raise errors.BzrCommandError(gettext(
1811
"brz update --revision takes exactly one revision"))
1813
tree = WorkingTree.open_containing('.')[0]
1815
tree, relpath = WorkingTree.open_containing(dir)
1818
raise errors.BzrCommandError(gettext(
1819
"brz update can only update a whole tree, "
1820
"not a file or subdirectory"))
1394
raise errors.BzrCommandError(
1395
"bzr update --revision takes exactly one revision")
1396
tree = WorkingTree.open_containing(dir)[0]
1821
1397
branch = tree.branch
1822
1398
possible_transports = []
1823
1399
master = branch.get_master_branch(
1824
1400
possible_transports=possible_transports)
1825
1401
if master is not None:
1826
1402
branch_location = master.base
1827
self.enter_context(tree.lock_write())
1829
1405
branch_location = tree.branch.base
1830
self.enter_context(tree.lock_tree_write())
1406
tree.lock_tree_write()
1407
self.add_cleanup(tree.unlock)
1831
1408
# get rid of the final '/' and be ready for display
1832
1409
branch_location = urlutils.unescape_for_display(
1833
1410
branch_location.rstrip('/'),
1919
1495
noise_level = get_verbosity_level()
1921
1497
noise_level = 0
1922
from .info import show_bzrdir_info
1923
show_bzrdir_info(controldir.ControlDir.open_containing(location)[0],
1498
from bzrlib.info import show_bzrdir_info
1499
show_bzrdir_info(bzrdir.BzrDir.open_containing(location)[0],
1924
1500
verbose=noise_level, outfile=self.outf)
1927
1503
class cmd_remove(Command):
1928
1504
__doc__ = """Remove files or directories.
1930
This makes Breezy stop tracking changes to the specified files. Breezy will
1931
delete them if they can easily be recovered using revert otherwise they
1932
will be backed up (adding an extension of the form .~#~). If no options or
1933
parameters are given Breezy will scan for files that are being tracked by
1934
Breezy but missing in your tree and stop tracking them for you.
1506
This makes bzr stop tracking changes to the specified files. bzr will delete
1507
them if they can easily be recovered using revert. If no options or
1508
parameters are given bzr will scan for files that are being tracked by bzr
1509
but missing in your tree and stop tracking them for you.
1936
1511
takes_args = ['file*']
1937
1512
takes_options = ['verbose',
1939
'new', help='Only remove files that have never been committed.'),
1940
RegistryOption.from_kwargs('file-deletion-strategy',
1941
'The file deletion mode to be used.',
1942
title='Deletion Strategy', value_switches=True, enum_switch=False,
1943
safe='Backup changed files (default).',
1944
keep='Delete from brz but leave the working copy.',
1945
no_backup='Don\'t backup changed files.'),
1513
Option('new', help='Only remove files that have never been committed.'),
1514
RegistryOption.from_kwargs('file-deletion-strategy',
1515
'The file deletion mode to be used.',
1516
title='Deletion Strategy', value_switches=True, enum_switch=False,
1517
safe='Only delete files if they can be'
1518
' safely recovered (default).',
1519
keep='Delete from bzr but leave the working copy.',
1520
force='Delete all the specified files, even if they can not be '
1521
'recovered and even if they are non-empty directories.')]
1947
1522
aliases = ['rm', 'del']
1948
1523
encoding_type = 'replace'
1950
1525
def run(self, file_list, verbose=False, new=False,
1951
file_deletion_strategy='safe'):
1953
tree, file_list = WorkingTree.open_containing_paths(file_list)
1526
file_deletion_strategy='safe'):
1527
tree, file_list = tree_files(file_list)
1955
1529
if file_list is not None:
1956
1530
file_list = [f for f in file_list]
1958
self.enter_context(tree.lock_write())
1532
self.add_cleanup(tree.lock_write().unlock)
1959
1533
# Heuristics should probably all move into tree.remove_smart or
1962
1536
added = tree.changes_from(tree.basis_tree(),
1963
specific_files=file_list).added
1964
file_list = sorted([f.path[1] for f in added], reverse=True)
1537
specific_files=file_list).added
1538
file_list = sorted([f[0] for f in added], reverse=True)
1965
1539
if len(file_list) == 0:
1966
raise errors.BzrCommandError(gettext('No matching files.'))
1540
raise errors.BzrCommandError('No matching files.')
1967
1541
elif file_list is None:
1968
1542
# missing files show up in iter_changes(basis) as
1969
1543
# versioned-with-no-kind.
1971
1545
for change in tree.iter_changes(tree.basis_tree()):
1972
1546
# Find paths in the working tree that have no kind:
1973
if change.path[1] is not None and change.kind[1] is None:
1974
missing.append(change.path[1])
1547
if change[1][1] is not None and change[6][1] is None:
1548
missing.append(change[1][1])
1975
1549
file_list = sorted(missing, reverse=True)
1976
1550
file_deletion_strategy = 'keep'
1977
1551
tree.remove(file_list, verbose=verbose, to_file=self.outf,
1978
keep_files=file_deletion_strategy == 'keep',
1979
force=(file_deletion_strategy == 'no-backup'))
1552
keep_files=file_deletion_strategy=='keep',
1553
force=file_deletion_strategy=='force')
1556
class cmd_file_id(Command):
1557
__doc__ = """Print file_id of a particular file or directory.
1559
The file_id is assigned when the file is first added and remains the
1560
same through all revisions where the file exists, even when it is
1565
_see_also = ['inventory', 'ls']
1566
takes_args = ['filename']
1569
def run(self, filename):
1570
tree, relpath = WorkingTree.open_containing(filename)
1571
i = tree.path2id(relpath)
1573
raise errors.NotVersionedError(filename)
1575
self.outf.write(i + '\n')
1578
class cmd_file_path(Command):
1579
__doc__ = """Print path of file_ids to a file or directory.
1581
This prints one line for each directory down to the target,
1582
starting at the branch root.
1586
takes_args = ['filename']
1589
def run(self, filename):
1590
tree, relpath = WorkingTree.open_containing(filename)
1591
fid = tree.path2id(relpath)
1593
raise errors.NotVersionedError(filename)
1594
segments = osutils.splitpath(relpath)
1595
for pos in range(1, len(segments) + 1):
1596
path = osutils.joinpath(segments[:pos])
1597
self.outf.write("%s\n" % tree.path2id(path))
1982
1600
class cmd_reconcile(Command):
1983
__doc__ = """Reconcile brz metadata in a branch.
1601
__doc__ = """Reconcile bzr metadata in a branch.
1985
1603
This can correct data mismatches that may have been caused by
1986
previous ghost operations or brz upgrades. You should only
1987
need to run this command if 'brz check' or a brz developer
1604
previous ghost operations or bzr upgrades. You should only
1605
need to run this command if 'bzr check' or a bzr developer
1988
1606
advises you to run it.
1990
1608
If a second branch is provided, cross-branch reconciliation is
1991
1609
also attempted, which will check that data like the tree root
1992
id which was not present in very early brz versions is represented
1610
id which was not present in very early bzr versions is represented
1993
1611
correctly in both branches.
1995
1613
At the same time it is run it may recompress data resulting in
2125
1725
to_transport.ensure_base()
2126
1726
except errors.NoSuchFile:
2127
1727
if not create_prefix:
2128
raise errors.BzrCommandError(gettext("Parent directory of %s"
2130
"\nYou may supply --create-prefix to create all"
2131
" leading parent directories.")
1728
raise errors.BzrCommandError("Parent directory of %s"
1730
"\nYou may supply --create-prefix to create all"
1731
" leading parent directories."
2133
1733
to_transport.create_prefix()
2136
a_controldir = controldir.ControlDir.open_from_transport(
1736
a_bzrdir = bzrdir.BzrDir.open_from_transport(to_transport)
2138
1737
except errors.NotBranchError:
2139
1738
# really a NotBzrDir error...
2140
create_branch = controldir.ControlDir.create_branch_convenience
2142
force_new_tree = False
2144
force_new_tree = None
1739
create_branch = bzrdir.BzrDir.create_branch_convenience
2145
1740
branch = create_branch(to_transport.base, format=format,
2146
possible_transports=[to_transport],
2147
force_new_tree=force_new_tree)
2148
a_controldir = branch.controldir
1741
possible_transports=[to_transport])
1742
a_bzrdir = branch.bzrdir
2150
from .transport.local import LocalTransport
2151
if a_controldir.has_branch():
1744
from bzrlib.transport.local import LocalTransport
1745
if a_bzrdir.has_branch():
2152
1746
if (isinstance(to_transport, LocalTransport)
2153
and not a_controldir.has_workingtree()):
2154
raise errors.BranchExistsWithoutWorkingTree(location)
1747
and not a_bzrdir.has_workingtree()):
1748
raise errors.BranchExistsWithoutWorkingTree(location)
2155
1749
raise errors.AlreadyBranchError(location)
2156
branch = a_controldir.create_branch()
2157
if not no_tree and not a_controldir.has_workingtree():
2158
a_controldir.create_workingtree()
1750
branch = a_bzrdir.create_branch()
1751
a_bzrdir.create_workingtree()
2159
1752
if append_revisions_only:
2161
1754
branch.set_append_revisions_only(True)
2162
1755
except errors.UpgradeRequired:
2163
raise errors.BzrCommandError(gettext('This branch format cannot be set'
2164
' to append-revisions-only. Try --default.'))
1756
raise errors.BzrCommandError('This branch format cannot be set'
1757
' to append-revisions-only. Try --default.')
2165
1758
if not is_quiet():
2166
from .info import describe_layout, describe_format
1759
from bzrlib.info import describe_layout, describe_format
2168
tree = a_controldir.open_workingtree(recommend_upgrade=False)
1761
tree = a_bzrdir.open_workingtree(recommend_upgrade=False)
2169
1762
except (errors.NoWorkingTree, errors.NotLocalUrl):
2171
1764
repository = branch.repository
2172
1765
layout = describe_layout(repository, branch, tree).lower()
2173
format = describe_format(a_controldir, repository, branch, tree)
2174
self.outf.write(gettext("Created a {0} (format: {1})\n").format(
1766
format = describe_format(a_bzrdir, repository, branch, tree)
1767
self.outf.write("Created a %s (format: %s)\n" % (layout, format))
2176
1768
if repository.is_shared():
2177
# XXX: maybe this can be refactored into transport.path_or_url()
2178
url = repository.controldir.root_transport.external_url()
1769
#XXX: maybe this can be refactored into transport.path_or_url()
1770
url = repository.bzrdir.root_transport.external_url()
2180
1772
url = urlutils.local_path_from_url(url)
2181
except urlutils.InvalidURL:
1773
except errors.InvalidURL:
2183
self.outf.write(gettext("Using shared repository: %s\n") % url)
2186
class cmd_init_shared_repository(Command):
1775
self.outf.write("Using shared repository: %s\n" % url)
1778
class cmd_init_repository(Command):
2187
1779
__doc__ = """Create a shared repository for branches to share storage space.
2189
1781
New branches created under the repository directory will store their
2190
1782
revisions in the repository, not in the branch directory. For branches
2191
with shared history, this reduces the amount of storage needed and
1783
with shared history, this reduces the amount of storage needed and
2192
1784
speeds up the creation of new branches.
2194
1786
If the --no-trees option is given then the branches in the repository
2195
will not have working trees by default. They will still exist as
2196
directories on disk, but they will not have separate copies of the
1787
will not have working trees by default. They will still exist as
1788
directories on disk, but they will not have separate copies of the
2197
1789
files at a certain revision. This can be useful for repositories that
2198
1790
store branches which are interacted with through checkouts or remote
2199
1791
branches, such as on a server.
2282
1858
Shows the difference in the working tree versus the last commit::
2286
1862
Difference between the working tree and revision 1::
2290
1866
Difference between revision 3 and revision 1::
2294
1870
Difference between revision 3 and revision 1 for branch xxx::
2298
The changes introduced by revision 2 (equivalent to -r1..2)::
2302
To see the changes introduced by revision X::
1874
To see the changes introduced in revision X::
2306
1878
Note that in the case of a merge, the -c option shows the changes
2307
1879
compared to the left hand parent. To see the changes against
2308
1880
another parent, use::
2310
brz diff -r<chosen_parent>..X
2312
The changes between the current revision and the previous revision
2313
(equivalent to -c-1 and -r-2..-1)
1882
bzr diff -r<chosen_parent>..X
1884
The changes introduced by revision 2 (equivalent to -r1..2)::
2317
1888
Show just the differences for file NEWS::
2321
1892
Show the differences in working tree xxx for file NEWS::
2325
1896
Show the differences from branch xxx to this working tree:
2329
1900
Show the differences between two branches for file NEWS::
2331
brz diff --old xxx --new yyy NEWS
2333
Same as 'brz diff' but prefix paths with old/ and new/::
2335
brz diff --prefix old/:new/
2337
Show the differences using a custom diff program with options::
2339
brz diff --using /usr/bin/diff --diff-options -wu
1902
bzr diff --old xxx --new yyy NEWS
1904
Same as 'bzr diff' but prefix paths with old/ and new/::
1906
bzr diff --prefix old/:new/
2341
1908
_see_also = ['status']
2342
1909
takes_args = ['file*']
2343
1910
takes_options = [
2344
Option('diff-options', type=text_type,
1911
Option('diff-options', type=str,
2345
1912
help='Pass these options to the external diff program.'),
2346
Option('prefix', type=text_type,
1913
Option('prefix', type=str,
2347
1914
short_name='p',
2348
1915
help='Set prefixes added to old and new filenames, as '
2349
1916
'two values separated by a colon. (eg "old/:new/").'),
2351
help='Branch/tree to compare from.',
1918
help='Branch/tree to compare from.',
2355
help='Branch/tree to compare to.',
1922
help='Branch/tree to compare to.',
2360
1927
Option('using',
2361
help='Use this command to compare files.',
1928
help='Use this command to compare files.',
2364
1931
RegistryOption('format',
2366
help='Diff format to use.',
2367
lazy_registry=('breezy.diff', 'format_registry'),
2368
title='Diff format'),
2370
help='How many lines of context to show.',
2373
RegistryOption.from_kwargs(
2375
help='Color mode to use.',
2376
title='Color Mode', value_switches=False, enum_switch=True,
2377
never='Never colorize output.',
2378
auto='Only colorize output if terminal supports it and STDOUT is a'
2380
always='Always colorize output (default).'),
2383
help=('Warn if trailing whitespace or spurious changes have been'
1932
help='Diff format to use.',
1933
lazy_registry=('bzrlib.diff', 'format_registry'),
1934
value_switches=False, title='Diff format'),
2387
1936
aliases = ['di', 'dif']
2388
1937
encoding_type = 'exact'
2390
1939
@display_command
2391
1940
def run(self, revision=None, file_list=None, diff_options=None,
2392
prefix=None, old=None, new=None, using=None, format=None,
2393
context=None, color='never'):
2394
from .diff import (get_trees_and_branches_to_diff_locked,
1941
prefix=None, old=None, new=None, using=None, format=None):
1942
from bzrlib.diff import (get_trees_and_branches_to_diff_locked,
1945
if (prefix is None) or (prefix == '0'):
2398
1946
# diff -p0 format
2401
elif prefix == u'1' or prefix is None:
2402
1950
old_label = 'old/'
2403
1951
new_label = 'new/'
2404
elif u':' in prefix:
2405
old_label, new_label = prefix.split(u":")
1953
old_label, new_label = prefix.split(":")
2407
raise errors.BzrCommandError(gettext(
1955
raise errors.BzrCommandError(
2408
1956
'--prefix expects two values separated by a colon'
2409
' (eg "old/:new/")'))
1957
' (eg "old/:new/")')
2411
1959
if revision and len(revision) > 2:
2412
raise errors.BzrCommandError(gettext('brz diff --revision takes exactly'
2413
' one or two revision specifiers'))
1960
raise errors.BzrCommandError('bzr diff --revision takes exactly'
1961
' one or two revision specifiers')
2415
1963
if using is not None and format is not None:
2416
raise errors.BzrCommandError(gettext(
2417
'{0} and {1} are mutually exclusive').format(
2418
'--using', '--format'))
1964
raise errors.BzrCommandError('--using and --format are mutually '
2420
1967
(old_tree, new_tree,
2421
1968
old_branch, new_branch,
2422
1969
specific_files, extra_trees) = get_trees_and_branches_to_diff_locked(
2423
file_list, revision, old, new, self._exit_stack, apply_view=True)
2424
# GNU diff on Windows uses ANSI encoding for filenames
2425
path_encoding = osutils.get_diff_header_encoding()
2428
from .terminal import has_ansi_colors
2429
if has_ansi_colors():
2433
if 'always' == color:
2434
from .colordiff import DiffWriter
2435
outf = DiffWriter(outf)
2436
return show_diff_trees(old_tree, new_tree, outf,
1970
file_list, revision, old, new, self.add_cleanup, apply_view=True)
1971
return show_diff_trees(old_tree, new_tree, sys.stdout,
2437
1972
specific_files=specific_files,
2438
1973
external_diff_options=diff_options,
2439
1974
old_label=old_label, new_label=new_label,
2440
extra_trees=extra_trees,
2441
path_encoding=path_encoding,
2442
using=using, context=context,
1975
extra_trees=extra_trees, using=using,
2443
1976
format_cls=format)
2707
2237
takes_args = ['file*']
2708
2238
_see_also = ['log-formats', 'revisionspec']
2709
2239
takes_options = [
2711
help='Show from oldest to newest.'),
2713
custom_help('verbose',
2714
help='Show files changed in each revision.'),
2718
type=breezy.option._parse_revision_str,
2720
help='Show just the specified revision.'
2721
' See also "help revisionspec".'),
2723
RegistryOption('authors',
2724
'What names to list as authors - first, all or committer.',
2727
'breezy.log', 'author_list_registry'),
2731
help='Number of levels to display - 0 for all, 1 for flat.',
2733
type=_parse_levels),
2735
help='Show revisions whose message matches this '
2736
'regular expression.',
2741
help='Limit the output to the first N revisions.',
2746
help='Show changes made in each revision as a patch.'),
2747
Option('include-merged',
2748
help='Show merged revisions like --levels 0 does.'),
2749
Option('include-merges', hidden=True,
2750
help='Historical alias for --include-merged.'),
2751
Option('omit-merges',
2752
help='Do not report commits with more than one parent.'),
2753
Option('exclude-common-ancestry',
2754
help='Display only the revisions that are not part'
2755
' of both ancestries (require -rX..Y).'
2757
Option('signatures',
2758
help='Show digital signature validity.'),
2241
help='Show from oldest to newest.'),
2243
custom_help('verbose',
2244
help='Show files changed in each revision.'),
2248
type=bzrlib.option._parse_revision_str,
2250
help='Show just the specified revision.'
2251
' See also "help revisionspec".'),
2253
RegistryOption('authors',
2254
'What names to list as authors - first, all or committer.',
2256
lazy_registry=('bzrlib.log', 'author_list_registry'),
2260
help='Number of levels to display - 0 for all, 1 for flat.',
2262
type=_parse_levels),
2760
2264
short_name='m',
2761
help='Show revisions whose properties match this '
2764
ListOption('match-message',
2765
2265
help='Show revisions whose message matches this '
2768
ListOption('match-committer',
2769
help='Show revisions whose committer matches this '
2772
ListOption('match-author',
2773
help='Show revisions whose authors match this '
2776
ListOption('match-bugs',
2777
help='Show revisions whose bugs match this '
2266
'regular expression.',
2270
help='Limit the output to the first N revisions.',
2275
help='Show changes made in each revision as a patch.'),
2276
Option('include-merges',
2277
help='Show merged revisions like --levels 0 does.'),
2278
Option('exclude-common-ancestry',
2279
help='Display only the revisions that are not part'
2280
' of both ancestries (require -rX..Y)'
2781
2283
encoding_type = 'replace'
2783
2285
@display_command
3027
2497
_see_also = ['status', 'cat']
3028
2498
takes_args = ['path?']
3029
2499
takes_options = [
3032
Option('recursive', short_name='R',
3033
help='Recurse into subdirectories.'),
3035
help='Print paths relative to the root of the branch.'),
3036
Option('unknown', short_name='u',
3037
help='Print unknown files.'),
3038
Option('versioned', help='Print versioned files.',
3040
Option('ignored', short_name='i',
3041
help='Print ignored files.'),
3042
Option('kind', short_name='k',
3043
help=('List entries of a particular kind: file, '
3044
'directory, symlink, tree-reference.'),
2502
Option('recursive', short_name='R',
2503
help='Recurse into subdirectories.'),
2505
help='Print paths relative to the root of the branch.'),
2506
Option('unknown', short_name='u',
2507
help='Print unknown files.'),
2508
Option('versioned', help='Print versioned files.',
2510
Option('ignored', short_name='i',
2511
help='Print ignored files.'),
2512
Option('kind', short_name='k',
2513
help='List entries of a particular kind: file, directory, symlink.',
3051
2519
@display_command
3052
2520
def run(self, revision=None, verbose=False,
3053
2521
recursive=False, from_root=False,
3054
2522
unknown=False, versioned=False, ignored=False,
3055
2523
null=False, kind=None, show_ids=False, path=None, directory=None):
3057
if kind and kind not in ('file', 'directory', 'symlink', 'tree-reference'):
3058
raise errors.BzrCommandError(gettext('invalid kind specified'))
2525
if kind and kind not in ('file', 'directory', 'symlink'):
2526
raise errors.BzrCommandError('invalid kind specified')
3060
2528
if verbose and null:
3061
raise errors.BzrCommandError(
3062
gettext('Cannot set both --verbose and --null'))
2529
raise errors.BzrCommandError('Cannot set both --verbose and --null')
3063
2530
all = not (unknown or versioned or ignored)
3065
selection = {'I': ignored, '?': unknown, 'V': versioned}
2532
selection = {'I':ignored, '?':unknown, 'V':versioned}
3067
2534
if path is None:
3071
raise errors.BzrCommandError(gettext('cannot specify both --from-root'
2538
raise errors.BzrCommandError('cannot specify both --from-root'
3074
2541
tree, branch, relpath = \
3075
2542
_open_directory_or_containing_tree_or_branch(fs_path, directory)
3169
2636
After adding, editing or deleting that file either indirectly by
3170
2637
using this command or directly by using an editor, be sure to commit
3173
Breezy also supports a global ignore file ~/.config/breezy/ignore. On
3174
Windows the global ignore file can be found in the application data
3176
C:\\Documents and Settings\\<user>\\Application Data\\Breezy\\3.0\\ignore.
2640
Bazaar also supports a global ignore file ~/.bazaar/ignore. On Windows
2641
the global ignore file can be found in the application data directory as
2642
C:\\Documents and Settings\\<user>\\Application Data\\Bazaar\\2.0\\ignore.
3177
2643
Global ignores are not touched by this command. The global ignore file
3178
2644
can be edited directly using an editor.
3180
2646
Patterns prefixed with '!' are exceptions to ignore patterns and take
3181
2647
precedence over regular ignores. Such exceptions are used to specify
3182
2648
files that should be versioned which would otherwise be ignored.
3184
2650
Patterns prefixed with '!!' act as regular ignore patterns, but have
3185
2651
precedence over the '!' exception patterns.
3189
* Ignore patterns containing shell wildcards must be quoted from
3192
* Ignore patterns starting with "#" act as comments in the ignore file.
3193
To ignore patterns that begin with that character, use the "RE:" prefix.
2653
Note: ignore patterns containing shell wildcards must be quoted from
3196
2657
Ignore the top level Makefile::
3198
brz ignore ./Makefile
2659
bzr ignore ./Makefile
3200
2661
Ignore .class files in all directories...::
3202
brz ignore "*.class"
2663
bzr ignore "*.class"
3204
2665
...but do not ignore "special.class"::
3206
brz ignore "!special.class"
3208
Ignore files whose name begins with the "#" character::
3212
Ignore .o files under the lib directory::
3214
brz ignore "lib/**/*.o"
3216
Ignore .o files under the lib directory::
3218
brz ignore "RE:lib/.*\\.o"
2667
bzr ignore "!special.class"
2669
Ignore .o files under the lib directory::
2671
bzr ignore "lib/**/*.o"
2673
Ignore .o files under the lib directory::
2675
bzr ignore "RE:lib/.*\.o"
3220
2677
Ignore everything but the "debian" toplevel directory::
3222
brz ignore "RE:(?!debian/).*"
2679
bzr ignore "RE:(?!debian/).*"
3224
2681
Ignore everything except the "local" toplevel directory,
3225
but always ignore autosave files ending in ~, even under local/::
3228
brz ignore "!./local"
2682
but always ignore "*~" autosave files, even under local/::
2685
bzr ignore "!./local"
3232
2689
_see_also = ['status', 'ignored', 'patterns']
3233
2690
takes_args = ['name_pattern*']
3234
2691
takes_options = ['directory',
3235
Option('default-rules',
3236
help='Display the default ignore rules that brz uses.')
2692
Option('default-rules',
2693
help='Display the default ignore rules that bzr uses.')
3239
2696
def run(self, name_pattern_list=None, default_rules=None,
3240
2697
directory=u'.'):
3241
from breezy import ignores
2698
from bzrlib import ignores
3242
2699
if default_rules is not None:
3243
2700
# dump the default rules and exit
3244
2701
for pattern in ignores.USER_DEFAULTS:
3245
2702
self.outf.write("%s\n" % pattern)
3247
2704
if not name_pattern_list:
3248
raise errors.BzrCommandError(gettext("ignore requires at least one "
3249
"NAME_PATTERN or --default-rules."))
2705
raise errors.BzrCommandError("ignore requires at least one "
2706
"NAME_PATTERN or --default-rules.")
3250
2707
name_pattern_list = [globbing.normalize_pattern(p)
3251
2708
for p in name_pattern_list]
3253
bad_patterns_count = 0
3254
for p in name_pattern_list:
3255
if not globbing.Globster.is_pattern_valid(p):
3256
bad_patterns_count += 1
3257
bad_patterns += ('\n %s' % p)
3259
msg = (ngettext('Invalid ignore pattern found. %s',
3260
'Invalid ignore patterns found. %s',
3261
bad_patterns_count) % bad_patterns)
3262
ui.ui_factory.show_error(msg)
3263
raise lazy_regex.InvalidPattern('')
3264
2709
for name_pattern in name_pattern_list:
3265
2710
if (name_pattern[0] == '/' or
3266
(len(name_pattern) > 1 and name_pattern[1] == ':')):
3267
raise errors.BzrCommandError(gettext(
3268
"NAME_PATTERN should not be an absolute path"))
2711
(len(name_pattern) > 1 and name_pattern[1] == ':')):
2712
raise errors.BzrCommandError(
2713
"NAME_PATTERN should not be an absolute path")
3269
2714
tree, relpath = WorkingTree.open_containing(directory)
3270
2715
ignores.tree_ignores_add_patterns(tree, name_pattern_list)
3271
2716
ignored = globbing.Globster(name_pattern_list)
3273
self.enter_context(tree.lock_read())
3274
for filename, fc, fkind, entry in tree.list_files():
3275
id = getattr(entry, 'file_id', None)
2719
for entry in tree.list_files():
3276
2721
if id is not None:
3277
2723
if ignored.match(filename):
3278
2724
matches.append(filename)
3279
2726
if len(matches) > 0:
3280
self.outf.write(gettext("Warning: the following files are version "
3281
"controlled and match your ignore pattern:\n%s"
3282
"\nThese files will continue to be version controlled"
3283
" unless you 'brz remove' them.\n") % ("\n".join(matches),))
2727
self.outf.write("Warning: the following files are version controlled and"
2728
" match your ignore pattern:\n%s"
2729
"\nThese files will continue to be version controlled"
2730
" unless you 'bzr remove' them.\n" % ("\n".join(matches),))
3286
2733
class cmd_ignored(Command):
3361
2807
================= =========================
3364
encoding_type = 'exact'
3365
2809
takes_args = ['dest', 'branch_or_subdir?']
3366
2810
takes_options = ['directory',
3368
help="Type of file to export to.",
3371
Option('filters', help='Apply content filters to export the '
3372
'convenient form.'),
3375
help="Name of the root directory inside the exported file."),
3376
Option('per-file-timestamps',
3377
help='Set modification time of files to that of the last '
3378
'revision in which it was changed.'),
3379
Option('uncommitted',
3380
help='Export the working tree contents rather than that of the '
2812
help="Type of file to export to.",
2815
Option('filters', help='Apply content filters to export the '
2816
'convenient form.'),
2819
help="Name of the root directory inside the exported file."),
2820
Option('per-file-timestamps',
2821
help='Set modification time of files to that of the last '
2822
'revision in which it was changed.'),
3384
2824
def run(self, dest, branch_or_subdir=None, revision=None, format=None,
3385
root=None, filters=False, per_file_timestamps=False, uncommitted=False,
3387
from .export import export, guess_format, get_root_name
2825
root=None, filters=False, per_file_timestamps=False, directory=u'.'):
2826
from bzrlib.export import export
3389
2828
if branch_or_subdir is None:
3390
branch_or_subdir = directory
3392
(tree, b, subdir) = controldir.ControlDir.open_containing_tree_or_branch(
3394
if tree is not None:
3395
self.enter_context(tree.lock_read())
3399
raise errors.BzrCommandError(
3400
gettext("--uncommitted requires a working tree"))
3403
export_tree = _get_one_revision_tree(
3404
'export', revision, branch=b,
3408
format = guess_format(dest)
3411
root = get_root_name(dest)
3413
if not per_file_timestamps:
3414
force_mtime = time.time()
3419
from breezy.filter_tree import ContentFilterTree
3420
export_tree = ContentFilterTree(
3421
export_tree, export_tree._content_filter_stack)
2829
tree = WorkingTree.open_containing(directory)[0]
2833
b, subdir = Branch.open_containing(branch_or_subdir)
2836
rev_tree = _get_one_revision_tree('export', revision, branch=b, tree=tree)
3424
export(export_tree, dest, format, root, subdir,
2838
export(rev_tree, dest, format, root, subdir, filtered=filters,
3425
2839
per_file_timestamps=per_file_timestamps)
3426
except errors.NoSuchExportFormat as e:
3427
raise errors.BzrCommandError(
3428
gettext('Unsupported export format: %s') % e.format)
2840
except errors.NoSuchExportFormat, e:
2841
raise errors.BzrCommandError('Unsupported export format: %s' % e.format)
3431
2844
class cmd_cat(Command):
3452
2864
def run(self, filename, revision=None, name_from_revision=False,
3453
2865
filters=False, directory=None):
3454
2866
if revision is not None and len(revision) != 1:
3455
raise errors.BzrCommandError(gettext("brz cat --revision takes exactly"
3456
" one revision specifier"))
2867
raise errors.BzrCommandError("bzr cat --revision takes exactly"
2868
" one revision specifier")
3457
2869
tree, branch, relpath = \
3458
2870
_open_directory_or_containing_tree_or_branch(filename, directory)
3459
self.enter_context(branch.lock_read())
2871
self.add_cleanup(branch.lock_read().unlock)
3460
2872
return self._run(tree, branch, relpath, filename, revision,
3461
2873
name_from_revision, filters)
3463
2875
def _run(self, tree, b, relpath, filename, revision, name_from_revision,
3466
2877
if tree is None:
3467
2878
tree = b.basis_tree()
3468
2879
rev_tree = _get_one_revision_tree('cat', revision, branch=b)
3469
self.enter_context(rev_tree.lock_read())
2880
self.add_cleanup(rev_tree.lock_read().unlock)
2882
old_file_id = rev_tree.path2id(relpath)
3471
2884
if name_from_revision:
3472
2885
# Try in revision if requested
3473
if not rev_tree.is_versioned(relpath):
3474
raise errors.BzrCommandError(gettext(
3475
"{0!r} is not present in revision {1}").format(
2886
if old_file_id is None:
2887
raise errors.BzrCommandError(
2888
"%r is not present in revision %s" % (
3476
2889
filename, rev_tree.get_revision_id()))
3477
rev_tree_path = relpath
2891
content = rev_tree.get_file_text(old_file_id)
3480
rev_tree_path = _mod_tree.find_previous_path(
3481
tree, rev_tree, relpath)
3482
except errors.NoSuchFile:
3483
rev_tree_path = None
3485
if rev_tree_path is None:
3486
# Path didn't exist in working tree
3487
if not rev_tree.is_versioned(relpath):
3488
raise errors.BzrCommandError(gettext(
3489
"{0!r} is not present in revision {1}").format(
3490
filename, rev_tree.get_revision_id()))
3492
# Fall back to the same path in the basis tree, if present.
3493
rev_tree_path = relpath
2893
cur_file_id = tree.path2id(relpath)
2895
if cur_file_id is not None:
2896
# Then try with the actual file id
2898
content = rev_tree.get_file_text(cur_file_id)
2900
except errors.NoSuchId:
2901
# The actual file id didn't exist at that time
2903
if not found and old_file_id is not None:
2904
# Finally try with the old file id
2905
content = rev_tree.get_file_text(old_file_id)
2908
# Can't be found anywhere
2909
raise errors.BzrCommandError(
2910
"%r is not present in revision %s" % (
2911
filename, rev_tree.get_revision_id()))
3496
from .filter_tree import ContentFilterTree
3497
filter_tree = ContentFilterTree(
3498
rev_tree, rev_tree._content_filter_stack)
3499
fileobj = filter_tree.get_file(rev_tree_path)
2913
from bzrlib.filters import (
2914
ContentFilterContext,
2915
filtered_output_bytes,
2917
filters = rev_tree._content_filter_stack(relpath)
2918
chunks = content.splitlines(True)
2919
content = filtered_output_bytes(chunks, filters,
2920
ContentFilterContext(relpath, rev_tree))
2922
self.outf.writelines(content)
3501
fileobj = rev_tree.get_file(rev_tree_path)
3502
shutil.copyfileobj(fileobj, self.outf)
2925
self.outf.write(content)
3506
2928
class cmd_local_time_offset(Command):
3507
2929
__doc__ = """Show the offset in seconds from GMT to local time."""
3510
2931
@display_command
3512
2933
self.outf.write("%s\n" % osutils.local_time_offset())
3515
2937
class cmd_commit(Command):
3516
2938
__doc__ = """Commit changes into a new revision.
3548
2970
"John Doe <jdoe@example.com>". If there is more than one author of
3549
2971
the change you can specify the option multiple times, once for each
3554
2976
A common mistake is to forget to add a new file or directory before
3555
2977
running the commit command. The --strict option checks for unknown
3556
2978
files and aborts the commit if any are found. More advanced pre-commit
3557
checks can be implemented by defining hooks. See ``brz help hooks``
2979
checks can be implemented by defining hooks. See ``bzr help hooks``
3560
2982
:Things to note:
3562
If you accidentally commit the wrong changes or make a spelling
2984
If you accidentially commit the wrong changes or make a spelling
3563
2985
mistake in the commit message say, you can use the uncommit command
3564
to undo it. See ``brz help uncommit`` for details.
2986
to undo it. See ``bzr help uncommit`` for details.
3566
2988
Hooks can also be configured to run after a commit. This allows you
3567
2989
to trigger updates to external systems like bug trackers. The --fixes
3568
2990
option can be used to record the association between a revision and
3569
one or more bugs. See ``brz help bugs`` for details.
2991
one or more bugs. See ``bzr help bugs`` for details.
2993
A selective commit may fail in some cases where the committed
2994
tree would be invalid. Consider::
2999
bzr commit foo -m "committing foo"
3000
bzr mv foo/bar foo/baz
3003
bzr commit foo/bar -m "committing bar but not baz"
3005
In the example above, the last commit will fail by design. This gives
3006
the user the opportunity to decide whether they want to commit the
3007
rename at the same time, separately first, or not at all. (As a general
3008
rule, when in doubt, Bazaar has a policy of Doing the Safe Thing.)
3010
# TODO: Run hooks on tree to-be-committed, and after commit.
3012
# TODO: Strict commit that fails if there are deleted files.
3013
# (what does "deleted files" mean ??)
3015
# TODO: Give better message for -s, --summary, used by tla people
3017
# XXX: verbose currently does nothing
3572
3019
_see_also = ['add', 'bugs', 'hooks', 'uncommit']
3573
3020
takes_args = ['selected*']
3574
3021
takes_options = [
3576
'exclude', type=text_type, short_name='x',
3577
help="Do not consider changes made to a given path."),
3578
Option('message', type=text_type,
3580
help="Description of the new revision."),
3583
help='Commit even if nothing has changed.'),
3584
Option('file', type=text_type,
3587
help='Take commit message from this file.'),
3589
help="Refuse to commit if there are unknown "
3590
"files in the working tree."),
3591
Option('commit-time', type=text_type,
3592
help="Manually set a commit time using commit date "
3593
"format, e.g. '2009-10-10 08:00:00 +0100'."),
3595
'bugs', type=text_type,
3596
help="Link to a related bug. (see \"brz help bugs\")."),
3598
'fixes', type=text_type,
3599
help="Mark a bug as being fixed by this revision "
3600
"(see \"brz help bugs\")."),
3602
'author', type=text_type,
3603
help="Set the author's name, if it's different "
3604
"from the committer."),
3606
help="Perform a local commit in a bound "
3607
"branch. Local commits are not pushed to "
3608
"the master branch until a normal commit "
3611
Option('show-diff', short_name='p',
3612
help='When no message is supplied, show the diff along'
3613
' with the status summary in the message editor.'),
3615
help='When committing to a foreign version control '
3616
'system do not push data that can not be natively '
3022
ListOption('exclude', type=str, short_name='x',
3023
help="Do not consider changes made to a given path."),
3024
Option('message', type=unicode,
3026
help="Description of the new revision."),
3029
help='Commit even if nothing has changed.'),
3030
Option('file', type=str,
3033
help='Take commit message from this file.'),
3035
help="Refuse to commit if there are unknown "
3036
"files in the working tree."),
3037
Option('commit-time', type=str,
3038
help="Manually set a commit time using commit date "
3039
"format, e.g. '2009-10-10 08:00:00 +0100'."),
3040
ListOption('fixes', type=str,
3041
help="Mark a bug as being fixed by this revision "
3042
"(see \"bzr help bugs\")."),
3043
ListOption('author', type=unicode,
3044
help="Set the author's name, if it's different "
3045
"from the committer."),
3047
help="Perform a local commit in a bound "
3048
"branch. Local commits are not pushed to "
3049
"the master branch until a normal commit "
3052
Option('show-diff', short_name='p',
3053
help='When no message is supplied, show the diff along'
3054
' with the status summary in the message editor.'),
3618
3056
aliases = ['ci', 'checkin']
3620
def _iter_bug_urls(self, bugs, branch, status):
3621
default_bugtracker = None
3058
def _iter_bug_fix_urls(self, fixes, branch):
3622
3059
# Configure the properties for bug fixing attributes.
3624
tokens = bug.split(':')
3625
if len(tokens) == 1:
3626
if default_bugtracker is None:
3627
branch_config = branch.get_config_stack()
3628
default_bugtracker = branch_config.get(
3630
if default_bugtracker is None:
3631
raise errors.BzrCommandError(gettext(
3632
"No tracker specified for bug %s. Use the form "
3633
"'tracker:id' or specify a default bug tracker "
3634
"using the `bugtracker` option.\nSee "
3635
"\"brz help bugs\" for more information on this "
3636
"feature. Commit refused.") % bug)
3637
tag = default_bugtracker
3639
elif len(tokens) != 2:
3640
raise errors.BzrCommandError(gettext(
3060
for fixed_bug in fixes:
3061
tokens = fixed_bug.split(':')
3062
if len(tokens) != 2:
3063
raise errors.BzrCommandError(
3641
3064
"Invalid bug %s. Must be in the form of 'tracker:id'. "
3642
"See \"brz help bugs\" for more information on this "
3643
"feature.\nCommit refused.") % bug)
3645
tag, bug_id = tokens
3065
"See \"bzr help bugs\" for more information on this "
3066
"feature.\nCommit refused." % fixed_bug)
3067
tag, bug_id = tokens
3647
yield bugtracker.get_bug_url(tag, branch, bug_id), status
3648
except bugtracker.UnknownBugTrackerAbbreviation:
3649
raise errors.BzrCommandError(gettext(
3650
'Unrecognized bug %s. Commit refused.') % bug)
3651
except bugtracker.MalformedBugIdentifier as e:
3652
raise errors.BzrCommandError(gettext(
3653
u"%s\nCommit refused.") % (e,))
3069
yield bugtracker.get_bug_url(tag, branch, bug_id)
3070
except errors.UnknownBugTrackerAbbreviation:
3071
raise errors.BzrCommandError(
3072
'Unrecognized bug %s. Commit refused.' % fixed_bug)
3073
except errors.MalformedBugIdentifier, e:
3074
raise errors.BzrCommandError(
3075
"%s\nCommit refused." % (str(e),))
3655
3077
def run(self, message=None, file=None, verbose=False, selected_list=None,
3656
unchanged=False, strict=False, local=False, fixes=None, bugs=None,
3657
author=None, show_diff=False, exclude=None, commit_time=None,
3660
from .commit import (
3078
unchanged=False, strict=False, local=False, fixes=None,
3079
author=None, show_diff=False, exclude=None, commit_time=None):
3080
from bzrlib.errors import (
3661
3081
PointlessCommit,
3663
from .errors import (
3664
3082
ConflictsInTree,
3665
3083
StrictCommitFailed
3667
from .msgeditor import (
3085
from bzrlib.msgeditor import (
3668
3086
edit_commit_message_encoded,
3669
3087
generate_commit_message_template,
3670
make_commit_message_template_encoded,
3088
make_commit_message_template_encoded
3674
3091
commit_stamp = offset = None
3675
3092
if commit_time is not None:
3677
3094
commit_stamp, offset = timestamp.parse_patch_date(commit_time)
3678
except ValueError as e:
3679
raise errors.BzrCommandError(gettext(
3680
"Could not parse --commit-time: " + str(e)))
3095
except ValueError, e:
3096
raise errors.BzrCommandError(
3097
"Could not parse --commit-time: " + str(e))
3099
# TODO: Need a blackbox test for invoking the external editor; may be
3100
# slightly problematic to run this cross-platform.
3102
# TODO: do more checks that the commit will succeed before
3103
# spending the user's valuable time typing a commit message.
3682
3105
properties = {}
3684
tree, selected_list = WorkingTree.open_containing_paths(selected_list)
3107
tree, selected_list = tree_files(selected_list)
3685
3108
if selected_list == ['']:
3686
3109
# workaround - commit of root of tree should be exactly the same
3687
3110
# as just default commit in that tree, and succeed even though
3865
3276
class cmd_upgrade(Command):
3866
__doc__ = """Upgrade a repository, branch or working tree to a newer format.
3868
When the default format has changed after a major new release of
3869
Bazaar/Breezy, you may be informed during certain operations that you
3870
should upgrade. Upgrading to a newer format may improve performance
3871
or make new features available. It may however limit interoperability
3872
with older repositories or with older versions of Bazaar or Breezy.
3874
If you wish to upgrade to a particular format rather than the
3875
current default, that can be specified using the --format option.
3876
As a consequence, you can use the upgrade command this way to
3877
"downgrade" to an earlier format, though some conversions are
3878
a one way process (e.g. changing from the 1.x default to the
3879
2.x default) so downgrading is not always possible.
3881
A backup.bzr.~#~ directory is created at the start of the conversion
3882
process (where # is a number). By default, this is left there on
3883
completion. If the conversion fails, delete the new .bzr directory
3884
and rename this one back in its place. Use the --clean option to ask
3885
for the backup.bzr directory to be removed on successful conversion.
3886
Alternatively, you can delete it by hand if everything looks good
3889
If the location given is a shared repository, dependent branches
3890
are also converted provided the repository converts successfully.
3891
If the conversion of a branch fails, remaining branches are still
3894
For more information on upgrades, see the Breezy Upgrade Guide,
3895
https://www.breezy-vcs.org/doc/en/upgrade-guide/.
3277
__doc__ = """Upgrade branch storage to current format.
3279
The check command or bzr developers may sometimes advise you to run
3280
this command. When the default format has changed you may also be warned
3281
during other operations to upgrade.
3898
_see_also = ['check', 'reconcile', 'formats']
3284
_see_also = ['check']
3899
3285
takes_args = ['url?']
3900
3286
takes_options = [
3901
RegistryOption('format',
3902
help='Upgrade to a specific format. See "brz help'
3903
' formats" for details.',
3904
lazy_registry=('breezy.controldir', 'format_registry'),
3905
converter=lambda name: controldir.format_registry.make_controldir(
3907
value_switches=True, title='Branch format'),
3909
help='Remove the backup.bzr directory if successful.'),
3911
help="Show what would be done, but don't actually do anything."),
3287
RegistryOption('format',
3288
help='Upgrade to a specific format. See "bzr help'
3289
' formats" for details.',
3290
lazy_registry=('bzrlib.bzrdir', 'format_registry'),
3291
converter=lambda name: bzrdir.format_registry.make_bzrdir(name),
3292
value_switches=True, title='Branch format'),
3914
def run(self, url='.', format=None, clean=False, dry_run=False):
3915
from .upgrade import upgrade
3916
exceptions = upgrade(url, format, clean_up=clean, dry_run=dry_run)
3918
if len(exceptions) == 1:
3919
# Compatibility with historical behavior
3295
def run(self, url='.', format=None):
3296
from bzrlib.upgrade import upgrade
3297
upgrade(url, format)
3925
3300
class cmd_whoami(Command):
3926
__doc__ = """Show or set brz user id.
3301
__doc__ = """Show or set bzr user id.
3929
3304
Show the email of the current user::
3933
3308
Set the current user::
3935
brz whoami "Frank Chu <fchu@example.com>"
3310
bzr whoami "Frank Chu <fchu@example.com>"
3937
takes_options = ['directory',
3939
help='Display email address only.'),
3941
help='Set identity for the current branch instead of '
3312
takes_options = [ Option('email',
3313
help='Display email address only.'),
3315
help='Set identity for the current branch instead of '
3944
3318
takes_args = ['name?']
3945
3319
encoding_type = 'replace'
3947
3321
@display_command
3948
def run(self, email=False, branch=False, name=None, directory=None):
3322
def run(self, email=False, branch=False, name=None):
3949
3323
if name is None:
3950
if directory is None:
3951
# use branch if we're inside one; otherwise global config
3953
c = Branch.open_containing(u'.')[0].get_config_stack()
3954
except errors.NotBranchError:
3955
c = _mod_config.GlobalStack()
3957
c = Branch.open(directory).get_config_stack()
3958
identity = c.get('email')
3324
# use branch if we're inside one; otherwise global config
3326
c = Branch.open_containing('.')[0].get_config()
3327
except errors.NotBranchError:
3328
c = config.GlobalConfig()
3960
self.outf.write(_mod_config.extract_email_address(identity)
3330
self.outf.write(c.user_email() + '\n')
3963
self.outf.write(identity + '\n')
3332
self.outf.write(c.username() + '\n')
3967
raise errors.BzrCommandError(gettext("--email can only be used to display existing "
3970
3335
# display a warning if an email address isn't included in the given name.
3972
_mod_config.extract_email_address(name)
3973
except _mod_config.NoEmailInUsername:
3337
config.extract_email_address(name)
3338
except errors.NoEmailInUsername, e:
3974
3339
warning('"%s" does not seem to contain an email address. '
3975
3340
'This is allowed, but not recommended.', name)
3977
3342
# use global config unless --branch given
3979
if directory is None:
3980
c = Branch.open_containing(u'.')[0].get_config_stack()
3982
b = Branch.open(directory)
3983
self.enter_context(b.lock_write())
3984
c = b.get_config_stack()
3344
c = Branch.open_containing('.')[0].get_config()
3986
c = _mod_config.GlobalStack()
3987
c.set('email', name)
3346
c = config.GlobalConfig()
3347
c.set_user_option('email', name)
3990
3350
class cmd_nick(Command):
3991
3351
__doc__ = """Print or set the branch nickname.
3993
If unset, the colocated branch name is used for colocated branches, and
3994
the branch directory name is used for other branches. To print the
3995
current nickname, execute with no argument.
3353
If unset, the tree root directory name is used as the nickname.
3354
To print the current nickname, execute with no argument.
3997
3356
Bound branches use the nickname of its master branch unless it is set
4215
3566
def run(self, testspecs_list=None, verbose=False, one=False,
4216
3567
transport=None, benchmark=None,
3568
lsprof_timed=None, cache_dir=None,
4218
3569
first=False, list_only=False,
4219
3570
randomize=None, exclude=None, strict=False,
4220
load_list=None, debugflag=None, starting_with=None, subunit1=False,
4221
subunit2=False, parallel=None, lsprof_tests=False, sync=False):
4223
# During selftest, disallow proxying, as it can cause severe
4224
# performance penalties and is only needed for thread
4225
# safety. The selftest command is assumed to not use threads
4226
# too heavily. The call should be as early as possible, as
4227
# error reporting for past duplicate imports won't have useful
4229
if sys.version_info[0] < 3:
4230
# TODO(pad.lv/1696545): Allow proxying on Python 3, since
4231
# disallowing it currently leads to failures in many places.
4232
lazy_import.disallow_proxying()
4237
raise errors.BzrCommandError("tests not available. Install the "
4238
"breezy tests to run the breezy testsuite.")
3571
load_list=None, debugflag=None, starting_with=None, subunit=False,
3572
parallel=None, lsprof_tests=False):
3573
from bzrlib.tests import selftest
3574
import bzrlib.benchmarks as benchmarks
3575
from bzrlib.benchmarks import tree_creator
3577
# Make deprecation warnings visible, unless -Werror is set
3578
symbol_versioning.activate_deprecation_warnings(override=False)
3580
if cache_dir is not None:
3581
tree_creator.TreeCreator.CACHE_ROOT = osutils.abspath(cache_dir)
4240
3582
if testspecs_list is not None:
4241
3583
pattern = '|'.join(testspecs_list)
4246
from .tests import SubUnitBzrRunnerv1
3588
from bzrlib.tests import SubUnitBzrRunner
4247
3589
except ImportError:
4248
raise errors.BzrCommandError(gettext(
4249
"subunit not available. subunit needs to be installed "
4250
"to use --subunit."))
4251
self.additional_selftest_args['runner_class'] = SubUnitBzrRunnerv1
3590
raise errors.BzrCommandError("subunit not available. subunit "
3591
"needs to be installed to use --subunit.")
3592
self.additional_selftest_args['runner_class'] = SubUnitBzrRunner
4252
3593
# On Windows, disable automatic conversion of '\n' to '\r\n' in
4253
# stdout, which would corrupt the subunit stream.
3594
# stdout, which would corrupt the subunit stream.
4254
3595
# FIXME: This has been fixed in subunit trunk (>0.0.5) so the
4255
3596
# following code can be deleted when it's sufficiently deployed
4256
3597
# -- vila/mgz 20100514
4257
3598
if (sys.platform == "win32"
4258
and getattr(sys.stdout, 'fileno', None) is not None):
3599
and getattr(sys.stdout, 'fileno', None) is not None):
4260
3601
msvcrt.setmode(sys.stdout.fileno(), os.O_BINARY)
4263
from .tests import SubUnitBzrRunnerv2
4265
raise errors.BzrCommandError(gettext(
4266
"subunit not available. subunit "
4267
"needs to be installed to use --subunit2."))
4268
self.additional_selftest_args['runner_class'] = SubUnitBzrRunnerv2
4271
3603
self.additional_selftest_args.setdefault(
4272
3604
'suite_decorators', []).append(parallel)
4274
raise errors.BzrCommandError(gettext(
4275
"--benchmark is no longer supported from brz 2.2; "
4276
"use bzr-usertest instead"))
4277
test_suite_factory = None
4279
exclude_pattern = None
3606
test_suite_factory = benchmarks.test_suite
3607
# Unless user explicitly asks for quiet, be verbose in benchmarks
3608
verbose = not is_quiet()
3609
# TODO: should possibly lock the history file...
3610
benchfile = open(".perf_history", "at", buffering=1)
3611
self.add_cleanup(benchfile.close)
4281
exclude_pattern = '(' + '|'.join(exclude) + ')'
4283
self._disable_fsync()
3613
test_suite_factory = None
4284
3615
selftest_kwargs = {"verbose": verbose,
4286
"stop_on_failure": one,
4287
"transport": transport,
4288
"test_suite_factory": test_suite_factory,
4289
"lsprof_timed": lsprof_timed,
4290
"lsprof_tests": lsprof_tests,
4291
"matching_tests_first": first,
4292
"list_only": list_only,
4293
"random_seed": randomize,
4294
"exclude_pattern": exclude_pattern,
4296
"load_list": load_list,
4297
"debug_flags": debugflag,
4298
"starting_with": starting_with
3617
"stop_on_failure": one,
3618
"transport": transport,
3619
"test_suite_factory": test_suite_factory,
3620
"lsprof_timed": lsprof_timed,
3621
"lsprof_tests": lsprof_tests,
3622
"bench_history": benchfile,
3623
"matching_tests_first": first,
3624
"list_only": list_only,
3625
"random_seed": randomize,
3626
"exclude_pattern": exclude,
3628
"load_list": load_list,
3629
"debug_flags": debugflag,
3630
"starting_with": starting_with
4300
3632
selftest_kwargs.update(self.additional_selftest_args)
4302
# Make deprecation warnings visible, unless -Werror is set
4303
cleanup = symbol_versioning.activate_deprecation_warnings(
4306
result = tests.selftest(**selftest_kwargs)
3633
result = selftest(**selftest_kwargs)
4309
3634
return int(not result)
4311
def _disable_fsync(self):
4312
"""Change the 'os' functionality to not synchronize."""
4313
self._orig_fsync = getattr(os, 'fsync', None)
4314
if self._orig_fsync is not None:
4315
os.fsync = lambda filedes: None
4316
self._orig_fdatasync = getattr(os, 'fdatasync', None)
4317
if self._orig_fdatasync is not None:
4318
os.fdatasync = lambda filedes: None
4321
3637
class cmd_version(Command):
4322
__doc__ = """Show version of brz."""
3638
__doc__ = """Show version of bzr."""
4324
3640
encoding_type = 'replace'
4325
3641
takes_options = [
4376
3691
The source of the merge can be specified either in the form of a branch,
4377
3692
or in the form of a path to a file containing a merge directive generated
4378
with brz send. If neither is specified, the default is the upstream branch
4379
or the branch most recently merged using --remember. The source of the
4380
merge may also be specified in the form of a path to a file in another
4381
branch: in this case, only the modifications to that file are merged into
4382
the current working tree.
4384
When merging from a branch, by default brz will try to merge in all new
4385
work from the other branch, automatically determining an appropriate base
4386
revision. If this fails, you may need to give an explicit base.
4388
To pick a different ending revision, pass "--revision OTHER". brz will
4389
try to merge in all new work up to and including revision OTHER.
4391
If you specify two values, "--revision BASE..OTHER", only revisions BASE
4392
through OTHER, excluding BASE but including OTHER, will be merged. If this
4393
causes some revisions to be skipped, i.e. if the destination branch does
4394
not already contain revision BASE, such a merge is commonly referred to as
4395
a "cherrypick". Unlike a normal merge, Breezy does not currently track
4396
cherrypicks. The changes look like a normal commit, and the history of the
4397
changes from the other branch is not stored in the commit.
4399
Revision numbers are always relative to the source branch.
3693
with bzr send. If neither is specified, the default is the upstream branch
3694
or the branch most recently merged using --remember.
3696
When merging a branch, by default the tip will be merged. To pick a different
3697
revision, pass --revision. If you specify two values, the first will be used as
3698
BASE and the second one as OTHER. Merging individual revisions, or a subset of
3699
available revisions, like this is commonly referred to as "cherrypicking".
3701
Revision numbers are always relative to the branch being merged.
3703
By default, bzr will try to merge in all new work from the other
3704
branch, automatically determining an appropriate base. If this
3705
fails, you may need to give an explicit base.
4401
3707
Merge will do its best to combine the changes in two branches, but there
4402
3708
are some kinds of problems only a human can fix. When it encounters those,
4403
3709
it will mark a conflict. A conflict means that you need to fix something,
4404
before you can commit.
4406
Use brz resolve when you have fixed a problem. See also brz conflicts.
4408
If there is no default branch set, the first merge will set it (use
4409
--no-remember to avoid setting it). After that, you can omit the branch
4410
to use the default. To change the default, use --remember. The value will
4411
only be saved if the remote location can be accessed.
3710
before you should commit.
3712
Use bzr resolve when you have fixed a problem. See also bzr conflicts.
3714
If there is no default branch set, the first merge will set it. After
3715
that, you can omit the branch to use the default. To change the
3716
default, use --remember. The value will only be saved if the remote
3717
location can be accessed.
4413
3719
The results of the merge are placed into the destination working
4414
directory, where they can be reviewed (with brz diff), tested, and then
3720
directory, where they can be reviewed (with bzr diff), tested, and then
4415
3721
committed to record the result of the merge.
4417
3723
merge refuses to run if there are any uncommitted changes, unless
4418
--force is given. If --force is given, then the changes from the source
4419
will be merged with the current working tree, including any uncommitted
4420
changes in the tree. The --force option can also be used to create a
3724
--force is given. The --force option can also be used to create a
4421
3725
merge revision which has more than two parents.
4423
3727
If one would like to merge changes from the working tree of the other
4511
3815
change_reporter = delta._ChangeReporter(
4512
3816
unversioned_filter=tree.is_ignored, view_info=view_info)
4513
3817
pb = ui.ui_factory.nested_progress_bar()
4514
self.enter_context(pb)
4515
self.enter_context(tree.lock_write())
3818
self.add_cleanup(pb.finished)
3819
self.add_cleanup(tree.lock_write().unlock)
4516
3820
if location is not None:
4518
mergeable = _mod_mergeable.read_mergeable_from_url(
4519
location, possible_transports=possible_transports)
3822
mergeable = bundle.read_mergeable_from_url(location,
3823
possible_transports=possible_transports)
4520
3824
except errors.NotABundle:
4521
3825
mergeable = None
4523
3827
if uncommitted:
4524
raise errors.BzrCommandError(gettext('Cannot use --uncommitted'
4525
' with bundles or merge directives.'))
3828
raise errors.BzrCommandError('Cannot use --uncommitted'
3829
' with bundles or merge directives.')
4527
3831
if revision is not None:
4528
raise errors.BzrCommandError(gettext(
4529
'Cannot use -r with merge directives or bundles'))
3832
raise errors.BzrCommandError(
3833
'Cannot use -r with merge directives or bundles')
4530
3834
merger, verified = _mod_merge.Merger.from_mergeable(tree,
4533
3837
if merger is None and uncommitted:
4534
3838
if revision is not None and len(revision) > 0:
4535
raise errors.BzrCommandError(gettext('Cannot use --uncommitted and'
4536
' --revision at the same time.'))
3839
raise errors.BzrCommandError('Cannot use --uncommitted and'
3840
' --revision at the same time.')
4537
3841
merger = self.get_merger_from_uncommitted(tree, location, None)
4538
3842
allow_pending = False
4540
3844
if merger is None:
4541
3845
merger, allow_pending = self._get_merger_from_branch(tree,
4542
location, revision, remember, possible_transports, None)
3846
location, revision, remember, possible_transports, None)
4544
3848
merger.merge_type = merge_type
4545
3849
merger.reprocess = reprocess
4546
3850
merger.show_base = show_base
4547
3851
self.sanity_check_merger(merger)
4548
3852
if (merger.base_rev_id == merger.other_rev_id and
4549
merger.other_rev_id is not None):
4550
# check if location is a nonexistent file (and not a branch) to
4551
# disambiguate the 'Nothing to do'
4552
if merger.interesting_files:
4553
if not merger.other_tree.has_filename(
4554
merger.interesting_files[0]):
4555
note(gettext("merger: ") + str(merger))
4556
raise errors.PathsDoNotExist([location])
4557
note(gettext('Nothing to do.'))
3853
merger.other_rev_id is not None):
3854
note('Nothing to do.')
4559
if pull and not preview:
4560
3857
if merger.interesting_files is not None:
4561
raise errors.BzrCommandError(
4562
gettext('Cannot pull individual files'))
3858
raise errors.BzrCommandError('Cannot pull individual files')
4563
3859
if (merger.base_rev_id == tree.last_revision()):
4564
3860
result = tree.pull(merger.other_branch, False,
4565
3861
merger.other_rev_id)
4566
3862
result.report(self.outf)
4568
3864
if merger.this_basis is None:
4569
raise errors.BzrCommandError(gettext(
3865
raise errors.BzrCommandError(
4570
3866
"This branch has no commits."
4571
" (perhaps you would prefer 'brz pull')"))
3867
" (perhaps you would prefer 'bzr pull')")
4573
3869
return self._do_preview(merger)
4574
3870
elif interactive:
4780
4057
Re-do the merge of all conflicted files, and show the base text in
4781
4058
conflict regions, in addition to the usual THIS and OTHER texts::
4783
brz remerge --show-base
4060
bzr remerge --show-base
4785
4062
Re-do the merge of "foobar", using the weave merge algorithm, with
4786
4063
additional processing to reduce the size of conflict regions::
4788
brz remerge --merge-type weave --reprocess foobar
4065
bzr remerge --merge-type weave --reprocess foobar
4790
4067
takes_args = ['file*']
4791
4068
takes_options = [
4795
help="Show base revision text in conflicts."),
4072
help="Show base revision text in conflicts."),
4798
4075
def run(self, file_list=None, merge_type=None, show_base=False,
4799
4076
reprocess=False):
4800
from .conflicts import restore
4077
from bzrlib.conflicts import restore
4801
4078
if merge_type is None:
4802
4079
merge_type = _mod_merge.Merge3Merger
4803
tree, file_list = WorkingTree.open_containing_paths(file_list)
4804
self.enter_context(tree.lock_write())
4080
tree, file_list = tree_files(file_list)
4081
self.add_cleanup(tree.lock_write().unlock)
4805
4082
parents = tree.get_parent_ids()
4806
4083
if len(parents) != 2:
4807
raise errors.BzrCommandError(
4808
gettext("Sorry, remerge only works after normal"
4809
" merges. Not cherrypicking or multi-merges."))
4810
interesting_files = None
4084
raise errors.BzrCommandError("Sorry, remerge only works after normal"
4085
" merges. Not cherrypicking or"
4087
repository = tree.branch.repository
4088
interesting_ids = None
4811
4089
new_conflicts = []
4812
4090
conflicts = tree.conflicts()
4813
4091
if file_list is not None:
4814
interesting_files = set()
4092
interesting_ids = set()
4815
4093
for filename in file_list:
4816
if not tree.is_versioned(filename):
4094
file_id = tree.path2id(filename)
4817
4096
raise errors.NotVersionedError(filename)
4818
interesting_files.add(filename)
4819
if tree.kind(filename) != "directory":
4097
interesting_ids.add(file_id)
4098
if tree.kind(file_id) != "directory":
4822
for path, ie in tree.iter_entries_by_dir(
4823
specific_files=[filename]):
4824
interesting_files.add(path)
4101
for name, ie in tree.inventory.iter_entries(file_id):
4102
interesting_ids.add(ie.file_id)
4825
4103
new_conflicts = conflicts.select_conflicts(tree, file_list)[0]
4827
4105
# Remerge only supports resolving contents conflicts
4828
4106
allowed_conflicts = ('text conflict', 'contents conflict')
4829
4107
restore_files = [c.path for c in conflicts
4830
4108
if c.typestring in allowed_conflicts]
4831
_mod_merge.transform_tree(tree, tree.basis_tree(), interesting_files)
4109
_mod_merge.transform_tree(tree, tree.basis_tree(), interesting_ids)
4832
4110
tree.set_conflicts(ConflictList(new_conflicts))
4833
4111
if file_list is not None:
4834
4112
restore_files = file_list
5292
4557
@display_command
5293
4558
def run(self, filename, all=False, long=False, revision=None,
5294
4559
show_ids=False, directory=None):
5295
from .annotate import (
4560
from bzrlib.annotate import annotate_file, annotate_file_tree
5298
4561
wt, branch, relpath = \
5299
4562
_open_directory_or_containing_tree_or_branch(filename, directory)
5300
4563
if wt is not None:
5301
self.enter_context(wt.lock_read())
4564
self.add_cleanup(wt.lock_read().unlock)
5303
self.enter_context(branch.lock_read())
4566
self.add_cleanup(branch.lock_read().unlock)
5304
4567
tree = _get_one_revision_tree('annotate', revision, branch=branch)
5305
self.enter_context(tree.lock_read())
4568
self.add_cleanup(tree.lock_read().unlock)
4570
file_id = wt.path2id(relpath)
4572
file_id = tree.path2id(relpath)
4574
raise errors.NotVersionedError(filename)
4575
file_version = tree.inventory[file_id].revision
5306
4576
if wt is not None and revision is None:
5307
if not wt.is_versioned(relpath):
5308
raise errors.NotVersionedError(relpath)
5309
4577
# If there is a tree and we're not annotating historical
5310
4578
# versions, annotate the working tree's content.
5311
annotate_file_tree(wt, relpath, self.outf, long, all,
4579
annotate_file_tree(wt, file_id, self.outf, long, all,
5314
if not tree.is_versioned(relpath):
5315
raise errors.NotVersionedError(relpath)
5316
annotate_file_tree(tree, relpath, self.outf, long, all,
5317
show_ids=show_ids, branch=branch)
4582
annotate_file(branch, file_version, file_id, long, all, self.outf,
5320
4586
class cmd_re_sign(Command):
5321
4587
__doc__ = """Create a digital signature for an existing revision."""
5322
4588
# TODO be able to replace existing ones.
5324
hidden = True # is this right ?
4590
hidden = True # is this right ?
5325
4591
takes_args = ['revision_id*']
5326
4592
takes_options = ['directory', 'revision']
5328
4594
def run(self, revision_id_list=None, revision=None, directory=u'.'):
5329
4595
if revision_id_list is not None and revision is not None:
5330
raise errors.BzrCommandError(
5331
gettext('You can only supply one of revision_id or --revision'))
4596
raise errors.BzrCommandError('You can only supply one of revision_id or --revision')
5332
4597
if revision_id_list is None and revision is None:
5333
raise errors.BzrCommandError(
5334
gettext('You must supply either --revision or a revision_id'))
4598
raise errors.BzrCommandError('You must supply either --revision or a revision_id')
5335
4599
b = WorkingTree.open_containing(directory)[0].branch
5336
self.enter_context(b.lock_write())
4600
self.add_cleanup(b.lock_write().unlock)
5337
4601
return self._run(b, revision_id_list, revision)
5339
4603
def _run(self, b, revision_id_list, revision):
5340
from .repository import WriteGroup
5341
gpg_strategy = gpg.GPGStrategy(b.get_config_stack())
4604
import bzrlib.gpg as gpg
4605
gpg_strategy = gpg.GPGStrategy(b.get_config())
5342
4606
if revision_id_list is not None:
5343
with WriteGroup(b.repository):
4607
b.repository.start_write_group()
5344
4609
for revision_id in revision_id_list:
5345
revision_id = cache_utf8.encode(revision_id)
5346
4610
b.repository.sign_revision(revision_id, gpg_strategy)
4612
b.repository.abort_write_group()
4615
b.repository.commit_write_group()
5347
4616
elif revision is not None:
5348
4617
if len(revision) == 1:
5349
4618
revno, rev_id = revision[0].in_history(b)
5350
with WriteGroup(b.repository):
4619
b.repository.start_write_group()
5351
4621
b.repository.sign_revision(rev_id, gpg_strategy)
4623
b.repository.abort_write_group()
4626
b.repository.commit_write_group()
5352
4627
elif len(revision) == 2:
5353
4628
# are they both on rh- if so we can walk between them
5354
4629
# might be nice to have a range helper for arbitrary
5522
4794
end_revision=last_revno)
5525
self.outf.write(gettext('Dry-run, pretending to remove'
5526
' the above revisions.\n'))
4797
self.outf.write('Dry-run, pretending to remove'
4798
' the above revisions.\n')
5529
gettext('The above revision(s) will be removed.\n'))
4800
self.outf.write('The above revision(s) will be removed.\n')
5532
if not ui.ui_factory.confirm_action(
5533
gettext(u'Uncommit these revisions'),
5534
'breezy.builtins.uncommit',
5536
self.outf.write(gettext('Canceled\n'))
4803
if not ui.ui_factory.get_boolean('Are you sure'):
4804
self.outf.write('Canceled')
5539
4807
mutter('Uncommitting from {%s} to {%s}',
5540
4808
last_rev_id, rev_id)
5541
4809
uncommit(b, tree=tree, dry_run=dry_run, verbose=verbose,
5542
revno=revno, local=local, keep_tags=keep_tags)
5545
gettext('You can restore the old tip by running:\n'
5546
' brz pull -d %s %s -r revid:%s\n')
5547
% (location, location, last_rev_id.decode('utf-8')))
5550
gettext('You can restore the old tip by running:\n'
5551
' brz pull . -r revid:%s\n')
5552
% last_rev_id.decode('utf-8'))
4810
revno=revno, local=local)
4811
self.outf.write('You can restore the old tip by running:\n'
4812
' bzr pull . -r revid:%s\n' % last_rev_id)
5555
4815
class cmd_break_lock(Command):
5556
__doc__ = """Break a dead lock.
5558
This command breaks a lock on a repository, branch, working directory or
4816
__doc__ = """Break a dead lock on a repository, branch or working directory.
5561
4818
CAUTION: Locks should only be broken when you are sure that the process
5562
4819
holding the lock has been stopped.
5564
You can get information on what locks are open via the 'brz info
4821
You can get information on what locks are open via the 'bzr info
5565
4822
[location]' command.
5569
brz break-lock brz+ssh://example.com/brz/foo
5570
brz break-lock --conf ~/.config/breezy
4826
bzr break-lock bzr+ssh://example.com/bzr/foo
5573
4828
takes_args = ['location?']
5576
help='LOCATION is the directory where the config lock is.'),
5578
help='Do not ask for confirmation before breaking the lock.'),
5581
def run(self, location=None, config=False, force=False):
4830
def run(self, location=None, show=False):
5582
4831
if location is None:
5583
4832
location = u'.'
5585
ui.ui_factory = ui.ConfirmationUserInterfacePolicy(ui.ui_factory,
5587
{'breezy.lockdir.break': True})
5589
conf = _mod_config.LockableConfig(file_name=location)
5592
control, relpath = controldir.ControlDir.open_containing(location)
5594
control.break_lock()
5595
except NotImplementedError:
4833
control, relpath = bzrdir.BzrDir.open_containing(location)
4835
control.break_lock()
4836
except NotImplementedError:
5599
4840
class cmd_wait_until_signalled(Command):
5600
__doc__ = """Test helper for test_start_and_stop_brz_subprocess_send_signal.
4841
__doc__ = """Test helper for test_start_and_stop_bzr_subprocess_send_signal.
5602
4843
This just prints a line to signal when it is ready, then blocks on stdin.
5620
4861
help='Serve on stdin/out for use from inetd or sshd.'),
5621
4862
RegistryOption('protocol',
5622
help="Protocol to serve.",
5623
lazy_registry=('breezy.transport',
5624
'transport_server_registry'),
5625
value_switches=True),
5627
help='Listen for connections on nominated address.',
4863
help="Protocol to serve.",
4864
lazy_registry=('bzrlib.transport', 'transport_server_registry'),
4865
value_switches=True),
5630
help='Listen for connections on nominated port. Passing 0 as '
5631
'the port number will result in a dynamically allocated '
5632
'port. The default port depends on the protocol.',
4867
help='Listen for connections on nominated port of the form '
4868
'[hostname:]portnumber. Passing 0 as the port number will '
4869
'result in a dynamically allocated port. The default port '
4870
'depends on the protocol.',
5634
4872
custom_help('directory',
5635
help='Serve contents of this directory.'),
4873
help='Serve contents of this directory.'),
5636
4874
Option('allow-writes',
5637
4875
help='By default the server is a readonly server. Supplying '
5638
4876
'--allow-writes enables write access to the contents of '
5639
'the served directory and below. Note that ``brz serve`` '
4877
'the served directory and below. Note that ``bzr serve`` '
5640
4878
'does not perform authentication, so unless some form of '
5641
4879
'external authentication is arranged supplying this '
5642
4880
'option leads to global uncontrolled write access to your '
5645
Option('client-timeout', type=float,
5646
help='Override the default idle client timeout (5min).'),
5649
def run(self, listen=None, port=None, inet=False, directory=None,
5650
allow_writes=False, protocol=None, client_timeout=None):
5651
from . import location, transport
4885
def get_host_and_port(self, port):
4886
"""Return the host and port to run the smart server on.
4888
If 'port' is None, None will be returned for the host and port.
4890
If 'port' has a colon in it, the string before the colon will be
4891
interpreted as the host.
4893
:param port: A string of the port to run the server on.
4894
:return: A tuple of (host, port), where 'host' is a host name or IP,
4895
and port is an integer TCP/IP port.
4898
if port is not None:
4900
host, port = port.split(':')
4904
def run(self, port=None, inet=False, directory=None, allow_writes=False,
4906
from bzrlib.transport import get_transport, transport_server_registry
5652
4907
if directory is None:
5653
directory = osutils.getcwd()
4908
directory = os.getcwd()
5654
4909
if protocol is None:
5655
protocol = transport.transport_server_registry.get()
5656
url = location.location_to_url(directory)
4910
protocol = transport_server_registry.get()
4911
host, port = self.get_host_and_port(port)
4912
url = urlutils.local_path_to_url(directory)
5657
4913
if not allow_writes:
5658
4914
url = 'readonly+' + url
5659
t = transport.get_transport_from_url(url)
5660
protocol(t, listen, port, inet, client_timeout)
4915
transport = get_transport(url)
4916
protocol(transport, host, port, inet)
5663
4919
class cmd_join(Command):
6199
5434
takes_args = ['location?']
6200
5435
takes_options = [
6201
5436
RegistryOption.from_kwargs(
6204
help='The relation between branch and tree.',
5438
title='Target type',
5439
help='The type to reconfigure the directory to.',
6205
5440
value_switches=True, enum_switch=False,
6206
5441
branch='Reconfigure to be an unbound branch with no working tree.',
6207
5442
tree='Reconfigure to be an unbound branch with a working tree.',
6208
5443
checkout='Reconfigure to be a bound branch with a working tree.',
6209
5444
lightweight_checkout='Reconfigure to be a lightweight'
6210
' checkout (with no local history).',
6212
RegistryOption.from_kwargs(
6214
title='Repository type',
6215
help='Location fo the repository.',
6216
value_switches=True, enum_switch=False,
5445
' checkout (with no local history).',
6217
5446
standalone='Reconfigure to be a standalone branch '
6218
'(i.e. stop using shared repository).',
5447
'(i.e. stop using shared repository).',
6219
5448
use_shared='Reconfigure to use a shared repository.',
6221
RegistryOption.from_kwargs(
6223
title='Trees in Repository',
6224
help='Whether new branches in the repository have trees.',
6225
value_switches=True, enum_switch=False,
6226
5449
with_trees='Reconfigure repository to create '
6227
'working trees on branches by default.',
5450
'working trees on branches by default.',
6228
5451
with_no_trees='Reconfigure repository to not create '
6229
'working trees on branches by default.'
5452
'working trees on branches by default.'
6231
Option('bind-to', help='Branch to bind checkout to.', type=text_type),
5454
Option('bind-to', help='Branch to bind checkout to.', type=str),
6232
5455
Option('force',
6233
help='Perform reconfiguration even if local changes'
5456
help='Perform reconfiguration even if local changes'
6235
5458
Option('stacked-on',
6236
help='Reconfigure a branch to be stacked on another branch.',
5459
help='Reconfigure a branch to be stacked on another branch.',
6239
5462
Option('unstacked',
6240
help='Reconfigure a branch to be unstacked. This '
6241
'may require copying substantial data into it.',
5463
help='Reconfigure a branch to be unstacked. This '
5464
'may require copying substantial data into it.',
6245
def run(self, location=None, bind_to=None, force=False,
6246
tree_type=None, repository_type=None, repository_trees=None,
6247
stacked_on=None, unstacked=None):
6248
directory = controldir.ControlDir.open(location)
5468
def run(self, location=None, target_type=None, bind_to=None, force=False,
5471
directory = bzrdir.BzrDir.open(location)
6249
5472
if stacked_on and unstacked:
6250
raise errors.BzrCommandError(
6251
gettext("Can't use both --stacked-on and --unstacked"))
5473
raise BzrCommandError("Can't use both --stacked-on and --unstacked")
6252
5474
elif stacked_on is not None:
6253
5475
reconfigure.ReconfigureStackedOn().apply(directory, stacked_on)
6254
5476
elif unstacked:
6322
5533
takes_args = ['to_location?']
6323
takes_options = ['directory',
6325
help='Switch even if local commits will be lost.'),
5534
takes_options = [Option('force',
5535
help='Switch even if local commits will be lost.'),
6327
5537
Option('create-branch', short_name='b',
6328
help='Create the target branch from this one before'
6329
' switching to it.'),
6331
help='Store and restore uncommitted changes in the'
5538
help='Create the target branch from this one before'
5539
' switching to it.'),
6335
5542
def run(self, to_location=None, force=False, create_branch=False,
6336
revision=None, directory=u'.', store=False):
6337
from . import switch
6338
tree_location = directory
5544
from bzrlib import switch
6339
5546
revision = _get_one_revision('switch', revision)
6340
control_dir = controldir.ControlDir.open_containing(tree_location)[0]
6341
possible_transports = [control_dir.root_transport]
5547
control_dir = bzrdir.BzrDir.open_containing(tree_location)[0]
6342
5548
if to_location is None:
6343
5549
if revision is None:
6344
raise errors.BzrCommandError(gettext('You must supply either a'
6345
' revision or a location'))
6346
to_location = tree_location
5550
raise errors.BzrCommandError('You must supply either a'
5551
' revision or a location')
6348
branch = control_dir.open_branch(
6349
possible_transports=possible_transports)
5554
branch = control_dir.open_branch()
6350
5555
had_explicit_nick = branch.get_config().has_explicit_nickname()
6351
5556
except errors.NotBranchError:
6353
5558
had_explicit_nick = False
6355
possible_transports.append(branch.user_transport)
6356
5559
if create_branch:
6357
5560
if branch is None:
6358
raise errors.BzrCommandError(
6359
gettext('cannot create branch without source branch'))
6360
to_location = lookup_new_sibling_branch(
6361
control_dir, to_location,
6362
possible_transports=possible_transports)
6363
if revision is not None:
6364
revision = revision.as_revision_id(branch)
6365
to_branch = branch.controldir.sprout(
6367
possible_transports=possible_transports,
6368
revision_id=revision,
6369
source_branch=branch).open_branch()
5561
raise errors.BzrCommandError('cannot create branch without'
5563
to_location = directory_service.directories.dereference(
5565
if '/' not in to_location and '\\' not in to_location:
5566
# This path is meant to be relative to the existing branch
5567
this_url = self._get_branch_location(control_dir)
5568
to_location = urlutils.join(this_url, '..', to_location)
5569
to_branch = branch.bzrdir.sprout(to_location,
5570
possible_transports=[branch.bzrdir.root_transport],
5571
source_branch=branch).open_branch()
5574
to_branch = Branch.open(to_location)
5575
except errors.NotBranchError:
5576
this_url = self._get_branch_location(control_dir)
6372
5577
to_branch = Branch.open(
6373
to_location, possible_transports=possible_transports)
6374
except errors.NotBranchError:
6375
to_branch = open_sibling_branch(
6376
control_dir, to_location,
6377
possible_transports=possible_transports)
6378
if revision is not None:
6379
revision = revision.as_revision_id(to_branch)
6380
possible_transports.append(to_branch.user_transport)
6382
switch.switch(control_dir, to_branch, force, revision_id=revision,
6383
store_uncommitted=store,
6384
possible_transports=possible_transports)
6385
except controldir.BranchReferenceLoop:
6386
raise errors.BzrCommandError(
6387
gettext('switching would create a branch reference loop. '
6388
'Use the "bzr up" command to switch to a '
6389
'different revision.'))
5578
urlutils.join(this_url, '..', to_location))
5579
if revision is not None:
5580
revision = revision.as_revision_id(to_branch)
5581
switch.switch(control_dir, to_branch, force, revision_id=revision)
6390
5582
if had_explicit_nick:
6391
branch = control_dir.open_branch() # get the new branch!
5583
branch = control_dir.open_branch() #get the new branch!
6392
5584
branch.nick = to_branch.nick
6394
if to_branch.controldir.control_url != control_dir.control_url:
6395
note(gettext('Switched to branch %s at %s'),
6396
to_branch.name, urlutils.unescape_for_display(to_branch.base, 'utf-8'))
5585
note('Switched to branch: %s',
5586
urlutils.unescape_for_display(to_branch.base, 'utf-8'))
5588
def _get_branch_location(self, control_dir):
5589
"""Return location of branch for this control dir."""
5591
this_branch = control_dir.open_branch()
5592
# This may be a heavy checkout, where we want the master branch
5593
master_location = this_branch.get_bound_location()
5594
if master_location is not None:
5595
return master_location
5596
# If not, use a local sibling
5597
return this_branch.base
5598
except errors.NotBranchError:
5599
format = control_dir.find_branch_format()
5600
if getattr(format, 'get_reference', None) is not None:
5601
return format.get_reference(control_dir)
6398
note(gettext('Switched to branch %s'), to_branch.name)
6400
note(gettext('Switched to branch at %s'),
6401
urlutils.unescape_for_display(to_branch.base, 'utf-8'))
5603
return control_dir.root_transport.base
6404
5606
class cmd_view(Command):
6788
5956
takes_args = ['path?', 'location?']
6791
Option('force-unversioned',
6792
help='Set reference even if path is not versioned.'),
6795
def run(self, path=None, directory='.', location=None, force_unversioned=False):
6796
tree, branch, relpath = (
6797
controldir.ControlDir.open_containing_tree_or_branch(directory))
5958
def run(self, path=None, location=None):
5960
if path is not None:
5962
tree, branch, relpath =(
5963
bzrdir.BzrDir.open_containing_tree_or_branch(branchdir))
5964
if path is not None:
6798
5966
if tree is None:
6799
5967
tree = branch.basis_tree()
6800
5968
if path is None:
6801
with tree.lock_read():
6803
(path, tree.get_reference_info(path, branch))
6804
for path in tree.iter_references()]
6805
self._display_reference_info(tree, branch, info)
5969
info = branch._get_all_reference_info().iteritems()
5970
self._display_reference_info(tree, branch, info)
6807
if not tree.is_versioned(path) and not force_unversioned:
5972
file_id = tree.path2id(path)
6808
5974
raise errors.NotVersionedError(path)
6809
5975
if location is None:
6810
info = [(path, tree.get_reference_info(path, branch))]
5976
info = [(file_id, branch.get_reference_info(file_id))]
6811
5977
self._display_reference_info(tree, branch, info)
6813
tree.set_reference_info(path, location)
5979
branch.set_reference_info(file_id, path, location)
6815
5981
def _display_reference_info(self, tree, branch, info):
6817
for path, location in info:
5983
for file_id, (path, location) in info:
5985
path = tree.id2path(file_id)
5986
except errors.NoSuchId:
6818
5988
ref_list.append((path, location))
6819
5989
for path, location in sorted(ref_list):
6820
5990
self.outf.write('%s %s\n' % (path, location))
6823
class cmd_export_pot(Command):
6824
__doc__ = """Export command helps and error messages in po format."""
6827
takes_options = [Option('plugin',
6828
help='Export help text from named command '
6829
'(defaults to all built in commands).',
6831
Option('include-duplicates',
6832
help='Output multiple copies of the same msgid '
6833
'string if it appears more than once.'),
6836
def run(self, plugin=None, include_duplicates=False):
6837
from .export_pot import export_pot
6838
export_pot(self.outf, plugin, include_duplicates)
6841
class cmd_import(Command):
6842
__doc__ = """Import sources from a directory, tarball or zip file
6844
This command will import a directory, tarball or zip file into a bzr
6845
tree, replacing any versioned files already present. If a directory is
6846
specified, it is used as the target. If the directory does not exist, or
6847
is not versioned, it is created.
6849
Tarballs may be gzip or bzip2 compressed. This is autodetected.
6851
If the tarball or zip has a single root directory, that directory is
6852
stripped when extracting the tarball. This is not done for directories.
6855
takes_args = ['source', 'tree?']
6857
def run(self, source, tree=None):
6858
from .upstream_import import do_import
6859
do_import(source, tree)
6862
class cmd_link_tree(Command):
6863
__doc__ = """Hardlink matching files to another tree.
6865
Only files with identical content and execute bit will be linked.
6868
takes_args = ['location']
6870
def run(self, location):
6871
from .transform import link_tree
6872
target_tree = WorkingTree.open_containing(".")[0]
6873
source_tree = WorkingTree.open(location)
6874
with target_tree.lock_write(), source_tree.lock_read():
6875
link_tree(target_tree, source_tree)
6878
class cmd_fetch_ghosts(Command):
6879
__doc__ = """Attempt to retrieve ghosts from another branch.
6881
If the other branch is not supplied, the last-pulled branch is used.
6885
aliases = ['fetch-missing']
6886
takes_args = ['branch?']
6887
takes_options = [Option('no-fix', help="Skip additional synchonization.")]
6889
def run(self, branch=None, no_fix=False):
6890
from .fetch_ghosts import GhostFetcher
6891
installed, failed = GhostFetcher.from_cmdline(branch).run()
6892
if len(installed) > 0:
6893
self.outf.write("Installed:\n")
6894
for rev in installed:
6895
self.outf.write(rev.decode('utf-8') + "\n")
6897
self.outf.write("Still missing:\n")
6899
self.outf.write(rev.decode('utf-8') + "\n")
6900
if not no_fix and len(installed) > 0:
6901
cmd_reconcile().run(".")
6904
class cmd_grep(Command):
6905
"""Print lines matching PATTERN for specified files and revisions.
6907
This command searches the specified files and revisions for a given
6908
pattern. The pattern is specified as a Python regular expressions[1].
6910
If the file name is not specified, the revisions starting with the
6911
current directory are searched recursively. If the revision number is
6912
not specified, the working copy is searched. To search the last committed
6913
revision, use the '-r -1' or '-r last:1' option.
6915
Unversioned files are not searched unless explicitly specified on the
6916
command line. Unversioned directores are not searched.
6918
When searching a pattern, the output is shown in the 'filepath:string'
6919
format. If a revision is explicitly searched, the output is shown as
6920
'filepath~N:string', where N is the revision number.
6922
--include and --exclude options can be used to search only (or exclude
6923
from search) files with base name matches the specified Unix style GLOB
6924
pattern. The GLOB pattern an use *, ?, and [...] as wildcards, and \\
6925
to quote wildcard or backslash character literally. Note that the glob
6926
pattern is not a regular expression.
6928
[1] http://docs.python.org/library/re.html#regular-expression-syntax
6931
encoding_type = 'replace'
6932
takes_args = ['pattern', 'path*']
6936
Option('color', type=text_type, argname='when',
6937
help='Show match in color. WHEN is never, always or auto.'),
6938
Option('diff', short_name='p',
6939
help='Grep for pattern in changeset for each revision.'),
6940
ListOption('exclude', type=text_type, argname='glob', short_name='X',
6941
help="Skip files whose base name matches GLOB."),
6942
ListOption('include', type=text_type, argname='glob', short_name='I',
6943
help="Search only files whose base name matches GLOB."),
6944
Option('files-with-matches', short_name='l',
6945
help='Print only the name of each input file in '
6946
'which PATTERN is found.'),
6947
Option('files-without-match', short_name='L',
6948
help='Print only the name of each input file in '
6949
'which PATTERN is not found.'),
6950
Option('fixed-string', short_name='F',
6951
help='Interpret PATTERN is a single fixed string (not regex).'),
6953
help='Search for pattern starting from the root of the branch. '
6954
'(implies --recursive)'),
6955
Option('ignore-case', short_name='i',
6956
help='Ignore case distinctions while matching.'),
6958
help='Number of levels to display - 0 for all, 1 for collapsed '
6961
type=_parse_levels),
6962
Option('line-number', short_name='n',
6963
help='Show 1-based line number.'),
6964
Option('no-recursive',
6965
help="Don't recurse into subdirectories. (default is --recursive)"),
6966
Option('null', short_name='Z',
6967
help='Write an ASCII NUL (\\0) separator '
6968
'between output lines rather than a newline.'),
6972
def run(self, verbose=False, ignore_case=False, no_recursive=False,
6973
from_root=False, null=False, levels=None, line_number=False,
6974
path_list=None, revision=None, pattern=None, include=None,
6975
exclude=None, fixed_string=False, files_with_matches=False,
6976
files_without_match=False, color=None, diff=False):
6977
from breezy import _termcolor
6980
if path_list is None:
6984
raise errors.BzrCommandError(
6985
'cannot specify both --from-root and PATH.')
6987
if files_with_matches and files_without_match:
6988
raise errors.BzrCommandError(
6989
'cannot specify both '
6990
'-l/--files-with-matches and -L/--files-without-matches.')
6992
global_config = _mod_config.GlobalConfig()
6995
color = global_config.get_user_option('grep_color')
7000
if color not in ['always', 'never', 'auto']:
7001
raise errors.BzrCommandError('Valid values for --color are '
7002
'"always", "never" or "auto".')
7008
if revision is not None or levels == 0:
7009
# print revision numbers as we may be showing multiple revisions
7016
if not ignore_case and grep.is_fixed_string(pattern):
7017
# if the pattern isalnum, implicitly use to -F for faster grep
7019
elif ignore_case and fixed_string:
7020
# GZ 2010-06-02: Fall back to regexp rather than lowercasing
7021
# pattern and text which will cause pain later
7022
fixed_string = False
7023
pattern = re.escape(pattern)
7026
re_flags = re.MULTILINE
7028
re_flags |= re.IGNORECASE
7030
if not fixed_string:
7031
patternc = grep.compile_pattern(
7032
pattern.encode(grep._user_encoding), re_flags)
7034
if color == 'always':
7036
elif color == 'never':
7038
elif color == 'auto':
7039
show_color = _termcolor.allow_color()
7041
opts = grep.GrepOptions()
7043
opts.verbose = verbose
7044
opts.ignore_case = ignore_case
7045
opts.no_recursive = no_recursive
7046
opts.from_root = from_root
7048
opts.levels = levels
7049
opts.line_number = line_number
7050
opts.path_list = path_list
7051
opts.revision = revision
7052
opts.pattern = pattern
7053
opts.include = include
7054
opts.exclude = exclude
7055
opts.fixed_string = fixed_string
7056
opts.files_with_matches = files_with_matches
7057
opts.files_without_match = files_without_match
7061
opts.eol_marker = eol_marker
7062
opts.print_revno = print_revno
7063
opts.patternc = patternc
7064
opts.recursive = not no_recursive
7065
opts.fixed_string = fixed_string
7066
opts.outf = self.outf
7067
opts.show_color = show_color
7071
# files_with_matches, files_without_match
7072
# levels(?), line_number, from_root
7074
# These are silently ignored.
7075
grep.grep_diff(opts)
7076
elif revision is None:
7077
grep.workingtree_grep(opts)
7079
grep.versioned_grep(opts)
7082
class cmd_patch(Command):
7083
"""Apply a named patch to the current tree.
7087
takes_args = ['filename?']
7088
takes_options = [Option('strip', type=int, short_name='p',
7089
help=("Strip the smallest prefix containing num "
7090
"leading slashes from filenames.")),
7091
Option('silent', help='Suppress chatter.')]
7093
def run(self, filename=None, strip=None, silent=False):
7094
from .patch import patch_tree
7095
wt = WorkingTree.open_containing('.')[0]
7099
if filename is None:
7100
my_file = getattr(sys.stdin, 'buffer', sys.stdin)
7102
my_file = open(filename, 'rb')
7103
patches = [my_file.read()]
7104
return patch_tree(wt, patches, strip, quiet=is_quiet(), out=self.outf)
7107
class cmd_resolve_location(Command):
7108
__doc__ = """Expand a location to a full URL.
7111
Look up a Launchpad URL.
7113
brz resolve-location lp:brz
7115
takes_args = ['location']
7118
def run(self, location):
7119
from .location import location_to_url
7120
url = location_to_url(location)
7121
display_url = urlutils.unescape_for_display(url, self.outf.encoding)
7122
self.outf.write('%s\n' % display_url)
7125
5993
def _register_lazy_builtins():
7126
5994
# register lazy builtins from other modules; called at startup and should
7127
5995
# be only called once.
7128
5996
for (name, aliases, module_name) in [
7129
('cmd_bisect', [], 'breezy.bisect'),
7130
('cmd_bundle_info', [], 'breezy.bzr.bundle.commands'),
7131
('cmd_config', [], 'breezy.config'),
7132
('cmd_dump_btree', [], 'breezy.bzr.debug_commands'),
7133
('cmd_file_id', [], 'breezy.bzr.debug_commands'),
7134
('cmd_file_path', [], 'breezy.bzr.debug_commands'),
7135
('cmd_version_info', [], 'breezy.cmd_version_info'),
7136
('cmd_resolve', ['resolved'], 'breezy.conflicts'),
7137
('cmd_conflicts', [], 'breezy.conflicts'),
7138
('cmd_ping', [], 'breezy.bzr.smart.ping'),
7139
('cmd_sign_my_commits', [], 'breezy.commit_signature_commands'),
7140
('cmd_verify_signatures', [], 'breezy.commit_signature_commands'),
7141
('cmd_test_script', [], 'breezy.cmd_test_script'),
5997
('cmd_bundle_info', [], 'bzrlib.bundle.commands'),
5998
('cmd_dpush', [], 'bzrlib.foreign'),
5999
('cmd_version_info', [], 'bzrlib.cmd_version_info'),
6000
('cmd_resolve', ['resolved'], 'bzrlib.conflicts'),
6001
('cmd_conflicts', [], 'bzrlib.conflicts'),
6002
('cmd_sign_my_commits', [], 'bzrlib.sign_my_commits'),
7143
6004
builtin_command_registry.register_lazy(name, aliases, module_name)