UncountablePythonSDK 0.0.20__tar.gz → 0.0.22__tar.gz

{uncountablepythonsdk-0.0.20/UncountablePythonSDK.egg-info → uncountablepythonsdk-0.0.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: UncountablePythonSDK
-Version: 0.0.20
+Version: 0.0.22
 Summary: Uncountable SDK
 Project-URL: Homepage, https://github.com/uncountableinc/uncountable-python-sdk
 Project-URL: Repository, https://github.com/uncountableinc/uncountable-python-sdk.git
@@ -16,6 +16,8 @@ Classifier: Topic :: Utilities
 Classifier: Typing :: Typed
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
+Requires-Dist: aiotus==0.1.15
+Requires-Dist: aiohttp==3.9.5
 Requires-Dist: requests==2.31.0
 Requires-Dist: SQLAlchemy==1.4.52
 Requires-Dist: APScheduler==3.10.4

{uncountablepythonsdk-0.0.20 → uncountablepythonsdk-0.0.22/UncountablePythonSDK.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: UncountablePythonSDK
-Version: 0.0.20
+Version: 0.0.22
 Summary: Uncountable SDK
 Project-URL: Homepage, https://github.com/uncountableinc/uncountable-python-sdk
 Project-URL: Repository, https://github.com/uncountableinc/uncountable-python-sdk.git
@@ -16,6 +16,8 @@ Classifier: Topic :: Utilities
 Classifier: Typing :: Typed
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
+Requires-Dist: aiotus==0.1.15
+Requires-Dist: aiohttp==3.9.5
 Requires-Dist: requests==2.31.0
 Requires-Dist: SQLAlchemy==1.4.52
 Requires-Dist: APScheduler==3.10.4

{uncountablepythonsdk-0.0.20 → uncountablepythonsdk-0.0.22}/UncountablePythonSDK.egg-info/SOURCES.txt

@@ -24,7 +24,9 @@ docs/static/favicons/favicon-32x32.png
 docs/static/favicons/manifest.json
 docs/static/favicons/mstile-150x150.png
 docs/static/favicons/safari-pinned-tab.svg
+examples/async_batch.py
 examples/create_entity.py
+examples/upload_files.py
 examples/recipe-import/importer.py
 pkgs/__init__.py
 pkgs/argument_parser/__init__.py
@@ -76,6 +78,7 @@ type_spec/external/api/entity/get_entities_data.yaml
 type_spec/external/api/entity/list_entities.yaml
 type_spec/external/api/entity/resolve_entity_ids.yaml
 type_spec/external/api/entity/set_values.yaml
+type_spec/external/api/entity/transition_entity_phase.yaml
 type_spec/external/api/id_source/list_id_source.yaml
 type_spec/external/api/id_source/match_id_source.yaml
 type_spec/external/api/input_groups/get_input_group_names.yaml
@@ -87,6 +90,7 @@ type_spec/external/api/inputs/set_input_attribute_values.yaml
 type_spec/external/api/outputs/get_output_data.yaml
 type_spec/external/api/outputs/get_output_names.yaml
 type_spec/external/api/outputs/resolve_output_conditions.yaml
+type_spec/external/api/permissions/set_core_permissions.yaml
 type_spec/external/api/project/get_projects.yaml
 type_spec/external/api/project/get_projects_data.yaml
 type_spec/external/api/recipe_links/create_recipe_link.yaml
@@ -95,6 +99,8 @@ type_spec/external/api/recipes/associate_recipe_as_input.yaml
 type_spec/external/api/recipes/associate_recipe_as_lot.yaml
 type_spec/external/api/recipes/create_recipe.yaml
 type_spec/external/api/recipes/create_recipes.yaml
+type_spec/external/api/recipes/disassociate_recipe_as_input.yaml
+type_spec/external/api/recipes/edit_recipe_inputs.yaml
 type_spec/external/api/recipes/get_curve.yaml
 type_spec/external/api/recipes/get_recipe_calculations.yaml
 type_spec/external/api/recipes/get_recipe_links.yaml
@@ -104,11 +110,15 @@ type_spec/external/api/recipes/get_recipes_data.yaml
 type_spec/external/api/recipes/set_recipe_inputs.yaml
 type_spec/external/api/recipes/set_recipe_metadata.yaml
 type_spec/external/api/recipes/set_recipe_outputs.yaml
+type_spec/external/api/recipes/set_recipe_tags.yaml
 type_spec/external/api/triggers/run_trigger.yaml
 uncountable/__init__.py
 uncountable/py.typed
 uncountable/core/__init__.py
+uncountable/core/async_batch.py
 uncountable/core/client.py
+uncountable/core/file_upload.py
+uncountable/core/types.py
 uncountable/integration/__init__.py
 uncountable/integration/construct_client.py
 uncountable/integration/cron.py
@@ -122,6 +132,7 @@ uncountable/integration/executors/__init__.py
 uncountable/integration/executors/script_executor.py
 uncountable/types/__init__.py
 uncountable/types/async_batch.py
+uncountable/types/async_batch_processor.py
 uncountable/types/base.py
 uncountable/types/calculations.py
 uncountable/types/chemical_structure.py
@@ -136,12 +147,16 @@ uncountable/types/identifier.py
 uncountable/types/input_attributes.py
 uncountable/types/inputs.py
 uncountable/types/outputs.py
+uncountable/types/permissions.py
 uncountable/types/phases.py
+uncountable/types/post_base.py
 uncountable/types/recipe_identifiers.py
+uncountable/types/recipe_inputs.py
 uncountable/types/recipe_links.py
 uncountable/types/recipe_metadata.py
 uncountable/types/recipe_output_metadata.py
 uncountable/types/recipe_tags.py
+uncountable/types/recipe_workflow_steps.py
 uncountable/types/response.py
 uncountable/types/units.py
 uncountable/types/users.py
@@ -159,6 +174,7 @@ uncountable/types/api/entity/get_entities_data.py
 uncountable/types/api/entity/list_entities.py
 uncountable/types/api/entity/resolve_entity_ids.py
 uncountable/types/api/entity/set_values.py
+uncountable/types/api/entity/transition_entity_phase.py
 uncountable/types/api/id_source/__init__.py
 uncountable/types/api/id_source/list_id_source.py
 uncountable/types/api/id_source/match_id_source.py
@@ -174,6 +190,8 @@ uncountable/types/api/outputs/__init__.py
 uncountable/types/api/outputs/get_output_data.py
 uncountable/types/api/outputs/get_output_names.py
 uncountable/types/api/outputs/resolve_output_conditions.py
+uncountable/types/api/permissions/__init__.py
+uncountable/types/api/permissions/set_core_permissions.py
 uncountable/types/api/project/__init__.py
 uncountable/types/api/project/get_projects.py
 uncountable/types/api/project/get_projects_data.py
@@ -186,6 +204,8 @@ uncountable/types/api/recipes/associate_recipe_as_input.py
 uncountable/types/api/recipes/associate_recipe_as_lot.py
 uncountable/types/api/recipes/create_recipe.py
 uncountable/types/api/recipes/create_recipes.py
+uncountable/types/api/recipes/disassociate_recipe_as_input.py
+uncountable/types/api/recipes/edit_recipe_inputs.py
 uncountable/types/api/recipes/get_curve.py
 uncountable/types/api/recipes/get_recipe_calculations.py
 uncountable/types/api/recipes/get_recipe_links.py
@@ -195,5 +215,6 @@ uncountable/types/api/recipes/get_recipes_data.py
 uncountable/types/api/recipes/set_recipe_inputs.py
 uncountable/types/api/recipes/set_recipe_metadata.py
 uncountable/types/api/recipes/set_recipe_outputs.py
+uncountable/types/api/recipes/set_recipe_tags.py
 uncountable/types/api/triggers/__init__.py
 uncountable/types/api/triggers/run_trigger.py

{uncountablepythonsdk-0.0.20 → uncountablepythonsdk-0.0.22}/UncountablePythonSDK.egg-info/requires.txt

@@ -1,3 +1,5 @@
+aiotus==0.1.15
+aiohttp==3.9.5
 requests==2.31.0
 SQLAlchemy==1.4.52
 APScheduler==3.10.4

uncountablepythonsdk-0.0.22/examples/async_batch.py

@@ -0,0 +1,36 @@
+from decimal import Decimal
+from uncountable.core import AuthDetailsApiKey, Client
+from uncountable.core import AsyncBatchProcessor
+from uncountable.types import (
+    recipe_metadata,
+)
+from uncountable.types.identifier import IdentifierKeyBatchReference
+from uncountable.types.recipe_identifiers import (
+    RecipeIdentifierEditableName,
+    RecipeIdentifiers,
+)
+
+
+client = Client(
+    base_url="https://app.uncountable.com",
+    auth_details=AuthDetailsApiKey(
+        api_id="X",
+        api_secret_key="X",
+    ),
+)
+batch_loader = AsyncBatchProcessor(client=client)
+recipe_identifiers: RecipeIdentifiers = []
+recipe_identifiers.append(
+    RecipeIdentifierEditableName(editable_name="My recipe from API")
+)
+req = batch_loader.create_recipe(
+    material_family_id=1, workflow_id=1, identifiers=recipe_identifiers
+)
+created_recipe_reference = req.batch_reference
+batch_loader.set_recipe_metadata(
+    recipe_key=IdentifierKeyBatchReference(reference=created_recipe_reference),
+    recipe_metadata=[
+        recipe_metadata.MetadataValue(metadata_id=7, value_numeric=Decimal(38))
+    ],
+)
+job_id = batch_loader.send()

uncountablepythonsdk-0.0.22/examples/upload_files.py

@@ -0,0 +1,19 @@
+import os
+from pprint import pprint
+
+from uncountable import AuthDetailsApiKey, Client, MediaFileUpload
+
+client = Client(
+    base_url="http://localhost:5000",
+    auth_details=AuthDetailsApiKey(
+        api_id=os.environ["UNC_API_ID"],
+        api_secret_key=os.environ["UNC_API_SECRET_KEY"],
+    ),
+)
+uploaded = client.upload_files(
+    file_uploads=[
+        MediaFileUpload(path="/my/file/path.doc"),
+        MediaFileUpload(path="/my/file/path2.doc"),
+    ]
+)
+pprint(uploaded)

{uncountablepythonsdk-0.0.20 → uncountablepythonsdk-0.0.22}/pkgs/type_spec/actions_registry/__main__.py

@@ -14,7 +14,7 @@ from pkgs.type_spec import builder
 from ...argument_parser import CachedParser
 from ..emit_typescript_util import ts_name
 from ..util import rewrite_file
-from .emit_typescript import emit_action_definitions
+from .emit_typescript import ActionDefinitionWithArgument, emit_action_definitions
 
 key_name = "name"
 key_icon = "icon"
@@ -61,11 +61,11 @@ def get_action_registry_files_info() -> list[ActionRegistryFileInfo]:
 
 def main() -> None:
     files_info = get_action_registry_files_info()
-    action_definitions: defaultdict[str, list[actions_registry_t.ActionDefinition]] = (
+    action_definitions: defaultdict[str, list[ActionDefinitionWithArgument]] = (
         defaultdict(list)
     )
-    all_action_definitions: list[actions_registry_t.ActionDefinition] = []
-
+    all_action_definitions: list[actions_registry_t.ActionDefinitionInternal] = []
+    action_definitions_with_arguments_list: list[ActionDefinitionWithArgument] = []
     for file_info in files_info:
         in_action_definitions = action_definition_parser.parse_yaml_file(
             file_info.filepath
@@ -79,29 +79,41 @@ def main() -> None:
                 modules.append(file_info.filename)
 
             module_str = "_".join(modules)
-            all_action_definitions.append(
-                actions_registry_t.ActionDefinition(
-                    name=definition.name,
-                    short_description=definition.short_description,
-                    description=definition.description,
-                    icon=definition.icon,
+            action_definition = actions_registry_t.ActionDefinitionInternal(
+                name=definition.name,
+                short_description=definition.short_description,
+                description=definition.description,
+                icon=definition.icon,
+                ref_name=ref_name,
+                module=actions_registry_t.ActionsRegistryModule(
+                    ts_name(module_str, name_case=builder.NameCase.convert)
+                ),
+                visibility_scope=[
+                    actions_registry_t.ActionDefinitionVisibilityScope(item)
+                    for item in definition.visibility_scope
+                ]
+                if definition.visibility_scope is not None
+                else None,
+            )
+            action_definitions_with_arguments_list.append(
+                ActionDefinitionWithArgument(
+                    module=module_str,
                     ref_name=ref_name,
-                    module=actions_registry_t.ActionsRegistryModule(
-                        ts_name(module_str, name_case=builder.NameCase.convert)
-                    ),
-                    visibility_scope=[
-                        actions_registry_t.ActionDefinitionVisibilityScope(item)
-                        for item in definition.visibility_scope
-                    ]
-                    if definition.visibility_scope is not None
-                    else None,
+                    arguments=definition.arguments,
+                    definition=action_definition,
                 )
             )
-    all_action_definitions = sorted(
-        all_action_definitions, key=lambda item: (item.module, item.ref_name)
+            all_action_definitions.append(action_definition)
+    action_definitions_with_arguments_list = sorted(
+        action_definitions_with_arguments_list,
+        key=lambda item: (item.module, item.ref_name),
     )
-    for action_definition in all_action_definitions:
-        action_definitions[action_definition.module].append(action_definition)
+
+    for action_definition_with_argument in action_definitions_with_arguments_list:
+        action_definitions[action_definition_with_argument.module].append(
+            action_definition_with_argument
+        )
+
     ts_content = emit_action_definitions(action_definitions)
     rewrite_file(
         "main/site/js/materials/base/actions_registry/action_definitions.tsx",

{uncountablepythonsdk-0.0.20 → uncountablepythonsdk-0.0.22}/pkgs/type_spec/actions_registry/emit_typescript.py

@@ -1,17 +1,34 @@
 import io
 from collections import defaultdict
+from dataclasses import dataclass
 
 from main.base.types import actions_registry_t
 
 from ...type_spec import builder
-from ..emit_typescript_util import INDENT, MODIFY_NOTICE, ts_name
+from ..emit_typescript_util import (
+    INDENT,
+    MODIFY_NOTICE,
+    resolve_namespace_ref,
+    ts_name,
+    ts_type_name,
+)
 from ..util import encode_common_string
 
 
-def _action_symbol_name(action_definition: actions_registry_t.ActionDefinition) -> str:
+def _action_symbol_name(
+    action_definition: actions_registry_t.ActionDefinitionInternal,
+) -> str:
     return f"{ts_name(action_definition.ref_name, name_case=builder.NameCase.convert)}"
 
 
+def _action_type_name(ref_name: str) -> str:
+    return f"{ts_type_name(ref_name)}"
+
+
+def _action_namespace_name(name: str) -> str:
+    return f"{resolve_namespace_ref(builder.SpecNamespace(name=name))}"
+
+
 def _action_module_name_base(module: str) -> str:
     return f"{ts_name(module, name_case=builder.NameCase.convert)}"
 
@@ -24,24 +41,54 @@ def _action_module_name(module: str) -> str:
     return f"ActionsRegistryT.ActionsRegistryModule.{_action_module_name_base(module)}"
 
 
+@dataclass(kw_only=True)
+class ActionDefinitionWithArgument:
+    module: str
+    ref_name: str
+    arguments: str | None
+    definition: actions_registry_t.ActionDefinitionInternal
+
+
+def _emit_imports(
+    action_definitions: defaultdict[str, list[ActionDefinitionWithArgument]],
+) -> str:
+    out = io.StringIO()
+    namespaces = set()
+    for definitions in action_definitions.values():
+        for definition in definitions:
+            if definition.arguments is not None:
+                argument_parts = definition.arguments.split(".")
+                namespace = argument_parts[0]
+                namespaces.add(namespace)
+    namespaces_to_import = ", ".join(
+        sorted([f"type {_action_namespace_name(item)}" for item in list(namespaces)])
+    )
+    out.write(
+        f'import {{ ActionsRegistryT, {namespaces_to_import} }} from "unc_mat/types"\n\n'
+    )
+    out.write(MODIFY_NOTICE)
+    return out.getvalue()
+
+
 def emit_action_definitions(
-    action_definitions: defaultdict[str, list[actions_registry_t.ActionDefinition]],
+    action_definitions: defaultdict[str, list[ActionDefinitionWithArgument]],
 ) -> str:
     out = io.StringIO()
     out.write(MODIFY_NOTICE)
     out.write("\n")
-    out.write('import { ActionsRegistryT } from "unc_mat/types"\n\n')
-    out.write(MODIFY_NOTICE)
+    out.write(_emit_imports(action_definitions))
     modules = []
     for key, values in action_definitions.items():
         out.write(MODIFY_NOTICE)
         modules.append(key)
         out.write(f"export const {_action_module_name_obj(key)} = {{\n")
-        for action_definition in values:
+        for item in values:
             out.write(MODIFY_NOTICE)
-            out.write(_emit_action_definition(action_definition, INDENT))
+            out.write(_emit_action_definition(item.definition, item.arguments, INDENT))
         out.write("}\n")
 
+    out.write(MODIFY_NOTICE)
+    out.write("\n")
     out.write(MODIFY_NOTICE)
     out.write("\n")
     out.write("export const actionDefinitions = {\n")
@@ -58,12 +105,27 @@ def emit_action_definitions(
     return out.getvalue()
 
 
+def _get_argument_type(arguments: str | None) -> str | None:
+    if arguments is None:
+        return None
+    argument_parts = arguments.split(".")
+    namespace = argument_parts[0]
+    type_name = argument_parts[1]
+    if namespace is not None and type_name is not None:
+        return f"{_action_namespace_name(namespace)}.{type_name}"
+    return None
+
+
 def _emit_action_definition(
-    action_definition: actions_registry_t.ActionDefinition, indent: str
+    action_definition: actions_registry_t.ActionDefinitionInternal,
+    arguments: str | None,
+    indent: str,
 ) -> str:
     out = io.StringIO()
 
     sub_indent = indent + INDENT
+    argument_type = _get_argument_type(arguments)
+    argument_type = f"<{argument_type}>" if argument_type is not None else ""
     out.write(f"{indent}{_action_symbol_name(action_definition)}: {{\n")
     out.write(f"{sub_indent}name: {encode_common_string(action_definition.name)},\n")
     if action_definition.icon is not None:
@@ -85,7 +147,7 @@ def _emit_action_definition(
         out.write(
             f"{sub_indent}visibilityScope: {_emit_visibility_scope(action_definition.visibility_scope)},\n"
         )
-    out.write(f"{indent}}},\n")
+    out.write(f"{indent}}} as ActionsRegistryT.ActionDefinition{argument_type},\n")
     return out.getvalue()
 
 

{uncountablepythonsdk-0.0.20 → uncountablepythonsdk-0.0.22}/pkgs/type_spec/builder.py

@@ -10,7 +10,7 @@ import re
 from collections import defaultdict
 from dataclasses import MISSING, dataclass
 from enum import Enum, StrEnum, auto
-from typing import Any, Optional
+from typing import Any, Optional, Self
 
 from . import util
 from .util import parse_type_str, unused
@@ -184,6 +184,34 @@ class SpecTypeInstance(SpecType):
         return defn_type + self.parameters
 
 
+@dataclass(kw_only=True)
+class SpecEndpointExample:
+    summary: str
+    description: str
+    arguments: dict[str, object]
+    data: dict[str, object]
+
+
+@dataclass(kw_only=True)
+class SpecGuide:
+    title: str
+    markdown_content: str
+    html_content: str
+
+
+@dataclass(kw_only=True, frozen=True)
+class RootGuideKey:
+    pass
+
+
+@dataclass(kw_only=True, frozen=True)
+class EndpointGuideKey:
+    path: str
+
+
+SpecGuideKey = RootGuideKey | EndpointGuideKey
+
+
 class SpecTypeLiteralWrapper(SpecType):
     def __init__(
         self,
@@ -672,6 +700,32 @@ class ResultType(StrEnum):
 RE_ENDPOINT_ROOT = re.compile(r"\${([_a-z]+)}")
 
 
+@dataclass(kw_only=True, frozen=True)
+class _EndpointPathDetails:
+    root: str
+    root_path: str
+    resolved_path: str
+
+
+def _resolve_endpoint_path(
+    path: str, api_endpoints: dict[str, str]
+) -> _EndpointPathDetails:
+    root_path_source = path.split("/")[0]
+    root_match = RE_ENDPOINT_ROOT.fullmatch(root_path_source)
+    if root_match is None:
+        raise Exception(f"invalid-api-path-root:{root_path_source}")
+
+    root_var = root_match.group(1)
+    root_path = api_endpoints[root_var]
+
+    _, *rest_path = path.split("/", 1)
+    resolved_path = "/".join([root_path] + rest_path)
+
+    return _EndpointPathDetails(
+        root=root_var, root_path=root_path, resolved_path=resolved_path
+    )
+
+
 class SpecEndpoint:
     method: RouteMethod
     root: str
@@ -680,9 +734,11 @@ class SpecEndpoint:
     path_basename: str
     data_loader: bool
     is_sdk: bool
+    is_beta: bool
     # Don't emit TypeScript endpoint code
     suppress_ts: bool
     function: Optional[str]
+    async_batch_path: str | None = None
     result_type: ResultType = ResultType.json
     has_attachment: bool = False
     desc: str | None = None
@@ -701,6 +757,8 @@ class SpecEndpoint:
                 "path",
                 "data_loader",
                 "is_sdk",
+                "is_beta",
+                "async_batch_path",
                 "function",
                 "suppress_ts",
                 "desc",
@@ -727,6 +785,15 @@ class SpecEndpoint:
         assert isinstance(is_sdk, bool)
         self.is_sdk = is_sdk
 
+        is_beta = data.get("is_beta", False)
+        assert isinstance(is_beta, bool)
+        self.is_beta = is_beta
+
+        async_batch_path = data.get("async_batch_path")
+        if async_batch_path is not None:
+            assert isinstance(async_batch_path, str)
+            self.async_batch_path = async_batch_path
+
         self.function = data.get("function")
 
         suppress_ts = data.get("suppress_ts", False)
@@ -735,14 +802,10 @@ class SpecEndpoint:
 
         self.result_type = ResultType(data.get("result_type", ResultType.json.value))
 
+        path_details = _resolve_endpoint_path(data["path"], builder.api_endpoints)
+        self.root = path_details.root
+        self.path_root = path_details.root_path
         self.desc = data.get("desc")
-
-        root_match = RE_ENDPOINT_ROOT.fullmatch(path[0])
-        if root_match is None:
-            raise Exception(f"invalid-api-path-root:{path[0]}")
-
-        self.root = root_match.group(1)
-        self.path_root = builder.api_endpoints[self.root]
         # IMPROVE: remove need for is_external flag
         self.is_external = self.path_root == "api/external"
         self.has_attachment = data.get("has_attachment", False)
@@ -751,6 +814,10 @@ class SpecEndpoint:
             not is_sdk or self.desc is not None
         ), f"Endpoint description required for SDK endpoints, missing: {path}"
 
+    @property
+    def resolved_path(self: Self) -> str:
+        return f"{self.path_root}/{self.path_dirname}/{self.path_basename}"
+
 
 def _parse_const(
     builder: SpecBuilder,
@@ -1001,6 +1068,8 @@ class SpecBuilder:
         self.pending: list[NamespaceDataPair] = []
         self.parts: dict[str, dict[str, str]] = defaultdict(dict)
         self.preparts: dict[str, dict[str, str]] = defaultdict(dict)
+        self.examples: dict[str, list[SpecEndpointExample]] = defaultdict(list)
+        self.guides: dict[SpecGuideKey, list[SpecGuide]] = defaultdict(list)
         self.api_endpoints = api_endpoints
         base_namespace = SpecNamespace(name=base_namespace_name)
         for base_type in BaseTypeName:
@@ -1185,5 +1254,53 @@ class SpecBuilder:
     def add_prepart_file(self, target: str, name: str, data: str) -> None:
         self.preparts[target][name] = data
 
+    def add_example_file(self, data: dict[str, object]) -> None:
+        path_details = _resolve_endpoint_path(str(data["path"]), self.api_endpoints)
+
+        examples_data = data["examples"]
+        if not isinstance(examples_data, list):
+            raise Exception(
+                f"'examples' in example files are expected to be a list, endpoint_path={path_details.resolved_path}"
+            )
+        for example in examples_data:
+            arguments = example["arguments"]
+            data_example = example["data"]
+            if not isinstance(arguments, dict) or not isinstance(data_example, dict):
+                raise Exception(
+                    f"'arguments' and 'data' fields must be dictionaries for each endpoint example, endpoint={path_details.resolved_path}"
+                )
+            self.examples[path_details.resolved_path].append(
+                SpecEndpointExample(
+                    summary=str(example["summary"]),
+                    description=str(example["description"]),
+                    arguments=arguments,
+                    data=data_example,
+                )
+            )
+
+    def add_guide_file(self, file_content: str) -> None:
+        import markdown
+
+        md = markdown.Markdown(extensions=["meta"])
+        html = md.convert(file_content)
+        meta: dict[str, list[str]] = md.Meta  # type: ignore[attr-defined]
+        title_meta: list[str] | None = meta.get("title")
+        if title_meta is None:
+            raise Exception("guides requier a title in the meta section")
+
+        path_meta: list[str] | None = meta.get("path")
+        guide_key: SpecGuideKey = RootGuideKey()
+        if path_meta is not None:
+            path_details = _resolve_endpoint_path("".join(path_meta), self.api_endpoints)
+            guide_key = EndpointGuideKey(path=path_details.resolved_path)
+
+        self.guides[guide_key].append(
+            SpecGuide(
+                title="".join(title_meta),
+                html_content=html,
+                markdown_content=file_content,
+            )
+        )
+
     def resolve_proper_name(self, stype: SpecTypeDefn) -> str:
         return f"{'.'.join(stype.namespace.path)}.{stype.name}"

{uncountablepythonsdk-0.0.20 → uncountablepythonsdk-0.0.22}/pkgs/type_spec/config.py

@@ -56,6 +56,7 @@ class PythonConfig(BaseLanguageConfig):
     emit_api_argument_lookup: bool = (
         False  # emit a lookup for api endpoint path to argument type.
     )
+    emit_async_batch_processor: bool = False  # emit the async batch wrapping functions
     emit_client_class: bool = False  # emit the base class for the api client
     all_named_type_exports: bool = False  # emit __all__ for all named type exports
     sdk_endpoints_only: bool = False  # only emit is_sdk endpoints