Function to get the object on which the input sculpture is based

Author: emptybutton

Diff for: sculpting/core.py

@@ -12,6 +12,7 @@
 
 __all__ = (
     "Sculpture",
+    "material_of",
     "AttributeMap",
     "attribute_map_for",
     "read_only_attribute_map_as",
@@ -252,4 +253,11 @@ def _attribute_value_for(self, attribute_name: str, attribute_map: AttributeMap[
         return attribute_map.getter(self.__original)
 
     def _set_attribute_value_for(self, attribute_name: str, attribute_value: Any, attribute_map: AttributeMap[OriginalT]) -> Any:
-        return attribute_map.setter(self.__original, attribute_value)
+        return attribute_map.setter(self.__original, attribute_value)
+
+
+material_of: Callable[[Sculpture[OriginalT]], OriginalT] = documenting_by(
+    """Function to get the object on which the input sculpture is based."""
+)(
+    getattr |by| "_Sculpture__original"
+)

Diff for: tests.py

@@ -169,4 +169,9 @@ def test_sculpture_attribute_mapping(
 
     setattr(sculpture, virtual_attribute_name, new_attribute_value)
 
-    assert getattr(sculpture, virtual_attribute_name) == getattr(mapped, original_attribute_name)
+    assert getattr(sculpture, virtual_attribute_name) == getattr(mapped, original_attribute_name)
+
+
+@mark.parametrize("obj", [(AttributeKeeper(value=42), 42, None)])
+def test_original_from(obj: object):
+    assert material_of(Sculpture(obj)) is obj