UncountablePythonSDK 0.0.112__tar.gz → 0.0.114__tar.gz

{uncountablepythonsdk-0.0.112 → uncountablepythonsdk-0.0.114}/.github/workflows/documentation.yml

@@ -11,16 +11,14 @@ jobs:
     steps:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
       - uses: actions/setup-python@82c7e631bb3cdc910f68e0081d67478d79c6982d # v5
-        with:
-          python-version: '3.12'
       - uses: extractions/setup-crate@4993624604c307fbca528d28a3c8b60fa5ecc859 # v1
         with:
           repo: casey/just@0.10
       - name: Set up UV
-        uses: astral-sh/setup-uv@4db96194c378173c656ce18a155ffc14a9fc4355 # v5
+        uses: astral-sh/setup-uv@v6
         with:
           version: "0.7.1"
-          python-version: "3.12"
+          activate-environment: true
           enable-cache: true
       - name: Install dependencies
         run: |

{uncountablepythonsdk-0.0.112 → uncountablepythonsdk-0.0.114}/.github/workflows/publish.yml

@@ -22,14 +22,11 @@ jobs:
       - uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4
         with:
           fetch-depth: 0
-      - uses: actions/setup-python@82c7e631bb3cdc910f68e0081d67478d79c6982d # v5
-        with:
-          python-version: '3.12'
       - name: Set up UV
-        uses: astral-sh/setup-uv@4db96194c378173c656ce18a155ffc14a9fc4355 # v5
+        uses: astral-sh/setup-uv@v6
         with:
           version: "0.7.1"
-          python-version: "3.12"
+          activate-environment: true
           enable-cache: true
       - name: Install build dependencies
         run: |

uncountablepythonsdk-0.0.114/.python-version

@@ -0,0 +1 @@
+3.12.10

{uncountablepythonsdk-0.0.112/UncountablePythonSDK.egg-info → uncountablepythonsdk-0.0.114}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UncountablePythonSDK
-Version: 0.0.112
+Version: 0.0.114
 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.112 → uncountablepythonsdk-0.0.114/UncountablePythonSDK.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UncountablePythonSDK
-Version: 0.0.112
+Version: 0.0.114
 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.112 → uncountablepythonsdk-0.0.114}/UncountablePythonSDK.egg-info/SOURCES.txt

@@ -1,4 +1,5 @@
 .gitignore
+.python-version
 README.md
 pyproject.toml
 .github/workflows/documentation.yml
@@ -34,6 +35,7 @@ examples/set_recipe_metadata_file.py
 examples/set_recipe_output_file_sdk.py
 examples/upload_files.py
 examples/integration-server/pyproject.toml
+examples/integration-server/jobs/materials_auto/concurrent_cron.py
 examples/integration-server/jobs/materials_auto/example_cron.py
 examples/integration-server/jobs/materials_auto/example_runsheet_wh.py
 examples/integration-server/jobs/materials_auto/example_wh.py
@@ -81,6 +83,7 @@ pkgs/type_spec/emit_python.py
 pkgs/type_spec/emit_typescript.py
 pkgs/type_spec/emit_typescript_util.py
 pkgs/type_spec/load_types.py
+pkgs/type_spec/non_discriminated_union_exceptions.py
 pkgs/type_spec/open_api_util.py
 pkgs/type_spec/test.py
 pkgs/type_spec/util.py
@@ -169,6 +172,8 @@ uncountable/types/entity.py
 uncountable/types/entity_t.py
 uncountable/types/experiment_groups.py
 uncountable/types/experiment_groups_t.py
+uncountable/types/exports.py
+uncountable/types/exports_t.py
 uncountable/types/field_values.py
 uncountable/types/field_values_t.py
 uncountable/types/fields.py
@@ -239,6 +244,7 @@ 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_entity.py
+uncountable/types/api/entity/export_entities.py
 uncountable/types/api/entity/get_entities_data.py
 uncountable/types/api/entity/grant_entity_permissions.py
 uncountable/types/api/entity/list_entities.py
@@ -292,6 +298,7 @@ uncountable/types/api/recipes/archive_recipes.py
 uncountable/types/api/recipes/associate_recipe_as_input.py
 uncountable/types/api/recipes/associate_recipe_as_lot.py
 uncountable/types/api/recipes/clear_recipe_outputs.py
+uncountable/types/api/recipes/create_mix_order.py
 uncountable/types/api/recipes/create_recipe.py
 uncountable/types/api/recipes/create_recipes.py
 uncountable/types/api/recipes/disassociate_recipe_as_input.py

uncountablepythonsdk-0.0.114/examples/integration-server/jobs/materials_auto/concurrent_cron.py

