robo_appian 0.0.18__py3-none-any.whl → 0.0.20__py3-none-any.whl

robo_appian/components/ButtonUtils.py

@@ -2,6 +2,7 @@ from selenium.webdriver.common.by import By
 from selenium.webdriver.support import expected_conditions as EC
 from selenium.webdriver.support.ui import WebDriverWait
 from selenium.webdriver.remote.webelement import WebElement
+from robo_appian.utils.ComponentUtils import ComponentUtils
 
 
 class ButtonUtils:
@@ -36,32 +37,18 @@ class ButtonUtils:
         """
         xpath = f".//button[./span[contains(translate(normalize-space(.), '\u00a0', ' '), '{label}')]]"
         try:
-            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+            component = ComponentUtils.findVisibleComponentByXpath(wait, xpath)
         except Exception as e:
-            raise RuntimeError(f"Button with label '{label}' not found or not clickable.") from e
+            raise Exception(f"Button with label '{label}' not found or not clickable.") from e
         return component
 
     @staticmethod
-    def _findByLabelText(wait: WebDriverWait, label: str):
-        """
-        Finds a button by its label.
-
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            label: The label of the button to find.
-            label: The label of the button to find.
-
-        Returns:
-            WebElement representing the button.
-
-        Example:
-            component = ButtonUtils._findByLabelText(wait, "Submit")
-        """
+    def __findByLabelText(wait: WebDriverWait, label: str):
         xpath = f".//button[./span[normalize-space(.)='{label}']]"
         try:
-            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+            component = ComponentUtils.findVisibleComponentByXpath(wait, xpath)
         except Exception as e:
-            raise RuntimeError(f"Button with label '{label}' not found or not clickable.") from e
+            raise Exception(f"Button with label '{label}' not found.") from e
         return component
 
     @staticmethod
@@ -87,7 +74,7 @@ class ButtonUtils:
             Example:
                 ButtonUtils.clickByLabelText(wait, "Button Label")
         """
-        component = ButtonUtils._findByLabelText(wait, label)
+        component = ButtonUtils.__findByLabelText(wait, label)
         ButtonUtils.__click(wait, component)
 
     @staticmethod
@@ -106,6 +93,41 @@ class ButtonUtils:
         try:
             component = wait.until(EC.element_to_be_clickable((By.ID, id)))
         except Exception as e:
-            raise RuntimeError(f"Input button with id '{id}' not found or not clickable.") from e
+            raise Exception(f"Input button with id '{id}' not found or not clickable.") from e
 
         ButtonUtils.__click(wait, component)
+
+    @staticmethod
+    def isButtonExistsByLabelText(wait: WebDriverWait, label: str):
+        xpath = f".//button[./span[normalize-space(.)='{label}']]"
+        try:
+            ComponentUtils.findComponentByXPath(wait, xpath)
+        except Exception:
+            return False
+        return True
+
+    @staticmethod
+    def isButtonExistsByPartialLabelText(wait: WebDriverWait, label: str):
+        xpath = f".//button[./span[contains(translate(normalize-space(.), '\u00a0', ' '), '{label}')]]"
+        try:
+            ComponentUtils.findComponentByXPath(wait, xpath)
+        except Exception:
+            return False
+        return True
+
+    @staticmethod
+    def isButtonExistsByPartialLabelTextAfterLoad(wait: WebDriverWait, label: str):
+        try:
+            ButtonUtils._findByPartialLabelText(wait, label)
+        except Exception:
+            return False
+        return True
+
+    @staticmethod
+    def waitForButtonToBeVisibleByPartialLabelText(wait: WebDriverWait, label: str):
+        xpath = f".//button[./span[contains(translate(normalize-space(.), '\u00a0', ' '), '{label}')]]"
+        try:
+            component = ComponentUtils.waitForComponentToBeVisibleByXpath(wait, xpath)
+        except Exception as e:
+            raise Exception(f"Button with partial label '{label}' not visible.") from e
+        return component

robo_appian/components/InputUtils.py

@@ -1,5 +1,4 @@
 from robo_appian.utils.ComponentUtils import ComponentUtils
-from selenium.webdriver.common.by import By
 from selenium.webdriver.support import expected_conditions as EC
 from selenium.webdriver.support.ui import WebDriverWait
 from selenium.webdriver.remote.webelement import WebElement
@@ -19,70 +18,53 @@ class InputUtils:
     """
 
     @staticmethod
-    def __findInputComponentsByXpath(wait: WebDriverWait, xpath: str):
+    def __findComponentByPartialLabel(wait: WebDriverWait, label: str):
         """
-        Finds input components by their XPath.
+        Finds an input component by its label text, allowing for partial matches.
 
         Parameters:
             wait: Selenium WebDriverWait instance.
-            xpath: The XPath expression to locate the input components.
+            label: The visible text label of the input component, allowing for partial matches.
 
         Returns:
-            A list of Selenium WebElement representing the input components.
+            A Selenium WebElement representing the input component.
 
         Example:
-            InputUtils.__findInputComponentsByXpath(wait, './/div/label[normalize-space(.)="Username"]')
+            InputUtils.__findInputComponentByPartialLabel(wait, "User")
         """
-        label_components = ComponentUtils.findComponentsByXPath(wait, xpath)
-        input_components = []
-        for label_component in label_components:
-            attribute: str = "for"
-            component_id = label_component.get_attribute(attribute)  # type: ignore[reportUnknownMemberType]
-            if component_id:
-                try:
-                    component = wait.until(EC.element_to_be_clickable((By.ID, component_id)))
-                    input_components.append(component)
-                except Exception as e:
-                    raise Exception(f"Could not find clickable input component with id '{component_id}': {e}")
-            else:
-                raise ValueError(f"Input component with label '{label_component.text}' does not have 'for' attribute.")
-        return input_components
-
-    @staticmethod
-    def __findInputComponentsByPartialLabel(wait: WebDriverWait, label: str):
-        """Finds input components by their label text, allowing for partial matches.
 
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            label: The visible text label of the input component, allowing for partial matches.
+        xpath = f'.//div/label[contains(normalize-space(.), "{label}")]'
+        label_component = ComponentUtils.findVisibleComponentByXpath(wait, xpath)
 
-        Returns:
-            A list of Selenium WebElement representing the input components.
+        input_id = label_component.get_attribute("for")
+        if input_id is None:
+            raise ValueError(f"Label component with text '{label}' does not have a 'for' attribute.")
 
-        Example:
-            InputUtils.__findInputComponentsByPartialLabel(wait, "Username")
-        """
-        xpath = f'.//div/label[contains(normalize-space(.), "{label}")]'
-        components = InputUtils.__findInputComponentsByXpath(wait, xpath)
-        return components
+        component = ComponentUtils.findComponentById(wait, input_id)
+        return component
 
     @staticmethod
-    def __findComponentsByLabel(wait: WebDriverWait, label: str):
-        """Finds input components by their label text.
-
+    def __findComponentByLabel(wait: WebDriverWait, label: str):
+        """Finds a component by its label text.
         Parameters:
             wait: Selenium WebDriverWait instance.
             label: The visible text label of the input component.
 
         Returns:
-            A list of Selenium WebElement representing the input components.
+            A Selenium WebElement representing the input component.
 
         Example:
-            InputUtils.__findComponentsByLabel(wait, "Username")
+            InputUtils.__findComponentByLabel(wait, "Username")
         """
+
         xpath = f'.//div/label[normalize-space(.)="{label}"]'
-        components = InputUtils.__findInputComponentsByXpath(wait, xpath)
-        return components
+        label_component = ComponentUtils.findVisibleComponentByXpath(wait, xpath)
+        input_id = label_component.get_attribute("for")
+        if input_id is None:
+            raise ValueError(f"Label component with text '{label}' does not have a 'for' attribute.")
+
+        component = ComponentUtils.findComponentById(wait, input_id)
+        return component
 
     @staticmethod
     def _setValueByComponent(wait: WebDriverWait, component: WebElement, value: str):
@@ -102,26 +84,20 @@ class InputUtils:
         return component
 
     @staticmethod
-    def __setValueByComponents(wait: WebDriverWait, input_components, value: str):
+    def setValueByPartialLabelText(wait: WebDriverWait, label: str, value: str):
         """
-        Sets a value in an input component identified by its label text.
+        Sets a value in an input component identified by its partial label text.
+
         Parameters:
             wait: Selenium WebDriverWait instance.
-            label: The visible text label of the input component.
+            label: The visible text label of the input component (partial match).
             value: The value to set in the input field.
+
         Returns:
             None
-        Example:
-            InputUtils.setValueByLabelText(wait, "Username", "test_user")
         """
-
-        for component in input_components:
-            InputUtils._setValueByComponent(wait, component, value)
-
-    @staticmethod
-    def setValueByPartialLabelText(wait: WebDriverWait, label: str, value: str):
-        input_components = InputUtils.__findInputComponentsByPartialLabel(wait, label)
-        InputUtils.__setValueByComponents(wait, input_components, value)
+        component = InputUtils.__findComponentByPartialLabel(wait, label)
+        InputUtils._setValueByComponent(wait, component, value)
 
     @staticmethod
     def setValueByLabelText(wait: WebDriverWait, label: str, value: str):
@@ -139,17 +115,17 @@ class InputUtils:
         Example:
             InputUtils.setValueByLabelText(wait, "Username", "test_user")
         """
-        input_components = InputUtils.__findComponentsByLabel(wait, label)
-        InputUtils.__setValueByComponents(wait, input_components, value)
+        component = InputUtils.__findComponentByLabel(wait, label)
+        InputUtils._setValueByComponent(wait, component, value)
 
     @staticmethod
-    def setValueById(wait: WebDriverWait, component_id: str, value: str):
+    def setValueById(wait: WebDriverWait, id: str, value: str):
         """
         Sets a value in an input component identified by its ID.
 
         Parameters:
             wait: Selenium WebDriverWait instance.
-            component_id: The ID of the input component.
+            id: The ID of the input component.
             value: The value to set in the input field.
 
         Returns:
@@ -158,9 +134,28 @@ class InputUtils:
         Example:
             InputUtils.setValueById(wait, "inputComponentId", "test_value")
         """
-        try:
-            component = wait.until(EC.element_to_be_clickable((By.ID, component_id)))
-        except Exception as e:
-            raise Exception(f"Timeout or error finding input component with id '{component_id}': {e}")
+        # try:
+        #     component = wait.until(EC.element_to_be_clickable((By.ID, component_id)))
+        # except Exception as e:
+        #     raise Exception(f"Timeout or error finding input component with id '{component_id}': {e}")
+        component = ComponentUtils.findComponentById(wait, id)
+        InputUtils._setValueByComponent(wait, component, value)
+
+    @staticmethod
+    def setValueByPlaceholderText(wait: WebDriverWait, text: str, value: str):
+        """Sets a value in an input component identified by its placeholder text.
+
+        Parameters:
+            wait: Selenium WebDriverWait instance.
+            text: The placeholder text of the input component.
+            value: The value to set in the input field.
+
+        Returns:
+            None
+
+        Example:
+            InputUtils.setValueByPlaceholderText(wait, "Enter your name", "John Doe")
+        """
+        xpath = f'.//input[@placeholder="{text}"]'
+        component = ComponentUtils.findVisibleComponentByXpath(wait, xpath)
         InputUtils._setValueByComponent(wait, component, value)
-        return component

robo_appian/components/LabelUtils.py

@@ -1,6 +1,7 @@
-from selenium.webdriver.common.by import By
 from selenium.webdriver.support import expected_conditions as EC
 from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.common.by import By
+from robo_appian.utils.ComponentUtils import ComponentUtils
 
 
 class LabelUtils:
@@ -24,11 +25,12 @@ class LabelUtils:
         Example:
             component = LabelUtils._findByLabelText(wait, "Submit")
         """
-        xpath = f".//*[normalize-space(.)='{label}']"
+        xpath = f'.//*[normalize-space(.)="{label}"]'
         try:
-            component = wait.until(EC.visibility_of_element_located((By.XPATH, xpath)))
+            # component = wait.until(EC.visibility_of_element_located((By.XPATH, xpath)))
+            component = ComponentUtils.findVisibleComponentByXpath(wait, xpath)
         except Exception as e:
-            raise RuntimeError(f"Label with text '{label}' not found.") from e
+            raise Exception(f"Label with text '{label}' not found.") from e
 
         return component
 
@@ -47,9 +49,27 @@ class LabelUtils:
         component.click()
 
     @staticmethod
-    def checkLabelExists(wait: WebDriverWait, label: str):
+    def isLabelExists(wait: WebDriverWait, label: str):
         try:
             LabelUtils.__findByLabelText(wait, label)
         except Exception:
             return False
         return True
+
+    @staticmethod
+    def isLabelExistsAfterLoad(wait: WebDriverWait, label: str):
+        try:
+            xpath = f'.//*[normalize-space(.)="{label}"]'
+            wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
+            wait.until(EC.visibility_of_element_located((By.XPATH, xpath)))
+        except Exception:
+            return False
+        return True
+
+    @staticmethod
+    def waitForLabelToBeVisible(wait: WebDriverWait, label: str):
+        try:
+            xpath = f'.//*[normalize-space(.)="{label}"]'
+            wait.until(EC.visibility_of_element_located((By.XPATH, xpath)))
+        except Exception as e:
+            raise Exception(f"Label with text '{label}' not found.") from e

robo_appian/components/LinkUtils.py

@@ -19,9 +19,10 @@ class LinkUtils:
 
     @staticmethod
     def find(wait: WebDriverWait, label: str):
-        xpath = f'.//a[normalize-space(.)="{label}"]'
+        # xpath = f'.//a[normalize-space(.)="{label}"]'
+        xpath = f'.//a[normalize-space(.)="{label}" and not(ancestor::*[@aria-hidden="true"])]'
         try:
-            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+            component = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
         except Exception as e:
             raise Exception(f"Could not find clickable link with label '{label}': {e}")
         return component
@@ -40,5 +41,6 @@ class LinkUtils:
         """
 
         component = LinkUtils.find(wait, label)
+        wait.until(EC.element_to_be_clickable(component))
         component.click()
         return component

robo_appian/components/SearchDropdownUtils.py

@@ -24,7 +24,7 @@ class SearchDropdownUtils:
             wait.until(EC.presence_of_element_located((By.ID, input_component_id)))
             input_component = wait.until(EC.element_to_be_clickable((By.ID, input_component_id)))
         except Exception as e:
-            raise RuntimeError(f"Failed to locate or click input component with ID '{input_component_id}': {e}")
+            raise Exception(f"Failed to locate or click input component with ID '{input_component_id}': {e}")
         InputUtils._setValueByComponent(wait, input_component, value)
 
         dropdown_option_id = str(component_id) + "_list"
@@ -33,7 +33,7 @@ class SearchDropdownUtils:
         try:
             component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
         except Exception as e:
-            raise RuntimeError(f"Failed to locate or click dropdown option with XPath '{xpath}': {e}")
+            raise Exception(f"Failed to locate or click dropdown option with XPath '{xpath}': {e}")
         component.click()
 
     @staticmethod
@@ -42,7 +42,7 @@ class SearchDropdownUtils:
         try:
             combobox = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
         except Exception as e:
-            raise RuntimeError(f"Failed to locate or click dropdown component with XPath '{xpath}': {e}")
+            raise Exception(f"Failed to locate or click dropdown component with XPath '{xpath}': {e}")
 
         SearchDropdownUtils._selectSearchDropdownValueByComboboxComponent(wait, combobox, value)
 
@@ -54,7 +54,7 @@ class SearchDropdownUtils:
         try:
             combobox = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
         except Exception as e:
-            raise RuntimeError(f"Failed to locate or click dropdown component with XPath '{xpath}': {e}")
+            raise Exception(f"Failed to locate or click dropdown component with XPath '{xpath}': {e}")
         SearchDropdownUtils._selectSearchDropdownValueByComboboxComponent(wait, combobox, value)
 
     @staticmethod
@@ -63,7 +63,7 @@ class SearchDropdownUtils:
         if id is not None:
             component_id = id.rsplit("_value", 1)[0]
         else:
-            raise RuntimeError("Combobox element does not have an 'id' attribute.")
+            raise Exception("Combobox element does not have an 'id' attribute.")
 
         wait.until(EC.element_to_be_clickable(combobox))
         combobox.click()

robo_appian/components/SearchInputUtils.py

@@ -33,7 +33,7 @@ class SearchInputUtils:
                     drop_down_item = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
                     drop_down_item = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
                 except Exception as e:
-                    raise RuntimeError(
+                    raise Exception(
                         f"Dropdown item with value '{value}' not found for component '{search_input_component.text}'."
                     ) from e
                 drop_down_item.click()

robo_appian/components/TableUtils.py

@@ -21,30 +21,6 @@ class TableUtils:
 
     """
 
