UncountablePythonSDK 0.0.129__tar.gz → 0.0.130__tar.gz

{uncountablepythonsdk-0.0.129 → uncountablepythonsdk-0.0.130}/PKG-INFO

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

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

@@ -208,6 +208,8 @@ uncountable/types/integrations.py
 uncountable/types/integrations_t.py
 uncountable/types/job_definition.py
 uncountable/types/job_definition_t.py
+uncountable/types/listing.py
+uncountable/types/listing_t.py
 uncountable/types/notifications.py
 uncountable/types/notifications_t.py
 uncountable/types/outputs.py
@@ -244,6 +246,8 @@ uncountable/types/secret_retrieval.py
 uncountable/types/secret_retrieval_t.py
 uncountable/types/sockets.py
 uncountable/types/sockets_t.py
+uncountable/types/structured_filters.py
+uncountable/types/structured_filters_t.py
 uncountable/types/units.py
 uncountable/types/units_t.py
 uncountable/types/uploader.py
@@ -304,6 +308,8 @@ uncountable/types/api/integrations/push_notification.py
 uncountable/types/api/integrations/register_sockets_token.py
 uncountable/types/api/material_families/__init__.py
 uncountable/types/api/material_families/update_entity_material_families.py
+uncountable/types/api/notebooks/__init__.py
+uncountable/types/api/notebooks/add_notebook_content.py
 uncountable/types/api/outputs/__init__.py
 uncountable/types/api/outputs/get_output_data.py
 uncountable/types/api/outputs/get_output_names.py

{uncountablepythonsdk-0.0.129 → uncountablepythonsdk-0.0.130}/docs/requirements.txt

@@ -1,4 +1,4 @@
-furo==2025.7.19
+furo==2025.9.25
 myst-parser==4.0.1
 sphinx-autoapi==3.6.0
 sphinx-copybutton==0.5.2

{uncountablepythonsdk-0.0.129 → uncountablepythonsdk-0.0.130}/examples/integration-server/jobs/materials_auto/example_parse.py

@@ -23,9 +23,40 @@ class ParseExample(WebhookJob[ParsePayload]):
     def run(
         self, args: JobArguments, payload: ParsePayload
     ) -> job_definition_t.JobResult:
