# tree.py # Copyright (C) 2008-2010 Michael Trier (mtrier@gmail.com) and contributors # # This module is part of GitPython and is released under # the BSD License: http://www.opensource.org/licenses/bsd-license.php import os from lazy import LazyMixin import blob class Tree(LazyMixin): def __init__(self, repo, id, mode=None, name=None): LazyMixin.__init__(self) self.repo = repo self.id = id self.mode = mode self.name = name self._contents = None def __bake__(self): # Ensure the treeish references directly a tree treeish = self.id if not treeish.endswith(':'): treeish = treeish + ':' # Read the tree contents. self._contents = {} for line in self.repo.git.ls_tree(self.id).splitlines(): obj = self.content_from_string(self.repo, line) if obj is not None: self._contents[obj.name] = obj @staticmethod def content_from_string(repo, text): """ Parse a content item and create the appropriate object ``repo`` is the Repo ``text`` is the single line containing the items data in `git ls-tree` format Returns ``git.Blob`` or ``git.Tree`` """ try: mode, typ, id, name = text.expandtabs(1).split(" ", 3) except: return None if typ == "tree": return Tree(repo, id=id, mode=mode, name=name) elif typ == "blob": return blob.Blob(repo, id=id, mode=mode, name=name) elif typ == "commit": return None else: raise(TypeError, "Invalid type: %s" % typ) def __div__(self, file): """ Find the named object in this tree's contents Examples:: >>> Repo('/path/to/python-git').tree()/'lib' >>> Repo('/path/to/python-git').tree()/'README' Returns ``git.Blob`` or ``git.Tree`` or ``None`` if not found """ return self.get(file) @property def basename(self): os.path.basename(self.name) def __repr__(self): return '' % self.id # Implement the basics of the dict protocol: # directories/trees can be seen as object dicts. def __getitem__(self, key): return self._contents[key] def __iter__(self): return iter(self._contents) def __len__(self): return len(self._contents) def __contains__(self, key): return key in self._contents def get(self, key): return self._contents.get(key) def items(self): return self._contents.items() def keys(self): return self._contents.keys() def values(self): return self._contents.values()