lamindb 0.76.12__py3-none-any.whl → 0.76.14__py3-none-any.whl

lamindb/__init__.py

@@ -43,7 +43,7 @@ Modules and settings.
 """
 
 # denote a release candidate for 0.1.0 with 0.1rc1, 0.1a1, 0.1b1, etc.
-__version__ = "0.76.12"
+__version__ = "0.76.14"
 
 import os as _os
 

lamindb/_artifact.py

@@ -331,9 +331,10 @@ def get_artifact_kwargs_from_data(
         artifact = stat_or_artifact
         # update the run of the existing artifact
         if run is not None:
-            # save the information that this artifact was previously
-            # produced by another run
-            if artifact.run is not None:
+            # save the information that this artifact was previously produced by
+            # another run
+            # note: same logic exists for _output_collections_with_later_updates
+            if artifact.run is not None and artifact.run != run:
                 artifact.run._output_artifacts_with_later_updates.add(artifact)
             # update the run of the artifact with the latest run
             stat_or_artifact.run = run
@@ -924,7 +925,7 @@ def open(
         filepath.name == "soma" or filepath.suffix == ".tiledbsoma"
     ) and mode == "w"
     # consider the case where an object is already locally cached
-    localpath = setup_settings.instance.storage.cloud_to_local_no_update(
+    localpath = setup_settings.paths.cloud_to_local_no_update(
         filepath, cache_key=cache_key
     )
     if not is_tiledbsoma_w and localpath.exists():
@@ -962,12 +963,12 @@ def _synchronize_cleanup_on_error(
     filepath: UPath, cache_key: str | None = None
 ) -> UPath:
     try:
-        cache_path = setup_settings.instance.storage.cloud_to_local(
+        cache_path = setup_settings.paths.cloud_to_local(
             filepath, cache_key=cache_key, print_progress=True
         )
     except Exception as e:
         if not isinstance(filepath, LocalPathClasses):
-            cache_path = setup_settings.instance.storage.cloud_to_local_no_update(
+            cache_path = setup_settings.paths.cloud_to_local_no_update(
                 filepath, cache_key=cache_key
             )
             if cache_path.is_file():
@@ -1155,9 +1156,7 @@ def _cache_path(self) -> UPath:
     )
     if isinstance(filepath, LocalPathClasses):
         return filepath
-    return setup_settings.instance.storage.cloud_to_local_no_update(
-        filepath, cache_key=cache_key
-    )
+    return setup_settings.paths.cloud_to_local_no_update(filepath, cache_key=cache_key)
 
 
 # docstring handled through attach_func_to_class_method

lamindb/_collection.py

@@ -145,15 +145,16 @@ def __init__(
         logger.warning(
             f"returning existing collection with same hash: {existing_collection}"
         )
-        # update the run of the existing artifact
+        # update the run of the existing collection
         if run is not None:
-            # save the information that this artifact was previously
-            # produced by another run
-            if existing_collection.run is not None:
+            # save the information that this collection was previously produced
+            # by another run
+            # note: same logic exists for _output_artifacts_with_later_updates
+            if existing_collection.run is not None and existing_collection.run != run:
                 existing_collection.run._output_collections_with_later_updates.add(
                     existing_collection
                 )
-            # update the run of the artifact with the latest run
+            # update the run of the collection with the latest run
             existing_collection.run = run
             existing_collection.transform = run.transform
         init_self_from_db(collection, existing_collection)
@@ -186,6 +187,16 @@ def __init__(
     _track_run_input(artifacts, run=run)
 
 
+# docstring handled through attach_func_to_class_method
+def append(self, artifact: Artifact, run: Run | None = None) -> Collection:
+    return Collection(
+        self.artifacts.all().list() + [artifact],
+        description=self.description,
+        revises=self,
+        run=run,
+    )
+
+
 # internal function, not exposed to user
 def from_artifacts(artifacts: Iterable[Artifact]) -> tuple[str, dict[str, str]]:
     # assert all artifacts are already saved
@@ -352,6 +363,7 @@ def restore(self) -> None:
 @doc_args(Collection.ordered_artifacts.__doc__)
 def ordered_artifacts(self) -> QuerySet:
     """{}"""  # noqa: D415
+    # tracking is done via QueryManager (_query_manager.py)
     return self.artifacts.order_by("links_collection__id")
 
 
@@ -364,6 +376,7 @@ def data_artifact(self) -> Artifact | None:
 
 METHOD_NAMES = [
     "__init__",
+    "append",
     "mapped",
     "cache",
     "load",