UncountablePythonSDK 0.0.170__tar.gz → 0.0.171__tar.gz

{uncountablepythonsdk-0.0.170 → uncountablepythonsdk-0.0.171}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UncountablePythonSDK
-Version: 0.0.170
+Version: 0.0.171
 Summary: Uncountable SDK
 Project-URL: Homepage, https://github.com/uncountableinc/uncountable-python-sdk
 Project-URL: Repository, https://github.com/uncountableinc/uncountable-python-sdk.git

{uncountablepythonsdk-0.0.170 → uncountablepythonsdk-0.0.171}/UncountablePythonSDK.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UncountablePythonSDK
-Version: 0.0.170
+Version: 0.0.171
 Summary: Uncountable SDK
 Project-URL: Homepage, https://github.com/uncountableinc/uncountable-python-sdk
 Project-URL: Repository, https://github.com/uncountableinc/uncountable-python-sdk.git

{uncountablepythonsdk-0.0.170 → uncountablepythonsdk-0.0.171}/UncountablePythonSDK.egg-info/SOURCES.txt

@@ -299,6 +299,7 @@ uncountable/types/api/condition_parameters/upsert_condition_matches.py
 uncountable/types/api/entity/__init__.py
 uncountable/types/api/entity/create_entities.py
 uncountable/types/api/entity/create_entity.py
+uncountable/types/api/entity/create_or_update_entities.py
 uncountable/types/api/entity/create_or_update_entity.py
 uncountable/types/api/entity/export_entities.py
 uncountable/types/api/entity/get_entities_data.py
@@ -309,6 +310,7 @@ uncountable/types/api/entity/lock_entity.py
 uncountable/types/api/entity/lookup_entity.py
 uncountable/types/api/entity/resolve_entity_ids.py
 uncountable/types/api/entity/set_barcode.py
+uncountable/types/api/entity/set_entities_field_values.py
 uncountable/types/api/entity/set_entity_field_values.py
 uncountable/types/api/entity/set_values.py
 uncountable/types/api/entity/transition_entity_phase.py

{uncountablepythonsdk-0.0.170 → uncountablepythonsdk-0.0.171}/pkgs/argument_parser/argument_parser.py

