zaber-motion 7.10.0__py3-none-win32.whl → 7.12.0__py3-none-win32.whl

zaber_motion/dto/__init__.py

@@ -2,6 +2,7 @@
 # pylint: disable=line-too-long
 from .axis_address import AxisAddress as AxisAddress
 from .channel_address import ChannelAddress as ChannelAddress
+from .device_db_source import DeviceDbSource as DeviceDbSource
 from .device_db_source_type import DeviceDbSourceType as DeviceDbSourceType
 from .firmware_version import FirmwareVersion as FirmwareVersion
 from .log_output_mode import LogOutputMode as LogOutputMode

zaber_motion/dto/device_db_source.py

@@ -0,0 +1,66 @@
+# This file is generated. Do not modify by hand.
+# pylint: disable=line-too-long, unused-argument, f-string-without-interpolation, too-many-branches, too-many-statements, unnecessary-pass
+from dataclasses import dataclass
+from typing import Any, Dict, Optional
+import zaber_bson
+from .device_db_source_type import DeviceDbSourceType
+
+
+@dataclass
+class DeviceDbSource:
+    """
+    A source that device information can be retrieved from.
+    """
+
+    source_type: DeviceDbSourceType
+    """
+    Whether the source is a web service or a local DB file.
+    """
+
+    url_or_file_path: Optional[str] = None
+    """
+    The URL of the web service or path to the local DB file.
+    """
+
+    @staticmethod
+    def zero_values() -> 'DeviceDbSource':
+        return DeviceDbSource(
+            source_type=next(first for first in DeviceDbSourceType),
+            url_or_file_path=None,
+        )
+
+    @staticmethod
+    def from_binary(data_bytes: bytes) -> 'DeviceDbSource':
+        """" Deserialize a binary representation of this class. """
+        data = zaber_bson.loads(data_bytes)  # type: Dict[str, Any]
+        return DeviceDbSource.from_dict(data)
+
+    def to_binary(self) -> bytes:
+        """" Serialize this class to a binary representation. """
+        self.validate()
+        return zaber_bson.dumps(self.to_dict())  # type: ignore
+
+    def to_dict(self) -> Dict[str, Any]:
+        return {
+            'sourceType': self.source_type.value,
+            'urlOrFilePath': str(self.url_or_file_path) if self.url_or_file_path is not None else None,
+        }
+
+    @staticmethod
+    def from_dict(data: Dict[str, Any]) -> 'DeviceDbSource':
+        return DeviceDbSource(
+            source_type=DeviceDbSourceType(data.get('sourceType')),  # type: ignore
+            url_or_file_path=data.get('urlOrFilePath'),  # type: ignore
+        )
+
+    def validate(self) -> None:
+        """" Validates the properties of the instance. """
+        if self.source_type is None:
+            raise ValueError(f'Property "SourceType" of "DeviceDbSource" is None.')
+
+        if not isinstance(self.source_type, DeviceDbSourceType):
+            raise ValueError(f'Property "SourceType" of "DeviceDbSource" is not an instance of "DeviceDbSourceType".')
+
+        if self.url_or_file_path is not None:
+            if not isinstance(self.url_or_file_path, str):
+                raise ValueError(f'Property "UrlOrFilePath" of "DeviceDbSource" is not a string.')

zaber_motion/dto/exceptions/__init__.py

@@ -5,6 +5,7 @@ from .command_failed_exception_data import CommandFailedExceptionData as Command
 from .command_too_long_exception_data import CommandTooLongExceptionData as CommandTooLongExceptionData
 from .device_address_conflict_exception_data import DeviceAddressConflictExceptionData as DeviceAddressConflictExceptionData
 from .device_db_failed_exception_data import DeviceDbFailedExceptionData as DeviceDbFailedExceptionData
+from .device_db_inner_error import DeviceDbInnerError as DeviceDbInnerError
 from .g_code_execution_exception_data import GCodeExecutionExceptionData as GCodeExecutionExceptionData
 from .g_code_syntax_exception_data import GCodeSyntaxExceptionData as GCodeSyntaxExceptionData
 from .invalid_packet_exception_data import InvalidPacketExceptionData as InvalidPacketExceptionData

zaber_motion/dto/exceptions/device_db_failed_exception_data.py

@@ -1,8 +1,10 @@
 # This file is generated. Do not modify by hand.
 # pylint: disable=line-too-long, unused-argument, f-string-without-interpolation, too-many-branches, too-many-statements, unnecessary-pass
 from dataclasses import dataclass
-from typing import Any, Dict
+from typing import Any, Dict, List
+from collections.abc import Iterable
 import zaber_bson
+from .device_db_inner_error import DeviceDbInnerError
 
 
 @dataclass
@@ -16,10 +18,16 @@ class DeviceDbFailedExceptionData:
     Code describing type of the error.
     """
 
+    inner_errors: List[DeviceDbInnerError]
+    """
+    A list of errors that occurred while trying to access information from the device database.
+    """
+
     @staticmethod
     def zero_values() -> 'DeviceDbFailedExceptionData':
         return DeviceDbFailedExceptionData(
             code="",
+            inner_errors=[],
         )
 
     @staticmethod
@@ -36,12 +44,14 @@ class DeviceDbFailedExceptionData:
     def to_dict(self) -> Dict[str, Any]:
         return {
             'code': str(self.code or ''),
+            'innerErrors': [item.to_dict() for item in self.inner_errors] if self.inner_errors is not None else [],
         }
 
     @staticmethod
     def from_dict(data: Dict[str, Any]) -> 'DeviceDbFailedExceptionData':
         return DeviceDbFailedExceptionData(
             code=data.get('code'),  # type: ignore
+            inner_errors=[DeviceDbInnerError.from_dict(item) for item in data.get('innerErrors')],  # type: ignore
         )
 
     def validate(self) -> None:
@@ -49,3 +59,16 @@ class DeviceDbFailedExceptionData:
         if self.code is not None:
             if not isinstance(self.code, str):
                 raise ValueError(f'Property "Code" of "DeviceDbFailedExceptionData" is not a string.')
+
+        if self.inner_errors is not None:
+            if not isinstance(self.inner_errors, Iterable):
+                raise ValueError('Property "InnerErrors" of "DeviceDbFailedExceptionData" is not iterable.')
+
+            for i, inner_errors_item in enumerate(self.inner_errors):
+                if inner_errors_item is None:
+                    raise ValueError(f'Item {i} in property "InnerErrors" of "DeviceDbFailedExceptionData" is None.')
+
+                if not isinstance(inner_errors_item, DeviceDbInnerError):
+                    raise ValueError(f'Item {i} in property "InnerErrors" of "DeviceDbFailedExceptionData" is not an instance of "DeviceDbInnerError".')
+
+                inner_errors_item.validate()

zaber_motion/dto/exceptions/device_db_inner_error.py

@@ -0,0 +1,85 @@
+# This file is generated. Do not modify by hand.
+# pylint: disable=line-too-long, unused-argument, f-string-without-interpolation, too-many-branches, too-many-statements, unnecessary-pass
+from dataclasses import dataclass
+from typing import Any, Dict, List
+from collections.abc import Iterable
+import zaber_bson
+
+
+@dataclass
+class DeviceDbInnerError:
+    """
+    One of the errors that occurred while trying to access information from the device database.
+    """
+
+    code: str
+    """
+    Code describing type of the error.
+    """
+
+    message: str
+    """
+    Description of the error.
+    """
+
+    inner_errors: List['DeviceDbInnerError']
+    """
+    A list of errors that occurred while trying to access information from the device database.
+    """
+
+    @staticmethod
+    def zero_values() -> 'DeviceDbInnerError':
+        return DeviceDbInnerError(
+            code="",
+            message="",
+            inner_errors=[],
+        )
+
+    @staticmethod
+    def from_binary(data_bytes: bytes) -> 'DeviceDbInnerError':
+        """" Deserialize a binary representation of this class. """
+        data = zaber_bson.loads(data_bytes)  # type: Dict[str, Any]
+        return DeviceDbInnerError.from_dict(data)
+
+    def to_binary(self) -> bytes:
+        """" Serialize this class to a binary representation. """
+        self.validate()
+        return zaber_bson.dumps(self.to_dict())  # type: ignore
+
+    def to_dict(self) -> Dict[str, Any]:
+        return {
+            'code': str(self.code or ''),
+            'message': str(self.message or ''),
+            'innerErrors': [item.to_dict() for item in self.inner_errors] if self.inner_errors is not None else [],
+        }
+
+    @staticmethod
+    def from_dict(data: Dict[str, Any]) -> 'DeviceDbInnerError':
+        return DeviceDbInnerError(
+            code=data.get('code'),  # type: ignore
+            message=data.get('message'),  # type: ignore
+            inner_errors=[DeviceDbInnerError.from_dict(item) for item in data.get('innerErrors')],  # type: ignore
+        )
+
+    def validate(self) -> None:
+        """" Validates the properties of the instance. """
+        if self.code is not None:
+            if not isinstance(self.code, str):
+                raise ValueError(f'Property "Code" of "DeviceDbInnerError" is not a string.')
+
+        if self.message is not None:
+            if not isinstance(self.message, str):
+                raise ValueError(f'Property "Message" of "DeviceDbInnerError" is not a string.')
+
+        if self.inner_errors is not None:
+            if not isinstance(self.inner_errors, Iterable):
+                raise ValueError('Property "InnerErrors" of "DeviceDbInnerError" is not iterable.')
+
+            for i, inner_errors_item in enumerate(self.inner_errors):
+                if inner_errors_item is None:
+                    raise ValueError(f'Item {i} in property "InnerErrors" of "DeviceDbInnerError" is None.')
+
+                if not isinstance(inner_errors_item, DeviceDbInnerError):
+                    raise ValueError(f'Item {i} in property "InnerErrors" of "DeviceDbInnerError" is not an instance of "DeviceDbInnerError".')
+
+                inner_errors_item.validate()

