sqlakit 0.22.5__tar.gz → 0.22.6__tar.gz

{sqlakit-0.22.5 → sqlakit-0.22.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlakit
-Version: 0.22.5
+Version: 0.22.6
 Summary: A toolkit for SQLAlchemy applications.
 Keywords: sqlalchemy,database,orm,sql,asyncio
 Author: Anton Ruhlov

{sqlakit-0.22.5 → sqlakit-0.22.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sqlakit"
-version = "0.22.5"
+version = "0.22.6"
 description = "A toolkit for SQLAlchemy applications."
 readme = "README.md"
 license = "MIT"

{sqlakit-0.22.5 → sqlakit-0.22.6}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "sqlakit"
-version = "0.22.5"
+version = "0.22.6"
 description = "A toolkit for SQLAlchemy applications."
 readme = "README.md"
 license = "MIT"

{sqlakit-0.22.5 → sqlakit-0.22.6}/sqlakit/_sql.py

@@ -1954,6 +1954,16 @@ def unless_set(value: Param, expr: Sql, otherwise: Sql = Sql("TRUE")) -> str:  #
     return _grouped(str(otherwise if _is_set(value.value) else expr))
 
 
+@sql_macro(optional=True, lazy=True)
+def if_not_set(value: Param, expr: Sql, otherwise: Sql = Sql("TRUE")) -> str:  # noqa: B008
+    """`expr` when the parameter holds no value: another name for `unless_set`.
+
+    It reads as the other way round from `if_set`:
+    `AND tpl.if_not_set(:status, status <> 'archived')`.
+    """
+    return _grouped(str(otherwise if _is_set(value.value) else expr))
+
+
 @sql_macro(optional=True)
 def array(ctx: Context, values: Param, type_name: Sql = Sql("")) -> str:  # noqa: B008
     """Write a list as an array, one parameter per value.
@@ -2564,6 +2574,7 @@ BUILTIN_MACROS: Mapping[str, Macro] = {
     for macro in (
         if_set,
         unless_set,
+        if_not_set,
         order_by,
         icontains,
         icollate,