lamindb 0.76.11__tar.gz → 0.76.12__tar.gz

{lamindb-0.76.11 → lamindb-0.76.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lamindb
-Version: 0.76.11
+Version: 0.76.12
 Summary: A data framework for biology.
 Author-email: Lamin Labs <open-source@lamin.ai>
 Requires-Python: >=3.9
@@ -8,10 +8,10 @@ Description-Content-Type: text/markdown
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
-Requires-Dist: lnschema_core==0.74.6
-Requires-Dist: lamindb_setup==0.77.7
+Requires-Dist: lnschema_core==0.75.0
 Requires-Dist: lamin_utils==0.13.6
-Requires-Dist: lamin_cli==0.17.8
+Requires-Dist: lamin_cli==0.18.0
+Requires-Dist: lamindb_setup
 Requires-Dist: rapidfuzz
 Requires-Dist: pyarrow
 Requires-Dist: typing_extensions!=4.6.0
@@ -23,7 +23,7 @@ Requires-Dist: pandas
 Requires-Dist: graphviz
 Requires-Dist: psycopg2-binary
 Requires-Dist: lamindb_setup[aws] ; extra == "aws"
-Requires-Dist: bionty==0.51.1 ; extra == "bionty"
+Requires-Dist: bionty==0.51.2 ; extra == "bionty"
 Requires-Dist: line_profiler ; extra == "dev"
 Requires-Dist: pre-commit ; extra == "dev"
 Requires-Dist: nox ; extra == "dev"

{lamindb-0.76.11 → lamindb-0.76.12}/docs/scripts/run-track-with-params.py

@@ -10,8 +10,11 @@ if __name__ == "__main__":
     params = {
         "input_dir": args.input_dir,
         "learning_rate": args.learning_rate,
-        "downsample": args.downsample,
+        "preprocess_params": {
+            "downsample": args.downsample,
+            "normalization": "the_good_one",
+        },
     }
-    ln.track("JjRF4mACd9m00000", params=params)
+    ln.track("JjRF4mACd9m00001", params=params)
     # your code
     ln.finish()

{lamindb-0.76.11 → lamindb-0.76.12}/docs/setup.ipynb

@@ -254,25 +254,39 @@
    "source": [
     "`lamindb` mantains cache for cloud instances, i.e. instances having storage set to an AWS S3 bucket.\n",
     "\n",
-    "Cache directory can be accessed via {class}`lamindb.settings`.\n",
-    "\n",
-    "```\n",
-    "ln.settings.storage.cache_dir\n",
-    "```\n",
-    "\n",
-    "or print the cache directory path with CLI\n",
-    "\n",
-    "```\n",
-    "lamin cache get\n",
-    "```\n",
-    "\n",
-    "It can be configured using the settings\n",
-    "\n",
-    "```\n",
-    "ln.settings.storage.cache_dir = \"some/path/to/cache\"\n",
-    "```\n",
-    "\n",
-    "or using CLI\n",
+    "Cache directory can be accessed via {class}`lamindb.settings`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "ln.settings.cache_dir"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "or print the cache directory path with CLI"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!lamin cache get"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "It can be also configured via \n",
     "\n",
     "```\n",
     "lamin cache set some/path/to/cache\n",

{lamindb-0.76.11 → lamindb-0.76.12}/docs/storage/prepare-transfer-local-to-cloud.ipynb

@@ -34,7 +34,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "ln.setup.init(storage=\"./test-transfer-to-cloud\", schema=\"bionty,wetlab\")\n",
+    "ln.setup.init(storage=\"./test-transfer-to-cloud\", schema=\"bionty,wetlab,findrefs\")\n",
     "ln.setup.settings.auto_connect = False"
    ]
   },

{lamindb-0.76.11 → lamindb-0.76.12}/docs/storage/vitessce.ipynb

@@ -82,7 +82,7 @@
     "vc = VitessceConfig(schema_version=\"1.0.15\")\n",
     "vc.add_dataset(name=\"test1\").add_object(\n",
     "    AnnDataWrapper(\n",
