/brz/remove-bazaar : contents of bzrlib/memorytree.py at revision 3567.5.1

: (revision 3567.5.1)

To get this branch, use:

bzr branch
http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

# Copyright (C) 2006 Canonical Ltd
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

"""MemoryTree object.

See MemoryTree for more details.
"""


from copy import deepcopy
import os

from bzrlib import (
    errors,
    mutabletree,
    osutils,
    revision as _mod_revision,
    )
from bzrlib.decorators import needs_read_lock, needs_write_lock
from bzrlib.osutils import sha_file
from bzrlib.mutabletree import needs_tree_write_lock
from bzrlib.transport.memory import MemoryTransport


class MemoryTree(mutabletree.MutableTree):
    """A MemoryTree is a specialisation of MutableTree.
    
    It maintains nearly no state outside of read_lock and write_lock
    transactions. (it keeps a reference to the branch, and its last-revision
    only).
    """

    def __init__(self, branch, revision_id):
        """Construct a MemoryTree for branch using revision_id."""
        self.branch = branch
        self.bzrdir = branch.bzrdir
        self._branch_revision_id = revision_id
        self._locks = 0
        self._lock_mode = None

    @needs_tree_write_lock
    def _add(self, files, ids, kinds):
        """See MutableTree._add."""
        for f, file_id, kind in zip(files, ids, kinds):
            if kind is None:
                kind = 'file'
            if file_id is None:
                self._inventory.add_path(f, kind=kind)
            else:
                self._inventory.add_path(f, kind=kind, file_id=file_id)

    def basis_tree(self):
        """See Tree.basis_tree()."""
        return self._basis_tree

    @staticmethod
    def create_on_branch(branch):
        """Create a MemoryTree for branch, using the last-revision of branch."""
        revision_id = _mod_revision.ensure_null(branch.last_revision())
        if _mod_revision.is_null(revision_id):
            revision_id = None
        return MemoryTree(branch, revision_id)

    def _gather_kinds(self, files, kinds):
        """See MutableTree._gather_kinds.
        
        This implementation does not care about the file kind of
        missing files, so is a no-op.
        """

    def get_file(self, file_id, path=None):
        """See Tree.get_file."""
        if path is None:
            path = self.id2path(file_id)
        return self._file_transport.get(path)

    def get_file_sha1(self, file_id, path=None, stat_value=None):
        """See Tree.get_file_sha1()."""
        if path is None:
            path = self.id2path(file_id)
        stream = self._file_transport.get(path)
        return sha_file(stream)

    def get_root_id(self):
        return self.path2id('')

    def _comparison_data(self, entry, path):
        """See Tree._comparison_data."""
        if entry is None:
            return None, False, None
        return entry.kind, entry.executable, None

    @needs_tree_write_lock
    def rename_one(self, from_rel, to_rel):
        file_id = self.path2id(from_rel)
        to_dir, to_tail = os.path.split(to_rel)
        to_parent_id = self.path2id(to_dir)
        self._file_transport.move(from_rel, to_rel)
        self._inventory.rename(file_id, to_parent_id, to_tail)
        
    def path_content_summary(self, path):
        """See Tree.path_content_summary."""
        id = self.path2id(path)
        if id is None:
            return 'missing', None, None, None
        kind = self.kind(id)
        if kind == 'file':
            bytes = self._file_transport.get_bytes(path)
            size = len(bytes)
            executable = self._inventory[id].executable
            sha1 = None # no stat cache
            return (kind, size, executable, sha1)
        elif kind == 'directory':
            # memory tree does not support nested trees yet.
            return kind, None, None, None
        elif kind == 'symlink':
            raise NotImplementedError('symlink support')
        else:
            raise NotImplementedError('unknown kind')

    def _file_size(self, entry, stat_value):
        """See Tree._file_size."""
        if entry is None:
            return 0
        return entry.text_size

    @needs_read_lock
    def get_parent_ids(self):
        """See Tree.get_parent_ids.

        This implementation returns the current cached value from
            self._parent_ids.
        """
        return list(self._parent_ids)

    def has_filename(self, filename):
        """See Tree.has_filename()."""
        return self._file_transport.has(filename)

    def is_executable(self, file_id, path=None):
        return self._inventory[file_id].executable

    def kind(self, file_id):
        return self._inventory[file_id].kind

    def mkdir(self, path, file_id=None):
        """See MutableTree.mkdir()."""
        self.add(path, file_id, 'directory')
        if file_id is None:
            file_id = self.path2id(path)
        self._file_transport.mkdir(path)
        return file_id

    @needs_read_lock
    def last_revision(self):
        """See MutableTree.last_revision."""
        return self._branch_revision_id

    def lock_read(self):
        """Lock the memory tree for reading.

        This triggers population of data from the branch for its revision.
        """
        self._locks += 1
        try:
            if self._locks == 1:
                self.branch.lock_read()
                self._lock_mode = "r"
                self._populate_from_branch()
        except:
            self._locks -= 1
            raise

    def lock_tree_write(self):
        """See MutableTree.lock_tree_write()."""
        self._locks += 1
        try:
            if self._locks == 1:
                self.branch.lock_read()
                self._lock_mode = "w"
                self._populate_from_branch()
            elif self._lock_mode == "r":
                raise errors.ReadOnlyError(self)
        except:
            self._locks -= 1
            raise

    def lock_write(self):
        """See MutableTree.lock_write()."""
        self._locks += 1
        try:
            if self._locks == 1:
                self.branch.lock_write()
                self._lock_mode = "w"
                self._populate_from_branch()
            elif self._lock_mode == "r":
                raise errors.ReadOnlyError(self)
        except:
            self._locks -= 1
            raise

    def _populate_from_branch(self):
        """Populate the in-tree state from the branch."""
        self._basis_tree = self.branch.repository.revision_tree(
            self._branch_revision_id)
        if self._branch_revision_id is None:
            self._parent_ids = []
        else:
            self._parent_ids = [self._branch_revision_id]
        self._inventory = deepcopy(self._basis_tree._inventory)
        self._file_transport = MemoryTransport()
        # TODO copy the revision trees content, or do it lazy, or something.
        inventory_entries = self._inventory.iter_entries()
        for path, entry in inventory_entries:
            if path == '':
                continue
            if entry.kind == 'directory':
                self._file_transport.mkdir(path)
            elif entry.kind == 'file':
                self._file_transport.put_file(path,
                    self._basis_tree.get_file(entry.file_id))
            else:
                raise NotImplementedError(self._populate_from_branch)

    def put_file_bytes_non_atomic(self, file_id, bytes):
        """See MutableTree.put_file_bytes_non_atomic."""
        self._file_transport.put_bytes(self.id2path(file_id), bytes)

    def unlock(self):
        """Release a lock.

        This frees all cached state when the last lock context for the tree is
        left.
        """
        if self._locks == 1:
            self._basis_tree = None
            self._parent_ids = []
            self._inventory = None
            try:
                self.branch.unlock()
            finally:
                self._locks = 0
                self._lock_mode = None
        else:
            self._locks -= 1

    @needs_tree_write_lock
    def unversion(self, file_ids):
        """Remove the file ids in file_ids from the current versioned set.

        When a file_id is unversioned, all of its children are automatically
        unversioned.

        :param file_ids: The file ids to stop versioning.
        :raises: NoSuchId if any fileid is not currently versioned.
        """
        # XXX: This should be in mutabletree, but the inventory-save action
        # is not relevant to memory tree. Until that is done in unlock by
        # working tree, we cannot share the implementation.
        for file_id in file_ids:
            if self._inventory.has_id(file_id):
                self._inventory.remove_recursive_id(file_id)
            else:
                raise errors.NoSuchId(self, file_id)

    def set_parent_ids(self, revision_ids, allow_leftmost_as_ghost=False):
        """See MutableTree.set_parent_trees()."""
        for revision_id in revision_ids:
            _mod_revision.check_not_reserved_id(revision_id)
        if len(revision_ids) == 0:
            self._parent_ids = []
            self._basis_tree = self.branch.repository.revision_tree(None)
        else:
            self._parent_ids = revision_ids
            self._basis_tree = self.branch.repository.revision_tree(
                                    revision_ids[0])
            self._branch_revision_id = revision_ids[0]

    def set_parent_trees(self, parents_list, allow_leftmost_as_ghost=False):
        """See MutableTree.set_parent_trees()."""
        if len(parents_list) == 0:
            self._parent_ids = []
            self._basis_tree = self.branch.repository.revision_tree(None)
        else:
            if parents_list[0][1] is None and not allow_leftmost_as_ghost:
                # a ghost in the left most parent
                raise errors.GhostRevisionUnusableHere(parents_list[0][0])
            self._parent_ids = [parent_id for parent_id, tree in parents_list]
            if parents_list[0][1] is None or parents_list[0][1] == 'null:':
                self._basis_tree = self.branch.repository.revision_tree(None)
            else:
                self._basis_tree = parents_list[0][1]
            self._branch_revision_id = parents_list[0][0]

