viam-sdk 0.25.2__py3-none-linux_armv7l.whl → 0.62.0__py3-none-linux_armv7l.whl

viam/proto/component/switch/__init__.py

@@ -0,0 +1,26 @@
+"""
+@generated by Viam.
+Do not edit manually!
+"""
+
+from ....gen.component.switch.v1.switch_grpc import SwitchServiceBase, SwitchServiceStub, UnimplementedSwitchServiceBase
+from ....gen.component.switch.v1.switch_pb2 import (
+    GetNumberOfPositionsRequest,
+    GetNumberOfPositionsResponse,
+    GetPositionRequest,
+    GetPositionResponse,
+    SetPositionRequest,
+    SetPositionResponse,
+)
+
+__all__ = [
+    "SwitchServiceBase",
+    "SwitchServiceStub",
+    "UnimplementedSwitchServiceBase",
+    "GetNumberOfPositionsRequest",
+    "GetNumberOfPositionsResponse",
+    "GetPositionRequest",
+    "GetPositionResponse",
+    "SetPositionRequest",
+    "SetPositionResponse",
+]

viam/proto/component/testecho/__init__.py

@@ -2,6 +2,7 @@
 @generated by Viam.
 Do not edit manually!
 """
+
 from ....gen.component.testecho.v1.testecho_grpc import TestEchoServiceBase, TestEchoServiceStub, UnimplementedTestEchoServiceBase
 from ....gen.component.testecho.v1.testecho_pb2 import (
     EchoBiDiRequest,

viam/proto/module/__init__.py

@@ -2,6 +2,7 @@
 @generated by Viam.
 Do not edit manually!
 """