-    "        adata_url=dataset_artifact.path.to_url(),\n",
+    "        adata_artifact=dataset_artifact,\n",
     "        obs_embedding_paths=[\"obsm/X_umap\"],\n",
     "    ),\n",
     ")\n",
@@ -134,39 +134,17 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "# use a corrupted suffix\n",
+    "# pass an artifact URL instead of the artifact object itself\n",
     "vc = VitessceConfig(schema_version=\"1.0.15\")\n",
-    "vc.add_dataset(name=\"test1\").add_object(\n",
-    "    AnnDataWrapper(\n",
-    "        adata_url=dataset_artifact.path.to_url() + \".random\",\n",
-    "        obs_embedding_paths=[\"obsm/X_umap\"],\n",
-    "    ),\n",
-    ")\n",
-    "with pytest.raises(ValueError) as error:\n",
-    "    ln.integrations.save_vitessce_config(vc)\n",
-    "print(error.exconly())\n",
-    "assert error.exconly().startswith(\"ValueError: Suffix should be '.zarr' or one of\")\n",
-    "assert error.exconly().endswith(\".random\")\n"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "# use a corrupted stem_uid\n",
-    "vc = VitessceConfig(schema_version=\"1.0.15\")\n",
-    "vc.add_dataset(name=\"test1\").add_object(\n",
-    "    AnnDataWrapper(\n",
-    "        adata_url=dataset_artifact.path.to_url().replace(dataset_artifact.stem_uid, \"not-a-valid-uid\"),\n",
-    "        obs_embedding_paths=[\"obsm/X_umap\"],\n",
-    "    ),\n",
-    ")\n",
-    "with pytest.raises(ValueError) as error:\n",
-    "    ln.integrations.save_vitessce_config(vc)\n",
+    "with pytest.raises(AttributeError) as error:\n",
+    "    vc.add_dataset(name=\"test1\").add_object(\n",
+    "        AnnDataWrapper(\n",
+    "            adata_artifact=dataset_artifact.path.to_url(),\n",
+    "            obs_embedding_paths=[\"obsm/X_umap\"],\n",
+    "        ),\n",
+    "    )\n",
     "print(error.exconly())\n",
-    "assert error.exconly().startswith(\"ValueError: Could not find dataset with stem uid 'not-a-valid-uid' in lamindb\")"
+    "assert error.exconly().startswith(\"AttributeError: 'str' object has no attribute 'path'\")\n"
    ]
   },
   {

{lamindb-0.76.11 → lamindb-0.76.12}/docs/track.ipynb

@@ -141,6 +141,8 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
+    "(track-run-parameters)=\n",
+    "\n",
     "## Track run parameters"
    ]
   },
@@ -165,7 +167,7 @@
     "\n",
     "ln.Param(name=\"input_dir\", dtype=\"str\").save()\n",
     "ln.Param(name=\"learning_rate\", dtype=\"float\").save()\n",