1986.1.2 by Robert Collins Various changes to allow non-workingtree specific tests to run entirely	1	# Copyright (C) 2006 Canonical Ltd
	2	#
	3	# This program is free software; you can redistribute it and/or modify
	4	# it under the terms of the GNU General Public License as published by
	5	# the Free Software Foundation; either version 2 of the License, or
	6	# (at your option) any later version.
	7	#
	8	# This program is distributed in the hope that it will be useful,
	9	# but WITHOUT ANY WARRANTY; without even the implied warranty of
	10	# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	11	# GNU General Public License for more details.
	12	#
	13	# You should have received a copy of the GNU General Public License
	14	# along with this program; if not, write to the Free Software
	15	# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
	16
	17	"""MemoryTree object.
	18
	19	See MemoryTree for more details.
	20	"""
	21
	22
	23	from copy import deepcopy
3567.5.1 by John Arbash Meinel Implement rename_one on MemoryTree, and expose that in the Branch Builder	24	import os
1986.1.2 by Robert Collins Various changes to allow non-workingtree specific tests to run entirely	25
2598.5.1 by Aaron Bentley Start eliminating the use of None to indicate null revision	26	from bzrlib import (
	27	errors,
	28	mutabletree,
3567.5.1 by John Arbash Meinel Implement rename_one on MemoryTree, and expose that in the Branch Builder	29	osutils,
2598.5.1 by Aaron Bentley Start eliminating the use of None to indicate null revision	30	revision as _mod_revision,
	31	)