@@ -0,0 +1,11 @@
+import time
+
+from uncountable.integration.job import CronJob, JobArguments, register_job
+from uncountable.types.job_definition_t import JobResult
+
+
+@register_job
+class MyConcurrentCronJob(CronJob):
+    def run(self, args: JobArguments) -> JobResult:
+        time.sleep(10)
+        return JobResult(success=True)

{uncountablepythonsdk-0.0.112 → uncountablepythonsdk-0.0.114}/examples/integration-server/jobs/materials_auto/profile.yaml

@@ -22,6 +22,25 @@ jobs:
         - admin:
           type: ref_name
           ref_name: admin
+  - id: concurrent_cron_1
+    enabled: true
+    type: cron
+    name: MyConcurrentCron - 1
+    cron_spec: "* * * * *"
+    executor:
+      type: script
+      import_path: concurrent_cron
+    subqueue_name: subqueue_1
+  - id: concurrent_cron_2
+    enabled: true
+    type: cron
+    name: MyConcurrentCron - 2
+    cron_spec: "* * * * *"
+    executor:
+      type: script
+      import_path: concurrent_cron
+    subqueue_name: subqueue_2
+
 
   - id: example_wh1
     type: webhook

{uncountablepythonsdk-0.0.112 → uncountablepythonsdk-0.0.114}/pkgs/argument_parser/argument_parser.py

