commit.name_rev property added for convenience

Author: Byron

CHANGES

@@ -61,6 +61,7 @@ GitCommand
 Commit
 ------
 * 'count' method is not an instance method to increase its ease of use
+* 'name_rev' property returns a nice name for the commit's sha
 
 Config
 ------

lib/git/objects/commit.py

@@ -117,6 +117,15 @@ def count(self, paths='', **kwargs):
 		"""
 		return len(self.repo.git.rev_list(self.id, '--', paths, **kwargs).strip().splitlines())
 
+	@property
+	def name_rev(self):
+		"""
+		Returns
+			String describing the commits hex sha based on the closest Reference.
+			Mostly useful for UI purposes
+		"""
+		return self.repo.git.name_rev(self)
+
 	@classmethod
 	def iter_items(cls, repo, rev, paths='', **kwargs):
 		"""

test/git/test_commit.py

@@ -94,3 +94,7 @@ def test_iter_parents(self):
 			assert first_parent == c.parents[0]
 		# END for each 
 
+	def test_base(self):
+		name_rev = self.rorepo.head.commit.name_rev
+		assert isinstance(name_rev, basestring)
+