Implement (single) series deserialization

Author: homeworkprod

CHANGELOG.md

@@ -8,7 +8,7 @@
 
 - Renamed `writing` subpackage to `serialization`.
 
-- Implemented serialization of series.
+- Implemented serialization and deserialization of (single) series.
 
 - Added suffix `_from_toml` to public deserialization functions with string
   input argument.

src/lanpartydb/deserialization.py

@@ -16,7 +16,7 @@
 from .models import Location, Party, PartyLinks, Resource, Series
 
 
-# series
+# series list
 
 
 def deserialize_series_list_from_toml_file(filename: Path) -> list[Series]:
@@ -36,6 +36,26 @@ def _deserialize_series_list_from_dict(data: dict[str, Any]) -> list[Series]:
     return [Series(**item) for item in data.get('series', [])]
 
 
+# series
+
+
+def deserialize_series_from_toml_file(filename: Path) -> Series:
+    """Deserialize series from a TOML file."""
+    toml = filename.read_text()
+    return deserialize_series_from_toml(toml)
+
+
+def deserialize_series_from_toml(toml: str) -> Series:
+    """Deserialize series from a TOML document."""
+    data = _load_toml(toml)
+    return _deserialize_series_from_dict(data)
+
+
+def _deserialize_series_from_dict(data: dict[str, Any]) -> Series:
+    """Build series from a dictionary."""
+    return Series(**data)
+
+
 # party
 
 

tests/deserialization/test_deserialize_series.py

@@ -0,0 +1,57 @@
+"""
+:Copyright: 2024-2025 Jochen Kupperschmidt
+:License: MIT
+"""
+
+import pytest
+
+from lanpartydb.deserialization import deserialize_series_from_toml
+from lanpartydb.models import Series
+
+
+@pytest.mark.parametrize(
+    ('toml', 'expected'),
+    [
+        (
+            """
+            slug = "megalan"
+            name = "MegaLAN"
+            """,
+            Series(
+                slug='megalan',
+                name='MegaLAN',
+                alternative_names=[],
+                country_codes=[],
+            ),
+        ),
+        (
+            """
+            slug = "gammalan"
+            name = "GammaLAN"
+            country_codes = ["ca", "us"]
+            """,
+            Series(
+                slug='gammalan',
+                name='GammaLAN',
+                alternative_names=[],
+                country_codes=['ca', 'us'],
+            ),
+        ),
+        (
+            """
+            slug = "deltalan"
+            name = "DeltaLAN"
+            alternative_names = ["Δ LAN", "Δέλτα LAN"]
+            country_codes = ["au"]
+            """,
+            Series(
+                slug='deltalan',
+                name='DeltaLAN',
+                alternative_names=['Δ LAN', 'Δέλτα LAN'],
+                country_codes=['au'],
+            ),
+        ),
+    ],
+)
+def test_deserialize_series_from_toml(toml: str, expected: Series):
+    assert deserialize_series_from_toml(toml) == expected