zaber_motion/dto/requests/__init__.py

@@ -141,16 +141,20 @@ from .oscilloscope_request import OscilloscopeRequest as OscilloscopeRequest
 from .oscilloscope_start_request import OscilloscopeStartRequest as OscilloscopeStartRequest
 from .prepare_command_request import PrepareCommandRequest as PrepareCommandRequest
 from .process_on import ProcessOn as ProcessOn
+from .pvt_buffer_get_sequence_data_request import PvtBufferGetSequenceDataRequest as PvtBufferGetSequenceDataRequest
 from .pvt_generate_positions_request import PvtGeneratePositionsRequest as PvtGeneratePositionsRequest
+from .pvt_generate_velocities_and_times_request import PvtGenerateVelocitiesAndTimesRequest as PvtGenerateVelocitiesAndTimesRequest
 from .pvt_generate_velocities_request import PvtGenerateVelocitiesRequest as PvtGenerateVelocitiesRequest
 from .pvt_load_csv_request import PvtLoadCsvRequest as PvtLoadCsvRequest
 from .pvt_point_request import PvtPointRequest as PvtPointRequest
 from .pvt_points_request import PvtPointsRequest as PvtPointsRequest
 from .pvt_save_csv_request import PvtSaveCsvRequest as PvtSaveCsvRequest
+from .pvt_submit_sequence_data_request import PvtSubmitSequenceDataRequest as PvtSubmitSequenceDataRequest
 from .renumber_request import RenumberRequest as RenumberRequest
 from .response_type import ResponseType as ResponseType
 from .servo_tuning_paramset_response import ServoTuningParamsetResponse as ServoTuningParamsetResponse
 from .servo_tuning_request import ServoTuningRequest as ServoTuningRequest
