nominal 1.96.0__tar.gz → 1.97.0__tar.gz

{nominal-1.96.0 → nominal-1.97.0}/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [1.97.0](https://github.com/nominal-io/nominal-client/compare/v1.96.0...v1.97.0) (2025-12-04)
+
+
+### Features
+
+* add create_workbook_template ([#535](https://github.com/nominal-io/nominal-client/issues/535)) ([9c98975](https://github.com/nominal-io/nominal-client/commit/9c989753828c39e417bafed3db2981444132aeac))
+
+
+### Bug Fixes
+
+* add per-part retries during multipart uploads ([#537](https://github.com/nominal-io/nominal-client/issues/537)) ([ffdbc4a](https://github.com/nominal-io/nominal-client/commit/ffdbc4ac6f82562fb9eff3fed4b254b784aa89bc))
+
 ## [1.96.0](https://github.com/nominal-io/nominal-client/compare/v1.95.0...v1.96.0) (2025-12-03)
 
 

{nominal-1.96.0 → nominal-1.97.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nominal
-Version: 1.96.0
+Version: 1.97.0
 Summary: Automate Nominal workflows in Python
 Project-URL: Homepage, https://nominal.io
 Project-URL: Documentation, https://docs.nominal.io

{nominal-1.96.0 → nominal-1.97.0}/nominal/core/_utils/multipart.py

@@ -27,29 +27,53 @@ def _sign_and_upload_part_job(
     upload_id: str,
     q: Queue[bytes],
     part: int,
+    num_retries: int = 3,
 ) -> requests.Response:
     data = q.get()
+
     try:
-        response = upload_client.sign_part(auth_header, key, part, upload_id)
-        logger.debug(
-            "successfully signed multipart upload part",
-            extra={"key": key, "part": part, "upload_id": upload_id, "response.url": response.url},
-        )
-        put_response = requests.put(
-            response.url,
-            data=data,
-            headers=response.headers,
-            verify=upload_client._verify,
-        )
-        logger.debug(
-            "put multipart upload part",
-            extra={"url": response.url, "size": len(data), "status_code": put_response.status_code},
+        last_ex: Exception | None = None
+        for attempt in range(num_retries):
+            try:
+                log_extras = {"key": key, "part": part, "upload_id": upload_id, "attempt": attempt + 1}
+
+                logger.debug("Signing part %d for upload", part, extra=log_extras)
+                sign_response = upload_client.sign_part(auth_header, key, part, upload_id)
+                logger.debug(
+                    "Successfully signed part %d for upload",
+                    part,
+                    extra={"response.url": sign_response.url, **log_extras},
+                )
+
+                logger.debug("Pushing part %d for multipart upload", extra=log_extras)
+                put_response = requests.put(
+                    sign_response.url,
+                    data=data,
+                    headers=sign_response.headers,
+                    verify=upload_client._verify,
+                )
+                logger.debug(
+                    "Finished pushing part %d for multipart upload with status %d",
+                    part,
+                    put_response.status_code,
+                    extra={"response.url": put_response.url, **log_extras},
+                )
+                put_response.raise_for_status()
+                return put_response
+            except Exception as ex:
+                logger.warning(
+                    "Failed to upload part %d: %s",
+                    part,
+                    ex,
+                    extra=log_extras,
+                )
+                last_ex = ex
+
+        raise (
+            last_ex
+            if last_ex
+            else RuntimeError(f"Unknown error uploading part {part} for upload_id={upload_id} and key={key}")
         )
-        put_response.raise_for_status()
-        return put_response
-    except Exception as e:
-        logger.exception("error uploading part", exc_info=e, extra={"key": key, "upload_id": upload_id, "part": part})
-        raise e
     finally:
         q.task_done()
 

{nominal-1.96.0 → nominal-1.97.0}/nominal/core/client.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import enum
 import logging
+import uuid
 from dataclasses import dataclass, field
 from datetime import datetime, timedelta
 from io import TextIOBase
@@ -21,10 +22,12 @@ from nominal_api import (
     scout_catalog,
     scout_checks_api,
     scout_datasource_connection_api,
+    scout_layout_api,
     scout_notebook_api,
     scout_run_api,
     scout_template_api,
     scout_video_api,
+    scout_workbookcommon_api,
     secrets_api,
     storage_datasource_api,
 )
@@ -1478,3 +1481,52 @@ class NominalClient:
             "nominal.core.NominalClient.create_workbook_from_template",
             "use 'nominal.core.WorkbookTemplate.create_workbook' instead",
         )
+
+    def create_workbook_template(
+        self,
+        title: str,
+        *,
+        description: str | None = None,
+        labels: list[str] | None = None,
+        properties: dict[str, str] | None = None,
+        commit_message: str | None = None,
+        workspace: Workspace | str | None = None,
+    ) -> WorkbookTemplate:
+        """Create an empty workbook template.
+
+        Args:
+            title: Title of the workbook template
+            description: Description of the workbook template
+            labels: Labels to attach to the workbook template
+            properties: Properties to attach to the workbook template
+            commit_message: An optional message to include with the creation of the template
+            workspace: Workspace to create the workbook template in.
+
+        Returns:
+            The created WorkbookTemplate
+        """
+        request = scout_template_api.CreateTemplateRequest(
+            title=title,
+            description=description if description is not None else "",
+            labels=labels if labels is not None else [],
+            properties=properties if properties is not None else {},
+            is_published=False,
+            layout=scout_layout_api.WorkbookLayout(
+                v1=scout_layout_api.WorkbookLayoutV1(
+                    root_panel=scout_layout_api.Panel(
+                        tabbed=scout_layout_api.TabbedPanel(
+                            v1=scout_layout_api.TabbedPanelV1(
+                                id=str(uuid.uuid4()),
+                                tabs=[],
+                            )
+                        )
+                    )
+                )
+            ),
+            content=scout_workbookcommon_api.WorkbookContent(channel_variables={}, charts={}),
+            message=commit_message if commit_message is not None else "Initial blank workbook template",
+            workspace=self._workspace_rid_for_search(workspace or WorkspaceSearchType.ALL),
+        )
+
+        template = self._clients.template.create(self._clients.auth_header, request)
+        return WorkbookTemplate._from_conjure(self._clients, template)

{nominal-1.96.0 → nominal-1.97.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nominal"
-version = "1.96.0"
+version = "1.97.0"
 description = "Automate Nominal workflows in Python"
 authors = [
     { name = "Alexander Reynolds", email = "alex.reynolds@nominal.io" },