iqm-exa-common 26.11__py3-none-any.whl → 26.12__py3-none-any.whl

exa/common/helpers/yaml_helper.py

@@ -0,0 +1,43 @@
+#  ********************************************************************************
+#    _____  ____ _
+#   / _ \ \/ / _` |  Framework for control
+#  |  __/>  < (_| |  and measurement of
+#   \___/_/\_\__,_|  superconducting qubits
+#
+#  Copyright (c) 2019-2025 IQM Finland Oy.
+#  All rights reserved. Confidential and proprietary.
+#
+#  Distribution or reproduction of any information contained herein
+#  is prohibited without IQM Finland Oy’s prior written permission.
+#  ********************************************************************************
+"""YAML utilities."""
+
+import logging
+from pathlib import Path
+from typing import Any
+
+from ruamel.yaml import YAML, YAMLError
+
+logger = logging.getLogger(__name__)
+yaml = YAML(typ="safe", pure=True)
+
+
+def load_yaml(path: Path | str) -> dict[str, Any]:
+    """Load a YAML file from the given path and raise error if the file can't be loaded."""
+    path = path if isinstance(path, Path) else Path(path)
+    with path.open(encoding="utf-8") as file:
+        try:
+            data = yaml.load(file)
+        except YAMLError as err:
+            raise ValueError(f"Failed to load YAML file from {path}.") from err
+    logger.debug("Loaded a YAML file from %s.", path)
+    return data
+
+
+def dump_yaml(data: dict[str, Any], path: Path | str) -> None:
+    """Dump a YAML data to the given path. Create missing directories if necessary."""
+    path = path if isinstance(path, Path) else Path(path)
+    path.parent.mkdir(parents=True, exist_ok=True)
+    with path.open("w", encoding="utf-8") as file:
+        yaml.dump(data, file)
+    logger.debug("Saved a YAML file to %s.", path)

{iqm_exa_common-26.11.dist-info → iqm_exa_common-26.12.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: iqm-exa-common
-Version: 26.11
+Version: 26.12
 Summary: Framework for control and measurement of superconducting qubits: common library
 Author-email: IQM Finland Oy <info@meetiqm.com>
 License: Apache License
@@ -219,6 +219,8 @@ Requires-Dist: pydantic <3.0,>=2.10.4
 Requires-Dist: python-dotenv ==0.21.1
 Requires-Dist: xarray ==2024.10.0
 Requires-Dist: requests ==2.32.3
+Requires-Dist: ruamel-yaml ==0.17.32
+Requires-Dist: ruamel-yaml-clib ==0.2.8
 
 EXA-common
 ==========

{iqm_exa_common-26.11.dist-info → iqm_exa_common-26.12.dist-info}/RECORD

@@ -38,6 +38,7 @@ exa/common/helpers/deprecation.py,sha256=nY8484iun63JOBfBeh49Q6VD5xZ4_gT9fjPmH1R
 exa/common/helpers/json_helper.py,sha256=LoTrL6FREML1o0X3Zznf1baI4kn0kh03NE1nqBHgYss,2699
 exa/common/helpers/numpy_helper.py,sha256=KKKyZ_fD0O1gn7_InEQROYnX3WGMA6C1qHh8KzzjtUI,1062
 exa/common/helpers/software_version_helper.py,sha256=9vczRJFktNycbvB6FbbLDP8ejkRrmkg_-0S46tUfbyQ,5131
+exa/common/helpers/yaml_helper.py,sha256=wLy-7Nyit597FoWBemduUilYP2VCk_aDDT8y62i3ox8,1626
 exa/common/logger/__init__.py,sha256=1bIsGxHzfujXlkgtcAnWToKMkw3dpU5PEd_7LE_NpgQ,686
 exa/common/logger/logger.py,sha256=0aSjkx4pXy_CCKtspOnFgwMmhZVFAZUlopQ6HUjBMko,5689
 exa/common/qcm_data/__init__.py,sha256=VtsYkGoaniSjCkY0oQlqkcYJCtmC2sTDxfrIe_kpqZg,567
@@ -49,8 +50,8 @@ exa/common/qcm_data/qcm_data_client.py,sha256=0clAbZ3HPBH9lFOe8cVmaq8hPHG5m3pyPG
 exa/common/sweep/__init__.py,sha256=uEKk5AtzSgSnf8Y0geRPwUpqXIBIXpeCxsN64sX7F1o,591
 exa/common/sweep/database_serialization.py,sha256=NUu1umxRQZpKtRmw1vNDsSbnofqbHvKFg_xQ2mdhY6k,7469
 exa/common/sweep/util.py,sha256=-QE2AaH-WDkYAVH5-Z-30leLgY0x4efmby4kc1JTCgY,3732
-iqm_exa_common-26.11.dist-info/LICENSE.txt,sha256=R6Q7eUrLyoCQgWYorQ8WJmVmWKYU3dxA3jYUp0wwQAw,11332
-iqm_exa_common-26.11.dist-info/METADATA,sha256=ZBi19GWCpltp8bTk67J0FPgR3sOY_nGkMg4ysspskYg,14549
-iqm_exa_common-26.11.dist-info/WHEEL,sha256=y4mX-SOX4fYIkonsAGA5N0Oy-8_gI4FXw5HNI1xqvWg,91
-iqm_exa_common-26.11.dist-info/top_level.txt,sha256=Clphg2toaZ3_jSFRPhjMNEmLurkMNMc4lkK2EFYsSlM,4
-iqm_exa_common-26.11.dist-info/RECORD,,
+iqm_exa_common-26.12.dist-info/LICENSE.txt,sha256=R6Q7eUrLyoCQgWYorQ8WJmVmWKYU3dxA3jYUp0wwQAw,11332
+iqm_exa_common-26.12.dist-info/METADATA,sha256=8_09q-TzrJblKp1nodnI_UHMNQrHz0dAC35nzLO_6LU,14626
+iqm_exa_common-26.12.dist-info/WHEEL,sha256=y4mX-SOX4fYIkonsAGA5N0Oy-8_gI4FXw5HNI1xqvWg,91
+iqm_exa_common-26.12.dist-info/top_level.txt,sha256=Clphg2toaZ3_jSFRPhjMNEmLurkMNMc4lkK2EFYsSlM,4
+iqm_exa_common-26.12.dist-info/RECORD,,