Add (Unix) TimestampMatcher

Signed-off-by: Olivier Mehani <shtrom@ssji.net>

Author: shtrom

rotate_backups/__init__.py

@@ -312,6 +312,30 @@ def search(self, entry: str) -> FilenameMatch:
             return FilenameMatch(match)
 
 
+class TimestampMatch:
+    entry: str = None
+    field: str = None
+
+    def __init__(self, entry: str, timestamp='mtime'):
+        self.entry = entry
+        self.field = f'st_{timestamp}'
+
+    def match_to_datetime(self) -> datetime.datetime:
+        return datetime.datetime.fromtimestamp(
+            getattr(os.stat(self.entry), self.field)
+        )
+
+
+class TimestampMatcher:
+    timestamp: str = None
+
+    def __init__(self, timestamp='mtime'):
+        self.timestamp = timestamp
+
+    def search(self, entry: str) -> Match:
+        return TimestampMatch(entry, self.timestamp)
+
+
 class RotateBackups(PropertyManager):
 
     """Python API for the ``rotate-backups`` program."""