cocoindex 0.1.44__cp313-cp313-macosx_11_0_arm64.whl → 0.1.45__cp313-cp313-macosx_11_0_arm64.whl

cocoindex/convert.py

@@ -1,35 +1,48 @@
 """
 Utilities to convert between Python and engine values.
 """
+
 import dataclasses
 import datetime
 import inspect
 import uuid
 
 from enum import Enum
-from typing import Any, Callable, get_origin
-from .typing import analyze_type_info, encode_enriched_type, is_namedtuple_type, TABLE_TYPES, KEY_FIELD_NAME
+from typing import Any, Callable, get_origin, Mapping
+from .typing import (
+    analyze_type_info,
+    encode_enriched_type,
+    is_namedtuple_type,
+    TABLE_TYPES,
+    KEY_FIELD_NAME,
+)
 
 
 def encode_engine_value(value: Any) -> Any:
     """Encode a Python value to an engine value."""
     if dataclasses.is_dataclass(value):
-        return [encode_engine_value(getattr(value, f.name)) for f in dataclasses.fields(value)]
+        return [
+            encode_engine_value(getattr(value, f.name))
+            for f in dataclasses.fields(value)
+        ]
     if is_namedtuple_type(type(value)):
         return [encode_engine_value(getattr(value, name)) for name in value._fields]
     if isinstance(value, (list, tuple)):
         return [encode_engine_value(v) for v in value]
     if isinstance(value, dict):
-        return [[encode_engine_value(k)] + encode_engine_value(v) for k, v in value.items()]
+        return [
+            [encode_engine_value(k)] + encode_engine_value(v) for k, v in value.items()
+        ]
     if isinstance(value, uuid.UUID):
         return value.bytes
     return value
 
+
 def make_engine_value_decoder(
-        field_path: list[str],
-        src_type: dict[str, Any],
-        dst_annotation,
-    ) -> Callable[[Any], Any]:
+    field_path: list[str],
+    src_type: dict[str, Any],
+    dst_annotation: Any,
+) -> Callable[[Any], Any]:
     """
     Make a decoder from an engine value to a Python value.
 
@@ -42,12 +55,18 @@ def make_engine_value_decoder(
         A decoder from an engine value to a Python value.
     """
 
-    src_type_kind = src_type['kind']
+    src_type_kind = src_type["kind"]
 
-    if dst_annotation is None or dst_annotation is inspect.Parameter.empty or dst_annotation is Any:
-        if src_type_kind == 'Struct' or src_type_kind in TABLE_TYPES:
-            raise ValueError(f"Missing type annotation for `{''.join(field_path)}`."
-                             f"It's required for {src_type_kind} type.")
+    if (
+        dst_annotation is None
+        or dst_annotation is inspect.Parameter.empty
+        or dst_annotation is Any
+    ):
+        if src_type_kind == "Struct" or src_type_kind in TABLE_TYPES:
+            raise ValueError(
+                f"Missing type annotation for `{''.join(field_path)}`."
+                f"It's required for {src_type_kind} type."
+            )
         return lambda value: value
 
     dst_type_info = analyze_type_info(dst_annotation)
@@ -55,96 +74,118 @@ def make_engine_value_decoder(
     if src_type_kind != dst_type_info.kind:
         raise ValueError(
             f"Type mismatch for `{''.join(field_path)}`: "
-            f"passed in {src_type_kind}, declared {dst_annotation} ({dst_type_info.kind})")
+            f"passed in {src_type_kind}, declared {dst_annotation} ({dst_type_info.kind})"
+        )
 
     if dst_type_info.struct_type is not None:
         return _make_engine_struct_value_decoder(
-            field_path, src_type['fields'], dst_type_info.struct_type)
+            field_path, src_type["fields"], dst_type_info.struct_type
+        )
 
     if src_type_kind in TABLE_TYPES:
-        field_path.append('[*]')
+        field_path.append("[*]")
         elem_type_info = analyze_type_info(dst_type_info.elem_type)
         if elem_type_info.struct_type is None:
-            raise ValueError(f"Type mismatch for `{''.join(field_path)}`: "
-                            f"declared `{dst_type_info.kind}`, a dataclass or NamedTuple type expected")
-        engine_fields_schema = src_type['row']['fields']
+            raise ValueError(
+                f"Type mismatch for `{''.join(field_path)}`: "
+                f"declared `{dst_type_info.kind}`, a dataclass or NamedTuple type expected"
+            )
+        engine_fields_schema = src_type["row"]["fields"]
         if elem_type_info.key_type is not None:
             key_field_schema = engine_fields_schema[0]
             field_path.append(f".{key_field_schema.get('name', KEY_FIELD_NAME)}")
             key_decoder = make_engine_value_decoder(
-                field_path, key_field_schema['type'], elem_type_info.key_type)
+                field_path, key_field_schema["type"], elem_type_info.key_type
+            )
             field_path.pop()
             value_decoder = _make_engine_struct_value_decoder(
-                field_path, engine_fields_schema[1:], elem_type_info.struct_type)
-            def decode(value):
+                field_path, engine_fields_schema[1:], elem_type_info.struct_type
+            )
+
+            def decode(value: Any) -> Any | None:
                 if value is None:
                     return None
                 return {key_decoder(v[0]): value_decoder(v[1:]) for v in value}
         else:
             elem_decoder = _make_engine_struct_value_decoder(
-                field_path, engine_fields_schema, elem_type_info.struct_type)
-            def decode(value):
+                field_path, engine_fields_schema, elem_type_info.struct_type
+            )
+
+            def decode(value: Any) -> Any | None:
                 if value is None:
                     return None
                 return [elem_decoder(v) for v in value]