@@ -35,7 +35,7 @@ from .parser_error import (
 
 T = typing.TypeVar("T")
 ParserFunction = typing.Callable[[typing.Any], T]
-ParserCache = dict[type[typing.Any], ParserFunction[typing.Any]]
+ParserCache = dict[type[typing.Any] | typing.TypeAliasType, ParserFunction[typing.Any]]
 
 
 class SourceEncoding(Enum):
@@ -267,7 +267,7 @@ def _resolve_base_type_vars(
 
 
 def _build_parser_inner(
-    parsed_type: type[T] | typing.TypeVar,
+    parsed_type: type[T] | typing.TypeVar | typing.TypeAliasType,
     context: ParserContext,
     type_var_map: dict[typing.TypeVar, type],
 ) -> ParserFunction[T]:
@@ -278,6 +278,26 @@ def _build_parser_inner(
     if isinstance(parsed_type, typing.TypeVar):
         return _build_parser_inner(type_var_map[parsed_type], context, type_var_map)
 
+    # Resolve PEP 695 type aliases (e.g. ``type Foo[T] = Annotated[..., ...]``)
+    # to their underlying value, threading any subscripted type arguments into
+    # ``type_var_map`` so generic substitutions reach the inner parser.
+    if isinstance(parsed_type, typing.TypeAliasType):
+        return _build_parser_inner(parsed_type.__value__, context, type_var_map)
+    alias_origin = typing.get_origin(parsed_type)
+    if isinstance(alias_origin, typing.TypeAliasType):
+        alias_args = typing.get_args(parsed_type)
+        merged_alias_map: dict[typing.TypeVar, type] = {**type_var_map}
+        for alias_param, alias_arg in zip(
+            alias_origin.__type_params__, alias_args, strict=True
+        ):
+            assert isinstance(alias_param, typing.TypeVar), (
+                "Parametric type alias only supports TypeVar parameters"
+            )
+            merged_alias_map[alias_param] = _resolve_type_var(
+                type_arg=alias_arg, type_var_map=type_var_map
+            )
+        return _build_parser_inner(alias_origin.__value__, context, merged_alias_map)
+
     serial_union = get_serial_union_data(parsed_type)
     if serial_union is not None:
         discriminator = serial_union.discriminator
@@ -689,7 +709,7 @@ _CACHE_MAP: dict[ParserOptions, ParserCache] = defaultdict(ParserCache)
 
 
 def build_parser(
-    parsed_type: type[T],
+    parsed_type: type[T] | typing.TypeAliasType,
     options: ParserOptions,
 ) -> ParserFunction[T]:
     """
@@ -744,7 +764,7 @@ class ParserBase(ABC, typing.Generic[T]):
 class CachedParser(ParserBase[T], typing.Generic[T]):
     def __init__(
         self,
-        args: type[T],
+        args: type[T] | typing.TypeAliasType,
         strict_property_parsing: bool = False,
     ):
         self.arguments = args

{uncountablepythonsdk-0.0.170 → uncountablepythonsdk-0.0.171}/pkgs/type_spec/builder.py

@@ -467,7 +467,7 @@ class SpecTypeDefn(SpecType):
 class SpecTypeGenericParameter(SpecType):
     def __init__(
         self,
-        spec_type_definition: SpecTypeDefnObject,
+        spec_type_definition: SpecTypeDefnObject | SpecTypeDefnUnion,
         name: str,
     ) -> None:
         self.spec_type_definition = spec_type_definition
@@ -623,8 +623,17 @@ class SpecTypeDefnAlias(SpecTypeDefn):
 
 
 class SpecTypeDefnUnion(SpecTypeDefn):
-    def __init__(self, namespace: SpecNamespace, name: str) -> None:
+    parameters: list[str]
+
+    def __init__(
+        self,
+        namespace: SpecNamespace,
+        name: str,
+        *,
+        parameters: list[str] | None = None,
+    ) -> None:
         super().__init__(namespace, name)
+        self.parameters = parameters if parameters is not None else []
         self.discriminator: str | None = None
         self.types: list[SpecType] = []
         self._alias_type: SpecType | None = None
@@ -638,7 +647,7 @@ class SpecTypeDefnUnion(SpecTypeDefn):
         self.discriminator = data.get("discriminator", None)
 
         for sub_type_str in data["types"]:
-            sub_type = builder.parse_type(self.namespace, sub_type_str)
+            sub_type = builder.parse_type(self.namespace, sub_type_str, scope=self)
             self.types.append(sub_type)
 
         base_type = builder.namespaces[base_namespace_name].types[BaseTypeName.s_union]
@@ -1302,9 +1311,16 @@ class SpecNamespace:
             if defn_type == DefnTypeName.s_alias:
                 spec_type = SpecTypeDefnAlias(self, name)
             elif defn_type == DefnTypeName.s_union:
-                spec_type = SpecTypeDefnUnion(self, name)
-                if parsed_name.parameters is not None:
-                    raise ValueError("Union types with parameters are not supported")
+                union_parameters = (
+                    [
+                        parameter.name
+                        for name_parameters in parsed_name.parameters
+                        for parameter in name_parameters
+                    ]
+                    if parsed_name.parameters is not None
+                    else None
+                )
+                spec_type = SpecTypeDefnUnion(self, name, parameters=union_parameters)
             elif defn_type == DefnTypeName.s_external:
                 spec_type = SpecTypeDefnExternal(self, name)
             elif defn_type == DefnTypeName.s_string_enum:
@@ -1550,9 +1566,9 @@ class SpecBuilder:
         if (
             defn_type is None
             and scope is not None
-            and isinstance(scope, SpecTypeDefnObject)
+            and isinstance(scope, (SpecTypeDefnObject, SpecTypeDefnUnion))
         ):
-            if path[0].name in (scope.parameters or []):
+            if path[0].name in scope.parameters:
                 return SpecTypeGenericParameter(
                     spec_type_definition=scope,
                     name=path[0].name,

{uncountablepythonsdk-0.0.170 → uncountablepythonsdk-0.0.171}/pkgs/type_spec/emit_open_api.py

@@ -535,6 +535,11 @@ def _emit_type(
         return
 
     if isinstance(stype, builder.SpecTypeDefnUnion):
+        if len(stype.parameters) > 0:
+            raise NotImplementedError(
+                f"OpenAPI emission for parametric union {stype.namespace.name}.{stype.name} "
+                f"is not supported. Use a concrete instantiation in the API surface instead."
+            )
         converted_discriminator_map: dict[str, OpenAPIRefType] = dict()
         if stype.discriminator_map is not None:
             for discriminator_value, base_type in stype.discriminator_map.items():

{uncountablepythonsdk-0.0.170 → uncountablepythonsdk-0.0.171}/pkgs/type_spec/emit_python.py

@@ -940,7 +940,11 @@ def _emit_type(ctx: Context, stype: builder.SpecType) -> None:
 
     if isinstance(stype, builder.SpecTypeDefnUnion):
         ctx.use_serial_union = True
-        ctx.out.write(f"{stype.name} = typing.Annotated[\n")
+        if len(stype.parameters) > 0:
+            type_params = f"[{', '.join(stype.parameters)}]"
+            ctx.out.write(f"type {stype.name}{type_params} = typing.Annotated[\n")
+        else:
+            ctx.out.write(f"{stype.name} = typing.Annotated[\n")
         ctx.out.write(f"{INDENT}{refer_to(ctx, stype.get_backing_type())},\n")
         ctx.out.write(f"{INDENT}serial_union_annotation(\n")
         ctx.out.write(

{uncountablepythonsdk-0.0.170 → uncountablepythonsdk-0.0.171}/pkgs/type_spec/emit_typescript_util.py

@@ -176,8 +176,12 @@ def emit_type_ts(ctx: EmitTypescriptContext, stype: builder.SpecType) -> None:
         return
 
     if isinstance(stype, builder.SpecTypeDefnUnion):
+        if len(stype.parameters) > 0:
+            full_type_name = f"{stype.name}<{', '.join(stype.parameters)}>"
+        else:
+            full_type_name = stype.name
         ctx.out.write(
-            f"export type {stype.name} = {refer_to(ctx, stype.get_backing_type())}\n"
+            f"export type {full_type_name} = {refer_to(ctx, stype.get_backing_type())}\n"
         )
         return
 

{uncountablepythonsdk-0.0.170 → uncountablepythonsdk-0.0.171}/pkgs/type_spec/type_info/emit_type_info.py

@@ -454,6 +454,7 @@ def _build_map_type(
     if isinstance(stype, builder.SpecTypeDefnUnion):
         backing = stype.get_backing_type()
         ext_info = _parse_ext_info(stype.ext_info)
+        union_params = stype.parameters if len(stype.parameters) > 0 else None
         return MapTypeAlias(
             type_name=stype.name,
             label=stype.label,
@@ -461,6 +462,7 @@ def _build_map_type(
             alias_type_path=type_path_of(backing),
             ext_info=_parse_ext_info(stype.ext_info),
             discriminator=stype.discriminator,
+            parameters=union_params,
         )
 
     if isinstance(stype, builder.SpecTypeDefnStringEnum):

{uncountablepythonsdk-0.0.170 → uncountablepythonsdk-0.0.171}/uncountable/types/__init__.py

@@ -26,6 +26,7 @@ from .api.entity import create_entities as create_entities_t
 from .api.entity import create_entity as create_entity_t
 from .api.inputs import create_inputs as create_inputs_t
 from .api.recipes import create_mix_order as create_mix_order_t
+from .api.entity import create_or_update_entities as create_or_update_entities_t
 from .api.entity import create_or_update_entity as create_or_update_entity_t
 from .api.recipes import create_recipe as create_recipe_t
 from .api.recipe_links import create_recipe_link as create_recipe_link_t
@@ -119,6 +120,7 @@ from . import runsheet_t as runsheet_t
 from . import secret_retrieval_t as secret_retrieval_t
 from .api.entity import set_barcode as set_barcode_t
 from .api.permissions import set_core_permissions as set_core_permissions_t
+from .api.entity import set_entities_field_values as set_entities_field_values_t
 from .api.entity import set_entity_field_values as set_entity_field_values_t
 from .api.permissions import set_entity_permission as set_entity_permission_t
 from .api.inputs import set_input_attribute_values as set_input_attribute_values_t
@@ -180,6 +182,7 @@ __all__: list[str] = [
     "create_entity_t",
     "create_inputs_t",
     "create_mix_order_t",
+    "create_or_update_entities_t",
     "create_or_update_entity_t",
     "create_recipe_t",
     "create_recipe_link_t",
@@ -273,6 +276,7 @@ __all__: list[str] = [
     "secret_retrieval_t",
     "set_barcode_t",
     "set_core_permissions_t",
+    "set_entities_field_values_t",
     "set_entity_field_values_t",
     "set_entity_permission_t",
     "set_input_attribute_values_t",

uncountablepythonsdk-0.0.171/uncountable/types/api/entity/create_or_update_entities.py

@@ -0,0 +1,57 @@
+# DO NOT MODIFY -- This file is generated by type_spec
+# ruff: noqa: E402 Q003
+# fmt: off
+# isort: skip_file
+from __future__ import annotations
+import typing  # noqa: F401
+import datetime  # noqa: F401
+from decimal import Decimal  # noqa: F401
+import dataclasses
+from pkgs.serialization import serial_class
+from ... import async_batch_t
+from ... import entity_t
+from ... import field_values_t
+from ... import identifier_t
+
+__all__: list[str] = [
+    "Arguments",
+    "Data",
+    "ENDPOINT_METHOD",
+    "ENDPOINT_PATH",
+    "EntityToCreateOrUpdate",
+]
+
+ENDPOINT_METHOD = "POST"
+ENDPOINT_PATH = "api/external/entity/create_or_update_entities"
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@serial_class(
+    named_type_path="sdk.api.entity.create_or_update_entities.EntityToCreateOrUpdate",
+)
+@dataclasses.dataclass(slots=True, kw_only=True)
+class EntityToCreateOrUpdate:
+    field_values: list[field_values_t.FieldArgumentValue]
+    entity_key: identifier_t.IdentifierKey | None = None
+    on_create_init_field_values: list[field_values_t.FieldArgumentValue] | None = None
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@serial_class(
+    named_type_path="sdk.api.entity.create_or_update_entities.Arguments",
+)
+@dataclasses.dataclass(slots=True, kw_only=True)
+class Arguments:
+    entity_type: entity_t.EntityType
+    definition_key: identifier_t.IdentifierKey
+    operations: list[EntityToCreateOrUpdate]
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@serial_class(
+    named_type_path="sdk.api.entity.create_or_update_entities.Data",
+)
+@dataclasses.dataclass(slots=True, kw_only=True)
+class Data:
+    results: list[async_batch_t.AsyncBatchActionReturn]
+# DO NOT MODIFY -- This file is generated by type_spec

uncountablepythonsdk-0.0.171/uncountable/types/api/entity/set_entities_field_values.py

@@ -0,0 +1,55 @@
+# DO NOT MODIFY -- This file is generated by type_spec
+# ruff: noqa: E402 Q003
+# fmt: off
+# isort: skip_file
+from __future__ import annotations
+import typing  # noqa: F401
+import datetime  # noqa: F401
+from decimal import Decimal  # noqa: F401
+import dataclasses
+from pkgs.serialization import serial_class
+from ... import async_batch_t
+from ... import entity_t
+from ... import field_values_t
+from ... import identifier_t
+
+__all__: list[str] = [
+    "Arguments",
+    "Data",
+    "ENDPOINT_METHOD",
+    "ENDPOINT_PATH",
+    "EntityToSetFieldValues",
+]
+
+ENDPOINT_METHOD = "POST"
+ENDPOINT_PATH = "api/external/entity/set_entities_field_values"
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@serial_class(
+    named_type_path="sdk.api.entity.set_entities_field_values.EntityToSetFieldValues",
+)
+@dataclasses.dataclass(slots=True, kw_only=True)
+class EntityToSetFieldValues:
+    identifier_key: identifier_t.IdentifierKey
+    field_values: list[field_values_t.FieldArgumentValue]
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@serial_class(
+    named_type_path="sdk.api.entity.set_entities_field_values.Arguments",
+)
+@dataclasses.dataclass(slots=True, kw_only=True)
+class Arguments:
+    entity_type: entity_t.EntityType
+    operations: list[EntityToSetFieldValues]
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@serial_class(
+    named_type_path="sdk.api.entity.set_entities_field_values.Data",
+)
+@dataclasses.dataclass(slots=True, kw_only=True)
+class Data:
+    results: list[async_batch_t.AsyncBatchActionReturn]
+# DO NOT MODIFY -- This file is generated by type_spec

{uncountablepythonsdk-0.0.170 → uncountablepythonsdk-0.0.171}/uncountable/types/client_base.py

@@ -27,6 +27,7 @@ import uncountable.types.api.entity.create_entities as create_entities_t
 import uncountable.types.api.entity.create_entity as create_entity_t
 import uncountable.types.api.inputs.create_inputs as create_inputs_t
 import uncountable.types.api.recipes.create_mix_order as create_mix_order_t
+import uncountable.types.api.entity.create_or_update_entities as create_or_update_entities_t
 import uncountable.types.api.entity.create_or_update_entity as create_or_update_entity_t
 import uncountable.types.api.recipes.create_recipe as create_recipe_t
 import uncountable.types.api.recipe_links.create_recipe_link as create_recipe_link_t
@@ -96,6 +97,7 @@ import uncountable.types.api.outputs.resolve_output_conditions as resolve_output
 import uncountable.types.api.triggers.run_trigger as run_trigger_t
 import uncountable.types.api.entity.set_barcode as set_barcode_t
 import uncountable.types.api.permissions.set_core_permissions as set_core_permissions_t
+import uncountable.types.api.entity.set_entities_field_values as set_entities_field_values_t
 import uncountable.types.api.entity.set_entity_field_values as set_entity_field_values_t
 import uncountable.types.api.permissions.set_entity_permission as set_entity_permission_t
 import uncountable.types.api.inputs.set_input_attribute_values as set_input_attribute_values_t
@@ -541,6 +543,30 @@ class ClientMethods(ABC):
         )
         return self.do_request(api_request=api_request, return_type=create_mix_order_t.Data)
 
+    def create_or_update_entities(
+        self,
+        *,
+        entity_type: entity_t.EntityType,
+        definition_key: identifier_t.IdentifierKey,
+        operations: list[create_or_update_entities_t.EntityToCreateOrUpdate],
+        _request_options: client_config_t.RequestOptions | None = None,
+    ) -> create_or_update_entities_t.Data:
+        """Bulk variant of create_or_update_entity scoped to a single (entity_type, definition_key) — accepts up to 100 operations sharing that scope and applies them via batched primitive calls (one permission check + one set_field_values across updates, one create_entities across creates). Returns one AsyncBatchActionReturn per input, in the same order. Cross-operation batch_reference dependencies are not supported.
+
+        """
+        args = create_or_update_entities_t.Arguments(
+            entity_type=entity_type,
+            definition_key=definition_key,
+            operations=operations,
+        )
+        api_request = APIRequest(
+            method=create_or_update_entities_t.ENDPOINT_METHOD,
+            endpoint=create_or_update_entities_t.ENDPOINT_PATH,
+            args=args,
+            request_options=_request_options,
+        )
+        return self.do_request(api_request=api_request, return_type=create_or_update_entities_t.Data)
+
     def create_or_update_entity(
         self,
         *,
@@ -1899,6 +1925,28 @@ class ClientMethods(ABC):
         )
         return self.do_request(api_request=api_request, return_type=set_core_permissions_t.Data)
 
+    def set_entities_field_values(
+        self,
+        *,
+        entity_type: entity_t.EntityType,
+        operations: list[set_entities_field_values_t.EntityToSetFieldValues],
+        _request_options: client_config_t.RequestOptions | None = None,
+    ) -> set_entities_field_values_t.Data:
+        """Bulk variant of set_entity_field_values scoped to a single entity_type — accepts up to 100 (identifier_key, field_values) operations sharing that scope and applies them via batched primitive calls (one entity-resolution round-trip, one check_entity_list_permitted, one set_field_values across the aggregate). Returns one AsyncBatchActionReturn per input, in the same order. Cross-operation batch_reference dependencies are not supported.
+
+        """
+        args = set_entities_field_values_t.Arguments(
+            entity_type=entity_type,
+            operations=operations,
+        )
+        api_request = APIRequest(
+            method=set_entities_field_values_t.ENDPOINT_METHOD,
+            endpoint=set_entities_field_values_t.ENDPOINT_PATH,
+            args=args,
+            request_options=_request_options,
+        )
+        return self.do_request(api_request=api_request, return_type=set_entities_field_values_t.Data)
+
     def set_entity_field_values(
         self,
         *,