1986.1.2 by Robert Collins Various changes to allow non-workingtree specific tests to run entirely	32	from bzrlib.decorators import needs_read_lock, needs_write_lock
	33	from bzrlib.osutils import sha_file
1986.1.8 by Robert Collins Update to bzr.dev, which involves adding lock_tree_write to MutableTree and MemoryTree.	34	from bzrlib.mutabletree import needs_tree_write_lock
1986.1.2 by Robert Collins Various changes to allow non-workingtree specific tests to run entirely	35	from bzrlib.transport.memory import MemoryTransport
	36
	37
	38	class MemoryTree(mutabletree.MutableTree):
	39	"""A MemoryTree is a specialisation of MutableTree.
	40
	41	It maintains nearly no state outside of read_lock and write_lock
	42	transactions. (it keeps a reference to the branch, and its last-revision
	43	only).
	44	"""
	45
	46	def __init__(self, branch, revision_id):
	47	"""Construct a MemoryTree for branch using revision_id."""
	48	self.branch = branch
	49	self.bzrdir = branch.bzrdir
	50	self._branch_revision_id = revision_id
	51	self._locks = 0
	52	self._lock_mode = None
	53
1986.1.8 by Robert Collins Update to bzr.dev, which involves adding lock_tree_write to MutableTree and MemoryTree.	54	@needs_tree_write_lock
1986.1.2 by Robert Collins Various changes to allow non-workingtree specific tests to run entirely	55	def _add(self, files, ids, kinds):
	56	"""See MutableTree._add."""
	57	for f, file_id, kind in zip(files, ids, kinds):
	58	if kind is None:
	59	kind = 'file'
	60	if file_id is None:
	61	self._inventory.add_path(f, kind=kind)
	62	else:
	63	self._inventory.add_path(f, kind=kind, file_id=file_id)
	64
	65	def basis_tree(self):
	66	"""See Tree.basis_tree()."""
	67	return self._basis_tree
	68
	69	@staticmethod
	70	def create_on_branch(branch):
	71	"""Create a MemoryTree for branch, using the last-revision of branch."""