+from .set_device_db_layered_sources_request import SetDeviceDbLayeredSourcesRequest as SetDeviceDbLayeredSourcesRequest
 from .set_device_db_source_request import SetDeviceDbSourceRequest as SetDeviceDbSourceRequest
 from .set_interface_checksum_enabled_request import SetInterfaceChecksumEnabledRequest as SetInterfaceChecksumEnabledRequest
 from .set_interface_timeout_request import SetInterfaceTimeoutRequest as SetInterfaceTimeoutRequest

zaber_motion/dto/requests/pvt_buffer_get_sequence_data_request.py

@@ -0,0 +1,79 @@
+# This file is generated. Do not modify by hand.
+# pylint: disable=line-too-long, unused-argument, f-string-without-interpolation, too-many-branches, too-many-statements, unnecessary-pass
+from dataclasses import dataclass
+from typing import Any, Dict
+import decimal
+import zaber_bson
+
+
+@dataclass
+class PvtBufferGetSequenceDataRequest:
+
+    interface_id: int = 0
+
+    device: int = 0
+
+    buffer_id: int = 0
+
+    @staticmethod
+    def zero_values() -> 'PvtBufferGetSequenceDataRequest':
+        return PvtBufferGetSequenceDataRequest(
+            interface_id=0,
+            device=0,
+            buffer_id=0,
+        )
+
+    @staticmethod
+    def from_binary(data_bytes: bytes) -> 'PvtBufferGetSequenceDataRequest':
+        """" Deserialize a binary representation of this class. """
+        data = zaber_bson.loads(data_bytes)  # type: Dict[str, Any]
+        return PvtBufferGetSequenceDataRequest.from_dict(data)
+
+    def to_binary(self) -> bytes:
+        """" Serialize this class to a binary representation. """
+        self.validate()
+        return zaber_bson.dumps(self.to_dict())  # type: ignore
+
+    def to_dict(self) -> Dict[str, Any]:
+        return {
+            'interfaceId': int(self.interface_id),
+            'device': int(self.device),
+            'bufferId': int(self.buffer_id),
+        }
+
+    @staticmethod
+    def from_dict(data: Dict[str, Any]) -> 'PvtBufferGetSequenceDataRequest':
+        return PvtBufferGetSequenceDataRequest(
+            interface_id=data.get('interfaceId'),  # type: ignore
+            device=data.get('device'),  # type: ignore
+            buffer_id=data.get('bufferId'),  # type: ignore
+        )
+
+    def validate(self) -> None:
+        """" Validates the properties of the instance. """
+        if self.interface_id is None:
+            raise ValueError(f'Property "InterfaceId" of "PvtBufferGetSequenceDataRequest" is None.')
+
+        if not isinstance(self.interface_id, (int, float, decimal.Decimal)):
+            raise ValueError(f'Property "InterfaceId" of "PvtBufferGetSequenceDataRequest" is not a number.')
+
+        if int(self.interface_id) != self.interface_id:
+            raise ValueError(f'Property "InterfaceId" of "PvtBufferGetSequenceDataRequest" is not integer value.')
+
+        if self.device is None:
+            raise ValueError(f'Property "Device" of "PvtBufferGetSequenceDataRequest" is None.')
+
+        if not isinstance(self.device, (int, float, decimal.Decimal)):
+            raise ValueError(f'Property "Device" of "PvtBufferGetSequenceDataRequest" is not a number.')
+
+        if int(self.device) != self.device:
+            raise ValueError(f'Property "Device" of "PvtBufferGetSequenceDataRequest" is not integer value.')
+
+        if self.buffer_id is None:
+            raise ValueError(f'Property "BufferId" of "PvtBufferGetSequenceDataRequest" is None.')
+
+        if not isinstance(self.buffer_id, (int, float, decimal.Decimal)):
+            raise ValueError(f'Property "BufferId" of "PvtBufferGetSequenceDataRequest" is not a number.')
+
+        if int(self.buffer_id) != self.buffer_id:
+            raise ValueError(f'Property "BufferId" of "PvtBufferGetSequenceDataRequest" is not integer value.')

