Merge pull request #16 from kamildemocko/feature/check-element

Feature/check element

Author: kamildemocko

pyproject.toml

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

pysapscript/window.py

@@ -247,6 +247,24 @@ def visualize(self, element: str, seconds: int = 1) -> None:
                 f"Error visualizing element {element}: {e}"
             )
 
+    def exists(self, element: str) -> bool:
+        """
+        checks if element exists by trying to access it
+
+        Args:
+            element (str): element to check
+
+        Returns:
+            bool: True if element exists, False otherwise
+        """
+
+        try:
+            self.session_handle.findById(element)
+            return True
+
+        except Exception:
+            return False
+
     def send_v_key(
         self,
         element: str = "wnd[0]",

readme.md

@@ -83,6 +83,7 @@ selected = window.is_selected(element)
 window.read(element)
 window.set_checkbox(value)
 window.visualize(element[, seconds=1])
+window.exists(element)
 
 table: ShellTable = window.read_shell_table(element)
 html_content = window.read_html_viewer(element)