added langauge flag to launch

Author: Kamil Democko

pyproject.toml

@@ -16,7 +16,7 @@ Documentation = "https://kamildemocko.github.io/pysapscript/"
 
 [tool.poetry]
 name = "pysapscript"
-version = "3.0.2"
+version = "3.0.3"
 description = "Automate SAP with python!"
 authors = ["Kamil Democko <[email protected]>"]
 readme = "README.md"

pysapscript/pysapscript.py

@@ -32,10 +32,16 @@ def __repr__(self) -> str:
     def __str__(self) -> str:
         return f"Sapscript(default_window_title={self.default_window_title})"
 
-    def launch_sap(self, *, root_sap_dir: Path = Path(r"C:\Program Files (x86)\SAP\FrontEnd\SAPgui"), 
-                   sid: str, client: str, 
-                   user: str, password: str, 
-                   maximise: bool = True, quit_auto: bool = True) -> None:
+    def launch_sap(self,
+                   sid: str,
+                   client: str,
+                   user: str,
+                   password: str,
+                   *,
+                   root_sap_dir: Path = Path(r"C:\Program Files (x86)\SAP\FrontEnd\SAPgui"),
+                   maximise: bool = True,
+                   language: str = "en",
+                   quit_auto: bool = True) -> None:
         """
         Launches SAP and waits for it to load
 
@@ -46,6 +52,7 @@ def launch_sap(self, *, root_sap_dir: Path = Path(r"C:\Program Files (x86)\SAP\F
             user (str): SAP user
             password (str): SAP password
             maximise (bool): maximises window after start if True
+            language (str): SAP language
             quit_auto (bool): quits automatically on SAP exit if True
 
         Raises:
@@ -67,7 +74,8 @@ def launch_sap(self, *, root_sap_dir: Path = Path(r"C:\Program Files (x86)\SAP\F
             client, 
             user, 
             password, 
-            maximise
+            maximise,
+            language
         )
 
         time.sleep(5)
@@ -165,7 +173,7 @@ def open_new_window(self, window_to_handle_opening: window.Window) -> None:
         utils.wait_for_window_title(self.default_window_title)
 
     def _launch(self, working_dir: Path, sid: str, client: str, 
-                user: str, password: str, maximise: bool) -> None:
+                user: str, password: str, maximise: bool, language: str) -> None:
         """
         launches sap from sapshcut.exe
         """
@@ -174,8 +182,12 @@ def _launch(self, working_dir: Path, sid: str, client: str,
         sap_executable = working_dir.joinpath("sapshcut.exe")
 
         maximise_sap = "-max" if maximise else ""
-        command = f"-system={sid} -client={client} "\
-            f"-user={user} -pw={password} {maximise_sap}"
+        language_sap = f"-language={language}" if language else ""
+
+        additional_args = " ".join([maximise_sap, language_sap])
+        command = " ".join([f"-system={sid} -client={client} "
+                            f"-user={user} -pw={password}",
+                            additional_args])
 
         tryouts = 2
         while tryouts > 0:

readme.md

@@ -41,6 +41,7 @@ additional parameters:
 
 `root_sap_dir = Path(r"C:\Program Files (x86)\SAP\FrontEnd\SAPgui")`  
 `maximise = True`  
+`language = "de"`  
 `quit_auto = True`
 
 ## Attach to an already opened window:

tests/manual_test.py

@@ -16,7 +16,8 @@ def __init__(self):
             client="006",
             user="robot01_t",
             password=str(pwd),
-            quit_auto=False
+            quit_auto=False,
+            language="sk"
         )
 
         self.window = self.pss.attach_window(0, 0)
@@ -69,7 +70,6 @@ def test_runs(self):
         window2.start_transaction("SQVI")
         window2.close_window()
 
-        # Quitting
         self.pss.quit()