🚚 Use label_ref_is_name field in ULabel link tables

lnschema_core/migrations/0056_rename_ulabel_ref_is_name_artifactulabel_label_ref_is_name_and_more.py

@@ -0,0 +1,22 @@
+# Generated by Django 5.1 on 2024-07-09 12:50
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("lnschema_core", "0055_artifact_type_artifactparamvalue_and_more"),
+    ]
+
+    operations = [
+        migrations.RenameField(
+            model_name="artifactulabel",
+            old_name="ulabel_ref_is_name",
+            new_name="label_ref_is_name",
+        ),
+        migrations.RenameField(
+            model_name="collectionulabel",
+            old_name="ulabel_ref_is_name",
+            new_name="label_ref_is_name",
+        ),
+    ]

lnschema_core/models.py

@@ -923,6 +923,8 @@ class User(Registry, CanValidate):
         >>> user
     """
 
+    _name_field: str = "handle"
+
     id: int = models.AutoField(primary_key=True)
     """Internal id, valid only in one DB instance."""
     uid: str = CharField(unique=True, db_index=True, max_length=8, default=None)
@@ -1008,6 +1010,8 @@ class Storage(Registry, TracksRun, TracksUpdates):
     class Meta(Registry.Meta, TracksRun.Meta, TracksUpdates.Meta):
         abstract = False
 
+    _name_field: str = "root"
+
     id: int = models.AutoField(primary_key=True)
     """Internal id, valid only in one DB instance."""
     uid: str = CharField(unique=True, max_length=12, default=base62_12, db_index=True)
@@ -1132,6 +1136,7 @@ class Meta(Registry.Meta, IsVersioned.Meta):
 
     _len_stem_uid: int = 12
     _len_full_uid: int = 16
+    _name_field: str = "name"
 
     id: int = models.AutoField(primary_key=True)
     """Internal id, valid only in one DB instance."""
@@ -1213,6 +1218,8 @@ class Param(Registry, CanValidate, TracksRun, TracksUpdates):
     class Meta(Registry.Meta, TracksRun.Meta, TracksUpdates.Meta):
         abstract = False
 
+    _name_field: str = "name"
+
     name: str = CharField(max_length=100, db_index=True)
     dtype: str = CharField(max_length=64, db_index=True, default=None)
     """Data type ("number", "cat", "int", "float", "bool", "datetime").
@@ -1228,6 +1235,8 @@ class ParamValue(Registry):
     class Meta:
         unique_together = ("param", "value")
 
+    _name_field: str = "value"
+
     param: Param = models.ForeignKey(Param, CASCADE)
     value: Any = models.JSONField()  # stores float, integer, boolean or datetime
     # it'd be confusing and hard to populate a run here because these
@@ -1278,6 +1287,7 @@ class Run(Registry, HasParams):
         >>> ln.core.context.run
     """
 
+    _name_field: str = "started_at"
     params: ParamManager = ParamManagerRun  # type: ignore
 
     id: int = models.BigAutoField(primary_key=True)
@@ -1413,6 +1423,8 @@ class ULabel(Registry, HasParents, CanValidate, TracksRun, TracksUpdates):
     class Meta(Registry.Meta, TracksRun.Meta, TracksUpdates.Meta):
         abstract = False
 
+    _name_field: str = "name"
+
     id: int = models.AutoField(primary_key=True)
     """Internal id, valid only in one DB instance."""
     uid: str = CharField(unique=True, db_index=True, max_length=8, default=base62_8)
@@ -1522,6 +1534,8 @@ class Feature(Registry, CanValidate, TracksRun, TracksUpdates):
     class Meta(Registry.Meta, TracksRun.Meta, TracksUpdates.Meta):
         abstract = False
 
+    _name_field: str = "name"
+
     id: int = models.AutoField(primary_key=True)
     """Internal id, valid only in one DB instance."""
     uid: str = CharField(unique=True, db_index=True, max_length=12, default=base62_12)
@@ -1597,6 +1611,8 @@ class Meta(Registry.Meta, TracksRun.Meta):
         abstract = False
         unique_together = ("feature", "value")
 
+    _name_field: str = "value"
+
     feature: Feature = models.ForeignKey(Feature, CASCADE, null=True, default=None)
     value: Any = models.JSONField()
 
@@ -1673,6 +1689,8 @@ class FeatureSet(Registry, TracksRun):
     class Meta(Registry.Meta, TracksRun.Meta, TracksUpdates.Meta):
         abstract = False
 
+    _name_field: str = "name"
+
     id: int = models.AutoField(primary_key=True)
     """Internal id, valid only in one DB instance."""
     uid: str = CharField(unique=True, db_index=True, max_length=20, default=None)
@@ -1886,6 +1904,7 @@ class Meta(Registry.Meta, IsVersioned.Meta, TracksRun.Meta, TracksUpdates.Meta):
 
     _len_full_uid: int = 20
     _len_stem_uid: int = 16
+    _name_field: str = "description"
     features: FeatureManager = FeatureManagerArtifact  # type: ignore
     params: ParamManager = ParamManagerArtifact  # type: ignore
 
@@ -2371,6 +2390,7 @@ class Meta(Registry.Meta, IsVersioned.Meta, TracksRun.Meta, TracksUpdates.Meta):
 
     _len_full_uid: int = 20
     _len_stem_uid: int = 16
+    _name_field: str = "name"
     features = FeatureManagerCollection  # type: ignore
 
     id: int = models.AutoField(primary_key=True)
@@ -2662,7 +2682,7 @@ class ArtifactULabel(Registry, LinkORM, TracksRun):
     feature = models.ForeignKey(
         Feature, PROTECT, null=True, default=None, related_name="artifactulabel_links"
     )
-    ulabel_ref_is_name: bool = models.BooleanField(null=True, default=None)
+    label_ref_is_name: bool = models.BooleanField(null=True, default=None)
     feature_ref_is_name: bool = models.BooleanField(null=True, default=None)
 
     class Meta:
@@ -2678,7 +2698,7 @@ class CollectionULabel(Registry, LinkORM, TracksRun):
     feature: Feature = models.ForeignKey(
         Feature, PROTECT, null=True, default=None, related_name="collectionulabel_links"
     )
-    ulabel_ref_is_name: bool = models.BooleanField(null=True, default=None)
+    label_ref_is_name: bool = models.BooleanField(null=True, default=None)
     feature_ref_is_name: bool = models.BooleanField(null=True, default=None)
 
     class Meta: