278
def _get_trees_to_diff(path_list, revision_specs, old_url, new_url):
279
"""Get the trees and specific files to diff given a list of paths.
281
This method works out the trees to be diff'ed and the files of
282
interest within those trees.
285
the list of arguments passed to the diff command
286
:param revision_specs:
287
Zero, one or two RevisionSpecs from the diff command line,
288
saying what revisions to compare.
290
The url of the old branch or tree. If None, the tree to use is
291
taken from the first path, if any, or the current working tree.
293
The url of the new branch or tree. If None, the tree to use is
294
taken from the first path, if any, or the current working tree.
296
a tuple of (old_tree, new_tree, specific_files, extra_trees) where
297
extra_trees is a sequence of additional trees to search in for
291
@deprecated_function(deprecated_in((2, 2, 0)))
292
def get_trees_and_branches_to_diff(path_list, revision_specs, old_url, new_url,
294
"""Get the trees and specific files to diff given a list of paths.
296
This method works out the trees to be diff'ed and the files of
297
interest within those trees.
300
the list of arguments passed to the diff command
301
:param revision_specs:
302
Zero, one or two RevisionSpecs from the diff command line,
303
saying what revisions to compare.
305
The url of the old branch or tree. If None, the tree to use is
306
taken from the first path, if any, or the current working tree.
308
The url of the new branch or tree. If None, the tree to use is
309
taken from the first path, if any, or the current working tree.
311
if True and a view is set, apply the view or check that the paths
314
a tuple of (old_tree, new_tree, old_branch, new_branch,
315
specific_files, extra_trees) where extra_trees is a sequence of
316
additional trees to search in for file-ids. The trees and branches
319
op = cleanup.OperationWithCleanups(get_trees_and_branches_to_diff_locked)
320
return op.run_simple(path_list, revision_specs, old_url, new_url,
321
op.add_cleanup, apply_view=apply_view)
324
def get_trees_and_branches_to_diff_locked(
325
path_list, revision_specs, old_url, new_url, add_cleanup, apply_view=True):
326
"""Get the trees and specific files to diff given a list of paths.
328
This method works out the trees to be diff'ed and the files of
329
interest within those trees.
332
the list of arguments passed to the diff command
333
:param revision_specs:
334
Zero, one or two RevisionSpecs from the diff command line,
335
saying what revisions to compare.
337
The url of the old branch or tree. If None, the tree to use is
338
taken from the first path, if any, or the current working tree.
340
The url of the new branch or tree. If None, the tree to use is
341
taken from the first path, if any, or the current working tree.
343
a callable like Command.add_cleanup. get_trees_and_branches_to_diff
344
will register cleanups that must be run to unlock the trees, etc.
346
if True and a view is set, apply the view or check that the paths
349
a tuple of (old_tree, new_tree, old_branch, new_branch,
350
specific_files, extra_trees) where extra_trees is a sequence of
351
additional trees to search in for file-ids. The trees and branches
352
will be read-locked until the cleanups registered via the add_cleanup
300
355
# Get the old and new revision specs
301
356
old_revision_spec = None
324
379
default_location = path_list[0]
325
380
other_paths = path_list[1:]
382
def lock_tree_or_branch(wt, br):
385
add_cleanup(wt.unlock)
388
add_cleanup(br.unlock)
327
390
# Get the old location
328
391
specific_files = []
329
392
if old_url is None:
330
393
old_url = default_location
331
394
working_tree, branch, relpath = \
332
395
bzrdir.BzrDir.open_containing_tree_or_branch(old_url)
396
lock_tree_or_branch(working_tree, branch)
333
397
if consider_relpath and relpath != '':
398
if working_tree is not None and apply_view:
399
views.check_path_in_view(working_tree, relpath)
334
400
specific_files.append(relpath)
335
401
old_tree = _get_tree_to_diff(old_revision_spec, working_tree, branch)
337
404
# Get the new location
338
405
if new_url is None:
340
407
if new_url != old_url:
341
408
working_tree, branch, relpath = \
342
409
bzrdir.BzrDir.open_containing_tree_or_branch(new_url)
410
lock_tree_or_branch(working_tree, branch)
343
411
if consider_relpath and relpath != '':
412
if working_tree is not None and apply_view:
413
views.check_path_in_view(working_tree, relpath)
344
414
specific_files.append(relpath)
345
415
new_tree = _get_tree_to_diff(new_revision_spec, working_tree, branch,
346
416
basis_is_default=working_tree is None)
348
419
# Get the specific files (all files is None, no files is [])
349
420
if make_paths_wt_relative and working_tree is not None:
350
other_paths = _relative_paths_in_tree(working_tree, other_paths)
421
other_paths = working_tree.safe_relpath_files(
423
apply_view=apply_view)
351
424
specific_files.extend(other_paths)
352
425
if len(specific_files) == 0:
353
426
specific_files = None
427
if (working_tree is not None and working_tree.supports_views()
429
view_files = working_tree.views.lookup_view()
431
specific_files = view_files
432
view_str = views.view_display_str(view_files)
433
note("*** Ignoring files outside view. View is %s" % view_str)
355
435
# Get extra trees that ought to be searched for file-ids
356
436
extra_trees = None
357
437
if working_tree is not None and working_tree not in (old_tree, new_tree):
358
438
extra_trees = (working_tree,)
359
return old_tree, new_tree, specific_files, extra_trees
439
return old_tree, new_tree, old_branch, new_branch, specific_files, extra_trees
362
442
def _get_tree_to_diff(spec, tree=None, branch=None, basis_is_default=True):
370
450
return branch.basis_tree()
373
if not spec.needs_branch():
374
branch = _mod_branch.Branch.open(spec.get_branch())
375
revision_id = spec.as_revision_id(branch)
376
return branch.repository.revision_tree(revision_id)
379
def _relative_paths_in_tree(tree, paths):
380
"""Get the relative paths within a working tree.
382
Each path may be either an absolute path or a path relative to the
383
current working directory.
386
for filename in paths:
388
result.append(tree.relpath(osutils.dereference_path(filename)))
389
except errors.PathNotChild:
390
raise errors.BzrCommandError("Files are in different branches")
453
return spec.as_tree(branch)
394
456
def show_diff_trees(old_tree, new_tree, to_file, specific_files=None,
396
458
old_label='a/', new_label='b/',
397
459
extra_trees=None,
398
460
path_encoding='utf8',
400
463
"""Show in text form the changes from one tree to another.
406
Include only changes to these files - None for all changes.
408
external_diff_options
409
If set, use an external GNU diff and pass these options.
412
If set, more Trees to use for looking up file ids
415
If set, the path will be encoded as specified, otherwise is supposed
465
:param to_file: The output stream.
466
:param specific_files: Include only changes to these files - None for all
468
:param external_diff_options: If set, use an external GNU diff and pass
470
:param extra_trees: If set, more Trees to use for looking up file ids
471
:param path_encoding: If set, the path will be encoded as specified,
472
otherwise is supposed to be utf8
473
:param format_cls: Formatter class (DiffTree subclass)
475
if format_cls is None:
476
format_cls = DiffTree
418
477
old_tree.lock_read()
420
479
if extra_trees is not None:
439
498
def _patch_header_date(tree, file_id, path):
440
499
"""Returns a timestamp suitable for use in a patch header."""
441
mtime = tree.get_file_mtime(file_id, path)
501
mtime = tree.get_file_mtime(file_id, path)
502
except errors.FileTimestampUnavailable:
442
504
return timestamp.format_patch_date(mtime)
445
def _raise_if_nonexistent(paths, old_tree, new_tree):
446
"""Complain if paths are not in either inventory or tree.
448
It's OK with the files exist in either tree's inventory, or
449
if they exist in the tree but are not versioned.
451
This can be used by operations such as bzr status that can accept
452
unknown or ignored files.
454
mutter("check paths: %r", paths)
457
s = old_tree.filter_unversioned_files(paths)
458
s = new_tree.filter_unversioned_files(s)
459
s = [path for path in s if not new_tree.has_filename(path)]
461
raise errors.PathsDoNotExist(sorted(s))
464
@deprecated_function(one_three)
465
def get_prop_change(meta_modified):
467
return " (properties changed)"
471
507
def get_executable_change(old_is_x, new_is_x):
472
508
descr = { True:"+x", False:"-x", None:"??" }
473
509
if old_is_x != new_is_x:
648
684
return self.CANNOT_DIFF
649
685
from_label = '%s%s\t%s' % (self.old_label, old_path, old_date)
650
686
to_label = '%s%s\t%s' % (self.new_label, new_path, new_date)
651
return self.diff_text(from_file_id, to_file_id, from_label, to_label)
687
return self.diff_text(from_file_id, to_file_id, from_label, to_label,
653
def diff_text(self, from_file_id, to_file_id, from_label, to_label):
690
def diff_text(self, from_file_id, to_file_id, from_label, to_label,
691
from_path=None, to_path=None):
654
692
"""Diff the content of given files in two trees
656
694
:param from_file_id: The id of the file in the from tree. If None,
658
696
:param to_file_id: The id of the file in the to tree. This may refer
659
697
to a different file from from_file_id. If None,
660
698
the file is not present in the to tree.
699
:param from_path: The path in the from tree or None if unknown.
700
:param to_path: The path in the to tree or None if unknown.
662
def _get_text(tree, file_id):
702
def _get_text(tree, file_id, path):
663
703
if file_id is not None:
664
return tree.get_file(file_id).readlines()
704
return tree.get_file_lines(file_id, path)
668
from_text = _get_text(self.old_tree, from_file_id)
669
to_text = _get_text(self.new_tree, to_file_id)
708
from_text = _get_text(self.old_tree, from_file_id, from_path)
709
to_text = _get_text(self.new_tree, to_file_id, to_path)
670
710
self.text_differ(from_label, from_text, to_label, to_text,
711
self.to_file, path_encoding=self.path_encoding)
672
712
except errors.BinaryFile:
673
713
self.to_file.write(
674
714
("Binary files %s and %s differ\n" %
675
(from_label, to_label)).encode(self.path_encoding))
715
(from_label, to_label)).encode(self.path_encoding,'replace'))
676
716
return self.CHANGED
688
728
def from_string(klass, command_string, old_tree, new_tree, to_file,
689
729
path_encoding='utf-8'):
690
command_template = commands.shlex_split_unicode(command_string)
691
command_template.extend(['%(old_path)s', '%(new_path)s'])
730
command_template = cmdline.split(command_string)
731
if '@' not in command_string:
732
command_template.extend(['@old_path', '@new_path'])
692
733
return klass(command_template, old_tree, new_tree, to_file,
696
def make_from_diff_tree(klass, command_string):
737
def make_from_diff_tree(klass, command_string, external_diff_options=None):
697
738
def from_diff_tree(diff_tree):
698
return klass.from_string(command_string, diff_tree.old_tree,
739
full_command_string = [command_string]
740
if external_diff_options is not None:
741
full_command_string += ' ' + external_diff_options
742
return klass.from_string(full_command_string, diff_tree.old_tree,
699
743
diff_tree.new_tree, diff_tree.to_file)
700
744
return from_diff_tree
702
746
def _get_command(self, old_path, new_path):
703
747
my_map = {'old_path': old_path, 'new_path': new_path}
704
return [t % my_map for t in self.command_template]
748
command = [AtTemplate(t).substitute(my_map) for t in
749
self.command_template]
750
if sys.platform == 'win32': # Popen doesn't accept unicode on win32
753
if isinstance(c, unicode):
754
command_encoded.append(c.encode('mbcs'))
756
command_encoded.append(c)
757
return command_encoded
706
761
def _execute(self, old_path, new_path):
707
762
command = self._get_command(old_path, new_path)
730
def _write_file(self, file_id, tree, prefix, relpath):
731
full_path = osutils.pathjoin(self._root, prefix, relpath)
732
if self._try_symlink_root(tree, prefix):
787
"""Returns safe encoding for passing file path to diff tool"""
788
if sys.platform == 'win32':
791
# Don't fallback to 'utf-8' because subprocess may not be able to
792
# handle utf-8 correctly when locale is not utf-8.
793
return sys.getfilesystemencoding() or 'ascii'
795
def _is_safepath(self, path):
796
"""Return true if `path` may be able to pass to subprocess."""
799
return path == path.encode(fenc).decode(fenc)
803
def _safe_filename(self, prefix, relpath):
804
"""Replace unsafe character in `relpath` then join `self._root`,
805
`prefix` and `relpath`."""
807
# encoded_str.replace('?', '_') may break multibyte char.
808
# So we should encode, decode, then replace(u'?', u'_')
809
relpath_tmp = relpath.encode(fenc, 'replace').decode(fenc, 'replace')
810
relpath_tmp = relpath_tmp.replace(u'?', u'_')
811
return osutils.pathjoin(self._root, prefix, relpath_tmp)
813
def _write_file(self, file_id, tree, prefix, relpath, force_temp=False,
815
if not force_temp and isinstance(tree, WorkingTree):
816
full_path = tree.abspath(tree.id2path(file_id))
817
if self._is_safepath(full_path):
820
full_path = self._safe_filename(prefix, relpath)
821
if not force_temp and self._try_symlink_root(tree, prefix):
734
823
parent_dir = osutils.dirname(full_path)
749
osutils.make_readonly(full_path)
750
mtime = tree.get_file_mtime(file_id)
751
os.utime(full_path, (mtime, mtime))
839
mtime = tree.get_file_mtime(file_id)
840
except errors.FileTimestampUnavailable:
843
os.utime(full_path, (mtime, mtime))
845
osutils.make_readonly(full_path)
754
def _prepare_files(self, file_id, old_path, new_path):
848
def _prepare_files(self, file_id, old_path, new_path, force_temp=False,
849
allow_write_new=False):
755
850
old_disk_path = self._write_file(file_id, self.old_tree, 'old',
851
old_path, force_temp)
757
852
new_disk_path = self._write_file(file_id, self.new_tree, 'new',
853
new_path, force_temp,
854
allow_write=allow_write_new)
759
855
return old_disk_path, new_disk_path
761
857
def finish(self):
762
osutils.rmtree(self._root)
859
osutils.rmtree(self._root)
861
if e.errno != errno.ENOENT:
862
mutter("The temporary directory \"%s\" was not "
863
"cleanly removed: %s." % (self._root, e))
764
865
def diff(self, file_id, old_path, new_path, old_kind, new_kind):
765
866
if (old_kind, new_kind) != ('file', 'file'):
766
867
return DiffPath.CANNOT_DIFF
767
self._prepare_files(file_id, old_path, new_path)
768
self._execute(osutils.pathjoin('old', old_path),
769
osutils.pathjoin('new', new_path))
868
(old_disk_path, new_disk_path) = self._prepare_files(
869
file_id, old_path, new_path)
870
self._execute(old_disk_path, new_disk_path)
872
def edit_file(self, file_id):
873
"""Use this tool to edit a file.
875
A temporary copy will be edited, and the new contents will be
878
:param file_id: The id of the file to edit.
879
:return: The new contents of the file.
881
old_path = self.old_tree.id2path(file_id)
882
new_path = self.new_tree.id2path(file_id)
883
old_abs_path, new_abs_path = self._prepare_files(
884
file_id, old_path, new_path,
885
allow_write_new=True,
887
command = self._get_command(old_abs_path, new_abs_path)
888
subprocess.call(command, cwd=self._root)
889
new_file = open(new_abs_path, 'rb')
891
return new_file.read()
772
896
class DiffTree(object):
829
954
:param using: Commandline to use to invoke an external diff tool
831
956
if using is not None:
832
extra_factories = [DiffFromTool.make_from_diff_tree(using)]
957
extra_factories = [DiffFromTool.make_from_diff_tree(using, external_diff_options)]
834
959
extra_factories = []
835
960
if external_diff_options:
836
961
opts = external_diff_options.split()
837
def diff_file(olab, olines, nlab, nlines, to_file):
962
def diff_file(olab, olines, nlab, nlines, to_file, path_encoding=None):
963
""":param path_encoding: not used but required
964
to match the signature of internal_diff.
838
966
external_diff(olab, olines, nlab, nlines, to_file, opts)
840
968
diff_file = internal_diff
931
1059
new_kind = self.new_tree.kind(file_id)
932
1060
except (errors.NoSuchId, errors.NoSuchFile):
1062
self._diff(file_id, old_path, new_path, old_kind, new_kind)
1065
def _diff(self, file_id, old_path, new_path, old_kind, new_kind):
935
1066
result = DiffPath._diff_many(self.differs, file_id, old_path,
936
1067
new_path, old_kind, new_kind)
937
1068
if result is DiffPath.CANNOT_DIFF: