Added .get_timestamp method for retrieving the timestamp of a given r…

…evision.

jaraco/vcs/base.py

@@ -7,6 +7,7 @@
 import os.path
 import posixpath
 
+import dateutil.parser
 from more_itertools import one
 
 import jaraco.versioning as versioning
@@ -120,3 +121,6 @@ def subrepos(self):
 
     def sub_paths(self):
         raise NotImplementedError()
+
+    def get_timestamp(self, rev):
+        return dateutil.parser.parse(self._get_timestamp_str(rev))

jaraco/vcs/cmd.py

@@ -144,6 +144,9 @@ def sub_paths(self):
         except Exception:
             return ()
 
+    def _get_timestamp_str(self, rev):
+        return self._invoke('log', '-l', '1', '--template', '{date|isodate}', '-r', rev)
+
 
 class Git(Command):
     exe = 'git'
@@ -205,3 +208,6 @@ def get_ancestral_tags(self, rev=None):
     def sub_paths(self):
         lines = self._invoke('submodules', 'status').splitlines()
         return (line.split()[1] for line in lines)
+
+    def _get_timestamp_str(self, rev):
+        return self._invoke('log', '-1', '--format=%ai', rev)

newsfragments/+6c48af32.feature.rst

@@ -0,0 +1 @@
+Added .get_timestamp method for retrieving the timestamp of a given revision.

pyproject.toml

@@ -23,6 +23,7 @@ dependencies = [
 	"jaraco.classes",
 	"more_itertools",
 	"jaraco.versioning",
+	"python-dateutil",
 ]
 dynamic = ["version"]
 
@@ -42,6 +43,7 @@ testing = [
 	# local
 	"pygments",
 	"jaraco.path",
+	"types-python-dateutil",
 ]
 docs = [
 	# upstream

tests/test_git.py

@@ -1,3 +1,4 @@
+import datetime
 import os
 
 import pytest
@@ -41,3 +42,11 @@ def test_simple(self):
     def test_trailing_mess(self):
         val = cmd.Git._parse_version('git version 1.9.3 (Mac OS X)')
         assert val == '1.9.3'
+
+
+@pytest.mark.usefixtures("git_repo")
+class TestRevisionTimestamp:
+    def test_tagged_rev_timestamp(self):
+        mgr = vcs.Git('.')
+        mgr._invoke('tag', '-am', 'tagging 1.0', '1.0')
+        assert mgr.get_timestamp('1.0').date() == datetime.date.today()

tests/test_mercurial.py

@@ -1,3 +1,4 @@
+import datetime
 import operator
 import os
 import platform
@@ -155,3 +156,11 @@ def test_ancestral_tags_specified(self):
         self._setup_branchy_tags()
         (tag,) = self.mgr.get_ancestral_tags(3)
         assert tag.tag == '1.0'
+
+
+@pytest.mark.usefixtures("hg_repo")
+class TestRevisionTimestamp:
+    def test_tagged_rev_timestamp(self):
+        mgr = vcs.Mercurial('.')
+        mgr._invoke('tag', '1.0')
+        assert mgr.get_timestamp('1.0').date() == datetime.date.today()