From 3067b7258b30889eec0cf6052bb91812fa1c50c1 Mon Sep 17 00:00:00 2001
From: ansIAzehaf <107680473+iazehaf@users.noreply.github.com>
Date: Wed, 16 Aug 2023 17:05:55 +0200
Subject: [PATCH] Check hid if uid is provided. (#159)

Co-authored-by: PanekOndrej <108389964+PanekOndrej@users.noreply.github.com>
---
 src/ansys/optislang/core/server_commands.py | 33 ++++++++++++++++-----
 1 file changed, 25 insertions(+), 8 deletions(-)

diff --git a/src/ansys/optislang/core/server_commands.py b/src/ansys/optislang/core/server_commands.py
index a8fb281a0..eed43e5dd 100644
--- a/src/ansys/optislang/core/server_commands.py
+++ b/src/ansys/optislang/core/server_commands.py
@@ -752,9 +752,9 @@ def reset(actor_uid: str = None, hid: str = None, password: str = None) -> str:
     Parameters
     ----------
     actor_uid: str, opt
-        Actor uid entry.
+        Actor uid entry. A Hirearchical ID (hid) is required.
     hid: str, opt
-        Hid entry.
+        Hid entry. The actor uid is required.
     password : str, opt
         Password.
 
@@ -763,6 +763,10 @@ def reset(actor_uid: str = None, hid: str = None, password: str = None) -> str:
     str
         JSON string of ``reset`` command.
     """
+    if actor_uid and hid is None:
+        raise ValueError("The Hirearchical ID (hid) is required.")
+    elif actor_uid is None and hid:
+        raise ValueError("The actor uid is required.")
     return _to_json(
         _gen_server_command(command=_RESET, actor_uid=actor_uid, hid=hid, password=password)
     )
@@ -774,9 +778,9 @@ def restart(actor_uid: str = None, hid: str = None, password: str = None) -> str
     Parameters
     ----------
     actor_uid: str, opt
-        Actor uid entry.
+        Actor uid entry. A Hirearchical ID (hid) is required.
     hid: str, opt
-        Hid entry.
+        Hid entry. The actor uid is required.
     password : str, opt
         Password.
 
@@ -785,6 +789,10 @@ def restart(actor_uid: str = None, hid: str = None, password: str = None) -> str
     str
         JSON string of ``restart`` command.
     """
+    if actor_uid and hid is None:
+        raise ValueError("The Hirearchical ID (hid) is required.")
+    elif actor_uid is None and hid:
+        raise ValueError("The actor uid is required.")
     return _to_json(
         _gen_server_command(command=_RESTART, actor_uid=actor_uid, hid=hid, password=password)
     )
@@ -1316,9 +1324,9 @@ def stop(actor_uid: str = None, hid: str = None, password: str = None) -> str:
     Parameters
     ----------
     actor_uid: str, opt
-        Actor uid entry.
+        Actor uid entry. A Hirearchical ID (hid) is required.
     hid: str, opt
-        Hid entry.
+        Hid entry. The actor uid is required.
     password : str, opt
         Password.
 
@@ -1327,6 +1335,11 @@ def stop(actor_uid: str = None, hid: str = None, password: str = None) -> str:
     str
         JSON string of ``stop`` command.
     """
+    if actor_uid and hid is None:
+        raise ValueError("The Hirearchical ID (hid) is required.")
+    elif actor_uid is None and hid:
+        raise ValueError("The actor uid is required.")
+
     return _to_json(
         _gen_server_command(command=_STOP, actor_uid=actor_uid, hid=hid, password=password)
     )
@@ -1338,9 +1351,9 @@ def stop_gently(actor_uid: str = None, hid: str = None, password: str = None) ->
     Parameters
     ----------
     actor_uid: str, opt
-        Actor uid entry.
+        Actor uid entry. A Hirearchical ID (hid) is required.
     hid: str, opt
-        Hid entry.
+        Hid entry. The actor uid is required.
     password : str, opt
         Password.
 
@@ -1349,6 +1362,10 @@ def stop_gently(actor_uid: str = None, hid: str = None, password: str = None) ->
     str
         JSON string of ``stop_gently`` command.
     """
+    if actor_uid and hid is None:
+        raise ValueError("The Hirearchical ID (hid) is required.")
+    elif actor_uid is None and hid:
+        raise ValueError("The actor uid is required.")
     return _to_json(
         _gen_server_command(command=_STOP_GENTLY, actor_uid=actor_uid, hid=hid, password=password)
     )