vgi-python 0.11.0__tar.gz → 0.11.1__tar.gz

{vgi_python-0.11.0 → vgi_python-0.11.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vgi-python
-Version: 0.11.0
+Version: 0.11.1
 Summary: Vector Gateway Interface - Connect DuckDB to external programs via Apache Arrow
 Project-URL: Homepage, https://query.farm
 Project-URL: Repository, https://github.com/Query-farm/vgi-python

{vgi_python-0.11.0 → vgi_python-0.11.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "vgi-python"
-version = "0.11.0"
+version = "0.11.1"
 description = "Vector Gateway Interface - Connect DuckDB to external programs via Apache Arrow"
 readme = "README.md"
 keywords = [

{vgi_python-0.11.0 → vgi_python-0.11.1}/tests/landing/_checker.py

@@ -63,7 +63,7 @@ def check(
     """Return a list of failure strings (empty == conformant)."""
     base = base_url.rstrip("/")
     fails: list[str] = []
-    schema = json.loads(schema_path.read_text())
+    schema = json.loads(schema_path.read_text(encoding="utf-8"))
     columns_schema = {**schema, **schema["$defs"]["columns"]}
 
     # 1) describe.json — schema-valid.
@@ -105,11 +105,17 @@ def check(
     # 4) Golden diff (cross-language equality).
     if golden_path is not None:
         got = _canonical(normalize(doc))
-        want = golden_path.read_text() if golden_path.exists() else None
+        want = golden_path.read_text(encoding="utf-8") if golden_path.exists() else None
         if want is None:
             fails.append(f"golden {golden_path} does not exist (run with --update)")
         elif got.strip() != want.strip():
-            fails.append(f"describe.json does not match golden {golden_path.name} (normalized diff)")
+            import difflib
+
+            diff = list(
+                difflib.unified_diff(want.strip().splitlines(), got.strip().splitlines(), "golden", "live", lineterm="")
+            )
+            snippet = "\n".join(diff[:40])
+            fails.append(f"describe.json does not match golden {golden_path.name}:\n{snippet}")
 
     return fails
 
@@ -127,7 +133,7 @@ def main() -> int:
             ap.error("--update requires --golden")
         _, body, _ = _get(f"{args.url.rstrip('/')}/describe.json")
         args.golden.parent.mkdir(parents=True, exist_ok=True)
-        args.golden.write_text(_canonical(normalize(json.loads(body))) + "\n")
+        args.golden.write_text(_canonical(normalize(json.loads(body))) + "\n", encoding="utf-8")
         print(f"wrote golden {args.golden}")
         return 0
 

{vgi_python-0.11.0 → vgi_python-0.11.1}/uv.lock

@@ -2228,7 +2228,7 @@ requires-dist = [
 
 [[package]]
 name = "vgi-python"
-version = "0.11.0"
+version = "0.11.1"
 source = { editable = "." }
 dependencies = [
     { name = "click" },

{vgi_python-0.11.0 → vgi_python-0.11.1}/vgi/http/describe_json.py

@@ -119,13 +119,13 @@ def _attach(
 # ---------------------------------------------------------------------------
 
 
-def _meta(field: pa.Field, key: bytes) -> str | None:
+def _meta(field: pa.Field[Any], key: bytes) -> str | None:
     md = field.metadata or {}
     raw = md.get(key)
     return raw.decode("utf-8") if raw is not None else None
 
 
-def _column(field: pa.Field) -> dict[str, Any]:
+def _column(field: pa.Field[Any]) -> dict[str, Any]:
     col: dict[str, Any] = {"name": field.name, "type": str(field.type)}
     comment = _meta(field, b"comment") or _meta(field, VGI_DOC_KEY)
     if comment:
@@ -157,7 +157,7 @@ def _function_returns(fn: FunctionInfo) -> str | None:
         return None
     if fn.function_type in (FunctionType.SCALAR, FunctionType.AGGREGATE):
         # Scalar/aggregate output is a single "result" column.
-        return str(schema[0].type)
+        return str(schema.field(0).type)
     cols = ", ".join(f"{f.name} {f.type}" for f in schema)
     return f"TABLE({cols})"
 
@@ -206,7 +206,9 @@ def _schema_contents(
         return []
 
 
-def _build_schemas(iface: CatalogInterface, attach_opaque_data: AttachOpaqueData) -> tuple[list[dict], dict[str, int]]:
+def _build_schemas(
+    iface: CatalogInterface, attach_opaque_data: AttachOpaqueData
+) -> tuple[list[dict[str, Any]], dict[str, int]]:
     """Return ``(schemas, counts)`` for the attached catalog."""
     try:
         schema_infos = list(iface.schemas(attach_opaque_data=attach_opaque_data, transaction_opaque_data=None))
@@ -214,9 +216,11 @@ def _build_schemas(iface: CatalogInterface, attach_opaque_data: AttachOpaqueData
         logger.debug("iface.schemas() failed", exc_info=True)
         return [], {"schemas": 0, "tables": 0, "views": 0, "functions": 0}
 
-    schemas: list[dict] = []
+    schemas: list[dict[str, Any]] = []
     totals = {"schemas": 0, "tables": 0, "views": 0, "functions": 0}
-    for si in schema_infos:
+    # Deterministic ordering so describe.json (and the conformance golden) is
+    # stable across platforms / Python versions / worker iteration order.
+    for si in sorted(schema_infos, key=lambda s: s.name):
         tables_raw: list[TableInfo] = _schema_contents(iface, attach_opaque_data, si.name, SchemaObjectType.TABLE)
         views_raw: list[ViewInfo] = _schema_contents(iface, attach_opaque_data, si.name, SchemaObjectType.VIEW)
         funcs_raw: list[FunctionInfo] = []
@@ -228,14 +232,14 @@ def _build_schemas(iface: CatalogInterface, attach_opaque_data: AttachOpaqueData
             funcs_raw.extend(_schema_contents(iface, attach_opaque_data, si.name, kind))
 
         tables = []
-        for t in tables_raw:
+        for t in sorted(tables_raw, key=lambda x: x.name):
             schema = _read_schema(bytes(t.columns))
             tables.append(
                 {"name": t.name, "cols": len(schema) if schema is not None else 0, "comment": t.comment or ""}
             )
 
         views = []
-        for v in views_raw:
+        for v in sorted(views_raw, key=lambda x: x.name):
             views.append(
                 {
                     "name": v.name,