@@ -170,9 +170,15 @@ def _invoke_membership_parser(
 
 def _build_parser_discriminated_union(
     context: ParserContext,
-    discriminator: str,
+    discriminator_raw: str,
     discriminator_map: dict[str, ParserFunction[T]],
 ) -> ParserFunction[T]:
+    discriminator = (
+        snake_to_camel_case(discriminator_raw)
+        if context.options.from_camel_case
+        else discriminator_raw
+    )
+
     def parse(value: typing.Any) -> typing.Any:
         if context.options.allow_direct_type and dataclasses.is_dataclass(value):
             discriminant = getattr(value, discriminator)
@@ -414,8 +420,7 @@ def _build_parser_dataclass(
     cur_parser = context.cache.get(parsed_type)
     if cur_parser is not None:
         return cur_parser
-
-    type_hints = typing.get_type_hints(parsed_type)
+    type_hints = typing.get_type_hints(parsed_type, include_extras=True)
     dc_field_parsers: list[
         tuple[
             dataclasses.Field[typing.Any],

{uncountablepythonsdk-0.0.112 → uncountablepythonsdk-0.0.114}/pkgs/filesystem_utils/_blob_session.py

@@ -1,5 +1,6 @@
 from io import BytesIO
 
+from azure.core.credentials import AzureSasCredential
 from azure.storage.blob import BlobServiceClient, ContainerClient
 
 from pkgs.filesystem_utils.file_type_utils import (
@@ -122,7 +123,13 @@ class BlobSession(FileSystemSession):
             )
             dest_blob_client = self.container_client.get_blob_client(dest_file.filepath)
 
-            dest_blob_client.start_copy_from_url(source_blob_client.url)
+            source_url = (
+                f"{source_blob_client.url}?{self.config.credential.signature}"
+                if isinstance(self.config.credential, AzureSasCredential)
+                else source_blob_client.url
+            )
+
+            dest_blob_client.start_copy_from_url(source_url)
             source_blob_client.delete_blob()
 
     def delete_files(self, filepaths: list[FileSystemObject]) -> None:

{uncountablepythonsdk-0.0.112 → uncountablepythonsdk-0.0.114}/pkgs/type_spec/builder.py

@@ -14,6 +14,7 @@ from typing import Any, Self
 
 from . import util
 from .cross_output_links import CrossOutputPaths
+from .non_discriminated_union_exceptions import NON_DISCRIMINATED_UNION_EXCEPTIONS
 from .util import parse_type_str, unused
 
 RawDict = dict[Any, Any]
@@ -636,6 +637,11 @@ class SpecTypeDefnUnion(SpecTypeDefn):
                 self.discriminator_map[discriminant] = sub_type
 
                 builder.pop_where()
+        elif (
+            f"{self.namespace.name}.{self.name}"
+            not in NON_DISCRIMINATED_UNION_EXCEPTIONS
+        ):
+            raise Exception(f"union requires a discriminator: {self.name}")
 
     def get_referenced_types(self) -> list[SpecType]:
         return self.types
@@ -960,8 +966,8 @@ class SpecEndpoint:
         elif isinstance(is_sdk, str):
             try:
                 is_sdk = EndpointEmitType(is_sdk)
-            except ValueError:
-                raise ValueError(f"Invalid value for is_sdk: {is_sdk}")
+            except ValueError as e:
+                raise ValueError(f"Invalid value for is_sdk: {is_sdk}") from e
 
         assert isinstance(is_sdk, EndpointEmitType)
 

uncountablepythonsdk-0.0.114/pkgs/type_spec/non_discriminated_union_exceptions.py

@@ -0,0 +1,14 @@
+NON_DISCRIMINATED_UNION_EXCEPTIONS = [
+    "generate_tool_parameters.UnionWithoutDiscrim",
+    "output_calculation_entities.ConditionParameterFilterCondition",
+    "output_parameters.AnalyticalMethodParameterOptions",
+    "output_parameters.AnalyticalMethodLinkedOptionValue",
+    "recipes_redirect.RecipesRedirectResult",
+    "value_spec.ResolvedPathAll",
+    "weighted_sum.WeightedSumEntities",
+    "workflows.WorkflowTotalDisplay",
+    "type_info.TypeFormActionConstraint",
+    "structured_loading.CompatibleFilterNode",
+    "structured_display_element.DisplayElementColumn",
+    "field_values.FieldValue",
+]

{uncountablepythonsdk-0.0.112 → uncountablepythonsdk-0.0.114}/pkgs/type_spec/parts/base.py.prepart

@@ -58,15 +58,12 @@ def is_pure_json_value(value: ExtJsonValue) -> bool:
         return True
 
     if isinstance(value, list):
-        for item in value:
-            if not is_pure_json_value(item):
-                return False
-        return True
+        return all(is_pure_json_value(item) for item in value)
 
     if isinstance(value, dict):
-        for key, item in value.items():
-            if not is_pure_json_value(key) or not is_pure_json_value(item):
-                return False
-        return True
+        return all(
+            is_pure_json_value(key) and is_pure_json_value(item)
+            for key, item in value.items()
+        )
 
     return False

{uncountablepythonsdk-0.0.112 → uncountablepythonsdk-0.0.114}/pkgs/type_spec/value_spec/__main__.py

@@ -104,8 +104,8 @@ def parse_function_signature(text: str) -> ParsedFunctionSignature:
 
         type_str = source.extract_type()
         ref_name = arg_group.group(1)
-        is_missing = arg_group.group(2) == "?"
-        is_repeating = arg_group.group(2) == "+"
+        # is_missing = arg_group.group(2) == "?"
+        # is_repeating = arg_group.group(2) == "+"
         type_path = parse_type_str(type_str)
 
         match arg_group.group(3):

{uncountablepythonsdk-0.0.112 → uncountablepythonsdk-0.0.114}/uncountable/integration/queue_runner/job_scheduler.py

@@ -1,4 +1,5 @@
 import asyncio
+import sys
 import typing
 from concurrent.futures import ProcessPoolExecutor
 from dataclasses import dataclass
@@ -34,6 +35,10 @@ class JobListenerKey:
 def _get_job_worker_key(
     job_definition: job_definition_t.JobDefinition, profile_name: str
 ) -> JobListenerKey:
+    if job_definition.subqueue_name is not None:
+        return JobListenerKey(
+            profile_name=profile_name, subqueue_name=job_definition.subqueue_name
+        )
     return JobListenerKey(profile_name=profile_name)
 
 
@@ -41,9 +46,12 @@ def on_worker_crash(
     worker_key: JobListenerKey,
 ) -> typing.Callable[[asyncio.Task], None]:
     def hook(task: asyncio.Task) -> None:
-        raise Exception(
-            f"worker {worker_key.profile_name}_{worker_key.subqueue_name} crashed unexpectedly"
+        Logger(get_current_span()).log_exception(
+            Exception(
+                f"worker {worker_key.profile_name}_{worker_key.subqueue_name} crashed unexpectedly"
+            )
         )
+        sys.exit(1)
 
     return hook
 

{uncountablepythonsdk-0.0.112 → uncountablepythonsdk-0.0.114}/uncountable/integration/scan_profiles.py

@@ -26,7 +26,7 @@ def load_profiles() -> list[job_definition_t.ProfileMetadata]:
         profile_name = profile_file.name
         try:
             definition = profile_parser.parse_yaml_resource(
-                package=".".join([profiles_module, profile_name]),
+                package=f"{profiles_module}.{profile_name}",
                 resource="profile.yaml",
             )
             for job in definition.jobs:

{uncountablepythonsdk-0.0.112 → uncountablepythonsdk-0.0.114}/uncountable/integration/secret_retrieval/retrieve_secret.py

@@ -54,7 +54,7 @@ def _load_secret_overrides(profile_name: str) -> dict[SecretRetrieval, str]:
     profiles_module = os.environ["UNC_PROFILES_MODULE"]
     try:
         overrides = overrides_parser.parse_yaml_resource(
-            package=".".join([profiles_module, profile_name]),
+            package=f"{profiles_module}.{profile_name}",
             resource="local_overrides.yaml",
         )
         return {

{uncountablepythonsdk-0.0.112 → uncountablepythonsdk-0.0.114}/uncountable/types/__init__.py

@@ -21,6 +21,7 @@ from .api.chemical import convert_chemical_formats as convert_chemical_formats_t
 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_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
@@ -34,6 +35,8 @@ from . import entity_t as entity_t
 from .api.batch import execute_batch as execute_batch_t
 from .api.batch import execute_batch_load_async as execute_batch_load_async_t
 from . import experiment_groups_t as experiment_groups_t
+from .api.entity import export_entities as export_entities_t
+from . import exports_t as exports_t
 from . import field_values_t as field_values_t
 from . import fields_t as fields_t
 from . import generic_upload_t as generic_upload_t
@@ -135,6 +138,7 @@ __all__: list[str] = [
     "create_entities_t",
     "create_entity_t",
     "create_inputs_t",
+    "create_mix_order_t",
     "create_or_update_entity_t",
     "create_recipe_t",
     "create_recipe_link_t",
@@ -148,6 +152,8 @@ __all__: list[str] = [
     "execute_batch_t",
     "execute_batch_load_async_t",
     "experiment_groups_t",
+    "export_entities_t",
+    "exports_t",
     "field_values_t",
     "fields_t",
     "generic_upload_t",

uncountablepythonsdk-0.0.114/uncountable/types/api/entity/export_entities.py

@@ -0,0 +1,46 @@
+# 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 base_t
+from ... import exports_t
+from ... import identifier_t
+
+__all__: list[str] = [
+    "Arguments",
+    "Data",
+    "ENDPOINT_METHOD",
+    "ENDPOINT_PATH",
+]
+
+ENDPOINT_METHOD = "POST"
+ENDPOINT_PATH = "api/external/entity/export_entities"
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@serial_class(
+    named_type_path="sdk.api.entity.export_entities.Arguments",
+)
+@dataclasses.dataclass(slots=base_t.ENABLE_SLOTS, kw_only=True)  # type: ignore[literal-required]
+class Arguments:
+    config_key: identifier_t.IdentifierKey
+    type: exports_t.ExportType = exports_t.ExportType.EXCEL
+    client_timezone: exports_t.ListingExportUserTimezone | None = None
+    limit: int | None = None
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@serial_class(
+    named_type_path="sdk.api.entity.export_entities.Data",
+)
+@dataclasses.dataclass(slots=base_t.ENABLE_SLOTS, kw_only=True)  # type: ignore[literal-required]
+class Data(async_batch_t.AsyncBatchActionReturn):
+    pass
+# DO NOT MODIFY -- This file is generated by type_spec

uncountablepythonsdk-0.0.114/uncountable/types/api/recipes/create_mix_order.py

@@ -0,0 +1,44 @@
+# 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 base_t
+from ... import identifier_t
+from ... import recipe_workflow_steps_t
+
+__all__: list[str] = [
+    "Arguments",
+    "Data",
+    "ENDPOINT_METHOD",
+    "ENDPOINT_PATH",
+]
+
+ENDPOINT_METHOD = "POST"
+ENDPOINT_PATH = "api/external/recipes/create_mix_order"
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@serial_class(
+    named_type_path="sdk.api.recipes.create_mix_order.Arguments",
+)
+@dataclasses.dataclass(slots=base_t.ENABLE_SLOTS, kw_only=True)  # type: ignore[literal-required]
+class Arguments:
+    recipe_key: identifier_t.IdentifierKey
+    recipe_workflow_step_identifier: recipe_workflow_steps_t.RecipeWorkflowStepIdentifier
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@serial_class(
+    named_type_path="sdk.api.recipes.create_mix_order.Data",
+)
+@dataclasses.dataclass(slots=base_t.ENABLE_SLOTS, kw_only=True)  # type: ignore[literal-required]
+class Data(async_batch_t.AsyncBatchActionReturn):
+    pass
+# DO NOT MODIFY -- This file is generated by type_spec

{uncountablepythonsdk-0.0.112 → uncountablepythonsdk-0.0.114}/uncountable/types/api/recipes/set_recipe_outputs.py

@@ -60,7 +60,8 @@ class RecipeOutputValue:
     value_numeric: Decimal | None = None
     value_str: str | None = None
     value_curve: CurveValues | None = None
-    value_color: data_t.RecipeOutputColor | None = None
+    value_color: data_t.SupportedColorFormatColor | None = None
+    value_ingredient_id: base_t.ObjectId | None = None
     formatting: recipes_t.RecipeAttributeFormatting | None = None
     field_values: list[field_values_t.ArgumentValueRefName | field_values_t.ArgumentValueId] | None = None
 

{uncountablepythonsdk-0.0.112 → uncountablepythonsdk-0.0.114}/uncountable/types/async_batch_processor.py

@@ -14,6 +14,7 @@ from uncountable.types import async_batch_t
 from uncountable.types import base_t
 import uncountable.types.api.recipes.clear_recipe_outputs as clear_recipe_outputs_t
 import uncountable.types.api.runsheet.complete_async_upload as complete_async_upload_t
+import uncountable.types.api.recipes.create_mix_order as create_mix_order_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.recipes.edit_recipe_inputs as edit_recipe_inputs_t
@@ -217,6 +218,39 @@ class AsyncBatchProcessorBase(ABC):
             batch_reference=req.batch_reference,
         )
 
+    def create_mix_order(
+        self,
+        *,
+        recipe_key: identifier_t.IdentifierKey,
+        recipe_workflow_step_identifier: recipe_workflow_steps_t.RecipeWorkflowStepIdentifier,
+        depends_on: list[str] | None = None,
+    ) -> async_batch_t.QueuedAsyncBatchRequest:
+        """Creates mix order on a recipe workflow step
+
+        :param depends_on: A list of batch reference keys to process before processing this request
+        """
+        args = create_mix_order_t.Arguments(
+            recipe_key=recipe_key,
+            recipe_workflow_step_identifier=recipe_workflow_step_identifier,
+        )
+        json_data = serialize_for_api(args)
+
+        batch_reference = str(uuid.uuid4())
+
+        req = async_batch_t.AsyncBatchRequest(
+            path=async_batch_t.AsyncBatchRequestPath.CREATE_MIX_ORDER,
+            data=json_data,
+            depends_on=depends_on,
+            batch_reference=batch_reference,
+        )
+
+        self._enqueue(req)
+
+        return async_batch_t.QueuedAsyncBatchRequest(
+            path=req.path,
+            batch_reference=req.batch_reference,
+        )
+
     def create_or_update_entity(
         self,
         *,

{uncountablepythonsdk-0.0.112 → uncountablepythonsdk-0.0.114}/uncountable/types/async_batch_t.py

@@ -44,6 +44,7 @@ class AsyncBatchRequestPath(StrEnum):
     CREATE_RECIPE_LINK = "recipe_links/create_recipe_link"
     UPSERT_CONDITION_MATCH = "condition_parameters/upsert_condition_match"
     COMPLETE_ASYNC_UPLOAD = "runsheet/complete_async_upload"
+    CREATE_MIX_ORDER = "recipes/create_mix_order"
 
 
 # DO NOT MODIFY -- This file is generated by type_spec

{uncountablepythonsdk-0.0.112 → uncountablepythonsdk-0.0.114}/uncountable/types/base_t.py

@@ -74,16 +74,13 @@ def is_pure_json_value(value: ExtJsonValue) -> bool:
         return True
 
     if isinstance(value, list):
-        for item in value:
-            if not is_pure_json_value(item):
-                return False
-        return True
+        return all(is_pure_json_value(item) for item in value)
 
     if isinstance(value, dict):
-        for key, item in value.items():
-            if not is_pure_json_value(key) or not is_pure_json_value(item):
-                return False
-        return True
+        return all(
+            is_pure_json_value(key) and is_pure_json_value(item)
+            for key, item in value.items()
+        )
 
     return False
 # === END section from base.prepart.py ===

{uncountablepythonsdk-0.0.112 → uncountablepythonsdk-0.0.114}/uncountable/types/data.py

@@ -3,10 +3,10 @@
 # isort: skip_file
 # DO NOT MODIFY -- This file is generated by type_spec
 # Kept only for SDK backwards compatibility
+from .data_t import ColorFormat as ColorFormat
 from .data_t import RgbColor as RgbColor
 from .data_t import CielabColor as CielabColor
 from .data_t import XyzColor as XyzColor
 from .data_t import LChColor as LChColor
-from .data_t import HslColor as HslColor
-from .data_t import RecipeOutputColor as RecipeOutputColor
+from .data_t import SupportedColorFormatColor as SupportedColorFormatColor
 # DO NOT MODIFY -- This file is generated by type_spec