lamindb 1.10.1__py3-none-any.whl → 1.11.0__py3-none-any.whl

lamindb/migrations/0118_alter_recordproject_value_projectrecord.py

@@ -0,0 +1,99 @@
+# Generated by Django 5.2 on 2025-08-07 15:28
+
+import django.db.models.deletion
+import django.db.models.functions.datetime
+from django.db import migrations, models
+
+import lamindb.base.fields
+import lamindb.base.users
+import lamindb.models.run
+import lamindb.models.sqlrecord
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("lamindb", "0117_fix_artifact_storage_hash_unique_constraints"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="recordproject",
+            name="value",
+            field=lamindb.base.fields.ForeignKey(
+                blank=True,
+                on_delete=django.db.models.deletion.PROTECT,
+                related_name="links_in_record",
+                to="lamindb.project",
+            ),
+        ),
+        migrations.CreateModel(
+            name="ProjectRecord",
+            fields=[
+                (
+                    "created_at",
+                    lamindb.base.fields.DateTimeField(
+                        blank=True,
+                        db_default=django.db.models.functions.datetime.Now(),
+                        db_index=True,
+                        editable=False,
+                    ),
+                ),
+                ("id", models.BigAutoField(primary_key=True, serialize=False)),
+                (
+                    "created_by",
+                    lamindb.base.fields.ForeignKey(
+                        blank=True,
+                        default=lamindb.base.users.current_user_id,
+                        editable=False,
+                        on_delete=django.db.models.deletion.PROTECT,
+                        related_name="+",
+                        to="lamindb.user",
+                    ),
+                ),
+                (
+                    "feature",
+                    lamindb.base.fields.ForeignKey(
+                        blank=True,
+                        default=None,
+                        null=True,
+                        on_delete=django.db.models.deletion.PROTECT,
+                        related_name="links_projectrecord",
+                        to="lamindb.feature",
+                    ),
+                ),
+                (
+                    "project",
+                    lamindb.base.fields.ForeignKey(
+                        blank=True,
+                        on_delete=django.db.models.deletion.PROTECT,
+                        related_name="links_record",
+                        to="lamindb.project",
+                    ),
+                ),
+                (
+                    "record",
+                    lamindb.base.fields.ForeignKey(
+                        blank=True,
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="links_project",
+                        to="lamindb.record",
+                    ),
+                ),
+                (
+                    "run",
+                    lamindb.base.fields.ForeignKey(
+                        blank=True,
+                        default=lamindb.models.run.current_run,
+                        null=True,
+                        on_delete=django.db.models.deletion.PROTECT,
+                        related_name="+",
+                        to="lamindb.run",
+                    ),
+                ),
+            ],
+            options={
+                "unique_together": {("record", "project", "feature")},
+            },
+            bases=(lamindb.models.sqlrecord.IsLink, models.Model),
+        ),
+    ]

lamindb/migrations/0119_rename_records_project_linked_in_records.py

@@ -0,0 +1,26 @@
+# Generated by Django 5.2 on 2025-08-09 13:31
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("lamindb", "0118_alter_recordproject_value_projectrecord"),
+    ]
+
+    operations = [
+        migrations.RenameField(
+            model_name="project",
+            old_name="records",
+            new_name="linked_in_records",
+        ),
+        migrations.AddField(
+            model_name="project",
+            name="records",
+            field=models.ManyToManyField(
+                related_name="projects",
+                through="lamindb.ProjectRecord",
+                to="lamindb.record",
+            ),
+        ),
+    ]

lamindb/migrations/{0117_squashed.py → 0119_squashed.py}

@@ -1,4 +1,4 @@
-# Generated by Django 5.2 on 2025-07-26 18:58
+# Generated by Django 5.2 on 2025-08-09 13:33
 
 import django.core.validators
 import django.db.models.deletion
@@ -139,6 +139,8 @@ class Migration(migrations.Migration):
         ("lamindb", "0115_alter_space_uid"),
         ("lamindb", "0116_remove_artifact_unique_artifact_storage_key_hash_and_more"),
         ("lamindb", "0117_fix_artifact_storage_hash_unique_constraints"),
+        ("lamindb", "0118_alter_recordproject_value_projectrecord"),
+        ("lamindb", "0119_rename_records_project_linked_in_records"),
     ]
 
     dependencies = []  # type: ignore
@@ -217,9 +219,8 @@ class Migration(migrations.Migration):
                     "uid",
                     lamindb.base.fields.CharField(
                         blank=True,
-                        db_default="aaaaaaaaaaaa",
                         db_index=True,
-                        default="aaaaaaaaaaaaa",
+                        default=lamindb.base.uids.base62_12,
                         editable=False,
                         max_length=12,
                         unique=True,
@@ -1522,6 +1523,60 @@ class Migration(migrations.Migration):
             },
             bases=(lamindb.models.can_curate.CanCurate, models.Model),
         ),
