nominal 1.95.0__py3-none-any.whl → 1.97.0__py3-none-any.whl

CHANGELOG.md

@@ -1,5 +1,26 @@
 # 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)
+
+
+### Features
+
+* add tags to dataflash apis ([#534](https://github.com/nominal-io/nominal-client/issues/534)) ([00cd79f](https://github.com/nominal-io/nominal-client/commit/00cd79fdb84e299a4013b69ce9639cfc75644b32))
+* remove deprecated fields, methods, files ([#525](https://github.com/nominal-io/nominal-client/issues/525)) ([e11175d](https://github.com/nominal-io/nominal-client/commit/e11175de0e303d97d91efa7eaf6ee6010d6b08ef))
+* reorder methods in run and asset class ([#530](https://github.com/nominal-io/nominal-client/issues/530)) ([5813157](https://github.com/nominal-io/nominal-client/commit/58131574bd85a82d36f7e76f18279c8c7cfaf1a8))
+
 ## [1.95.0](https://github.com/nominal-io/nominal-client/compare/v1.94.0...v1.95.0) (2025-11-19)
 
 

nominal/cli/__init__.py

@@ -2,7 +2,7 @@ import importlib.metadata
 
 import click
 
-from nominal.cli import attachment, auth, config, dataset, download, mis, run
+from nominal.cli import attachment, config, dataset, download, mis, run
 
 
 @click.group(context_settings={"show_default": True, "help_option_names": ("-h", "--help")})
@@ -12,7 +12,6 @@ def nom() -> None:
 
 
 nom.add_command(attachment.attachment_cmd)
-nom.add_command(auth.auth_cmd)
 nom.add_command(config.config_cmd)
 nom.add_command(dataset.dataset_cmd)
 nom.add_command(download.download_cmd)

nominal/cli/auth.py

@@ -1,12 +1,9 @@
 from __future__ import annotations
 
-import warnings
-
 import click
 
 from nominal.cli.util.global_decorators import global_options
-from nominal.cli.util.verify_connection import validate_token_url
-from nominal.config import _config as _deprecated_config
+from nominal.core.exceptions import NominalMethodRemovedError
 
 
 @click.group(name="auth")
@@ -25,12 +22,4 @@ def set_token(token: str, base_url: str) -> None:
 
     Update the token for a given URL in the (deprecated) Nominal config file
     """
-    warnings.warn(
-        "`nom auth set-token` is deprecated, use `nom config profile add` instead",
-        UserWarning,
-        stacklevel=2,
-    )
-    path = _deprecated_config._DEFAULT_NOMINAL_CONFIG_PATH
-    validate_token_url(token, base_url, None)
-    _deprecated_config.set_token(base_url, token)
-    click.secho(f"Successfully set token for '{base_url}' in {path}", fg="green")
+    raise NominalMethodRemovedError("nominal auth set-token", "use 'nominal config profile add' instead")

nominal/cli/dataset.py

@@ -70,7 +70,7 @@ def upload_csv(
         description=description,
         prefix_tree_delimiter=channel_name_delimiter,
     )
-    dataset.add_tabular_data(
+    dataset_file = dataset.add_tabular_data(
         file,
         timestamp_column=timestamp_column,
         timestamp_type=timestamp_type,
@@ -78,7 +78,7 @@ def upload_csv(
 
     # block until ingestion completed, if requested
     if wait:
-        dataset.poll_until_ingestion_completed()
+        dataset_file.poll_until_ingestion_completed()
 
     click.echo(dataset)
 

nominal/cli/util/click_log_handler.py

@@ -4,7 +4,7 @@ import logging
 
 from typing_extensions import deprecated
 
-from nominal.experimental.logging import ClickLogHandler, install_click_log_handler
+from nominal.core.exceptions import NominalMethodRemovedError
 
 
 @deprecated(
@@ -20,7 +20,10 @@ def install_log_handler(level: int = logging.WARNING, no_color: bool = False) ->
         no_color: If true, prevents log messages from being stylized by severity level
 
     """
-    install_click_log_handler(level=level, no_color=no_color)
+    raise NominalMethodRemovedError(
+        "nominal.cli.util.install_log_handler",
+        "use nominal.experimental.logging.install_click_log_handler instead",
+    )
 
 
-__all__ = ["ClickLogHandler", "install_log_handler"]
+__all__ = ["install_log_handler"]

nominal/cli/util/global_decorators.py

@@ -8,7 +8,6 @@ import typing
 
 import click
 
-from nominal.config._config import _DEFAULT_NOMINAL_CONFIG_PATH, get_token
 from nominal.core.client import NominalClient
 from nominal.experimental.logging import install_click_log_handler
 
@@ -105,14 +104,14 @@ def client_options(func: typing.Callable[Param, T]) -> typing.Callable[..., T]:
     """Decorator to add click options to a click command for dynamically creating and injecting an instance of the
     NominalClient into commands based on user-provided flags to configure its creation.
 
-    This will add three options, --profile, --base-url, and --token, which perform the three aforementioned
-    configurations before spawning a NominalClient.
+    This will add an option --profile which perform the aforementioned configurations before spawning a NominalClient.
 
     NOTE: any click command utilizing this decorator MUST accept a key-value argument pair named client of type
         NominalClient.
     """
     profile_option = click.option(
         "--profile",
+        required=True,
         help=(
             "If provided, use the given named config profile for instantiating a Nominal Client. "
             "This is the preferred mechanism for instantiating a client today-- see `nom config profile add` "
@@ -120,26 +119,6 @@ def client_options(func: typing.Callable[Param, T]) -> typing.Callable[..., T]:
             "--base-url."
         ),
     )
-    url_option = click.option(
-        "--base-url",
-        default="https://api.gov.nominal.io/api",
-        show_default=True,
-        help="Base URL of the Nominal API to hit. Useful for hitting other clusters, e.g., staging for internal users.",
-    )
-    token_path_option = click.option(
-        "--token-path",
-        default=_DEFAULT_NOMINAL_CONFIG_PATH,
-        type=click.Path(dir_okay=False, resolve_path=True, path_type=pathlib.Path),
-        show_default=True,
-        help="Path to the yaml file containing the Nominal access token for authenticating with the API",
-    )
-    token_option = click.option(
-        "--token",
-        help=(
-            "API Access token to use when creating the nominal client. "
-            "If provided, takes precedence over --token-path and --base-url"
-        ),
-    )
     trust_store_option = click.option(
         "--trust-store-path",
         type=click.Path(dir_okay=False, exists=True, resolve_path=True, path_type=pathlib.Path),
@@ -154,35 +133,14 @@ def client_options(func: typing.Callable[Param, T]) -> typing.Callable[..., T]:
         *args: Param.args,
         **kwargs: Param.kwargs,
     ) -> T:
-        profile: str | None = kwargs.pop("profile")  # type: ignore[assignment]
-        base_url: str = kwargs.pop("base_url", "")  # type: ignore[assignment]
-        token: str | None = kwargs.pop("token")  # type: ignore[assignment]
-        token_path: pathlib.Path = kwargs.pop("token_path")  # type: ignore[assignment]
+        profile: str = kwargs.pop("profile")  # type: ignore[assignment]
         trust_store_path: pathlib.Path | None = kwargs.pop("trust_store_path")  # type: ignore[assignment]
 
         trust_store_str = str(trust_store_path) if trust_store_path else None
 
-        if profile is not None:
-            logger.info("Instantiating client from profile '%s'", profile)
-            client = NominalClient.from_profile(profile, trust_store_path=trust_store_str)
-            kwargs["client"] = client
-            return func(*args, **kwargs)
-
-        logger.warning(
-            "Creating a Nominal Client without using '--profile' is deprecated! "
-            "See 'https://docs.nominal.io/core/sdk/python-client/authentication' for details..."
-        )
-
-        if token is None:
-            if token_path.exists():
-                token = get_token(base_url, token_path)
-            else:
-                raise ValueError(
-                    f"Cannot instantiate client: no token provided and token path {token_path} does not exist."
-                )
-
-        client = NominalClient.create(base_url, token=token, trust_store_path=trust_store_str)
+        logger.info("Instantiating client from profile '%s'", profile)
+        client = NominalClient.from_profile(profile, trust_store_path=trust_store_str)
         kwargs["client"] = client
         return func(*args, **kwargs)
 
-    return profile_option(token_option(token_path_option(url_option(trust_store_option(wrapped_function)))))
+    return profile_option(trust_store_option(wrapped_function))

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()