zaber_motion/dto/requests/pvt_generate_velocities_and_times_request.py

@@ -0,0 +1,96 @@
+# This file is generated. Do not modify by hand.
+# pylint: disable=line-too-long, unused-argument, f-string-without-interpolation, too-many-branches, too-many-statements, unnecessary-pass
+from dataclasses import dataclass, field
+from typing import Any, Dict, List, Optional
+import decimal
+from collections.abc import Iterable
+import zaber_bson
+from ..ascii.measurement_sequence import MeasurementSequence
+from ..measurement import Measurement
+
+
+@dataclass
+class PvtGenerateVelocitiesAndTimesRequest:
+
+    positions: List[MeasurementSequence] = field(default_factory=list)
+
+    target_speed: Measurement = field(default_factory=Measurement.zero_values)
+
+    target_acceleration: Measurement = field(default_factory=Measurement.zero_values)
+
+    resample_number: Optional[int] = None
+
+    @staticmethod
+    def zero_values() -> 'PvtGenerateVelocitiesAndTimesRequest':
+        return PvtGenerateVelocitiesAndTimesRequest(
+            positions=[],
+            target_speed=Measurement.zero_values(),
+            target_acceleration=Measurement.zero_values(),
+            resample_number=None,
+        )
+
+    @staticmethod
+    def from_binary(data_bytes: bytes) -> 'PvtGenerateVelocitiesAndTimesRequest':
+        """" Deserialize a binary representation of this class. """
+        data = zaber_bson.loads(data_bytes)  # type: Dict[str, Any]
+        return PvtGenerateVelocitiesAndTimesRequest.from_dict(data)
+
+    def to_binary(self) -> bytes:
+        """" Serialize this class to a binary representation. """
+        self.validate()
+        return zaber_bson.dumps(self.to_dict())  # type: ignore
+
+    def to_dict(self) -> Dict[str, Any]:
+        return {
+            'positions': [item.to_dict() for item in self.positions] if self.positions is not None else [],
+            'targetSpeed': self.target_speed.to_dict(),
+            'targetAcceleration': self.target_acceleration.to_dict(),
+            'resampleNumber': int(self.resample_number) if self.resample_number is not None else None,
+        }
+
+    @staticmethod
+    def from_dict(data: Dict[str, Any]) -> 'PvtGenerateVelocitiesAndTimesRequest':
+        return PvtGenerateVelocitiesAndTimesRequest(
+            positions=[MeasurementSequence.from_dict(item) for item in data.get('positions')],  # type: ignore
+            target_speed=Measurement.from_dict(data.get('targetSpeed')),  # type: ignore
+            target_acceleration=Measurement.from_dict(data.get('targetAcceleration')),  # type: ignore
+            resample_number=data.get('resampleNumber'),  # type: ignore
+        )
+
+    def validate(self) -> None:
+        """" Validates the properties of the instance. """
+        if self.positions is not None:
+            if not isinstance(self.positions, Iterable):
+                raise ValueError('Property "Positions" of "PvtGenerateVelocitiesAndTimesRequest" is not iterable.')
+
+            for i, positions_item in enumerate(self.positions):
+                if positions_item is None:
+                    raise ValueError(f'Item {i} in property "Positions" of "PvtGenerateVelocitiesAndTimesRequest" is None.')
+
+                if not isinstance(positions_item, MeasurementSequence):
+                    raise ValueError(f'Item {i} in property "Positions" of "PvtGenerateVelocitiesAndTimesRequest" is not an instance of "MeasurementSequence".')
+
+                positions_item.validate()
+
+        if self.target_speed is None:
+            raise ValueError(f'Property "TargetSpeed" of "PvtGenerateVelocitiesAndTimesRequest" is None.')
+
+        if not isinstance(self.target_speed, Measurement):
+            raise ValueError(f'Property "TargetSpeed" of "PvtGenerateVelocitiesAndTimesRequest" is not an instance of "Measurement".')
+
+        self.target_speed.validate()
+
+        if self.target_acceleration is None:
+            raise ValueError(f'Property "TargetAcceleration" of "PvtGenerateVelocitiesAndTimesRequest" is None.')
+
+        if not isinstance(self.target_acceleration, Measurement):
+            raise ValueError(f'Property "TargetAcceleration" of "PvtGenerateVelocitiesAndTimesRequest" is not an instance of "Measurement".')
+
+        self.target_acceleration.validate()
+
+        if self.resample_number is not None:
+            if not isinstance(self.resample_number, (int, float, decimal.Decimal)):
+                raise ValueError(f'Property "ResampleNumber" of "PvtGenerateVelocitiesAndTimesRequest" is not a number.')
+
+            if int(self.resample_number) != self.resample_number:
+                raise ValueError(f'Property "ResampleNumber" of "PvtGenerateVelocitiesAndTimesRequest" is not integer value.')

