migrate completely to ruamel.yaml to read and write decimals correctly (#638)

* migrate completely to ruamel.yaml to read and write decimals correctly

* update docs dependencies

* fix deps for docs build

* add ruamel.yaml to readthedocs.yaml

Author: walshmm

.readthedocs.yaml

@@ -21,7 +21,7 @@ build:
       # Install the package in editable mode using pixi
       - $HOME/.pixi/bin/pixi run --environment docs pip install -e .
       # Install docs dependencies in the RTD Python environment too
-      - pip install erdantic versioningit sphinx_rtd_theme sphinxcontrib-mermaid types-pyyaml h5py numpy matplotlib
+      - pip install erdantic versioningit sphinx_rtd_theme sphinxcontrib-mermaid types-pyyaml h5py numpy matplotlib ruamel.yaml
 
 sphinx:
   builder: html

docs/source/conf.py

@@ -101,6 +101,8 @@ def import_mock(name, *args, **kwargs):
         imports = orig_import(name, *args, **kwargs)
     except ImportError:
         # Create a mock module for missing imports with better type handling
+        if "ruamel.yaml" in name:
+            raise ImportError("Module 'ruamel.yaml' is not available")
         imports = mock.MagicMock()
         # Set common attributes to avoid warnings
         imports.__name__ = name