robo_appian 0.0.9__py3-none-any.whl → 0.0.11__py3-none-any.whl

robo_appian/components/ButtonUtils.py

@@ -4,49 +4,13 @@ from selenium.webdriver.support.ui import WebDriverWait
 
 
 class ButtonUtils:
-    """
-    Utility class for interacting with button elements in Selenium-based Appian UI automation.
-
-        Usage Example:
-
-        from selenium.webdriver.support.ui import WebDriverWait
-        from robo_appian.components.ButtonUtils import ButtonUtils
-
-        wait = WebDriverWait(driver, 10)
-        ButtonUtils.click(wait, "Login")
-
-    """
-
     @staticmethod
     def find(wait: WebDriverWait, label: str):
-        """
-        Finds a button element by its label.
-
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            label: The visible text label of the button.
-
-        Returns:
-            The Selenium WebElement for the button.
-
-        Example:
-            ButtonUtils.find(wait, "Submit")
-
-        """
-
-        # This method locates a button that contains a span with the specified label text.
-
         xpath = f".//button[./span[contains(translate(normalize-space(.), '\u00a0', ' '), '{label}')]]"
         try:
             component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-        except TimeoutError as e:
-            raise TimeoutError(
-                f"Button with label '{label}' not found or not clickable."
-            ) from e
         except Exception as e:
-            raise RuntimeError(
-                f"Button with label '{label}' not found or not clickable."
-            ) from e
+            raise RuntimeError(f"Button with label '{label}' not found or not clickable.") from e
         return component
 
     @staticmethod
@@ -80,12 +44,8 @@ class ButtonUtils:
         try:
             component = wait.until(EC.element_to_be_clickable((By.ID, id)))
         except TimeoutError as e:
-            raise TimeoutError(
-                f"Input button with id '{id}' not found or not clickable."
-            ) from e
+            raise TimeoutError(f"Input button with id '{id}' not found or not clickable.") from e
         except Exception as e:
-            raise RuntimeError(
-                f"Input button with id '{id}' not found or not clickable."
-            ) from e
+            raise RuntimeError(f"Input button with id '{id}' not found or not clickable.") from e
 
         component.click()

robo_appian/components/DateUtils.py

@@ -116,7 +116,7 @@ class DateUtils:
         # It sets the value of the input element and submits it.
 
         component = DateUtils.findComponent(wait, label)
-        InputUtils.setValueAndSubmitUsingComponent(component, value)
+        InputUtils.setValueAndSubmitByComponent(component, value)
 
         return component
 

robo_appian/components/DropdownUtils.py

@@ -2,176 +2,131 @@ 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.components.InputUtils import InputUtils
+from selenium.common.exceptions import NoSuchElementException
 
 
 class DropdownUtils:
     """
     Utility class for interacting with dropdown components in Appian UI.
-
-        Usage Example:
-
+    Usage Example:
         # Select a value from a dropdown
         from robo_appian.components.DropdownUtils import DropdownUtils
         DropdownUtils.selectDropdownValueByLabelText(wait, "Status", "Approved")
-
-        # Select a value from a search dropdown
-        from robo_appian.components.DropdownUtils import DropdownUtils
-        DropdownUtils.selectSearchDropdownValueByLabelText(wait, "Category", "Finance")
     """
 
     @staticmethod
-    def __findDropdownComponentsByXpath(wait: WebDriverWait, xpath: str):
+    def __findComboboxByPartialLabelText(wait: WebDriverWait, label: str):
+        xpath = f'.//div[./div/span[contains(normalize-space(text()), "{label}")]]/div/div/div/div[@role="combobox" and not(@aria-disabled="true")]'
         try:
-            # Wait for at least one element to be present
-            try:
-                wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-            except TimeoutError as e:
-                raise TimeoutError(
-                    f'No clickable dropdown component found for xpath "{xpath}": {str(e)}'
-                )
-            except Exception as e:
-                raise Exception(
-                    f'No clickable dropdown component found for xpath "{xpath}": {str(e)}'
-                )
+            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        except Exception as e:
+            raise Exception(f'Could not find combobox with partial label "{label}" : {str(e)}')
 
-            # Find all matching elements
-            driver = wait._driver
-            components = driver.find_elements(By.XPATH, xpath)
+        return component
 
-            # Filter for clickable and displayed components
-            valid_components = []
-            for component in components:
-                try:
-                    if component.is_displayed() and component.is_enabled():
-                        valid_components.append(component)
-                except Exception:
-                    continue
+    @staticmethod
+    def __findComboboxByLabelText(wait: WebDriverWait, label: str):
+        xpath = f'.//div[./div/span[normalize-space(text())="{label}"]]/div/div/div/div[@role="combobox" and not(@aria-disabled="true")]'
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        except Exception as e:
+            raise Exception(f'Could not find combobox with label "{label}" : {str(e)}')
 
-            if not valid_components:
-                raise Exception(
-                    f'No valid dropdown components with xpath "{xpath}" found.'
-                )
+        return component
 
-            # Return single component if only one found, list if multiple
-            return valid_components
+    @staticmethod
+    def __clickCombobox(wait: WebDriverWait, combobox: WebElement):
+        combobox.click()
 
-        except Exception as e:
-            raise Exception(
-                f'Dropdown component with xpath "{xpath}" not found: {str(e)}'
-            )
+    @staticmethod
+    def __findDropdownOptionId(wait: WebDriverWait, combobox: WebElement):
+        dropdown_option_id = combobox.get_attribute("aria-controls")
+        if dropdown_option_id is None:
+            raise Exception('Dropdown component does not have a valid "aria-controls" attribute.')
+        return dropdown_option_id
 
     @staticmethod
-    def selectDropdownValueByComponent(wait, combobox, value):
-        dropdown_id = combobox.get_attribute("aria-controls")
-        combobox.click()
+    def __checkDropdownOptionValueExistsByDropdownOptionId(wait: WebDriverWait, dropdown_option_id: str, value: str):
+        option_xpath = f'.//div/ul[@id="{dropdown_option_id}"]/li[./div[normalize-space(text())="{value}"]]'
+        try:
+            wait.until(EC.element_to_be_clickable((By.XPATH, option_xpath)))
+            return True
+        except NoSuchElementException:
+            return False
+        except Exception as e:
+            raise Exception(f'Could not find dropdown option "{value}" with dropdown option id "{dropdown_option_id}": {str(e)}')
 
-        option_xpath = f'.//div/ul[@id="{dropdown_id}"]/li[./div[normalize-space(text())="{value}"]]'
+    @staticmethod
+    def __selectDropdownValueByDropdownOptionId(wait: WebDriverWait, dropdown_option_id: str, value: str):
+        option_xpath = f'.//div/ul[@id="{dropdown_option_id}"]/li[./div[normalize-space(text())="{value}"]]'
         try:
-            component = wait.until(
-                EC.presence_of_element_located((By.XPATH, option_xpath))
-            )
-            component = wait.until(EC.element_to_be_clickable((By.XPATH, option_xpath)))
-        except TimeoutError as e:
-            raise TimeoutError(
-                f'Could not find or click dropdown option "{value}" with xpath "{option_xpath}": {str(e)}'
-            )
+            try:
+                component = wait.until(EC.presence_of_element_located((By.XPATH, option_xpath)))
+                component = wait.until(EC.element_to_be_clickable((By.XPATH, option_xpath)))
+            except Exception as e:
+                raise Exception(
+                    f'Could not locate or click dropdown option "{value}" with dropdown option id "{dropdown_option_id}": {str(e)}'
+                )
         except Exception as e:
-            raise Exception(
-                f'Could not find or click dropdown option "{value}" with xpath "{option_xpath}": {str(e)}'
-            )
+            raise Exception(f'Could not find or click dropdown option "{value}" with xpath "{option_xpath}": {str(e)}')
         component.click()
 
     @staticmethod
-    def __selectDropdownValueByXpath(wait, xpath, value):
-        components = DropdownUtils.__findDropdownComponentsByXpath(wait, xpath)
-        for combobox in components:
-            if combobox.is_displayed() and combobox.is_enabled():
-                DropdownUtils.selectDropdownValueByComponent(wait, combobox, value)
+    def __selectDropdownValueByPartialLabelText(wait: WebDriverWait, label: str, value: str):
+        """
+        Selects a value from a dropdown by its label text.
+
+        :param wait: WebDriverWait instance to wait for elements.
+        :param label: The label of the dropdown.
+        :param value: The value to select from the dropdown.
+        """
+        combobox = DropdownUtils.__findComboboxByPartialLabelText(wait, label)
+        DropdownUtils.__clickCombobox(wait, combobox)
+        dropdown_option_id = DropdownUtils.__findDropdownOptionId(wait, combobox)
+        DropdownUtils.__selectDropdownValueByDropdownOptionId(wait, dropdown_option_id, value)
 
     @staticmethod
-    def selectDropdownValueByLabelText(
-        wait: WebDriverWait, dropdown_label: str, value: str
-    ):
-        xpath = f'.//div[./div/span[normalize-space(text())="{dropdown_label}"]]/div/div/div/div[@role="combobox" and @tabindex="0"]'
-        DropdownUtils.__selectDropdownValueByXpath(wait, xpath, value)
+    def __selectDropdownValueByLabelText(wait: WebDriverWait, label: str, value: str):
+        """
+        Selects a value from a dropdown by its label text.
+
+        :param wait: WebDriverWait instance to wait for elements.
+        :param label: The label of the dropdown.
+        :param value: The value to select from the dropdown.
+        """
+        combobox = DropdownUtils.__findComboboxByLabelText(wait, label)
+        DropdownUtils.__clickCombobox(wait, combobox)
+        dropdown_option_id = DropdownUtils.__findDropdownOptionId(wait, combobox)
+        DropdownUtils.__selectDropdownValueByDropdownOptionId(wait, dropdown_option_id, value)
 
     @staticmethod
-    def selectDropdownValueByPartialLabelText(
-        wait: WebDriverWait, dropdown_label: str, value: str
-    ):
-        xpath = f'.//div[./div/span[contains(normalize-space(text()), "{dropdown_label}")]]/div/div/div/div[@role="combobox" and @tabindex="0"]'
-        DropdownUtils.__selectDropdownValueByXpath(wait, xpath, value)
+    def checkReadOnlyStatusByLabelText(wait: WebDriverWait, label: str):
+        xpath = f'.//div[./div/span[normalize-space(text())="{label}"]]/div/div/p[text()]'
+        try:
+            wait._driver.find_element(By.XPATH, xpath)
+            return True
+        except NoSuchElementException:
+            return False
+        except Exception:
+            raise Exception(f'Error checking read-only status for label "{label}"')
 
     @staticmethod
-    def __selectSearchDropdownValueByXpath(wait, xpath, value):
-        components = DropdownUtils.__findDropdownComponentsByXpath(wait, xpath)
-
-        for component in components:
-            if component.is_displayed() and component.is_enabled():
-                component_id = component.get_attribute("aria-labelledby")  # type: ignore[reportUnknownMemberType]
-                dropdown_id = component.get_attribute("aria-controls")  # type: ignore[reportUnknownMemberType]
-                component.click()
-
-                input_component_id = str(component_id) + "_searchInput"
-                try:
-                    input_component = wait.until(
-                        EC.element_to_be_clickable((By.ID, input_component_id))
-                    )
-                except TimeoutError as e:
-                    raise TimeoutError(
-                        f'Could not find or click search input component with id "{input_component_id}": {str(e)}'
-                    )
-                except Exception as e:
-                    raise Exception(
-                        f'Could not find or click search input component with id "{input_component_id}": {str(e)}'
-                    )
-                InputUtils._setComponentValue(input_component, value)
-
-                xpath = f'.//ul[@id="{dropdown_id}"]/li[./div[normalize-space(text())="{value}"]][1]'
-                try:
-                    component = wait.until(
-                        EC.element_to_be_clickable((By.XPATH, xpath))
-                    )
-                except TimeoutError as e:
-                    raise TimeoutError(
-                        f'Could not find or click search dropdown option "{value}" with xpath "{xpath}": {str(e)}'
-                    )
-                except Exception as e:
-                    raise Exception(
-                        f'Could not find or click search dropdown option "{value}" with xpath "{xpath}": {str(e)}'
-                    )
-                component.click()
+    def selectDropdownValueByComboboxComponent(wait: WebDriverWait, combobox: WebElement, value: str):
+        dropdown_option_id = DropdownUtils.__findDropdownOptionId(wait, combobox)
+        DropdownUtils.__clickCombobox(wait, combobox)
+        DropdownUtils.__selectDropdownValueByDropdownOptionId(wait, dropdown_option_id, value)
 
     @staticmethod
-    def selectSearchDropdownValueByLabelText(
-        wait: WebDriverWait, dropdown_label: str, value: str
-    ):
-        xpath = f'.//div[./div/span[normalize-space(text())="{dropdown_label}"]]/div/div/div/div[@role="combobox" and @tabindex="0"]'
-        DropdownUtils.__selectSearchDropdownValueByXpath(wait, xpath, value)
+    def selectDropdownValueByLabelText(wait: WebDriverWait, dropdown_label: str, value: str):
+        DropdownUtils.__selectDropdownValueByLabelText(wait, dropdown_label, value)
 
     @staticmethod
-    def selectSearchDropdownValueByPartialLabelText(
-        wait: WebDriverWait, dropdown_label: str, value: str
-    ):
-        xpath = f'.//div[./div/span[contains(normalize-space(text()), "{dropdown_label}")]]/div/div/div/div[@role="combobox" and @tabindex="0"]'
-        DropdownUtils.__selectSearchDropdownValueByXpath(wait, xpath, value)
+    def selectDropdownValueByPartialLabelText(wait: WebDriverWait, dropdown_label: str, value: str):
+        DropdownUtils.__selectDropdownValueByPartialLabelText(wait, dropdown_label, value)
 
     @staticmethod