2598.5.4 by Aaron Bentley Restore original Branch.last_revision behavior, fix bits that care	72	revision_id = _mod_revision.ensure_null(branch.last_revision())
2598.5.1 by Aaron Bentley Start eliminating the use of None to indicate null revision	73	if _mod_revision.is_null(revision_id):
	74	revision_id = None
	75	return MemoryTree(branch, revision_id)
1986.1.2 by Robert Collins Various changes to allow non-workingtree specific tests to run entirely	76
	77	def _gather_kinds(self, files, kinds):
	78	"""See MutableTree._gather_kinds.
	79
	80	This implementation does not care about the file kind of
	81	missing files, so is a no-op.
	82	"""
	83
2743.3.3 by Ian Clatworthy Skip path lookup for tree.get_file() when we already know the path	84	def get_file(self, file_id, path=None):
1986.1.2 by Robert Collins Various changes to allow non-workingtree specific tests to run entirely	85	"""See Tree.get_file."""
2743.3.3 by Ian Clatworthy Skip path lookup for tree.get_file() when we already know the path	86	if path is None:
	87	path = self.id2path(file_id)
	88	return self._file_transport.get(path)
1986.1.2 by Robert Collins Various changes to allow non-workingtree specific tests to run entirely	89
2564.2.1 by Ian Clatworthy refactor commit to support alternative population meothds	90	def get_file_sha1(self, file_id, path=None, stat_value=None):
1986.1.2 by Robert Collins Various changes to allow non-workingtree specific tests to run entirely	91	"""See Tree.get_file_sha1()."""
	92	if path is None:
	93	path = self.id2path(file_id)
	94	stream = self._file_transport.get(path)
	95	return sha_file(stream)
	96
2946.3.5 by John Arbash Meinel MemoryTree is not tested under the tree_implementations tests.	97	def get_root_id(self):
	98	return self.path2id('')
	99
2564.2.1 by Ian Clatworthy refactor commit to support alternative population meothds	100	def _comparison_data(self, entry, path):
	101	"""See Tree._comparison_data."""
	102	if entry is None:
	103	return None, False, None
	104	return entry.kind, entry.executable, None
	105
3567.5.1 by John Arbash Meinel Implement rename_one on MemoryTree, and expose that in the Branch Builder	106	@needs_tree_write_lock
	107	def rename_one(self, from_rel, to_rel):
	108	file_id = self.path2id(from_rel)
	109	to_dir, to_tail = os.path.split(to_rel)
	110	to_parent_id = self.path2id(to_dir)
	111	self._file_transport.move(from_rel, to_rel)
	112	self._inventory.rename(file_id, to_parent_id, to_tail)
	113
2776.4.2 by Robert Collins nuke _read_tree_state and snapshot from inventory, moving responsibility into the commit builder.	114	def path_content_summary(self, path):
	115	"""See Tree.path_content_summary."""
	116	id = self.path2id(path)
	117	if id is None:
	118	return 'missing', None, None, None
	119	kind = self.kind(id)
	120	if kind == 'file':
	121	bytes = self._file_transport.get_bytes(path)
	122	size = len(bytes)
	123	executable = self._inventory[id].executable
	124	sha1 = None # no stat cache
	125	return (kind, size, executable, sha1)
	126	elif kind == 'directory':
	127	# memory tree does not support nested trees yet.
	128	return kind, None, None, None
	129	elif kind == 'symlink':
	130	raise NotImplementedError('symlink support')
	131	else:
	132	raise NotImplementedError('unknown kind')
	133
2564.2.1 by Ian Clatworthy refactor commit to support alternative population meothds	134	def _file_size(self, entry, stat_value):
	135	"""See Tree._file_size."""
	136	if entry is None:
	137	return 0
	138	return entry.text_size
	139