+        migrations.CreateModel(
+            name="ProjectRecord",
+            fields=[
+                (
+                    "created_at",
+                    lamindb.base.fields.DateTimeField(
+                        blank=True,
+                        db_default=django.db.models.functions.datetime.Now(),
+                        db_index=True,
+                        editable=False,
+                    ),
+                ),
+                ("id", models.BigAutoField(primary_key=True, serialize=False)),
+                (
+                    "feature",
+                    lamindb.base.fields.ForeignKey(
+                        blank=True,
+                        default=None,
+                        null=True,
+                        on_delete=django.db.models.deletion.PROTECT,
+                        related_name="links_projectrecord",
+                        to="lamindb.feature",
+                    ),
+                ),
+                (
+                    "project",
+                    lamindb.base.fields.ForeignKey(
+                        blank=True,
+                        on_delete=django.db.models.deletion.PROTECT,
+                        related_name="links_record",
+                        to="lamindb.project",
+                    ),
+                ),
+                (
+                    "record",
+                    lamindb.base.fields.ForeignKey(
+                        blank=True,
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="links_project",
+                        to="lamindb.record",
+                    ),
+                ),
+            ],
+            bases=(lamindb.models.sqlrecord.IsLink, models.Model),
+        ),
+        migrations.AddField(
+            model_name="project",
+            name="records",
+            field=models.ManyToManyField(
+                related_name="projects",
+                through="lamindb.ProjectRecord",
+                to="lamindb.record",
+            ),
+        ),
         migrations.AddField(
             model_name="artifactrecord",
             name="record",
@@ -1651,7 +1706,7 @@ class Migration(migrations.Migration):
                     lamindb.base.fields.ForeignKey(
                         blank=True,
                         on_delete=django.db.models.deletion.PROTECT,
-                        related_name="links_record",
+                        related_name="links_in_record",
                         to="lamindb.project",
                     ),
                 ),
@@ -1663,7 +1718,7 @@ class Migration(migrations.Migration):
         ),
         migrations.AddField(
             model_name="project",
-            name="records",
+            name="linked_in_records",
             field=models.ManyToManyField(
                 related_name="linked_projects",
                 through="lamindb.RecordProject",
@@ -2198,6 +2253,18 @@ class Migration(migrations.Migration):
                 to="lamindb.run",
             ),
         ),
+        migrations.AddField(
+            model_name="projectrecord",
+            name="run",
+            field=lamindb.base.fields.ForeignKey(
+                blank=True,
+                default=lamindb.models.run.current_run,
+                null=True,
+                on_delete=django.db.models.deletion.PROTECT,
+                related_name="+",
+                to="lamindb.run",
+            ),
+        ),
         migrations.AddField(
             model_name="project",
             name="run",
@@ -4174,6 +4241,18 @@ class Migration(migrations.Migration):
                 to="lamindb.user",
             ),
         ),
+        migrations.AddField(
+            model_name="projectrecord",
+            name="created_by",
+            field=lamindb.base.fields.ForeignKey(
+                blank=True,
+                default=lamindb.base.users.current_user_id,
+                editable=False,
+                on_delete=django.db.models.deletion.PROTECT,
+                related_name="+",
+                to="lamindb.user",
+            ),
+        ),
         migrations.AddField(
             model_name="project",
             name="created_by",
@@ -4427,6 +4506,10 @@ class Migration(migrations.Migration):
             name="runfeaturevalue",
             unique_together={("run", "featurevalue")},
         ),
+        migrations.AlterUniqueTogether(
+            name="projectrecord",
+            unique_together={("record", "project", "feature")},
+        ),
         migrations.AlterUniqueTogether(
             name="personproject",
             unique_together={("person", "project")},
@@ -4498,4 +4581,8 @@ class Migration(migrations.Migration):
                 name="unique_artifact_storage_hash_null_key",
             ),
         ),
+        migrations.AlterModelOptions(
+            name="user",
+            options={},
+        ),
     ]

lamindb/migrations/0120_add_record_fk_constraint.py

