query-cache-common 1.2.0__tar.gz → 1.2.1__tar.gz

{query_cache_common-1.2.0 → query_cache_common-1.2.1}/.gitignore

@@ -226,3 +226,6 @@ tests/integration/dbt_run_cache_turbo/corpus_catalog.json
 
 # Superpowers (AI agent plans/specs)
 docs/superpowers/
+
+# Git worktrees
+.worktrees/

{query_cache_common-1.2.0 → query_cache_common-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: query-cache-common
-Version: 1.2.0
+Version: 1.2.1
 Summary: Common code for Query Cache shared across client and server
 License: Copyright (c) 2026 Fivetran, Inc.
         
@@ -32,5 +32,6 @@ License: Copyright (c) 2026 Fivetran, Inc.
         FROM USE OF THIS SOFTWARE, INCLUDING DIRECT, INDIRECT, INCIDENTAL,
         PUNITIVE, AND CONSEQUENTIAL DAMAGES.
 Requires-Python: >=3.9
+Requires-Dist: humanize
 Requires-Dist: query-cache-protobuf
 Requires-Dist: typing-extensions>=4.0.0

{query_cache_common-1.2.0 → query_cache_common-1.2.1}/pyproject.toml

@@ -7,6 +7,7 @@ requires-python = ">=3.9"
 dependencies = [
     "typing-extensions>=4.0.0",
     "query-cache-protobuf",
+    "humanize",
 ]
 
 [tool.hatch.version]

{query_cache_common-1.2.0 → query_cache_common-1.2.1}/src/query_cache_common/models/services/explain_service_models.py

@@ -57,3 +57,7 @@ class GetExplainMessagesRequest(BaseSerDeModel):
 @proto_dataclass(explain_service_pb2.GetExplainMessagesResponse)
 class GetExplainMessagesResponse(BaseSerDeModel):
     messages: t.List[ExplainMessageEntry]
+
+    @property
+    def by_id(self) -> t.Dict[str, ExplainMessageEntry]:
+        return {m.execution_decision_id: m for m in self.messages}

{query_cache_common-1.2.0 → query_cache_common-1.2.1}/src/query_cache_common/utils.py

@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+import datetime
+import humanize
 import time
 import typing as t
 
@@ -114,3 +116,16 @@ def extract_fqn_parts(fqn: str, dialect: str) -> t.Tuple[str, str, str]:
         raise ValueError(f"Expecting SQLGlot expression for name, got: {name}")
 
     return catalog.sql(dialect=dialect), schema.sql(dialect=dialect), name.sql(dialect=dialect)
+
+
+def format_as_localtime(dt: datetime.datetime) -> str:
+    local_dt = dt.astimezone()  # convert to localtime
+    return local_dt.strftime("%Y-%m-%d %H:%M:%S %Z")
+
+
+def format_epoch_relative(epoch: t.Optional[int]) -> str:
+    if epoch is None:
+        return "no data"
+
+    as_dt = datetime.datetime.fromtimestamp(epoch / 1000, tz=datetime.timezone.utc)
+    return f"{humanize.naturaltime(as_dt)}, {format_as_localtime(as_dt)}"