Initial commit: Email alerts application

2025-07-25 11:31:36 +01:00
commit adfb625ae9
6322 changed files with 2882826 additions and 0 deletions
@@ -0,0 +1,75 @@
+import datetime
+from decimal import BasicContext, Decimal
+from email.utils import parsedate
+from typing import Optional, Union
+
+ISO8601_DATE_FORMAT = "%Y-%m-%d"
+ISO8601_DATETIME_FORMAT = "%Y-%m-%dT%H:%M:%SZ"
+
+
+def iso8601_date(s: str) -> Union[datetime.date, str]:
+    """
+    Parses an ISO 8601 date string and returns a UTC date object or the string
+    if the parsing failed.
+    :param s: ISO 8601-formatted date string (2015-01-25)
+    :return:
+    """
+    try:
+        return (
+            datetime.datetime.strptime(s, ISO8601_DATE_FORMAT)
+            .replace(tzinfo=datetime.timezone.utc)
+            .date()
+        )
+    except (TypeError, ValueError):
+        return s
+
+
+def iso8601_datetime(
+    s: str,
+) -> Union[datetime.datetime, str]:
+    """
+    Parses an ISO 8601 datetime string and returns a UTC datetime object,
+    or the string if parsing failed.
+    :param s: ISO 8601-formatted datetime string (2015-01-25T12:34:56Z)
+    """
+    try:
+        return datetime.datetime.strptime(s, ISO8601_DATETIME_FORMAT).replace(
+            tzinfo=datetime.timezone.utc
+        )
+    except (TypeError, ValueError):
+        return s
+
+
+def rfc2822_datetime(s: str) -> Optional[datetime.datetime]:
+    """
+    Parses an RFC 2822 date string and returns a UTC datetime object,
+    or the string if parsing failed.
+    :param s: RFC 2822-formatted string date
+    :return: datetime or str
+    """
+    date_tuple = parsedate(s)
+    if date_tuple is None:
+        return None
+    return datetime.datetime(*date_tuple[:6]).replace(tzinfo=datetime.timezone.utc)
+
+
+def decimal(d: Optional[str]) -> Union[Decimal, str]:
+    """
+    Parses a decimal string into a Decimal
+    :param d: decimal string
+    """
+    if not d:
+        return d
+    return Decimal(d, BasicContext)
+
+
+def integer(i: str) -> Union[int, str]:
+    """
+    Parses an integer string into an int
+    :param i: integer string
+    :return: int
+    """
+    try:
+        return int(i)
+    except (TypeError, ValueError):
+        return i