zaber_motion/dto/requests/pvt_submit_sequence_data_request.py

@@ -0,0 +1,93 @@
+# This file is generated. Do not modify by hand.
+# pylint: disable=line-too-long, unused-argument, f-string-without-interpolation, too-many-branches, too-many-statements, unnecessary-pass
+from dataclasses import dataclass, field
+from typing import Any, Dict
+import decimal
+import zaber_bson
+from ..ascii.pvt_sequence_data import PvtSequenceData
+
+
+@dataclass
+class PvtSubmitSequenceDataRequest:
+
+    interface_id: int = 0
+
+    device: int = 0
+
+    stream_id: int = 0
+
+    sequence_data: PvtSequenceData = field(default_factory=PvtSequenceData.zero_values)
+
+    @staticmethod
+    def zero_values() -> 'PvtSubmitSequenceDataRequest':
+        return PvtSubmitSequenceDataRequest(
+            interface_id=0,
+            device=0,
+            stream_id=0,
+            sequence_data=PvtSequenceData.zero_values(),
+        )
+
+    @staticmethod
+    def from_binary(data_bytes: bytes) -> 'PvtSubmitSequenceDataRequest':
+        """" Deserialize a binary representation of this class. """
+        data = zaber_bson.loads(data_bytes)  # type: Dict[str, Any]
+        return PvtSubmitSequenceDataRequest.from_dict(data)
+
+    def to_binary(self) -> bytes:
+        """" Serialize this class to a binary representation. """
+        self.validate()
+        return zaber_bson.dumps(self.to_dict())  # type: ignore
+
+    def to_dict(self) -> Dict[str, Any]:
+        return {
+            'interfaceId': int(self.interface_id),
+            'device': int(self.device),
+            'streamId': int(self.stream_id),
+            'sequenceData': self.sequence_data.to_dict(),
+        }
+
+    @staticmethod
+    def from_dict(data: Dict[str, Any]) -> 'PvtSubmitSequenceDataRequest':
+        return PvtSubmitSequenceDataRequest(
+            interface_id=data.get('interfaceId'),  # type: ignore
+            device=data.get('device'),  # type: ignore
+            stream_id=data.get('streamId'),  # type: ignore
+            sequence_data=PvtSequenceData.from_dict(data.get('sequenceData')),  # type: ignore
+        )
+
+    def validate(self) -> None:
+        """" Validates the properties of the instance. """
+        if self.interface_id is None:
+            raise ValueError(f'Property "InterfaceId" of "PvtSubmitSequenceDataRequest" is None.')
+
+        if not isinstance(self.interface_id, (int, float, decimal.Decimal)):
+            raise ValueError(f'Property "InterfaceId" of "PvtSubmitSequenceDataRequest" is not a number.')
+
+        if int(self.interface_id) != self.interface_id:
+            raise ValueError(f'Property "InterfaceId" of "PvtSubmitSequenceDataRequest" is not integer value.')
+
+        if self.device is None:
+            raise ValueError(f'Property "Device" of "PvtSubmitSequenceDataRequest" is None.')
+
+        if not isinstance(self.device, (int, float, decimal.Decimal)):
+            raise ValueError(f'Property "Device" of "PvtSubmitSequenceDataRequest" is not a number.')
+
+        if int(self.device) != self.device:
+            raise ValueError(f'Property "Device" of "PvtSubmitSequenceDataRequest" is not integer value.')
+
+        if self.stream_id is None:
+            raise ValueError(f'Property "StreamId" of "PvtSubmitSequenceDataRequest" is None.')
+
+        if not isinstance(self.stream_id, (int, float, decimal.Decimal)):
+            raise ValueError(f'Property "StreamId" of "PvtSubmitSequenceDataRequest" is not a number.')
+
+        if int(self.stream_id) != self.stream_id:
+            raise ValueError(f'Property "StreamId" of "PvtSubmitSequenceDataRequest" is not integer value.')
+
+        if self.sequence_data is None:
+            raise ValueError(f'Property "SequenceData" of "PvtSubmitSequenceDataRequest" is None.')
+
+        if not isinstance(self.sequence_data, PvtSequenceData):
+            raise ValueError(f'Property "SequenceData" of "PvtSubmitSequenceDataRequest" is not an instance of "PvtSequenceData".')
+
+        self.sequence_data.validate()