-    "ln.Param(name=\"downsample\", dtype=\"bool\").save()"
+    "ln.Param(name=\"preprocess_params\", dtype=\"dict\").save()"
    ]
   },
   {
@@ -223,14 +225,24 @@
    },
    "outputs": [],
    "source": [
-    "ln.Run.params.filter(learning_rate=0.01, input_dir=\"./mydataset\").df()"
+    "ln.Run.params.filter(learning_rate=0.01, input_dir=\"./mydataset\", preprocess_params__downsample=True).df()"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Look at the parameter values that were used for a given run."
+    "Note that:\n",
+    "\n",
+    "* `preprocess_params__downsample=True` traverses the dictionary `preprocess_params` to find the key `\"downsample\"` and match it to `True`\n",
+    "* nested keys like `\"downsample\"` in a dictionary do not appear in `Param` and hence, do not get validated"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Below is how you get the parameter values that were used for a given run."
    ]
   },
   {
@@ -247,6 +259,35 @@
     "run.params.get_values()"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Or [on the hub](https://lamin.ai/laminlabs/lamindata/transform/JjRF4mACd9m00001).\n",
+    "\n",
+    "<img width=\"500\" alt=\"image\" src=\"https://github.com/user-attachments/assets/d8a5df37-d585-4940-b6f0-91f99b6c436c\">"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "If you want to query all parameter values across all runs, use {class}`~lamindb.core.ParamValue`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "tags": [
+     "hide-output"
+    ]
+   },
+   "outputs": [],
+   "source": [
+    "ln.core.ParamValue.df(include=[\"param__name\", \"created_by__handle\"])"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},
@@ -297,7 +338,7 @@
    },
    "outputs": [],
    "source": [
-    "assert run.params.get_values() == {'downsample': True, 'input_dir': './mydataset', 'learning_rate': 0.01}\n",
+    "assert run.params.get_values() == {'input_dir': './mydataset', 'learning_rate': 0.01, 'preprocess_params': {'downsample': True, 'normalization': 'the_good_one'}}\n",
     "\n",
     "# clean up test instance\n",
     "!rm -r ./test-track\n",

{lamindb-0.76.11 → lamindb-0.76.12}/docs/tutorial.ipynb

@@ -197,7 +197,8 @@
    },
    "outputs": [],
    "source": [
-    "ln.UPath(\"s3://lamindata/iris_studies\").view_tree()"
+    "# we use anon=True here in case no aws credentials are configured\n",
+    "ln.UPath(\"s3://lamindata/iris_studies\", anon=True).view_tree()"
    ]
   },
   {
@@ -947,7 +948,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.10.13"
+   "version": "3.9.17"
   },
   "vscode": {
    "interpreter": {

{lamindb-0.76.11 → lamindb-0.76.12}/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.11"
+__version__ = "0.76.12"
 
 import os as _os
 

{lamindb-0.76.11 → lamindb-0.76.12}/lamindb/_artifact.py

@@ -10,7 +10,7 @@ import fsspec
 import lamindb_setup as ln_setup
 import pandas as pd
 from anndata import AnnData
-from django.db.models import Q, QuerySet
+from django.db.models import Q
 from lamin_utils import colors, logger
 from lamindb_setup import settings as setup_settings
 from lamindb_setup._init_instance import register_storage_in_instance
@@ -180,7 +180,7 @@ def process_data(
                 f" be '{suffix}'."
             )
         cache_name = f"{provisional_uid}{suffix}"
-        path = settings.storage.cache_dir / cache_name
+        path = settings.cache_dir / cache_name
         # Alex: I don't understand the line below
         if path.suffixes == []:
             path = path.with_suffix(suffix)
@@ -344,7 +344,7 @@ def get_artifact_kwargs_from_data(
 
     if revises is not None:  # update provisional_uid
         provisional_uid, revises = create_uid(revises=revises, version=version)
-        if settings.storage.cache_dir in path.parents:
+        if settings.cache_dir in path.parents:
             path = path.rename(path.with_name(f"{provisional_uid}{suffix}"))
 
     check_path_in_storage = False
@@ -749,10 +749,6 @@ def from_dir(
     run: Run | None = None,
 ) -> list[Artifact]:
     """{}"""  # noqa: D415
-    logger.warning(
-        "this creates one artifact per file in the directory - consider"
-        " ln.Artifact(dir_path) to get one artifact for the entire directory"
-    )
     folderpath: UPath = create_path(path)  # returns Path for local
     default_storage = settings.storage.record
     using_key = settings._using_key
@@ -1125,7 +1121,7 @@ def save(self, upload: bool | None = None, **kwargs) -> Artifact:
         raise RuntimeError(exception)
     if local_path is not None and not state_was_adding:
         # only move the local artifact to cache if it was not newly created
-        local_path_cache = ln_setup.settings.storage.cache_dir / local_path.name
+        local_path_cache = ln_setup.settings.cache_dir / local_path.name
         # don't use Path.rename here because of cross-device link error
         # https://laminlabs.slack.com/archives/C04A0RMA0SC/p1710259102686969
         shutil.move(

{lamindb-0.76.11 → lamindb-0.76.12}/lamindb/_filter.py

@@ -2,8 +2,6 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING
 
-from lnschema_core import Artifact, Collection
-
 from ._query_set import QuerySet, process_expressions
 
 if TYPE_CHECKING:

{lamindb-0.76.11 → lamindb-0.76.12}/lamindb/_finish.py

@@ -130,12 +130,12 @@ def save_context_core(
                 if response != "y":
                     return "aborted-non-consecutive"
         # write the report
-        report_path = ln_setup.settings.storage.cache_dir / filepath.name.replace(
+        report_path = ln_setup.settings.cache_dir / filepath.name.replace(
             ".ipynb", ".html"
         )
         notebook_to_report(filepath, report_path)
         # write the source code
-        source_code_path = ln_setup.settings.storage.cache_dir / filepath.name.replace(
+        source_code_path = ln_setup.settings.cache_dir / filepath.name.replace(
             ".ipynb", ".py"
         )
         notebook_to_script(transform, filepath, source_code_path)
@@ -171,7 +171,7 @@ def save_context_core(
         transform.hash = hash
 
     # track environment
-    env_path = ln_setup.settings.storage.cache_dir / f"run_env_pip_{run.uid}.txt"
+    env_path = ln_setup.settings.cache_dir / f"run_env_pip_{run.uid}.txt"
     if env_path.exists():
         overwrite_env = True
         if run.environment_id is not None and from_cli:

{lamindb-0.76.11 → lamindb-0.76.12}/lamindb/_query_set.py

@@ -139,7 +139,7 @@ class QuerySet(models.QuerySet):
 
     See Also:
 
-        `django QuerySet <https://docs.djangoproject.com/en/4.2/ref/models/querysets/>`__ # noqa
+        `django QuerySet <https://docs.djangoproject.com/en/4.2/ref/models/querysets/>`__
 
     Examples:
 
@@ -154,7 +154,7 @@ class QuerySet(models.QuerySet):
     ) -> pd.DataFrame:
         """{}"""  # noqa: D415
         # re-order the columns
-        exclude_field_names = ["created_at"]
+        exclude_field_names = ["updated_at"]
         field_names = [
             field.name
             for field in self.model._meta.fields

{lamindb-0.76.11 → lamindb-0.76.12}/lamindb/_record.py

@@ -15,7 +15,7 @@ from lamindb_setup._connect_instance import (
     update_db_using_local,
 )
 from lamindb_setup.core._docs import doc_args
-from lamindb_setup.core._hub_core import connect_instance
+from lamindb_setup.core._hub_core import connect_instance_hub
 from lamindb_setup.core._settings_store import instance_settings_file
 from lnschema_core.models import IsVersioned, Record, Run, Transform
 
@@ -380,11 +380,9 @@ def using(
         return QuerySet(model=cls, using=None)
     owner, name = get_owner_name_from_identifier(instance)
     settings_file = instance_settings_file(name, owner)
-    cache_filepath = (
-        ln_setup.settings.storage.cache_dir / f"instance--{owner}--{name}--uid.txt"
-    )
+    cache_filepath = ln_setup.settings.cache_dir / f"instance--{owner}--{name}--uid.txt"
     if not settings_file.exists():
-        result = connect_instance(owner=owner, name=name)
+        result = connect_instance_hub(owner=owner, name=name)
         if isinstance(result, str):
             raise RuntimeError(
                 f"Failed to load instance {instance}, please check your permissions!"
@@ -469,9 +467,7 @@ def get_transfer_run(record) -> Run:
 
     slug = record._state.db
     owner, name = get_owner_name_from_identifier(slug)
-    cache_filepath = (
-        ln_setup.settings.storage.cache_dir / f"instance--{owner}--{name}--uid.txt"
-    )
+    cache_filepath = ln_setup.settings.cache_dir / f"instance--{owner}--{name}--uid.txt"
     if not cache_filepath.exists():
         raise SystemExit("Need to call .using() before")
     instance_uid = cache_filepath.read_text()

{lamindb-0.76.11 → lamindb-0.76.12}/lamindb/_save.py

@@ -168,7 +168,7 @@ def copy_or_move_to_cache(
 
     local_path = local_path.resolve()
     is_dir = local_path.is_dir()
-    cache_dir = settings._storage_settings.cache_dir
+    cache_dir = settings.cache_dir
 
     # just delete from the cache dir if storage_path is local
     if cache_path is None:

{lamindb-0.76.11 → lamindb-0.76.12}/lamindb/core/_context.py

@@ -562,26 +562,32 @@ class Context:
 
             return "CMD + s" if platform.system() == "Darwin" else "CTRL + s"
 
-        if context.run is None:
+        if self.run is None:
             raise TrackNotCalled("Please run `ln.track()` before `ln.finish()`")
-        if context._path is None:
-            if context.run.transform.type in {"script", "notebook"}:
+        if self._path is None:
+            if self.run.transform.type in {"script", "notebook"}:
                 raise ValueError(
-                    f"Transform type is not allowed to be 'script' or 'notebook' but is {context.run.transform.type}."
+                    "Transform type is not allowed to be 'script' or 'notebook' because `context._path` is `None`."
                 )
-            context.run.finished_at = datetime.now(timezone.utc)
-            context.run.save()
+            self.run.finished_at = datetime.now(timezone.utc)
+            self.run.save()
             # nothing else to do
             return None
         if is_run_from_ipython:  # notebooks
-            if get_seconds_since_modified(context._path) > 2 and not ln_setup._TESTING:
+            import nbproject
+
+            # it might be that the user modifies the title just before ln.finish()
+            if (nbproject_title := nbproject.meta.live.title) != self.transform.name:
+                self.transform.name = nbproject_title
+                self.transform.save()
+            if get_seconds_since_modified(self._path) > 2 and not ln_setup._TESTING:
                 raise NotebookNotSaved(
                     f"Please save the notebook in your editor (shortcut `{get_shortcut()}`) right before calling `ln.finish()`"
                 )
         save_context_core(
-            run=context.run,
-            transform=context.run.transform,
-            filepath=context._path,
+            run=self.run,
+            transform=self.run.transform,
+            filepath=self._path,
             finished_at=True,
             ignore_non_consecutive=ignore_non_consecutive,
         )

{lamindb-0.76.11 → lamindb-0.76.12}/lamindb/core/_feature_manager.py

@@ -40,7 +40,7 @@ from lamindb._record import (
     transfer_to_default_db,
 )
 from lamindb._save import save
-from lamindb.core.exceptions import ValidationError
+from lamindb.core.exceptions import DoesNotExist, ValidationError
 from lamindb.core.storage import LocalPathClasses
 
 from ._django import get_artifact_with_related
@@ -509,18 +509,49 @@ def filter_base(cls, **expression):
             expression = {feature_param: feature, f"value{comparator}": value}
             feature_value = value_model.filter(**expression)
             new_expression[f"_{feature_param}_values__in"] = feature_value
-        else:
+        elif isinstance(value, (str, Record)):
+            # because SQL is sensitive to whether querying with __in or not
+            # and might return multiple equivalent records for the latter
+            # we distinguish cases in which we have multiple label matches vs. one
+            label = None
+            labels = None
             if isinstance(value, str):
+                # we need the comparator here because users might query like so
+                # ln.Artifact.features.filter(experiment__contains="Experi")
                 expression = {f"name{comparator}": value}
-                label = ULabel.get(**expression)
-                new_expression["ulabels"] = label
+                labels = ULabel.filter(**expression).all()
+                if len(labels) == 0:
+                    raise DoesNotExist(
+                        f"Did not find a ULabel matching `name{comparator}={value}`"
+                    )
+                elif len(labels) == 1:
+                    label = labels[0]
+            elif isinstance(value, Record):
+                label = value
+            label_registry = (
+                label.__class__ if label is not None else labels[0].__class__
+            )
+            accessor_name = (
+                label_registry.artifacts.through.artifact.field._related_name
+            )
+            new_expression[f"{accessor_name}__feature"] = feature
+            if label is not None:
+                # simplified query if we have exactly one label
+                new_expression[
+                    f"{accessor_name}__{label_registry.__name__.lower()}"
+                ] = label
             else:
-                raise NotImplementedError
+                new_expression[
+                    f"{accessor_name}__{label_registry.__name__.lower()}__in"
+                ] = labels
+        else:
+            # if passing a list of records, we want to
+            # find artifacts that are annotated by all of them at the same
+            # time; hence, we don't want the __in construct that we use to match strings
+            # https://laminlabs.slack.com/archives/C04FPE8V01W/p1688328084810609
+            raise NotImplementedError
     if cls == FeatureManager or cls == ParamManagerArtifact:
         return Artifact.filter(**new_expression)
-    # might renable something similar in the future
-    # elif cls == FeatureManagerCollection:
-    #     return Collection.filter(**new_expression)
     elif cls == ParamManagerRun:
         return Run.filter(**new_expression)
 

{lamindb-0.76.11 → lamindb-0.76.12}/lamindb/core/_settings.py

@@ -143,6 +143,11 @@ class Settings:
             path, kwargs = path_kwargs, {}
         set_managed_storage(path, **kwargs)
 
+    @property
+    def cache_dir(self) -> UPath:
+        """Cache root, a local directory to cache cloud files."""
+        return ln_setup.settings.cache_dir
+
     @property
     def storage_local(self) -> StorageSettings:
         """An additional local default storage (a path to its root).

{lamindb-0.76.11 → lamindb-0.76.12}/lamindb/core/_sync_git.py

@@ -16,7 +16,7 @@ class BlobHashNotFound(SystemExit):
 
 def get_git_repo_from_remote() -> Path:
     repo_url = settings.sync_git_repo
-    repo_dir = setup_settings.storage.cache_dir / repo_url.split("/")[-1]
+    repo_dir = setup_settings.cache_dir / repo_url.split("/")[-1]
     if repo_dir.exists():
         logger.warning(f"git repo {repo_dir} already exists locally")
         return repo_dir
@@ -26,7 +26,7 @@ def get_git_repo_from_remote() -> Path:
     result = subprocess.run(
         ["git", "clone", "--depth", "10", f"{repo_url}.git"],
         capture_output=True,
-        cwd=setup_settings.storage.cache_dir,
+        cwd=setup_settings.cache_dir,
     )
     if result.returncode != 0 or not repo_dir.exists():
         raise RuntimeError(result.stderr.decode())

{lamindb-0.76.11 → lamindb-0.76.12}/lamindb/core/_track_environment.py

@@ -11,7 +11,7 @@ if TYPE_CHECKING:
 
 
 def track_environment(run: Run) -> None:
-    filepath = ln_setup.settings.storage.cache_dir / f"run_env_pip_{run.uid}.txt"
+    filepath = ln_setup.settings.cache_dir / f"run_env_pip_{run.uid}.txt"
     # create a requirements.txt
     # we don't create a conda environment.yml mostly for its slowness
     try:

{lamindb-0.76.11 → lamindb-0.76.12}/lamindb/core/exceptions.py

@@ -45,7 +45,7 @@ class ValidationError(SystemExit):
 
 # inspired by Django's DoesNotExist
 # equivalent to SQLAlchemy's NoResultFound
-class DoesNotExist(Exception):
+class DoesNotExist(SystemExit):
     """No record found."""
 
     pass