+
         field_path.pop()
         return decode
 
-    if src_type_kind == 'Uuid':
+    if src_type_kind == "Uuid":
         return lambda value: uuid.UUID(bytes=value)
 
     return lambda value: value
 
+
 def _make_engine_struct_value_decoder(
-        field_path: list[str],
-        src_fields: list[dict[str, Any]],
-        dst_struct_type: type,
-    ) -> Callable[[list], Any]:
+    field_path: list[str],
+    src_fields: list[dict[str, Any]],
+    dst_struct_type: type,
+) -> Callable[[list[Any]], Any]:
     """Make a decoder from an engine field values to a Python value."""
 
-    src_name_to_idx = {f['name']: i for i, f in enumerate(src_fields)}
-    
-    is_dataclass = dataclasses.is_dataclass(dst_struct_type)
-    is_namedtuple = is_namedtuple_type(dst_struct_type)
-    
-    if is_dataclass:
+    src_name_to_idx = {f["name"]: i for i, f in enumerate(src_fields)}
+
+    parameters: Mapping[str, inspect.Parameter]
+    if dataclasses.is_dataclass(dst_struct_type):
         parameters = inspect.signature(dst_struct_type).parameters
-    elif is_namedtuple:
-        defaults = getattr(dst_struct_type, '_field_defaults', {})
+    elif is_namedtuple_type(dst_struct_type):
+        defaults = getattr(dst_struct_type, "_field_defaults", {})
+        fields = getattr(dst_struct_type, "_fields", ())
         parameters = {
             name: inspect.Parameter(
                 name=name,
                 kind=inspect.Parameter.POSITIONAL_OR_KEYWORD,
                 default=defaults.get(name, inspect.Parameter.empty),
-                annotation=dst_struct_type.__annotations__.get(name, inspect.Parameter.empty)
+                annotation=dst_struct_type.__annotations__.get(
+                    name, inspect.Parameter.empty
+                ),
             )
-            for name in dst_struct_type._fields
+            for name in fields
         }
     else:
         raise ValueError(f"Unsupported struct type: {dst_struct_type}")
 
-    def make_closure_for_value(name: str, param: inspect.Parameter) -> Callable[[list], Any]:
+    def make_closure_for_value(
+        name: str, param: inspect.Parameter
+    ) -> Callable[[list[Any]], Any]:
         src_idx = src_name_to_idx.get(name)
         if src_idx is not None:
-            field_path.append(f'.{name}')
+            field_path.append(f".{name}")
             field_decoder = make_engine_value_decoder(
-                field_path, src_fields[src_idx]['type'], param.annotation)
+                field_path, src_fields[src_idx]["type"], param.annotation
+            )
             field_path.pop()
-            return lambda values: field_decoder(values[src_idx]) if len(values) > src_idx else param.default
+            return (
+                lambda values: field_decoder(values[src_idx])
+                if len(values) > src_idx
+                else param.default
+            )
 
         default_value = param.default
         if default_value is inspect.Parameter.empty:
             raise ValueError(
-                f"Field without default value is missing in input: {''.join(field_path)}")
+                f"Field without default value is missing in input: {''.join(field_path)}"
+            )
 
         return lambda _: default_value
 
     field_value_decoder = [
-        make_closure_for_value(name, param)
-        for (name, param) in parameters.items()]
+        make_closure_for_value(name, param) for (name, param) in parameters.items()
+    ]
 
     return lambda values: dst_struct_type(
-        *(decoder(values) for decoder in field_value_decoder))
+        *(decoder(values) for decoder in field_value_decoder)
+    )
+
 
 def dump_engine_object(v: Any) -> Any:
     """Recursively dump an object for engine. Engine side uses `Pythonized` to catch."""
@@ -158,14 +199,14 @@ def dump_engine_object(v: Any) -> Any:
         total_secs = v.total_seconds()
         secs = int(total_secs)
         nanos = int((total_secs - secs) * 1e9)
-        return {'secs': secs, 'nanos': nanos}
-    elif hasattr(v, '__dict__'):
+        return {"secs": secs, "nanos": nanos}
+    elif hasattr(v, "__dict__"):
         s = {k: dump_engine_object(v) for k, v in v.__dict__.items()}
-        if hasattr(v, 'kind') and 'kind' not in s:
-            s['kind'] = v.kind
+        if hasattr(v, "kind") and "kind" not in s:
+            s["kind"] = v.kind
         return s
     elif isinstance(v, (list, tuple)):
         return [dump_engine_object(item) for item in v]
     elif isinstance(v, dict):
         return {k: dump_engine_object(v) for k, v in v.items()}
-    return v
+    return v