Prep v0.9.10

Author: denisecase

CHANGELOG.md

@@ -14,6 +14,13 @@ and this project adheres to **[Semantic Versioning](https://semver.org/spec/v2.0
 
 ---
 
+## [0.9.10] - 2025-10-26
+
+### Changed
+- add yaml_utils
+
+---
+
 ## [0.9.9] - 2025-10-26
 
 ### Changed
@@ -58,7 +65,8 @@ and this project adheres to **[Semantic Versioning](https://semver.org/spec/v2.0
   Tag the repository with `vX.Y.Z` to publish a release.
 - Documentation and badges are updated per tag and aliased to **latest**.
 
-[Unreleased]: https://github.com/civic-interconnect/civic-transparency-py-sdk/compare/v0.9.9...HEAD
+[Unreleased]: https://github.com/civic-interconnect/civic-transparency-py-sdk/compare/v0.9.10...HEAD
+[0.9.10]: https://github.com/civic-interconnect/civic-transparency-py-sdk/releases/tag/v0.9.10
 [0.9.9]: https://github.com/civic-interconnect/civic-transparency-py-sdk/releases/tag/v0.9.9
 [0.9.8]: https://github.com/civic-interconnect/civic-transparency-py-sdk/releases/tag/v0.9.8
 [0.9.7]: https://github.com/civic-interconnect/civic-transparency-py-sdk/releases/tag/v0.9.7

src/civic_lib_core/yaml_utils.py

@@ -0,0 +1,42 @@
+"""Lightweight helpers for reading and writing YAML files.
+
+File: yaml_utils.py
+"""
+
+from pathlib import Path
+from typing import Any
+
+import yaml
+
+__all__ = ["write_yaml", "read_yaml"]
+
+
+def write_yaml(data: dict[str, Any], path: str | Path) -> Path:
+    """Write a dictionary to a YAML file.
+
+    Args:
+        data (dict): Data to write.
+        path (str | Path): File path to write to.
+
+    Returns:
+        Path: The path the file was written to.
+    """
+    path = Path(path)
+    path.parent.mkdir(parents=True, exist_ok=True)
+    with path.open("w", encoding="utf-8") as f:
+        yaml.dump(data, f, sort_keys=False)
+    return path
+
+
+def read_yaml(path: str | Path) -> dict[str, Any]:
+    """Read and parse a YAML file into a dictionary.
+
+    Args:
+        path (str | Path): YAML file path.
+
+    Returns:
+        dict: Parsed YAML data.
+    """
+    path = Path(path)
+    with path.open("r", encoding="utf-8") as f:
+        return yaml.safe_load(f)

tests/test_yaml_utils.py

@@ -0,0 +1,11 @@
+from pathlib import Path
+import tempfile
+
+from civic_lib_core.yaml_utils import read_yaml, write_yaml
+
+
+def test_roundtrip_yaml():
+    data = {"a": 1, "b": {"c": 2}}
+    tmp = Path(tempfile.gettempdir()) / "test.yaml"
+    write_yaml(data, tmp)
+    assert read_yaml(tmp) == data