-    def selectValueByDropdownWrapperComponent(
-        wait: WebDriverWait, component: WebElement, value: str
-    ):
-        xpath = './div/div[@role="combobox" and @tabindex="0"]'
-        try:
-            combobox = component.find_element(By.XPATH, xpath)
-        except TimeoutError as e:
-            raise TimeoutError(
-                f'Could not find combobox element with xpath "{xpath}" in the provided component: {str(e)}'
-            )
-        except Exception as e:
-            raise Exception(
-                f'Could not find combobox element with xpath "{xpath}" in the provided component: {str(e)}'
-            )
-        DropdownUtils.selectDropdownValueByComponent(wait, combobox, value)
-        return combobox
+    def checkDropdownOptionValueExists(wait: WebDriverWait, dropdown_label: str, value: str):
+        combobox = DropdownUtils.__findComboboxByLabelText(wait, dropdown_label)
+        DropdownUtils.__clickCombobox(wait, combobox)
+        dropdown_option_id = DropdownUtils.__findDropdownOptionId(wait, combobox)
+        return DropdownUtils.__checkDropdownOptionValueExistsByDropdownOptionId(wait, dropdown_option_id, value)

robo_appian/components/InputUtils.py

@@ -19,7 +19,7 @@ class InputUtils:
     """
 
     @staticmethod
-    def setValueAndSubmitUsingComponent(component: WebElement, value: str):
+    def setValueAndSubmitByComponent(component: WebElement, value: str):
         """
         Sets a value in an input component and submits it using the provided component element.
 
@@ -31,7 +31,7 @@ class InputUtils:
             The Selenium WebElement for the input component after setting the value and submitting.
 
         Example:
-            InputUtils.setValueAndSubmitUsingComponent(component, "test_user")
+            InputUtils.setValueAndSubmitByComponent(component, "test_user")
 
         """
         # This method assumes that the component is already found and passed as an argument.
@@ -46,7 +46,7 @@ class InputUtils:
         return component
 
     @staticmethod
-    def __findInputComponentsByLabelPath(wait: WebDriverWait, xpath: str):
+    def __findInputComponentsByXpath(wait: WebDriverWait, xpath: str):
         label_components = ComponentUtils.findComponentsByXPath(wait, xpath)
         input_components = []
         for label_component in label_components:
@@ -71,13 +71,13 @@ class InputUtils:
     @staticmethod
     def __findInputComponentsByPartialLabel(wait: WebDriverWait, label: str):
         xpath = f'.//div/label[contains(normalize-space(text()), "{label}")]'
-        components = InputUtils.__findInputComponentsByLabelPath(wait, xpath)
+        components = InputUtils.__findInputComponentsByXpath(wait, xpath)
         return components
 
     @staticmethod
     def __findInputComponentsByLabel(wait: WebDriverWait, label: str):
         xpath = f'.//div/label[normalize-space(text())="{label}"]'
-        components = InputUtils.__findInputComponentsByLabelPath(wait, xpath)
+        components = InputUtils.__findInputComponentsByXpath(wait, xpath)
         return components
 
     @staticmethod

robo_appian/components/SearchDropdownUtils.py

@@ -0,0 +1,75 @@
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+from selenium.webdriver.common.by import By
+from robo_appian.components.InputUtils import InputUtils
+
+
+class SearchDropdownUtils:
+    """
+    Utility class for interacting with search dropdown components in Appian UI.
+    Usage Example:
+        # Select a value from a search dropdown
+        from robo_appian.components.SearchDropdownUtils import SearchDropdownUtils
+        SearchDropdownUtils.selectSearchDropdownValueByLabelText(wait, "Status", "Approved")
+    """
+
+    @staticmethod
+    def __selectSearchDropdownValueByDropdownOptionId(wait, component_id, dropdown_option_id, value):
+        input_component_id = str(component_id) + "_searchInput"
+        try:
+            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}")
+        InputUtils._setComponentValue(input_component, value)
+
+        xpath = f'.//ul[@id="{dropdown_option_id}"]/li[./div[normalize-space(text())="{value}"]][1]'
+        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}")
+        component.click()
+
+    @staticmethod
+    def __selectSearchDropdownValueByPartialLabelText(wait: WebDriverWait, label: str, value: str):
+        xpath = f'.//div[./div/span[contains(normalize-space(text()), "{label}")]]/div/div/div/div[@role="combobox" and not(@aria-disabled="true")]'
+        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 component with XPath '{xpath}': {e}")
+        component_id = component.get_attribute("aria-labelledby")
+        dropdown_id = component.get_attribute("aria-controls")
+        component.click()
+
+        SearchDropdownUtils.__selectSearchDropdownValueByDropdownOptionId(wait, component_id, dropdown_id, value)
+
+    @staticmethod
+    def __selectSearchDropdownValueByLabelText(wait: WebDriverWait, label: str, value: str):
+        xpath = f'.//div[./div/span[normalize-space(text())="{label}"]]/div/div/div/div[@role="combobox" and not(@aria-disabled="true")]'
+        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 component with XPath '{xpath}': {e}")
+        component_id = component.get_attribute("aria-labelledby")
+        dropdown_option_id = component.get_attribute("aria-controls")
+        component.click()
+        SearchDropdownUtils.__selectSearchDropdownValueByDropdownOptionId(wait, component_id, dropdown_option_id, value)
+
+    @staticmethod
+    def selectSearchDropdownValueByLabelText(wait: WebDriverWait, dropdown_label: str, value: str):
+        """Selects a value from a search dropdown by label text.
+        Args:
+            wait (WebDriverWait): The WebDriverWait instance to use for waiting.
+            dropdown_label (str): The label text of the dropdown.
+            value (str): The value to select from the dropdown.
+        """
+        SearchDropdownUtils.__selectSearchDropdownValueByLabelText(wait, dropdown_label, value)
+
+    @staticmethod
+    def selectSearchDropdownValueByPartialLabelText(wait: WebDriverWait, dropdown_label: str, value: str):
+        """Selects a value from a search dropdown by partial label text.
+        Args:
+            wait (WebDriverWait): The WebDriverWait instance to use for waiting.
+            dropdown_label (str): The label text of the dropdown.
+            value (str): The value to select from the dropdown.
+        """
+        SearchDropdownUtils.__selectSearchDropdownValueByPartialLabelText(wait, dropdown_label, value)

robo_appian/components/TabUtils.py

@@ -10,15 +10,15 @@ class TabUtils:
 
         # Select a tab by its label
         from robo_appian.components.TabUtils import TabUtils
-        TabUtils.select_tab(wait, "Settings")
+        TabUtils.selectInactiveTab(wait, "Settings")
 
         # Find the currently selected tab by its label
         from robo_appian.components.TabUtils import TabUtils
-        selected_tab = TabUtils.find_selected_tab(wait, "Settings")
+        selected_tab = TabUtils.findSelectedTab(wait, "Settings")
     """
 
     @staticmethod
