14
14
# along with this program; if not, write to the Free Software
15
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17
"""builtin bzr commands"""
17
"""builtin brz commands"""
19
from __future__ import absolute_import
21
from bzrlib.lazy_import import lazy_import
22
lazy_import(globals(), """
32
from . import lazy_import
33
lazy_import.lazy_import(globals(), """
38
branch as _mod_branch,
44
config as _mod_config,
41
50
merge as _mod_merge,
51
mergeable as _mod_mergeable,
46
56
revision as _mod_revision,
55
from bzrlib.branch import Branch
56
from bzrlib.conflicts import ConflictList
57
from bzrlib.transport import memory
58
from bzrlib.revisionspec import RevisionSpec, RevisionInfo
59
from bzrlib.smtp_connection import SMTPConnection
60
from bzrlib.workingtree import WorkingTree
65
from breezy.branch import Branch
66
from breezy.conflicts import ConflictList
67
from breezy.transport import memory
68
from breezy.smtp_connection import SMTPConnection
69
from breezy.workingtree import WorkingTree
70
from breezy.i18n import gettext, ngettext
63
from bzrlib.commands import (
73
from .commands import (
65
75
builtin_command_registry,
68
from bzrlib.option import (
73
83
_parse_revision_str,
75
from bzrlib.trace import mutter, note, warning, is_quiet, get_verbosity_level
78
def tree_files(file_list, default_branch=u'.', canonicalize=True,
81
return internal_tree_files(file_list, default_branch, canonicalize,
83
except errors.FileInWrongBranch, e:
84
raise errors.BzrCommandError("%s is not in the same branch as %s" %
85
(e.path, file_list[0]))
85
from .revisionspec import (
95
from .trace import mutter, note, warning, is_quiet, get_verbosity_level
98
def _get_branch_location(control_dir, possible_transports=None):
99
"""Return location of branch for this control dir."""
101
target = control_dir.get_branch_reference()
102
except errors.NotBranchError:
103
return control_dir.root_transport.base
104
if target is not None:
106
this_branch = control_dir.open_branch(
107
possible_transports=possible_transports)
108
# This may be a heavy checkout, where we want the master branch
109
master_location = this_branch.get_bound_location()
110
if master_location is not None:
111
return master_location
112
# If not, use a local sibling
113
return this_branch.base
116
def _is_colocated(control_dir, possible_transports=None):
117
"""Check if the branch in control_dir is colocated.
119
:param control_dir: Control directory
120
:return: Tuple with boolean indicating whether the branch is colocated
121
and the full URL to the actual branch
123
# This path is meant to be relative to the existing branch
124
this_url = _get_branch_location(
125
control_dir, possible_transports=possible_transports)
126
# Perhaps the target control dir supports colocated branches?
128
root = controldir.ControlDir.open(
129
this_url, possible_transports=possible_transports)
130
except errors.NotBranchError:
131
return (False, this_url)
134
control_dir.open_workingtree()
135
except (errors.NoWorkingTree, errors.NotLocalUrl):
136
return (False, this_url)
139
root._format.colocated_branches and
140
control_dir.control_url == root.control_url,
144
def lookup_new_sibling_branch(control_dir, location, possible_transports=None):
145
"""Lookup the location for a new sibling branch.
147
:param control_dir: Control directory to find sibling branches from
148
:param location: Name of the new branch
149
:return: Full location to the new branch
151
location = directory_service.directories.dereference(location)
152
if '/' not in location and '\\' not in location:
153
(colocated, this_url) = _is_colocated(control_dir, possible_transports)
156
return urlutils.join_segment_parameters(
157
this_url, {"branch": urlutils.escape(location)})
159
return urlutils.join(this_url, '..', urlutils.escape(location))
163
def open_sibling_branch(control_dir, location, possible_transports=None):
164
"""Open a branch, possibly a sibling of another.
166
:param control_dir: Control directory relative to which to lookup the
168
:param location: Location to look up
169
:return: branch to open
172
# Perhaps it's a colocated branch?
173
return control_dir.open_branch(
174
location, possible_transports=possible_transports)
175
except (errors.NotBranchError, errors.NoColocatedBranchSupport):
176
this_url = _get_branch_location(control_dir)
179
this_url, '..', urlutils.escape(location)))
182
def open_nearby_branch(near=None, location=None, possible_transports=None):
183
"""Open a nearby branch.
185
:param near: Optional location of container from which to open branch
186
:param location: Location of the branch
187
:return: Branch instance
194
location, possible_transports=possible_transports)
195
except errors.NotBranchError:
197
cdir = controldir.ControlDir.open(
198
near, possible_transports=possible_transports)
199
return open_sibling_branch(
200
cdir, location, possible_transports=possible_transports)
203
def iter_sibling_branches(control_dir, possible_transports=None):
204
"""Iterate over the siblings of a branch.
206
:param control_dir: Control directory for which to look up the siblings
207
:return: Iterator over tuples with branch name and branch object
210
reference = control_dir.get_branch_reference()
211
except errors.NotBranchError:
213
if reference is not None:
215
ref_branch = Branch.open(
216
reference, possible_transports=possible_transports)
217
except errors.NotBranchError:
221
if ref_branch is None or ref_branch.name:
222
if ref_branch is not None:
223
control_dir = ref_branch.controldir
224
for name, branch in viewitems(control_dir.get_branches()):
227
repo = ref_branch.controldir.find_repository()
228
for branch in repo.find_branches(using=True):
229
name = urlutils.relative_url(
230
repo.user_url, branch.user_url).rstrip("/")
88
234
def tree_files_for_add(file_list):
342
436
takes_args = ['revision_id?']
343
takes_options = ['revision']
437
takes_options = ['directory', 'revision']
344
438
# cat-revision is more for frontends so should be exact
345
439
encoding = 'strict'
347
441
def print_revision(self, revisions, revid):
348
442
stream = revisions.get_record_stream([(revid,)], 'unordered', True)
349
record = stream.next()
443
record = next(stream)
350
444
if record.storage_kind == 'absent':
351
445
raise errors.NoSuchRevision(revisions, revid)
352
446
revtext = record.get_bytes_as('fulltext')
353
447
self.outf.write(revtext.decode('utf-8'))
356
def run(self, revision_id=None, revision=None):
450
def run(self, revision_id=None, revision=None, directory=u'.'):
357
451
if revision_id is not None and revision is not None:
358
raise errors.BzrCommandError('You can only supply one of'
359
' revision_id or --revision')
452
raise errors.BzrCommandError(gettext('You can only supply one of'
453
' revision_id or --revision'))
360
454
if revision_id is None and revision is None:
361
raise errors.BzrCommandError('You must supply either'
362
' --revision or a revision_id')
363
b = WorkingTree.open_containing(u'.')[0].branch
365
revisions = b.repository.revisions
455
raise errors.BzrCommandError(
456
gettext('You must supply either --revision or a revision_id'))
458
b = controldir.ControlDir.open_containing_tree_or_branch(directory)[1]
460
revisions = getattr(b.repository, "revisions", None)
366
461
if revisions is None:
367
raise errors.BzrCommandError('Repository %r does not support '
368
'access to raw revision texts')
462
raise errors.BzrCommandError(
463
gettext('Repository %r does not support '
464
'access to raw revision texts') % b.repository)
370
b.repository.lock_read()
466
with b.repository.lock_read():
372
467
# TODO: jam 20060112 should cat-revision always output utf-8?
373
468
if revision_id is not None:
374
revision_id = osutils.safe_revision_id(revision_id, warn=False)
469
revision_id = cache_utf8.encode(revision_id)
376
471
self.print_revision(revisions, revision_id)
377
472
except errors.NoSuchRevision:
378
msg = "The repository %s contains no revision %s." % (
379
b.repository.base, revision_id)
474
"The repository {0} contains no revision {1}.").format(
475
b.repository.base, revision_id.decode('utf-8'))
380
476
raise errors.BzrCommandError(msg)
381
477
elif revision is not None:
382
478
for rev in revision:
384
480
raise errors.BzrCommandError(
385
'You cannot specify a NULL revision.')
481
gettext('You cannot specify a NULL revision.'))
386
482
rev_id = rev.as_revision_id(b)
387
483
self.print_revision(revisions, rev_id)
389
b.repository.unlock()
392
class cmd_dump_btree(Command):
393
__doc__ = """Dump the contents of a btree index file to stdout.
395
PATH is a btree index file, it can be any URL. This includes things like
396
.bzr/repository/pack-names, or .bzr/repository/indices/a34b3a...ca4a4.iix
398
By default, the tuples stored in the index file will be displayed. With
399
--raw, we will uncompress the pages, but otherwise display the raw bytes
403
# TODO: Do we want to dump the internal nodes as well?
404
# TODO: It would be nice to be able to dump the un-parsed information,
405
# rather than only going through iter_all_entries. However, this is
406
# good enough for a start
408
encoding_type = 'exact'
409
takes_args = ['path']
410
takes_options = [Option('raw', help='Write the uncompressed bytes out,'
411
' rather than the parsed tuples.'),
414
def run(self, path, raw=False):
415
dirname, basename = osutils.split(path)
416
t = transport.get_transport(dirname)
418
self._dump_raw_bytes(t, basename)
420
self._dump_entries(t, basename)
422
def _get_index_and_bytes(self, trans, basename):
423
"""Create a BTreeGraphIndex and raw bytes."""
424
bt = btree_index.BTreeGraphIndex(trans, basename, None)
425
bytes = trans.get_bytes(basename)
426
bt._file = cStringIO.StringIO(bytes)
427
bt._size = len(bytes)
430
def _dump_raw_bytes(self, trans, basename):
433
# We need to parse at least the root node.
434
# This is because the first page of every row starts with an
435
# uncompressed header.
436
bt, bytes = self._get_index_and_bytes(trans, basename)
437
for page_idx, page_start in enumerate(xrange(0, len(bytes),
438
btree_index._PAGE_SIZE)):
439
page_end = min(page_start + btree_index._PAGE_SIZE, len(bytes))
440
page_bytes = bytes[page_start:page_end]
442
self.outf.write('Root node:\n')
443
header_end, data = bt._parse_header_from_bytes(page_bytes)
444
self.outf.write(page_bytes[:header_end])
446
self.outf.write('\nPage %d\n' % (page_idx,))
447
decomp_bytes = zlib.decompress(page_bytes)
448
self.outf.write(decomp_bytes)
449
self.outf.write('\n')
451
def _dump_entries(self, trans, basename):
453
st = trans.stat(basename)
454
except errors.TransportNotPossible:
455
# We can't stat, so we'll fake it because we have to do the 'get()'
457
bt, _ = self._get_index_and_bytes(trans, basename)
459
bt = btree_index.BTreeGraphIndex(trans, basename, st.st_size)
460
for node in bt.iter_all_entries():
461
# Node is made up of:
462
# (index, key, value, [references])
466
refs_as_tuples = None
468
refs_as_tuples = static_tuple.as_tuples(refs)
469
as_tuple = (tuple(node[1]), node[2], refs_as_tuples)
470
self.outf.write('%s\n' % (as_tuple,))
473
486
class cmd_remove_tree(Command):
476
489
Since a lightweight checkout is little more than a working tree
477
490
this will refuse to run against one.
479
To re-create the working tree, use "bzr checkout".
492
To re-create the working tree, use "brz checkout".
481
494
_see_also = ['checkout', 'working-trees']
482
495
takes_args = ['location*']
483
496
takes_options = [
485
498
help='Remove the working tree even if it has '
486
'uncommitted changes.'),
499
'uncommitted or shelved changes.'),
489
502
def run(self, location_list, force=False):
490
503
if not location_list:
504
location_list = ['.']
493
506
for location in location_list:
494
d = bzrdir.BzrDir.open(location)
507
d = controldir.ControlDir.open(location)
497
510
working = d.open_workingtree()
498
511
except errors.NoWorkingTree:
499
raise errors.BzrCommandError("No working tree to remove")
512
raise errors.BzrCommandError(
513
gettext("No working tree to remove"))
500
514
except errors.NotLocalUrl:
501
raise errors.BzrCommandError("You cannot remove the working tree"
515
raise errors.BzrCommandError(
516
gettext("You cannot remove the working tree"
517
" of a remote path"))
504
519
if (working.has_changes()):
505
520
raise errors.UncommittedChanges(working)
521
if working.get_shelf_manager().last_shelf() is not None:
522
raise errors.ShelvedChanges(working)
507
524
if working.user_url != working.branch.user_url:
508
raise errors.BzrCommandError("You cannot remove the working tree"
509
" from a lightweight checkout")
525
raise errors.BzrCommandError(
526
gettext("You cannot remove the working tree"
527
" from a lightweight checkout"))
511
529
d.destroy_workingtree()
532
class cmd_repair_workingtree(Command):
533
__doc__ = """Reset the working tree state file.
535
This is not meant to be used normally, but more as a way to recover from
536
filesystem corruption, etc. This rebuilds the working inventory back to a
537
'known good' state. Any new modifications (adding a file, renaming, etc)
538
will be lost, though modified files will still be detected as such.
540
Most users will want something more like "brz revert" or "brz update"
541
unless the state file has become corrupted.
543
By default this attempts to recover the current state by looking at the
544
headers of the state file. If the state file is too corrupted to even do
545
that, you can supply --revision to force the state of the tree.
549
'revision', 'directory',
551
help='Reset the tree even if it doesn\'t appear to be'
556
def run(self, revision=None, directory='.', force=False):
557
tree, _ = WorkingTree.open_containing(directory)
558
self.enter_context(tree.lock_tree_write())
562
except errors.BzrError:
563
pass # There seems to be a real error here, so we'll reset
566
raise errors.BzrCommandError(gettext(
567
'The tree does not appear to be corrupt. You probably'
568
' want "brz revert" instead. Use "--force" if you are'
569
' sure you want to reset the working tree.'))
573
revision_ids = [r.as_revision_id(tree.branch) for r in revision]
575
tree.reset_state(revision_ids)
576
except errors.BzrError:
577
if revision_ids is None:
578
extra = gettext(', the header appears corrupt, try passing '
579
'-r -1 to set the state to the last commit')
582
raise errors.BzrCommandError(
583
gettext('failed to reset the tree state{0}').format(extra))
514
586
class cmd_revno(Command):
515
587
__doc__ = """Show current revision number.
747
860
takes_options = [
863
Option('include-root',
864
help='Include the entry for the root of the tree, if any.'),
751
help='List entries of a particular kind: file, directory, symlink.',
866
help='List entries of a particular kind: file, directory, '
754
870
takes_args = ['file*']
757
def run(self, revision=None, show_ids=False, kind=None, file_list=None):
873
def run(self, revision=None, show_ids=False, kind=None, include_root=False,
758
875
if kind and kind not in ['file', 'directory', 'symlink']:
759
raise errors.BzrCommandError('invalid kind %r specified' % (kind,))
876
raise errors.BzrCommandError(
877
gettext('invalid kind %r specified') % (kind,))
761
879
revision = _get_one_revision('inventory', revision)
762
work_tree, file_list = tree_files(file_list)
763
work_tree.lock_read()
764
self.add_cleanup(work_tree.unlock)
880
work_tree, file_list = WorkingTree.open_containing_paths(file_list)
881
self.enter_context(work_tree.lock_read())
765
882
if revision is not None:
766
883
tree = revision.as_tree(work_tree.branch)
768
885
extra_trees = [work_tree]
770
self.add_cleanup(tree.unlock)
886
self.enter_context(tree.lock_read())
891
self.enter_context(tree.lock_read())
775
892
if file_list is not None:
776
file_ids = tree.paths2ids(file_list, trees=extra_trees,
777
require_versioned=True)
893
paths = tree.find_related_paths_across_trees(
894
file_list, extra_trees, require_versioned=True)
778
895
# find_ids_across_trees may include some paths that don't
779
896
# exist in 'tree'.
780
entries = sorted((tree.id2path(file_id), tree.inventory[file_id])
781
for file_id in file_ids if file_id in tree)
897
entries = tree.iter_entries_by_dir(specific_files=paths)
783
entries = tree.inventory.entries()
899
entries = tree.iter_entries_by_dir()
786
for path, entry in entries:
901
for path, entry in sorted(entries):
787
902
if kind and kind != entry.kind:
904
if path == "" and not include_root:
790
self.outf.write('%-50s %s\n' % (path, entry.file_id))
907
self.outf.write('%-50s %s\n' % (
908
path, entry.file_id.decode('utf-8')))
792
910
self.outf.write(path)
793
911
self.outf.write('\n')
914
class cmd_cp(Command):
915
__doc__ = """Copy a file.
918
brz cp OLDNAME NEWNAME
920
brz cp SOURCE... DESTINATION
922
If the last argument is a versioned directory, all the other names
923
are copied into it. Otherwise, there must be exactly two arguments
924
and the file is copied to a new name.
926
Files cannot be copied between branches. Only files can be copied
930
takes_args = ['names*']
933
encoding_type = 'replace'
935
def run(self, names_list):
936
if names_list is None:
938
if len(names_list) < 2:
939
raise errors.BzrCommandError(gettext("missing file argument"))
940
tree, rel_names = WorkingTree.open_containing_paths(
941
names_list, canonicalize=False)
942
for file_name in rel_names[0:-1]:
944
raise errors.BzrCommandError(
945
gettext("can not copy root of branch"))
946
self.enter_context(tree.lock_tree_write())
947
into_existing = osutils.isdir(names_list[-1])
948
if not into_existing:
950
(src, dst) = rel_names
952
raise errors.BzrCommandError(
953
gettext('to copy multiple files the'
954
' destination must be a versioned'
959
(n, osutils.joinpath([rel_names[-1], osutils.basename(n)]))
960
for n in rel_names[:-1]]
962
for src, dst in pairs:
964
src_kind = tree.stored_kind(src)
965
except errors.NoSuchFile:
966
raise errors.BzrCommandError(
967
gettext('Could not copy %s => %s: %s is not versioned.')
970
raise errors.BzrCommandError(
971
gettext('Could not copy %s => %s . %s is not versioned\\.'
973
if src_kind == 'directory':
974
raise errors.BzrCommandError(
975
gettext('Could not copy %s => %s . %s is a directory.'
977
dst_parent = osutils.split(dst)[0]
980
dst_parent_kind = tree.stored_kind(dst_parent)
981
except errors.NoSuchFile:
982
raise errors.BzrCommandError(
983
gettext('Could not copy %s => %s: %s is not versioned.')
984
% (src, dst, dst_parent))
985
if dst_parent_kind != 'directory':
986
raise errors.BzrCommandError(
987
gettext('Could not copy to %s: %s is not a directory.')
988
% (dst_parent, dst_parent))
990
tree.copy_one(src, dst)
796
993
class cmd_mv(Command):
797
994
__doc__ = """Move or rename a file.
800
bzr mv OLDNAME NEWNAME
997
brz mv OLDNAME NEWNAME
802
bzr mv SOURCE... DESTINATION
999
brz mv SOURCE... DESTINATION
804
1001
If the last argument is a versioned directory, all the other names
805
1002
are moved into it. Otherwise, there must be exactly two arguments
1070
1293
considered diverged if the destination branch's most recent commit is one
1071
1294
that has not been merged (directly or indirectly) by the source branch.
1073
If branches have diverged, you can use 'bzr push --overwrite' to replace
1296
If branches have diverged, you can use 'brz push --overwrite' to replace
1074
1297
the other branch completely, discarding its unmerged changes.
1076
1299
If you want to ensure you have the different changes in the other branch,
1077
do a merge (see bzr help merge) from the other branch, and commit that.
1300
do a merge (see brz help merge) from the other branch, and commit that.
1078
1301
After that you will be able to do a push without '--overwrite'.
1080
If there is no default push location set, the first push will set it.
1081
After that, you can omit the location to use the default. To change the
1082
default, use --remember. The value will only be saved if the remote
1083
location can be accessed.
1303
If there is no default push location set, the first push will set it (use
1304
--no-remember to avoid setting it). After that, you can omit the
1305
location to use the default. To change the default, use --remember. The
1306
value will only be saved if the remote location can be accessed.
1308
The --verbose option will display the revisions pushed using the log_format
1309
configuration option. You can use a different format by overriding it with
1310
-Olog_format=<other_format>.
1086
1313
_see_also = ['pull', 'update', 'working-trees']
1087
1314
takes_options = ['remember', 'overwrite', 'verbose', 'revision',
1088
Option('create-prefix',
1089
help='Create the path leading up to the branch '
1090
'if it does not already exist.'),
1092
help='Branch to push from, '
1093
'rather than the one containing the working directory.',
1097
Option('use-existing-dir',
1098
help='By default push will fail if the target'
1099
' directory exists, but does not already'
1100
' have a control directory. This flag will'
1101
' allow push to proceed.'),
1103
help='Create a stacked branch that references the public location '
1104
'of the parent branch.'),
1105
Option('stacked-on',
1106
help='Create a stacked branch that refers to another branch '
1107
'for the commit history. Only the work not present in the '
1108
'referenced branch is included in the branch created.',
1111
help='Refuse to push if there are uncommitted changes in'
1112
' the working tree, --no-strict disables the check.'),
1315
Option('create-prefix',
1316
help='Create the path leading up to the branch '
1317
'if it does not already exist.'),
1318
custom_help('directory',
1319
help='Branch to push from, '
1320
'rather than the one containing the working directory.'),
1321
Option('use-existing-dir',
1322
help='By default push will fail if the target'
1323
' directory exists, but does not already'
1324
' have a control directory. This flag will'
1325
' allow push to proceed.'),
1327
help='Create a stacked branch that references the public location '
1328
'of the parent branch.'),
1329
Option('stacked-on',
1330
help='Create a stacked branch that refers to another branch '
1331
'for the commit history. Only the work not present in the '
1332
'referenced branch is included in the branch created.',
1335
help='Refuse to push if there are uncommitted changes in'
1336
' the working tree, --no-strict disables the check.'),
1338
help="Don't populate the working tree, even for protocols"
1339
" that support it."),
1340
Option('overwrite-tags',
1341
help="Overwrite tags only."),
1342
Option('lossy', help="Allow lossy push, i.e. dropping metadata "
1343
"that can't be represented in the target.")
1114
1345
takes_args = ['location?']
1115
1346
encoding_type = 'replace'
1117
def run(self, location=None, remember=False, overwrite=False,
1118
create_prefix=False, verbose=False, revision=None,
1119
use_existing_dir=False, directory=None, stacked_on=None,
1120
stacked=False, strict=None):
1121
from bzrlib.push import _show_push_branch
1348
def run(self, location=None, remember=None, overwrite=False,
1349
create_prefix=False, verbose=False, revision=None,
1350
use_existing_dir=False, directory=None, stacked_on=None,
1351
stacked=False, strict=None, no_tree=False,
1352
overwrite_tags=False, lossy=False):
1353
from .location import location_to_url
1354
from .push import _show_push_branch
1357
overwrite = ["history", "tags"]
1358
elif overwrite_tags:
1359
overwrite = ["tags"]
1123
1363
if directory is None:
1124
1364
directory = '.'
1125
1365
# Get the source branch
1126
1366
(tree, br_from,
1127
_unused) = bzrdir.BzrDir.open_containing_tree_or_branch(directory)
1367
_unused) = controldir.ControlDir.open_containing_tree_or_branch(directory)
1128
1368
# Get the tip's revision_id
1129
1369
revision = _get_one_revision('push', revision)
1130
1370
if revision is not None:
1189
1439
_see_also = ['checkout']
1190
1440
takes_args = ['from_location', 'to_location?']
1191
takes_options = ['revision', Option('hardlink',
1192
help='Hard-link working tree files where possible.'),
1194
help="Create a branch without a working-tree."),
1196
help="Switch the checkout in the current directory "
1197
"to the new branch."),
1199
help='Create a stacked branch referring to the source branch. '
1200
'The new branch will depend on the availability of the source '
1201
'branch for all operations.'),
1202
Option('standalone',
1203
help='Do not use a shared repository, even if available.'),
1204
Option('use-existing-dir',
1205
help='By default branch will fail if the target'
1206
' directory exists, but does not already'
1207
' have a control directory. This flag will'
1208
' allow branch to proceed.'),
1210
help="Bind new branch to from location."),
1212
aliases = ['get', 'clone']
1441
takes_options = ['revision',
1443
'hardlink', help='Hard-link working tree files where possible.'),
1444
Option('files-from', type=text_type,
1445
help="Get file contents from this tree."),
1447
help="Create a branch without a working-tree."),
1449
help="Switch the checkout in the current directory "
1450
"to the new branch."),
1452
help='Create a stacked branch referring to the source branch. '
1453
'The new branch will depend on the availability of the source '
1454
'branch for all operations.'),
1455
Option('standalone',
1456
help='Do not use a shared repository, even if available.'),
1457
Option('use-existing-dir',
1458
help='By default branch will fail if the target'
1459
' directory exists, but does not already'
1460
' have a control directory. This flag will'
1461
' allow branch to proceed.'),
1463
help="Bind new branch to from location."),
1464
Option('no-recurse-nested',
1465
help='Do not recursively check out nested trees.'),
1214
1468
def run(self, from_location, to_location=None, revision=None,
1215
1469
hardlink=False, stacked=False, standalone=False, no_tree=False,
1216
use_existing_dir=False, switch=False, bind=False):
1217
from bzrlib import switch as _mod_switch
1218
from bzrlib.tag import _merge_tags_if_possible
1219
accelerator_tree, br_from = bzrdir.BzrDir.open_tree_or_branch(
1470
use_existing_dir=False, switch=False, bind=False,
1471
files_from=None, no_recurse_nested=False):
1472
from breezy import switch as _mod_switch
1473
accelerator_tree, br_from = controldir.ControlDir.open_tree_or_branch(
1475
if no_recurse_nested:
1479
if not (hardlink or files_from):
1480
# accelerator_tree is usually slower because you have to read N
1481
# files (no readahead, lots of seeks, etc), but allow the user to
1482
# explicitly request it
1483
accelerator_tree = None
1484
if files_from is not None and files_from != from_location:
1485
accelerator_tree = WorkingTree.open(files_from)
1221
1486
revision = _get_one_revision('branch', revision)
1223
self.add_cleanup(br_from.unlock)
1487
self.enter_context(br_from.lock_read())
1224
1488
if revision is not None:
1225
1489
revision_id = revision.as_revision_id(br_from)
1230
1494
revision_id = br_from.last_revision()
1231
1495
if to_location is None:
1232
1496
to_location = urlutils.derive_to_location(from_location)
1233
to_transport = transport.get_transport(to_location)
1497
to_transport = transport.get_transport(to_location, purpose='write')
1235
1499
to_transport.mkdir('.')
1236
1500
except errors.FileExists:
1237
if not use_existing_dir:
1238
raise errors.BzrCommandError('Target directory "%s" '
1239
'already exists.' % to_location)
1502
to_dir = controldir.ControlDir.open_from_transport(
1504
except errors.NotBranchError:
1505
if not use_existing_dir:
1506
raise errors.BzrCommandError(gettext('Target directory "%s" '
1507
'already exists.') % to_location)
1242
bzrdir.BzrDir.open_from_transport(to_transport)
1512
to_dir.open_branch()
1243
1513
except errors.NotBranchError:
1246
1516
raise errors.AlreadyBranchError(to_location)
1247
1517
except errors.NoSuchFile:
1248
raise errors.BzrCommandError('Parent of "%s" does not exist.'
1518
raise errors.BzrCommandError(gettext('Parent of "%s" does not exist.')
1251
# preserve whatever source format we have.
1252
dir = br_from.bzrdir.sprout(to_transport.base, revision_id,
1253
possible_transports=[to_transport],
1254
accelerator_tree=accelerator_tree,
1255
hardlink=hardlink, stacked=stacked,
1256
force_new_repo=standalone,
1257
create_tree_if_local=not no_tree,
1258
source_branch=br_from)
1259
branch = dir.open_branch()
1260
except errors.NoSuchRevision:
1261
to_transport.delete_tree('.')
1262
msg = "The branch %s has no revision %s." % (from_location,
1264
raise errors.BzrCommandError(msg)
1265
_merge_tags_if_possible(br_from, branch)
1524
# preserve whatever source format we have.
1525
to_dir = br_from.controldir.sprout(
1526
to_transport.base, revision_id,
1527
possible_transports=[to_transport],
1528
accelerator_tree=accelerator_tree, hardlink=hardlink,
1529
stacked=stacked, force_new_repo=standalone,
1530
create_tree_if_local=not no_tree, source_branch=br_from,
1532
branch = to_dir.open_branch(
1533
possible_transports=[
1534
br_from.controldir.root_transport, to_transport])
1535
except errors.NoSuchRevision:
1536
to_transport.delete_tree('.')
1537
msg = gettext("The branch {0} has no revision {1}.").format(
1538
from_location, revision)
1539
raise errors.BzrCommandError(msg)
1542
to_repo = to_dir.open_repository()
1543
except errors.NoRepositoryPresent:
1544
to_repo = to_dir.create_repository()
1545
to_repo.fetch(br_from.repository, revision_id=revision_id)
1546
branch = br_from.sprout(
1547
to_dir, revision_id=revision_id)
1548
br_from.tags.merge_to(branch.tags)
1266
1550
# If the source branch is stacked, the new branch may
1267
1551
# be stacked whether we asked for that explicitly or not.
1268
1552
# We therefore need a try/except here and not just 'if stacked:'
1270
note('Created new stacked branch referring to %s.' %
1271
branch.get_stacked_on_url())
1272
except (errors.NotStacked, errors.UnstackableBranchFormat,
1273
errors.UnstackableRepositoryFormat), e:
1274
note('Branched %d revision(s).' % branch.revno())
1554
note(gettext('Created new stacked branch referring to %s.') %
1555
branch.get_stacked_on_url())
1556
except (errors.NotStacked, _mod_branch.UnstackableBranchFormat,
1557
errors.UnstackableRepositoryFormat) as e:
1558
revno = branch.revno()
1559
if revno is not None:
1560
note(ngettext('Branched %d revision.',
1561
'Branched %d revisions.',
1562
branch.revno()) % revno)
1564
note(gettext('Created new branch.'))
1276
1566
# Bind to the parent
1277
1567
parent_branch = Branch.open(from_location)
1278
1568
branch.bind(parent_branch)
1279
note('New branch bound to %s' % from_location)
1569
note(gettext('New branch bound to %s') % from_location)
1281
1571
# Switch to the new branch
1282
1572
wt, _ = WorkingTree.open_containing('.')
1283
_mod_switch.switch(wt.bzrdir, branch)
1284
note('Switched to branch: %s',
1285
urlutils.unescape_for_display(branch.base, 'utf-8'))
1573
_mod_switch.switch(wt.controldir, branch)
1574
note(gettext('Switched to branch: %s'),
1575
urlutils.unescape_for_display(branch.base, 'utf-8'))
1578
class cmd_branches(Command):
1579
__doc__ = """List the branches available at the current location.
1581
This command will print the names of all the branches at the current
1585
takes_args = ['location?']
1587
Option('recursive', short_name='R',
1588
help='Recursively scan for branches rather than '
1589
'just looking in the specified location.')]
1591
def run(self, location=".", recursive=False):
1593
t = transport.get_transport(location, purpose='read')
1594
if not t.listable():
1595
raise errors.BzrCommandError(
1596
"Can't scan this type of location.")
1597
for b in controldir.ControlDir.find_branches(t):
1598
self.outf.write("%s\n" % urlutils.unescape_for_display(
1599
urlutils.relative_url(t.base, b.base),
1600
self.outf.encoding).rstrip("/"))
1602
dir = controldir.ControlDir.open_containing(location)[0]
1604
active_branch = dir.open_branch(name="")
1605
except errors.NotBranchError:
1606
active_branch = None
1608
for name, branch in iter_sibling_branches(dir):
1611
active = (active_branch is not None and
1612
active_branch.user_url == branch.user_url)
1613
names[name] = active
1614
# Only mention the current branch explicitly if it's not
1615
# one of the colocated branches
1616
if not any(viewvalues(names)) and active_branch is not None:
1617
self.outf.write("* %s\n" % gettext("(default)"))
1618
for name in sorted(names):
1619
active = names[name]
1624
self.outf.write("%s %s\n" % (
1625
prefix, (name if PY3 else name.encode(self.outf.encoding))))
1288
1628
class cmd_checkout(Command):
1289
1629
__doc__ = """Create a new checkout of an existing branch.
1291
If BRANCH_LOCATION is omitted, checkout will reconstitute a working tree for
1292
the branch found in '.'. This is useful if you have removed the working tree
1293
or if it was never created - i.e. if you pushed the branch to its current
1294
location using SFTP.
1631
If BRANCH_LOCATION is omitted, checkout will reconstitute a working tree
1632
for the branch found in '.'. This is useful if you have removed the working
1633
tree or if it was never created - i.e. if you pushed the branch to its
1634
current location using SFTP.
1296
If the TO_LOCATION is omitted, the last component of the BRANCH_LOCATION will
1297
be used. In other words, "checkout ../foo/bar" will attempt to create ./bar.
1298
If the BRANCH_LOCATION has no / or path separator embedded, the TO_LOCATION
1299
is derived from the BRANCH_LOCATION by stripping a leading scheme or drive
1300
identifier, if any. For example, "checkout lp:foo-bar" will attempt to
1636
If the TO_LOCATION is omitted, the last component of the BRANCH_LOCATION
1637
will be used. In other words, "checkout ../foo/bar" will attempt to create
1638
./bar. If the BRANCH_LOCATION has no / or path separator embedded, the
1639
TO_LOCATION is derived from the BRANCH_LOCATION by stripping a leading
1640
scheme or drive identifier, if any. For example, "checkout lp:foo-bar" will
1641
attempt to create ./foo-bar.
1303
1643
To retrieve the branch as of a particular revision, supply the --revision
1304
parameter, as in "checkout foo/bar -r 5". Note that this will be immediately
1305
out of date [so you cannot commit] but it may be useful (i.e. to examine old
1644
parameter, as in "checkout foo/bar -r 5". Note that this will be
1645
immediately out of date [so you cannot commit] but it may be useful (i.e.
1646
to examine old code.)
1309
_see_also = ['checkouts', 'branch']
1649
_see_also = ['checkouts', 'branch', 'working-trees', 'remove-tree']
1310
1650
takes_args = ['branch_location?', 'to_location?']
1311
1651
takes_options = ['revision',
1312
1652
Option('lightweight',
1366
1710
@display_command
1367
1711
def run(self, dir=u'.'):
1368
1712
tree = WorkingTree.open_containing(dir)[0]
1370
self.add_cleanup(tree.unlock)
1371
new_inv = tree.inventory
1713
self.enter_context(tree.lock_read())
1372
1714
old_tree = tree.basis_tree()
1373
old_tree.lock_read()
1374
self.add_cleanup(old_tree.unlock)
1375
old_inv = old_tree.inventory
1715
self.enter_context(old_tree.lock_read())
1377
1717
iterator = tree.iter_changes(old_tree, include_unchanged=True)
1378
for f, paths, c, v, p, n, k, e in iterator:
1379
if paths[0] == paths[1]:
1383
renames.append(paths)
1718
for change in iterator:
1719
if change.path[0] == change.path[1]:
1721
if None in change.path:
1723
renames.append(change.path)
1385
1725
for old_name, new_name in renames:
1386
1726
self.outf.write("%s => %s\n" % (old_name, new_name))
1389
1729
class cmd_update(Command):
1390
__doc__ = """Update a tree to have the latest code committed to its branch.
1392
This will perform a merge into the working tree, and may generate
1393
conflicts. If you have any local changes, you will still
1394
need to commit them after the update for the update to be complete.
1396
If you want to discard your local changes, you can just do a
1397
'bzr revert' instead of 'bzr commit' after the update.
1399
If the tree's branch is bound to a master branch, it will also update
1730
__doc__ = """Update a working tree to a new revision.
1732
This will perform a merge of the destination revision (the tip of the
1733
branch, or the specified revision) into the working tree, and then make
1734
that revision the basis revision for the working tree.
1736
You can use this to visit an older revision, or to update a working tree
1737
that is out of date from its branch.
1739
If there are any uncommitted changes in the tree, they will be carried
1740
across and remain as uncommitted changes after the update. To discard
1741
these changes, use 'brz revert'. The uncommitted changes may conflict
1742
with the changes brought in by the change in basis revision.
1744
If the tree's branch is bound to a master branch, brz will also update
1400
1745
the branch from the master.
1747
You cannot update just a single file or directory, because each Breezy
1748
working tree has just a single basis revision. If you want to restore a
1749
file that has been removed locally, use 'brz revert' instead of 'brz
1750
update'. If you want to restore a file to its state in a previous
1751
revision, use 'brz revert' with a '-r' option, or use 'brz cat' to write
1752
out the old content of that file to a new location.
1754
The 'dir' argument, if given, must be the location of the root of a
1755
working tree to update. By default, the working tree that contains the
1756
current working directory is used.
1403
1759
_see_also = ['pull', 'working-trees', 'status-flags']
1404
1760
takes_args = ['dir?']
1405
takes_options = ['revision']
1761
takes_options = ['revision',
1763
help="Show base revision text in conflicts."),
1406
1765
aliases = ['up']
1408
def run(self, dir='.', revision=None):
1767
def run(self, dir=None, revision=None, show_base=None):
1409
1768
if revision is not None and len(revision) != 1:
1410
raise errors.BzrCommandError(
1411
"bzr update --revision takes exactly one revision")
1412
tree = WorkingTree.open_containing(dir)[0]
1769
raise errors.BzrCommandError(gettext(
1770
"brz update --revision takes exactly one revision"))
1772
tree = WorkingTree.open_containing('.')[0]
1774
tree, relpath = WorkingTree.open_containing(dir)
1777
raise errors.BzrCommandError(gettext(
1778
"brz update can only update a whole tree, "
1779
"not a file or subdirectory"))
1413
1780
branch = tree.branch
1414
1781
possible_transports = []
1415
1782
master = branch.get_master_branch(
1416
1783
possible_transports=possible_transports)
1417
1784
if master is not None:
1419
1785
branch_location = master.base
1786
self.enter_context(tree.lock_write())
1421
tree.lock_tree_write()
1422
1788
branch_location = tree.branch.base
1423
self.add_cleanup(tree.unlock)
1789
self.enter_context(tree.lock_tree_write())
1424
1790
# get rid of the final '/' and be ready for display
1425
1791
branch_location = urlutils.unescape_for_display(
1426
1792
branch_location.rstrip('/'),
1511
1878
noise_level = get_verbosity_level()
1513
1880
noise_level = 0
1514
from bzrlib.info import show_bzrdir_info
1515
show_bzrdir_info(bzrdir.BzrDir.open_containing(location)[0],
1881
from .info import show_bzrdir_info
1882
show_bzrdir_info(controldir.ControlDir.open_containing(location)[0],
1516
1883
verbose=noise_level, outfile=self.outf)
1519
1886
class cmd_remove(Command):
1520
1887
__doc__ = """Remove files or directories.
1522
This makes bzr stop tracking changes to the specified files. bzr will delete
1523
them if they can easily be recovered using revert. If no options or
1524
parameters are given bzr will scan for files that are being tracked by bzr
1525
but missing in your tree and stop tracking them for you.
1889
This makes Breezy stop tracking changes to the specified files. Breezy will
1890
delete them if they can easily be recovered using revert otherwise they
1891
will be backed up (adding an extension of the form .~#~). If no options or
1892
parameters are given Breezy will scan for files that are being tracked by
1893
Breezy but missing in your tree and stop tracking them for you.
1527
1895
takes_args = ['file*']
1528
1896
takes_options = ['verbose',
1529
Option('new', help='Only remove files that have never been committed.'),
1530
RegistryOption.from_kwargs('file-deletion-strategy',
1531
'The file deletion mode to be used.',
1532
title='Deletion Strategy', value_switches=True, enum_switch=False,
1533
safe='Only delete files if they can be'
1534
' safely recovered (default).',
1535
keep='Delete from bzr but leave the working copy.',
1536
force='Delete all the specified files, even if they can not be '
1537
'recovered and even if they are non-empty directories.')]
1898
'new', help='Only remove files that have never been committed.'),
1899
RegistryOption.from_kwargs('file-deletion-strategy',
1900
'The file deletion mode to be used.',
1901
title='Deletion Strategy', value_switches=True, enum_switch=False,
1902
safe='Backup changed files (default).',
1903
keep='Delete from brz but leave the working copy.',
1904
no_backup='Don\'t backup changed files.'),
1538
1906
aliases = ['rm', 'del']
1539
1907
encoding_type = 'replace'
1541
1909
def run(self, file_list, verbose=False, new=False,
1542
file_deletion_strategy='safe'):
1543
tree, file_list = tree_files(file_list)
1910
file_deletion_strategy='safe'):
1912
tree, file_list = WorkingTree.open_containing_paths(file_list)
1545
1914
if file_list is not None:
1546
1915
file_list = [f for f in file_list]
1549
self.add_cleanup(tree.unlock)
1917
self.enter_context(tree.lock_write())
1550
1918
# Heuristics should probably all move into tree.remove_smart or
1553
1921
added = tree.changes_from(tree.basis_tree(),
1554
specific_files=file_list).added
1555
file_list = sorted([f[0] for f in added], reverse=True)
1922
specific_files=file_list).added
1923
file_list = sorted([f.path[1] for f in added], reverse=True)
1556
1924
if len(file_list) == 0:
1557
raise errors.BzrCommandError('No matching files.')
1925
raise errors.BzrCommandError(gettext('No matching files.'))
1558
1926
elif file_list is None:
1559
1927
# missing files show up in iter_changes(basis) as
1560
1928
# versioned-with-no-kind.
1562
1930
for change in tree.iter_changes(tree.basis_tree()):
1563
1931
# Find paths in the working tree that have no kind:
1564
if change[1][1] is not None and change[6][1] is None:
1565
missing.append(change[1][1])
1932
if change.path[1] is not None and change.kind[1] is None:
1933
missing.append(change.path[1])
1566
1934
file_list = sorted(missing, reverse=True)
1567
1935
file_deletion_strategy = 'keep'
1568
1936
tree.remove(file_list, verbose=verbose, to_file=self.outf,
1569
keep_files=file_deletion_strategy=='keep',
1570
force=file_deletion_strategy=='force')
1573
class cmd_file_id(Command):
1574
__doc__ = """Print file_id of a particular file or directory.
1576
The file_id is assigned when the file is first added and remains the
1577
same through all revisions where the file exists, even when it is
1582
_see_also = ['inventory', 'ls']
1583
takes_args = ['filename']
1586
def run(self, filename):
1587
tree, relpath = WorkingTree.open_containing(filename)
1588
i = tree.path2id(relpath)
1590
raise errors.NotVersionedError(filename)
1592
self.outf.write(i + '\n')
1595
class cmd_file_path(Command):
1596
__doc__ = """Print path of file_ids to a file or directory.
1598
This prints one line for each directory down to the target,
1599
starting at the branch root.
1603
takes_args = ['filename']
1606
def run(self, filename):
1607
tree, relpath = WorkingTree.open_containing(filename)
1608
fid = tree.path2id(relpath)
1610
raise errors.NotVersionedError(filename)
1611
segments = osutils.splitpath(relpath)
1612
for pos in range(1, len(segments) + 1):
1613
path = osutils.joinpath(segments[:pos])
1614
self.outf.write("%s\n" % tree.path2id(path))
1937
keep_files=file_deletion_strategy == 'keep',
1938
force=(file_deletion_strategy == 'no-backup'))
1617
1941
class cmd_reconcile(Command):
1618
__doc__ = """Reconcile bzr metadata in a branch.
1942
__doc__ = """Reconcile brz metadata in a branch.
1620
1944
This can correct data mismatches that may have been caused by
1621
previous ghost operations or bzr upgrades. You should only
1622
need to run this command if 'bzr check' or a bzr developer
1945
previous ghost operations or brz upgrades. You should only
1946
need to run this command if 'brz check' or a brz developer
1623
1947
advises you to run it.
1625
1949
If a second branch is provided, cross-branch reconciliation is
1626
1950
also attempted, which will check that data like the tree root
1627
id which was not present in very early bzr versions is represented
1951
id which was not present in very early brz versions is represented
1628
1952
correctly in both branches.
1630
1954
At the same time it is run it may recompress data resulting in
1742
2084
to_transport.ensure_base()
1743
2085
except errors.NoSuchFile:
1744
2086
if not create_prefix:
1745
raise errors.BzrCommandError("Parent directory of %s"
1747
"\nYou may supply --create-prefix to create all"
1748
" leading parent directories."
2087
raise errors.BzrCommandError(gettext("Parent directory of %s"
2089
"\nYou may supply --create-prefix to create all"
2090
" leading parent directories.")
1750
2092
to_transport.create_prefix()
1753
a_bzrdir = bzrdir.BzrDir.open_from_transport(to_transport)
2095
a_controldir = controldir.ControlDir.open_from_transport(
1754
2097
except errors.NotBranchError:
1755
2098
# really a NotBzrDir error...
1756
create_branch = bzrdir.BzrDir.create_branch_convenience
2099
create_branch = controldir.ControlDir.create_branch_convenience
2101
force_new_tree = False
2103
force_new_tree = None
1757
2104
branch = create_branch(to_transport.base, format=format,
1758
possible_transports=[to_transport])
1759
a_bzrdir = branch.bzrdir
2105
possible_transports=[to_transport],
2106
force_new_tree=force_new_tree)
2107
a_controldir = branch.controldir
1761
from bzrlib.transport.local import LocalTransport
1762
if a_bzrdir.has_branch():
2109
from .transport.local import LocalTransport
2110
if a_controldir.has_branch():
1763
2111
if (isinstance(to_transport, LocalTransport)
1764
and not a_bzrdir.has_workingtree()):
1765
raise errors.BranchExistsWithoutWorkingTree(location)
2112
and not a_controldir.has_workingtree()):
2113
raise errors.BranchExistsWithoutWorkingTree(location)
1766
2114
raise errors.AlreadyBranchError(location)
1767
branch = a_bzrdir.create_branch()
1768
a_bzrdir.create_workingtree()
2115
branch = a_controldir.create_branch()
2116
if not no_tree and not a_controldir.has_workingtree():
2117
a_controldir.create_workingtree()
1769
2118
if append_revisions_only:
1771
2120
branch.set_append_revisions_only(True)
1772
2121
except errors.UpgradeRequired:
1773
raise errors.BzrCommandError('This branch format cannot be set'
1774
' to append-revisions-only. Try --default.')
2122
raise errors.BzrCommandError(gettext('This branch format cannot be set'
2123
' to append-revisions-only. Try --default.'))
1775
2124
if not is_quiet():
1776
from bzrlib.info import describe_layout, describe_format
2125
from .info import describe_layout, describe_format
1778
tree = a_bzrdir.open_workingtree(recommend_upgrade=False)
2127
tree = a_controldir.open_workingtree(recommend_upgrade=False)
1779
2128
except (errors.NoWorkingTree, errors.NotLocalUrl):
1781
2130
repository = branch.repository
1782
2131
layout = describe_layout(repository, branch, tree).lower()
1783
format = describe_format(a_bzrdir, repository, branch, tree)
1784
self.outf.write("Created a %s (format: %s)\n" % (layout, format))
2132
format = describe_format(a_controldir, repository, branch, tree)
2133
self.outf.write(gettext("Created a {0} (format: {1})\n").format(
1785
2135
if repository.is_shared():
1786
#XXX: maybe this can be refactored into transport.path_or_url()
1787
url = repository.bzrdir.root_transport.external_url()
2136
# XXX: maybe this can be refactored into transport.path_or_url()
2137
url = repository.controldir.root_transport.external_url()
1789
2139
url = urlutils.local_path_from_url(url)
1790
except errors.InvalidURL:
2140
except urlutils.InvalidURL:
1792
self.outf.write("Using shared repository: %s\n" % url)
1795
class cmd_init_repository(Command):
2142
self.outf.write(gettext("Using shared repository: %s\n") % url)
2145
class cmd_init_shared_repository(Command):
1796
2146
__doc__ = """Create a shared repository for branches to share storage space.
1798
2148
New branches created under the repository directory will store their
1799
2149
revisions in the repository, not in the branch directory. For branches
1800
with shared history, this reduces the amount of storage needed and
2150
with shared history, this reduces the amount of storage needed and
1801
2151
speeds up the creation of new branches.
1803
2153
If the --no-trees option is given then the branches in the repository
1804
will not have working trees by default. They will still exist as
1805
directories on disk, but they will not have separate copies of the
2154
will not have working trees by default. They will still exist as
2155
directories on disk, but they will not have separate copies of the
1806
2156
files at a certain revision. This can be useful for repositories that
1807
2157
store branches which are interacted with through checkouts or remote
1808
2158
branches, such as on a server.
1875
2241
Shows the difference in the working tree versus the last commit::
1879
2245
Difference between the working tree and revision 1::
1883
2249
Difference between revision 3 and revision 1::
1887
2253
Difference between revision 3 and revision 1 for branch xxx::
1891
To see the changes introduced in revision X::
2257
The changes introduced by revision 2 (equivalent to -r1..2)::
2261
To see the changes introduced by revision X::
1895
2265
Note that in the case of a merge, the -c option shows the changes
1896
2266
compared to the left hand parent. To see the changes against
1897
2267
another parent, use::
1899
bzr diff -r<chosen_parent>..X
1901
The changes introduced by revision 2 (equivalent to -r1..2)::
2269
brz diff -r<chosen_parent>..X
2271
The changes between the current revision and the previous revision
2272
(equivalent to -c-1 and -r-2..-1)
1905
2276
Show just the differences for file NEWS::
1909
2280
Show the differences in working tree xxx for file NEWS::
1913
2284
Show the differences from branch xxx to this working tree:
1917
2288
Show the differences between two branches for file NEWS::
1919
bzr diff --old xxx --new yyy NEWS
1921
Same as 'bzr diff' but prefix paths with old/ and new/::
1923
bzr diff --prefix old/:new/
2290
brz diff --old xxx --new yyy NEWS
2292
Same as 'brz diff' but prefix paths with old/ and new/::
2294
brz diff --prefix old/:new/
2296
Show the differences using a custom diff program with options::
2298
brz diff --using /usr/bin/diff --diff-options -wu
1925
2300
_see_also = ['status']
1926
2301
takes_args = ['file*']
1927
2302
takes_options = [
1928
Option('diff-options', type=str,
2303
Option('diff-options', type=text_type,
1929
2304
help='Pass these options to the external diff program.'),
1930
Option('prefix', type=str,
2305
Option('prefix', type=text_type,
1931
2306
short_name='p',
1932
2307
help='Set prefixes added to old and new filenames, as '
1933
2308
'two values separated by a colon. (eg "old/:new/").'),
1935
help='Branch/tree to compare from.',
2310
help='Branch/tree to compare from.',
1939
help='Branch/tree to compare to.',
2314
help='Branch/tree to compare to.',
1944
2319
Option('using',
1945
help='Use this command to compare files.',
2320
help='Use this command to compare files.',
1948
2323
RegistryOption('format',
1949
help='Diff format to use.',
1950
lazy_registry=('bzrlib.diff', 'format_registry'),
1951
value_switches=False, title='Diff format'),
2325
help='Diff format to use.',
2326
lazy_registry=('breezy.diff', 'format_registry'),
2327
title='Diff format'),
2329
help='How many lines of context to show.',
1953
2333
aliases = ['di', 'dif']
1954
2334
encoding_type = 'exact'
1956
2336
@display_command
1957
2337
def run(self, revision=None, file_list=None, diff_options=None,
1958
prefix=None, old=None, new=None, using=None, format=None):
1959
from bzrlib.diff import (get_trees_and_branches_to_diff_locked,
2338
prefix=None, old=None, new=None, using=None, format=None,
2340
from .diff import (get_trees_and_branches_to_diff_locked,
1962
if (prefix is None) or (prefix == '0'):
1963
2344
# diff -p0 format
2347
elif prefix == u'1' or prefix is None:
1967
2348
old_label = 'old/'
1968
2349
new_label = 'new/'
1970
old_label, new_label = prefix.split(":")
2350
elif u':' in prefix:
2351
old_label, new_label = prefix.split(u":")
1972
raise errors.BzrCommandError(
2353
raise errors.BzrCommandError(gettext(
1973
2354
'--prefix expects two values separated by a colon'
1974
' (eg "old/:new/")')
2355
' (eg "old/:new/")'))
1976
2357
if revision and len(revision) > 2:
1977
raise errors.BzrCommandError('bzr diff --revision takes exactly'
1978
' one or two revision specifiers')
2358
raise errors.BzrCommandError(gettext('brz diff --revision takes exactly'
2359
' one or two revision specifiers'))
1980
2361
if using is not None and format is not None:
1981
raise errors.BzrCommandError('--using and --format are mutually '
2362
raise errors.BzrCommandError(gettext(
2363
'{0} and {1} are mutually exclusive').format(
2364
'--using', '--format'))
1984
2366
(old_tree, new_tree,
1985
2367
old_branch, new_branch,
1986
2368
specific_files, extra_trees) = get_trees_and_branches_to_diff_locked(
1987
file_list, revision, old, new, self.add_cleanup, apply_view=True)
1988
return show_diff_trees(old_tree, new_tree, sys.stdout,
2369
file_list, revision, old, new, self._exit_stack, apply_view=True)
2370
# GNU diff on Windows uses ANSI encoding for filenames
2371
path_encoding = osutils.get_diff_header_encoding()
2372
return show_diff_trees(old_tree, new_tree, self.outf,
1989
2373
specific_files=specific_files,
1990
2374
external_diff_options=diff_options,
1991
2375
old_label=old_label, new_label=new_label,
1992
extra_trees=extra_trees, using=using,
2376
extra_trees=extra_trees,
2377
path_encoding=path_encoding,
2378
using=using, context=context,
1993
2379
format_cls=format)
2522
2963
_see_also = ['status', 'cat']
2523
2964
takes_args = ['path?']
2524
2965
takes_options = [
2527
Option('recursive', short_name='R',
2528
help='Recurse into subdirectories.'),
2530
help='Print paths relative to the root of the branch.'),
2531
Option('unknown', help='Print unknown files.'),
2532
Option('versioned', help='Print versioned files.',
2534
Option('ignored', help='Print ignored files.'),
2536
help='Write an ascii NUL (\\0) separator '
2537
'between files rather than a newline.'),
2539
help='List entries of a particular kind: file, directory, symlink.',
2968
Option('recursive', short_name='R',
2969
help='Recurse into subdirectories.'),
2971
help='Print paths relative to the root of the branch.'),
2972
Option('unknown', short_name='u',
2973
help='Print unknown files.'),
2974
Option('versioned', help='Print versioned files.',
2976
Option('ignored', short_name='i',
2977
help='Print ignored files.'),
2978
Option('kind', short_name='k',
2979
help=('List entries of a particular kind: file, '
2980
'directory, symlink, tree-reference.'),
2543
2987
@display_command
2544
2988
def run(self, revision=None, verbose=False,
2545
2989
recursive=False, from_root=False,
2546
2990
unknown=False, versioned=False, ignored=False,
2547
null=False, kind=None, show_ids=False, path=None):
2991
null=False, kind=None, show_ids=False, path=None, directory=None):
2549
if kind and kind not in ('file', 'directory', 'symlink'):
2550
raise errors.BzrCommandError('invalid kind specified')
2993
if kind and kind not in ('file', 'directory', 'symlink', 'tree-reference'):
2994
raise errors.BzrCommandError(gettext('invalid kind specified'))
2552
2996
if verbose and null:
2553
raise errors.BzrCommandError('Cannot set both --verbose and --null')
2997
raise errors.BzrCommandError(
2998
gettext('Cannot set both --verbose and --null'))
2554
2999
all = not (unknown or versioned or ignored)
2556
selection = {'I':ignored, '?':unknown, 'V':versioned}
3001
selection = {'I': ignored, '?': unknown, 'V': versioned}
2558
3003
if path is None:
2562
raise errors.BzrCommandError('cannot specify both --from-root'
3007
raise errors.BzrCommandError(gettext('cannot specify both --from-root'
2565
tree, branch, relpath = bzrdir.BzrDir.open_containing_tree_or_branch(
3010
tree, branch, relpath = \
3011
_open_directory_or_containing_tree_or_branch(fs_path, directory)
2568
3013
# Calculate the prefix to use
2660
3105
After adding, editing or deleting that file either indirectly by
2661
3106
using this command or directly by using an editor, be sure to commit
2664
Bazaar also supports a global ignore file ~/.bazaar/ignore. On Windows
2665
the global ignore file can be found in the application data directory as
2666
C:\\Documents and Settings\\<user>\\Application Data\\Bazaar\\2.0\\ignore.
3109
Breezy also supports a global ignore file ~/.config/breezy/ignore. On
3110
Windows the global ignore file can be found in the application data
3112
C:\\Documents and Settings\\<user>\\Application Data\\Breezy\\3.0\\ignore.
2667
3113
Global ignores are not touched by this command. The global ignore file
2668
3114
can be edited directly using an editor.
2670
3116
Patterns prefixed with '!' are exceptions to ignore patterns and take
2671
3117
precedence over regular ignores. Such exceptions are used to specify
2672
3118
files that should be versioned which would otherwise be ignored.
2674
3120
Patterns prefixed with '!!' act as regular ignore patterns, but have
2675
3121
precedence over the '!' exception patterns.
2677
Note: ignore patterns containing shell wildcards must be quoted from
3125
* Ignore patterns containing shell wildcards must be quoted from
3128
* Ignore patterns starting with "#" act as comments in the ignore file.
3129
To ignore patterns that begin with that character, use the "RE:" prefix.
2681
3132
Ignore the top level Makefile::
2683
bzr ignore ./Makefile
3134
brz ignore ./Makefile
2685
3136
Ignore .class files in all directories...::
2687
bzr ignore "*.class"
3138
brz ignore "*.class"
2689
3140
...but do not ignore "special.class"::
2691
bzr ignore "!special.class"
2693
Ignore .o files under the lib directory::
2695
bzr ignore "lib/**/*.o"
2697
Ignore .o files under the lib directory::
2699
bzr ignore "RE:lib/.*\.o"
3142
brz ignore "!special.class"
3144
Ignore files whose name begins with the "#" character::
3148
Ignore .o files under the lib directory::
3150
brz ignore "lib/**/*.o"
3152
Ignore .o files under the lib directory::
3154
brz ignore "RE:lib/.*\\.o"
2701
3156
Ignore everything but the "debian" toplevel directory::
2703
bzr ignore "RE:(?!debian/).*"
3158
brz ignore "RE:(?!debian/).*"
2705
3160
Ignore everything except the "local" toplevel directory,
2706
but always ignore "*~" autosave files, even under local/::
2709
bzr ignore "!./local"
3161
but always ignore autosave files ending in ~, even under local/::
3164
brz ignore "!./local"
2713
3168
_see_also = ['status', 'ignored', 'patterns']
2714
3169
takes_args = ['name_pattern*']
2716
Option('default-rules',
2717
help='Display the default ignore rules that bzr uses.')
3170
takes_options = ['directory',
3171
Option('default-rules',
3172
help='Display the default ignore rules that brz uses.')
2720
def run(self, name_pattern_list=None, default_rules=None):
2721
from bzrlib import ignores
3175
def run(self, name_pattern_list=None, default_rules=None,
3177
from breezy import ignores
2722
3178
if default_rules is not None:
2723
3179
# dump the default rules and exit
2724
3180
for pattern in ignores.USER_DEFAULTS:
2725
3181
self.outf.write("%s\n" % pattern)
2727
3183
if not name_pattern_list:
2728
raise errors.BzrCommandError("ignore requires at least one "
2729
"NAME_PATTERN or --default-rules.")
3184
raise errors.BzrCommandError(gettext("ignore requires at least one "
3185
"NAME_PATTERN or --default-rules."))
2730
3186
name_pattern_list = [globbing.normalize_pattern(p)
2731
3187
for p in name_pattern_list]
3189
bad_patterns_count = 0
3190
for p in name_pattern_list:
3191
if not globbing.Globster.is_pattern_valid(p):
3192
bad_patterns_count += 1
3193
bad_patterns += ('\n %s' % p)
3195
msg = (ngettext('Invalid ignore pattern found. %s',
3196
'Invalid ignore patterns found. %s',
3197
bad_patterns_count) % bad_patterns)
3198
ui.ui_factory.show_error(msg)
3199
raise lazy_regex.InvalidPattern('')
2732
3200
for name_pattern in name_pattern_list:
2733
3201
if (name_pattern[0] == '/' or
2734
(len(name_pattern) > 1 and name_pattern[1] == ':')):
2735
raise errors.BzrCommandError(
2736
"NAME_PATTERN should not be an absolute path")
2737
tree, relpath = WorkingTree.open_containing(u'.')
3202
(len(name_pattern) > 1 and name_pattern[1] == ':')):
3203
raise errors.BzrCommandError(gettext(
3204
"NAME_PATTERN should not be an absolute path"))
3205
tree, relpath = WorkingTree.open_containing(directory)
2738
3206
ignores.tree_ignores_add_patterns(tree, name_pattern_list)
2739
3207
ignored = globbing.Globster(name_pattern_list)
2742
for entry in tree.list_files():
3209
self.enter_context(tree.lock_read())
3210
for filename, fc, fkind, entry in tree.list_files():
3211
id = getattr(entry, 'file_id', None)
2744
3212
if id is not None:
2746
3213
if ignored.match(filename):
2747
3214
matches.append(filename)
2749
3215
if len(matches) > 0:
2750
self.outf.write("Warning: the following files are version controlled and"
2751
" match your ignore pattern:\n%s"
2752
"\nThese files will continue to be version controlled"
2753
" unless you 'bzr remove' them.\n" % ("\n".join(matches),))
3216
self.outf.write(gettext("Warning: the following files are version "
3217
"controlled and match your ignore pattern:\n%s"
3218
"\nThese files will continue to be version controlled"
3219
" unless you 'brz remove' them.\n") % ("\n".join(matches),))
2756
3222
class cmd_ignored(Command):
2829
3297
================= =========================
3300
encoding_type = 'exact'
2831
3301
takes_args = ['dest', 'branch_or_subdir?']
2834
help="Type of file to export to.",
2837
Option('filters', help='Apply content filters to export the '
2838
'convenient form.'),
2841
help="Name of the root directory inside the exported file."),
2842
Option('per-file-timestamps',
2843
help='Set modification time of files to that of the last '
2844
'revision in which it was changed.'),
3302
takes_options = ['directory',
3304
help="Type of file to export to.",
3307
Option('filters', help='Apply content filters to export the '
3308
'convenient form.'),
3311
help="Name of the root directory inside the exported file."),
3312
Option('per-file-timestamps',
3313
help='Set modification time of files to that of the last '
3314
'revision in which it was changed.'),
3315
Option('uncommitted',
3316
help='Export the working tree contents rather than that of the '
2846
3320
def run(self, dest, branch_or_subdir=None, revision=None, format=None,
2847
root=None, filters=False, per_file_timestamps=False):
2848
from bzrlib.export import export
3321
root=None, filters=False, per_file_timestamps=False, uncommitted=False,
3323
from .export import export, guess_format, get_root_name
2850
3325
if branch_or_subdir is None:
2851
tree = WorkingTree.open_containing(u'.')[0]
2855
b, subdir = Branch.open_containing(branch_or_subdir)
2858
rev_tree = _get_one_revision_tree('export', revision, branch=b, tree=tree)
3326
branch_or_subdir = directory
3328
(tree, b, subdir) = controldir.ControlDir.open_containing_tree_or_branch(
3330
if tree is not None:
3331
self.enter_context(tree.lock_read())
3335
raise errors.BzrCommandError(
3336
gettext("--uncommitted requires a working tree"))
3339
export_tree = _get_one_revision_tree(
3340
'export', revision, branch=b,
3344
format = guess_format(dest)
3347
root = get_root_name(dest)
3349
if not per_file_timestamps:
3350
force_mtime = time.time()
3355
from breezy.filter_tree import ContentFilterTree
3356
export_tree = ContentFilterTree(
3357
export_tree, export_tree._content_filter_stack)
2860
export(rev_tree, dest, format, root, subdir, filtered=filters,
3360
export(export_tree, dest, format, root, subdir,
2861
3361
per_file_timestamps=per_file_timestamps)
2862
except errors.NoSuchExportFormat, e:
2863
raise errors.BzrCommandError('Unsupported export format: %s' % e.format)
3362
except errors.NoSuchExportFormat as e:
3363
raise errors.BzrCommandError(
3364
gettext('Unsupported export format: %s') % e.format)
2866
3367
class cmd_cat(Command):
2875
3376
_see_also = ['ls']
2877
Option('name-from-revision', help='The path name in the old tree.'),
2878
Option('filters', help='Apply content filters to display the '
2879
'convenience form.'),
3377
takes_options = ['directory',
3378
Option('name-from-revision',
3379
help='The path name in the old tree.'),
3380
Option('filters', help='Apply content filters to display the '
3381
'convenience form.'),
2882
3384
takes_args = ['filename']
2883
3385
encoding_type = 'exact'
2885
3387
@display_command
2886
3388
def run(self, filename, revision=None, name_from_revision=False,
3389
filters=False, directory=None):
2888
3390
if revision is not None and len(revision) != 1:
2889
raise errors.BzrCommandError("bzr cat --revision takes exactly"
2890
" one revision specifier")
3391
raise errors.BzrCommandError(gettext("brz cat --revision takes exactly"
3392
" one revision specifier"))
2891
3393
tree, branch, relpath = \
2892
bzrdir.BzrDir.open_containing_tree_or_branch(filename)
2894
self.add_cleanup(branch.unlock)
3394
_open_directory_or_containing_tree_or_branch(filename, directory)
3395
self.enter_context(branch.lock_read())
2895
3396
return self._run(tree, branch, relpath, filename, revision,
2896
3397
name_from_revision, filters)
2898
3399
def _run(self, tree, b, relpath, filename, revision, name_from_revision,
2900
3402
if tree is None:
2901
3403
tree = b.basis_tree()
2902
3404
rev_tree = _get_one_revision_tree('cat', revision, branch=b)
2903
rev_tree.lock_read()
2904
self.add_cleanup(rev_tree.unlock)
2906
old_file_id = rev_tree.path2id(relpath)
3405
self.enter_context(rev_tree.lock_read())
2908
3407
if name_from_revision:
2909
3408
# Try in revision if requested
2910
if old_file_id is None:
2911
raise errors.BzrCommandError(
2912
"%r is not present in revision %s" % (
3409
if not rev_tree.is_versioned(relpath):
3410
raise errors.BzrCommandError(gettext(
3411
"{0!r} is not present in revision {1}").format(
2913
3412
filename, rev_tree.get_revision_id()))
2915
content = rev_tree.get_file_text(old_file_id)
3413
rev_tree_path = relpath
2917
cur_file_id = tree.path2id(relpath)
2919
if cur_file_id is not None:
2920
# Then try with the actual file id
2922
content = rev_tree.get_file_text(cur_file_id)
2924
except errors.NoSuchId:
2925
# The actual file id didn't exist at that time
2927
if not found and old_file_id is not None:
2928
# Finally try with the old file id
2929
content = rev_tree.get_file_text(old_file_id)
2932
# Can't be found anywhere
2933
raise errors.BzrCommandError(
2934
"%r is not present in revision %s" % (
2935
filename, rev_tree.get_revision_id()))
3416
rev_tree_path = _mod_tree.find_previous_path(
3417
tree, rev_tree, relpath)
3418
except errors.NoSuchFile:
3419
rev_tree_path = None
3421
if rev_tree_path is None:
3422
# Path didn't exist in working tree
3423
if not rev_tree.is_versioned(relpath):
3424
raise errors.BzrCommandError(gettext(
3425
"{0!r} is not present in revision {1}").format(
3426
filename, rev_tree.get_revision_id()))
3428
# Fall back to the same path in the basis tree, if present.
3429
rev_tree_path = relpath
2937
from bzrlib.filters import (
2938
ContentFilterContext,
2939
filtered_output_bytes,
2941
filters = rev_tree._content_filter_stack(relpath)
2942
chunks = content.splitlines(True)
2943
content = filtered_output_bytes(chunks, filters,
2944
ContentFilterContext(relpath, rev_tree))
2946
self.outf.writelines(content)
3432
from .filter_tree import ContentFilterTree
3433
filter_tree = ContentFilterTree(
3434
rev_tree, rev_tree._content_filter_stack)
3435
fileobj = filter_tree.get_file(rev_tree_path)
2949
self.outf.write(content)
3437
fileobj = rev_tree.get_file(rev_tree_path)
3438
shutil.copyfileobj(fileobj, self.outf)
2952
3442
class cmd_local_time_offset(Command):
2953
3443
__doc__ = """Show the offset in seconds from GMT to local time."""
2955
3446
@display_command
2957
3448
self.outf.write("%s\n" % osutils.local_time_offset())
2961
3451
class cmd_commit(Command):
2962
3452
__doc__ = """Commit changes into a new revision.
2994
3484
"John Doe <jdoe@example.com>". If there is more than one author of
2995
3485
the change you can specify the option multiple times, once for each
3000
3490
A common mistake is to forget to add a new file or directory before
3001
3491
running the commit command. The --strict option checks for unknown
3002
3492
files and aborts the commit if any are found. More advanced pre-commit
3003
checks can be implemented by defining hooks. See ``bzr help hooks``
3493
checks can be implemented by defining hooks. See ``brz help hooks``
3006
3496
:Things to note:
3008
If you accidentially commit the wrong changes or make a spelling
3498
If you accidentally commit the wrong changes or make a spelling
3009
3499
mistake in the commit message say, you can use the uncommit command
3010
to undo it. See ``bzr help uncommit`` for details.
3500
to undo it. See ``brz help uncommit`` for details.
3012
3502
Hooks can also be configured to run after a commit. This allows you
3013
3503
to trigger updates to external systems like bug trackers. The --fixes
3014
3504
option can be used to record the association between a revision and
3015
one or more bugs. See ``bzr help bugs`` for details.
3017
A selective commit may fail in some cases where the committed
3018
tree would be invalid. Consider::
3023
bzr commit foo -m "committing foo"
3024
bzr mv foo/bar foo/baz
3027
bzr commit foo/bar -m "committing bar but not baz"
3029
In the example above, the last commit will fail by design. This gives
3030
the user the opportunity to decide whether they want to commit the
3031
rename at the same time, separately first, or not at all. (As a general
3032
rule, when in doubt, Bazaar has a policy of Doing the Safe Thing.)
3505
one or more bugs. See ``brz help bugs`` for details.
3034
# TODO: Run hooks on tree to-be-committed, and after commit.
3036
# TODO: Strict commit that fails if there are deleted files.
3037
# (what does "deleted files" mean ??)
3039
# TODO: Give better message for -s, --summary, used by tla people
3041
# XXX: verbose currently does nothing
3043
3508
_see_also = ['add', 'bugs', 'hooks', 'uncommit']
3044
3509
takes_args = ['selected*']
3045
3510
takes_options = [
3046
ListOption('exclude', type=str, short_name='x',
3047
help="Do not consider changes made to a given path."),
3048
Option('message', type=unicode,
3050
help="Description of the new revision."),
3053
help='Commit even if nothing has changed.'),
3054
Option('file', type=str,
3057
help='Take commit message from this file.'),
3059
help="Refuse to commit if there are unknown "
3060
"files in the working tree."),
3061
Option('commit-time', type=str,
3062
help="Manually set a commit time using commit date "
3063
"format, e.g. '2009-10-10 08:00:00 +0100'."),
3064
ListOption('fixes', type=str,
3065
help="Mark a bug as being fixed by this revision "
3066
"(see \"bzr help bugs\")."),
3067
ListOption('author', type=unicode,
3068
help="Set the author's name, if it's different "
3069
"from the committer."),
3071
help="Perform a local commit in a bound "
3072
"branch. Local commits are not pushed to "
3073
"the master branch until a normal commit "
3076
Option('show-diff', short_name='p',
3077
help='When no message is supplied, show the diff along'
3078
' with the status summary in the message editor.'),
3512
'exclude', type=text_type, short_name='x',
3513
help="Do not consider changes made to a given path."),
3514
Option('message', type=text_type,
3516
help="Description of the new revision."),
3519
help='Commit even if nothing has changed.'),
3520
Option('file', type=text_type,
3523
help='Take commit message from this file.'),
3525
help="Refuse to commit if there are unknown "
3526
"files in the working tree."),
3527
Option('commit-time', type=text_type,
3528
help="Manually set a commit time using commit date "
3529
"format, e.g. '2009-10-10 08:00:00 +0100'."),
3531
'bugs', type=text_type,
3532
help="Link to a related bug. (see \"brz help bugs\")."),
3534
'fixes', type=text_type,
3535
help="Mark a bug as being fixed by this revision "
3536
"(see \"brz help bugs\")."),
3538
'author', type=text_type,
3539
help="Set the author's name, if it's different "
3540
"from the committer."),
3542
help="Perform a local commit in a bound "
3543
"branch. Local commits are not pushed to "
3544
"the master branch until a normal commit "
3547
Option('show-diff', short_name='p',
3548
help='When no message is supplied, show the diff along'
3549
' with the status summary in the message editor.'),
3551
help='When committing to a foreign version control '
3552
'system do not push data that can not be natively '
3080
3554
aliases = ['ci', 'checkin']
3082
def _iter_bug_fix_urls(self, fixes, branch):
3556
def _iter_bug_urls(self, bugs, branch, status):
3557
default_bugtracker = None
3083
3558
# Configure the properties for bug fixing attributes.
3084
for fixed_bug in fixes:
3085
tokens = fixed_bug.split(':')
3086
if len(tokens) != 2:
3087
raise errors.BzrCommandError(
3560
tokens = bug.split(':')
3561
if len(tokens) == 1:
3562
if default_bugtracker is None:
3563
branch_config = branch.get_config_stack()
3564
default_bugtracker = branch_config.get(
3566
if default_bugtracker is None:
3567
raise errors.BzrCommandError(gettext(
3568
"No tracker specified for bug %s. Use the form "
3569
"'tracker:id' or specify a default bug tracker "
3570
"using the `bugtracker` option.\nSee "
3571
"\"brz help bugs\" for more information on this "
3572
"feature. Commit refused.") % bug)
3573
tag = default_bugtracker
3575
elif len(tokens) != 2:
3576
raise errors.BzrCommandError(gettext(
3088
3577
"Invalid bug %s. Must be in the form of 'tracker:id'. "
3089
"See \"bzr help bugs\" for more information on this "
3090
"feature.\nCommit refused." % fixed_bug)
3091
tag, bug_id = tokens
3578
"See \"brz help bugs\" for more information on this "
3579
"feature.\nCommit refused.") % bug)
3581
tag, bug_id = tokens
3093
yield bugtracker.get_bug_url(tag, branch, bug_id)
3094
except errors.UnknownBugTrackerAbbreviation:
3095
raise errors.BzrCommandError(
3096
'Unrecognized bug %s. Commit refused.' % fixed_bug)
3097
except errors.MalformedBugIdentifier, e:
3098
raise errors.BzrCommandError(
3099
"%s\nCommit refused." % (str(e),))
3583
yield bugtracker.get_bug_url(tag, branch, bug_id), status
3584
except bugtracker.UnknownBugTrackerAbbreviation:
3585
raise errors.BzrCommandError(gettext(
3586
'Unrecognized bug %s. Commit refused.') % bug)
3587
except bugtracker.MalformedBugIdentifier as e:
3588
raise errors.BzrCommandError(gettext(
3589
u"%s\nCommit refused.") % (e,))
3101
3591
def run(self, message=None, file=None, verbose=False, selected_list=None,
3102
unchanged=False, strict=False, local=False, fixes=None,
3103
author=None, show_diff=False, exclude=None, commit_time=None):
3104
from bzrlib.errors import (
3592
unchanged=False, strict=False, local=False, fixes=None, bugs=None,
3593
author=None, show_diff=False, exclude=None, commit_time=None,
3596
from .commit import (
3105
3597
PointlessCommit,
3599
from .errors import (
3106
3600
ConflictsInTree,
3107
3601
StrictCommitFailed
3109
from bzrlib.msgeditor import (
3603
from .msgeditor import (
3110
3604
edit_commit_message_encoded,
3111
3605
generate_commit_message_template,
3112
make_commit_message_template_encoded
3606
make_commit_message_template_encoded,
3115
3610
commit_stamp = offset = None
3116
3611
if commit_time is not None:
3118
3613
commit_stamp, offset = timestamp.parse_patch_date(commit_time)
3119
except ValueError, e:
3120
raise errors.BzrCommandError(
3121
"Could not parse --commit-time: " + str(e))
3123
# TODO: Need a blackbox test for invoking the external editor; may be
3124
# slightly problematic to run this cross-platform.
3126
# TODO: do more checks that the commit will succeed before
3127
# spending the user's valuable time typing a commit message.
3614
except ValueError as e:
3615
raise errors.BzrCommandError(gettext(
3616
"Could not parse --commit-time: " + str(e)))
3129
3618
properties = {}
3131
tree, selected_list = tree_files(selected_list)
3620
tree, selected_list = WorkingTree.open_containing_paths(selected_list)
3132
3621
if selected_list == ['']:
3133
3622
# workaround - commit of root of tree should be exactly the same
3134
3623
# as just default commit in that tree, and succeed even though
3297
3801
class cmd_upgrade(Command):
3298
__doc__ = """Upgrade branch storage to current format.
3300
The check command or bzr developers may sometimes advise you to run
3301
this command. When the default format has changed you may also be warned
3302
during other operations to upgrade.
3802
__doc__ = """Upgrade a repository, branch or working tree to a newer format.
3804
When the default format has changed after a major new release of
3805
Bazaar/Breezy, you may be informed during certain operations that you
3806
should upgrade. Upgrading to a newer format may improve performance
3807
or make new features available. It may however limit interoperability
3808
with older repositories or with older versions of Bazaar or Breezy.
3810
If you wish to upgrade to a particular format rather than the
3811
current default, that can be specified using the --format option.
3812
As a consequence, you can use the upgrade command this way to
3813
"downgrade" to an earlier format, though some conversions are
3814
a one way process (e.g. changing from the 1.x default to the
3815
2.x default) so downgrading is not always possible.
3817
A backup.bzr.~#~ directory is created at the start of the conversion
3818
process (where # is a number). By default, this is left there on
3819
completion. If the conversion fails, delete the new .bzr directory
3820
and rename this one back in its place. Use the --clean option to ask
3821
for the backup.bzr directory to be removed on successful conversion.
3822
Alternatively, you can delete it by hand if everything looks good
3825
If the location given is a shared repository, dependent branches
3826
are also converted provided the repository converts successfully.
3827
If the conversion of a branch fails, remaining branches are still
3830
For more information on upgrades, see the Breezy Upgrade Guide,
3831
https://www.breezy-vcs.org/doc/en/upgrade-guide/.
3305
_see_also = ['check']
3834
_see_also = ['check', 'reconcile', 'formats']
3306
3835
takes_args = ['url?']
3307
3836
takes_options = [
3308
RegistryOption('format',
3309
help='Upgrade to a specific format. See "bzr help'
3310
' formats" for details.',
3311
lazy_registry=('bzrlib.bzrdir', 'format_registry'),
3312
converter=lambda name: bzrdir.format_registry.make_bzrdir(name),
3313
value_switches=True, title='Branch format'),
3837
RegistryOption('format',
3838
help='Upgrade to a specific format. See "brz help'
3839
' formats" for details.',
3840
lazy_registry=('breezy.controldir', 'format_registry'),
3841
converter=lambda name: controldir.format_registry.make_controldir(
3843
value_switches=True, title='Branch format'),
3845
help='Remove the backup.bzr directory if successful.'),
3847
help="Show what would be done, but don't actually do anything."),
3316
def run(self, url='.', format=None):
3317
from bzrlib.upgrade import upgrade
3318
upgrade(url, format)
3850
def run(self, url='.', format=None, clean=False, dry_run=False):
3851
from .upgrade import upgrade
3852
exceptions = upgrade(url, format, clean_up=clean, dry_run=dry_run)
3854
if len(exceptions) == 1:
3855
# Compatibility with historical behavior
3321
3861
class cmd_whoami(Command):
3322
__doc__ = """Show or set bzr user id.
3862
__doc__ = """Show or set brz user id.
3325
3865
Show the email of the current user::
3329
3869
Set the current user::
3331
bzr whoami "Frank Chu <fchu@example.com>"
3871
brz whoami "Frank Chu <fchu@example.com>"
3333
takes_options = [ Option('email',
3334
help='Display email address only.'),
3336
help='Set identity for the current branch instead of '
3873
takes_options = ['directory',
3875
help='Display email address only.'),
3877
help='Set identity for the current branch instead of '
3339
3880
takes_args = ['name?']
3340
3881
encoding_type = 'replace'
3342
3883
@display_command
3343
def run(self, email=False, branch=False, name=None):
3884
def run(self, email=False, branch=False, name=None, directory=None):
3344
3885
if name is None:
3345
# use branch if we're inside one; otherwise global config
3347
c = Branch.open_containing('.')[0].get_config()
3348
except errors.NotBranchError:
3349
c = config.GlobalConfig()
3886
if directory is None:
3887
# use branch if we're inside one; otherwise global config
3889
c = Branch.open_containing(u'.')[0].get_config_stack()
3890
except errors.NotBranchError:
3891
c = _mod_config.GlobalStack()
3893
c = Branch.open(directory).get_config_stack()
3894
identity = c.get('email')
3351
self.outf.write(c.user_email() + '\n')
3896
self.outf.write(_mod_config.extract_email_address(identity)
3353
self.outf.write(c.username() + '\n')
3899
self.outf.write(identity + '\n')
3903
raise errors.BzrCommandError(gettext("--email can only be used to display existing "
3356
3906
# display a warning if an email address isn't included in the given name.
3358
config.extract_email_address(name)
3359
except errors.NoEmailInUsername, e:
3908
_mod_config.extract_email_address(name)
3909
except _mod_config.NoEmailInUsername:
3360
3910
warning('"%s" does not seem to contain an email address. '
3361
3911
'This is allowed, but not recommended.', name)
3363
3913
# use global config unless --branch given
3365
c = Branch.open_containing('.')[0].get_config()
3915
if directory is None:
3916
c = Branch.open_containing(u'.')[0].get_config_stack()
3918
b = Branch.open(directory)
3919
self.enter_context(b.lock_write())
3920
c = b.get_config_stack()
3367
c = config.GlobalConfig()
3368
c.set_user_option('email', name)
3922
c = _mod_config.GlobalStack()
3923
c.set('email', name)
3371
3926
class cmd_nick(Command):
3372
3927
__doc__ = """Print or set the branch nickname.
3374
If unset, the tree root directory name is used as the nickname.
3375
To print the current nickname, execute with no argument.
3929
If unset, the colocated branch name is used for colocated branches, and
3930
the branch directory name is used for other branches. To print the
3931
current nickname, execute with no argument.
3377
3933
Bound branches use the nickname of its master branch unless it is set
3586
4151
def run(self, testspecs_list=None, verbose=False, one=False,
3587
4152
transport=None, benchmark=None,
3588
lsprof_timed=None, cache_dir=None,
3589
4154
first=False, list_only=False,
3590
4155
randomize=None, exclude=None, strict=False,
3591
load_list=None, debugflag=None, starting_with=None, subunit=False,
3592
parallel=None, lsprof_tests=False):
3593
from bzrlib.tests import selftest
3594
import bzrlib.benchmarks as benchmarks
3595
from bzrlib.benchmarks import tree_creator
3597
# Make deprecation warnings visible, unless -Werror is set
3598
symbol_versioning.activate_deprecation_warnings(override=False)
3600
if cache_dir is not None:
3601
tree_creator.TreeCreator.CACHE_ROOT = osutils.abspath(cache_dir)
4156
load_list=None, debugflag=None, starting_with=None, subunit1=False,
4157
subunit2=False, parallel=None, lsprof_tests=False, sync=False):
4159
# During selftest, disallow proxying, as it can cause severe
4160
# performance penalties and is only needed for thread
4161
# safety. The selftest command is assumed to not use threads
4162
# too heavily. The call should be as early as possible, as
4163
# error reporting for past duplicate imports won't have useful
4165
if sys.version_info[0] < 3:
4166
# TODO(pad.lv/1696545): Allow proxying on Python 3, since
4167
# disallowing it currently leads to failures in many places.
4168
lazy_import.disallow_proxying()
4173
raise errors.BzrCommandError("tests not available. Install the "
4174
"breezy tests to run the breezy testsuite.")
3602
4176
if testspecs_list is not None:
3603
4177
pattern = '|'.join(testspecs_list)
3608
from bzrlib.tests import SubUnitBzrRunner
4182
from .tests import SubUnitBzrRunnerv1
3609
4183
except ImportError:
3610
raise errors.BzrCommandError("subunit not available. subunit "
3611
"needs to be installed to use --subunit.")
3612
self.additional_selftest_args['runner_class'] = SubUnitBzrRunner
4184
raise errors.BzrCommandError(gettext(
4185
"subunit not available. subunit needs to be installed "
4186
"to use --subunit."))
4187
self.additional_selftest_args['runner_class'] = SubUnitBzrRunnerv1
3613
4188
# On Windows, disable automatic conversion of '\n' to '\r\n' in
3614
# stdout, which would corrupt the subunit stream.
3615
if sys.platform == "win32" and sys.stdout.fileno() >= 0:
4189
# stdout, which would corrupt the subunit stream.
4190
# FIXME: This has been fixed in subunit trunk (>0.0.5) so the
4191
# following code can be deleted when it's sufficiently deployed
4192
# -- vila/mgz 20100514
4193
if (sys.platform == "win32"
4194
and getattr(sys.stdout, 'fileno', None) is not None):
3617
4196
msvcrt.setmode(sys.stdout.fileno(), os.O_BINARY)
4199
from .tests import SubUnitBzrRunnerv2
4201
raise errors.BzrCommandError(gettext(
4202
"subunit not available. subunit "
4203
"needs to be installed to use --subunit2."))
4204
self.additional_selftest_args['runner_class'] = SubUnitBzrRunnerv2
3619
4207
self.additional_selftest_args.setdefault(
3620
4208
'suite_decorators', []).append(parallel)
3622
test_suite_factory = benchmarks.test_suite
3623
# Unless user explicitly asks for quiet, be verbose in benchmarks
3624
verbose = not is_quiet()
3625
# TODO: should possibly lock the history file...
3626
benchfile = open(".perf_history", "at", buffering=1)
3627
self.add_cleanup(benchfile.close)
4210
raise errors.BzrCommandError(gettext(
4211
"--benchmark is no longer supported from brz 2.2; "
4212
"use bzr-usertest instead"))
4213
test_suite_factory = None
4215
exclude_pattern = None
3629
test_suite_factory = None
4217
exclude_pattern = '(' + '|'.join(exclude) + ')'
4219
self._disable_fsync()
3631
4220
selftest_kwargs = {"verbose": verbose,
3633
"stop_on_failure": one,
3634
"transport": transport,
3635
"test_suite_factory": test_suite_factory,
3636
"lsprof_timed": lsprof_timed,
3637
"lsprof_tests": lsprof_tests,
3638
"bench_history": benchfile,
3639
"matching_tests_first": first,
3640
"list_only": list_only,
3641
"random_seed": randomize,
3642
"exclude_pattern": exclude,
3644
"load_list": load_list,
3645
"debug_flags": debugflag,
3646
"starting_with": starting_with
4222
"stop_on_failure": one,
4223
"transport": transport,
4224
"test_suite_factory": test_suite_factory,
4225
"lsprof_timed": lsprof_timed,
4226
"lsprof_tests": lsprof_tests,
4227
"matching_tests_first": first,
4228
"list_only": list_only,
4229
"random_seed": randomize,
4230
"exclude_pattern": exclude_pattern,
4232
"load_list": load_list,
4233
"debug_flags": debugflag,
4234
"starting_with": starting_with
3648
4236
selftest_kwargs.update(self.additional_selftest_args)
3649
result = selftest(**selftest_kwargs)
4238
# Make deprecation warnings visible, unless -Werror is set
4239
cleanup = symbol_versioning.activate_deprecation_warnings(
4242
result = tests.selftest(**selftest_kwargs)
3650
4245
return int(not result)
4247
def _disable_fsync(self):
4248
"""Change the 'os' functionality to not synchronize."""
4249
self._orig_fsync = getattr(os, 'fsync', None)
4250
if self._orig_fsync is not None:
4251
os.fsync = lambda filedes: None
4252
self._orig_fdatasync = getattr(os, 'fdatasync', None)
4253
if self._orig_fdatasync is not None:
4254
os.fdatasync = lambda filedes: None
3653
4257
class cmd_version(Command):
3654
__doc__ = """Show version of bzr."""
4258
__doc__ = """Show version of brz."""
3656
4260
encoding_type = 'replace'
3657
4261
takes_options = [
3709
4312
The source of the merge can be specified either in the form of a branch,
3710
4313
or in the form of a path to a file containing a merge directive generated
3711
with bzr send. If neither is specified, the default is the upstream branch
3712
or the branch most recently merged using --remember.
3714
When merging a branch, by default the tip will be merged. To pick a different
3715
revision, pass --revision. If you specify two values, the first will be used as
3716
BASE and the second one as OTHER. Merging individual revisions, or a subset of
3717
available revisions, like this is commonly referred to as "cherrypicking".
3719
Revision numbers are always relative to the branch being merged.
3721
By default, bzr will try to merge in all new work from the other
3722
branch, automatically determining an appropriate base. If this
3723
fails, you may need to give an explicit base.
4314
with brz send. If neither is specified, the default is the upstream branch
4315
or the branch most recently merged using --remember. The source of the
4316
merge may also be specified in the form of a path to a file in another
4317
branch: in this case, only the modifications to that file are merged into
4318
the current working tree.
4320
When merging from a branch, by default brz will try to merge in all new
4321
work from the other branch, automatically determining an appropriate base
4322
revision. If this fails, you may need to give an explicit base.
4324
To pick a different ending revision, pass "--revision OTHER". brz will
4325
try to merge in all new work up to and including revision OTHER.
4327
If you specify two values, "--revision BASE..OTHER", only revisions BASE
4328
through OTHER, excluding BASE but including OTHER, will be merged. If this
4329
causes some revisions to be skipped, i.e. if the destination branch does
4330
not already contain revision BASE, such a merge is commonly referred to as
4331
a "cherrypick". Unlike a normal merge, Breezy does not currently track
4332
cherrypicks. The changes look like a normal commit, and the history of the
4333
changes from the other branch is not stored in the commit.
4335
Revision numbers are always relative to the source branch.
3725
4337
Merge will do its best to combine the changes in two branches, but there
3726
4338
are some kinds of problems only a human can fix. When it encounters those,
3727
4339
it will mark a conflict. A conflict means that you need to fix something,
3728
before you should commit.
3730
Use bzr resolve when you have fixed a problem. See also bzr conflicts.
3732
If there is no default branch set, the first merge will set it. After
3733
that, you can omit the branch to use the default. To change the
3734
default, use --remember. The value will only be saved if the remote
3735
location can be accessed.
4340
before you can commit.
4342
Use brz resolve when you have fixed a problem. See also brz conflicts.
4344
If there is no default branch set, the first merge will set it (use
4345
--no-remember to avoid setting it). After that, you can omit the branch
4346
to use the default. To change the default, use --remember. The value will
4347
only be saved if the remote location can be accessed.
3737
4349
The results of the merge are placed into the destination working
3738
directory, where they can be reviewed (with bzr diff), tested, and then
4350
directory, where they can be reviewed (with brz diff), tested, and then
3739
4351
committed to record the result of the merge.
3741
4353
merge refuses to run if there are any uncommitted changes, unless
3742
--force is given. The --force option can also be used to create a
4354
--force is given. If --force is given, then the changes from the source
4355
will be merged with the current working tree, including any uncommitted
4356
changes in the tree. The --force option can also be used to create a
3743
4357
merge revision which has more than two parents.
3745
4359
If one would like to merge changes from the working tree of the other
3836
4447
change_reporter = delta._ChangeReporter(
3837
4448
unversioned_filter=tree.is_ignored, view_info=view_info)
3838
4449
pb = ui.ui_factory.nested_progress_bar()
3839
self.add_cleanup(pb.finished)
3841
self.add_cleanup(tree.unlock)
4450
self.enter_context(pb)
4451
self.enter_context(tree.lock_write())
3842
4452
if location is not None:
3844
mergeable = bundle.read_mergeable_from_url(location,
3845
possible_transports=possible_transports)
4454
mergeable = _mod_mergeable.read_mergeable_from_url(
4455
location, possible_transports=possible_transports)
3846
4456
except errors.NotABundle:
3847
4457
mergeable = None
3849
4459
if uncommitted:
3850
raise errors.BzrCommandError('Cannot use --uncommitted'
3851
' with bundles or merge directives.')
4460
raise errors.BzrCommandError(gettext('Cannot use --uncommitted'
4461
' with bundles or merge directives.'))
3853
4463
if revision is not None:
3854
raise errors.BzrCommandError(
3855
'Cannot use -r with merge directives or bundles')
4464
raise errors.BzrCommandError(gettext(
4465
'Cannot use -r with merge directives or bundles'))
3856
4466
merger, verified = _mod_merge.Merger.from_mergeable(tree,
3859
4469
if merger is None and uncommitted:
3860
4470
if revision is not None and len(revision) > 0:
3861
raise errors.BzrCommandError('Cannot use --uncommitted and'
3862
' --revision at the same time.')
4471
raise errors.BzrCommandError(gettext('Cannot use --uncommitted and'
4472
' --revision at the same time.'))
3863
4473
merger = self.get_merger_from_uncommitted(tree, location, None)
3864
4474
allow_pending = False
3866
4476
if merger is None:
3867
4477
merger, allow_pending = self._get_merger_from_branch(tree,
3868
location, revision, remember, possible_transports, None)
4478
location, revision, remember, possible_transports, None)
3870
4480
merger.merge_type = merge_type
3871
4481
merger.reprocess = reprocess
3872
4482
merger.show_base = show_base
3873
4483
self.sanity_check_merger(merger)
3874
4484
if (merger.base_rev_id == merger.other_rev_id and
3875
merger.other_rev_id is not None):
3876
note('Nothing to do.')
4485
merger.other_rev_id is not None):
4486
# check if location is a nonexistent file (and not a branch) to
4487
# disambiguate the 'Nothing to do'
4488
if merger.interesting_files:
4489
if not merger.other_tree.has_filename(
4490
merger.interesting_files[0]):
4491
note(gettext("merger: ") + str(merger))
4492
raise errors.PathsDoNotExist([location])
4493
note(gettext('Nothing to do.'))
4495
if pull and not preview:
3879
4496
if merger.interesting_files is not None:
3880
raise errors.BzrCommandError('Cannot pull individual files')
4497
raise errors.BzrCommandError(
4498
gettext('Cannot pull individual files'))
3881
4499
if (merger.base_rev_id == tree.last_revision()):
3882
4500
result = tree.pull(merger.other_branch, False,
3883
4501
merger.other_rev_id)
3884
4502
result.report(self.outf)
3886
4504
if merger.this_basis is None:
3887
raise errors.BzrCommandError(
4505
raise errors.BzrCommandError(gettext(
3888
4506
"This branch has no commits."
3889
" (perhaps you would prefer 'bzr pull')")
4507
" (perhaps you would prefer 'brz pull')"))
3891
4509
return self._do_preview(merger)
3892
4510
elif interactive:
4079
4716
Re-do the merge of all conflicted files, and show the base text in
4080
4717
conflict regions, in addition to the usual THIS and OTHER texts::
4082
bzr remerge --show-base
4719
brz remerge --show-base
4084
4721
Re-do the merge of "foobar", using the weave merge algorithm, with
4085
4722
additional processing to reduce the size of conflict regions::
4087
bzr remerge --merge-type weave --reprocess foobar
4724
brz remerge --merge-type weave --reprocess foobar
4089
4726
takes_args = ['file*']
4090
4727
takes_options = [
4094
help="Show base revision text in conflicts."),
4731
help="Show base revision text in conflicts."),
4097
4734
def run(self, file_list=None, merge_type=None, show_base=False,
4098
4735
reprocess=False):
4099
from bzrlib.conflicts import restore
4736
from .conflicts import restore
4100
4737
if merge_type is None:
4101
4738
merge_type = _mod_merge.Merge3Merger
4102
tree, file_list = tree_files(file_list)
4104
self.add_cleanup(tree.unlock)
4739
tree, file_list = WorkingTree.open_containing_paths(file_list)
4740
self.enter_context(tree.lock_write())
4105
4741
parents = tree.get_parent_ids()
4106
4742
if len(parents) != 2:
4107
raise errors.BzrCommandError("Sorry, remerge only works after normal"
4108
" merges. Not cherrypicking or"
4110
repository = tree.branch.repository
4111
interesting_ids = None
4743
raise errors.BzrCommandError(
4744
gettext("Sorry, remerge only works after normal"
4745
" merges. Not cherrypicking or multi-merges."))
4746
interesting_files = None
4112
4747
new_conflicts = []
4113
4748
conflicts = tree.conflicts()
4114
4749
if file_list is not None:
4115
interesting_ids = set()
4750
interesting_files = set()
4116
4751
for filename in file_list:
4117
file_id = tree.path2id(filename)
4752
if not tree.is_versioned(filename):
4119
4753
raise errors.NotVersionedError(filename)
4120
interesting_ids.add(file_id)
4121
if tree.kind(file_id) != "directory":
4754
interesting_files.add(filename)
4755
if tree.kind(filename) != "directory":
4124
for name, ie in tree.inventory.iter_entries(file_id):
4125
interesting_ids.add(ie.file_id)
4758
for path, ie in tree.iter_entries_by_dir(
4759
specific_files=[filename]):
4760
interesting_files.add(path)
4126
4761
new_conflicts = conflicts.select_conflicts(tree, file_list)[0]
4128
4763
# Remerge only supports resolving contents conflicts
4129
4764
allowed_conflicts = ('text conflict', 'contents conflict')
4130
4765
restore_files = [c.path for c in conflicts
4131
4766
if c.typestring in allowed_conflicts]
4132
_mod_merge.transform_tree(tree, tree.basis_tree(), interesting_ids)
4767
_mod_merge.transform_tree(tree, tree.basis_tree(), interesting_files)
4133
4768
tree.set_conflicts(ConflictList(new_conflicts))
4134
4769
if file_list is not None:
4135
4770
restore_files = file_list
4578
5221
Option('long', help='Show commit date in annotations.'),
4582
5226
encoding_type = 'exact'
4584
5228
@display_command
4585
5229
def run(self, filename, all=False, long=False, revision=None,
4587
from bzrlib.annotate import annotate_file, annotate_file_tree
5230
show_ids=False, directory=None):
5231
from .annotate import (
4588
5234
wt, branch, relpath = \
4589
bzrdir.BzrDir.open_containing_tree_or_branch(filename)
5235
_open_directory_or_containing_tree_or_branch(filename, directory)
4590
5236
if wt is not None:
4592
self.add_cleanup(wt.unlock)
5237
self.enter_context(wt.lock_read())
4595
self.add_cleanup(branch.unlock)
5239
self.enter_context(branch.lock_read())
4596
5240
tree = _get_one_revision_tree('annotate', revision, branch=branch)
4598
self.add_cleanup(tree.unlock)
4600
file_id = wt.path2id(relpath)
4602
file_id = tree.path2id(relpath)
4604
raise errors.NotVersionedError(filename)
4605
file_version = tree.inventory[file_id].revision
5241
self.enter_context(tree.lock_read())
4606
5242
if wt is not None and revision is None:
5243
if not wt.is_versioned(relpath):
5244
raise errors.NotVersionedError(relpath)
4607
5245
# If there is a tree and we're not annotating historical
4608
5246
# versions, annotate the working tree's content.
4609
annotate_file_tree(wt, file_id, self.outf, long, all,
5247
annotate_file_tree(wt, relpath, self.outf, long, all,
4612
annotate_file(branch, file_version, file_id, long, all, self.outf,
5250
if not tree.is_versioned(relpath):
5251
raise errors.NotVersionedError(relpath)
5252
annotate_file_tree(tree, relpath, self.outf, long, all,
5253
show_ids=show_ids, branch=branch)
4616
5256
class cmd_re_sign(Command):
4617
5257
__doc__ = """Create a digital signature for an existing revision."""
4618
5258
# TODO be able to replace existing ones.
4620
hidden = True # is this right ?
5260
hidden = True # is this right ?
4621
5261
takes_args = ['revision_id*']
4622
takes_options = ['revision']
5262
takes_options = ['directory', 'revision']
4624
def run(self, revision_id_list=None, revision=None):
5264
def run(self, revision_id_list=None, revision=None, directory=u'.'):
4625
5265
if revision_id_list is not None and revision is not None:
4626
raise errors.BzrCommandError('You can only supply one of revision_id or --revision')
5266
raise errors.BzrCommandError(
5267
gettext('You can only supply one of revision_id or --revision'))
4627
5268
if revision_id_list is None and revision is None:
4628
raise errors.BzrCommandError('You must supply either --revision or a revision_id')
4629
b = WorkingTree.open_containing(u'.')[0].branch
4631
self.add_cleanup(b.unlock)
5269
raise errors.BzrCommandError(
5270
gettext('You must supply either --revision or a revision_id'))
5271
b = WorkingTree.open_containing(directory)[0].branch
5272
self.enter_context(b.lock_write())
4632
5273
return self._run(b, revision_id_list, revision)
4634
5275
def _run(self, b, revision_id_list, revision):
4635
import bzrlib.gpg as gpg
4636
gpg_strategy = gpg.GPGStrategy(b.get_config())
5276
from .repository import WriteGroup
5277
gpg_strategy = gpg.GPGStrategy(b.get_config_stack())
4637
5278
if revision_id_list is not None:
4638
b.repository.start_write_group()
5279
with WriteGroup(b.repository):
4640
5280
for revision_id in revision_id_list:
5281
revision_id = cache_utf8.encode(revision_id)
4641
5282
b.repository.sign_revision(revision_id, gpg_strategy)
4643
b.repository.abort_write_group()
4646
b.repository.commit_write_group()
4647
5283
elif revision is not None:
4648
5284
if len(revision) == 1:
4649
5285
revno, rev_id = revision[0].in_history(b)
4650
b.repository.start_write_group()
5286
with WriteGroup(b.repository):
4652
5287
b.repository.sign_revision(rev_id, gpg_strategy)
4654
b.repository.abort_write_group()
4657
b.repository.commit_write_group()
4658
5288
elif len(revision) == 2:
4659
5289
# are they both on rh- if so we can walk between them
4660
5290
# might be nice to have a range helper for arbitrary
4827
5458
end_revision=last_revno)
4830
self.outf.write('Dry-run, pretending to remove'
4831
' the above revisions.\n')
5461
self.outf.write(gettext('Dry-run, pretending to remove'
5462
' the above revisions.\n'))
4833
self.outf.write('The above revision(s) will be removed.\n')
5465
gettext('The above revision(s) will be removed.\n'))
4836
if not ui.ui_factory.get_boolean('Are you sure'):
4837
self.outf.write('Canceled')
5468
if not ui.ui_factory.confirm_action(
5469
gettext(u'Uncommit these revisions'),
5470
'breezy.builtins.uncommit',
5472
self.outf.write(gettext('Canceled\n'))
4840
5475
mutter('Uncommitting from {%s} to {%s}',
4841
5476
last_rev_id, rev_id)
4842
5477
uncommit(b, tree=tree, dry_run=dry_run, verbose=verbose,
4843
revno=revno, local=local)
4844
self.outf.write('You can restore the old tip by running:\n'
4845
' bzr pull . -r revid:%s\n' % last_rev_id)
5478
revno=revno, local=local, keep_tags=keep_tags)
5481
gettext('You can restore the old tip by running:\n'
5482
' brz pull -d %s %s -r revid:%s\n')
5483
% (location, location, last_rev_id.decode('utf-8')))
5486
gettext('You can restore the old tip by running:\n'
5487
' brz pull . -r revid:%s\n')
5488
% last_rev_id.decode('utf-8'))
4848
5491
class cmd_break_lock(Command):
4849
__doc__ = """Break a dead lock on a repository, branch or working directory.
5492
__doc__ = """Break a dead lock.
5494
This command breaks a lock on a repository, branch, working directory or
4851
5497
CAUTION: Locks should only be broken when you are sure that the process
4852
5498
holding the lock has been stopped.
4854
You can get information on what locks are open via the 'bzr info
5500
You can get information on what locks are open via the 'brz info
4855
5501
[location]' command.
4859
bzr break-lock bzr+ssh://example.com/bzr/foo
5505
brz break-lock brz+ssh://example.com/brz/foo
5506
brz break-lock --conf ~/.config/breezy
4861
5509
takes_args = ['location?']
5512
help='LOCATION is the directory where the config lock is.'),
5514
help='Do not ask for confirmation before breaking the lock.'),
4863
def run(self, location=None, show=False):
5517
def run(self, location=None, config=False, force=False):
4864
5518
if location is None:
4865
5519
location = u'.'
4866
control, relpath = bzrdir.BzrDir.open_containing(location)
4868
control.break_lock()
4869
except NotImplementedError:
5521
ui.ui_factory = ui.ConfirmationUserInterfacePolicy(ui.ui_factory,
5523
{'breezy.lockdir.break': True})
5525
conf = _mod_config.LockableConfig(file_name=location)
5528
control, relpath = controldir.ControlDir.open_containing(location)
5530
control.break_lock()
5531
except NotImplementedError:
4873
5535
class cmd_wait_until_signalled(Command):
4874
__doc__ = """Test helper for test_start_and_stop_bzr_subprocess_send_signal.
5536
__doc__ = """Test helper for test_start_and_stop_brz_subprocess_send_signal.
4876
5538
This just prints a line to signal when it is ready, then blocks on stdin.
4894
5556
help='Serve on stdin/out for use from inetd or sshd.'),
4895
5557
RegistryOption('protocol',
4896
help="Protocol to serve.",
4897
lazy_registry=('bzrlib.transport', 'transport_server_registry'),
4898
value_switches=True),
5558
help="Protocol to serve.",
5559
lazy_registry=('breezy.transport',
5560
'transport_server_registry'),
5561
value_switches=True),
5563
help='Listen for connections on nominated address.',
4900
help='Listen for connections on nominated port of the form '
4901
'[hostname:]portnumber. Passing 0 as the port number will '
4902
'result in a dynamically allocated port. The default port '
4903
'depends on the protocol.',
4906
help='Serve contents of this directory.',
5566
help='Listen for connections on nominated port. Passing 0 as '
5567
'the port number will result in a dynamically allocated '
5568
'port. The default port depends on the protocol.',
5570
custom_help('directory',
5571
help='Serve contents of this directory.'),
4908
5572
Option('allow-writes',
4909
5573
help='By default the server is a readonly server. Supplying '
4910
5574
'--allow-writes enables write access to the contents of '
4911
'the served directory and below. Note that ``bzr serve`` '
5575
'the served directory and below. Note that ``brz serve`` '
4912
5576
'does not perform authentication, so unless some form of '
4913
5577
'external authentication is arranged supplying this '
4914
5578
'option leads to global uncontrolled write access to your '
5581
Option('client-timeout', type=float,
5582
help='Override the default idle client timeout (5min).'),
4919
def get_host_and_port(self, port):
4920
"""Return the host and port to run the smart server on.
4922
If 'port' is None, None will be returned for the host and port.
4924
If 'port' has a colon in it, the string before the colon will be
4925
interpreted as the host.
4927
:param port: A string of the port to run the server on.
4928
:return: A tuple of (host, port), where 'host' is a host name or IP,
4929
and port is an integer TCP/IP port.
4932
if port is not None:
4934
host, port = port.split(':')
4938
def run(self, port=None, inet=False, directory=None, allow_writes=False,
4940
from bzrlib.transport import get_transport, transport_server_registry
5585
def run(self, listen=None, port=None, inet=False, directory=None,
5586
allow_writes=False, protocol=None, client_timeout=None):
5587
from . import location, transport
4941
5588
if directory is None:
4942
directory = os.getcwd()
5589
directory = osutils.getcwd()
4943
5590
if protocol is None:
4944
protocol = transport_server_registry.get()
4945
host, port = self.get_host_and_port(port)
4946
url = urlutils.local_path_to_url(directory)
5591
protocol = transport.transport_server_registry.get()
5592
url = location.location_to_url(directory)
4947
5593
if not allow_writes:
4948
5594
url = 'readonly+' + url
4949
transport = get_transport(url)
4950
protocol(transport, host, port, inet)
5595
t = transport.get_transport_from_url(url)
5596
protocol(t, listen, port, inet, client_timeout)
4953
5599
class cmd_join(Command):
5476
6135
takes_args = ['location?']
5477
6136
takes_options = [
5478
6137
RegistryOption.from_kwargs(
5480
title='Target type',
5481
help='The type to reconfigure the directory to.',
6140
help='The relation between branch and tree.',
5482
6141
value_switches=True, enum_switch=False,
5483
6142
branch='Reconfigure to be an unbound branch with no working tree.',
5484
6143
tree='Reconfigure to be an unbound branch with a working tree.',
5485
6144
checkout='Reconfigure to be a bound branch with a working tree.',
5486
6145
lightweight_checkout='Reconfigure to be a lightweight'
5487
' checkout (with no local history).',
6146
' checkout (with no local history).',
6148
RegistryOption.from_kwargs(
6150
title='Repository type',
6151
help='Location fo the repository.',
6152
value_switches=True, enum_switch=False,
5488
6153
standalone='Reconfigure to be a standalone branch '
5489
'(i.e. stop using shared repository).',
6154
'(i.e. stop using shared repository).',
5490
6155
use_shared='Reconfigure to use a shared repository.',
6157
RegistryOption.from_kwargs(
6159
title='Trees in Repository',
6160
help='Whether new branches in the repository have trees.',
6161
value_switches=True, enum_switch=False,
5491
6162
with_trees='Reconfigure repository to create '
5492
'working trees on branches by default.',
6163
'working trees on branches by default.',
5493
6164
with_no_trees='Reconfigure repository to not create '
5494
'working trees on branches by default.'
6165
'working trees on branches by default.'
5496
Option('bind-to', help='Branch to bind checkout to.', type=str),
6167
Option('bind-to', help='Branch to bind checkout to.', type=text_type),
5497
6168
Option('force',
5498
help='Perform reconfiguration even if local changes'
6169
help='Perform reconfiguration even if local changes'
5500
6171
Option('stacked-on',
5501
help='Reconfigure a branch to be stacked on another branch.',
6172
help='Reconfigure a branch to be stacked on another branch.',
5504
6175
Option('unstacked',
5505
help='Reconfigure a branch to be unstacked. This '
5506
'may require copying substantial data into it.',
6176
help='Reconfigure a branch to be unstacked. This '
6177
'may require copying substantial data into it.',
5510
def run(self, location=None, target_type=None, bind_to=None, force=False,
5513
directory = bzrdir.BzrDir.open(location)
6181
def run(self, location=None, bind_to=None, force=False,
6182
tree_type=None, repository_type=None, repository_trees=None,
6183
stacked_on=None, unstacked=None):
6184
directory = controldir.ControlDir.open(location)
5514
6185
if stacked_on and unstacked:
5515
raise BzrCommandError("Can't use both --stacked-on and --unstacked")
6186
raise errors.BzrCommandError(
6187
gettext("Can't use both --stacked-on and --unstacked"))
5516
6188
elif stacked_on is not None:
5517
6189
reconfigure.ReconfigureStackedOn().apply(directory, stacked_on)
5518
6190
elif unstacked:
5575
6258
takes_args = ['to_location?']
5576
takes_options = [Option('force',
5577
help='Switch even if local commits will be lost.'),
6259
takes_options = ['directory',
6261
help='Switch even if local commits will be lost.'),
5579
6263
Option('create-branch', short_name='b',
5580
help='Create the target branch from this one before'
5581
' switching to it.'),
6264
help='Create the target branch from this one before'
6265
' switching to it.'),
6267
help='Store and restore uncommitted changes in the'
5584
6271
def run(self, to_location=None, force=False, create_branch=False,
5586
from bzrlib import switch
6272
revision=None, directory=u'.', store=False):
6273
from . import switch
6274
tree_location = directory
5588
6275
revision = _get_one_revision('switch', revision)
5589
control_dir = bzrdir.BzrDir.open_containing(tree_location)[0]
6276
control_dir = controldir.ControlDir.open_containing(tree_location)[0]
6277
possible_transports = [control_dir.root_transport]
5590
6278
if to_location is None:
5591
6279
if revision is None:
5592
raise errors.BzrCommandError('You must supply either a'
5593
' revision or a location')
6280
raise errors.BzrCommandError(gettext('You must supply either a'
6281
' revision or a location'))
6282
to_location = tree_location
5596
branch = control_dir.open_branch()
6284
branch = control_dir.open_branch(
6285
possible_transports=possible_transports)
5597
6286
had_explicit_nick = branch.get_config().has_explicit_nickname()
5598
6287
except errors.NotBranchError:
5600
6289
had_explicit_nick = False
6291
possible_transports.append(branch.user_transport)
5601
6292
if create_branch:
5602
6293
if branch is None:
5603
raise errors.BzrCommandError('cannot create branch without'
5605
to_location = directory_service.directories.dereference(
5607
if '/' not in to_location and '\\' not in to_location:
5608
# This path is meant to be relative to the existing branch
5609
this_url = self._get_branch_location(control_dir)
5610
to_location = urlutils.join(this_url, '..', to_location)
5611
to_branch = branch.bzrdir.sprout(to_location,
5612
possible_transports=[branch.bzrdir.root_transport],
5613
source_branch=branch).open_branch()
6294
raise errors.BzrCommandError(
6295
gettext('cannot create branch without source branch'))
6296
to_location = lookup_new_sibling_branch(
6297
control_dir, to_location,
6298
possible_transports=possible_transports)
6299
if revision is not None:
6300
revision = revision.as_revision_id(branch)
6301
to_branch = branch.controldir.sprout(
6303
possible_transports=possible_transports,
6304
revision_id=revision,
6305
source_branch=branch).open_branch()
5616
to_branch = Branch.open(to_location)
5617
except errors.NotBranchError:
5618
this_url = self._get_branch_location(control_dir)
5619
6308
to_branch = Branch.open(
5620
urlutils.join(this_url, '..', to_location))
5621
if revision is not None:
5622
revision = revision.as_revision_id(to_branch)
5623
switch.switch(control_dir, to_branch, force, revision_id=revision)
6309
to_location, possible_transports=possible_transports)
6310
except errors.NotBranchError:
6311
to_branch = open_sibling_branch(
6312
control_dir, to_location,
6313
possible_transports=possible_transports)
6314
if revision is not None:
6315
revision = revision.as_revision_id(to_branch)
6316
possible_transports.append(to_branch.user_transport)
6318
switch.switch(control_dir, to_branch, force, revision_id=revision,
6319
store_uncommitted=store,
6320
possible_transports=possible_transports)
6321
except controldir.BranchReferenceLoop:
6322
raise errors.BzrCommandError(
6323
gettext('switching would create a branch reference loop. '
6324
'Use the "bzr up" command to switch to a '
6325
'different revision.'))
5624
6326
if had_explicit_nick:
5625
branch = control_dir.open_branch() #get the new branch!
6327
branch = control_dir.open_branch() # get the new branch!
5626
6328
branch.nick = to_branch.nick
5627
note('Switched to branch: %s',
5628
urlutils.unescape_for_display(to_branch.base, 'utf-8'))
5630
def _get_branch_location(self, control_dir):
5631
"""Return location of branch for this control dir."""
5633
this_branch = control_dir.open_branch()
5634
# This may be a heavy checkout, where we want the master branch
5635
master_location = this_branch.get_bound_location()
5636
if master_location is not None:
5637
return master_location
5638
# If not, use a local sibling
5639
return this_branch.base
5640
except errors.NotBranchError:
5641
format = control_dir.find_branch_format()
5642
if getattr(format, 'get_reference', None) is not None:
5643
return format.get_reference(control_dir)
6330
if to_branch.controldir.control_url != control_dir.control_url:
6331
note(gettext('Switched to branch %s at %s'),
6332
to_branch.name, urlutils.unescape_for_display(to_branch.base, 'utf-8'))
5645
return control_dir.root_transport.base
6334
note(gettext('Switched to branch %s'), to_branch.name)
6336
note(gettext('Switched to branch at %s'),
6337
urlutils.unescape_for_display(to_branch.base, 'utf-8'))
5648
6340
class cmd_view(Command):
5998
6724
takes_args = ['path?', 'location?']
6726
Option('force-unversioned',
6727
help='Set reference even if path is not versioned.'),
6000
def run(self, path=None, location=None):
6730
def run(self, path=None, location=None, force_unversioned=False):
6001
6731
branchdir = '.'
6002
6732
if path is not None:
6003
6733
branchdir = path
6004
tree, branch, relpath =(
6005
bzrdir.BzrDir.open_containing_tree_or_branch(branchdir))
6734
tree, branch, relpath = (
6735
controldir.ControlDir.open_containing_tree_or_branch(branchdir))
6006
6736
if path is not None:
6008
6738
if tree is None:
6009
6739
tree = branch.basis_tree()
6010
6740
if path is None:
6011
info = branch._get_all_reference_info().iteritems()
6741
info = viewitems(branch._get_all_reference_info())
6012
6742
self._display_reference_info(tree, branch, info)
6014
file_id = tree.path2id(path)
6744
if not tree.is_versioned(path) and not force_unversioned:
6016
6745
raise errors.NotVersionedError(path)
6017
6746
if location is None:
6018
info = [(file_id, branch.get_reference_info(file_id))]
6747
info = [(path, branch.get_reference_info(path))]
6019
6748
self._display_reference_info(tree, branch, info)
6021
branch.set_reference_info(file_id, path, location)
6750
branch.set_reference_info(
6751
path, location, file_id=tree.path2id(path))
6023
6753
def _display_reference_info(self, tree, branch, info):
6025
for file_id, (path, location) in info:
6027
path = tree.id2path(file_id)
6028
except errors.NoSuchId:
6755
for path, (location, file_id) in info:
6030
6756
ref_list.append((path, location))
6031
6757
for path, location in sorted(ref_list):
6032
6758
self.outf.write('%s %s\n' % (path, location))
6761
class cmd_export_pot(Command):
6762
__doc__ = """Export command helps and error messages in po format."""
6765
takes_options = [Option('plugin',
6766
help='Export help text from named command '
6767
'(defaults to all built in commands).',
6769
Option('include-duplicates',
6770
help='Output multiple copies of the same msgid '
6771
'string if it appears more than once.'),
6774
def run(self, plugin=None, include_duplicates=False):
6775
from .export_pot import export_pot
6776
export_pot(self.outf, plugin, include_duplicates)
6779
class cmd_import(Command):
6780
__doc__ = """Import sources from a directory, tarball or zip file
6782
This command will import a directory, tarball or zip file into a bzr
6783
tree, replacing any versioned files already present. If a directory is
6784
specified, it is used as the target. If the directory does not exist, or
6785
is not versioned, it is created.
6787
Tarballs may be gzip or bzip2 compressed. This is autodetected.
6789
If the tarball or zip has a single root directory, that directory is
6790
stripped when extracting the tarball. This is not done for directories.
6793
takes_args = ['source', 'tree?']
6795
def run(self, source, tree=None):
6796
from .upstream_import import do_import
6797
do_import(source, tree)
6800
class cmd_link_tree(Command):
6801
__doc__ = """Hardlink matching files to another tree.
6803
Only files with identical content and execute bit will be linked.
6806
takes_args = ['location']
6808
def run(self, location):
6809
from .transform import link_tree
6810
target_tree = WorkingTree.open_containing(".")[0]
6811
source_tree = WorkingTree.open(location)
6812
with target_tree.lock_write(), source_tree.lock_read():
6813
link_tree(target_tree, source_tree)
6816
class cmd_fetch_ghosts(Command):
6817
__doc__ = """Attempt to retrieve ghosts from another branch.
6819
If the other branch is not supplied, the last-pulled branch is used.
6823
aliases = ['fetch-missing']
6824
takes_args = ['branch?']
6825
takes_options = [Option('no-fix', help="Skip additional synchonization.")]
6827
def run(self, branch=None, no_fix=False):
6828
from .fetch_ghosts import GhostFetcher
6829
installed, failed = GhostFetcher.from_cmdline(branch).run()
6830
if len(installed) > 0:
6831
self.outf.write("Installed:\n")
6832
for rev in installed:
6833
self.outf.write(rev.decode('utf-8') + "\n")
6835
self.outf.write("Still missing:\n")
6837
self.outf.write(rev.decode('utf-8') + "\n")
6838
if not no_fix and len(installed) > 0:
6839
cmd_reconcile().run(".")
6842
class cmd_grep(Command):
6843
"""Print lines matching PATTERN for specified files and revisions.
6845
This command searches the specified files and revisions for a given
6846
pattern. The pattern is specified as a Python regular expressions[1].
6848
If the file name is not specified, the revisions starting with the
6849
current directory are searched recursively. If the revision number is
6850
not specified, the working copy is searched. To search the last committed
6851
revision, use the '-r -1' or '-r last:1' option.
6853
Unversioned files are not searched unless explicitly specified on the
6854
command line. Unversioned directores are not searched.
6856
When searching a pattern, the output is shown in the 'filepath:string'
6857
format. If a revision is explicitly searched, the output is shown as
6858
'filepath~N:string', where N is the revision number.
6860
--include and --exclude options can be used to search only (or exclude
6861
from search) files with base name matches the specified Unix style GLOB
6862
pattern. The GLOB pattern an use *, ?, and [...] as wildcards, and \\
6863
to quote wildcard or backslash character literally. Note that the glob
6864
pattern is not a regular expression.
6866
[1] http://docs.python.org/library/re.html#regular-expression-syntax
6869
encoding_type = 'replace'
6870
takes_args = ['pattern', 'path*']
6874
Option('color', type=text_type, argname='when',
6875
help='Show match in color. WHEN is never, always or auto.'),
6876
Option('diff', short_name='p',
6877
help='Grep for pattern in changeset for each revision.'),
6878
ListOption('exclude', type=text_type, argname='glob', short_name='X',
6879
help="Skip files whose base name matches GLOB."),
6880
ListOption('include', type=text_type, argname='glob', short_name='I',
6881
help="Search only files whose base name matches GLOB."),
6882
Option('files-with-matches', short_name='l',
6883
help='Print only the name of each input file in '
6884
'which PATTERN is found.'),
6885
Option('files-without-match', short_name='L',
6886
help='Print only the name of each input file in '
6887
'which PATTERN is not found.'),
6888
Option('fixed-string', short_name='F',
6889
help='Interpret PATTERN is a single fixed string (not regex).'),
6891
help='Search for pattern starting from the root of the branch. '
6892
'(implies --recursive)'),
6893
Option('ignore-case', short_name='i',
6894
help='Ignore case distinctions while matching.'),
6896
help='Number of levels to display - 0 for all, 1 for collapsed '
6899
type=_parse_levels),
6900
Option('line-number', short_name='n',
6901
help='Show 1-based line number.'),
6902
Option('no-recursive',
6903
help="Don't recurse into subdirectories. (default is --recursive)"),
6904
Option('null', short_name='Z',
6905
help='Write an ASCII NUL (\\0) separator '
6906
'between output lines rather than a newline.'),
6910
def run(self, verbose=False, ignore_case=False, no_recursive=False,
6911
from_root=False, null=False, levels=None, line_number=False,
6912
path_list=None, revision=None, pattern=None, include=None,
6913
exclude=None, fixed_string=False, files_with_matches=False,
6914
files_without_match=False, color=None, diff=False):
6915
from breezy import _termcolor
6918
if path_list is None:
6922
raise errors.BzrCommandError(
6923
'cannot specify both --from-root and PATH.')
6925
if files_with_matches and files_without_match:
6926
raise errors.BzrCommandError(
6927
'cannot specify both '
6928
'-l/--files-with-matches and -L/--files-without-matches.')
6930
global_config = _mod_config.GlobalConfig()
6933
color = global_config.get_user_option('grep_color')
6938
if color not in ['always', 'never', 'auto']:
6939
raise errors.BzrCommandError('Valid values for --color are '
6940
'"always", "never" or "auto".')
6946
if revision is not None or levels == 0:
6947
# print revision numbers as we may be showing multiple revisions
6954
if not ignore_case and grep.is_fixed_string(pattern):
6955
# if the pattern isalnum, implicitly use to -F for faster grep
6957
elif ignore_case and fixed_string:
6958
# GZ 2010-06-02: Fall back to regexp rather than lowercasing
6959
# pattern and text which will cause pain later
6960
fixed_string = False
6961
pattern = re.escape(pattern)
6964
re_flags = re.MULTILINE
6966
re_flags |= re.IGNORECASE
6968
if not fixed_string:
6969
patternc = grep.compile_pattern(
6970
pattern.encode(grep._user_encoding), re_flags)
6972
if color == 'always':
6974
elif color == 'never':
6976
elif color == 'auto':
6977
show_color = _termcolor.allow_color()
6979
opts = grep.GrepOptions()
6981
opts.verbose = verbose
6982
opts.ignore_case = ignore_case
6983
opts.no_recursive = no_recursive
6984
opts.from_root = from_root
6986
opts.levels = levels
6987
opts.line_number = line_number
6988
opts.path_list = path_list
6989
opts.revision = revision
6990
opts.pattern = pattern
6991
opts.include = include
6992
opts.exclude = exclude
6993
opts.fixed_string = fixed_string
6994
opts.files_with_matches = files_with_matches
6995
opts.files_without_match = files_without_match
6999
opts.eol_marker = eol_marker
7000
opts.print_revno = print_revno
7001
opts.patternc = patternc
7002
opts.recursive = not no_recursive
7003
opts.fixed_string = fixed_string
7004
opts.outf = self.outf
7005
opts.show_color = show_color
7009
# files_with_matches, files_without_match
7010
# levels(?), line_number, from_root
7012
# These are silently ignored.
7013
grep.grep_diff(opts)
7014
elif revision is None:
7015
grep.workingtree_grep(opts)
7017
grep.versioned_grep(opts)
7020
class cmd_patch(Command):
7021
"""Apply a named patch to the current tree.
7025
takes_args = ['filename?']
7026
takes_options = [Option('strip', type=int, short_name='p',
7027
help=("Strip the smallest prefix containing num "
7028
"leading slashes from filenames.")),
7029
Option('silent', help='Suppress chatter.')]
7031
def run(self, filename=None, strip=None, silent=False):
7032
from .patch import patch_tree
7033
wt = WorkingTree.open_containing('.')[0]
7037
if filename is None:
7038
my_file = getattr(sys.stdin, 'buffer', sys.stdin)
7040
my_file = open(filename, 'rb')
7041
patches = [my_file.read()]
7042
return patch_tree(wt, patches, strip, quiet=is_quiet(), out=self.outf)
7045
class cmd_resolve_location(Command):
7046
__doc__ = """Expand a location to a full URL.
7049
Look up a Launchpad URL.
7051
brz resolve-location lp:brz
7053
takes_args = ['location']
7056
def run(self, location):
7057
from .location import location_to_url
7058
url = location_to_url(location)
7059
display_url = urlutils.unescape_for_display(url, self.outf.encoding)
7060
self.outf.write('%s\n' % display_url)
6035
7063
def _register_lazy_builtins():
6036
7064
# register lazy builtins from other modules; called at startup and should
6037
7065
# be only called once.
6038
7066
for (name, aliases, module_name) in [
6039
('cmd_bundle_info', [], 'bzrlib.bundle.commands'),
6040
('cmd_dpush', [], 'bzrlib.foreign'),
6041
('cmd_version_info', [], 'bzrlib.cmd_version_info'),
6042
('cmd_resolve', ['resolved'], 'bzrlib.conflicts'),
6043
('cmd_conflicts', [], 'bzrlib.conflicts'),
6044
('cmd_sign_my_commits', [], 'bzrlib.sign_my_commits'),
7067
('cmd_bisect', [], 'breezy.bisect'),
7068
('cmd_bundle_info', [], 'breezy.bzr.bundle.commands'),
7069
('cmd_config', [], 'breezy.config'),
7070
('cmd_dump_btree', [], 'breezy.bzr.debug_commands'),
7071
('cmd_file_id', [], 'breezy.bzr.debug_commands'),
7072
('cmd_file_path', [], 'breezy.bzr.debug_commands'),
7073
('cmd_version_info', [], 'breezy.cmd_version_info'),
7074
('cmd_resolve', ['resolved'], 'breezy.conflicts'),
7075
('cmd_conflicts', [], 'breezy.conflicts'),
7076
('cmd_ping', [], 'breezy.bzr.smart.ping'),
7077
('cmd_sign_my_commits', [], 'breezy.commit_signature_commands'),
7078
('cmd_verify_signatures', [], 'breezy.commit_signature_commands'),
7079
('cmd_test_script', [], 'breezy.cmd_test_script'),
6046
7081
builtin_command_registry.register_lazy(name, aliases, module_name)