interloper-sql 0.113.0__tar.gz → 0.116.0__tar.gz

{interloper_sql-0.113.0 → interloper_sql-0.116.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: interloper-sql
-Version: 0.113.0
+Version: 0.116.0
 Summary: Interloper SQL integration: portable views over SQL warehouses, and a SQLAlchemy-backed destination for PostgreSQL and other SQL databases
 Author: Guillaume Onfroy
 Author-email: Guillaume Onfroy <guillaume@digitlcloud.com>

{interloper_sql-0.113.0 → interloper_sql-0.116.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "interloper-sql"
-version = "0.113.0"
+version = "0.116.0"
 description = "Interloper SQL integration: portable views over SQL warehouses, and a SQLAlchemy-backed destination for PostgreSQL and other SQL databases"
 readme = "README.md"
 requires-python = ">=3.10"

{interloper_sql-0.113.0 → interloper_sql-0.116.0}/pyproject.toml.orig

@@ -3,7 +3,7 @@
 # ###############
 [project]
 name = "interloper-sql"
-version = "0.113.0"
+version = "0.116.0"
 description = "Interloper SQL integration: portable views over SQL warehouses, and a SQLAlchemy-backed destination for PostgreSQL and other SQL databases"
 readme = "README.md"
 authors = [{ name = "Guillaume Onfroy", email = "guillaume@digitlcloud.com" }]

{interloper_sql-0.113.0 → interloper_sql-0.116.0}/src/interloper_sql/__init__.py

@@ -1,6 +1,6 @@
 """Interloper SQL integration: portable views, and a SQLAlchemy-backed destination behind the postgres extra."""
 
-from interloper_sql.view import IbisView, ibis_view, union
+from interloper_sql.view import IbisView, ibis_view, latest, union
 
 try:
     from interloper_sql.connection import SQLConnection
@@ -12,6 +12,7 @@ except ModuleNotFoundError as error:
     __all__ = [
         "IbisView",
         "ibis_view",
+        "latest",
         "union",
     ]
 else:
@@ -20,5 +21,6 @@ else:
         "SQLConnection",
         "SQLDestination",
         "ibis_view",
+        "latest",
         "union",
     ]

{interloper_sql-0.113.0 → interloper_sql-0.116.0}/src/interloper_sql/view/__init__.py

@@ -1,7 +1,7 @@
 """Portable views: Ibis expressions over typed upstream tables, compiled per warehouse dialect."""
 
-from interloper_sql.view.base import IbisDefinition, IbisView, union
+from interloper_sql.view.base import IbisDefinition, IbisView, latest, union
 from interloper_sql.view.decorator import ibis_view
 from interloper_sql.view.types import IBIS_DIALECTS, ibis_schema
 
-__all__ = ["IBIS_DIALECTS", "IbisDefinition", "IbisView", "ibis_schema", "ibis_view", "union"]
+__all__ = ["IBIS_DIALECTS", "IbisDefinition", "IbisView", "ibis_schema", "ibis_view", "latest", "union"]

{interloper_sql-0.113.0 → interloper_sql-0.116.0}/src/interloper_sql/view/base.py

@@ -152,3 +152,19 @@ def union(upstreams: Sequence[Upstream], *columns: str, **stamps: Callable[[Upst
             values[name] = ibis.literal(stamped, type="int64") if is_integer else ibis.literal(stamped)
         tables.append(table.mutate(**values))
     return ibis.union(*tables, distinct=False).select(*names, *stamps)
+
+
+def latest(rows: ibis.Table, key: str, *order: ibis.Expr) -> ibis.Table:
+    """One row per *key*, the first in *order*: the dimension pattern over candidate rows.
+
+    Args:
+        rows: Candidate rows, several per key.
+        key: The column one row is kept per value of.
+        *order: The sort that puts the row to keep first, such as a source
+            tier then the latest date.
+
+    Returns:
+        The kept rows, without the ranking column.
+    """
+    ranked = rows.mutate(rank=ibis.row_number().over(group_by=key, order_by=list(order)))
+    return ranked.filter(ranked["rank"] == 0).drop("rank")

{interloper_sql-0.113.0 → interloper_sql-0.116.0}/src/interloper_sql/view/types.py

@@ -15,7 +15,7 @@ IBIS_TYPES: dict[Any, str] = {
     float: "float64",
     bool: "boolean",
     dt.date: "date",
-    dt.datetime: "timestamp",
+    dt.datetime: "timestamp('UTC')",
     Decimal: "decimal",
     bytes: "binary",
 }