-    def find_selected_tab(wait, label):
+    def findSelectedTab(wait, label):
         """
         Finds the currently selected tab by its label.
 
@@ -30,7 +30,7 @@ class TabUtils:
             The Selenium WebElement for the selected tab.
 
         Example:
-            TabUtils.find_selected_tab(wait, "Settings")
+            TabUtils.findSelectedTab(wait, "Settings")
         """
         # This method locates a tab that is currently selected and contains the specified label.
 
@@ -44,7 +44,7 @@ class TabUtils:
         return component
 
     @staticmethod
-    def select_tab(wait, label):
+    def selectInactiveTab(wait, label):
         """
         Selects a tab by its label.
 
@@ -53,7 +53,7 @@ class TabUtils:
             label: The visible text label of the tab to select.
 
         Example:
-            TabUtils.select_tab(wait, "Settings")
+            TabUtils.selectInactiveTab(wait, "Settings")
         """
         # This method locates a tab that contains a label with the specified text.
 

robo_appian/components/TableUtils.py

@@ -11,12 +11,12 @@ class TableUtils:
 
         # Find a table using a column name
         from robo_appian.components.TableUtils import TableUtils
-        table = TableUtils.findTableUsingColumnName(wait, "Status")
+        table = TableUtils.findTableByColumnName(wait, "Status")
 
     """
 
     @staticmethod
-    def findTableUsingColumnName(wait: WebDriverWait, columnName: str):
+    def findTableByColumnName(wait: WebDriverWait, columnName: str):
         """
         Finds a table component that contains a column with the specified name.
 
@@ -28,7 +28,7 @@ class TableUtils:
             The Selenium WebElement for the table component.
 
         Example:
-            table = TableUtils.findTableUsingColumnName(wait, "Status")
+            table = TableUtils.findTableByColumnName(wait, "Status")
 
         """
         # This method locates a table that contains a header cell with the specified column name.
@@ -49,89 +49,6 @@ class TableUtils:
             )
         return component
 
-    @staticmethod
-    def clickOnLinkUsingHoverText(wait, columnName, rowNumber, hoverText):
-        """
-        Clicks on a link in a table cell identified by its column name, row number, and the hover text of the link.
-
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            columnName: The name of the column where the link is located.
-            rowNumber: The row number (0-based index) where the link is located.
-            hoverText: The text that appears when hovering over the link.
-
-        Example:
-            TableUtils.clickOnLinkUsingHoverText(wait, "Status", 2, "View Details")
-
-        """
-
-        # This method locates a link within a specific table cell based on the column name and row number.
-        # It constructs an XPath that targets the table cell containing the link with the specified hover text.
-        # The XPath first identifies the table by the column name, then finds the specific row and cell,
-        # and finally looks for the link with the specified hover text.
-
-        xpath = f".//table[./thead/tr/th[@abbr='{columnName}']]/tbody/tr[@data-dnd-name='row {rowNumber + 1}']/td[not (@data-empty-grid-message)]/div/p/a[./span[text()='{hoverText}']]"
-        # xpath=f".//table[./thead/tr/th/div[text()='{columnName}']][1]/tbody/tr[@data-dnd-name='row {rowNumber}']/td/div/p/a[./span[text()='{hoverText}']]"
-        try:
-            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-        except TimeoutError as e:
-            raise TimeoutError(
-                f"Could not find link with hover text '{hoverText}' in column '{columnName}', row {rowNumber}: {e}"
-            )
-        except Exception as e:
-            raise RuntimeError(
-                f"Could not find link with hover text '{hoverText}' in column '{columnName}', row {rowNumber}: {e}"
-            )
-        component.click()
-
-    @staticmethod
-    def clickOnButtonUsingHoverText(wait, columnName, rowNumber, hoverText):
-        """
-        Clicks on a button in a table cell identified by its column name, row number, and the hover text of the button.
-
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            columnName: The name of the column where the button is located.
-            rowNumber: The row number (0-based index) where the button is located.
-            hoverText: The text that appears when hovering over the button.
-
-        Example:
-            TableUtils.clickOnButtonUsingHoverText(wait, "Actions", 2, "Delete")
-
-        """
-        # This method locates a button within a specific table cell based on the column name and row number.
-        # It constructs an XPath that targets the table cell containing the button with the specified hover text.
-        # The XPath first identifies the table by the column name, then finds the specific row and cell,
-        # and finally looks for the button with the specified hover text.
-
-        # TODO rowNumber = rowNumber + 1  # Adjusting for 1-based index in XPath
-
-        xpath = f".//table[./thead/tr/th[@abbr='{columnName}']]/tbody/tr[@data-dnd-name='row {rowNumber}']/td[not (@data-empty-grid-message)]"
-        try:
-            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-        except TimeoutError as e:
-            raise TimeoutError(
-                f"Could not find button with hover text '{hoverText}' in column '{columnName}', row {rowNumber}: {e}"
-            )
-        except Exception as e:
-            raise RuntimeError(
-                f"Could not find button with hover text '{hoverText}' in column '{columnName}', row {rowNumber}: {e}"
-            )
-        component.click()
-
-        xpath = f".//table[./thead/tr/th[@abbr='{columnName}']]/tbody/tr[@data-dnd-name='row {rowNumber}']/td[not (@data-empty-grid-message)]/div/div/button[./span[text()='{hoverText}']]"
-        try:
-            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-        except TimeoutError as e:
-            raise TimeoutError(
-                f"Could not find button with hover text '{hoverText}' in column '{columnName}', row {rowNumber}: {e}"
-            )
-        except Exception as e:
-            raise RuntimeError(
-                f"Could not find button with hover text '{hoverText}' in column '{columnName}', row {rowNumber}: {e}"
-            )
-        component.click()
-
     @staticmethod
     def rowCount(tableObject):
         """
@@ -155,7 +72,7 @@ class TableUtils:
         return len(rows)
 
     @staticmethod
-    def findColumNumberUsingColumnName(tableObject, columnName):
+    def findColumNumberByColumnName(tableObject, columnName):
         """
         Finds the column number in a table based on the column name.
 
@@ -167,7 +84,7 @@ class TableUtils:
             The index of the column (0-based).
 
         Example:
-            column_number = TableUtils.findColumNumberUsingColumnName(table, "Status")
+            column_number = TableUtils.findColumNumberByColumnName(table, "Status")
 
         """
         # This method locates the column header cell with the specified column name
@@ -199,7 +116,7 @@ class TableUtils:
         return int(data[1])
 
     @staticmethod
-    def find_component_from_tabele_cell(wait, rowNumber, columnName):
+    def findComponentFromTableCell(wait, rowNumber, columnName):
         """
         Finds a component within a specific table cell based on the row number and column name.
 
@@ -212,17 +129,15 @@ class TableUtils:
             The Selenium WebElement for the component within the specified table cell.
 
         Example:
-            component = TableUtils.find_component_from_tabele_cell(wait, 2, "Status")
+            component = TableUtils.findComponentFromTableCell(wait, 2, "Status")
 
         """
         # This method locates a specific component within a table cell based on the provided row number
         # and column name. It constructs an XPath that targets the table cell containing the specified column
         # and row, and then retrieves the component within that cell.
 