zaber_motion/dto/requests/set_device_db_layered_sources_request.py

@@ -0,0 +1,56 @@
+# This file is generated. Do not modify by hand.
+# pylint: disable=line-too-long, unused-argument, f-string-without-interpolation, too-many-branches, too-many-statements, unnecessary-pass
+from dataclasses import dataclass, field
+from typing import Any, Dict, List
+from collections.abc import Iterable
+import zaber_bson
+from ..device_db_source import DeviceDbSource
+
+
+@dataclass
+class SetDeviceDbLayeredSourcesRequest:
+
+    sources: List[DeviceDbSource] = field(default_factory=list)
+
+    @staticmethod
+    def zero_values() -> 'SetDeviceDbLayeredSourcesRequest':
+        return SetDeviceDbLayeredSourcesRequest(
+            sources=[],
+        )
+
+    @staticmethod
+    def from_binary(data_bytes: bytes) -> 'SetDeviceDbLayeredSourcesRequest':
+        """" Deserialize a binary representation of this class. """
+        data = zaber_bson.loads(data_bytes)  # type: Dict[str, Any]
+        return SetDeviceDbLayeredSourcesRequest.from_dict(data)
+
+    def to_binary(self) -> bytes:
+        """" Serialize this class to a binary representation. """
+        self.validate()
+        return zaber_bson.dumps(self.to_dict())  # type: ignore
+
+    def to_dict(self) -> Dict[str, Any]:
+        return {
+            'sources': [item.to_dict() for item in self.sources] if self.sources is not None else [],
+        }
+
+    @staticmethod
+    def from_dict(data: Dict[str, Any]) -> 'SetDeviceDbLayeredSourcesRequest':
+        return SetDeviceDbLayeredSourcesRequest(
+            sources=[DeviceDbSource.from_dict(item) for item in data.get('sources')],  # type: ignore
+        )
+
+    def validate(self) -> None:
+        """" Validates the properties of the instance. """
+        if self.sources is not None:
+            if not isinstance(self.sources, Iterable):
+                raise ValueError('Property "Sources" of "SetDeviceDbLayeredSourcesRequest" is not iterable.')
+
+            for i, sources_item in enumerate(self.sources):
+                if sources_item is None:
+                    raise ValueError(f'Item {i} in property "Sources" of "SetDeviceDbLayeredSourcesRequest" is None.')
+
+                if not isinstance(sources_item, DeviceDbSource):
+                    raise ValueError(f'Item {i} in property "Sources" of "SetDeviceDbLayeredSourcesRequest" is not an instance of "DeviceDbSource".')
+
+                sources_item.validate()

