nominal 1.107.0__tar.gz → 1.109.0__tar.gz

{nominal-1.107.0 → nominal-1.109.0}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [1.109.0](https://github.com/nominal-io/nominal-client/compare/v1.108.0...v1.109.0) (2026-01-23)
+
+
+### Features
+
+* clone channels when cloning datasets ([#587](https://github.com/nominal-io/nominal-client/issues/587)) ([ab6de09](https://github.com/nominal-io/nominal-client/commit/ab6de0962c55e2c0a6933d6b9f94fb36f5e91273))
+
+## [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)
 
 

{nominal-1.107.0 → nominal-1.109.0}/PKG-INFO

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

{nominal-1.107.0 → nominal-1.109.0}/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-1.107.0 → nominal-1.109.0}/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-1.107.0 → nominal-1.109.0}/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-1.107.0 → nominal-1.109.0}/nominal/experimental/migration/migration_utils.py

@@ -403,7 +403,7 @@ def copy_file_to_dataset(
 
 
 def clone_dataset(source_dataset: Dataset, destination_client: NominalClient) -> Dataset:
-    """Clones a dataset, maintaining all properties and files.
+    """Clones a dataset, maintaining all properties, files, and channels.
 
     Args:
         source_dataset (Dataset): The dataset to copy from.
@@ -412,7 +412,11 @@ def clone_dataset(source_dataset: Dataset, destination_client: NominalClient) ->
     Returns:
         The cloned dataset.
     """
-    return copy_dataset_from(source_dataset=source_dataset, destination_client=destination_client, include_files=True)
+    return copy_dataset_from(
+        source_dataset=source_dataset,
+        destination_client=destination_client,
+        include_files=True,
+    )
 
 
 def copy_dataset_from(
@@ -482,6 +486,20 @@ def copy_dataset_from(
             labels=dataset_labels,
         )
 
+    if preserve_uuid:
+        channels_copied_count = 0
+        for source_channel in source_dataset.search_channels():
+            if source_channel.data_type is None:
+                logger.warning("Skipping channel %s: unknown data type", source_channel.name, extra=log_extras)
+                continue
+            new_dataset.add_channel(
+                name=source_channel.name,
+                data_type=source_channel.data_type,
+                description=source_channel.description,
+                unit=source_channel.unit,
+            )
+            channels_copied_count += 1
+        logger.info("Copied %d channels from dataset %s", channels_copied_count, source_dataset.name, extra=log_extras)
     if include_files:
         for source_file in source_dataset.list_files():
             copy_file_to_dataset(source_file, new_dataset)

{nominal-1.107.0 → nominal-1.109.0}/pyproject.toml

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