Revert accidental changes

Author: greschd

src/ansys/tools/common/launcher/interface.py

@@ -22,11 +22,13 @@
 
 """Interface definitions for implementing a local product launcher.
 
-A plugin for the Local Product Launcher must implement the :class:`LauncherProtocol`
+A plugin for the local product launcher must implement the :class:`LauncherProtocol`
 class and register it.
 """
 
+from collections.abc import Mapping
 from enum import Enum, auto
+from types import MappingProxyType
 from typing import Any, ClassVar, Protocol, TypeVar, runtime_checkable
 
 from .grpc_transport import TransportOptionsType
@@ -119,7 +121,7 @@ class LauncherProtocol(Protocol[LAUNCHER_CONFIG_T]):
     used in the configuration CLI, if available.
     """
 
-    SERVER_SPEC: dict[str, ServerType]
+    SERVER_SPEC: ClassVar[Mapping[str, ServerType]] = MappingProxyType({})
     """Defines the server types that are started.
 
     Examples
@@ -130,7 +132,12 @@ class LauncherProtocol(Protocol[LAUNCHER_CONFIG_T]):
 
     .. code:: python
 
-        SERVER_SPEC = {"MAIN": ServerType.GENERIC, "FILE_TRANSFER": ServerType.GRPC}
+        SERVER_SPEC = MappingProxyType(
+            {
+                "MAIN": ServerType.GENERIC,
+                "FILE_TRANSFER": ServerType.GRPC,
+            }
+        )
 
     The :attr:`.ProductInstance.urls` attribute then has keys
     ``{"MAIN", "FILE_TRANSFER"}``, whereas the

src/ansys/tools/common/launcher/product_instance.py

@@ -103,15 +103,15 @@ def stop(self, *, timeout: float | None = None) -> None:
 
         Parameters
         ----------
-        timeout :
+        timeout : float, default: None
             Time in seconds after which the instance is forcefully stopped.
             Not all launch methods implement this parameter. If the parameter
             is not implemented, it is ignored.
 
         Raises
         ------
         ProductInstanceError
-            If the instance is already in the stopped state.
+            If the instance is already stopped.
         """
         if self.stopped:
             raise ProductInstanceError("Cannot stop the server. It has already been stopped.")
@@ -123,7 +123,7 @@ def restart(self, stop_timeout: float | None = None) -> None:
 
         Parameters
         ----------
-        stop_timeout :
+        stop_timeout : float, default: None
             Time in seconds after which the instance is forcefully stopped.
             Not all launch methods implement this parameter. If the parameter
             is not implemented, it is ignored.
@@ -141,7 +141,7 @@ def check(self, timeout: float | None = None) -> bool:
 
         Parameters
         ----------
-        timeout :
+        timeout : float, default: None
             Time in seconds to wait for the servers to respond. There
             is no guarantee that the ``check()`` method returns within this time.
             Instead, this parameter is used as a hint to the launcher implementation.
@@ -156,7 +156,7 @@ def wait(self, timeout: float) -> None:
 
         Parameters
         ----------
-        timeout :
+        timeout : float, default: None
             Wait time in seconds before raising an exception.
 
         Raises