-    @staticmethod
-    def findTableByColumnName(wait: WebDriverWait, columnName: str):
-        """
-        Finds a table component by its column name.
-
-        :param wait: Selenium WebDriverWait instance.
-        :param columnName: The name of the column to search for.
-        :return: WebElement representing the table.
-        Example:
-            component = TableUtils.findTableByColumnName(wait, "Status")
-        """
-
-        xpath = f'.//table[./thead/tr/th[@abbr="{columnName}"]]'
-        try:
-            component = wait.until(EC.visibility_of_element_located((By.XPATH, xpath)))
-        except Exception as e:
-            raise Exception(f"Could not find table with column name '{columnName}': {e}")
-
-        try:
-            component = wait.until(EC.element_to_be_clickable(component))
-        except Exception as e:
-            raise Exception(f"Table found by column name '{columnName}' is not clickable: {e}")
-        return component
-
     @staticmethod
     def rowCount(tableObject):
         """
@@ -98,7 +74,8 @@ class TableUtils:
 
     @staticmethod
     def __findRowByColumnNameAndRowNumber(wait, rowNumber, columnName):
-        xpath = f'.//table[./thead/tr/th/div[normalize-space(.)="{columnName}"] ]/tbody/tr[@data-dnd-name="row {rowNumber + 1}"]'
+        # xpath = f'.//table[./thead/tr/th/div[normalize-space(.)="{columnName}"] ]/tbody/tr[@data-dnd-name="row {rowNumber + 1}"]'
+        xpath = f'.//table[./thead/tr/th[@abbr="{columnName}"]]/tbody/tr[@data-dnd-name="row {rowNumber + 1}" and not(ancestor::*[@aria-hidden="true"])]'
         row = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
         return row
 
@@ -134,7 +111,8 @@ class TableUtils:
 
     @staticmethod
     def findComponentByColumnNameAndRowNumber(wait, rowNumber, columnName):
-        xpath = f'.//table/thead/tr/th[./div[normalize-space(.)="{columnName}"]]'
+        # xpath = f'.//table/thead/tr/th[./div[normalize-space(.)="{columnName}"]]'
+        xpath = f'.//table/thead/tr/th[@abbr="{columnName}" and not(ancestor::*[@aria-hidden="true"]) ]'
         column = wait.until(EC.visibility_of_element_located((By.XPATH, xpath)))
         id = column.get_attribute("id")
         parts = id.rsplit("_", 1)
@@ -145,3 +123,27 @@ class TableUtils:
         component = ComponentUtils.findChildComponentByXpath(wait, tableRow, xpath)
         component = wait.until(EC.element_to_be_clickable(component))
         return component
+
+    @staticmethod
+    def findTableByColumnName(wait: WebDriverWait, columnName: str):
+        """
+        Finds a table component by its column name.
+
+        :param wait: Selenium WebDriverWait instance.
+        :param columnName: The name of the column to search for.
+        :return: WebElement representing the table.
+        Example:
+            component = TableUtils.findTableByColumnName(wait, "Status")
+        """
+
+        xpath = f'.//table[./thead/tr/th[@abbr="{columnName}"]]'
+        try:
+            component = wait.until(EC.visibility_of_element_located((By.XPATH, xpath)))
+        except Exception as e:
+            raise Exception(f"Could not find table with column name '{columnName}': {e}")
+
+        try:
+            component = wait.until(EC.element_to_be_clickable(component))
+        except Exception as e:
+            raise Exception(f"Table found by column name '{columnName}' is not clickable: {e}")
+        return component

robo_appian/controllers/ComponentDriver.py

@@ -56,7 +56,7 @@ class ComponentDriver:
             case "Label":
                 match action:
                     case "Find":
-                        LabelUtils.checkLabelExists(wait, label)
+                        LabelUtils.isLabelExists(wait, label)
                     case _:
                         raise ValueError(f"Unsupported action for {type}: {action}")
             case "Link":

robo_appian/utils/ComponentUtils.py

@@ -58,36 +58,38 @@ class ComponentUtils:
         return component
 
     @staticmethod
-    def findComponentUsingXpathAndClick(wait: WebDriverWait, xpath: str):
-        """Finds a component using the given XPath and clicks it.
+    def findComponentById(wait: WebDriverWait, id: str):
+        try:
+            component = wait.until(EC.presence_of_element_located((By.ID, id)))
+        except Exception:
+            raise Exception(f"Component with ID '{id}' not found.")
+        return component
 
