All times are not stored as time_struct, but as simple int to consume less memory

time imports cleaned up and mostly removed as they were not required (anymore)

Author: Byron

CHANGES

@@ -20,6 +20,9 @@ General
   may change without prior notice.
 * Renamed all find_all methods to list_items - this method is part of the Iterable interface
   that also provides a more efficients and more responsive iter_items method
+* All dates, like authored_date and committer_date, are stored as seconds since epoc
+  to consume less memory - they can be converted using time.gmtime in a more suitable 
+  presentation format if needed.
 
 Item Iteration
 --------------

lib/git/objects/commit.py

@@ -4,14 +4,12 @@
 # This module is part of GitPython and is released under
 # the BSD License: http://www.opensource.org/licenses/bsd-license.php
 
-import re
-import time
 from git.utils import Iterable
-from git.actor import Actor
 import git.diff as diff
 import git.stats as stats
 from tree import Tree
 import base
+import utils
 
 class Commit(base.Object, Iterable):
 	"""
@@ -20,8 +18,6 @@ class Commit(base.Object, Iterable):
 	This class will act lazily on some of its attributes and will query the 
 	value on demand only if it involves calling the git binary.
 	"""
-	# precompiled regex
-	re_actor_epoch = re.compile(r'^.+? (.*) (\d+) .*$')
 
 	# object configuration 
 	type = "commit"