+
 from ...gen.module.v1.module_grpc import ModuleServiceBase, ModuleServiceStub, UnimplementedModuleServiceBase
 from ...gen.module.v1.module_pb2 import (
     AddResourceRequest,

viam/proto/provisioning/__init__.py

@@ -2,9 +2,12 @@
 @generated by Viam.
 Do not edit manually!
 """
+
 from ...gen.provisioning.v1.provisioning_grpc import ProvisioningServiceBase, ProvisioningServiceStub, UnimplementedProvisioningServiceBase
 from ...gen.provisioning.v1.provisioning_pb2 import (
     CloudConfig,
+    ExitProvisioningRequest,
+    ExitProvisioningResponse,
     GetNetworkListRequest,
     GetNetworkListResponse,
     GetSmartMachineStatusRequest,
@@ -22,6 +25,8 @@ __all__ = [
     "ProvisioningServiceStub",
     "UnimplementedProvisioningServiceBase",
     "CloudConfig",
+    "ExitProvisioningRequest",
+    "ExitProvisioningResponse",
     "GetNetworkListRequest",
     "GetNetworkListResponse",
     "GetSmartMachineStatusRequest",

viam/proto/robot/__init__.py

@@ -2,16 +2,14 @@
 @generated by Viam.
 Do not edit manually!
 """
+
 from ...gen.robot.v1.robot_grpc import RobotServiceBase, RobotServiceStub, UnimplementedRobotServiceBase
 from ...gen.robot.v1.robot_pb2 import (
     BlockForOperationRequest,
     BlockForOperationResponse,
     CancelOperationRequest,
     CancelOperationResponse,
-    DiscoverComponentsRequest,
-    DiscoverComponentsResponse,
-    Discovery,
-    DiscoveryQuery,
+    ConfigStatus,
     FrameSystemConfig,
     FrameSystemConfigRequest,
     FrameSystemConfigResponse,
@@ -19,14 +17,24 @@ from ...gen.robot.v1.robot_pb2 import (
     GetCloudMetadataResponse,
     GetMachineStatusRequest,
     GetMachineStatusResponse,
+    GetModelsFromModulesRequest,
+    GetModelsFromModulesResponse,
     GetOperationsRequest,
     GetOperationsResponse,
+    GetPoseRequest,
+    GetPoseResponse,
     GetSessionsRequest,
     GetSessionsResponse,
     GetStatusRequest,
     GetStatusResponse,
+    GetVersionRequest,
+    GetVersionResponse,
+    JobStatus,
+    ListTunnelsRequest,
+    ListTunnelsResponse,
     LogRequest,
     LogResponse,
+    ModuleModel,
     Operation,
     PeerConnectionInfo,
     PeerConnectionType,
@@ -55,6 +63,9 @@ from ...gen.robot.v1.robot_pb2 import (
     TransformPCDResponse,
     TransformPoseRequest,
     TransformPoseResponse,
+    Tunnel,
+    TunnelRequest,
+    TunnelResponse,
 )
 
 __all__ = [
@@ -65,10 +76,7 @@ __all__ = [
     "BlockForOperationResponse",
     "CancelOperationRequest",
     "CancelOperationResponse",
-    "DiscoverComponentsRequest",
-    "DiscoverComponentsResponse",
-    "Discovery",
-    "DiscoveryQuery",
+    "ConfigStatus",
     "FrameSystemConfig",
     "FrameSystemConfigRequest",
     "FrameSystemConfigResponse",
@@ -76,14 +84,24 @@ __all__ = [
     "GetCloudMetadataResponse",
     "GetMachineStatusRequest",
     "GetMachineStatusResponse",
+    "GetModelsFromModulesRequest",
+    "GetModelsFromModulesResponse",
     "GetOperationsRequest",
     "GetOperationsResponse",
+    "GetPoseRequest",
+    "GetPoseResponse",
     "GetSessionsRequest",
     "GetSessionsResponse",
     "GetStatusRequest",
     "GetStatusResponse",
+    "GetVersionRequest",
+    "GetVersionResponse",
+    "JobStatus",
+    "ListTunnelsRequest",
+    "ListTunnelsResponse",
     "LogRequest",
     "LogResponse",
+    "ModuleModel",
     "Operation",
     "PeerConnectionInfo",
     "PeerConnectionType",
@@ -112,4 +130,7 @@ __all__ = [
     "TransformPCDResponse",
     "TransformPoseRequest",
     "TransformPoseResponse",
+    "Tunnel",
+    "TunnelRequest",
+    "TunnelResponse",
 ]

viam/proto/rpc/auth.py

@@ -2,6 +2,7 @@
 @generated by Viam.
 Do not edit manually!
 """
+
 from ...gen.proto.rpc.v1.auth_grpc import (
     AuthServiceBase,
     AuthServiceStub,

viam/proto/rpc/examples/echo/__init__.py

@@ -2,6 +2,7 @@
 @generated by Viam.
 Do not edit manually!
 """
+
 from .....gen.proto.rpc.examples.echo.v1.echo_grpc import EchoServiceBase, EchoServiceStub, UnimplementedEchoServiceBase
 from .....gen.proto.rpc.examples.echo.v1.echo_pb2 import (
     EchoBiDiRequest,

viam/proto/rpc/examples/echoresource/__init__.py

@@ -2,6 +2,7 @@
 @generated by Viam.
 Do not edit manually!
 """
+
 from .....gen.proto.rpc.examples.echoresource.v1.echoresource_grpc import (
     EchoResourceServiceBase,
     EchoResourceServiceStub,

viam/proto/rpc/webrtc/grpc.py

@@ -2,6 +2,7 @@
 @generated by Viam.
 Do not edit manually!
 """
+
 from ....gen.proto.rpc.webrtc.v1.grpc_pb2 import (
     Metadata,
     PacketMessage,

viam/proto/rpc/webrtc/signaling.py

@@ -2,11 +2,13 @@
 @generated by Viam.
 Do not edit manually!
 """
+
 from ....gen.proto.rpc.webrtc.v1.signaling_grpc import SignalingServiceBase, SignalingServiceStub, UnimplementedSignalingServiceBase
 from ....gen.proto.rpc.webrtc.v1.signaling_pb2 import (
     AnswerRequest,
     AnswerRequestDoneStage,
     AnswerRequestErrorStage,
+    AnswerRequestHeartbeatStage,
     AnswerRequestInitStage,
     AnswerRequestUpdateStage,
     AnswerResponse,
@@ -34,6 +36,7 @@ __all__ = [
     "AnswerRequest",
     "AnswerRequestDoneStage",
     "AnswerRequestErrorStage",
+    "AnswerRequestHeartbeatStage",
     "AnswerRequestInitStage",
     "AnswerRequestUpdateStage",
     "AnswerResponse",

viam/proto/service/datamanager/__init__.py

@@ -2,12 +2,18 @@
 @generated by Viam.
 Do not edit manually!
 """
+
 from ....gen.service.datamanager.v1.data_manager_grpc import (
     DataManagerServiceBase,
     DataManagerServiceStub,
     UnimplementedDataManagerServiceBase,
 )
-from ....gen.service.datamanager.v1.data_manager_pb2 import SyncRequest, SyncResponse
+from ....gen.service.datamanager.v1.data_manager_pb2 import (
+    SyncRequest,
+    SyncResponse,
+    UploadBinaryDataToDatasetsRequest,
+    UploadBinaryDataToDatasetsResponse,
+)
 
 __all__ = [
     "DataManagerServiceBase",
@@ -15,4 +21,6 @@ __all__ = [
     "UnimplementedDataManagerServiceBase",
     "SyncRequest",
     "SyncResponse",
+    "UploadBinaryDataToDatasetsRequest",
+    "UploadBinaryDataToDatasetsResponse",
 ]

viam/proto/service/discovery/__init__.py

@@ -0,0 +1,15 @@
+"""
+@generated by Viam.
+Do not edit manually!
+"""
+
+from ....gen.service.discovery.v1.discovery_grpc import DiscoveryServiceBase, DiscoveryServiceStub, UnimplementedDiscoveryServiceBase
+from ....gen.service.discovery.v1.discovery_pb2 import DiscoverResourcesRequest, DiscoverResourcesResponse
+
+__all__ = [
+    "DiscoveryServiceBase",
+    "DiscoveryServiceStub",
+    "UnimplementedDiscoveryServiceBase",
+    "DiscoverResourcesRequest",
+    "DiscoverResourcesResponse",
+]

viam/proto/service/generic/__init__.py

@@ -2,6 +2,7 @@
 @generated by Viam.
 Do not edit manually!
 """
+
 from ....gen.service.generic.v1.generic_grpc import GenericServiceBase, GenericServiceStub, UnimplementedGenericServiceBase
 
 __all__ = [

viam/proto/service/mlmodel/__init__.py

@@ -2,6 +2,7 @@
 @generated by Viam.
 Do not edit manually!
 """
+
 from ....gen.service.mlmodel.v1.mlmodel_grpc import MLModelServiceBase, MLModelServiceStub, UnimplementedMLModelServiceBase
 from ....gen.service.mlmodel.v1.mlmodel_pb2 import (
     File,

viam/proto/service/motion/__init__.py

@@ -2,6 +2,7 @@
 @generated by Viam.
 Do not edit manually!
 """
+
 from ....gen.service.motion.v1.motion_grpc import MotionServiceBase, MotionServiceStub, UnimplementedMotionServiceBase
 from ....gen.service.motion.v1.motion_pb2 import (
     CollisionSpecification,
@@ -29,6 +30,7 @@ from ....gen.service.motion.v1.motion_pb2 import (
     PlanStatusWithID,
     PlanStep,
     PlanWithStatus,
+    PseudolinearConstraint,
     StopPlanRequest,
     StopPlanResponse,
 )
@@ -62,6 +64,7 @@ __all__ = [
     "PlanStatusWithID",
     "PlanStep",
     "PlanWithStatus",
+    "PseudolinearConstraint",
     "StopPlanRequest",
     "StopPlanResponse",
 ]

viam/proto/service/navigation/__init__.py

@@ -2,6 +2,7 @@
 @generated by Viam.
 Do not edit manually!
 """
+
 from ....gen.service.navigation.v1.navigation_grpc import NavigationServiceBase, NavigationServiceStub, UnimplementedNavigationServiceBase
 from ....gen.service.navigation.v1.navigation_pb2 import (
     AddWaypointRequest,

viam/proto/service/sensors/__init__.py

@@ -2,6 +2,7 @@
 @generated by Viam.
 Do not edit manually!
 """
+
 from ....gen.service.sensors.v1.sensors_grpc import SensorsServiceBase, SensorsServiceStub, UnimplementedSensorsServiceBase
 from ....gen.service.sensors.v1.sensors_pb2 import GetReadingsRequest, GetReadingsResponse, GetSensorsRequest, GetSensorsResponse, Readings
 

viam/proto/service/shell/__init__.py

@@ -2,6 +2,7 @@
 @generated by Viam.
 Do not edit manually!
 """
+
 from ....gen.service.shell.v1.shell_grpc import ShellServiceBase, ShellServiceStub, UnimplementedShellServiceBase
 from ....gen.service.shell.v1.shell_pb2 import (
     CopyFilesFromMachineRequest,

viam/proto/service/slam/__init__.py

@@ -2,6 +2,7 @@
 @generated by Viam.
 Do not edit manually!
 """
+
 from ....gen.service.slam.v1.slam_grpc import SLAMServiceBase, SLAMServiceStub, UnimplementedSLAMServiceBase
 from ....gen.service.slam.v1.slam_pb2 import (
     GetInternalStateRequest,

viam/proto/service/video/__init__.py

@@ -0,0 +1,15 @@
+"""
+@generated by Viam.
+Do not edit manually!
+"""
+
+from ....gen.service.video.v1.video_grpc import UnimplementedVideoServiceBase, VideoServiceBase, VideoServiceStub
+from ....gen.service.video.v1.video_pb2 import GetVideoRequest, GetVideoResponse
+
+__all__ = [
+    "UnimplementedVideoServiceBase",
+    "VideoServiceBase",
+    "VideoServiceStub",
+    "GetVideoRequest",
+    "GetVideoResponse",
+]

viam/proto/service/vision/__init__.py

@@ -2,6 +2,7 @@
 @generated by Viam.
 Do not edit manually!
 """
+
 from ....gen.service.vision.v1.vision_grpc import UnimplementedVisionServiceBase, VisionServiceBase, VisionServiceStub
 from ....gen.service.vision.v1.vision_pb2 import (
     CaptureAllFromCameraRequest,

viam/proto/service/worldstatestore/__init__.py

@@ -0,0 +1,32 @@
+"""
+@generated by Viam.
+Do not edit manually!
+"""
+
+from ....gen.service.worldstatestore.v1.world_state_store_grpc import (
+    UnimplementedWorldStateStoreServiceBase,
+    WorldStateStoreServiceBase,
+    WorldStateStoreServiceStub,
+)
+from ....gen.service.worldstatestore.v1.world_state_store_pb2 import (
+    GetTransformRequest,
+    GetTransformResponse,
+    ListUUIDsRequest,
+    ListUUIDsResponse,
+    StreamTransformChangesRequest,
+    StreamTransformChangesResponse,
+    TransformChangeType,
+)
+
+__all__ = [
+    "UnimplementedWorldStateStoreServiceBase",
+    "WorldStateStoreServiceBase",
+    "WorldStateStoreServiceStub",
+    "GetTransformRequest",
+    "GetTransformResponse",
+    "ListUUIDsRequest",
+    "ListUUIDsResponse",
+    "StreamTransformChangesRequest",
+    "StreamTransformChangesResponse",
+    "TransformChangeType",
+]

viam/proto/stream/__init__.py

@@ -2,14 +2,20 @@
 @generated by Viam.
 Do not edit manually!
 """
+
 from ...gen.stream.v1.stream_grpc import StreamServiceBase, StreamServiceStub, UnimplementedStreamServiceBase
 from ...gen.stream.v1.stream_pb2 import (
     AddStreamRequest,
     AddStreamResponse,
+    GetStreamOptionsRequest,
+    GetStreamOptionsResponse,
     ListStreamsRequest,
     ListStreamsResponse,
     RemoveStreamRequest,
     RemoveStreamResponse,
+    Resolution,
+    SetStreamOptionsRequest,
+    SetStreamOptionsResponse,
 )
 
 __all__ = [
@@ -18,8 +24,13 @@ __all__ = [
     "UnimplementedStreamServiceBase",
     "AddStreamRequest",
     "AddStreamResponse",
+    "GetStreamOptionsRequest",
+    "GetStreamOptionsResponse",
     "ListStreamsRequest",
     "ListStreamsResponse",
     "RemoveStreamRequest",
     "RemoveStreamResponse",
+    "Resolution",
+    "SetStreamOptionsRequest",
+    "SetStreamOptionsResponse",
 ]

viam/resource/base.py

@@ -1,4 +1,5 @@
 from abc import abstractmethod
+from logging import Logger
 from typing import TYPE_CHECKING, Any, ClassVar, Mapping, Optional, Protocol, runtime_checkable
 
 from typing_extensions import Self
@@ -6,7 +7,7 @@ from typing_extensions import Self
 from viam.operations import Operation
 from viam.proto.common import ResourceName
 
-from .types import Subtype
+from .types import API
 
 if TYPE_CHECKING:
     from viam.robot.client import RobotClient
@@ -19,12 +20,15 @@ class ResourceBase(Protocol):
     The base requirements for a Resource.
     """
 
-    SUBTYPE: ClassVar["Subtype"]
-    """The Subtype of the Resource"""
+    API: ClassVar["API"]
+    """The API of the Resource"""
 
     name: str
     """The name of the Resource"""
 
+    logger: Logger
+    """A logger allowing for setting log levels on a per-resource basis"""
+
     @classmethod
     def get_resource_name(cls, name: str) -> ResourceName:
         """
@@ -33,7 +37,7 @@ class ResourceBase(Protocol):
         ::
 
             # Can be used with any resource, using an arm as an example
-            my_arm_name = my_arm.get_resource_name("my_arm")
+            my_arm_name = Arm.get_resource_name("my_arm")
 
         Args:
             name (str): The name of the Resource
@@ -42,9 +46,9 @@ class ResourceBase(Protocol):
             ResourceName: The ResourceName of this Resource
         """
         return ResourceName(
-            namespace=cls.SUBTYPE.namespace,
-            type=cls.SUBTYPE.resource_type,
-            subtype=cls.SUBTYPE.resource_subtype,
+            namespace=cls.API.namespace,
+            type=cls.API.resource_type,
+            subtype=cls.API.resource_subtype,
             name=name,
         )
 
@@ -76,7 +80,7 @@ class ResourceBase(Protocol):
         ::
 
             command = {"cmd": "test", "data1": 500}
-            result = component.do(command)
+            result = await component.do_command(command)
 
         Args:
             command (Mapping[str, ValueTypes]): The command to execute

viam/resource/easy_resource.py

@@ -1,7 +1,7 @@
 import inspect
 import re
 from abc import ABCMeta
-from typing import Callable, Mapping, Union
+from typing import Callable, ClassVar, Mapping, Sequence, Tuple, Union
 
 from viam.proto.app.robot import ComponentConfig
 from viam.proto.common import ResourceName
@@ -10,7 +10,7 @@ from .. import logging
 from ..errors import MethodNotImplementedError
 from .base import ResourceBase
 from .registry import Registry, ResourceCreatorRegistration
-from .types import Model, ModelFamily, Subtype
+from .types import API, Model, ModelFamily
 
 modelRegex = re.compile(r"^([^:]+):([^:]+):([^:]+)$")
 
@@ -92,8 +92,8 @@ class EasyResource:
     See examples/easy_resource/main.py for extended usage.
     """
 
-    SUBTYPE: Subtype
-    MODEL: Model
+    API: ClassVar[API]
+    MODEL: ClassVar[Model]
 
     def __init_subclass__(cls, register=True, **kwargs):
         """
@@ -101,7 +101,7 @@ class EasyResource:
         """
         super().__init_subclass__(**kwargs)
         if not hasattr(cls, "MODEL"):
-            raise ValueError("please define a MODEL like 'org:type:name' on your class, for example 'viam:camera:IMX219'")
+            raise ValueError("Please define a MODEL with the format 'org:type:name' on your class, for example 'viam:camera:IMX219'")
         cls.MODEL = _parse_model(cls.MODEL)
         if register:
             cls.register()
@@ -113,26 +113,37 @@ class EasyResource:
     @classmethod
     def new(cls, config: ComponentConfig, dependencies: Mapping[ResourceName, ResourceBase]):
         """
-        This is passed to register_resource_creator; the default implementation calls reconfigure()
+        This is passed to register_resource_creator. The default implementation only sets the resource name
         when an instance of your model is instantiated. You can override this in your subclass.
         """
         self = cls(config.name)
-        logger.debug("created %s %s %s", self.SUBTYPE, self.MODEL, config.name)
-        self.reconfigure(config, dependencies)
+        logger.debug("created %s %s %s", cls.API, cls.MODEL, config.name)
         return self
 
+    @classmethod
+    def validate_config(cls, config: ComponentConfig) -> Tuple[Sequence[str], Sequence[str]]:
+        """This method allows you to validate the configuration object received from the machine,
+        as well as to return any implicit dependencies based on that `config`.
+
+        Args:
+            config (ComponentConfig): The configuration for this resource
+
+        Returns:
+            Tuple[Sequence[str], Sequence[str]]: One list of required implicit dependencies and one of optional deps.
+        """
+        return [], []
+
     @classmethod
     def register(cls):
         """
         This adds the model to the global registry. It is called by __init_subclass__ and you typically
         won't call it directly.
         """
-        logger.debug("registering %s %s", cls.SUBTYPE, cls.MODEL)
+        logger.debug("registering %s %s", cls.API, cls.MODEL)
         # note: We could fix this pyright-ignore if EasyResource inherited ResourceBase, but that crashes in the mro()
         # walk in ResourceManager.register.
         Registry.register_resource_creator(
-            cls.SUBTYPE, cls.MODEL, ResourceCreatorRegistration(cls.new)  # pyright: ignore [reportArgumentType]
+            cls.API,
+            cls.MODEL,
+            ResourceCreatorRegistration(cls.new, cls.validate_config),  # pyright: ignore [reportArgumentType]
         )
-
-    def reconfigure(self, config: ComponentConfig, dependencies: Mapping[ResourceName, ResourceBase]):
-        logger.debug("reconfigure %s %s", self.SUBTYPE, self.MODEL)

viam/resource/manager.py

@@ -39,12 +39,12 @@ class ResourceManager:
         Raises:
             DuplicateResourceError: Error if attempting to register resource
                                      with the name of an existing resource
-            ResourceNotFoundError: Raised if the subtype of the resource is not registered
+            ResourceNotFoundError: Raised if the API of the resource is not registered
 
         Args:
             resource (ResourceBase): The resource to register
         """
-        Registry.lookup_subtype(resource.SUBTYPE)  # confirm the subtype is registered in Registry
+        Registry.lookup_api(resource.API)  # confirm the API is registered in Registry
 
         _BaseClasses = (ResourceBase, ComponentBase, ServiceBase)
         rnames: Dict[ResourceName, ResourceBase] = {}
@@ -103,10 +103,11 @@ class ResourceManager:
             try:
                 resource = self.resources[name]
                 await resource.close()
-            except Exception as e:
-                raise e
             finally:
-                del self.resources[name]
+                try:
+                    del self.resources[name]
+                except KeyError:
+                    pass
 
     async def close(self):
         """Close the resourcce manager by removing all resources.