Namespace Handling

CHANGELOG.md

@@ -1,6 +1,10 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
+## [1.3.6] - 2026-06-22
+### Added
+- Improved namespaced property handling and additional unit testing.
+
 ## [1.3.5] - 2026-06-22
 ### Added
 - Improved document loading, namespaced property handling and additional unit testing.

source/semanticpy/__init__.py

@@ -20,9 +20,6 @@
     __version__ = file.read().strip()
 
 
-logger.debug("%s library (%s) imported from: %s", __name__, __version__, __file__)
-
-
 class Model(Node):
     """SemanticPy Base Model Class"""
 
@@ -580,7 +577,8 @@ def extend(
                 props = cls._validate_properties(props, prop)
 
                 if isinstance(canonical := props.get("canonical"), str):
-                    subclass._canonical[canonical] = prop
+                    if not canonical in subclass._canonical:
+                        subclass._canonical[canonical] = prop
 
                 if isinstance(hidden := props.get("hidden"), bool):
                     if hidden is True:

source/semanticpy/types/node.py

@@ -321,11 +321,14 @@ def _canonicalize(self, name: str) -> str:
         elif not len(name := name.strip()) > 0:
             raise ValueError("The 'name' argument must have a non-empty string value!")
 
-        if name in self._canonical:
-            if name in self._namespace:
-                return self._namespace[name] + ":" + self._canonical[name]
+        if isinstance(canonical := self._canonical.get(name), str):
+            if isinstance(namespace := self._namespace.get(name), str):
+                if not canonical.startswith(namespace + ":"):
+                    return namespace + ":" + canonical
+                else:
+                    return canonical
             else:
-                return self._canonical[name]
+                return canonical
         else:
             return name
 

source/semanticpy/version.txt

@@ -1 +1 @@
-1.3.5
+1.3.6

tests/data/examples/saved-extended.json

@@ -0,0 +1,25 @@
+{
+  "@context": "https://linked.art/ns/v1/linked-art.json",
+  "id": "https://data.example.org/object/123",
+  "type": "HumanMadeObject",
+  "_label": "Example Object 123",
+  "classified_as": [
+    {
+      "id": "http://vocab.getty.edu/aat/300133025",
+      "type": "Type",
+      "_label": "Works of Art"
+    }
+  ],
+  "test:related": [
+    {
+      "id": "https://data.example.org/object/456",
+      "type": "HumanMadeObject",
+      "_label": "Related Object 456"
+    },
+    {
+      "id": "https://data.example.org/object/789",
+      "type": "HumanMadeObject",
+      "_label": "Related Object 789"
+    }
+  ]
+}

tests/test_record_save.py

@@ -5,7 +5,7 @@
 logger = logging.getLogger(__name__)
 
 
-def test_record_load(factory: callable, data: callable, path: callable):
+def test_record_save_not_extended(factory: callable, data: callable, path: callable):
     # Initialise the Model using a named profile; in this case specify the "linked-art"
     # profile which is provided with the library so only needs specifying by its name.
     # Other profiles may be used to create models of other types; see the *Profiles*
@@ -42,3 +42,67 @@ def test_record_load(factory: callable, data: callable, path: callable):
 
     # Ensure that the contents of the saved file match the pre-saved example file
     assert contents == data("examples/saved.json")
+
+
+def test_record_save_with_extended(factory: callable, data: callable, path: callable):
+    # Initialise the Model using a named profile; in this case specify the "linked-art"
+    # profile which is provided with the library so only needs specifying by its name.
+    # Other profiles may be used to create models of other types; see the *Profiles*
+    # section in the README for more information. The factory method dynamically creates
+    # the required model class types and adds them to the object returned from the call:
+    model = factory(profile="linked-art")
+
+    # Extend the model by registering custom schema properties
+    # Register the 'test:related' custom property on the HumanMadeObject entity type
+    Model.extend(
+        model.HumanMadeObject,
+        properties=dict(
+            related=dict(
+                canonical="related",
+                namespace="test",
+                individual=False,
+                range=model.HumanMadeObject,
+                sorting=10000,
+            ),
+        ),
+    )
+
+    # Create a new Model instance
+    artefact = model.HumanMadeObject(
+        ident="https://data.example.org/object/123",
+        label="Example Object 123",
+    )
+
+    # Ensure that the created JSON-LD record is of the type expected
+    assert isinstance(artefact, model.HumanMadeObject)
+    assert isinstance(artefact, Model)
+    assert isinstance(artefact, Node)
+
+    # Add an example property value to the Model instance
+    artefact.classified_as = model.Type(
+        ident="http://vocab.getty.edu/aat/300133025",
+        label="Works of Art",
+    )
+
+    artefact.related = model.HumanMadeObject(
+        ident="https://data.example.org/object/456",
+        label="Related Object 456",
+    )
+
+    artefact.related = model.HumanMadeObject(
+        ident="https://data.example.org/object/789",
+        label="Related Object 789",
+    )
+
+    # Save the Model instance object to storage
+    filepath: str = artefact.save("/tmp/saved-extended.json", indent=2, overwrite=True)
+
+    # Ensure that the call to the .save() method returned the expected file path
+    assert isinstance(filepath, str)
+
+    # Load the contents of the saved file
+    contents: str = data(filepath)
+    assert isinstance(contents, str)
+
+    # Ensure that the contents of the saved file match the pre-saved example file
+    assert contents == data("examples/saved-extended.json")