Updated Linked.Art Context

Updated the Linked.Art profile document in preparation for the
migration to the Linked.Art 1.0 specification.

The updates have been made where possible in a backwards compatible
way, so that existing properties that are superseded/removed in 1.0 are
still present in the profile for backwards compatibility for a period
of time while mapping work may be undertaken to migrate from legacy
patterns to fully 1.0 compliant patterns, entities and properties.

Some changes however could not be made in a backwards compatible way,
such as updating the cardinality of properties, or updating properties
to have a more specific domain than they did previously, such as the
domain for `Joining` being changed from the broader `Activity` to the
narrower `Addition`. Changes of this nature could not be made in a
backwards compatible way. Where properties have been renamed, an alias
has been provided for the interim to allow the continued use of the
legacy naming until any mappings and consuming code is updated. Some
changes that necessitated removal of unused properties, such as the
`inScheme`, `topConceptOf` and `hasTopConcept` properties of the `Type`
entity do not have backwards compatible workarounds, and code
referencing these unused properties should be updated.

The full list of changes is documented below:

 * Added the `CRMEntity.notation` property;
 * Added the `Set.members_contained_by` property;
 * Added the `Set.members_exemplified_by` property;
 * Added the `PhysicalThing.contains_members_of` property;
 * Added the `TemporalEntity.after` property;
 * Added the `TemporalEntity.before` property;
 * Added the `SpacetimeVolume.includes` property;
 * Added the new `Transfer` entity type (a subtype of `Activity`) and
updated the superclasses from the broader `Activity` to the more
specific `Transfer` for `Acquisition`, `Move`, `Payment`,
`RightAcquisition` and `TransferOfCustody`;
 * Updated the superclass for `Joining` from the broader `Activity` to
the more specific `Addition`;
 * Updated the superclass for `Leaving` from the broader `Activity` to
the more specific `Removal`;
 * Updated the superclasses for `Group` from `Actor` previously, to
both `Set` and `Actor`;
 * Updated the cardinality for the `RightAcquisition` entity’s
`establishes` property from one to many (`individual: false`), this
will result in the property being serialised to a list of dictionaries
instead of being a reference to a single dictionary, so consuming code
will need to be updated (breaking change);
 * Broadened domain for `PhysicalObject.current_location` from
`PhysicalObject` to `PhysicalThing`;
 * Broadened the domain for `PhysicalObject.current_permanent_location`
from
`PhysicalObject` to `PhysicalThing`, marked the field as being newly
accepted for use (accepted: true), and adjusted the cardinality from
many to one (`individual: true`), resulting in the property being
serialised as a reference to a single dictionary instead of a list of
dictionaries, so consuming code will need to be updated (breaking
change);
 * Updated scope note for `Payment.paid_amount` to remove the
extraneous period;
 * Broadened the domain of
`PhysicalObject.current_permanent_location_of` from
`PhysicalObject` to `PhysicalThing`;
 * Broadened the domain of `Place.currently_holds` from
`PhysicalObject` to `PhysicalThing`;
 * Renamed the `PropositionalObject` entity’s `c_part` property to
`conceptual_part` (with an alias for backwards compatibility to
`c_part`);
 * Renamed the `PropositionalObject` entity’s `c_part_of` property to
`conceptual_part_of` (with an alias for backwards compatibility to
`c_part_of`);
 * Renamed the `ConditionState` entity’s `subState` property to
`sub_state` (with an alias for backwards compatibility to `subState`);
 * Renamed the `ConditionState` entity’s `subState_of` property to
`sub_state_of` (with an aliased for backwards compatibility to
`subState_of`);
 * Renamed the `SpacetimeVolume` entity’s `falls_within` property to
`during` and enabled the property for use (with an alias for backwards
compatibility to `during`);
 * Removed the `Type.inScheme` property (breaking change);
 * Removed the `Type.topConceptOf` property (breaking change);
 * Removed the `Type.hasTopConcept` property (breaking change).

Author: bluebinary

source/semanticpy/__init__.py

@@ -179,6 +179,8 @@ def _class_factory(name: str) -> type:
             #     properties_sorted[key] = properties[key]
             # properties = properties_sorted
 
+            aliases: dict[str, dict[str, object]] = {}
+
             for prop, props in properties.items():
                 # determine if at least one property on the model is marked as accepted
                 if props.get("accepted", True) is True:
@@ -194,6 +196,16 @@ def _class_factory(name: str) -> type:
                     if not prop in hidden:
                         hidden.append(prop)
 
+                # if the property has an alias, map the alias name to the property data
+                if isinstance(alias := props.get("alias"), str):
+                    if alias in aliases:
+                        if not aliases[alias] is props:
+                            raise SemanticPyError(
+                                f"An alias for '{alias}' already exists for the '{name}' entity!"
+                            )
+                    else:
+                        aliases[alias] = props
+
                 sorting[prop] = props.get("sorting") or 10000
 
             if accepted is False:
@@ -205,6 +217,9 @@ def _class_factory(name: str) -> type:
                     ),
                 )
 
+            if len(aliases) > 0:
+                properties.update(aliases)
+
             attributes = {
                 "_context": context,
                 "_type": entity.get("type"),

source/semanticpy/profiles/linked-art.json

@@ -1219,6 +1219,7 @@
                     "sorting": 10000
                 },
                 "sub_state": {
+                    "alias": "subState",
                     "name": "crm:P5_consists_of",
                     "label": "consists of",
                     "inverse": "crm:P5i_forms_part_of",
@@ -1232,6 +1233,7 @@
                     "sorting": 10000
                 },
                 "sub_state_of": {
+                    "alias": "subState_of",
                     "name": "crm:P5i_forms_part_of",
                     "label": "forms part of",
                     "inverse": "crm:P5_consists_of",
@@ -4072,6 +4074,7 @@
                     "sorting": 18
                 },
                 "conceptual_part": {
+                    "alias": "c_part",
                     "name": "crm:P148_has_component",
                     "label": "has component",
                     "inverse": "crm:P148i_is_component_of",
@@ -4085,6 +4088,7 @@
                     "sorting": 10000
                 },
                 "conceptually_part_of": {
+                    "alias": "c_part_of",
                     "name": "crm:P148i_is_component_of",
                     "label": "is component of",
                     "inverse": "crm:P148_has_component",
@@ -4244,7 +4248,7 @@
                     "subclasses": null,
                     "accepted": true,
                     "hidden": false,
-                    "individual": true,
+                    "individual": false,
                     "range": "crm:E30_Right",
                     "domain": "la:RightAcquisition",
                     "scope_note": "The right established by a RightAcquisition",
@@ -4384,6 +4388,7 @@
                     "sorting": 10000
                 },
                 "during": {
+                    "alias": "falls_within",
                     "name": "crm:P10_falls_within",
                     "label": "falls within",
                     "inverse": "crm:P10i_contains",