-        :param wait: WebDriverWait instance to wait for elements
-        :param xpath: XPath string to locate the component
-        :return: None
-        Example usage:
-        from selenium.webdriver.support.ui import WebDriverWait
-        from selenium import webdriver
+    @staticmethod
+    def waitForComponentToBeVisibleByXpath(wait: WebDriverWait, xpath: str):
+        try:
+            component = wait.until(EC.visibility_of_element_located((By.XPATH, xpath)))
+        except Exception:
+            raise Exception(f"Component with XPath '{xpath}' not visible.")
+        return component
 
-        driver = webdriver.Chrome()
-        wait = WebDriverWait(driver, 10)
-        xpath = "//button[@id='submit']"
-        ComponentUtils.findComponentUsingXpathAndClick(wait, xpath)
+    @staticmethod
+    def findVisibleComponentByXpath(wait: WebDriverWait, xpath: str):
         """
-        component = ComponentUtils.findComponentUsingXpath(wait, xpath)
-        component.click()
+        Finds a component using the given XPath in the current WebDriver instance.
 
-    @staticmethod
-    def findComponentUsingXpath(wait: WebDriverWait, xpath: str):
-        """Finds a component using the given XPath in the current WebDriver instance.
+            :param wait: WebDriverWait instance to wait for elements
+            :param xpath: XPath string to locate the component
+            :return: WebElement if found, raises NoSuchElementException otherwise
 
-        :param wait: WebDriverWait instance to wait for elements
-        :param xpath: XPath string to locate the component
-        :return: WebElement if found, raises NoSuchElementException otherwise
         Example usage:
-        component = ComponentUtils.findComponentUsingXpath(wait, "//button[@id='submit']")
-        component.click()
+            component = ComponentUtils.findVisibleComponentByXpath(wait, "//button[@id='submit']")
+            component.click()
         """
-        component = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
+        try:
+            component = wait.until(EC.visibility_of_element_located((By.XPATH, xpath)))
+        except Exception:
+            raise Exception(f"Component with XPath '{xpath}' not visible.")
         return component
 
     @staticmethod
@@ -95,7 +97,7 @@ class ComponentUtils:
         """Checks if a component with the given XPath exists in the current WebDriver instance."""
         status = False
         try:
-            ComponentUtils.findComponentUsingXpath(wait, xpath)
+            ComponentUtils.findVisibleComponentByXpath(wait, xpath)
             status = True
         except NoSuchElementException:
             pass
@@ -190,3 +192,50 @@ class ComponentUtils:
             return valid_components
 
         raise Exception(f"No valid components found for XPath: {xpath}")
+
+    @staticmethod
+    def findComponentByXPath(wait: WebDriverWait, xpath: str):
+        # component = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
+        component = wait._driver.find_element(By.XPATH, xpath)
+        return component
+
+    @staticmethod
+    def findComponentUsingXpathAndClick(wait: WebDriverWait, xpath: str):
+        """Finds a component using the given XPath and clicks it.
+
+        :param wait: WebDriverWait instance to wait for elements
+        :param xpath: XPath string to locate the component
+        :return: None
+        Example usage:
+        from selenium.webdriver.support.ui import WebDriverWait
+        from selenium import webdriver
+
+        driver = webdriver.Chrome()
+        wait = WebDriverWait(driver, 10)
+        xpath = "//button[@id='submit']"
+        ComponentUtils.findComponentUsingXpathAndClick(wait, xpath)
+        """
+
+        component = ComponentUtils.findVisibleComponentByXpath(wait, xpath)
+        ComponentUtils.click(wait, component)
+
+    @staticmethod
+    def click(wait: WebDriverWait, component: WebElement):
+        """
+        Clicks the given component after waiting for it to be clickable.
+
+            :param wait: WebDriverWait instance to wait for elements
+            :param component: WebElement representing the component to click
+            :return: None
+        Example usage:
+            ComponentUtils.click(wait, component)
+        """
+        wait.until(EC.element_to_be_clickable(component))
+        component.click()
+
+    @staticmethod
+    def waitForComponentToBeInVisible(wait: WebDriverWait, component: WebElement):
+        try:
+            wait.until(EC.staleness_of(component))
+        except Exception:
+            raise Exception("Component did not become invisible (stale) within the timeout period.")

{robo_appian-0.0.18.dist-info → robo_appian-0.0.20.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: robo_appian
-Version: 0.0.18
+Version: 0.0.20
 Summary: Automate your Appian code testing with Python. Boost quality, save time.
 Author: Dinil Mithra
 Author-email: dinilmithra@mailme@gmail.com

robo_appian-0.0.20.dist-info/RECORD

@@ -0,0 +1,22 @@
+robo_appian/__init__.py,sha256=6u9n2W7P1IKSSr5IPGsg7LhVR1o1uYv424mXDjJLgb0,720
+robo_appian/components/ButtonUtils.py,sha256=JjI81SsSqBGkX4A8c2EiQDfC1L3fkxp2s1Lzr51rUpI,4858
+robo_appian/components/DateUtils.py,sha256=3iptq3IDCy4IwefEyPtvEQ1nUFI1OVpTF3dAnViHIoM,3258
+robo_appian/components/DropdownUtils.py,sha256=X_ucR4uCiU3fnsMXGnJC9PTfwbfW3w3ulzyuURh1Vlw,11149
+robo_appian/components/InputUtils.py,sha256=78O7G8mNjEBVdrZUjlL9PMvDzTZ9uHEm0rDB5MsuYRQ,6050
+robo_appian/components/LabelUtils.py,sha256=1BDbgIVzxQJv5JkWWcmkd5QGrAjQvtUSZVc49gzyT0c,2711
+robo_appian/components/LinkUtils.py,sha256=32_0mW-j624Be9xlFZAkZsLjJ2OaORfp-ePSRyFwTfs,1549
+robo_appian/components/SearchDropdownUtils.py,sha256=sX9b__Rir7feH1SkCd53EeLJXO7OTLkeA1FMbZU_CNs,4504
+robo_appian/components/SearchInputUtils.py,sha256=2mg1QkEZGVJ-rLTvB0pMNSKvNhiqOU9QrUH0CNr4la4,3260
+robo_appian/components/TabUtils.py,sha256=k-HkIK8ca-KnHXSDTXDV4190jT5P84tZ3frWSCndn5I,2257
+robo_appian/components/TableUtils.py,sha256=_NBytGtP0EzBkjzrffpQ-pm3PoRPUykUvEwTcXu0xPk,6322
+robo_appian/components/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+robo_appian/controllers/ComponentDriver.py,sha256=4zKn6Jy71cFsGWqOh7EgQ6NYfRIVvi5l5Pn31tLLM9s,4350
+robo_appian/controllers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+robo_appian/exceptions/MyCustomError.py,sha256=DVAkytXNNQNjqyTyCjk6FFd6fr3AsBe57Y19erDSqVs,222
+robo_appian/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+robo_appian/utils/ComponentUtils.py,sha256=qm_55lVSuyu6o5NkqD4N8fSzAxVBxLIlMzzOVomxZiA,8940
+robo_appian/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+robo_appian-0.0.20.dist-info/LICENSE,sha256=g-xR4dRa9_4iFkMoJmED-wE-J5hoxbk3105Knhfpjm0,1068
+robo_appian-0.0.20.dist-info/METADATA,sha256=8lqgIdQ88C-EvlwwfUXVG2KivdrLIPlwllt4qoAJicQ,2261
+robo_appian-0.0.20.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+robo_appian-0.0.20.dist-info/RECORD,,

robo_appian-0.0.18.dist-info/RECORD

@@ -1,22 +0,0 @@
-robo_appian/__init__.py,sha256=6u9n2W7P1IKSSr5IPGsg7LhVR1o1uYv424mXDjJLgb0,720
-robo_appian/components/ButtonUtils.py,sha256=qFe84Pv3J64X2oqBvbOEnyZPudcCOK_Rrz-PAEAahM4,3874
-robo_appian/components/DateUtils.py,sha256=3iptq3IDCy4IwefEyPtvEQ1nUFI1OVpTF3dAnViHIoM,3258
-robo_appian/components/DropdownUtils.py,sha256=X_ucR4uCiU3fnsMXGnJC9PTfwbfW3w3ulzyuURh1Vlw,11149
-robo_appian/components/InputUtils.py,sha256=LNPNX2TYubPS7sgOx329JPixTrbtZZ7XhhpUolC9XYw,6514
-robo_appian/components/LabelUtils.py,sha256=Fue3BDpqvHKGK_vBOtMld3Lai3ZQ2wzZPeQJESrjUF8,1860
-robo_appian/components/LinkUtils.py,sha256=_m9dpHW9mUJFMcLp95K2s-YDYAvG-RlPF6giw3dmYcE,1389
-robo_appian/components/SearchDropdownUtils.py,sha256=rjsC3kd8Z-eHAAzF4OBJVchStRV5pCB2dtpVEL6cdCQ,4519
-robo_appian/components/SearchInputUtils.py,sha256=7sI8D6MXDzBPwbkIQodtxvXD2aA-8HiqvDCEJUlekZo,3263
-robo_appian/components/TabUtils.py,sha256=k-HkIK8ca-KnHXSDTXDV4190jT5P84tZ3frWSCndn5I,2257
-robo_appian/components/TableUtils.py,sha256=SmtB4jq0XGZc0smMTe1HRvcCurQTXz3CytswbogfwTY,6059
-robo_appian/components/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-robo_appian/controllers/ComponentDriver.py,sha256=jNaQrbKCFFyahpLKmipsA0v3p3bpjy9dMgW36IdE-Fw,4353
-robo_appian/controllers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-robo_appian/exceptions/MyCustomError.py,sha256=DVAkytXNNQNjqyTyCjk6FFd6fr3AsBe57Y19erDSqVs,222
-robo_appian/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-robo_appian/utils/ComponentUtils.py,sha256=sHHT-mcdhZs9hHIAVD3KkrgLFXn4gIo58NsHHhI156w,7088
-robo_appian/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-robo_appian-0.0.18.dist-info/LICENSE,sha256=g-xR4dRa9_4iFkMoJmED-wE-J5hoxbk3105Knhfpjm0,1068
-robo_appian-0.0.18.dist-info/METADATA,sha256=kbjqustBLua2sfLOP3uhL7awiy4Ykl6Y4nmnnY7ZpcA,2261
-robo_appian-0.0.18.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-robo_appian-0.0.18.dist-info/RECORD,,