@@ -48,14 +44,16 @@ def __init__(self, repo, id, tree=None, author=None, authored_date=None,
 		``author`` : Actor
 			is the author string ( will be implicitly converted into an Actor object )
 
-		``authored_date`` : (tm_year, tm_mon, tm_mday, tm_hour, tm_min, tm_sec, tm_wday, tm_yday, tm_isdst )
-			is the authored DateTime
+		``authored_date`` : int_seconds_since_epoch
+			is the authored DateTime - use time.gmtime() to convert it into a 
+			different format
 
 		``committer`` : Actor
 			is the committer string
 
-		``committed_date`` : (tm_year, tm_mon, tm_mday, tm_hour, tm_min, tm_sec, tm_wday, tm_yday, tm_isdst)
-			is the committed DateTime
+		``committed_date`` : int_seconds_since_epoch
+			is the committed DateTime - use time.gmtime() to convert it into a 
+			different format
 
 		``message`` : string
 			is the commit message
@@ -185,8 +183,8 @@ def _iter_from_process_or_stream(cls, repo, proc_or_stream):
 				parents.append(parent_line.split()[-1])
 			# END for each parent line
 
-			author, authored_date = cls._actor(next_line)
-			committer, committed_date = cls._actor(stream.next())
+			author, authored_date = utils.parse_actor_and_date(next_line)
+			committer, committed_date = utils.parse_actor_and_date(stream.next())
 
 			# empty line
 			stream.next()
@@ -286,14 +284,3 @@ def __str__(self):
 	def __repr__(self):
 		return '<git.Commit "%s">' % self.id
 
-	@classmethod
-	def _actor(cls, line):
-		"""
-		Parse out the actor (author or committer) info
-
-		Returns
-			[Actor, gmtime(acted at time)]
-		"""
-		m = cls.re_actor_epoch.search(line)
-		actor, epoch = m.groups()
-		return (Actor._from_string(actor), time.gmtime(int(epoch)))

lib/git/objects/tag.py

@@ -7,8 +7,7 @@
 Module containing all object based types.
 """
 import base
-import commit
-from utils import get_object_type_by_name
+import utils
 
 class TagObject(base.Object):
 	"""
@@ -38,8 +37,9 @@ def __init__(self, repo, id, object=None, tag=None,
 		 ``tagger``
 			Actor identifying the tagger
 			
-		  ``tagged_date`` : (tm_year, tm_mon, tm_mday, tm_hour, tm_min, tm_sec, tm_wday, tm_yday, tm_isdst)
-			is the DateTime of the tag creation
+		  ``tagged_date`` : int_seconds_since_epoch
+			is the DateTime of the tag creation - use time.gmtime to convert 
+			it into a different format
 		"""
 		super(TagObject, self).__init__(repo, id )
 		self._set_self_from_args_(locals())
@@ -53,12 +53,12 @@ def _set_cache_(self, attr):
 
 			obj, hexsha = lines[0].split(" ")		# object <hexsha>
 			type_token, type_name = lines[1].split(" ") # type <type_name>
-			self.object = get_object_type_by_name(type_name)(self.repo, hexsha)
+			self.object = utils.get_object_type_by_name(type_name)(self.repo, hexsha)
 
 			self.tag = lines[2][4:]  # tag <tag name>
 
 			tagger_info = lines[3][7:]# tagger <actor> <date>
-			self.tagger, self.tagged_date = commit.Commit._actor(tagger_info)
+			self.tagger, self.tagged_date = utils.parse_actor_and_date(tagger_info)
 
 			# line 4 empty - check git source to figure out purpose
 			self.message = "\n".join(lines[5:])

lib/git/objects/utils.py

@@ -6,7 +6,9 @@
 """
 Module for general utility functions
 """
+import re
 import commit, tag, blob, tree
+from git.actor import Actor
 
 def get_object_type_by_name(object_type_name):
 	"""
@@ -34,3 +36,20 @@ def get_object_type_by_name(object_type_name):
 		return tree.Tree
 	else:
 		raise ValueError("Cannot handle unknown object type: %s" % object_type_name)
+		
+	
+# precompiled regex
+_re_actor_epoch = re.compile(r'^.+? (.*) (\d+) .*$')
+
+def parse_actor_and_date(line):
+	"""
+	Parse out the actor (author or committer) info from a line like::
+	
+	 author Tom Preston-Werner <[email protected]> 1191999972 -0700
+	
+	Returns
+		[Actor, int_seconds_since_epoch]
+	"""
+	m = _re_actor_epoch.search(line)
+	actor, epoch = m.groups()
+	return (Actor._from_string(actor), int(epoch))

lib/git/repo.py

@@ -8,7 +8,6 @@
 import re
 import gzip
 import StringIO
-import time
 
 from errors import InvalidGitRepositoryError, NoSuchPathError
 from utils import touch, is_git_dir
@@ -160,7 +159,7 @@ def blame(self, commit, file):
 					if firstpart.endswith('-mail'):
 						info["%s_email" % role] = parts[-1]
 					elif firstpart.endswith('-time'):
-						info["%s_date" % role] = time.gmtime(int(parts[-1]))
+						info["%s_date" % role] = int(parts[-1])
 					elif role == firstpart:
 						info[role] = parts[-1]
 					# END distinguish mail,time,name
@@ -197,12 +196,13 @@ def blame(self, commit, file):
 			# END distinguish hexsha vs other information
 		return blames
 
-	def commits(self, start='master', path='', max_count=None, skip=0):
+	def commits(self, start=None, path='', max_count=None, skip=0):
 		"""
 		A list of Commit objects representing the history of a given ref/commit
 
 		``start``
-			is the branch/commit name (default 'master')
+			is a ref to start the commits from. If start is None, 
+			the active branch will be used
 
 		 ``path``
 			is an optional path to limit the returned commits to
@@ -223,7 +223,8 @@ def commits(self, start='master', path='', max_count=None, skip=0):
 
 		if max_count is None:
 			options.pop('max_count')		   
-				  
+		if start is None:
+			start = self.active_branch	
 		return Commit.list_items(self, start, path, **options)
 
 	def commits_between(self, frm, to):

test/git/test_base.py

@@ -4,7 +4,6 @@
 # This module is part of GitPython and is released under
 # the BSD License: http://www.opensource.org/licenses/bsd-license.php
 
-import time
 from test.testlib import *
 from git import *
 import git.objects.base as base

test/git/test_blob.py

@@ -4,7 +4,6 @@
 # This module is part of GitPython and is released under
 # the BSD License: http://www.opensource.org/licenses/bsd-license.php
 
-import time
 from test.testlib import *
 from git import *
 

test/git/test_repo.py

@@ -5,7 +5,6 @@
 # the BSD License: http://www.opensource.org/licenses/bsd-license.php
 
 import os, sys
-import time
 from test.testlib import *
 from git import *
 
@@ -51,10 +50,10 @@ def test_commits(self, git):
 		assert_equal("672eca9b7f9e09c22dcb128c283e8c3c8d7697a4", c.tree.id)
 		assert_equal("Tom Preston-Werner", c.author.name)
 		assert_equal("[email protected]", c.author.email)
-		assert_equal(time.gmtime(1191999972), c.authored_date)
+		assert_equal(1191999972, c.authored_date)
 		assert_equal("Tom Preston-Werner", c.committer.name)
 		assert_equal("[email protected]", c.committer.email)
-		assert_equal(time.gmtime(1191999972), c.committed_date)
+		assert_equal(1191999972, c.committed_date)
 		assert_equal("implement Grit#heads", c.message)
 
 		c = commits[1]
@@ -233,10 +232,10 @@ def test_should_display_blame_information(self, git):
 		assert_equal('634396b2f541a9f2d58b00be1a07f0c358b999b3', c.id)
 		assert_equal('Tom Preston-Werner', c.author.name)
 		assert_equal('[email protected]', c.author.email)
-		assert_equal(time.gmtime(1191997100), c.authored_date)
+		assert_equal(1191997100, c.authored_date)
 		assert_equal('Tom Preston-Werner', c.committer.name)
 		assert_equal('[email protected]', c.committer.email)
-		assert_equal(time.gmtime(1191997100), c.committed_date)
+		assert_equal(1191997100, c.committed_date)
 		assert_equal('initial grit setup', c.message)
 
 		# test the 'lines per commit' entries

test/git/test_tag.py

@@ -8,7 +8,6 @@
 from test.testlib import *
 from git import *
 from git.objects.tag import TagObject
-import time
 
 class TestTag(object):
 	def setup(self):
@@ -26,7 +25,7 @@ def test_tag_base(self):
 				assert isinstance( tagobj, TagObject ) 
 				assert tagobj.tag == tag.name
 				assert isinstance( tagobj.tagger, Actor )
-				assert isinstance( tagobj.tagged_date, time.struct_time )
+				assert isinstance( tagobj.tagged_date, int )
 				assert tagobj.message
 			# END if we have a tag object
 		# END for tag in repo-tags