support dill/pickle

dummio/__init__.py

@@ -4,6 +4,7 @@
 
 
 from dummio import json as json
+from dummio import pickle as pickle
 from dummio import text as text
 
 try:
@@ -23,3 +24,9 @@
 except ImportError:
     # this would require the optional dependency pydantic
     pass
+
+try:
+    from dummio import dill as dill
+except ImportError:
+    # this would require the optional dependency dill
+    pass

dummio/dill.py

@@ -0,0 +1,19 @@
+"""IO for dill."""
+
+from typing import Any
+
+import dill
+
+from dummio.constants import PathType
+
+
+def save(data: Any, *, filepath: PathType) -> None:
+    """Save a dill file."""
+    with open(filepath, "wb") as file:
+        dill.dump(data, file)
+
+
+def load(filepath: PathType) -> Any:
+    """Read a dill file."""
+    with open(filepath, "rb") as file:
+        return dill.load(file)

dummio/pickle.py

@@ -0,0 +1,18 @@
+"""IO for pickle."""
+
+import pickle
+from typing import Any
+
+from dummio.constants import PathType
+
+
+def save(data: Any, *, filepath: PathType) -> None:
+    """Save a pickle file."""
+    with open(filepath, "wb") as file:
+        pickle.dump(data, file)
+
+
+def load(filepath: PathType) -> Any:
+    """Read a pickle file."""
+    with open(filepath, "rb") as file:
+        return pickle.load(file)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dummio"
-version = "1.3.0"
+version = "1.4.0"
 description = "Easiest-possible IO for basic file types."
 authors = [{ name = "Zach Kurtz", email = "[email protected]" }]
 readme = "README.md"
@@ -21,6 +21,7 @@ extras = [
   "pyyaml>=6.0.2",
   "onnx>=1.10.1",
   "pydantic>=2.10.2",
+  "dill>=0.2.2",
 ]
 
 [project.urls]

tests/test_all_basic.py

@@ -50,3 +50,21 @@ def test_yaml(tmp_path: Path) -> None:
         data=dictionary(),
         module=dummio.yaml,
     )
+
+
+def test_pickle(tmp_path: Path) -> None:
+    """Test the packio package."""
+    _assert_cycle(
+        path=tmp_path / "data.pkl",
+        data=dictionary(),
+        module=dummio.pickle,
+    )
+
+
+def test_dill(tmp_path: Path) -> None:
+    """Test the packio package."""
+    _assert_cycle(
+        path=tmp_path / "data.pkl",
+        data=dictionary(),
+        module=dummio.dill,
+    )

tests/test_assert_module_protocol.py

@@ -7,8 +7,10 @@
 from dummio.protocol import assert_module_protocol
 
 IO_MODULES = [
+    "dummio.dill",
     "dummio.json",
     "dummio.onnx",
+    "dummio.pickle",
     "dummio.pydantic",
     "dummio.text",
     "dummio.yaml",