add calculated timestamp

docs/parsers/git_log.md

@@ -16,6 +16,12 @@ Additional options supported:
 - `--stat`
 - `--shortstat`
 
+The `epoch` calculated timestamp field is naive. (i.e. based on the
+local time of the system the parser is run on)
+
+The `epoch_utc` calculated timestamp field is timezone-aware and is
+only available if the timezone field is UTC.
+
 Usage (cli):
 
     $ git log | jc --git-log
@@ -37,6 +43,8 @@ Schema:
         "author":               string,
         "author_email":         string,
         "date":                 string,
+        "epoch":                integer,
+        "epoch_utc":            integer,
         "commit_by":            string,
         "commit_by_email":      string,
         "commit_by_date":       string,

docs/utils.md

@@ -187,7 +187,7 @@ class timestamp()
 
 ```python
 def __init__(datetime_string: str,
-             format_hint: Union[List, Tuple, None] = None) -> None
+             format_hint: Optional[Iterable] = None) -> None
 ```
 
 Input a datetime text string of several formats and convert to a
@@ -198,7 +198,7 @@ Parameters:
     datetime_string  (str):  a string representation of a
         datetime in several supported formats
 
-    format_hint  (list | tuple):  an optional list of format ID
+    format_hint  (iterable):  an optional iterable of format ID
         integers to instruct the timestamp object to try those
         formats first in the order given. Other formats will be
         tried after the format hint list is exhausted. This can

jc/parsers/git_log.py

@@ -11,6 +11,12 @@ Additional options supported:
 - `--stat`
 - `--shortstat`
 
+The `epoch` calculated timestamp field is naive. (i.e. based on the
+local time of the system the parser is run on)
+
+The `epoch_utc` calculated timestamp field is timezone-aware and is
+only available if the timezone field is UTC.
+
 Usage (cli):
 
     $ git log | jc --git-log
@@ -32,6 +38,8 @@ Schema:
         "author":               string,
         "author_email":         string,
         "date":                 string,
+        "epoch":                integer,
+        "epoch_utc":            integer,
         "commit_by":            string,
         "commit_by_email":      string,
         "commit_by_date":       string,
@@ -86,7 +94,13 @@ def _process(proc_data: List[Dict]) -> List[Dict]:
         List of Dictionaries. Structured to conform to the schema.
     """
     int_list = ['files_changed', 'insertions', 'deletions']
+
     for entry in proc_data:
+        if 'date' in entry:
+            ts = jc.utils.timestamp(entry['date'], format_hint=(1100,))
+            entry['epoch'] = ts.naive
+            entry['epoch_utc'] = ts.utc
+
         if 'stats' in entry:
             for key in entry['stats']:
                 if key in int_list:

jc/utils.py

@@ -6,7 +6,7 @@ import shutil
 from datetime import datetime, timezone
 from textwrap import TextWrapper
 from functools import lru_cache
-from typing import List, Tuple, Union, Optional
+from typing import List, Iterable, Union, Optional
 
 
 def warning_message(message_lines: List[str]) -> None:
@@ -233,7 +233,7 @@ def input_type_check(data: str) -> None:
 class timestamp:
     def __init__(self,
                  datetime_string: str,
-                 format_hint: Union[List, Tuple, None] = None
+                 format_hint: Optional[Iterable] = None
     ) -> None:
         """
         Input a datetime text string of several formats and convert to a
@@ -244,7 +244,7 @@ class timestamp:
             datetime_string  (str):  a string representation of a
                 datetime in several supported formats
 
-            format_hint  (list | tuple):  an optional list of format ID
+            format_hint  (iterable):  an optional iterable of format ID
                 integers to instruct the timestamp object to try those
                 formats first in the order given. Other formats will be
                 tried after the format hint list is exhausted. This can
@@ -361,6 +361,7 @@ class timestamp:
 
         formats = [
             {'id': 1000, 'format': '%a %b %d %H:%M:%S %Y', 'locale': None},  # manual C locale format conversion: Tue Mar 23 16:12:11 2021 or Tue Mar 23 16:12:11 IST 2021
+            {'id': 1100, 'format': '%a %b %d %H:%M:%S %Y %z', 'locale': None}, # git date output: Thu Mar 5 09:17:40 2020 -0800
             {'id': 1500, 'format': '%Y-%m-%d %H:%M', 'locale': None},  # en_US.UTF-8 local format (found in who cli output): 2021-03-23 00:14
             {'id': 1600, 'format': '%m/%d/%Y %I:%M %p', 'locale': None},  # Windows english format (found in dir cli output): 12/07/2019 02:09 AM
             {'id': 1700, 'format': '%m/%d/%Y, %I:%M:%S %p', 'locale': None},  # Windows english format wint non-UTC tz (found in systeminfo cli output): 3/22/2021, 1:15:51 PM (UTC-0600)

man/jc.1

@@ -1,4 +1,4 @@
-.TH jc 1 2022-04-19 1.18.7 "JSON Convert"
+.TH jc 1 2022-04-20 1.18.7 "JSON Convert"
 .SH NAME
 jc \- JSONifies the output of many CLI tools and file-types
 .SH SYNOPSIS