Created date parsing and reconciliation systems for robust date handling.

Author: Kaden McKeen

cyclops/data/df/dates/__init__.py

@@ -0,0 +1 @@
+"""Processors for date handling."""

cyclops/data/df/dates/common.py

@@ -0,0 +1,52 @@
+from typing import Any, Dict, List, Optional, Set, Union
+
+import numpy as np
+
+
+def to_list(obj: Any) -> List[Any]:
+    """Convert some object to a list of object(s) unless already one.
+
+    Parameters
+    ----------
+    obj : any
+        The object to convert to a list.
+
+    Returns
+    -------
+    list
+        The processed object.
+
+    """
+    if isinstance(obj, list):
+        return obj
+
+    if isinstance(obj, (np.ndarray, set, dict)):
+        return list(obj)
+
+    return [obj]
+
+
+def to_list_optional(
+    obj: Optional[Any], none_to_empty: bool = False
+) -> Union[List[Any], None]:
+    """Convert some object to a list of object(s) unless already None or a list.
+
+    Parameters
+    ----------
+    obj : any
+        The object to convert to a list.
+    none_to_empty: bool, default = False
+        If true, return a None obj as an empty list. Otherwise, return as None.
+
+    Returns
+    -------
+    list or None
+        The processed object.
+
+    """
+    if obj is None:
+        if none_to_empty:
+            return []
+        return None
+
+    return to_list(obj)