Implement connect() and disconnect()

CONTRIBUTING.md

@@ -22,7 +22,7 @@ See [GitHub's official documentation](https://help.github.com/articles/using-pul
 # Getting Started
 
 This is the command to generate the files in /src/ni/pythonpanel/v1/:
-`poetry run python -m grpc_tools.protoc --proto_path=protos --python_out=src/ --grpc_python_out=src/ ni/pythonpanel/v1/python_panel_service.proto`
+`poetry run python -m grpc_tools.protoc --proto_path=protos --python_out=src/ --grpc_python_out=src/ --mypy_out=src/ --mypy_grpc_out=src/ ni/pythonpanel/v1/python_panel_service.proto`
 
 # Testing
 

pyproject.toml

@@ -10,6 +10,11 @@ packages = [{ include = "nipanel", from = "src" }, { include = "ni", from = "src
 python = "^3.9"
 grpcio = {version=">=1.49.0,<2.0"}
 protobuf = {version=">=4.21"}
+ni-measurement-plugin-sdk = {version=">=2.3"}
+
+[tool.poetry.group.dev.dependencies]
+grpc-stubs = "^1.53"
+types-protobuf = ">=4.21"
 
 [tool.poetry.group.lint.dependencies]
 bandit = { version = ">=1.7", extras = ["toml"] }
@@ -36,6 +41,9 @@ build-backend = "poetry.core.masonry.api"
 [tool.ni-python-styleguide]
 extend_exclude = ".tox,docs,src/ni/pythonpanel/v1"
 
+[tool.black]
+extend-exclude = '\.tox/|docs/|src/ni/pythonpanel/v1/'
+
 [tool.mypy]
 files = "examples/,src/nipanel/,tests/"
 namespace_packages = true

src/ni/pythonpanel/v1/python_panel_service_pb2.pyi

@@ -0,0 +1,144 @@
+"""
+@generated by mypy-protobuf.  Do not edit manually!
+isort:skip_file
+"""
+
+import builtins
+import google.protobuf.any_pb2
+import google.protobuf.descriptor
+import google.protobuf.message
+import typing
+
+DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
+
+@typing.final
+class ConnectRequest(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    PANEL_ID_FIELD_NUMBER: builtins.int
+    PANEL_URI_FIELD_NUMBER: builtins.int
+    panel_id: builtins.str
+    """Unique ID of the panel"""
+    panel_uri: builtins.str
+    """Absolute path of the panel's file on disk, or network path to the file"""
+    def __init__(
+        self,
+        *,
+        panel_id: builtins.str = ...,
+        panel_uri: builtins.str = ...,
+    ) -> None: ...
+    def ClearField(self, field_name: typing.Literal["panel_id", b"panel_id", "panel_uri", b"panel_uri"]) -> None: ...
+
+global___ConnectRequest = ConnectRequest
+
+@typing.final
+class ConnectResponse(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+
+global___ConnectResponse = ConnectResponse
+
+@typing.final
+class DisconnectRequest(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    PANEL_ID_FIELD_NUMBER: builtins.int
+    panel_id: builtins.str
+    """Unique ID of the panel"""
+    def __init__(
+        self,
+        *,
+        panel_id: builtins.str = ...,
+    ) -> None: ...
+    def ClearField(self, field_name: typing.Literal["panel_id", b"panel_id"]) -> None: ...
+
+global___DisconnectRequest = DisconnectRequest
+
+@typing.final
+class DisconnectResponse(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+
+global___DisconnectResponse = DisconnectResponse
+
+@typing.final
+class GetValueRequest(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    PANEL_ID_FIELD_NUMBER: builtins.int
+    VALUE_ID_FIELD_NUMBER: builtins.int
+    panel_id: builtins.str
+    """Unique ID of the panel"""
+    value_id: builtins.str
+    """Unique ID of value"""
+    def __init__(
+        self,
+        *,
+        panel_id: builtins.str = ...,
+        value_id: builtins.str = ...,
+    ) -> None: ...
+    def ClearField(self, field_name: typing.Literal["panel_id", b"panel_id", "value_id", b"value_id"]) -> None: ...
+
+global___GetValueRequest = GetValueRequest
+
+@typing.final
+class GetValueResponse(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    VALUE_FIELD_NUMBER: builtins.int
+    @property
+    def value(self) -> google.protobuf.any_pb2.Any:
+        """The value"""
+
+    def __init__(
+        self,
+        *,
+        value: google.protobuf.any_pb2.Any | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["value", b"value"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["value", b"value"]) -> None: ...
+
+global___GetValueResponse = GetValueResponse
+
+@typing.final
+class SetValueRequest(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    PANEL_ID_FIELD_NUMBER: builtins.int
+    VALUE_ID_FIELD_NUMBER: builtins.int
+    VALUE_FIELD_NUMBER: builtins.int
+    panel_id: builtins.str
+    """Unique ID of the panel"""
+    value_id: builtins.str
+    """Unique ID of the value"""
+    @property
+    def value(self) -> google.protobuf.any_pb2.Any:
+        """The value"""
+
+    def __init__(
+        self,
+        *,
+        panel_id: builtins.str = ...,
+        value_id: builtins.str = ...,
+        value: google.protobuf.any_pb2.Any | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["value", b"value"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["panel_id", b"panel_id", "value", b"value", "value_id", b"value_id"]) -> None: ...
+
+global___SetValueRequest = SetValueRequest
+
+@typing.final
+class SetValueResponse(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+
+global___SetValueResponse = SetValueResponse

src/ni/pythonpanel/v1/python_panel_service_pb2_grpc.pyi

@@ -0,0 +1,146 @@
+"""
+@generated by mypy-protobuf.  Do not edit manually!
+isort:skip_file
+"""
+
+import abc
+import collections.abc
+import grpc
+import grpc.aio
+import ni.pythonpanel.v1.python_panel_service_pb2
+import typing
+
+_T = typing.TypeVar("_T")
+
+class _MaybeAsyncIterator(collections.abc.AsyncIterator[_T], collections.abc.Iterator[_T], metaclass=abc.ABCMeta): ...
+
+class _ServicerContext(grpc.ServicerContext, grpc.aio.ServicerContext):  # type: ignore[misc, type-arg]
+    ...
+
+class PythonPanelServiceStub:
+    """Service interface for connecting to python panels"""
+
+    def __init__(self, channel: typing.Union[grpc.Channel, grpc.aio.Channel]) -> None: ...
+    Connect: grpc.UnaryUnaryMultiCallable[
+        ni.pythonpanel.v1.python_panel_service_pb2.ConnectRequest,
+        ni.pythonpanel.v1.python_panel_service_pb2.ConnectResponse,
+    ]
+    """Connect to a panel and open it
+    Status Codes for errors:
+    - NOT_FOUND: the file for the panel was not found
+    """
+
+    Disconnect: grpc.UnaryUnaryMultiCallable[
+        ni.pythonpanel.v1.python_panel_service_pb2.DisconnectRequest,
+        ni.pythonpanel.v1.python_panel_service_pb2.DisconnectResponse,
+    ]
+    """Disconnect from a panel (does not close the panel)
+    Status Codes for errors:
+    - NOT_FOUND: the panel with the specified id was not found
+    """
+
+    GetValue: grpc.UnaryUnaryMultiCallable[
+        ni.pythonpanel.v1.python_panel_service_pb2.GetValueRequest,
+        ni.pythonpanel.v1.python_panel_service_pb2.GetValueResponse,
+    ]
+    """Get a value for a control on the panel
+    Status Codes for errors:
+    - NOT_FOUND: the panel with the specified id was not found
+    """
+
+    SetValue: grpc.UnaryUnaryMultiCallable[
+        ni.pythonpanel.v1.python_panel_service_pb2.SetValueRequest,
+        ni.pythonpanel.v1.python_panel_service_pb2.SetValueResponse,
+    ]
+    """Set a value for a control on the panel
+    Status Codes for errors:
+    - NOT_FOUND: the panel with the specified id was not found
+    """
+
+class PythonPanelServiceAsyncStub:
+    """Service interface for connecting to python panels"""
+
+    Connect: grpc.aio.UnaryUnaryMultiCallable[
+        ni.pythonpanel.v1.python_panel_service_pb2.ConnectRequest,
+        ni.pythonpanel.v1.python_panel_service_pb2.ConnectResponse,
+    ]
+    """Connect to a panel and open it
+    Status Codes for errors:
+    - NOT_FOUND: the file for the panel was not found
+    """
+
+    Disconnect: grpc.aio.UnaryUnaryMultiCallable[
+        ni.pythonpanel.v1.python_panel_service_pb2.DisconnectRequest,
+        ni.pythonpanel.v1.python_panel_service_pb2.DisconnectResponse,
+    ]
+    """Disconnect from a panel (does not close the panel)
+    Status Codes for errors:
+    - NOT_FOUND: the panel with the specified id was not found
+    """
+
+    GetValue: grpc.aio.UnaryUnaryMultiCallable[
+        ni.pythonpanel.v1.python_panel_service_pb2.GetValueRequest,
+        ni.pythonpanel.v1.python_panel_service_pb2.GetValueResponse,
+    ]
+    """Get a value for a control on the panel
+    Status Codes for errors:
+    - NOT_FOUND: the panel with the specified id was not found
+    """
+
+    SetValue: grpc.aio.UnaryUnaryMultiCallable[
+        ni.pythonpanel.v1.python_panel_service_pb2.SetValueRequest,
+        ni.pythonpanel.v1.python_panel_service_pb2.SetValueResponse,
+    ]
+    """Set a value for a control on the panel
+    Status Codes for errors:
+    - NOT_FOUND: the panel with the specified id was not found
+    """
+
+class PythonPanelServiceServicer(metaclass=abc.ABCMeta):
+    """Service interface for connecting to python panels"""
+
+    @abc.abstractmethod
+    def Connect(
+        self,
+        request: ni.pythonpanel.v1.python_panel_service_pb2.ConnectRequest,
+        context: _ServicerContext,
+    ) -> typing.Union[ni.pythonpanel.v1.python_panel_service_pb2.ConnectResponse, collections.abc.Awaitable[ni.pythonpanel.v1.python_panel_service_pb2.ConnectResponse]]:
+        """Connect to a panel and open it
+        Status Codes for errors:
+        - NOT_FOUND: the file for the panel was not found
+        """
+
+    @abc.abstractmethod
+    def Disconnect(
+        self,
+        request: ni.pythonpanel.v1.python_panel_service_pb2.DisconnectRequest,
+        context: _ServicerContext,
+    ) -> typing.Union[ni.pythonpanel.v1.python_panel_service_pb2.DisconnectResponse, collections.abc.Awaitable[ni.pythonpanel.v1.python_panel_service_pb2.DisconnectResponse]]:
+        """Disconnect from a panel (does not close the panel)
+        Status Codes for errors:
+        - NOT_FOUND: the panel with the specified id was not found
+        """
+
+    @abc.abstractmethod
+    def GetValue(
+        self,
+        request: ni.pythonpanel.v1.python_panel_service_pb2.GetValueRequest,
+        context: _ServicerContext,
+    ) -> typing.Union[ni.pythonpanel.v1.python_panel_service_pb2.GetValueResponse, collections.abc.Awaitable[ni.pythonpanel.v1.python_panel_service_pb2.GetValueResponse]]:
+        """Get a value for a control on the panel
+        Status Codes for errors:
+        - NOT_FOUND: the panel with the specified id was not found
+        """
+
+    @abc.abstractmethod
+    def SetValue(
+        self,
+        request: ni.pythonpanel.v1.python_panel_service_pb2.SetValueRequest,
+        context: _ServicerContext,
+    ) -> typing.Union[ni.pythonpanel.v1.python_panel_service_pb2.SetValueResponse, collections.abc.Awaitable[ni.pythonpanel.v1.python_panel_service_pb2.SetValueResponse]]:
+        """Set a value for a control on the panel
+        Status Codes for errors:
+        - NOT_FOUND: the panel with the specified id was not found
+        """
+
+def add_PythonPanelServiceServicer_to_server(servicer: PythonPanelServiceServicer, server: typing.Union[grpc.Server, grpc.aio.Server]) -> None: ...