1986.1.2 by Robert Collins Various changes to allow non-workingtree specific tests to run entirely	140	@needs_read_lock
	141	def get_parent_ids(self):
	142	"""See Tree.get_parent_ids.
	143
	144	This implementation returns the current cached value from
	145	self._parent_ids.
	146	"""
	147	return list(self._parent_ids)
	148
	149	def has_filename(self, filename):
	150	"""See Tree.has_filename()."""
	151	return self._file_transport.has(filename)
	152
	153	def is_executable(self, file_id, path=None):
	154	return self._inventory[file_id].executable
	155
1959.4.2 by Aaron Bentley Merge bzr.dev	156	def kind(self, file_id):
	157	return self._inventory[file_id].kind
	158
1986.1.2 by Robert Collins Various changes to allow non-workingtree specific tests to run entirely	159	def mkdir(self, path, file_id=None):
	160	"""See MutableTree.mkdir()."""
	161	self.add(path, file_id, 'directory')
	162	if file_id is None:
	163	file_id = self.path2id(path)
	164	self._file_transport.mkdir(path)
	165	return file_id
	166
1986.1.6 by Robert Collins Add MemoryTree.last_revision.	167	@needs_read_lock
	168	def last_revision(self):
	169	"""See MutableTree.last_revision."""
	170	return self._branch_revision_id
	171
1986.1.2 by Robert Collins Various changes to allow non-workingtree specific tests to run entirely	172	def lock_read(self):
	173	"""Lock the memory tree for reading.
	174
	175	This triggers population of data from the branch for its revision.
	176	"""
	177	self._locks += 1
	178	try:
	179	if self._locks == 1:
	180	self.branch.lock_read()
	181	self._lock_mode = "r"
	182	self._populate_from_branch()
	183	except:
	184	self._locks -= 1
	185	raise
	186
1986.1.8 by Robert Collins Update to bzr.dev, which involves adding lock_tree_write to MutableTree and MemoryTree.	187	def lock_tree_write(self):
	188	"""See MutableTree.lock_tree_write()."""
	189	self._locks += 1
	190	try:
	191	if self._locks == 1:
	192	self.branch.lock_read()
	193	self._lock_mode = "w"
	194	self._populate_from_branch()
	195	elif self._lock_mode == "r":
	196	raise errors.ReadOnlyError(self)
	197	except:
	198	self._locks -= 1
	199	raise
	200
1986.1.2 by Robert Collins Various changes to allow non-workingtree specific tests to run entirely	201	def lock_write(self):
	202	"""See MutableTree.lock_write()."""
	203	self._locks += 1
	204	try:
	205	if self._locks == 1:
	206	self.branch.lock_write()
	207	self._lock_mode = "w"
	208	self._populate_from_branch()
	209	elif self._lock_mode == "r":
	210	raise errors.ReadOnlyError(self)
	211	except:
	212	self._locks -= 1
	213	raise
	214
	215	def _populate_from_branch(self):
	216	"""Populate the in-tree state from the branch."""
	217	self._basis_tree = self.branch.repository.revision_tree(
	218	self._branch_revision_id)
	219	if self._branch_revision_id is None:
	220	self._parent_ids = []
	221	else:
	222	self._parent_ids = [self._branch_revision_id]
	223	self._inventory = deepcopy(self._basis_tree._inventory)
	224	self._file_transport = MemoryTransport()
	225	# TODO copy the revision trees content, or do it lazy, or something.
	226	inventory_entries = self._inventory.iter_entries()
	227	for path, entry in inventory_entries:
1731.1.50 by Aaron Bentley Merge bzr.dev	228	if path == '':
1731.1.50 by Aaron Bentley Merge bzr.dev	229	continue
1986.1.2 by Robert Collins Various changes to allow non-workingtree specific tests to run entirely	230	if entry.kind == 'directory':
	231	self._file_transport.mkdir(path)
	232	elif entry.kind == 'file':
1986.1.4 by Robert Collins Fixup deprecations from bzr.dev.	233	self._file_transport.put_file(path,
1986.1.2 by Robert Collins Various changes to allow non-workingtree specific tests to run entirely	234	self._basis_tree.get_file(entry.file_id))
	235	else:
	236	raise NotImplementedError(self._populate_from_branch)
	237
	238	def put_file_bytes_non_atomic(self, file_id, bytes):
	239	"""See MutableTree.put_file_bytes_non_atomic."""
