Add docstring to safeget method and an additional test

edpop_explorer/readers/stcn.py

@@ -15,6 +15,9 @@ def _remove_markup(input_str: str) -> str:
 
 
 def safeget(dictionary: Optional[dict], attribute_chain: tuple, first: bool = False):
+    """Safely get a (nested) attribute in a JSON-like structure. If the
+    result is a list and ``first`` is ``True``, return the first item
+    of the list."""
     if len(attribute_chain) == 0:
         raise ValueError("The attribute_chain argument cannot be empty")
     attribute = attribute_chain[0]

tests/readers/test_stcn.py

@@ -38,4 +38,9 @@ def test_safeget_nested_second_attribute_nonexistent():
         "attribute": {
             "other_attribute": "value"
         }
-    }, ("attribute", "attribute2")) is None
+    }, ("attribute", "attribute2")) is None
+
+def test_safeget_first():
+    assert safeget({
+        "attribute": ["value1", "value2"]
+    }, ("attribute",), True) == "value1"