velocity-python 0.0.151__tar.gz → 0.0.153__tar.gz

{velocity_python-0.0.151 → velocity_python-0.0.153}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: velocity-python
-Version: 0.0.151
+Version: 0.0.153
 Summary: A rapid application development library for interfacing with data storage
 Author-email: Velocity Team <info@codeclubs.org>
 License-Expression: MIT

{velocity_python-0.0.151 → velocity_python-0.0.153}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "velocity-python"
-version = "0.0.151"
+version = "0.0.153"
 authors = [
   { name="Velocity Team", email="info@codeclubs.org" },
 ]

{velocity_python-0.0.151 → velocity_python-0.0.153}/src/velocity/__init__.py

@@ -1,4 +1,4 @@
-__version__ = version = "0.0.151"
+__version__ = version = "0.0.153"
 
 from . import aws
 from . import db

{velocity_python-0.0.151 → velocity_python-0.0.153}/src/velocity/db/core/table.py

@@ -347,10 +347,10 @@ class Table:
         return Row(self, result[0]["sys_id"], lock=lock)
 
     @return_default(None)
-    def find(self, where, lock=None, use_where=False):
+    def find(self, where, lock=None, use_where=False, raise_if_missing=False):
         """
-        Finds a single row matching `where`, or returns None if none found.
-        Raises DuplicateRowsFoundError if multiple rows match.
+        Finds a single row matching `where`, or returns None if none found unless
+        ``raise_if_missing`` is True. Raises DuplicateRowsFoundError if multiple rows match.
         """
         if where is None:
             raise Exception("None is not allowed as a primary key.")
@@ -358,6 +358,10 @@ class Table:
             where = {"sys_id": where}
         result = self.select("sys_id", where=where, lock=lock).all()
         if not result:
+            if raise_if_missing:
+                raise LookupError(
+                    f"No rows found in `{self.name}` for criteria: {where!r}"
+                )
             return None
         if len(result) > 1:
             sql = self.select("sys_id", sql_only=True, where=where, lock=lock)

{velocity_python-0.0.151 → velocity_python-0.0.153}/src/velocity/db/core/transaction.py

@@ -164,17 +164,25 @@ class Transaction:
         """
         return Row(self.table(tablename), pk, lock=lock)
 
-    def get(self, tablename, where, lock=None):
-        """
-        Shortcut to table.get().
-        """
-        return self.table(tablename).get(where, lock=lock)
-
-    def find(self, tablename, where, lock=None):
-        """
-        Shortcut to table.find().
-        """
-        return self.table(tablename).find(where, lock=lock)
+    def get(self, tablename, where, lock=None, use_where=False):
+        """Shortcut to table.get() with optional ``use_where`` passthrough."""
+        return self.table(tablename).get(where, lock=lock, use_where=use_where)
+
+    def find(
+        self,
+        tablename,
+        where,
+        lock=None,
+        use_where=False,
+        raise_if_missing=False,
+    ):
+        """Shortcut to table.find() with ``use_where``/``raise_if_missing`` passthrough."""
+        return self.table(tablename).find(
+            where,
+            lock=lock,
+            use_where=use_where,
+            raise_if_missing=raise_if_missing,
+        )
 
     def column(self, tablename, colname):
         """

{velocity_python-0.0.151 → velocity_python-0.0.153}/src/velocity_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: velocity-python
-Version: 0.0.151
+Version: 0.0.153
 Summary: A rapid application development library for interfacing with data storage
 Author-email: Velocity Team <info@codeclubs.org>
 License-Expression: MIT