sqlakit 0.22.5__tar.gz → 0.22.7__tar.gz

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

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

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

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

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

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

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

@@ -328,12 +328,15 @@ class Context:
         self.values: dict[str, Any] = dict(values)
         self._bound = 0
 
-    no_order = "(SELECT NULL)"
-    """An `ORDER BY` term that orders by nothing, for a macro with nothing to sort by.
+    @property
+    def no_order(self) -> str:
+        """An `ORDER BY` term that orders by nothing, for a macro with nothing to sort by.
 
-    Every database takes it after `ORDER BY`, and a direction after it: `NULL`
-    and `NULL DESC` are refused by PostgreSQL, and `0` is a column's position.
-    """
+        PostgreSQL and SQL Server refuse a bare `NULL` there, and take
+        `(SELECT NULL)`. Snowflake refuses a subquery there, and takes `NULL`,
+        as MySQL, SQLite and Oracle do. `0` would be a column's position.
+        """
+        return "(SELECT NULL)" if self.dialect in ("postgresql", "mssql") else "NULL"
 
     def __repr__(self) -> str:
         return f"{type(self).__name__}({self.dialect!r})"
@@ -1954,6 +1957,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.
@@ -2064,7 +2077,8 @@ def order_by(ctx: Context, sort: Param, column: Sql, *columns: Sql) -> str:
     the nulls of every term whose sort string does not say, and MySQL, which
     has no `NULLS LAST`, sorts by `IS NULL` first. Any other string is the sort
     when the call passes none, `'name.asc'` above. With neither, the rows come
-    in no order: `(SELECT NULL)`, since PostgreSQL refuses a bare `NULL`.
+    in no order: `NULL`, or `(SELECT NULL)` on PostgreSQL and SQL Server, which
+    refuse a bare `NULL`.
     """
     written = [one.strip() for one in (column, *columns)]
     options = [one.strip("'") for one in written if one.startswith("'")]
@@ -2564,6 +2578,7 @@ BUILTIN_MACROS: Mapping[str, Macro] = {
     for macro in (
         if_set,
         unless_set,
+        if_not_set,
         order_by,
         icontains,
         icollate,