-        tableObject = TableUtils.findTableUsingColumnName(wait, columnName)
-        columnNumber = TableUtils.findColumNumberUsingColumnName(
-            tableObject, columnName
-        )
+        tableObject = TableUtils.findTableByColumnName(wait, columnName)
+        columnNumber = TableUtils.findColumNumberByColumnName(tableObject, columnName)
         # xpath=f'./tbody/tr[@data-dnd-name="row {rowNumber+1}"]/td[not (@data-empty-grid-message)][{columnNumber}]'
         # component = tableObject.find_elements(By.XPATH, xpath)
         rowNumber = rowNumber + 1

robo_appian/controllers/ComponentDriver.py

@@ -1,6 +1,5 @@
 from robo_appian.components.ButtonUtils import ButtonUtils
 from selenium.webdriver.support.ui import WebDriverWait
-from robo_appian.utils.ComponentUtils import ComponentUtils
 from robo_appian.components.DateUtils import DateUtils
 from robo_appian.components.DropdownUtils import DropdownUtils
 from robo_appian.components.InputUtils import InputUtils
@@ -8,6 +7,7 @@ from robo_appian.components.LabelUtils import LabelUtils
 from robo_appian.components.LinkUtils import LinkUtils
 from robo_appian.components.TabUtils import TabUtils
 from robo_appian.components.SearchInputUtils import SearchInputUtils
+from robo_appian.components.SearchDropdownUtils import SearchDropdownUtils
 
 
 class ComponentDriver:
@@ -35,7 +35,6 @@ class ComponentDriver:
         # This method executes an action on a specified component type based on the provided parameters.
 
         match type:
-
             case "Date":
                 match action:
                     case "Set Value":
@@ -51,9 +50,7 @@ class ComponentDriver:
             case "Search Input Text":
                 match action:
                     case "Select":
-                        SearchInputUtils.selectSearchDropdownByLabelText(
-                            wait, label, value
-                        )
+                        SearchInputUtils.selectSearchDropdownByLabelText(wait, label, value)
                     case _:
                         raise ValueError(f"Unsupported action for {type}: {action}")
             case "Label":
@@ -77,7 +74,7 @@ class ComponentDriver:
             case "Search Drop Down":
                 match action:
                     case "Select":
-                        DropdownUtils.selectSearchDropdownValueByLabelText(wait, label, value)
+                        SearchDropdownUtils.selectSearchDropdownValueByLabelText(wait, label, value)
                     case _:
                         raise ValueError(f"Unsupported action for {type}: {action}")
             case "Button":
@@ -89,7 +86,7 @@ class ComponentDriver:
             case "Tab":
                 match action:
                     case "Find":
-                        TabUtils.find_selected_tab(wait, label)
+                        TabUtils.findSelectedTab(wait, label)
                     case _:
                         raise ValueError(f"Unsupported action for {type}: {action}")
             case _:

robo_appian/utils/ComponentUtils.py

@@ -4,6 +4,7 @@ from selenium.webdriver.common.by import By
 from selenium.webdriver.common.keys import Keys
 from selenium.webdriver.support import expected_conditions as EC
 from selenium.webdriver.remote.webdriver import WebDriver
+from selenium.webdriver.remote.webelement import WebElement
 from selenium.webdriver.support.ui import WebDriverWait
 
 
@@ -37,6 +38,10 @@ class ComponentUtils:
         yesterday_formatted = yesterday.strftime("%m/%d/%Y")
         return yesterday_formatted
 
+    @staticmethod
+    def findChildComponent(wait: WebDriverWait, component: WebElement, xpath: str):
+        return component.find_element(By.XPATH, xpath)
+
     @staticmethod
     def findSuccessMessage(wait: WebDriverWait, message: str):
         """
@@ -161,9 +166,7 @@ class ComponentUtils:
         length = 0
 
         try:
-            component = wait.until(
-                EC.presence_of_all_elements_located((By.XPATH, xpath))
-            )
+            component = wait.until(EC.presence_of_all_elements_located((By.XPATH, xpath)))
             length = len(component)
         except NoSuchElementException:
             pass
@@ -203,7 +206,7 @@ class ComponentUtils:
         Raises:
             Exception: If no components are found.
         """
-        
+
         # Wait for at least one element to be present
         wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
 