zaber_motion/dto/requests/set_device_db_source_request.py

@@ -10,8 +10,14 @@ from ..device_db_source_type import DeviceDbSourceType
 class SetDeviceDbSourceRequest:
 
     source_type: DeviceDbSourceType = next(first for first in DeviceDbSourceType)
+    """
+    Whether the source is a web service or a local DB file.
+    """
 
     url_or_file_path: Optional[str] = None
+    """
+    The URL of the web service or path to the local DB file.
+    """
 
     @staticmethod
     def zero_values() -> 'SetDeviceDbSourceRequest':

zaber_motion/exceptions/__init__.py

@@ -68,6 +68,7 @@ from ..dto.exceptions.command_failed_exception_data import CommandFailedExceptio
 from ..dto.exceptions.command_too_long_exception_data import CommandTooLongExceptionData as CommandTooLongExceptionData
 from ..dto.exceptions.device_address_conflict_exception_data import DeviceAddressConflictExceptionData as DeviceAddressConflictExceptionData
 from ..dto.exceptions.device_db_failed_exception_data import DeviceDbFailedExceptionData as DeviceDbFailedExceptionData
+from ..dto.exceptions.device_db_inner_error import DeviceDbInnerError as DeviceDbInnerError
 from ..dto.exceptions.g_code_execution_exception_data import GCodeExecutionExceptionData as GCodeExecutionExceptionData
 from ..dto.exceptions.g_code_syntax_exception_data import GCodeSyntaxExceptionData as GCodeSyntaxExceptionData
 from ..dto.exceptions.invalid_packet_exception_data import InvalidPacketExceptionData as InvalidPacketExceptionData

zaber_motion/gcode/offline_translator.py

@@ -35,7 +35,7 @@ class OfflineTranslator:
         return self.__get_current_coordinate_system()
 
     def __init__(self, translator_id: int):
-        self._translator_id = translator_id
+        self._translator_id: int = translator_id
 
     @staticmethod
     def setup(

zaber_motion/gcode/translator.py

@@ -34,7 +34,7 @@ class Translator:
         return self.__get_current_coordinate_system()
 
     def __init__(self, translator_id: int):
-        self._translator_id = translator_id
+        self._translator_id: int = translator_id
 
     @staticmethod
     def setup(

zaber_motion/library.py

@@ -6,6 +6,7 @@ from .call import call, call_async, call_sync
 from .dto import requests as dto
 from .dto.log_output_mode import LogOutputMode
 from .dto.device_db_source_type import DeviceDbSourceType
+from .dto.device_db_source import DeviceDbSource
 
 
 class Library:
@@ -50,6 +51,22 @@ class Library:
         )
         call_sync("device_db/set_source", request)
 
+    @staticmethod
+    def set_device_db_sources(
+            *sources: DeviceDbSource
+    ) -> None:
+        """
+        Sets a sequence of sources. When the library needs device information,
+        it will try each source in the order they are provided.
+
+        Args:
+            sources: The list of sources the library will access data from.
+        """
+        request = dto.SetDeviceDbLayeredSourcesRequest(
+            sources=list(sources),
+        )
+        call_sync("device_db/set_sources", request)
+
     @staticmethod
     def enable_device_db_store(
             store_location: Optional[str] = None
@@ -154,7 +171,7 @@ class Library:
         """
         request = dto.CheckVersionRequest(
             host="py",
-            version="7.10.0",
+            version="7.12.0",
         )
         call_sync("library/check_version", request)