1986.1.4 by Robert Collins Fixup deprecations from bzr.dev.	240	self._file_transport.put_bytes(self.id2path(file_id), bytes)
1986.1.2 by Robert Collins Various changes to allow non-workingtree specific tests to run entirely	241
	242	def unlock(self):
	243	"""Release a lock.
	244
	245	This frees all cached state when the last lock context for the tree is
	246	left.
	247	"""
	248	if self._locks == 1:
	249	self._basis_tree = None
	250	self._parent_ids = []
	251	self._inventory = None
	252	try:
	253	self.branch.unlock()
	254	finally:
	255	self._locks = 0
	256	self._lock_mode = None
	257	else:
	258	self._locks -= 1
	259
1986.1.8 by Robert Collins Update to bzr.dev, which involves adding lock_tree_write to MutableTree and MemoryTree.	260	@needs_tree_write_lock
1986.1.3 by Robert Collins Merge bzr.dev.	261	def unversion(self, file_ids):
	262	"""Remove the file ids in file_ids from the current versioned set.
	263
	264	When a file_id is unversioned, all of its children are automatically
	265	unversioned.
	266
	267	:param file_ids: The file ids to stop versioning.
	268	:raises: NoSuchId if any fileid is not currently versioned.
	269	"""
	270	# XXX: This should be in mutabletree, but the inventory-save action
	271	# is not relevant to memory tree. Until that is done in unlock by
	272	# working tree, we cannot share the implementation.
	273	for file_id in file_ids:
	274	if self._inventory.has_id(file_id):
	275	self._inventory.remove_recursive_id(file_id)
	276	else:
	277	raise errors.NoSuchId(self, file_id)
	278
2418.5.1 by John Arbash Meinel Make a Branch helper which can create a very basic MemoryTree with history.	279	def set_parent_ids(self, revision_ids, allow_leftmost_as_ghost=False):
	280	"""See MutableTree.set_parent_trees()."""
2598.5.2 by Aaron Bentley Got all tests passing with Branch returning 'null:' for null revision	281	for revision_id in revision_ids:
	282	_mod_revision.check_not_reserved_id(revision_id)
2418.5.1 by John Arbash Meinel Make a Branch helper which can create a very basic MemoryTree with history.	283	if len(revision_ids) == 0:
	284	self._parent_ids = []
	285	self._basis_tree = self.branch.repository.revision_tree(None)
	286	else:
	287	self._parent_ids = revision_ids
	288	self._basis_tree = self.branch.repository.revision_tree(
	289	revision_ids[0])
	290	self._branch_revision_id = revision_ids[0]
	291
1986.1.2 by Robert Collins Various changes to allow non-workingtree specific tests to run entirely	292	def set_parent_trees(self, parents_list, allow_leftmost_as_ghost=False):
	293	"""See MutableTree.set_parent_trees()."""
	294	if len(parents_list) == 0:
	295	self._parent_ids = []
2418.5.1 by John Arbash Meinel Make a Branch helper which can create a very basic MemoryTree with history.	296	self._basis_tree = self.branch.repository.revision_tree(None)
1986.1.2 by Robert Collins Various changes to allow non-workingtree specific tests to run entirely	297	else:
	298	if parents_list[0][1] is None and not allow_leftmost_as_ghost:
	299	# a ghost in the left most parent
	300	raise errors.GhostRevisionUnusableHere(parents_list[0][0])
	301	self._parent_ids = [parent_id for parent_id, tree in parents_list]
2598.5.2 by Aaron Bentley Got all tests passing with Branch returning 'null:' for null revision	302	if parents_list[0][1] is None or parents_list[0][1] == 'null:':
2418.5.1 by John Arbash Meinel Make a Branch helper which can create a very basic MemoryTree with history.	303	self._basis_tree = self.branch.repository.revision_tree(None)
1986.1.2 by Robert Collins Various changes to allow non-workingtree specific tests to run entirely	304	else:
	305	self._basis_tree = parents_list[0][1]
1986.1.6 by Robert Collins Add MemoryTree.last_revision.	306	self._branch_revision_id = parents_list[0][0]