{robo_appian-0.0.9.dist-info → robo_appian-0.0.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: robo_appian
-Version: 0.0.9
+Version: 0.0.11
 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.11.dist-info/RECORD

@@ -0,0 +1,22 @@
+robo_appian/__init__.py,sha256=6u9n2W7P1IKSSr5IPGsg7LhVR1o1uYv424mXDjJLgb0,720
+robo_appian/components/ButtonUtils.py,sha256=cNCQ21BCbSIqO8gaz0CxBaGx_uQf4Cbrw-YpDEpWfYo,1764
+robo_appian/components/DateUtils.py,sha256=yewRjKarXj6xMA0RtiXu_ZshGXEkkhAu1bmq01uug74,5117
+robo_appian/components/DropdownUtils.py,sha256=11XJ96n1ZcoUaH157Y1I35FaZ53ZmlJnYnPSzy7L1k0,6454
+robo_appian/components/InputUtils.py,sha256=GDLn3ZZ8YrO6NfNgiRH9q1qaHdsE8v1nZTSH4jc3tgw,5102
+robo_appian/components/LabelUtils.py,sha256=bhMM2_lTyx8839ia__8qXVqAhTvnsgPCe7AIcEFYEN0,1654
+robo_appian/components/LinkUtils.py,sha256=R8B4xj7V6agyz9m2GFt_jQQE8yjHPd6R5T3Pn8YRxCk,1397
+robo_appian/components/SearchDropdownUtils.py,sha256=6Rsw3PiJZ6UnPWimNGZeHIwYDPGiuACjlx0_2VBwVbs,4040
+robo_appian/components/SearchInputUtils.py,sha256=EKajPjmeuEHwY4aswHXAEhO8I4igS3icWovK_rZV6K8,3064
+robo_appian/components/TabUtils.py,sha256=e3zk9hPXwynyA0aEIr5DEm2wpSvT8yewqKAUyWYUjzw,2575
+robo_appian/components/TableUtils.py,sha256=X0iA7saWm72Qgz_oZ4dnE3wp8-44Xdj16zzUnazGUIQ,6062
+robo_appian/components/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+robo_appian/controllers/ComponentDriver.py,sha256=QD2tEIJnl0bLwx9Vt7UQMnQVkg5Ke9287kOjQGSXY8g,4318
+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=Oa4XMey0Gm9lLF0bumrNBB0Z3BKljjwe9Zq3BSNm4Vk,8578
+robo_appian/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+robo_appian-0.0.11.dist-info/LICENSE,sha256=g-xR4dRa9_4iFkMoJmED-wE-J5hoxbk3105Knhfpjm0,1068
+robo_appian-0.0.11.dist-info/METADATA,sha256=URLQoo4GP1ZYNqhrHidlKlIup_yk56igJHaA407Otp4,4105
+robo_appian-0.0.11.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+robo_appian-0.0.11.dist-info/RECORD,,

robo_appian-0.0.9.dist-info/RECORD

@@ -1,21 +0,0 @@
-robo_appian/__init__.py,sha256=6u9n2W7P1IKSSr5IPGsg7LhVR1o1uYv424mXDjJLgb0,720
-robo_appian/components/ButtonUtils.py,sha256=oezrvj3n95KE7O-O-bkyvtfzrCzD3GJw7Za9QCYnGuc,2793
-robo_appian/components/DateUtils.py,sha256=CyG7vjeks4w_BZzLJALKMvx-wtAeV0DB65g8YRJCHb0,5120
-robo_appian/components/DropdownUtils.py,sha256=Fh6RxepV45QMF8bIlrmPtbXE_i3kQlaHCSBVznOSxR4,7736
-robo_appian/components/InputUtils.py,sha256=gqY5BUuqpcfLY1tn6R33Q5KpsZC7qc0KPqKflrwfBy4,5120
-robo_appian/components/LabelUtils.py,sha256=bhMM2_lTyx8839ia__8qXVqAhTvnsgPCe7AIcEFYEN0,1654
-robo_appian/components/LinkUtils.py,sha256=R8B4xj7V6agyz9m2GFt_jQQE8yjHPd6R5T3Pn8YRxCk,1397
-robo_appian/components/SearchInputUtils.py,sha256=EKajPjmeuEHwY4aswHXAEhO8I4igS3icWovK_rZV6K8,3064
-robo_appian/components/TabUtils.py,sha256=cdWTtIrzraDFR4AIesdqkMqUjuGbYKCs4n6SFHCnML0,2560
-robo_appian/components/TableUtils.py,sha256=sEdX8voQ67h7h2QfpF_GMzjWhsZwCFC2r8g2TfVw_w0,10495
-robo_appian/components/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-robo_appian/controllers/ComponentDriver.py,sha256=faeC_T06aT9XbDnUPqGwpG5ng7wULPmZigyU8TXLCu4,4354
-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=uq1y6_DxH3O-m7vCvtdVE5640Wx8Je8ydA7pbKDrKVw,8398
-robo_appian/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-robo_appian-0.0.9.dist-info/LICENSE,sha256=g-xR4dRa9_4iFkMoJmED-wE-J5hoxbk3105Knhfpjm0,1068
-robo_appian-0.0.9.dist-info/METADATA,sha256=sG_50s_VBR6wQakiLxCrT72Tj0lotW8xGRqBW5i0xeI,4104
-robo_appian-0.0.9.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-robo_appian-0.0.9.dist-info/RECORD,,