+        user_id: base_t.ObjectId | None = None
+        recipe_id: base_t.ObjectId | None = None
+        file_name: str | None = None
+        data = args.client.get_entities_data(
+            entity_ids=[payload.async_job_id], entity_type=entity_t.EntityType.ASYNC_JOB
+        )
+        for field_value in data.entity_details[0].field_values:
+            if field_value.field_ref_name == "core_async_job_jobData":
+                assert isinstance(field_value.value, dict)
+                assert isinstance(field_value.value["user_id"], int)
+                user_id = field_value.value["user_id"]
+            elif (
+                field_value.field_ref_name
+                == "unc_async_job_custom_parser_recipe_ids_in_view"
+            ):
+                if field_value.value is None:
+                    continue
+                assert isinstance(field_value.value, list)
+                if len(field_value.value) > 0:
+                    assert isinstance(field_value.value[0], int)
+                    recipe_id = field_value.value[0]
+            elif field_value.field_ref_name == "unc_async_job_custom_parser_input_file":
+                assert isinstance(field_value.value, list)
+                assert len(field_value.value) == 1
+                assert isinstance(field_value.value[0], dict)
+                assert isinstance(field_value.value[0]["name"], str)
+                file_name = field_value.value[0]["name"]
+
+        assert user_id is not None
+        assert file_name is not None
+
         dummy_parsed_file_data: list[uploader_t.ParsedFileData] = [
             uploader_t.ParsedFileData(
-                file_name="my_file_to_upload.xlsx",
+                file_name=file_name,
                 file_structures=[
                     uploader_t.DataChannel(
                         type=uploader_t.StructureElementType.CHANNEL,
@@ -82,32 +113,11 @@ class ParseExample(WebhookJob[ParsePayload]):
             )
         ]
 
-        user_id: base_t.ObjectId | None = None
-        recipe_id: base_t.ObjectId | None = None
-        data = args.client.get_entities_data(
-            entity_ids=[payload.async_job_id], entity_type=entity_t.EntityType.ASYNC_JOB
-        )
-        for field_value in data.entity_details[0].field_values:
-            if field_value.field_ref_name == "core_async_job_jobData":
-                assert isinstance(field_value.value, dict)
-                assert isinstance(field_value.value["user_id"], int)
-                user_id = field_value.value["user_id"]
-            if (
-                field_value.field_ref_name
-                == "unc_async_job_custom_parser_recipe_ids_in_view"
-            ):
-                assert isinstance(field_value.value, list)
-                assert isinstance(field_value.value[0], int)
-                recipe_id = field_value.value[0]
-
-        assert user_id is not None
-        assert recipe_id is not None
-
         complete_async_parse_req = args.batch_processor.complete_async_parse(
             parsed_file_data=dummy_parsed_file_data,
             async_job_key=identifier_t.IdentifierKeyId(id=payload.async_job_id),
             upload_destination=generic_upload_t.UploadDestinationRecipe(
-                recipe_key=identifier_t.IdentifierKeyId(id=recipe_id)
+                recipe_key=identifier_t.IdentifierKeyId(id=recipe_id or 1)
             ),
         )
 

uncountablepythonsdk-0.0.130/examples/integration-server/jobs/materials_auto/example_runsheet_wh.py

@@ -0,0 +1,39 @@
+from io import BytesIO
+
+from uncountable.core.file_upload import DataFileUpload, FileUpload
+from uncountable.integration.job import JobArguments, RunsheetWebhookJob, register_job
+from uncountable.types import (
+    download_file_t,
+    entity_t,
+    identifier_t,
+    webhook_job_t,
+)
+
+
+@register_job
+class StandardRunsheetGenerator(RunsheetWebhookJob):
+    def build_runsheet(
+        self,
+        *,
+        args: JobArguments,
+        payload: webhook_job_t.RunsheetWebhookPayload,
+    ) -> FileUpload:
+        args.logger.log_info("Retrieving pre-exported runsheet file from async job")
+
+        file_query = download_file_t.FileDownloadQueryEntityField(
+            entity=entity_t.EntityIdentifier(
+                type=entity_t.EntityType.ASYNC_JOB,
+                identifier_key=identifier_t.IdentifierKeyId(id=payload.async_job_id),
+            ),
+            field_key=identifier_t.IdentifierKeyRefName(
+                ref_name="unc_async_job_export_runsheet_recipe_export"
+            ),
+        )
+
+        downloaded_files = args.client.download_files(file_query=file_query)
+
+        file_data = downloaded_files[0].data.read()
+        return DataFileUpload(
+            data=BytesIO(file_data),
+            name=downloaded_files[0].name,
+        )

{uncountablepythonsdk-0.0.129 → uncountablepythonsdk-0.0.130}/pkgs/argument_parser/argument_parser.py

@@ -168,6 +168,23 @@ def _invoke_membership_parser(
     raise ValueError(f"Expected value from {expected_values} but got value {value}")
 
 
+# Uses `is` to compare
+def _build_identity_parser(
+    identity_value: T,
+) -> ParserFunction[T]:
+    def parse(value: typing.Any) -> T:
+        if value is identity_value:
+            return identity_value
+        raise ValueError(
+            f"Expected value {identity_value} (type: {type(identity_value)}) but got value {value} (type: {type(value)})"
+        )
+
+    return parse
+
+
+NONE_IDENTITY_PARSER = _build_identity_parser(None)
+
+
 def _build_parser_discriminated_union(
     context: ParserContext,
     discriminator_raw: str,
@@ -243,8 +260,10 @@ def _build_parser_inner(
             for field_name, field_parser in field_parsers
         })
 
+    # IMPROVE: unclear why we need == here
     if parsed_type == type(None):  # noqa: E721
-        return lambda value: _invoke_membership_parser({None}, value)
+        # Need to convince type checker that parsed_type is type(None)
+        return typing.cast(ParserFunction[T], NONE_IDENTITY_PARSER)
 
     origin = typing.get_origin(parsed_type)
     if origin is tuple:

{uncountablepythonsdk-0.0.129 → uncountablepythonsdk-0.0.130}/pkgs/type_spec/parts/base.ts.prepart

@@ -29,3 +29,6 @@ export const IOJsonValue: IO.Type<JsonValue> = IO.recursion('JsonValue', () =>
 export interface nominal<T> {
   "nominal structural brand": T
 }
+
+// Ids matching a strict integer number are converted to integers
+export const ID_REGEX = /-?[1-9][0-9]{0,20}/

{uncountablepythonsdk-0.0.129 → uncountablepythonsdk-0.0.130}/uncountable/types/__init__.py

@@ -2,6 +2,7 @@
 # ruff: noqa: E402 Q003
 # fmt: off
 # isort: skip_file
+from .api.notebooks import add_notebook_content as add_notebook_content_t
 from .api.recipes import add_recipe_to_project as add_recipe_to_project_t
 from .api.recipes import add_time_series_data as add_time_series_data_t
 from .api.recipes import archive_recipes as archive_recipes_t
@@ -73,6 +74,7 @@ from . import job_definition_t as job_definition_t
 from .api.entity import list_aggregate as list_aggregate_t
 from .api.entity import list_entities as list_entities_t
 from .api.id_source import list_id_source as list_id_source_t
+from . import listing_t as listing_t
 from .api.entity import lock_entity as lock_entity_t
 from .api.recipes import lock_recipes as lock_recipes_t
 from .api.entity import lookup_entity as lookup_entity_t
@@ -117,6 +119,7 @@ from .api.recipes import set_recipe_tags as set_recipe_tags_t
 from .api.recipes import set_recipe_total as set_recipe_total_t
 from .api.entity import set_values as set_values_t
 from . import sockets_t as sockets_t
+from . import structured_filters_t as structured_filters_t
 from .api.entity import transition_entity_phase as transition_entity_phase_t
 from .api.recipes import unarchive_recipes as unarchive_recipes_t
 from . import units_t as units_t
@@ -132,6 +135,7 @@ from . import workflows_t as workflows_t
 
 
 __all__: list[str] = [
+    "add_notebook_content_t",
     "add_recipe_to_project_t",
     "add_time_series_data_t",
     "archive_recipes_t",
@@ -203,6 +207,7 @@ __all__: list[str] = [
     "list_aggregate_t",
     "list_entities_t",
     "list_id_source_t",
+    "listing_t",
     "lock_entity_t",
     "lock_recipes_t",
     "lookup_entity_t",
@@ -247,6 +252,7 @@ __all__: list[str] = [
     "set_recipe_total_t",
     "set_values_t",
     "sockets_t",
+    "structured_filters_t",
     "transition_entity_phase_t",
     "unarchive_recipes_t",
     "units_t",

uncountablepythonsdk-0.0.130/uncountable/types/api/notebooks/add_notebook_content.py

@@ -0,0 +1,119 @@
+# 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
+from enum import StrEnum
+import dataclasses
+from pkgs.serialization import serial_class
+from pkgs.serialization import serial_union_annotation
+from pkgs.serialization import serial_string_enum
+from ... import base_t
+from ... import identifier_t
+
+__all__: list[str] = [
+    "Arguments",
+    "Data",
+    "ENDPOINT_METHOD",
+    "ENDPOINT_PATH",
+    "InputContent",
+    "InputContentTextMarkdown",
+    "InputContentType",
+    "Location",
+    "LocationAppendToFirstPage",
+    "LocationType",
+]
+
+ENDPOINT_METHOD = "POST"
+ENDPOINT_PATH = "api/external/notebooks/add_notebook_content"
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@serial_string_enum(
+    labels={
+        "append_to_first_page": "Append To First Page",
+    },
+)
+class LocationType(StrEnum):
+    APPEND_TO_FIRST_PAGE = "append_to_first_page"
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@serial_class(
+    named_type_path="sdk.api.notebooks.add_notebook_content.LocationAppendToFirstPage",
+    parse_require={"type"},
+)
+@dataclasses.dataclass(slots=base_t.ENABLE_SLOTS, kw_only=True)  # type: ignore[literal-required]
+class LocationAppendToFirstPage:
+    type: typing.Literal[LocationType.APPEND_TO_FIRST_PAGE] = LocationType.APPEND_TO_FIRST_PAGE
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+Location = typing.Annotated[
+    typing.Union[LocationAppendToFirstPage],
+    serial_union_annotation(
+    named_type_path="sdk.api.notebooks.add_notebook_content.Location",
+        discriminator="type",
+        discriminator_map={
+            "append_to_first_page": LocationAppendToFirstPage,
+        },
+    ),
+]
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@serial_string_enum(
+    labels={
+        "text_markdown": "Text Markdown",
+    },
+)
+class InputContentType(StrEnum):
+    TEXT_MARKDOWN = "text_markdown"
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@serial_class(
+    named_type_path="sdk.api.notebooks.add_notebook_content.InputContentTextMarkdown",
+    parse_require={"type"},
+)
+@dataclasses.dataclass(slots=base_t.ENABLE_SLOTS, kw_only=True)  # type: ignore[literal-required]
+class InputContentTextMarkdown:
+    type: typing.Literal[InputContentType.TEXT_MARKDOWN] = InputContentType.TEXT_MARKDOWN
+    text_markdown: str
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+InputContent = typing.Annotated[
+    typing.Union[InputContentTextMarkdown],
+    serial_union_annotation(
+    named_type_path="sdk.api.notebooks.add_notebook_content.InputContent",
+        discriminator="type",
+        discriminator_map={
+            "text_markdown": InputContentTextMarkdown,
+        },
+    ),
+]
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@serial_class(
+    named_type_path="sdk.api.notebooks.add_notebook_content.Arguments",
+)
+@dataclasses.dataclass(slots=base_t.ENABLE_SLOTS, kw_only=True)  # type: ignore[literal-required]
+class Arguments:
+    notebook_key: identifier_t.IdentifierKey
+    location: Location
+    contents: list[InputContent]
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@serial_class(
+    named_type_path="sdk.api.notebooks.add_notebook_content.Data",
+)
+@dataclasses.dataclass(slots=base_t.ENABLE_SLOTS, kw_only=True)  # type: ignore[literal-required]
+class Data:
+    pass
+# DO NOT MODIFY -- This file is generated by type_spec

uncountablepythonsdk-0.0.130/uncountable/types/api/user/__init__.py

@@ -0,0 +1 @@
+# DO NOT MODIFY -- This file is generated by type_spec

{uncountablepythonsdk-0.0.129 → uncountablepythonsdk-0.0.130}/uncountable/types/client_base.py

@@ -8,6 +8,7 @@ import typing  # noqa: F401
 import datetime  # noqa: F401
 from decimal import Decimal  # noqa: F401
 from pkgs.serialization import OpaqueKey
+import uncountable.types.api.notebooks.add_notebook_content as add_notebook_content_t
 import uncountable.types.api.recipes.add_recipe_to_project as add_recipe_to_project_t
 import uncountable.types.api.recipes.add_time_series_data as add_time_series_data_t
 import uncountable.types.api.recipes.archive_recipes as archive_recipes_t
@@ -124,6 +125,33 @@ class ClientMethods(ABC):
     def do_request(self, *, api_request: APIRequest, return_type: type[DT]) -> DT:
         ...
 
+    def add_notebook_content(
+        self,
+        *,
+        notebook_key: identifier_t.IdentifierKey,
+        location: add_notebook_content_t.Location,
+        contents: list[add_notebook_content_t.InputContent],
+        _request_options: client_config_t.RequestOptions | None = None,
+    ) -> add_notebook_content_t.Data:
+        """Adds content to an existing notebook
+
+        :param notebook_key: Key of the notebook to add the content to
+        :param location: The location to add the content to in the notebook
+        :param contents: List of input content to add to the notebook
+        """
+        args = add_notebook_content_t.Arguments(
+            notebook_key=notebook_key,
+            location=location,
+            contents=contents,
+        )
+        api_request = APIRequest(
+            method=add_notebook_content_t.ENDPOINT_METHOD,
+            endpoint=add_notebook_content_t.ENDPOINT_PATH,
+            args=args,
+            request_options=_request_options,
+        )
+        return self.do_request(api_request=api_request, return_type=add_notebook_content_t.Data)
+
     def add_recipe_to_project(
         self,
         *,

{uncountablepythonsdk-0.0.129 → uncountablepythonsdk-0.0.130}/uncountable/types/integration_server_t.py

@@ -26,6 +26,8 @@ class IntegrationEnvironment(StrEnum):
     DEV = "dev"
     TEST = "test"
     PROD = "prod"
+    STG = "stg"
+    SBX = "sbx"
 
 
 # DO NOT MODIFY -- This file is generated by type_spec

uncountablepythonsdk-0.0.130/uncountable/types/listing.py

@@ -0,0 +1,9 @@
+# ruff: noqa: E402 Q003
+# fmt: off
+# isort: skip_file
+# DO NOT MODIFY -- This file is generated by type_spec
+# Kept only for SDK backwards compatibility
+from .listing_t import ColumnType as ColumnType
+from .listing_t import ColumnIdentifierEntityRefName as ColumnIdentifierEntityRefName
+from .listing_t import ColumnIdentifier as ColumnIdentifier
+# DO NOT MODIFY -- This file is generated by type_spec

uncountablepythonsdk-0.0.130/uncountable/types/listing_t.py

@@ -0,0 +1,51 @@
+# 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
+from enum import StrEnum
+import dataclasses
+from pkgs.serialization import serial_class
+from pkgs.serialization import serial_union_annotation
+from . import base_t
+from . import entity_t
+
+__all__: list[str] = [
+    "ColumnIdentifier",
+    "ColumnIdentifierEntityRefName",
+    "ColumnType",
+]
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+class ColumnType(StrEnum):
+    REF_NAME = "ref_name"
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@serial_class(
+    named_type_path="sdk.listing.ColumnIdentifierEntityRefName",
+    parse_require={"type"},
+)
+@dataclasses.dataclass(slots=base_t.ENABLE_SLOTS, kw_only=True, frozen=True, eq=True)  # type: ignore[literal-required]
+class ColumnIdentifierEntityRefName:
+    type: typing.Literal[ColumnType.REF_NAME] = ColumnType.REF_NAME
+    entity_type: entity_t.EntityType
+    ref_name: str
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+ColumnIdentifier = typing.Annotated[
+    typing.Union[ColumnIdentifierEntityRefName],
+    serial_union_annotation(
+    named_type_path="sdk.listing.ColumnIdentifier",
+        discriminator="type",
+        discriminator_map={
+            "ref_name": ColumnIdentifierEntityRefName,
+        },
+    ),
+]
+# DO NOT MODIFY -- This file is generated by type_spec

uncountablepythonsdk-0.0.130/uncountable/types/structured_filters.py

@@ -0,0 +1,21 @@
+# ruff: noqa: E402 Q003
+# fmt: off
+# isort: skip_file
+# DO NOT MODIFY -- This file is generated by type_spec
+# Kept only for SDK backwards compatibility
+from .structured_filters_t import FilterRelation as FilterRelation
+from .structured_filters_t import FilterSpecBase as FilterSpecBase
+from .structured_filters_t import FilterScalarType as FilterScalarType
+from .structured_filters_t import FilterIdType as FilterIdType
+from .structured_filters_t import StringFilterValue as StringFilterValue
+from .structured_filters_t import FilterSpecEquals as FilterSpecEquals
+from .structured_filters_t import FilterSpecInclude as FilterSpecInclude
+from .structured_filters_t import FilterSpecIStrContains as FilterSpecIStrContains
+from .structured_filters_t import FilterSpecIStrStartsWith as FilterSpecIStrStartsWith
+from .structured_filters_t import FilterSpecExists as FilterSpecExists
+from .structured_filters_t import FilterSpecGreater as FilterSpecGreater
+from .structured_filters_t import FilterLess as FilterLess
+from .structured_filters_t import FilterSpecGeq as FilterSpecGeq
+from .structured_filters_t import FilterSpecLeq as FilterSpecLeq
+from .structured_filters_t import FilterSpec as FilterSpec
+# DO NOT MODIFY -- This file is generated by type_spec