Draft vX modules

src/eko/io/metadata.py

@@ -11,6 +11,7 @@
 
 from .. import version as vmod
 from ..interpolation import XGrid
+from . import v1, v2
 from .dictlike import DictLike
 from .paths import InternalPaths
 from .types import EvolutionPoint as EPoint
@@ -56,19 +57,21 @@ def load(cls, path: os.PathLike):
 
         Returns
         -------
-        bool
+        Metadata
             loaded metadata
         """
         path = pathlib.Path(path)
+        paths = InternalPaths(path)
         # read raw file first to catch version
-        raw = yaml.safe_load(InternalPaths(path).metadata.read_text(encoding="utf-8"))
+        raw = yaml.safe_load(paths.metadata.read_text(encoding="utf-8"))
         version = parse(raw["version"])
+        # patch if necessary
         if version.major == 0 and version.minor == 13:
-            raise NotImplementedError("TODO")
+            raw = v1.update_metadata(paths, raw)
         elif version.major == 0 and version.minor == 14:
-            raise NotImplementedError("TODO")
-        else:
-            content = cls.from_dict(raw)
+            raw = v2.update_metadata(paths, raw)
+        # now we are ready
+        content = cls.from_dict(raw)
         content._path = path
         return content
 

src/eko/io/v1.py

@@ -0,0 +1,25 @@
+"""Legacy interface to files created with v0.13.
+
+Although the data version v1 was already before v0.13 we only support
+that API version.
+"""
+
+from .paths import InternalPaths
+
+
+def update_metadata(paths: InternalPaths, raw: dict) -> dict:
+    """Modify the raw metadata to the new format.
+
+    Parameters
+    ----------
+    paths:
+        base paths to the EKO
+    raw:
+        raw yaml content
+
+    Returns
+    -------
+    dict
+        compatible raw yaml content
+    """
+    return raw

src/eko/io/v2.py

@@ -0,0 +1,26 @@
+"""Legacy interface to files created with v0.14.
+
+Although the data version v2 was never assigned to v0.14 we use it for
+exactly that API version.
+"""
+
+from .paths import InternalPaths
+
+
+def update_metadata(paths: InternalPaths, raw: dict) -> dict:
+    """Modify the raw metadata to the new format.
+
+    Parameters
+    ----------
+    paths:
+        base paths to the EKO
+    raw:
+        raw yaml content
+
+    Returns
+    -------
+    dict
+        compatible raw yaml content
+    """
+    raw["data_version"] = 2
+    return raw

src/eko/version.py

@@ -4,4 +4,4 @@
 """
 
 __version__ = "0.0.0"
-__data_version__ = 1
+__data_version__ = 3