nominal 1.106.0__py3-none-any.whl → 1.108.0__py3-none-any.whl

CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [1.108.0](https://github.com/nominal-io/nominal-client/compare/v1.107.0...v1.108.0) (2026-01-22)
+
+
+### Features
+
+* add channels to datasets ([#583](https://github.com/nominal-io/nominal-client/issues/583)) ([35398ef](https://github.com/nominal-io/nominal-client/commit/35398ef63633c2b2fa198d9915a85a8e19e40323))
+
+## [1.107.0](https://github.com/nominal-io/nominal-client/compare/v1.106.0...v1.107.0) (2026-01-22)
+
+
+### Features
+
+* make migration preserve uuid and dataset include options configurable ([#584](https://github.com/nominal-io/nominal-client/issues/584)) ([95ae64d](https://github.com/nominal-io/nominal-client/commit/95ae64de267ad957d15641378b6b418e8c234faa))
+
 ## [1.106.0](https://github.com/nominal-io/nominal-client/compare/v1.105.0...v1.106.0) (2026-01-21)
 
 

nominal/core/_clientsbunch.py

@@ -28,6 +28,7 @@ from nominal_api import (
     storage_writer_api,
     timeseries_channelmetadata,
     timeseries_logicalseries,
+    timeseries_metadata,
     upload_api,
 )
 from typing_extensions import Self
@@ -139,6 +140,7 @@ class ClientsBunch:
     proto_write: ProtoWriteService
     event: event.EventService
     channel_metadata: timeseries_channelmetadata.ChannelMetadataService
+    series_metadata: timeseries_metadata.SeriesMetadataService
     workspace: security_api_workspace.WorkspaceService
     containerized_extractors: ingest_api.ContainerizedExtractorService
     secrets: secrets_api.SecretService
@@ -179,6 +181,7 @@ class ClientsBunch:
             proto_write=client_factory(ProtoWriteService),
             event=client_factory(event.EventService),
             channel_metadata=client_factory(timeseries_channelmetadata.ChannelMetadataService),
+            series_metadata=client_factory(timeseries_metadata.SeriesMetadataService),
             workspace=client_factory(security_api_workspace.WorkspaceService),
             containerized_extractors=client_factory(ingest_api.ContainerizedExtractorService),
             secrets=client_factory(secrets_api.SecretService),

nominal/core/channel.py

@@ -12,6 +12,7 @@ from nominal_api import (
     scout_compute_api,
     scout_dataexport_api,
     scout_datasource,
+    storage_series_api,
     timeseries_channelmetadata,
     timeseries_channelmetadata_api,
     timeseries_logicalseries_api,
@@ -52,6 +53,18 @@ class ChannelDataType(enum.Enum):
         else:
             return cls("UNKNOWN")
 
+    def _to_nominal_data_type(self) -> storage_series_api.NominalDataType:
+        if self == ChannelDataType.DOUBLE:
+            return storage_series_api.NominalDataType.DOUBLE
+        elif self == ChannelDataType.STRING:
+            return storage_series_api.NominalDataType.STRING
+        elif self == ChannelDataType.LOG:
+            return storage_series_api.NominalDataType.LOG
+        elif self == ChannelDataType.INT:
+            return storage_series_api.NominalDataType.INT64
+        else:
+            return storage_series_api.NominalDataType.UNKNOWN
+
 
 @dataclass
 class Channel(RefreshableMixin[timeseries_channelmetadata_api.ChannelMetadata]):

nominal/core/datasource.py

@@ -19,6 +19,8 @@ from nominal_api import (
     timeseries_channelmetadata,
     timeseries_channelmetadata_api,
     timeseries_logicalseries,
+    timeseries_metadata,
+    timeseries_metadata_api,
     upload_api,
 )
 
@@ -67,6 +69,8 @@ class DataSource(HasRid):
         @property
         def channel_metadata(self) -> timeseries_channelmetadata.ChannelMetadataService: ...
         @property
+        def series_metadata(self) -> timeseries_metadata.SeriesMetadataService: ...
+        @property
         def containerized_extractors(self) -> ingest_api.ContainerizedExtractorService: ...
 
     def get_channel(self, name: str) -> Channel:
@@ -287,6 +291,53 @@ class DataSource(HasRid):
         request = datasource_api.IndexChannelPrefixTreeRequest(self.rid, delimiter=delimiter)
         self._clients.datasource.index_channel_prefix_tree(self._clients.auth_header, request)
 
+    def add_channel(
+        self,
+        name: str,
+        data_type: ChannelDataType,
+        *,
+        description: str | None = None,
+        unit: str | None = None,
+    ) -> Channel:
+        """Create a new channel (series metadata) for this data source.
+
+        This creates the channel metadata entry without uploading any data points.
+        Use this to pre-register channels before streaming data to them.
+
+        Args:
+            name: The name of the channel to create.
+            data_type: The data type of the channel (e.g., DOUBLE, STRING, LOG, INT).
+            description: Optional human-readable description of the channel.
+            unit: Optional unit symbol to associate with the channel.
+
+        Returns:
+            The created Channel object.
+
+        Raises:
+            conjure_python_client.ConjureHTTPError: If a channel with this name already exists
+                or if there's an error creating the channel.
+        """
+        nominal_data_type = data_type._to_nominal_data_type()
+
+        nominal_locator = timeseries_metadata_api.NominalLocatorTemplate(
+            channel=name,
+            type=nominal_data_type,
+        )
+
+        locator = timeseries_metadata_api.LocatorTemplate(nominal=nominal_locator)
+
+        create_request = timeseries_metadata_api.CreateSeriesMetadataRequest(
+            channel=name,
+            data_source_rid=self.rid,
+            locator=locator,
+            tags={},
+            description=description,
+            unit=unit,
+        )
+        self._clients.series_metadata.create(self._clients.auth_header, create_request)
+
+        return self.get_channel(name)
+
 
 def _construct_export_request(
     channels: Sequence[Channel],

nominal/experimental/migration/migration_data_config.py

@@ -0,0 +1,11 @@
+class MigrationDatasetConfig:
+    preserve_dataset_uuid: bool
+    include_dataset_files: bool
+
+    def __init__(self, preserve_dataset_uuid: bool, include_dataset_files: bool) -> None:
+        """Args:
+        preserve_dataset_uuid (bool): If true, preserves the original dataset UUIDs during migration.
+        include_dataset_files (bool): If true, includes dataset files in the migration.
+        """
+        self.preserve_dataset_uuid = preserve_dataset_uuid
+        self.include_dataset_files = include_dataset_files

nominal/experimental/migration/migration_utils.py

@@ -27,6 +27,7 @@ from nominal.core._utils.api_tools import Link, LinkDict
 from nominal.core.attachment import Attachment
 from nominal.core.run import Run
 from nominal.experimental.dataset_utils import create_dataset_with_uuid
+from nominal.experimental.migration.migration_data_config import MigrationDatasetConfig
 from nominal.experimental.migration.migration_resources import MigrationResources
 from nominal.ts import (
     IntegralNanosecondsDuration,
@@ -639,7 +640,7 @@ def clone_asset(
     return copy_asset_from(
         source_asset=source_asset,
         destination_client=destination_client,
-        include_data=True,
+        dataset_config=MigrationDatasetConfig(preserve_dataset_uuid=True, include_dataset_files=True),
         include_events=True,
         include_runs=True,
     )
@@ -653,7 +654,7 @@ def copy_asset_from(
     new_asset_description: str | None = None,
     new_asset_properties: dict[str, Any] | None = None,
     new_asset_labels: Sequence[str] | None = None,
-    include_data: bool = False,
+    dataset_config: MigrationDatasetConfig | None = None,
     include_events: bool = False,
     include_runs: bool = False,
 ) -> Asset:
@@ -666,7 +667,7 @@ def copy_asset_from(
         new_asset_description: Optional new description for the copied asset. If not provided, original description used
         new_asset_properties: Optional new properties for the copied asset. If not provided, original properties used.
         new_asset_labels: Optional new labels for the copied asset. If not provided, the original labels are used.
-        include_data: Whether to include data in the copied asset.
+        dataset_config: Configuration for dataset migration.
         include_events: Whether to include events in the copied dataset.
         include_runs: Whether to include runs in the copied asset.
 
@@ -683,15 +684,16 @@ def copy_asset_from(
         properties=new_asset_properties if new_asset_properties is not None else source_asset.properties,
         labels=new_asset_labels if new_asset_labels is not None else source_asset.labels,
     )
-    if include_data:
+    if dataset_config is not None:
         source_datasets = source_asset.list_datasets()
         for data_scope, source_dataset in source_datasets:
-            new_dataset = clone_dataset(
+            new_dataset = copy_dataset_from(
                 source_dataset=source_dataset,
                 destination_client=destination_client,
+                preserve_uuid=dataset_config.preserve_dataset_uuid,
+                include_files=dataset_config.include_dataset_files,
             )
             new_asset.add_dataset(data_scope, new_dataset)
-    source_asset._list_dataset_scopes
 
     if include_events:
         source_events = source_asset.search_events(origin_types=SearchEventOriginType.get_manual_origin_types())
@@ -710,6 +712,7 @@ def copy_asset_from(
 def copy_resources_to_destination_client(
     destination_client: NominalClient,
     migration_resources: MigrationResources,
+    dataset_config: MigrationDatasetConfig | None = None,
 ) -> tuple[Sequence[tuple[str, Dataset]], Sequence[Asset], Sequence[WorkbookTemplate], Sequence[Workbook]]:
     """Based on a list of assets and workbook templates, copy resources to destination client, creating
        new datasets, datafiles, and workbooks along the way.
@@ -717,6 +720,7 @@ def copy_resources_to_destination_client(
     Args:
         destination_client (NominalClient): client of the tenant/workspace to copy resources to.
         migration_resources (MigrationResources): resources to copy.
+        dataset_config (MigrationDataConfig | None): Configuration for dataset migration.
 
     Returns:
         All of the created resources.
@@ -731,7 +735,13 @@ def copy_resources_to_destination_client(
 
     new_data_scopes_and_datasets: list[tuple[str, Dataset]] = []
     for source_asset in migration_resources.source_assets:
-        new_asset = clone_asset(source_asset.asset, destination_client)
+        new_asset = copy_asset_from(
+            source_asset.asset,
+            destination_client,
+            dataset_config=dataset_config,
+            include_events=True,
+            include_runs=True,
+        )
         new_assets.append(new_asset)
         new_data_scopes_and_datasets.extend(new_asset.list_datasets())
 
@@ -739,7 +749,7 @@ def copy_resources_to_destination_client(
             new_template = clone_workbook_template(source_workbook_template, destination_client)
             new_templates.append(new_template)
             new_workbook = new_template.create_workbook(
-                title=new_template.title, description=new_template.description, asset=new_assets[0]
+                title=new_template.title, description=new_template.description, asset=new_asset
             )
             logger.debug(
                 "Created new workbook %s (rid: %s) from template %s (rid: %s)",

{nominal-1.106.0.dist-info → nominal-1.108.0.dist-info}/METADATA

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

{nominal-1.106.0.dist-info → nominal-1.108.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-CHANGELOG.md,sha256=roEVqpYae9DRMQRYCiJQm7ei603DhmGY7_Il7PmaoDg,88865
+CHANGELOG.md,sha256=-ls_mO5aZCjyBFUqYkMVzrqOswFIEqKJFz7r0mqSziQ,89542
 LICENSE,sha256=zEGHG9mjDjaIS3I79O8mweQo-yiTbqx8jJvUPppVAwk,1067
 README.md,sha256=KKe0dxh_pHXCtB7I9G4qWGQYvot_BZU8yW6MJyuyUHM,311
 nominal/__init__.py,sha256=rbraORnXUrNn1hywLXM0XwSQCd9UmQt20PDYlsBalfE,2167
@@ -28,14 +28,14 @@ nominal/cli/util/verify_connection.py,sha256=KU17ejaDfKBLmLiZ3MZSVLyfrqNE7c6mFBv
 nominal/config/__init__.py,sha256=wV8cq8X3J4NTJ5H_uR5THaMT_NQpWQO5qCUGEb-rPnM,3157
 nominal/config/_config.py,sha256=yKq_H1iYJDoxRfLz2iXLbbVdoL0MTEY0FS4eVL12w0g,2004
 nominal/core/__init__.py,sha256=1MiCC44cxHYFofP4hf2fz4EIkepK-OAhDzpPFIzHbWw,2422
-nominal/core/_clientsbunch.py,sha256=YwciugX7rQ9AOPHyvKuavG7b9SlX1PURRquP37nvLqE,8458
+nominal/core/_clientsbunch.py,sha256=sn-ajYsJ2FuZGLiEYiPwkYCxLKr13w35aqWHE3TX5us,8633
 nominal/core/_constants.py,sha256=SrxgaSqAEB1MvTSrorgGam3eO29iCmRr6VIdajxX3gI,56
 nominal/core/_event_types.py,sha256=Cq_8x-zv_5EDvRo9UTbaOpenAy92bTfQxlsEuHPOhtE,3706
 nominal/core/_types.py,sha256=FktMmcQ5_rD2rbXv8_p-WISzSo8T2NtO-exsLm-iadU,122
 nominal/core/asset.py,sha256=-hNMGXiU1dPWfrzmOngbab-Hf6vfq2Rm_j0FP-woJ-s,23120
 nominal/core/attachment.py,sha256=yOtDUdkLY5MT_Rk9kUlr1yupIJN7a5pt5sJWx4RLQV8,4355
 nominal/core/bounds.py,sha256=742BWmGL3FBryRAjoiJRg2N6aVinjYkQLxN7kfnJ40Q,581
-nominal/core/channel.py,sha256=dbe8wpfMiWqHu98x66w6GOmC9Ro33Wv9AhBVx2DvtVk,18970
+nominal/core/channel.py,sha256=e0RtbjrXYMAqyt8noe610iIFzv30z2P7oqrwq08atD8,19558
 nominal/core/checklist.py,sha256=rO1RPDYV3o2miPKF7DcCiYpj6bUN-sdtZNhJkXzkfYE,7110
 nominal/core/client.py,sha256=Awt9WPkE-YXBfOwJMTL7Su8AZFJY3UMH7IKp5hI26YQ,68328
 nominal/core/connection.py,sha256=LYllr3a1H2xp8-i4MaX1M7yK8X-HnwuIkciyK9XgLtQ,5175
@@ -43,7 +43,7 @@ nominal/core/containerized_extractors.py,sha256=fUz3-NHoNWYKqOCD15gLwGXDKVfdsW-x
 nominal/core/data_review.py,sha256=Z_W1Okp_FSQDiVCk6aKb9gV0EXbE2jtiQaPqc6TaL0g,11038
 nominal/core/dataset.py,sha256=LqofzNAlOd3S_3Aaw6b7DoY50rj6GyMHbUClIA2TmpY,46792
 nominal/core/dataset_file.py,sha256=8rCW6MO89MFbQ2NH0WtFWmJfRWeTxhmyuoGojuQQ4Qg,16545
-nominal/core/datasource.py,sha256=V5UahbqsCNIdml978kOHiY6boIxKxbp76KscNBpN5xc,16934
+nominal/core/datasource.py,sha256=i9db5OHNdfJyb3BJmhz2uJ398MfW8zx3Ek9pw5vYn3c,18739
 nominal/core/event.py,sha256=8trZXyuAqRlKedgcqSgDIimXAAJBmEfDLyHkOOBwUC0,7762
 nominal/core/exceptions.py,sha256=GUpwXRgdYamLl6684FE8ttCRHkBx6WEhOZ3NPE-ybD4,2671
 nominal/core/filetype.py,sha256=R8goHGW4SP0iO6AoQiUil2tNVuDgaQoHclftRbw44oc,5558
@@ -89,8 +89,9 @@ nominal/experimental/logging/click_log_handler.py,sha256=ANLf4IGgmh95V0kJlr756wQ
 nominal/experimental/logging/nominal_log_handler.py,sha256=hyTxyjsvFnE7vtyrDJpunAqADHmXekNWALwxXPIJGCk,5120
 nominal/experimental/logging/rich_log_handler.py,sha256=8yz_VtxNgJg2oiesnXz2iXoBvQrUP5pAsYkxknOXgXA,1231
 nominal/experimental/migration/__init__.py,sha256=E2IgWJLwJ5bN6jbl8k5nHECKFx5aT11jKAzVYcyXn3o,460
+nominal/experimental/migration/migration_data_config.py,sha256=sPwZjyLmL-_pHvDZvQspxrfW6yNZhEsQjDVwKA8IaXM,522
 nominal/experimental/migration/migration_resources.py,sha256=Tf_7kNBeSaY8z2fTF7DAxk-9q3a7F8xXFVvxI8tTc9c,415
-nominal/experimental/migration/migration_utils.py,sha256=E3K2_kMsWIG9p2oIwxM64aXJLRemhsCbqfJ4Jv4SJ4M,31214
+nominal/experimental/migration/migration_utils.py,sha256=isvxBH7pOjvT9PuJRfoMNHGJR17TYsSapDPVSRESCys,31804
 nominal/experimental/rust_streaming/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nominal/experimental/rust_streaming/rust_write_stream.py,sha256=oQ6ixwm8ct8ZDc_qNB7AucDt8o5-_aBVlW2fFCQ_nmA,1541
 nominal/experimental/stream_v2/__init__.py,sha256=W39vK46pssx5sXvmsImMuJiEPs7iGtwrbYBI0bWnXCY,2313
@@ -109,8 +110,8 @@ nominal/thirdparty/polars/polars_export_handler.py,sha256=hGCSwXX9dC4MG01CmmjlTb
 nominal/thirdparty/tdms/__init__.py,sha256=6n2ImFr2Wiil6JM1P5Q7Mpr0VzLcnDkmup_ftNpPq-s,142
 nominal/thirdparty/tdms/_tdms.py,sha256=m4gxbpxB9MTLi2FuYvGlbUGSyDAZKFxbM3ia2x1wIz0,8746
 nominal/ts/__init__.py,sha256=hmd0ENvDhxRnzDKGLxIub6QG8LpcxCgcyAct029CaEs,21442
-nominal-1.106.0.dist-info/METADATA,sha256=cdf0KpzkFmrFb5XsWVEa6F4UNUr1WMp79uekN4hIkq8,2307
-nominal-1.106.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-nominal-1.106.0.dist-info/entry_points.txt,sha256=-mCLhxgg9R_lm5efT7vW9wuBH12izvY322R0a3TYxbE,66
-nominal-1.106.0.dist-info/licenses/LICENSE,sha256=zEGHG9mjDjaIS3I79O8mweQo-yiTbqx8jJvUPppVAwk,1067
-nominal-1.106.0.dist-info/RECORD,,
+nominal-1.108.0.dist-info/METADATA,sha256=BFL54ilX_SW2XErNJm9Q4kEow-SCxGdJcIVvqlJ0b5A,2307
+nominal-1.108.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+nominal-1.108.0.dist-info/entry_points.txt,sha256=-mCLhxgg9R_lm5efT7vW9wuBH12izvY322R0a3TYxbE,66
+nominal-1.108.0.dist-info/licenses/LICENSE,sha256=zEGHG9mjDjaIS3I79O8mweQo-yiTbqx8jJvUPppVAwk,1067
+nominal-1.108.0.dist-info/RECORD,,