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.'),
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']
1475
1201
def run(self, from_location, to_location=None, revision=None,
1476
1202
hardlink=False, stacked=False, standalone=False, no_tree=False,
1477
use_existing_dir=False, switch=False, bind=False,
1478
files_from=None, no_recurse_nested=False):
1479
from breezy import switch as _mod_switch
1480
accelerator_tree, br_from = controldir.ControlDir.open_tree_or_branch(
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(
1482
if no_recurse_nested:
1486
if not (hardlink or files_from):
1487
# accelerator_tree is usually slower because you have to read N
1488
# files (no readahead, lots of seeks, etc), but allow the user to
1489
# explicitly request it
1490
accelerator_tree = None
1491
if files_from is not None and files_from != from_location:
1492
accelerator_tree = WorkingTree.open(files_from)
1493
1208
revision = _get_one_revision('branch', revision)
1494
self.enter_context(br_from.lock_read())
1209
self.add_cleanup(br_from.lock_read().unlock)
1495
1210
if revision is not None:
1496
1211
revision_id = revision.as_revision_id(br_from)
1501
1216
revision_id = br_from.last_revision()
1502
1217
if to_location is None:
1503
1218
to_location = urlutils.derive_to_location(from_location)
1504
to_transport = transport.get_transport(to_location, purpose='write')
1219
to_transport = transport.get_transport(to_location)
1506
1221
to_transport.mkdir('.')
1507
1222
except errors.FileExists:
1509
to_dir = controldir.ControlDir.open_from_transport(
1511
except errors.NotBranchError:
1512
if not use_existing_dir:
1513
raise errors.BzrCommandError(gettext('Target directory "%s" '
1514
'already exists.') % to_location)
1223
if not use_existing_dir:
1224
raise errors.BzrCommandError('Target directory "%s" '
1225
'already exists.' % to_location)
1519
to_dir.open_branch()
1228
bzrdir.BzrDir.open_from_transport(to_transport)
1520
1229
except errors.NotBranchError:
1523
1232
raise errors.AlreadyBranchError(to_location)
1524
1233
except errors.NoSuchFile:
1525
raise errors.BzrCommandError(gettext('Parent of "%s" does not exist.')
1234
raise errors.BzrCommandError('Parent of "%s" does not exist.'
1531
# preserve whatever source format we have.
1532
to_dir = br_from.controldir.sprout(
1533
to_transport.base, revision_id,
1534
possible_transports=[to_transport],
1535
accelerator_tree=accelerator_tree, hardlink=hardlink,
1536
stacked=stacked, force_new_repo=standalone,
1537
create_tree_if_local=not no_tree, source_branch=br_from,
1539
branch = to_dir.open_branch(
1540
possible_transports=[
1541
br_from.controldir.root_transport, to_transport])
1542
except errors.NoSuchRevision:
1543
to_transport.delete_tree('.')
1544
msg = gettext("The branch {0} has no revision {1}.").format(
1545
from_location, revision)
1546
raise errors.BzrCommandError(msg)
1549
to_repo = to_dir.open_repository()
1550
except errors.NoRepositoryPresent:
1551
to_repo = to_dir.create_repository()
1552
to_repo.fetch(br_from.repository, revision_id=revision_id)
1553
branch = br_from.sprout(
1554
to_dir, revision_id=revision_id)
1555
br_from.tags.merge_to(branch.tags)
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)
1557
1252
# If the source branch is stacked, the new branch may
1558
1253
# be stacked whether we asked for that explicitly or not.
1559
1254
# We therefore need a try/except here and not just 'if stacked:'
1561
note(gettext('Created new stacked branch referring to %s.') %
1562
branch.get_stacked_on_url())
1563
except (errors.NotStacked, _mod_branch.UnstackableBranchFormat,
1564
errors.UnstackableRepositoryFormat) as e:
1565
revno = branch.revno()
1566
if revno is not None:
1567
note(ngettext('Branched %d revision.',
1568
'Branched %d revisions.',
1569
branch.revno()) % revno)
1571
note(gettext('Created new branch.'))
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())
1573
1262
# Bind to the parent
1574
1263
parent_branch = Branch.open(from_location)
1575
1264
branch.bind(parent_branch)
1576
note(gettext('New branch bound to %s') % from_location)
1265
note('New branch bound to %s' % from_location)
1578
1267
# Switch to the new branch
1579
1268
wt, _ = WorkingTree.open_containing('.')
1580
_mod_switch.switch(wt.controldir, branch)
1581
note(gettext('Switched to branch: %s'),
1582
urlutils.unescape_for_display(branch.base, 'utf-8'))
1585
class cmd_branches(Command):
1586
__doc__ = """List the branches available at the current location.
1588
This command will print the names of all the branches at the current
1592
takes_args = ['location?']
1594
Option('recursive', short_name='R',
1595
help='Recursively scan for branches rather than '
1596
'just looking in the specified location.')]
1598
def run(self, location=".", recursive=False):
1600
t = transport.get_transport(location, purpose='read')
1601
if not t.listable():
1602
raise errors.BzrCommandError(
1603
"Can't scan this type of location.")
1604
for b in controldir.ControlDir.find_branches(t):
1605
self.outf.write("%s\n" % urlutils.unescape_for_display(
1606
urlutils.relative_url(t.base, b.base),
1607
self.outf.encoding).rstrip("/"))
1609
dir = controldir.ControlDir.open_containing(location)[0]
1611
active_branch = dir.open_branch(name="")
1612
except errors.NotBranchError:
1613
active_branch = None
1615
for name, branch in iter_sibling_branches(dir):
1618
active = (active_branch is not None and
1619
active_branch.user_url == branch.user_url)
1620
names[name] = active
1621
# Only mention the current branch explicitly if it's not
1622
# one of the colocated branches
1623
if not any(viewvalues(names)) and active_branch is not None:
1624
self.outf.write("* %s\n" % gettext("(default)"))
1625
for name in sorted(names):
1626
active = names[name]
1631
self.outf.write("%s %s\n" % (
1632
prefix, (name if PY3 else name.encode(self.outf.encoding))))
1269
_mod_switch.switch(wt.bzrdir, branch)
1270
note('Switched to branch: %s',
1271
urlutils.unescape_for_display(branch.base, 'utf-8'))
1635
1274
class cmd_checkout(Command):
1636
1275
__doc__ = """Create a new checkout of an existing branch.
1638
If BRANCH_LOCATION is omitted, checkout will reconstitute a working tree
1639
for the branch found in '.'. This is useful if you have removed the working
1640
tree or if it was never created - i.e. if you pushed the branch to its
1641
current location using SFTP.
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.
1643
If the TO_LOCATION is omitted, the last component of the BRANCH_LOCATION
1644
will be used. In other words, "checkout ../foo/bar" will attempt to create
1645
./bar. If the BRANCH_LOCATION has no / or path separator embedded, the
1646
TO_LOCATION is derived from the BRANCH_LOCATION by stripping a leading
1647
scheme or drive identifier, if any. For example, "checkout lp:foo-bar" will
1648
attempt to create ./foo-bar.
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
1650
1289
To retrieve the branch as of a particular revision, supply the --revision
1651
parameter, as in "checkout foo/bar -r 5". Note that this will be
1652
immediately out of date [so you cannot commit] but it may be useful (i.e.
1653
to examine old code.)
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
1656
_see_also = ['checkouts', 'branch', 'working-trees', 'remove-tree']
1295
_see_also = ['checkouts', 'branch']
1657
1296
takes_args = ['branch_location?', 'to_location?']
1658
1297
takes_options = ['revision',
1659
1298
Option('lightweight',
1749
1357
@display_command
1750
1358
def run(self, dir=u'.'):
1751
1359
tree = WorkingTree.open_containing(dir)[0]
1752
self.enter_context(tree.lock_read())
1360
self.add_cleanup(tree.lock_read().unlock)
1361
new_inv = tree.inventory
1753
1362
old_tree = tree.basis_tree()
1754
self.enter_context(old_tree.lock_read())
1363
self.add_cleanup(old_tree.lock_read().unlock)
1364
old_inv = old_tree.inventory
1756
1366
iterator = tree.iter_changes(old_tree, include_unchanged=True)
1757
for change in iterator:
1758
if change.path[0] == change.path[1]:
1760
if None in change.path:
1762
renames.append(change.path)
1367
for f, paths, c, v, p, n, k, e in iterator:
1368
if paths[0] == paths[1]:
1372
renames.append(paths)
1764
1374
for old_name, new_name in renames:
1765
1375
self.outf.write("%s => %s\n" % (old_name, new_name))
1768
1378
class cmd_update(Command):
1769
__doc__ = """Update a working tree to a new revision.
1771
This will perform a merge of the destination revision (the tip of the
1772
branch, or the specified revision) into the working tree, and then make
1773
that revision the basis revision for the working tree.
1775
You can use this to visit an older revision, or to update a working tree
1776
that is out of date from its branch.
1778
If there are any uncommitted changes in the tree, they will be carried
1779
across and remain as uncommitted changes after the update. To discard
1780
these changes, use 'brz revert'. The uncommitted changes may conflict
1781
with the changes brought in by the change in basis revision.
1783
If the tree's branch is bound to a master branch, brz will also update
1379
__doc__ = """Update a tree to have the latest code committed to its branch.
1381
This will perform a merge into the working tree, and may generate
1382
conflicts. If you have any local changes, you will still
1383
need to commit them after the update for the update to be complete.
1385
If you want to discard your local changes, you can just do a
1386
'bzr revert' instead of 'bzr commit' after the update.
1388
If the tree's branch is bound to a master branch, it will also update
1784
1389
the branch from the master.
1786
You cannot update just a single file or directory, because each Breezy
1787
working tree has just a single basis revision. If you want to restore a
1788
file that has been removed locally, use 'brz revert' instead of 'brz
1789
update'. If you want to restore a file to its state in a previous
1790
revision, use 'brz revert' with a '-r' option, or use 'brz cat' to write
1791
out the old content of that file to a new location.
1793
The 'dir' argument, if given, must be the location of the root of a
1794
working tree to update. By default, the working tree that contains the
1795
current working directory is used.
1798
1392
_see_also = ['pull', 'working-trees', 'status-flags']
1799
1393
takes_args = ['dir?']
1800
takes_options = ['revision',
1802
help="Show base revision text in conflicts."),
1394
takes_options = ['revision']
1804
1395
aliases = ['up']
1806
def run(self, dir=None, revision=None, show_base=None):
1397
def run(self, dir='.', revision=None):
1807
1398
if revision is not None and len(revision) != 1:
1808
raise errors.BzrCommandError(gettext(
1809
"brz update --revision takes exactly one revision"))
1811
tree = WorkingTree.open_containing('.')[0]
1813
tree, relpath = WorkingTree.open_containing(dir)
1816
raise errors.BzrCommandError(gettext(
1817
"brz update can only update a whole tree, "
1818
"not a file or subdirectory"))
1399
raise errors.BzrCommandError(
1400
"bzr update --revision takes exactly one revision")
1401
tree = WorkingTree.open_containing(dir)[0]
1819
1402
branch = tree.branch
1820
1403
possible_transports = []
1821
1404
master = branch.get_master_branch(
1822
1405
possible_transports=possible_transports)
1823
1406
if master is not None:
1824
1407
branch_location = master.base
1825
self.enter_context(tree.lock_write())
1827
1410
branch_location = tree.branch.base
1828
self.enter_context(tree.lock_tree_write())
1411
tree.lock_tree_write()
1412
self.add_cleanup(tree.unlock)
1829
1413
# get rid of the final '/' and be ready for display
1830
1414
branch_location = urlutils.unescape_for_display(
1831
1415
branch_location.rstrip('/'),
1917
1500
noise_level = get_verbosity_level()
1919
1502
noise_level = 0
1920
from .info import show_bzrdir_info
1921
show_bzrdir_info(controldir.ControlDir.open_containing(location)[0],
1503
from bzrlib.info import show_bzrdir_info
1504
show_bzrdir_info(bzrdir.BzrDir.open_containing(location)[0],
1922
1505
verbose=noise_level, outfile=self.outf)
1925
1508
class cmd_remove(Command):
1926
1509
__doc__ = """Remove files or directories.
1928
This makes Breezy stop tracking changes to the specified files. Breezy will
1929
delete them if they can easily be recovered using revert otherwise they
1930
will be backed up (adding an extension of the form .~#~). If no options or
1931
parameters are given Breezy will scan for files that are being tracked by
1932
Breezy but missing in your tree and stop tracking them for you.
1511
This makes bzr stop tracking changes to the specified files. bzr will delete
1512
them if they can easily be recovered using revert. If no options or
1513
parameters are given bzr will scan for files that are being tracked by bzr
1514
but missing in your tree and stop tracking them for you.
1934
1516
takes_args = ['file*']
1935
1517
takes_options = ['verbose',
1937
'new', help='Only remove files that have never been committed.'),
1938
RegistryOption.from_kwargs('file-deletion-strategy',
1939
'The file deletion mode to be used.',
1940
title='Deletion Strategy', value_switches=True, enum_switch=False,
1941
safe='Backup changed files (default).',
1942
keep='Delete from brz but leave the working copy.',
1943
no_backup='Don\'t backup changed files.'),
1518
Option('new', help='Only remove files that have never been committed.'),
1519
RegistryOption.from_kwargs('file-deletion-strategy',
1520
'The file deletion mode to be used.',
1521
title='Deletion Strategy', value_switches=True, enum_switch=False,
1522
safe='Only delete files if they can be'
1523
' safely recovered (default).',
1524
keep='Delete from bzr but leave the working copy.',
1525
force='Delete all the specified files, even if they can not be '
1526
'recovered and even if they are non-empty directories.')]
1945
1527
aliases = ['rm', 'del']
1946
1528
encoding_type = 'replace'
1948
1530
def run(self, file_list, verbose=False, new=False,
1949
file_deletion_strategy='safe'):
1951
tree, file_list = WorkingTree.open_containing_paths(file_list)
1531
file_deletion_strategy='safe'):
1532
tree, file_list = tree_files(file_list)
1953
1534
if file_list is not None:
1954
1535
file_list = [f for f in file_list]
1956
self.enter_context(tree.lock_write())
1537
self.add_cleanup(tree.lock_write().unlock)
1957
1538
# Heuristics should probably all move into tree.remove_smart or
1960
1541
added = tree.changes_from(tree.basis_tree(),
1961
specific_files=file_list).added
1962
file_list = sorted([f.path[1] for f in added], reverse=True)
1542
specific_files=file_list).added
1543
file_list = sorted([f[0] for f in added], reverse=True)
1963
1544
if len(file_list) == 0:
1964
raise errors.BzrCommandError(gettext('No matching files.'))
1545
raise errors.BzrCommandError('No matching files.')
1965
1546
elif file_list is None:
1966
1547
# missing files show up in iter_changes(basis) as
1967
1548
# versioned-with-no-kind.
1969
1550
for change in tree.iter_changes(tree.basis_tree()):
1970
1551
# Find paths in the working tree that have no kind:
1971
if change.path[1] is not None and change.kind[1] is None:
1972
missing.append(change.path[1])
1552
if change[1][1] is not None and change[6][1] is None:
1553
missing.append(change[1][1])
1973
1554
file_list = sorted(missing, reverse=True)
1974
1555
file_deletion_strategy = 'keep'
1975
1556
tree.remove(file_list, verbose=verbose, to_file=self.outf,
1976
keep_files=file_deletion_strategy == 'keep',
1977
force=(file_deletion_strategy == 'no-backup'))
1557
keep_files=file_deletion_strategy=='keep',
1558
force=file_deletion_strategy=='force')
1561
class cmd_file_id(Command):
1562
__doc__ = """Print file_id of a particular file or directory.
1564
The file_id is assigned when the file is first added and remains the
1565
same through all revisions where the file exists, even when it is
1570
_see_also = ['inventory', 'ls']
1571
takes_args = ['filename']
1574
def run(self, filename):
1575
tree, relpath = WorkingTree.open_containing(filename)
1576
i = tree.path2id(relpath)
1578
raise errors.NotVersionedError(filename)
1580
self.outf.write(i + '\n')
1583
class cmd_file_path(Command):
1584
__doc__ = """Print path of file_ids to a file or directory.
1586
This prints one line for each directory down to the target,
1587
starting at the branch root.
1591
takes_args = ['filename']
1594
def run(self, filename):
1595
tree, relpath = WorkingTree.open_containing(filename)
1596
fid = tree.path2id(relpath)
1598
raise errors.NotVersionedError(filename)
1599
segments = osutils.splitpath(relpath)
1600
for pos in range(1, len(segments) + 1):
1601
path = osutils.joinpath(segments[:pos])
1602
self.outf.write("%s\n" % tree.path2id(path))
1980
1605
class cmd_reconcile(Command):
1981
__doc__ = """Reconcile brz metadata in a branch.
1606
__doc__ = """Reconcile bzr metadata in a branch.
1983
1608
This can correct data mismatches that may have been caused by
1984
previous ghost operations or brz upgrades. You should only
1985
need to run this command if 'brz check' or a brz developer
1609
previous ghost operations or bzr upgrades. You should only
1610
need to run this command if 'bzr check' or a bzr developer
1986
1611
advises you to run it.
1988
1613
If a second branch is provided, cross-branch reconciliation is
1989
1614
also attempted, which will check that data like the tree root
1990
id which was not present in very early brz versions is represented
1615
id which was not present in very early bzr versions is represented
1991
1616
correctly in both branches.
1993
1618
At the same time it is run it may recompress data resulting in
2123
1730
to_transport.ensure_base()
2124
1731
except errors.NoSuchFile:
2125
1732
if not create_prefix:
2126
raise errors.BzrCommandError(gettext("Parent directory of %s"
2128
"\nYou may supply --create-prefix to create all"
2129
" leading parent directories.")
1733
raise errors.BzrCommandError("Parent directory of %s"
1735
"\nYou may supply --create-prefix to create all"
1736
" leading parent directories."
2131
1738
to_transport.create_prefix()
2134
a_controldir = controldir.ControlDir.open_from_transport(
1741
a_bzrdir = bzrdir.BzrDir.open_from_transport(to_transport)
2136
1742
except errors.NotBranchError:
2137
1743
# really a NotBzrDir error...
2138
create_branch = controldir.ControlDir.create_branch_convenience
2140
force_new_tree = False
2142
force_new_tree = None
1744
create_branch = bzrdir.BzrDir.create_branch_convenience
2143
1745
branch = create_branch(to_transport.base, format=format,
2144
possible_transports=[to_transport],
2145
force_new_tree=force_new_tree)
2146
a_controldir = branch.controldir
1746
possible_transports=[to_transport])
1747
a_bzrdir = branch.bzrdir
2148
from .transport.local import LocalTransport
2149
if a_controldir.has_branch():
1749
from bzrlib.transport.local import LocalTransport
1750
if a_bzrdir.has_branch():
2150
1751
if (isinstance(to_transport, LocalTransport)
2151
and not a_controldir.has_workingtree()):
2152
raise errors.BranchExistsWithoutWorkingTree(location)
1752
and not a_bzrdir.has_workingtree()):
1753
raise errors.BranchExistsWithoutWorkingTree(location)
2153
1754
raise errors.AlreadyBranchError(location)
2154
branch = a_controldir.create_branch()
2155
if not no_tree and not a_controldir.has_workingtree():
2156
a_controldir.create_workingtree()
1755
branch = a_bzrdir.create_branch()
1756
a_bzrdir.create_workingtree()
2157
1757
if append_revisions_only:
2159
1759
branch.set_append_revisions_only(True)
2160
1760
except errors.UpgradeRequired:
2161
raise errors.BzrCommandError(gettext('This branch format cannot be set'
2162
' to append-revisions-only. Try --default.'))
1761
raise errors.BzrCommandError('This branch format cannot be set'
1762
' to append-revisions-only. Try --default.')
2163
1763
if not is_quiet():
2164
from .info import describe_layout, describe_format
1764
from bzrlib.info import describe_layout, describe_format
2166
tree = a_controldir.open_workingtree(recommend_upgrade=False)
1766
tree = a_bzrdir.open_workingtree(recommend_upgrade=False)
2167
1767
except (errors.NoWorkingTree, errors.NotLocalUrl):
2169
1769
repository = branch.repository
2170
1770
layout = describe_layout(repository, branch, tree).lower()
2171
format = describe_format(a_controldir, repository, branch, tree)
2172
self.outf.write(gettext("Created a {0} (format: {1})\n").format(
1771
format = describe_format(a_bzrdir, repository, branch, tree)
1772
self.outf.write("Created a %s (format: %s)\n" % (layout, format))
2174
1773
if repository.is_shared():
2175
# XXX: maybe this can be refactored into transport.path_or_url()
2176
url = repository.controldir.root_transport.external_url()
1774
#XXX: maybe this can be refactored into transport.path_or_url()
1775
url = repository.bzrdir.root_transport.external_url()
2178
1777
url = urlutils.local_path_from_url(url)
2179
except urlutils.InvalidURL:
1778
except errors.InvalidURL:
2181
self.outf.write(gettext("Using shared repository: %s\n") % url)
2184
class cmd_init_shared_repository(Command):
1780
self.outf.write("Using shared repository: %s\n" % url)
1783
class cmd_init_repository(Command):
2185
1784
__doc__ = """Create a shared repository for branches to share storage space.
2187
1786
New branches created under the repository directory will store their
2188
1787
revisions in the repository, not in the branch directory. For branches
2189
with shared history, this reduces the amount of storage needed and
1788
with shared history, this reduces the amount of storage needed and
2190
1789
speeds up the creation of new branches.
2192
1791
If the --no-trees option is given then the branches in the repository
2193
will not have working trees by default. They will still exist as
2194
directories on disk, but they will not have separate copies of the
1792
will not have working trees by default. They will still exist as
1793
directories on disk, but they will not have separate copies of the
2195
1794
files at a certain revision. This can be useful for repositories that
2196
1795
store branches which are interacted with through checkouts or remote
2197
1796
branches, such as on a server.
2280
1863
Shows the difference in the working tree versus the last commit::
2284
1867
Difference between the working tree and revision 1::
2288
1871
Difference between revision 3 and revision 1::
2292
1875
Difference between revision 3 and revision 1 for branch xxx::
2296
The changes introduced by revision 2 (equivalent to -r1..2)::
2300
To see the changes introduced by revision X::
1879
To see the changes introduced in revision X::
2304
1883
Note that in the case of a merge, the -c option shows the changes
2305
1884
compared to the left hand parent. To see the changes against
2306
1885
another parent, use::
2308
brz diff -r<chosen_parent>..X
2310
The changes between the current revision and the previous revision
2311
(equivalent to -c-1 and -r-2..-1)
1887
bzr diff -r<chosen_parent>..X
1889
The changes introduced by revision 2 (equivalent to -r1..2)::
2315
1893
Show just the differences for file NEWS::
2319
1897
Show the differences in working tree xxx for file NEWS::
2323
1901
Show the differences from branch xxx to this working tree:
2327
1905
Show the differences between two branches for file NEWS::
2329
brz diff --old xxx --new yyy NEWS
2331
Same as 'brz diff' but prefix paths with old/ and new/::
2333
brz diff --prefix old/:new/
2335
Show the differences using a custom diff program with options::
2337
brz diff --using /usr/bin/diff --diff-options -wu
1907
bzr diff --old xxx --new yyy NEWS
1909
Same as 'bzr diff' but prefix paths with old/ and new/::
1911
bzr diff --prefix old/:new/
2339
1913
_see_also = ['status']
2340
1914
takes_args = ['file*']
2341
1915
takes_options = [
2342
Option('diff-options', type=text_type,
1916
Option('diff-options', type=str,
2343
1917
help='Pass these options to the external diff program.'),
2344
Option('prefix', type=text_type,
1918
Option('prefix', type=str,
2345
1919
short_name='p',
2346
1920
help='Set prefixes added to old and new filenames, as '
2347
1921
'two values separated by a colon. (eg "old/:new/").'),
2349
help='Branch/tree to compare from.',
1923
help='Branch/tree to compare from.',
2353
help='Branch/tree to compare to.',
1927
help='Branch/tree to compare to.',
2358
1932
Option('using',
2359
help='Use this command to compare files.',
1933
help='Use this command to compare files.',
2362
1936
RegistryOption('format',
2364
help='Diff format to use.',
2365
lazy_registry=('breezy.diff', 'format_registry'),
2366
title='Diff format'),
2368
help='How many lines of context to show.',
2371
RegistryOption.from_kwargs(
2373
help='Color mode to use.',
2374
title='Color Mode', value_switches=False, enum_switch=True,
2375
never='Never colorize output.',
2376
auto='Only colorize output if terminal supports it and STDOUT is a'
2378
always='Always colorize output (default).'),
2381
help=('Warn if trailing whitespace or spurious changes have been'
1937
help='Diff format to use.',
1938
lazy_registry=('bzrlib.diff', 'format_registry'),
1939
value_switches=False, title='Diff format'),
2385
1941
aliases = ['di', 'dif']
2386
1942
encoding_type = 'exact'
2388
1944
@display_command
2389
1945
def run(self, revision=None, file_list=None, diff_options=None,
2390
prefix=None, old=None, new=None, using=None, format=None,
2391
context=None, color='never'):
2392
from .diff import (get_trees_and_branches_to_diff_locked,
1946
prefix=None, old=None, new=None, using=None, format=None):
1947
from bzrlib.diff import (get_trees_and_branches_to_diff_locked,
1950
if (prefix is None) or (prefix == '0'):
2396
1951
# diff -p0 format
2399
elif prefix == u'1' or prefix is None:
2400
1955
old_label = 'old/'
2401
1956
new_label = 'new/'
2402
elif u':' in prefix:
2403
old_label, new_label = prefix.split(u":")
1958
old_label, new_label = prefix.split(":")
2405
raise errors.BzrCommandError(gettext(
1960
raise errors.BzrCommandError(
2406
1961
'--prefix expects two values separated by a colon'
2407
' (eg "old/:new/")'))
1962
' (eg "old/:new/")')
2409
1964
if revision and len(revision) > 2:
2410
raise errors.BzrCommandError(gettext('brz diff --revision takes exactly'
2411
' one or two revision specifiers'))
1965
raise errors.BzrCommandError('bzr diff --revision takes exactly'
1966
' one or two revision specifiers')
2413
1968
if using is not None and format is not None:
2414
raise errors.BzrCommandError(gettext(
2415
'{0} and {1} are mutually exclusive').format(
2416
'--using', '--format'))
1969
raise errors.BzrCommandError('--using and --format are mutually '
2418
1972
(old_tree, new_tree,
2419
1973
old_branch, new_branch,
2420
1974
specific_files, extra_trees) = get_trees_and_branches_to_diff_locked(
2421
file_list, revision, old, new, self._exit_stack, apply_view=True)
2422
# GNU diff on Windows uses ANSI encoding for filenames
2423
path_encoding = osutils.get_diff_header_encoding()
2426
from .terminal import has_ansi_colors
2427
if has_ansi_colors():
2431
if 'always' == color:
2432
from .colordiff import DiffWriter
2433
outf = DiffWriter(outf)
2434
return show_diff_trees(old_tree, new_tree, outf,
1975
file_list, revision, old, new, self.add_cleanup, apply_view=True)
1976
return show_diff_trees(old_tree, new_tree, sys.stdout,
2435
1977
specific_files=specific_files,
2436
1978
external_diff_options=diff_options,
2437
1979
old_label=old_label, new_label=new_label,
2438
extra_trees=extra_trees,
2439
path_encoding=path_encoding,
2440
using=using, context=context,
1980
extra_trees=extra_trees, using=using,
2441
1981
format_cls=format)
2705
2242
takes_args = ['file*']
2706
2243
_see_also = ['log-formats', 'revisionspec']
2707
2244
takes_options = [
2709
help='Show from oldest to newest.'),
2711
custom_help('verbose',
2712
help='Show files changed in each revision.'),
2716
type=breezy.option._parse_revision_str,
2718
help='Show just the specified revision.'
2719
' See also "help revisionspec".'),
2721
RegistryOption('authors',
2722
'What names to list as authors - first, all or committer.',
2725
'breezy.log', 'author_list_registry'),
2729
help='Number of levels to display - 0 for all, 1 for flat.',
2731
type=_parse_levels),
2733
help='Show revisions whose message matches this '
2734
'regular expression.',
2739
help='Limit the output to the first N revisions.',
2744
help='Show changes made in each revision as a patch.'),
2745
Option('include-merged',
2746
help='Show merged revisions like --levels 0 does.'),
2747
Option('include-merges', hidden=True,
2748
help='Historical alias for --include-merged.'),
2749
Option('omit-merges',
2750
help='Do not report commits with more than one parent.'),
2751
Option('exclude-common-ancestry',
2752
help='Display only the revisions that are not part'
2753
' of both ancestries (require -rX..Y).'
2755
Option('signatures',
2756
help='Show digital signature validity.'),
2246
help='Show from oldest to newest.'),
2248
custom_help('verbose',
2249
help='Show files changed in each revision.'),
2253
type=bzrlib.option._parse_revision_str,
2255
help='Show just the specified revision.'
2256
' See also "help revisionspec".'),
2258
RegistryOption('authors',
2259
'What names to list as authors - first, all or committer.',
2261
lazy_registry=('bzrlib.log', 'author_list_registry'),
2265
help='Number of levels to display - 0 for all, 1 for flat.',
2267
type=_parse_levels),
2758
2269
short_name='m',
2759
help='Show revisions whose properties match this '
2762
ListOption('match-message',
2763
2270
help='Show revisions whose message matches this '
2766
ListOption('match-committer',
2767
help='Show revisions whose committer matches this '
2770
ListOption('match-author',
2771
help='Show revisions whose authors match this '
2774
ListOption('match-bugs',
2775
help='Show revisions whose bugs match this '
2271
'regular expression.',
2275
help='Limit the output to the first N revisions.',
2280
help='Show changes made in each revision as a patch.'),
2281
Option('include-merges',
2282
help='Show merged revisions like --levels 0 does.'),
2283
Option('exclude-common-ancestry',
2284
help='Display only the revisions that are not part'
2285
' of both ancestries (require -rX..Y)'
2779
2288
encoding_type = 'replace'
2781
2290
@display_command
3025
2502
_see_also = ['status', 'cat']
3026
2503
takes_args = ['path?']
3027
2504
takes_options = [
3030
Option('recursive', short_name='R',
3031
help='Recurse into subdirectories.'),
3033
help='Print paths relative to the root of the branch.'),
3034
Option('unknown', short_name='u',
3035
help='Print unknown files.'),
3036
Option('versioned', help='Print versioned files.',
3038
Option('ignored', short_name='i',
3039
help='Print ignored files.'),
3040
Option('kind', short_name='k',
3041
help=('List entries of a particular kind: file, '
3042
'directory, symlink, tree-reference.'),
2507
Option('recursive', short_name='R',
2508
help='Recurse into subdirectories.'),
2510
help='Print paths relative to the root of the branch.'),
2511
Option('unknown', short_name='u',
2512
help='Print unknown files.'),
2513
Option('versioned', help='Print versioned files.',
2515
Option('ignored', short_name='i',
2516
help='Print ignored files.'),
2517
Option('kind', short_name='k',
2518
help='List entries of a particular kind: file, directory, symlink.',
3049
2524
@display_command
3050
2525
def run(self, revision=None, verbose=False,
3051
2526
recursive=False, from_root=False,
3052
2527
unknown=False, versioned=False, ignored=False,
3053
2528
null=False, kind=None, show_ids=False, path=None, directory=None):
3055
if kind and kind not in ('file', 'directory', 'symlink', 'tree-reference'):
3056
raise errors.BzrCommandError(gettext('invalid kind specified'))
2530
if kind and kind not in ('file', 'directory', 'symlink'):
2531
raise errors.BzrCommandError('invalid kind specified')
3058
2533
if verbose and null:
3059
raise errors.BzrCommandError(
3060
gettext('Cannot set both --verbose and --null'))
2534
raise errors.BzrCommandError('Cannot set both --verbose and --null')
3061
2535
all = not (unknown or versioned or ignored)
3063
selection = {'I': ignored, '?': unknown, 'V': versioned}
2537
selection = {'I':ignored, '?':unknown, 'V':versioned}
3065
2539
if path is None:
3069
raise errors.BzrCommandError(gettext('cannot specify both --from-root'
2543
raise errors.BzrCommandError('cannot specify both --from-root'
3072
2546
tree, branch, relpath = \
3073
2547
_open_directory_or_containing_tree_or_branch(fs_path, directory)
3167
2641
After adding, editing or deleting that file either indirectly by
3168
2642
using this command or directly by using an editor, be sure to commit
3171
Breezy also supports a global ignore file ~/.config/breezy/ignore. On
3172
Windows the global ignore file can be found in the application data
3174
C:\\Documents and Settings\\<user>\\Application Data\\Breezy\\3.0\\ignore.
2645
Bazaar also supports a global ignore file ~/.bazaar/ignore. On Windows
2646
the global ignore file can be found in the application data directory as
2647
C:\\Documents and Settings\\<user>\\Application Data\\Bazaar\\2.0\\ignore.
3175
2648
Global ignores are not touched by this command. The global ignore file
3176
2649
can be edited directly using an editor.
3178
2651
Patterns prefixed with '!' are exceptions to ignore patterns and take
3179
2652
precedence over regular ignores. Such exceptions are used to specify
3180
2653
files that should be versioned which would otherwise be ignored.
3182
2655
Patterns prefixed with '!!' act as regular ignore patterns, but have
3183
2656
precedence over the '!' exception patterns.
3187
* Ignore patterns containing shell wildcards must be quoted from
3190
* Ignore patterns starting with "#" act as comments in the ignore file.
3191
To ignore patterns that begin with that character, use the "RE:" prefix.
2658
Note: ignore patterns containing shell wildcards must be quoted from
3194
2662
Ignore the top level Makefile::
3196
brz ignore ./Makefile
2664
bzr ignore ./Makefile
3198
2666
Ignore .class files in all directories...::
3200
brz ignore "*.class"
2668
bzr ignore "*.class"
3202
2670
...but do not ignore "special.class"::
3204
brz ignore "!special.class"
3206
Ignore files whose name begins with the "#" character::
3210
Ignore .o files under the lib directory::
3212
brz ignore "lib/**/*.o"
3214
Ignore .o files under the lib directory::
3216
brz ignore "RE:lib/.*\\.o"
2672
bzr ignore "!special.class"
2674
Ignore .o files under the lib directory::
2676
bzr ignore "lib/**/*.o"
2678
Ignore .o files under the lib directory::
2680
bzr ignore "RE:lib/.*\.o"
3218
2682
Ignore everything but the "debian" toplevel directory::
3220
brz ignore "RE:(?!debian/).*"
2684
bzr ignore "RE:(?!debian/).*"
3222
2686
Ignore everything except the "local" toplevel directory,
3223
but always ignore autosave files ending in ~, even under local/::
3226
brz ignore "!./local"
2687
but always ignore "*~" autosave files, even under local/::
2690
bzr ignore "!./local"
3230
2694
_see_also = ['status', 'ignored', 'patterns']
3231
2695
takes_args = ['name_pattern*']
3232
2696
takes_options = ['directory',
3233
Option('default-rules',
3234
help='Display the default ignore rules that brz uses.')
2697
Option('default-rules',
2698
help='Display the default ignore rules that bzr uses.')
3237
2701
def run(self, name_pattern_list=None, default_rules=None,
3238
2702
directory=u'.'):
3239
from breezy import ignores
2703
from bzrlib import ignores
3240
2704
if default_rules is not None:
3241
2705
# dump the default rules and exit
3242
2706
for pattern in ignores.USER_DEFAULTS:
3243
2707
self.outf.write("%s\n" % pattern)
3245
2709
if not name_pattern_list:
3246
raise errors.BzrCommandError(gettext("ignore requires at least one "
3247
"NAME_PATTERN or --default-rules."))
2710
raise errors.BzrCommandError("ignore requires at least one "
2711
"NAME_PATTERN or --default-rules.")
3248
2712
name_pattern_list = [globbing.normalize_pattern(p)
3249
2713
for p in name_pattern_list]
3251
bad_patterns_count = 0
3252
for p in name_pattern_list:
3253
if not globbing.Globster.is_pattern_valid(p):
3254
bad_patterns_count += 1
3255
bad_patterns += ('\n %s' % p)
3257
msg = (ngettext('Invalid ignore pattern found. %s',
3258
'Invalid ignore patterns found. %s',
3259
bad_patterns_count) % bad_patterns)
3260
ui.ui_factory.show_error(msg)
3261
raise lazy_regex.InvalidPattern('')
3262
2714
for name_pattern in name_pattern_list:
3263
2715
if (name_pattern[0] == '/' or
3264
(len(name_pattern) > 1 and name_pattern[1] == ':')):
3265
raise errors.BzrCommandError(gettext(
3266
"NAME_PATTERN should not be an absolute path"))
2716
(len(name_pattern) > 1 and name_pattern[1] == ':')):
2717
raise errors.BzrCommandError(
2718
"NAME_PATTERN should not be an absolute path")
3267
2719
tree, relpath = WorkingTree.open_containing(directory)
3268
2720
ignores.tree_ignores_add_patterns(tree, name_pattern_list)
3269
2721
ignored = globbing.Globster(name_pattern_list)
3271
self.enter_context(tree.lock_read())
3272
for filename, fc, fkind, entry in tree.list_files():
3273
id = getattr(entry, 'file_id', None)
2724
for entry in tree.list_files():
3274
2726
if id is not None:
3275
2728
if ignored.match(filename):
3276
2729
matches.append(filename)
3277
2731
if len(matches) > 0:
3278
self.outf.write(gettext("Warning: the following files are version "
3279
"controlled and match your ignore pattern:\n%s"
3280
"\nThese files will continue to be version controlled"
3281
" unless you 'brz remove' them.\n") % ("\n".join(matches),))
2732
self.outf.write("Warning: the following files are version controlled and"
2733
" match your ignore pattern:\n%s"
2734
"\nThese files will continue to be version controlled"
2735
" unless you 'bzr remove' them.\n" % ("\n".join(matches),))
3284
2738
class cmd_ignored(Command):
3359
2812
================= =========================
3362
encoding_type = 'exact'
3363
2814
takes_args = ['dest', 'branch_or_subdir?']
3364
2815
takes_options = ['directory',
3366
help="Type of file to export to.",
3369
Option('filters', help='Apply content filters to export the '
3370
'convenient form.'),
3373
help="Name of the root directory inside the exported file."),
3374
Option('per-file-timestamps',
3375
help='Set modification time of files to that of the last '
3376
'revision in which it was changed.'),
3377
Option('uncommitted',
3378
help='Export the working tree contents rather than that of the '
2817
help="Type of file to export to.",
2820
Option('filters', help='Apply content filters to export the '
2821
'convenient form.'),
2824
help="Name of the root directory inside the exported file."),
2825
Option('per-file-timestamps',
2826
help='Set modification time of files to that of the last '
2827
'revision in which it was changed.'),
3382
2829
def run(self, dest, branch_or_subdir=None, revision=None, format=None,
3383
root=None, filters=False, per_file_timestamps=False, uncommitted=False,
3385
from .export import export, guess_format, get_root_name
2830
root=None, filters=False, per_file_timestamps=False, directory=u'.'):
2831
from bzrlib.export import export
3387
2833
if branch_or_subdir is None:
3388
branch_or_subdir = directory
3390
(tree, b, subdir) = controldir.ControlDir.open_containing_tree_or_branch(
3392
if tree is not None:
3393
self.enter_context(tree.lock_read())
3397
raise errors.BzrCommandError(
3398
gettext("--uncommitted requires a working tree"))
3401
export_tree = _get_one_revision_tree(
3402
'export', revision, branch=b,
3406
format = guess_format(dest)
3409
root = get_root_name(dest)
3411
if not per_file_timestamps:
3412
force_mtime = time.time()
3417
from breezy.filter_tree import ContentFilterTree
3418
export_tree = ContentFilterTree(
3419
export_tree, export_tree._content_filter_stack)
2834
tree = WorkingTree.open_containing(directory)[0]
2838
b, subdir = Branch.open_containing(branch_or_subdir)
2841
rev_tree = _get_one_revision_tree('export', revision, branch=b, tree=tree)
3422
export(export_tree, dest, format, root, subdir,
2843
export(rev_tree, dest, format, root, subdir, filtered=filters,
3423
2844
per_file_timestamps=per_file_timestamps)
3424
except errors.NoSuchExportFormat as e:
3425
raise errors.BzrCommandError(
3426
gettext('Unsupported export format: %s') % e.format)
2845
except errors.NoSuchExportFormat, e:
2846
raise errors.BzrCommandError('Unsupported export format: %s' % e.format)
3429
2849
class cmd_cat(Command):
3450
2869
def run(self, filename, revision=None, name_from_revision=False,
3451
2870
filters=False, directory=None):
3452
2871
if revision is not None and len(revision) != 1:
3453
raise errors.BzrCommandError(gettext("brz cat --revision takes exactly"
3454
" one revision specifier"))
2872
raise errors.BzrCommandError("bzr cat --revision takes exactly"
2873
" one revision specifier")
3455
2874
tree, branch, relpath = \
3456
2875
_open_directory_or_containing_tree_or_branch(filename, directory)
3457
self.enter_context(branch.lock_read())
2876
self.add_cleanup(branch.lock_read().unlock)
3458
2877
return self._run(tree, branch, relpath, filename, revision,
3459
2878
name_from_revision, filters)
3461
2880
def _run(self, tree, b, relpath, filename, revision, name_from_revision,
3464
2882
if tree is None:
3465
2883
tree = b.basis_tree()
3466
2884
rev_tree = _get_one_revision_tree('cat', revision, branch=b)
3467
self.enter_context(rev_tree.lock_read())
2885
self.add_cleanup(rev_tree.lock_read().unlock)
2887
old_file_id = rev_tree.path2id(relpath)
3469
2889
if name_from_revision:
3470
2890
# Try in revision if requested
3471
if not rev_tree.is_versioned(relpath):
3472
raise errors.BzrCommandError(gettext(
3473
"{0!r} is not present in revision {1}").format(
2891
if old_file_id is None:
2892
raise errors.BzrCommandError(
2893
"%r is not present in revision %s" % (
3474
2894
filename, rev_tree.get_revision_id()))
3475
rev_tree_path = relpath
2896
content = rev_tree.get_file_text(old_file_id)
3478
rev_tree_path = _mod_tree.find_previous_path(
3479
tree, rev_tree, relpath)
3480
except errors.NoSuchFile:
3481
rev_tree_path = None
3483
if rev_tree_path is None:
3484
# Path didn't exist in working tree
3485
if not rev_tree.is_versioned(relpath):
3486
raise errors.BzrCommandError(gettext(
3487
"{0!r} is not present in revision {1}").format(
3488
filename, rev_tree.get_revision_id()))
3490
# Fall back to the same path in the basis tree, if present.
3491
rev_tree_path = relpath
2898
cur_file_id = tree.path2id(relpath)
2900
if cur_file_id is not None:
2901
# Then try with the actual file id
2903
content = rev_tree.get_file_text(cur_file_id)
2905
except errors.NoSuchId:
2906
# The actual file id didn't exist at that time
2908
if not found and old_file_id is not None:
2909
# Finally try with the old file id
2910
content = rev_tree.get_file_text(old_file_id)
2913
# Can't be found anywhere
2914
raise errors.BzrCommandError(
2915
"%r is not present in revision %s" % (
2916
filename, rev_tree.get_revision_id()))
3494
from .filter_tree import ContentFilterTree
3495
filter_tree = ContentFilterTree(
3496
rev_tree, rev_tree._content_filter_stack)
3497
fileobj = filter_tree.get_file(rev_tree_path)
2918
from bzrlib.filters import (
2919
ContentFilterContext,
2920
filtered_output_bytes,
2922
filters = rev_tree._content_filter_stack(relpath)
2923
chunks = content.splitlines(True)
2924
content = filtered_output_bytes(chunks, filters,
2925
ContentFilterContext(relpath, rev_tree))
2927
self.outf.writelines(content)
3499
fileobj = rev_tree.get_file(rev_tree_path)
3500
shutil.copyfileobj(fileobj, self.outf)
2930
self.outf.write(content)
3504
2933
class cmd_local_time_offset(Command):
3505
2934
__doc__ = """Show the offset in seconds from GMT to local time."""
3508
2936
@display_command
3510
2938
self.outf.write("%s\n" % osutils.local_time_offset())
3513
2942
class cmd_commit(Command):
3514
2943
__doc__ = """Commit changes into a new revision.
3546
2975
"John Doe <jdoe@example.com>". If there is more than one author of
3547
2976
the change you can specify the option multiple times, once for each
3552
2981
A common mistake is to forget to add a new file or directory before
3553
2982
running the commit command. The --strict option checks for unknown
3554
2983
files and aborts the commit if any are found. More advanced pre-commit
3555
checks can be implemented by defining hooks. See ``brz help hooks``
2984
checks can be implemented by defining hooks. See ``bzr help hooks``
3558
2987
:Things to note:
3560
If you accidentally commit the wrong changes or make a spelling
2989
If you accidentially commit the wrong changes or make a spelling
3561
2990
mistake in the commit message say, you can use the uncommit command
3562
to undo it. See ``brz help uncommit`` for details.
2991
to undo it. See ``bzr help uncommit`` for details.
3564
2993
Hooks can also be configured to run after a commit. This allows you
3565
2994
to trigger updates to external systems like bug trackers. The --fixes
3566
2995
option can be used to record the association between a revision and
3567
one or more bugs. See ``brz help bugs`` for details.
2996
one or more bugs. See ``bzr help bugs`` for details.
2998
A selective commit may fail in some cases where the committed
2999
tree would be invalid. Consider::
3004
bzr commit foo -m "committing foo"
3005
bzr mv foo/bar foo/baz
3008
bzr commit foo/bar -m "committing bar but not baz"
3010
In the example above, the last commit will fail by design. This gives
3011
the user the opportunity to decide whether they want to commit the
3012
rename at the same time, separately first, or not at all. (As a general
3013
rule, when in doubt, Bazaar has a policy of Doing the Safe Thing.)
3015
# TODO: Run hooks on tree to-be-committed, and after commit.
3017
# TODO: Strict commit that fails if there are deleted files.
3018
# (what does "deleted files" mean ??)
3020
# TODO: Give better message for -s, --summary, used by tla people
3022
# XXX: verbose currently does nothing
3570
3024
_see_also = ['add', 'bugs', 'hooks', 'uncommit']
3571
3025
takes_args = ['selected*']
3572
3026
takes_options = [
3574
'exclude', type=text_type, short_name='x',
3575
help="Do not consider changes made to a given path."),
3576
Option('message', type=text_type,
3578
help="Description of the new revision."),
3581
help='Commit even if nothing has changed.'),
3582
Option('file', type=text_type,
3585
help='Take commit message from this file.'),
3587
help="Refuse to commit if there are unknown "
3588
"files in the working tree."),
3589
Option('commit-time', type=text_type,
3590
help="Manually set a commit time using commit date "
3591
"format, e.g. '2009-10-10 08:00:00 +0100'."),
3593
'bugs', type=text_type,
3594
help="Link to a related bug. (see \"brz help bugs\")."),
3596
'fixes', type=text_type,
3597
help="Mark a bug as being fixed by this revision "
3598
"(see \"brz help bugs\")."),
3600
'author', type=text_type,
3601
help="Set the author's name, if it's different "
3602
"from the committer."),
3604
help="Perform a local commit in a bound "
3605
"branch. Local commits are not pushed to "
3606
"the master branch until a normal commit "
3609
Option('show-diff', short_name='p',
3610
help='When no message is supplied, show the diff along'
3611
' with the status summary in the message editor.'),
3613
help='When committing to a foreign version control '
3614
'system do not push data that can not be natively '
3027
ListOption('exclude', type=str, short_name='x',
3028
help="Do not consider changes made to a given path."),
3029
Option('message', type=unicode,
3031
help="Description of the new revision."),
3034
help='Commit even if nothing has changed.'),
3035
Option('file', type=str,
3038
help='Take commit message from this file.'),
3040
help="Refuse to commit if there are unknown "
3041
"files in the working tree."),
3042
Option('commit-time', type=str,
3043
help="Manually set a commit time using commit date "
3044
"format, e.g. '2009-10-10 08:00:00 +0100'."),
3045
ListOption('fixes', type=str,
3046
help="Mark a bug as being fixed by this revision "
3047
"(see \"bzr help bugs\")."),
3048
ListOption('author', type=unicode,
3049
help="Set the author's name, if it's different "
3050
"from the committer."),
3052
help="Perform a local commit in a bound "
3053
"branch. Local commits are not pushed to "
3054
"the master branch until a normal commit "
3057
Option('show-diff', short_name='p',
3058
help='When no message is supplied, show the diff along'
3059
' with the status summary in the message editor.'),
3616
3061
aliases = ['ci', 'checkin']
3618
def _iter_bug_urls(self, bugs, branch, status):
3619
default_bugtracker = None
3063
def _iter_bug_fix_urls(self, fixes, branch):
3620
3064
# Configure the properties for bug fixing attributes.
3622
tokens = bug.split(':')
3623
if len(tokens) == 1:
3624
if default_bugtracker is None:
3625
branch_config = branch.get_config_stack()
3626
default_bugtracker = branch_config.get(
3628
if default_bugtracker is None:
3629
raise errors.BzrCommandError(gettext(
3630
"No tracker specified for bug %s. Use the form "
3631
"'tracker:id' or specify a default bug tracker "
3632
"using the `bugtracker` option.\nSee "
3633
"\"brz help bugs\" for more information on this "
3634
"feature. Commit refused.") % bug)
3635
tag = default_bugtracker
3637
elif len(tokens) != 2:
3638
raise errors.BzrCommandError(gettext(
3065
for fixed_bug in fixes:
3066
tokens = fixed_bug.split(':')
3067
if len(tokens) != 2:
3068
raise errors.BzrCommandError(
3639
3069
"Invalid bug %s. Must be in the form of 'tracker:id'. "
3640
"See \"brz help bugs\" for more information on this "
3641
"feature.\nCommit refused.") % bug)
3643
tag, bug_id = tokens
3070
"See \"bzr help bugs\" for more information on this "
3071
"feature.\nCommit refused." % fixed_bug)
3072
tag, bug_id = tokens
3645
yield bugtracker.get_bug_url(tag, branch, bug_id), status
3646
except bugtracker.UnknownBugTrackerAbbreviation:
3647
raise errors.BzrCommandError(gettext(
3648
'Unrecognized bug %s. Commit refused.') % bug)
3649
except bugtracker.MalformedBugIdentifier as e:
3650
raise errors.BzrCommandError(gettext(
3651
u"%s\nCommit refused.") % (e,))
3074
yield bugtracker.get_bug_url(tag, branch, bug_id)
3075
except errors.UnknownBugTrackerAbbreviation:
3076
raise errors.BzrCommandError(
3077
'Unrecognized bug %s. Commit refused.' % fixed_bug)
3078
except errors.MalformedBugIdentifier, e:
3079
raise errors.BzrCommandError(
3080
"%s\nCommit refused." % (str(e),))
3653
3082
def run(self, message=None, file=None, verbose=False, selected_list=None,
3654
unchanged=False, strict=False, local=False, fixes=None, bugs=None,
3655
author=None, show_diff=False, exclude=None, commit_time=None,
3658
from .commit import (
3083
unchanged=False, strict=False, local=False, fixes=None,
3084
author=None, show_diff=False, exclude=None, commit_time=None):
3085
from bzrlib.errors import (
3659
3086
PointlessCommit,
3661
from .errors import (
3662
3087
ConflictsInTree,
3663
3088
StrictCommitFailed
3665
from .msgeditor import (
3090
from bzrlib.msgeditor import (
3666
3091
edit_commit_message_encoded,
3667
3092
generate_commit_message_template,
3668
make_commit_message_template_encoded,
3093
make_commit_message_template_encoded
3672
3096
commit_stamp = offset = None
3673
3097
if commit_time is not None:
3675
3099
commit_stamp, offset = timestamp.parse_patch_date(commit_time)
3676
except ValueError as e:
3677
raise errors.BzrCommandError(gettext(
3678
"Could not parse --commit-time: " + str(e)))
3100
except ValueError, e:
3101
raise errors.BzrCommandError(
3102
"Could not parse --commit-time: " + str(e))
3104
# TODO: Need a blackbox test for invoking the external editor; may be
3105
# slightly problematic to run this cross-platform.
3107
# TODO: do more checks that the commit will succeed before
3108
# spending the user's valuable time typing a commit message.
3680
3110
properties = {}
3682
tree, selected_list = WorkingTree.open_containing_paths(selected_list)
3112
tree, selected_list = tree_files(selected_list)
3683
3113
if selected_list == ['']:
3684
3114
# workaround - commit of root of tree should be exactly the same
3685
3115
# as just default commit in that tree, and succeed even though
3863
3278
class cmd_upgrade(Command):
3864
__doc__ = """Upgrade a repository, branch or working tree to a newer format.
3866
When the default format has changed after a major new release of
3867
Bazaar/Breezy, you may be informed during certain operations that you
3868
should upgrade. Upgrading to a newer format may improve performance
3869
or make new features available. It may however limit interoperability
3870
with older repositories or with older versions of Bazaar or Breezy.
3872
If you wish to upgrade to a particular format rather than the
3873
current default, that can be specified using the --format option.
3874
As a consequence, you can use the upgrade command this way to
3875
"downgrade" to an earlier format, though some conversions are
3876
a one way process (e.g. changing from the 1.x default to the
3877
2.x default) so downgrading is not always possible.
3879
A backup.bzr.~#~ directory is created at the start of the conversion
3880
process (where # is a number). By default, this is left there on
3881
completion. If the conversion fails, delete the new .bzr directory
3882
and rename this one back in its place. Use the --clean option to ask
3883
for the backup.bzr directory to be removed on successful conversion.
3884
Alternatively, you can delete it by hand if everything looks good
3887
If the location given is a shared repository, dependent branches
3888
are also converted provided the repository converts successfully.
3889
If the conversion of a branch fails, remaining branches are still
3892
For more information on upgrades, see the Breezy Upgrade Guide,
3893
https://www.breezy-vcs.org/doc/en/upgrade-guide/.
3279
__doc__ = """Upgrade branch storage to current format.
3281
The check command or bzr developers may sometimes advise you to run
3282
this command. When the default format has changed you may also be warned
3283
during other operations to upgrade.
3896
_see_also = ['check', 'reconcile', 'formats']
3286
_see_also = ['check']
3897
3287
takes_args = ['url?']
3898
3288
takes_options = [
3899
RegistryOption('format',
3900
help='Upgrade to a specific format. See "brz help'
3901
' formats" for details.',
3902
lazy_registry=('breezy.controldir', 'format_registry'),
3903
converter=lambda name: controldir.format_registry.make_controldir(
3905
value_switches=True, title='Branch format'),
3907
help='Remove the backup.bzr directory if successful.'),
3909
help="Show what would be done, but don't actually do anything."),
3289
RegistryOption('format',
3290
help='Upgrade to a specific format. See "bzr help'
3291
' formats" for details.',
3292
lazy_registry=('bzrlib.bzrdir', 'format_registry'),
3293
converter=lambda name: bzrdir.format_registry.make_bzrdir(name),
3294
value_switches=True, title='Branch format'),
3912
def run(self, url='.', format=None, clean=False, dry_run=False):
3913
from .upgrade import upgrade
3914
exceptions = upgrade(url, format, clean_up=clean, dry_run=dry_run)
3916
if len(exceptions) == 1:
3917
# Compatibility with historical behavior
3297
def run(self, url='.', format=None):
3298
from bzrlib.upgrade import upgrade
3299
upgrade(url, format)
3923
3302
class cmd_whoami(Command):
3924
__doc__ = """Show or set brz user id.
3303
__doc__ = """Show or set bzr user id.
3927
3306
Show the email of the current user::
3931
3310
Set the current user::
3933
brz whoami "Frank Chu <fchu@example.com>"
3312
bzr whoami "Frank Chu <fchu@example.com>"
3935
takes_options = ['directory',
3937
help='Display email address only.'),
3939
help='Set identity for the current branch instead of '
3314
takes_options = [ Option('email',
3315
help='Display email address only.'),
3317
help='Set identity for the current branch instead of '
3942
3320
takes_args = ['name?']
3943
3321
encoding_type = 'replace'
3945
3323
@display_command
3946
def run(self, email=False, branch=False, name=None, directory=None):
3324
def run(self, email=False, branch=False, name=None):
3947
3325
if name is None:
3948
if directory is None:
3949
# use branch if we're inside one; otherwise global config
3951
c = Branch.open_containing(u'.')[0].get_config_stack()
3952
except errors.NotBranchError:
3953
c = _mod_config.GlobalStack()
3955
c = Branch.open(directory).get_config_stack()
3956
identity = c.get('email')
3326
# use branch if we're inside one; otherwise global config
3328
c = Branch.open_containing('.')[0].get_config()
3329
except errors.NotBranchError:
3330
c = config.GlobalConfig()
3958
self.outf.write(_mod_config.extract_email_address(identity)
3332
self.outf.write(c.user_email() + '\n')
3961
self.outf.write(identity + '\n')
3334
self.outf.write(c.username() + '\n')
3965
raise errors.BzrCommandError(gettext("--email can only be used to display existing "
3968
3337
# display a warning if an email address isn't included in the given name.
3970
_mod_config.extract_email_address(name)
3971
except _mod_config.NoEmailInUsername:
3339
config.extract_email_address(name)
3340
except errors.NoEmailInUsername, e:
3972
3341
warning('"%s" does not seem to contain an email address. '
3973
3342
'This is allowed, but not recommended.', name)
3975
3344
# use global config unless --branch given
3977
if directory is None:
3978
c = Branch.open_containing(u'.')[0].get_config_stack()
3980
b = Branch.open(directory)
3981
self.enter_context(b.lock_write())
3982
c = b.get_config_stack()
3346
c = Branch.open_containing('.')[0].get_config()
3984
c = _mod_config.GlobalStack()
3985
c.set('email', name)
3348
c = config.GlobalConfig()
3349
c.set_user_option('email', name)
3988
3352
class cmd_nick(Command):
3989
3353
__doc__ = """Print or set the branch nickname.
3991
If unset, the colocated branch name is used for colocated branches, and
3992
the branch directory name is used for other branches. To print the
3993
current nickname, execute with no argument.
3355
If unset, the tree root directory name is used as the nickname.
3356
To print the current nickname, execute with no argument.
3995
3358
Bound branches use the nickname of its master branch unless it is set
4213
3568
def run(self, testspecs_list=None, verbose=False, one=False,
4214
3569
transport=None, benchmark=None,
3570
lsprof_timed=None, cache_dir=None,
4216
3571
first=False, list_only=False,
4217
3572
randomize=None, exclude=None, strict=False,
4218
load_list=None, debugflag=None, starting_with=None, subunit1=False,
4219
subunit2=False, parallel=None, lsprof_tests=False, sync=False):
4221
# During selftest, disallow proxying, as it can cause severe
4222
# performance penalties and is only needed for thread
4223
# safety. The selftest command is assumed to not use threads
4224
# too heavily. The call should be as early as possible, as
4225
# error reporting for past duplicate imports won't have useful
4227
if sys.version_info[0] < 3:
4228
# TODO(pad.lv/1696545): Allow proxying on Python 3, since
4229
# disallowing it currently leads to failures in many places.
4230
lazy_import.disallow_proxying()
4235
raise errors.BzrCommandError("tests not available. Install the "
4236
"breezy tests to run the breezy testsuite.")
3573
load_list=None, debugflag=None, starting_with=None, subunit=False,
3574
parallel=None, lsprof_tests=False):
3575
from bzrlib.tests import selftest
3576
import bzrlib.benchmarks as benchmarks
3577
from bzrlib.benchmarks import tree_creator
3579
# Make deprecation warnings visible, unless -Werror is set
3580
symbol_versioning.activate_deprecation_warnings(override=False)
3582
if cache_dir is not None:
3583
tree_creator.TreeCreator.CACHE_ROOT = osutils.abspath(cache_dir)
4238
3584
if testspecs_list is not None:
4239
3585
pattern = '|'.join(testspecs_list)
4244
from .tests import SubUnitBzrRunnerv1
3590
from bzrlib.tests import SubUnitBzrRunner
4245
3591
except ImportError:
4246
raise errors.BzrCommandError(gettext(
4247
"subunit not available. subunit needs to be installed "
4248
"to use --subunit."))
4249
self.additional_selftest_args['runner_class'] = SubUnitBzrRunnerv1
3592
raise errors.BzrCommandError("subunit not available. subunit "
3593
"needs to be installed to use --subunit.")
3594
self.additional_selftest_args['runner_class'] = SubUnitBzrRunner
4250
3595
# On Windows, disable automatic conversion of '\n' to '\r\n' in
4251
# stdout, which would corrupt the subunit stream.
4252
# FIXME: This has been fixed in subunit trunk (>0.0.5) so the
4253
# following code can be deleted when it's sufficiently deployed
4254
# -- vila/mgz 20100514
4255
if (sys.platform == "win32"
4256
and getattr(sys.stdout, 'fileno', None) is not None):
3596
# stdout, which would corrupt the subunit stream.
3597
if sys.platform == "win32" and sys.stdout.fileno() >= 0:
4258
3599
msvcrt.setmode(sys.stdout.fileno(), os.O_BINARY)
4261
from .tests import SubUnitBzrRunnerv2
4263
raise errors.BzrCommandError(gettext(
4264
"subunit not available. subunit "
4265
"needs to be installed to use --subunit2."))
4266
self.additional_selftest_args['runner_class'] = SubUnitBzrRunnerv2
4269
3601
self.additional_selftest_args.setdefault(
4270
3602
'suite_decorators', []).append(parallel)
4272
raise errors.BzrCommandError(gettext(
4273
"--benchmark is no longer supported from brz 2.2; "
4274
"use bzr-usertest instead"))
4275
test_suite_factory = None
4277
exclude_pattern = None
3604
test_suite_factory = benchmarks.test_suite
3605
# Unless user explicitly asks for quiet, be verbose in benchmarks
3606
verbose = not is_quiet()
3607
# TODO: should possibly lock the history file...
3608
benchfile = open(".perf_history", "at", buffering=1)
3609
self.add_cleanup(benchfile.close)
4279
exclude_pattern = '(' + '|'.join(exclude) + ')'
4281
self._disable_fsync()
3611
test_suite_factory = None
4282
3613
selftest_kwargs = {"verbose": verbose,
4284
"stop_on_failure": one,
4285
"transport": transport,
4286
"test_suite_factory": test_suite_factory,
4287
"lsprof_timed": lsprof_timed,
4288
"lsprof_tests": lsprof_tests,
4289
"matching_tests_first": first,
4290
"list_only": list_only,
4291
"random_seed": randomize,
4292
"exclude_pattern": exclude_pattern,
4294
"load_list": load_list,
4295
"debug_flags": debugflag,
4296
"starting_with": starting_with
3615
"stop_on_failure": one,
3616
"transport": transport,
3617
"test_suite_factory": test_suite_factory,
3618
"lsprof_timed": lsprof_timed,
3619
"lsprof_tests": lsprof_tests,
3620
"bench_history": benchfile,
3621
"matching_tests_first": first,
3622
"list_only": list_only,
3623
"random_seed": randomize,
3624
"exclude_pattern": exclude,
3626
"load_list": load_list,
3627
"debug_flags": debugflag,
3628
"starting_with": starting_with
4298
3630
selftest_kwargs.update(self.additional_selftest_args)
4300
# Make deprecation warnings visible, unless -Werror is set
4301
cleanup = symbol_versioning.activate_deprecation_warnings(
4304
result = tests.selftest(**selftest_kwargs)
3631
result = selftest(**selftest_kwargs)
4307
3632
return int(not result)
4309
def _disable_fsync(self):
4310
"""Change the 'os' functionality to not synchronize."""
4311
self._orig_fsync = getattr(os, 'fsync', None)
4312
if self._orig_fsync is not None:
4313
os.fsync = lambda filedes: None
4314
self._orig_fdatasync = getattr(os, 'fdatasync', None)
4315
if self._orig_fdatasync is not None:
4316
os.fdatasync = lambda filedes: None
4319
3635
class cmd_version(Command):
4320
__doc__ = """Show version of brz."""
3636
__doc__ = """Show version of bzr."""
4322
3638
encoding_type = 'replace'
4323
3639
takes_options = [
4374
3689
The source of the merge can be specified either in the form of a branch,
4375
3690
or in the form of a path to a file containing a merge directive generated
4376
with brz send. If neither is specified, the default is the upstream branch
4377
or the branch most recently merged using --remember. The source of the
4378
merge may also be specified in the form of a path to a file in another
4379
branch: in this case, only the modifications to that file are merged into
4380
the current working tree.
4382
When merging from a branch, by default brz will try to merge in all new
4383
work from the other branch, automatically determining an appropriate base
4384
revision. If this fails, you may need to give an explicit base.
4386
To pick a different ending revision, pass "--revision OTHER". brz will
4387
try to merge in all new work up to and including revision OTHER.
4389
If you specify two values, "--revision BASE..OTHER", only revisions BASE
4390
through OTHER, excluding BASE but including OTHER, will be merged. If this
4391
causes some revisions to be skipped, i.e. if the destination branch does
4392
not already contain revision BASE, such a merge is commonly referred to as
4393
a "cherrypick". Unlike a normal merge, Breezy does not currently track
4394
cherrypicks. The changes look like a normal commit, and the history of the
4395
changes from the other branch is not stored in the commit.
4397
Revision numbers are always relative to the source branch.
3691
with bzr send. If neither is specified, the default is the upstream branch
3692
or the branch most recently merged using --remember.
3694
When merging a branch, by default the tip will be merged. To pick a different
3695
revision, pass --revision. If you specify two values, the first will be used as
3696
BASE and the second one as OTHER. Merging individual revisions, or a subset of
3697
available revisions, like this is commonly referred to as "cherrypicking".
3699
Revision numbers are always relative to the branch being merged.
3701
By default, bzr will try to merge in all new work from the other
3702
branch, automatically determining an appropriate base. If this
3703
fails, you may need to give an explicit base.
4399
3705
Merge will do its best to combine the changes in two branches, but there
4400
3706
are some kinds of problems only a human can fix. When it encounters those,
4401
3707
it will mark a conflict. A conflict means that you need to fix something,
4402
before you can commit.
4404
Use brz resolve when you have fixed a problem. See also brz conflicts.
4406
If there is no default branch set, the first merge will set it (use
4407
--no-remember to avoid setting it). After that, you can omit the branch
4408
to use the default. To change the default, use --remember. The value will
4409
only be saved if the remote location can be accessed.
3708
before you should commit.
3710
Use bzr resolve when you have fixed a problem. See also bzr conflicts.
3712
If there is no default branch set, the first merge will set it. After
3713
that, you can omit the branch to use the default. To change the
3714
default, use --remember. The value will only be saved if the remote
3715
location can be accessed.
4411
3717
The results of the merge are placed into the destination working
4412
directory, where they can be reviewed (with brz diff), tested, and then
3718
directory, where they can be reviewed (with bzr diff), tested, and then
4413
3719
committed to record the result of the merge.
4415
3721
merge refuses to run if there are any uncommitted changes, unless
4416
--force is given. If --force is given, then the changes from the source
4417
will be merged with the current working tree, including any uncommitted
4418
changes in the tree. The --force option can also be used to create a
3722
--force is given. The --force option can also be used to create a
4419
3723
merge revision which has more than two parents.
4421
3725
If one would like to merge changes from the working tree of the other
4509
3813
change_reporter = delta._ChangeReporter(
4510
3814
unversioned_filter=tree.is_ignored, view_info=view_info)
4511
3815
pb = ui.ui_factory.nested_progress_bar()
4512
self.enter_context(pb)
4513
self.enter_context(tree.lock_write())
3816
self.add_cleanup(pb.finished)
3817
self.add_cleanup(tree.lock_write().unlock)
4514
3818
if location is not None:
4516
mergeable = _mod_mergeable.read_mergeable_from_url(
4517
location, possible_transports=possible_transports)
3820
mergeable = bundle.read_mergeable_from_url(location,
3821
possible_transports=possible_transports)
4518
3822
except errors.NotABundle:
4519
3823
mergeable = None
4521
3825
if uncommitted:
4522
raise errors.BzrCommandError(gettext('Cannot use --uncommitted'
4523
' with bundles or merge directives.'))
3826
raise errors.BzrCommandError('Cannot use --uncommitted'
3827
' with bundles or merge directives.')
4525
3829
if revision is not None:
4526
raise errors.BzrCommandError(gettext(
4527
'Cannot use -r with merge directives or bundles'))
3830
raise errors.BzrCommandError(
3831
'Cannot use -r with merge directives or bundles')
4528
3832
merger, verified = _mod_merge.Merger.from_mergeable(tree,
4531
3835
if merger is None and uncommitted:
4532
3836
if revision is not None and len(revision) > 0:
4533
raise errors.BzrCommandError(gettext('Cannot use --uncommitted and'
4534
' --revision at the same time.'))
3837
raise errors.BzrCommandError('Cannot use --uncommitted and'
3838
' --revision at the same time.')
4535
3839
merger = self.get_merger_from_uncommitted(tree, location, None)
4536
3840
allow_pending = False
4538
3842
if merger is None:
4539
3843
merger, allow_pending = self._get_merger_from_branch(tree,
4540
location, revision, remember, possible_transports, None)
3844
location, revision, remember, possible_transports, None)
4542
3846
merger.merge_type = merge_type
4543
3847
merger.reprocess = reprocess
4544
3848
merger.show_base = show_base
4545
3849
self.sanity_check_merger(merger)
4546
3850
if (merger.base_rev_id == merger.other_rev_id and
4547
merger.other_rev_id is not None):
4548
# check if location is a nonexistent file (and not a branch) to
4549
# disambiguate the 'Nothing to do'
4550
if merger.interesting_files:
4551
if not merger.other_tree.has_filename(
4552
merger.interesting_files[0]):
4553
note(gettext("merger: ") + str(merger))
4554
raise errors.PathsDoNotExist([location])
4555
note(gettext('Nothing to do.'))
3851
merger.other_rev_id is not None):
3852
note('Nothing to do.')
4557
if pull and not preview:
4558
3855
if merger.interesting_files is not None:
4559
raise errors.BzrCommandError(
4560
gettext('Cannot pull individual files'))
3856
raise errors.BzrCommandError('Cannot pull individual files')
4561
3857
if (merger.base_rev_id == tree.last_revision()):
4562
3858
result = tree.pull(merger.other_branch, False,
4563
3859
merger.other_rev_id)
4564
3860
result.report(self.outf)
4566
3862
if merger.this_basis is None:
4567
raise errors.BzrCommandError(gettext(
3863
raise errors.BzrCommandError(
4568
3864
"This branch has no commits."
4569
" (perhaps you would prefer 'brz pull')"))
3865
" (perhaps you would prefer 'bzr pull')")
4571
3867
return self._do_preview(merger)
4572
3868
elif interactive:
4778
4055
Re-do the merge of all conflicted files, and show the base text in
4779
4056
conflict regions, in addition to the usual THIS and OTHER texts::
4781
brz remerge --show-base
4058
bzr remerge --show-base
4783
4060
Re-do the merge of "foobar", using the weave merge algorithm, with
4784
4061
additional processing to reduce the size of conflict regions::
4786
brz remerge --merge-type weave --reprocess foobar
4063
bzr remerge --merge-type weave --reprocess foobar
4788
4065
takes_args = ['file*']
4789
4066
takes_options = [
4793
help="Show base revision text in conflicts."),
4070
help="Show base revision text in conflicts."),
4796
4073
def run(self, file_list=None, merge_type=None, show_base=False,
4797
4074
reprocess=False):
4798
from .conflicts import restore
4075
from bzrlib.conflicts import restore
4799
4076
if merge_type is None:
4800
4077
merge_type = _mod_merge.Merge3Merger
4801
tree, file_list = WorkingTree.open_containing_paths(file_list)
4802
self.enter_context(tree.lock_write())
4078
tree, file_list = tree_files(file_list)
4079
self.add_cleanup(tree.lock_write().unlock)
4803
4080
parents = tree.get_parent_ids()
4804
4081
if len(parents) != 2:
4805
raise errors.BzrCommandError(
4806
gettext("Sorry, remerge only works after normal"
4807
" merges. Not cherrypicking or multi-merges."))
4808
interesting_files = None
4082
raise errors.BzrCommandError("Sorry, remerge only works after normal"
4083
" merges. Not cherrypicking or"
4085
repository = tree.branch.repository
4086
interesting_ids = None
4809
4087
new_conflicts = []
4810
4088
conflicts = tree.conflicts()
4811
4089
if file_list is not None:
4812
interesting_files = set()
4090
interesting_ids = set()
4813
4091
for filename in file_list:
4814
if not tree.is_versioned(filename):
4092
file_id = tree.path2id(filename)
4815
4094
raise errors.NotVersionedError(filename)
4816
interesting_files.add(filename)
4817
if tree.kind(filename) != "directory":
4095
interesting_ids.add(file_id)
4096
if tree.kind(file_id) != "directory":
4820
for path, ie in tree.iter_entries_by_dir(
4821
specific_files=[filename]):
4822
interesting_files.add(path)
4099
for name, ie in tree.inventory.iter_entries(file_id):
4100
interesting_ids.add(ie.file_id)
4823
4101
new_conflicts = conflicts.select_conflicts(tree, file_list)[0]
4825
4103
# Remerge only supports resolving contents conflicts
4826
4104
allowed_conflicts = ('text conflict', 'contents conflict')
4827
4105
restore_files = [c.path for c in conflicts
4828
4106
if c.typestring in allowed_conflicts]
4829
_mod_merge.transform_tree(tree, tree.basis_tree(), interesting_files)
4107
_mod_merge.transform_tree(tree, tree.basis_tree(), interesting_ids)
4830
4108
tree.set_conflicts(ConflictList(new_conflicts))
4831
4109
if file_list is not None:
4832
4110
restore_files = file_list
5290
4555
@display_command
5291
4556
def run(self, filename, all=False, long=False, revision=None,
5292
4557
show_ids=False, directory=None):
5293
from .annotate import (
4558
from bzrlib.annotate import annotate_file, annotate_file_tree
5296
4559
wt, branch, relpath = \
5297
4560
_open_directory_or_containing_tree_or_branch(filename, directory)
5298
4561
if wt is not None:
5299
self.enter_context(wt.lock_read())
4562
self.add_cleanup(wt.lock_read().unlock)
5301
self.enter_context(branch.lock_read())
4564
self.add_cleanup(branch.lock_read().unlock)
5302
4565
tree = _get_one_revision_tree('annotate', revision, branch=branch)
5303
self.enter_context(tree.lock_read())
4566
self.add_cleanup(tree.lock_read().unlock)
4568
file_id = wt.path2id(relpath)
4570
file_id = tree.path2id(relpath)
4572
raise errors.NotVersionedError(filename)
4573
file_version = tree.inventory[file_id].revision
5304
4574
if wt is not None and revision is None:
5305
if not wt.is_versioned(relpath):
5306
raise errors.NotVersionedError(relpath)
5307
4575
# If there is a tree and we're not annotating historical
5308
4576
# versions, annotate the working tree's content.
5309
annotate_file_tree(wt, relpath, self.outf, long, all,
4577
annotate_file_tree(wt, file_id, self.outf, long, all,
5312
if not tree.is_versioned(relpath):
5313
raise errors.NotVersionedError(relpath)
5314
annotate_file_tree(tree, relpath, self.outf, long, all,
5315
show_ids=show_ids, branch=branch)
4580
annotate_file(branch, file_version, file_id, long, all, self.outf,
5318
4584
class cmd_re_sign(Command):
5319
4585
__doc__ = """Create a digital signature for an existing revision."""
5320
4586
# TODO be able to replace existing ones.
5322
hidden = True # is this right ?
4588
hidden = True # is this right ?
5323
4589
takes_args = ['revision_id*']
5324
4590
takes_options = ['directory', 'revision']
5326
4592
def run(self, revision_id_list=None, revision=None, directory=u'.'):
5327
4593
if revision_id_list is not None and revision is not None:
5328
raise errors.BzrCommandError(
5329
gettext('You can only supply one of revision_id or --revision'))
4594
raise errors.BzrCommandError('You can only supply one of revision_id or --revision')
5330
4595
if revision_id_list is None and revision is None:
5331
raise errors.BzrCommandError(
5332
gettext('You must supply either --revision or a revision_id'))
4596
raise errors.BzrCommandError('You must supply either --revision or a revision_id')
5333
4597
b = WorkingTree.open_containing(directory)[0].branch
5334
self.enter_context(b.lock_write())
4598
self.add_cleanup(b.lock_write().unlock)
5335
4599
return self._run(b, revision_id_list, revision)
5337
4601
def _run(self, b, revision_id_list, revision):
5338
from .repository import WriteGroup
5339
gpg_strategy = gpg.GPGStrategy(b.get_config_stack())
4602
import bzrlib.gpg as gpg
4603
gpg_strategy = gpg.GPGStrategy(b.get_config())
5340
4604
if revision_id_list is not None:
5341
with WriteGroup(b.repository):
4605
b.repository.start_write_group()
5342
4607
for revision_id in revision_id_list:
5343
revision_id = cache_utf8.encode(revision_id)
5344
4608
b.repository.sign_revision(revision_id, gpg_strategy)
4610
b.repository.abort_write_group()
4613
b.repository.commit_write_group()
5345
4614
elif revision is not None:
5346
4615
if len(revision) == 1:
5347
4616
revno, rev_id = revision[0].in_history(b)
5348
with WriteGroup(b.repository):
4617
b.repository.start_write_group()
5349
4619
b.repository.sign_revision(rev_id, gpg_strategy)
4621
b.repository.abort_write_group()
4624
b.repository.commit_write_group()
5350
4625
elif len(revision) == 2:
5351
4626
# are they both on rh- if so we can walk between them
5352
4627
# might be nice to have a range helper for arbitrary
5520
4792
end_revision=last_revno)
5523
self.outf.write(gettext('Dry-run, pretending to remove'
5524
' the above revisions.\n'))
4795
self.outf.write('Dry-run, pretending to remove'
4796
' the above revisions.\n')
5527
gettext('The above revision(s) will be removed.\n'))
4798
self.outf.write('The above revision(s) will be removed.\n')
5530
if not ui.ui_factory.confirm_action(
5531
gettext(u'Uncommit these revisions'),
5532
'breezy.builtins.uncommit',
5534
self.outf.write(gettext('Canceled\n'))
4801
if not ui.ui_factory.get_boolean('Are you sure'):
4802
self.outf.write('Canceled')
5537
4805
mutter('Uncommitting from {%s} to {%s}',
5538
4806
last_rev_id, rev_id)
5539
4807
uncommit(b, tree=tree, dry_run=dry_run, verbose=verbose,
5540
revno=revno, local=local, keep_tags=keep_tags)
5543
gettext('You can restore the old tip by running:\n'
5544
' brz pull -d %s %s -r revid:%s\n')
5545
% (location, location, last_rev_id.decode('utf-8')))
5548
gettext('You can restore the old tip by running:\n'
5549
' brz pull . -r revid:%s\n')
5550
% last_rev_id.decode('utf-8'))
4808
revno=revno, local=local)
4809
self.outf.write('You can restore the old tip by running:\n'
4810
' bzr pull . -r revid:%s\n' % last_rev_id)
5553
4813
class cmd_break_lock(Command):
5554
__doc__ = """Break a dead lock.
5556
This command breaks a lock on a repository, branch, working directory or
4814
__doc__ = """Break a dead lock on a repository, branch or working directory.
5559
4816
CAUTION: Locks should only be broken when you are sure that the process
5560
4817
holding the lock has been stopped.
5562
You can get information on what locks are open via the 'brz info
4819
You can get information on what locks are open via the 'bzr info
5563
4820
[location]' command.
5567
brz break-lock brz+ssh://example.com/brz/foo
5568
brz break-lock --conf ~/.config/breezy
4824
bzr break-lock bzr+ssh://example.com/bzr/foo
5571
4826
takes_args = ['location?']
5574
help='LOCATION is the directory where the config lock is.'),
5576
help='Do not ask for confirmation before breaking the lock.'),
5579
def run(self, location=None, config=False, force=False):
4828
def run(self, location=None, show=False):
5580
4829
if location is None:
5581
4830
location = u'.'
5583
ui.ui_factory = ui.ConfirmationUserInterfacePolicy(ui.ui_factory,
5585
{'breezy.lockdir.break': True})
5587
conf = _mod_config.LockableConfig(file_name=location)
5590
control, relpath = controldir.ControlDir.open_containing(location)
5592
control.break_lock()
5593
except NotImplementedError:
4831
control, relpath = bzrdir.BzrDir.open_containing(location)
4833
control.break_lock()
4834
except NotImplementedError:
5597
4838
class cmd_wait_until_signalled(Command):
5598
__doc__ = """Test helper for test_start_and_stop_brz_subprocess_send_signal.
4839
__doc__ = """Test helper for test_start_and_stop_bzr_subprocess_send_signal.
5600
4841
This just prints a line to signal when it is ready, then blocks on stdin.
5618
4859
help='Serve on stdin/out for use from inetd or sshd.'),
5619
4860
RegistryOption('protocol',
5620
help="Protocol to serve.",
5621
lazy_registry=('breezy.transport',
5622
'transport_server_registry'),
5623
value_switches=True),
5625
help='Listen for connections on nominated address.',
4861
help="Protocol to serve.",
4862
lazy_registry=('bzrlib.transport', 'transport_server_registry'),
4863
value_switches=True),
5628
help='Listen for connections on nominated port. Passing 0 as '
5629
'the port number will result in a dynamically allocated '
5630
'port. The default port depends on the protocol.',
4865
help='Listen for connections on nominated port of the form '
4866
'[hostname:]portnumber. Passing 0 as the port number will '
4867
'result in a dynamically allocated port. The default port '
4868
'depends on the protocol.',
5632
4870
custom_help('directory',
5633
help='Serve contents of this directory.'),
4871
help='Serve contents of this directory.'),
5634
4872
Option('allow-writes',
5635
4873
help='By default the server is a readonly server. Supplying '
5636
4874
'--allow-writes enables write access to the contents of '
5637
'the served directory and below. Note that ``brz serve`` '
4875
'the served directory and below. Note that ``bzr serve`` '
5638
4876
'does not perform authentication, so unless some form of '
5639
4877
'external authentication is arranged supplying this '
5640
4878
'option leads to global uncontrolled write access to your '
5643
Option('client-timeout', type=float,
5644
help='Override the default idle client timeout (5min).'),
5647
def run(self, listen=None, port=None, inet=False, directory=None,
5648
allow_writes=False, protocol=None, client_timeout=None):
5649
from . import location, transport
4883
def get_host_and_port(self, port):
4884
"""Return the host and port to run the smart server on.
4886
If 'port' is None, None will be returned for the host and port.
4888
If 'port' has a colon in it, the string before the colon will be
4889
interpreted as the host.
4891
:param port: A string of the port to run the server on.
4892
:return: A tuple of (host, port), where 'host' is a host name or IP,
4893
and port is an integer TCP/IP port.
4896
if port is not None:
4898
host, port = port.split(':')
4902
def run(self, port=None, inet=False, directory=None, allow_writes=False,
4904
from bzrlib.transport import get_transport, transport_server_registry
5650
4905
if directory is None:
5651
directory = osutils.getcwd()
4906
directory = os.getcwd()
5652
4907
if protocol is None:
5653
protocol = transport.transport_server_registry.get()
5654
url = location.location_to_url(directory)
4908
protocol = transport_server_registry.get()
4909
host, port = self.get_host_and_port(port)
4910
url = urlutils.local_path_to_url(directory)
5655
4911
if not allow_writes:
5656
4912
url = 'readonly+' + url
5657
t = transport.get_transport_from_url(url)
5658
protocol(t, listen, port, inet, client_timeout)
4913
transport = get_transport(url)
4914
protocol(transport, host, port, inet)
5661
4917
class cmd_join(Command):
6197
5432
takes_args = ['location?']
6198
5433
takes_options = [
6199
5434
RegistryOption.from_kwargs(
6202
help='The relation between branch and tree.',
5436
title='Target type',
5437
help='The type to reconfigure the directory to.',
6203
5438
value_switches=True, enum_switch=False,
6204
5439
branch='Reconfigure to be an unbound branch with no working tree.',
6205
5440
tree='Reconfigure to be an unbound branch with a working tree.',
6206
5441
checkout='Reconfigure to be a bound branch with a working tree.',
6207
5442
lightweight_checkout='Reconfigure to be a lightweight'
6208
' checkout (with no local history).',
6210
RegistryOption.from_kwargs(
6212
title='Repository type',
6213
help='Location fo the repository.',
6214
value_switches=True, enum_switch=False,
5443
' checkout (with no local history).',
6215
5444
standalone='Reconfigure to be a standalone branch '
6216
'(i.e. stop using shared repository).',
5445
'(i.e. stop using shared repository).',
6217
5446
use_shared='Reconfigure to use a shared repository.',
6219
RegistryOption.from_kwargs(
6221
title='Trees in Repository',
6222
help='Whether new branches in the repository have trees.',
6223
value_switches=True, enum_switch=False,
6224
5447
with_trees='Reconfigure repository to create '
6225
'working trees on branches by default.',
5448
'working trees on branches by default.',
6226
5449
with_no_trees='Reconfigure repository to not create '
6227
'working trees on branches by default.'
5450
'working trees on branches by default.'
6229
Option('bind-to', help='Branch to bind checkout to.', type=text_type),
5452
Option('bind-to', help='Branch to bind checkout to.', type=str),
6230
5453
Option('force',
6231
help='Perform reconfiguration even if local changes'
5454
help='Perform reconfiguration even if local changes'
6233
5456
Option('stacked-on',
6234
help='Reconfigure a branch to be stacked on another branch.',
5457
help='Reconfigure a branch to be stacked on another branch.',
6237
5460
Option('unstacked',
6238
help='Reconfigure a branch to be unstacked. This '
6239
'may require copying substantial data into it.',
5461
help='Reconfigure a branch to be unstacked. This '
5462
'may require copying substantial data into it.',
6243
def run(self, location=None, bind_to=None, force=False,
6244
tree_type=None, repository_type=None, repository_trees=None,
6245
stacked_on=None, unstacked=None):
6246
directory = controldir.ControlDir.open(location)
5466
def run(self, location=None, target_type=None, bind_to=None, force=False,
5469
directory = bzrdir.BzrDir.open(location)
6247
5470
if stacked_on and unstacked:
6248
raise errors.BzrCommandError(
6249
gettext("Can't use both --stacked-on and --unstacked"))
5471
raise BzrCommandError("Can't use both --stacked-on and --unstacked")
6250
5472
elif stacked_on is not None:
6251
5473
reconfigure.ReconfigureStackedOn().apply(directory, stacked_on)
6252
5474
elif unstacked:
6320
5531
takes_args = ['to_location?']
6321
takes_options = ['directory',
6323
help='Switch even if local commits will be lost.'),
5532
takes_options = [Option('force',
5533
help='Switch even if local commits will be lost.'),
6325
5535
Option('create-branch', short_name='b',
6326
help='Create the target branch from this one before'
6327
' switching to it.'),
6329
help='Store and restore uncommitted changes in the'
5536
help='Create the target branch from this one before'
5537
' switching to it.'),
6333
5540
def run(self, to_location=None, force=False, create_branch=False,
6334
revision=None, directory=u'.', store=False):
6335
from . import switch
6336
tree_location = directory
5542
from bzrlib import switch
6337
5544
revision = _get_one_revision('switch', revision)
6338
control_dir = controldir.ControlDir.open_containing(tree_location)[0]
6339
possible_transports = [control_dir.root_transport]
5545
control_dir = bzrdir.BzrDir.open_containing(tree_location)[0]
6340
5546
if to_location is None:
6341
5547
if revision is None:
6342
raise errors.BzrCommandError(gettext('You must supply either a'
6343
' revision or a location'))
6344
to_location = tree_location
5548
raise errors.BzrCommandError('You must supply either a'
5549
' revision or a location')
6346
branch = control_dir.open_branch(
6347
possible_transports=possible_transports)
5552
branch = control_dir.open_branch()
6348
5553
had_explicit_nick = branch.get_config().has_explicit_nickname()
6349
5554
except errors.NotBranchError:
6351
5556
had_explicit_nick = False
6353
possible_transports.append(branch.user_transport)
6354
5557
if create_branch:
6355
5558
if branch is None:
6356
raise errors.BzrCommandError(
6357
gettext('cannot create branch without source branch'))
6358
to_location = lookup_new_sibling_branch(
6359
control_dir, to_location,
6360
possible_transports=possible_transports)
6361
if revision is not None:
6362
revision = revision.as_revision_id(branch)
6363
to_branch = branch.controldir.sprout(
6365
possible_transports=possible_transports,
6366
revision_id=revision,
6367
source_branch=branch).open_branch()
5559
raise errors.BzrCommandError('cannot create branch without'
5561
to_location = directory_service.directories.dereference(
5563
if '/' not in to_location and '\\' not in to_location:
5564
# This path is meant to be relative to the existing branch
5565
this_url = self._get_branch_location(control_dir)
5566
to_location = urlutils.join(this_url, '..', to_location)
5567
to_branch = branch.bzrdir.sprout(to_location,
5568
possible_transports=[branch.bzrdir.root_transport],
5569
source_branch=branch).open_branch()
5572
to_branch = Branch.open(to_location)
5573
except errors.NotBranchError:
5574
this_url = self._get_branch_location(control_dir)
6370
5575
to_branch = Branch.open(
6371
to_location, possible_transports=possible_transports)
6372
except errors.NotBranchError:
6373
to_branch = open_sibling_branch(
6374
control_dir, to_location,
6375
possible_transports=possible_transports)
6376
if revision is not None:
6377
revision = revision.as_revision_id(to_branch)
6378
possible_transports.append(to_branch.user_transport)
6380
switch.switch(control_dir, to_branch, force, revision_id=revision,
6381
store_uncommitted=store,
6382
possible_transports=possible_transports)
6383
except controldir.BranchReferenceLoop:
6384
raise errors.BzrCommandError(
6385
gettext('switching would create a branch reference loop. '
6386
'Use the "bzr up" command to switch to a '
6387
'different revision.'))
5576
urlutils.join(this_url, '..', to_location))
5577
if revision is not None:
5578
revision = revision.as_revision_id(to_branch)
5579
switch.switch(control_dir, to_branch, force, revision_id=revision)
6388
5580
if had_explicit_nick:
6389
branch = control_dir.open_branch() # get the new branch!
5581
branch = control_dir.open_branch() #get the new branch!
6390
5582
branch.nick = to_branch.nick
6392
if to_branch.controldir.control_url != control_dir.control_url:
6393
note(gettext('Switched to branch %s at %s'),
6394
to_branch.name, urlutils.unescape_for_display(to_branch.base, 'utf-8'))
5583
note('Switched to branch: %s',
5584
urlutils.unescape_for_display(to_branch.base, 'utf-8'))
5586
def _get_branch_location(self, control_dir):
5587
"""Return location of branch for this control dir."""
5589
this_branch = control_dir.open_branch()
5590
# This may be a heavy checkout, where we want the master branch
5591
master_location = this_branch.get_bound_location()
5592
if master_location is not None:
5593
return master_location
5594
# If not, use a local sibling
5595
return this_branch.base
5596
except errors.NotBranchError:
5597
format = control_dir.find_branch_format()
5598
if getattr(format, 'get_reference', None) is not None:
5599
return format.get_reference(control_dir)
6396
note(gettext('Switched to branch %s'), to_branch.name)
6398
note(gettext('Switched to branch at %s'),
6399
urlutils.unescape_for_display(to_branch.base, 'utf-8'))
5601
return control_dir.root_transport.base
6402
5604
class cmd_view(Command):
6786
5954
takes_args = ['path?', 'location?']
6789
Option('force-unversioned',
6790
help='Set reference even if path is not versioned.'),
6793
def run(self, path=None, directory='.', location=None, force_unversioned=False):
6794
tree, branch, relpath = (
6795
controldir.ControlDir.open_containing_tree_or_branch(directory))
5956
def run(self, path=None, location=None):
5958
if path is not None:
5960
tree, branch, relpath =(
5961
bzrdir.BzrDir.open_containing_tree_or_branch(branchdir))
5962
if path is not None:
6796
5964
if tree is None:
6797
5965
tree = branch.basis_tree()
6798
5966
if path is None:
6799
with tree.lock_read():
6801
(path, tree.get_reference_info(path, branch))
6802
for path in tree.iter_references()]
6803
self._display_reference_info(tree, branch, info)
5967
info = branch._get_all_reference_info().iteritems()
5968
self._display_reference_info(tree, branch, info)
6805
if not tree.is_versioned(path) and not force_unversioned:
5970
file_id = tree.path2id(path)
6806
5972
raise errors.NotVersionedError(path)
6807
5973
if location is None:
6808
info = [(path, tree.get_reference_info(path, branch))]
5974
info = [(file_id, branch.get_reference_info(file_id))]
6809
5975
self._display_reference_info(tree, branch, info)
6811
tree.set_reference_info(path, location)
5977
branch.set_reference_info(file_id, path, location)
6813
5979
def _display_reference_info(self, tree, branch, info):
6815
for path, location in info:
5981
for file_id, (path, location) in info:
5983
path = tree.id2path(file_id)
5984
except errors.NoSuchId:
6816
5986
ref_list.append((path, location))
6817
5987
for path, location in sorted(ref_list):
6818
5988
self.outf.write('%s %s\n' % (path, location))
6821
class cmd_export_pot(Command):
6822
__doc__ = """Export command helps and error messages in po format."""
6825
takes_options = [Option('plugin',
6826
help='Export help text from named command '
6827
'(defaults to all built in commands).',
6829
Option('include-duplicates',
6830
help='Output multiple copies of the same msgid '
6831
'string if it appears more than once.'),
6834
def run(self, plugin=None, include_duplicates=False):
6835
from .export_pot import export_pot
6836
export_pot(self.outf, plugin, include_duplicates)
6839
class cmd_import(Command):
6840
__doc__ = """Import sources from a directory, tarball or zip file
6842
This command will import a directory, tarball or zip file into a bzr
6843
tree, replacing any versioned files already present. If a directory is
6844
specified, it is used as the target. If the directory does not exist, or
6845
is not versioned, it is created.
6847
Tarballs may be gzip or bzip2 compressed. This is autodetected.
6849
If the tarball or zip has a single root directory, that directory is
6850
stripped when extracting the tarball. This is not done for directories.
6853
takes_args = ['source', 'tree?']
6855
def run(self, source, tree=None):
6856
from .upstream_import import do_import
6857
do_import(source, tree)
6860
class cmd_link_tree(Command):
6861
__doc__ = """Hardlink matching files to another tree.
6863
Only files with identical content and execute bit will be linked.
6866
takes_args = ['location']
6868
def run(self, location):
6869
from .transform import link_tree
6870
target_tree = WorkingTree.open_containing(".")[0]
6871
source_tree = WorkingTree.open(location)
6872
with target_tree.lock_write(), source_tree.lock_read():
6873
link_tree(target_tree, source_tree)
6876
class cmd_fetch_ghosts(Command):
6877
__doc__ = """Attempt to retrieve ghosts from another branch.
6879
If the other branch is not supplied, the last-pulled branch is used.
6883
aliases = ['fetch-missing']
6884
takes_args = ['branch?']
6885
takes_options = [Option('no-fix', help="Skip additional synchonization.")]
6887
def run(self, branch=None, no_fix=False):
6888
from .fetch_ghosts import GhostFetcher
6889
installed, failed = GhostFetcher.from_cmdline(branch).run()
6890
if len(installed) > 0:
6891
self.outf.write("Installed:\n")
6892
for rev in installed:
6893
self.outf.write(rev.decode('utf-8') + "\n")
6895
self.outf.write("Still missing:\n")
6897
self.outf.write(rev.decode('utf-8') + "\n")
6898
if not no_fix and len(installed) > 0:
6899
cmd_reconcile().run(".")
6902
class cmd_grep(Command):
6903
"""Print lines matching PATTERN for specified files and revisions.
6905
This command searches the specified files and revisions for a given
6906
pattern. The pattern is specified as a Python regular expressions[1].
6908
If the file name is not specified, the revisions starting with the
6909
current directory are searched recursively. If the revision number is
6910
not specified, the working copy is searched. To search the last committed
6911
revision, use the '-r -1' or '-r last:1' option.
6913
Unversioned files are not searched unless explicitly specified on the
6914
command line. Unversioned directores are not searched.
6916
When searching a pattern, the output is shown in the 'filepath:string'
6917
format. If a revision is explicitly searched, the output is shown as
6918
'filepath~N:string', where N is the revision number.
6920
--include and --exclude options can be used to search only (or exclude
6921
from search) files with base name matches the specified Unix style GLOB
6922
pattern. The GLOB pattern an use *, ?, and [...] as wildcards, and \\
6923
to quote wildcard or backslash character literally. Note that the glob
6924
pattern is not a regular expression.
6926
[1] http://docs.python.org/library/re.html#regular-expression-syntax
6929
encoding_type = 'replace'
6930
takes_args = ['pattern', 'path*']
6934
Option('color', type=text_type, argname='when',
6935
help='Show match in color. WHEN is never, always or auto.'),
6936
Option('diff', short_name='p',
6937
help='Grep for pattern in changeset for each revision.'),
6938
ListOption('exclude', type=text_type, argname='glob', short_name='X',
6939
help="Skip files whose base name matches GLOB."),
6940
ListOption('include', type=text_type, argname='glob', short_name='I',
6941
help="Search only files whose base name matches GLOB."),
6942
Option('files-with-matches', short_name='l',
6943
help='Print only the name of each input file in '
6944
'which PATTERN is found.'),
6945
Option('files-without-match', short_name='L',
6946
help='Print only the name of each input file in '
6947
'which PATTERN is not found.'),
6948
Option('fixed-string', short_name='F',
6949
help='Interpret PATTERN is a single fixed string (not regex).'),
6951
help='Search for pattern starting from the root of the branch. '
6952
'(implies --recursive)'),
6953
Option('ignore-case', short_name='i',
6954
help='Ignore case distinctions while matching.'),
6956
help='Number of levels to display - 0 for all, 1 for collapsed '
6959
type=_parse_levels),
6960
Option('line-number', short_name='n',
6961
help='Show 1-based line number.'),
6962
Option('no-recursive',
6963
help="Don't recurse into subdirectories. (default is --recursive)"),
6964
Option('null', short_name='Z',
6965
help='Write an ASCII NUL (\\0) separator '
6966
'between output lines rather than a newline.'),
6970
def run(self, verbose=False, ignore_case=False, no_recursive=False,
6971
from_root=False, null=False, levels=None, line_number=False,
6972
path_list=None, revision=None, pattern=None, include=None,
6973
exclude=None, fixed_string=False, files_with_matches=False,
6974
files_without_match=False, color=None, diff=False):
6975
from breezy import _termcolor
6978
if path_list is None:
6982
raise errors.BzrCommandError(
6983
'cannot specify both --from-root and PATH.')
6985
if files_with_matches and files_without_match:
6986
raise errors.BzrCommandError(
6987
'cannot specify both '
6988
'-l/--files-with-matches and -L/--files-without-matches.')
6990
global_config = _mod_config.GlobalConfig()
6993
color = global_config.get_user_option('grep_color')
6998
if color not in ['always', 'never', 'auto']:
6999
raise errors.BzrCommandError('Valid values for --color are '
7000
'"always", "never" or "auto".')
7006
if revision is not None or levels == 0:
7007
# print revision numbers as we may be showing multiple revisions
7014
if not ignore_case and grep.is_fixed_string(pattern):
7015
# if the pattern isalnum, implicitly use to -F for faster grep
7017
elif ignore_case and fixed_string:
7018
# GZ 2010-06-02: Fall back to regexp rather than lowercasing
7019
# pattern and text which will cause pain later
7020
fixed_string = False
7021
pattern = re.escape(pattern)
7024
re_flags = re.MULTILINE
7026
re_flags |= re.IGNORECASE
7028
if not fixed_string:
7029
patternc = grep.compile_pattern(
7030
pattern.encode(grep._user_encoding), re_flags)
7032
if color == 'always':
7034
elif color == 'never':
7036
elif color == 'auto':
7037
show_color = _termcolor.allow_color()
7039
opts = grep.GrepOptions()
7041
opts.verbose = verbose
7042
opts.ignore_case = ignore_case
7043
opts.no_recursive = no_recursive
7044
opts.from_root = from_root
7046
opts.levels = levels
7047
opts.line_number = line_number
7048
opts.path_list = path_list
7049
opts.revision = revision
7050
opts.pattern = pattern
7051
opts.include = include
7052
opts.exclude = exclude
7053
opts.fixed_string = fixed_string
7054
opts.files_with_matches = files_with_matches
7055
opts.files_without_match = files_without_match
7059
opts.eol_marker = eol_marker
7060
opts.print_revno = print_revno
7061
opts.patternc = patternc
7062
opts.recursive = not no_recursive
7063
opts.fixed_string = fixed_string
7064
opts.outf = self.outf
7065
opts.show_color = show_color
7069
# files_with_matches, files_without_match
7070
# levels(?), line_number, from_root
7072
# These are silently ignored.
7073
grep.grep_diff(opts)
7074
elif revision is None:
7075
grep.workingtree_grep(opts)
7077
grep.versioned_grep(opts)
7080
class cmd_patch(Command):
7081
"""Apply a named patch to the current tree.
7085
takes_args = ['filename?']
7086
takes_options = [Option('strip', type=int, short_name='p',
7087
help=("Strip the smallest prefix containing num "
7088
"leading slashes from filenames.")),
7089
Option('silent', help='Suppress chatter.')]
7091
def run(self, filename=None, strip=None, silent=False):
7092
from .patch import patch_tree
7093
wt = WorkingTree.open_containing('.')[0]
7097
if filename is None:
7098
my_file = getattr(sys.stdin, 'buffer', sys.stdin)
7100
my_file = open(filename, 'rb')
7101
patches = [my_file.read()]
7102
return patch_tree(wt, patches, strip, quiet=is_quiet(), out=self.outf)
7105
class cmd_resolve_location(Command):
7106
__doc__ = """Expand a location to a full URL.
7109
Look up a Launchpad URL.
7111
brz resolve-location lp:brz
7113
takes_args = ['location']
7116
def run(self, location):
7117
from .location import location_to_url
7118
url = location_to_url(location)
7119
display_url = urlutils.unescape_for_display(url, self.outf.encoding)
7120
self.outf.write('%s\n' % display_url)
7123
5991
def _register_lazy_builtins():
7124
5992
# register lazy builtins from other modules; called at startup and should
7125
5993
# be only called once.
7126
5994
for (name, aliases, module_name) in [
7127
('cmd_bisect', [], 'breezy.bisect'),
7128
('cmd_bundle_info', [], 'breezy.bzr.bundle.commands'),
7129
('cmd_config', [], 'breezy.config'),
7130
('cmd_dump_btree', [], 'breezy.bzr.debug_commands'),
7131
('cmd_file_id', [], 'breezy.bzr.debug_commands'),
7132
('cmd_file_path', [], 'breezy.bzr.debug_commands'),
7133
('cmd_version_info', [], 'breezy.cmd_version_info'),
7134
('cmd_resolve', ['resolved'], 'breezy.conflicts'),
7135
('cmd_conflicts', [], 'breezy.conflicts'),
7136
('cmd_ping', [], 'breezy.bzr.smart.ping'),
7137
('cmd_sign_my_commits', [], 'breezy.commit_signature_commands'),
7138
('cmd_verify_signatures', [], 'breezy.commit_signature_commands'),
7139
('cmd_test_script', [], 'breezy.cmd_test_script'),
5995
('cmd_bundle_info', [], 'bzrlib.bundle.commands'),
5996
('cmd_dpush', [], 'bzrlib.foreign'),
5997
('cmd_version_info', [], 'bzrlib.cmd_version_info'),
5998
('cmd_resolve', ['resolved'], 'bzrlib.conflicts'),
5999
('cmd_conflicts', [], 'bzrlib.conflicts'),
6000
('cmd_sign_my_commits', [], 'bzrlib.sign_my_commits'),
7141
6002
builtin_command_registry.register_lazy(name, aliases, module_name)