@@ -0,0 +1,64 @@
+# Generated by Django 5.2 on 2025-08-07 18:52
+
+from django.db import migrations
+
+CREATE_FUNCTION_SQL = """
+CREATE OR REPLACE FUNCTION is_valid_record_type(record_type_id INTEGER, record_is_type BOOLEAN)
+RETURNS BOOLEAN AS $$
+BEGIN
+    -- Record with no type is valid
+    IF record_type_id IS NULL THEN
+        RETURN TRUE;
+    END IF;
+
+    -- If current record is a type, it can only reference schema-less types
+    IF record_is_type THEN
+        RETURN EXISTS (
+            SELECT 1 FROM lamindb_record r
+            WHERE r.id = record_type_id AND r.is_type AND r.schema_id IS NULL
+        );
+    END IF;
+
+    -- Regular records can reference any type
+    RETURN EXISTS (
+        SELECT 1 FROM lamindb_record r
+        WHERE r.id = record_type_id AND r.is_type
+    );
+END;
+$$ LANGUAGE plpgsql;
+"""
+
+ADD_CONSTRAINT_SQL = """
+ALTER TABLE lamindb_record
+ADD CONSTRAINT record_type_is_valid_fk
+CHECK (is_valid_record_type(type_id, is_type));
+"""
+
+DROP_CONSTRAINT_SQL = (
+    "ALTER TABLE lamindb_record DROP CONSTRAINT IF EXISTS record_type_is_valid_fk;"
+)
+DROP_FUNCTION_SQL = "DROP FUNCTION IF EXISTS is_valid_record_type(INTEGER, BOOLEAN);"
+
+
+def apply_postgres_constraint(apps, schema_editor):
+    if schema_editor.connection.vendor == "postgresql":
+        schema_editor.execute(CREATE_FUNCTION_SQL)
+        schema_editor.execute(ADD_CONSTRAINT_SQL)
+
+
+def revert_postgres_constraint(apps, schema_editor):
+    if schema_editor.connection.vendor == "postgresql":
+        schema_editor.execute(DROP_CONSTRAINT_SQL)
+        schema_editor.execute(DROP_FUNCTION_SQL)
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("lamindb", "0119_squashed"),
+    ]
+
+    operations = [
+        migrations.RunPython(
+            apply_postgres_constraint, reverse_code=revert_postgres_constraint
+        ),
+    ]

lamindb/migrations/0121_recorduser.py

@@ -0,0 +1,60 @@
+# Generated by Django 5.2 on 2025-09-05 12:25
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+import lamindb.base.fields
+import lamindb.models.sqlrecord
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("lamindb", "0120_add_record_fk_constraint"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="RecordUser",
+            fields=[
+                ("id", models.BigAutoField(primary_key=True, serialize=False)),
+                (
+                    "feature",
+                    lamindb.base.fields.ForeignKey(
+                        blank=True,
+                        on_delete=django.db.models.deletion.PROTECT,
+                        related_name="links_recorduser",
+                        to="lamindb.feature",
+                    ),
+                ),
+                (
+                    "record",
+                    lamindb.base.fields.ForeignKey(
+                        blank=True,
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="values_user",
+                        to="lamindb.record",
+                    ),
+                ),
+                (
+                    "value",
+                    lamindb.base.fields.ForeignKey(
+                        blank=True,
+                        on_delete=django.db.models.deletion.PROTECT,
+                        related_name="links_record",
+                        to="lamindb.user",
+                    ),
+                ),
+            ],
+            options={
+                "unique_together": {("record", "feature", "value")},
+            },
+            bases=(models.Model, lamindb.models.sqlrecord.IsLink),
+        ),
+        migrations.AddField(
+            model_name="record",
+            name="linked_users",
+            field=models.ManyToManyField(
+                related_name="records", through="lamindb.RecordUser", to="lamindb.user"
+            ),
+        ),
+    ]

lamindb/models/__init__.py

@@ -9,6 +9,7 @@
    BasicQuerySet
    QuerySet
    ArtifactSet
+   LazyArtifact
    QueryManager
    SQLRecordList
    FeatureManager
@@ -49,7 +50,7 @@ from .schema import Schema
 from .ulabel import ULabel
 
 # should come last as it needs everything else
-from .artifact import Artifact
+from .artifact import Artifact, LazyArtifact
 from ._feature_manager import FeatureManager
 from ._label_manager import LabelManager
 from .collection import Collection, CollectionArtifact
@@ -78,6 +79,7 @@ from .project import (
     PersonProject,
     RecordPerson,
     RecordReference,
+    ProjectRecord,
 )
 from .run import RunFeatureValue
 from .schema import (
@@ -94,6 +96,7 @@ from .record import (
     RecordRecord,
     RecordULabel,
     RecordRun,
+    RecordUser,
     RecordArtifact,
     ArtifactRecord,
 )

lamindb/models/_describe.py

@@ -8,8 +8,6 @@ from lamin_utils import logger
 from rich.text import Text
 from rich.tree import Tree
 
-from ..core._context import is_run_from_ipython
-
 if TYPE_CHECKING:
     from lamindb.models import Artifact, Collection, Run
 
@@ -41,6 +39,8 @@ def format_rich_tree(
 ) -> str | None:
     from rich.console import Console
 
+    from ..core._context import is_run_from_ipython
+
     # If tree has no children, return fallback
     if not tree.children:
         return fallback