robo_appian 0.0.27__py3-none-any.whl

robo_appian/components/InputUtils.py

@@ -0,0 +1,161 @@
+from robo_appian.utils.ComponentUtils import ComponentUtils
+from selenium.webdriver.support import expected_conditions as EC
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.remote.webelement import WebElement
+
+
+class InputUtils:
+    """
+    Utility class for interacting with input components in Appian UI.
+    Usage Example:
+        from robo_appian.components.InputUtils import InputUtils
+
+        # Set a value in an input component by its label
+        InputUtils.setValueByLabelText(wait, "Username", "test_user")
+
+        # Set a value in an input component by its ID
+        InputUtils.setValueById(wait, "inputComponentId", "test_value")
+    """
+
+    @staticmethod
+    def __findComponentByPartialLabel(wait: WebDriverWait, label: str):
+        """
+        Finds an input component by its label text, allowing for partial matches.
+
+        Parameters:
+            wait: Selenium WebDriverWait instance.
+            label: The visible text label of the input component, allowing for partial matches.
+
+        Returns:
+            A Selenium WebElement representing the input component.
+
+        Example:
+            InputUtils.__findInputComponentByPartialLabel(wait, "User")
+        """
+
+        xpath = f'.//div/label[contains(normalize-space(.), "{label}")]'
+        label_component = ComponentUtils.waitForComponentToBeVisibleByXpath(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 __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 Selenium WebElement representing the input component.
+
+        Example:
+            InputUtils.__findComponentByLabel(wait, "Username")
+        """
+
+        xpath = f'.//div/label[normalize-space(.)="{label}"]'
+        label_component = ComponentUtils.waitForComponentToBeVisibleByXpath(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):
+        """
+        Sets a value in an input component.
+        Parameters:
+            component: The Selenium WebElement for the input component.
+            value: The value to set in the input field.
+        Returns:
+            The Selenium WebElement for the input component after setting the value.
+        Example:
+            InputUtils._setValueByComponent(component, "test_value")
+        """
+        wait.until(EC.element_to_be_clickable(component))
+        component.clear()
+        component.send_keys(value)
+        return component
+
+    @staticmethod
+    def setValueByPartialLabelText(wait: WebDriverWait, label: str, value: str):
+        """
+        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 (partial match).
+            value: The value to set in the input field.
+
+        Returns:
+            None
+        """
+        component = InputUtils.__findComponentByPartialLabel(wait, label)
+        InputUtils._setValueByComponent(wait, component, value)
+
+    @staticmethod
+    def setValueByLabelText(wait: WebDriverWait, label: str, value: str):
+        """
+        Sets a value in an input component identified by its label text.
+
+        Parameters:
+            wait: Selenium WebDriverWait instance.
+            label: The visible text label of the input component.
+            value: The value to set in the input field.
+
+        Returns:
+            None
+
+        Example:
+            InputUtils.setValueByLabelText(wait, "Username", "test_user")
+        """
+        component = InputUtils.__findComponentByLabel(wait, label)
+        InputUtils._setValueByComponent(wait, component, value)
+
+    @staticmethod
+    def setValueById(wait: WebDriverWait, id: str, value: str):
+        """
+        Sets a value in an input component identified by its ID.
+
+        Parameters:
+            wait: Selenium WebDriverWait instance.
+            id: The ID of the input component.
+            value: The value to set in the input field.
+
+        Returns:
+            The Selenium WebElement for the input component after setting the value.
+
+        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}")
+        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.waitForComponentToBeVisibleByXpath(wait, xpath)
+        InputUtils._setValueByComponent(wait, component, value)

robo_appian/components/LabelUtils.py

@@ -0,0 +1,67 @@
+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:
+    """
+    Utility class for interacting with label components in Appian UI.
+    Usage Example:
+        # Find a label by its text
+        component = LabelUtils._findByLabelText(wait, "Submit")
+        # Click a label by its text
+        LabelUtils.clickByLabelText(wait, "Submit")
+    """
+
+    @staticmethod
+    def __findByLabelText(wait: WebDriverWait, label: str):
+        """
+        Finds a label element by its text.
+
+        :param wait: Selenium WebDriverWait instance.
+        :param label: The text of the label to find.
+        :return: WebElement representing the label.
+        Example:
+            component = LabelUtils._findByLabelText(wait, "Submit")
+        """
+        xpath = f'//*[normalize-space(translate(., "\u00a0", " "))="{label}"]'
+        try:
+            # component = wait.until(EC.visibility_of_element_located((By.XPATH, xpath)))
+            component = ComponentUtils.waitForComponentToBeVisibleByXpath(wait, xpath)
+        except Exception as e:
+            raise Exception(f"Label with text '{label}' not found.") from e
+
+        return component
+
+    @staticmethod
+    def clickByLabelText(wait: WebDriverWait, label: str):
+        """
+        Clicks a label element identified by its text.
+
+        :param wait: Selenium WebDriverWait instance.
+        :param label: The text of the label to click.
+        Example:
+            LabelUtils.clickByLabelText(wait, "Submit")
+        """
+        component = LabelUtils.__findByLabelText(wait, label)
+        wait.until(EC.element_to_be_clickable(component))
+        component.click()
+
+    @staticmethod
+    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(translate(., "\u00a0", " "))="{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

robo_appian/components/LinkUtils.py

@@ -0,0 +1,46 @@
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support import expected_conditions as EC
+from selenium.webdriver.support.ui import WebDriverWait
+
+
+class LinkUtils:
+    """
+    Utility class for handling link operations in Selenium WebDriver.
+    Example usage:
+        from selenium import webdriver
+        from selenium.webdriver.support.ui import WebDriverWait
+        from robo_appian.components.LinkUtils import LinkUtils
+
+        driver = webdriver.Chrome()
+        wait = WebDriverWait(driver, 10)
+        LinkUtils.click(wait, "Learn More")
+        driver.quit()
+    """
+
+    @staticmethod
+    def find(wait: WebDriverWait, label: str):
+        # xpath = f'.//a[normalize-space(.)="{label}"]'
+        xpath = f'.//a[normalize-space(.)="{label}" and not(ancestor::*[@aria-hidden="true"])]'
+        try:
+            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
+
+    @staticmethod
+    def click(wait: WebDriverWait, label: str):
+        """
+        Clicks a link identified by its label.
+
+        Parameters:
+            wait: Selenium WebDriverWait instance.
+            label: The visible text label of the link.
+
+        Example:
+            LinkUtils.click(wait, "Learn More")
+        """
+
+        component = LinkUtils.find(wait, label)
+        wait.until(EC.element_to_be_clickable(component))
+        component.click()
+        return component

robo_appian/components/SearchDropdownUtils.py

@@ -0,0 +1,91 @@
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+from selenium.webdriver.common.by import By
+from selenium.webdriver.remote.webelement import WebElement
+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 __selectSearchDropdownValueByDropdownId(wait: WebDriverWait, component_id: str, value: str):
+        if not component_id:
+            raise ValueError("Invalid component_id provided.")
+
+        input_component_id = str(component_id) + "_searchInput"
+        try:
+            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 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"
+
+        xpath = f'.//ul[@id="{dropdown_option_id}"]/li[./div[normalize-space(.)="{value}"]][1]'
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        except Exception as e:
+            raise Exception(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(.), "{label}")]]/div/div/div/div[@role="combobox" and not(@aria-disabled="true")]'
+        try:
+            combobox = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        except Exception as e:
+            raise Exception(f"Failed to locate or click dropdown component with XPath '{xpath}': {e}")
+
+        SearchDropdownUtils._selectSearchDropdownValueByComboboxComponent(wait, combobox, value)
+
+    @staticmethod
+    def __selectSearchDropdownValueByLabelText(wait: WebDriverWait, label: str, value: str):
+        xpath = (
+            f'.//div[./div/span[normalize-space(.)="{label}"]]/div/div/div/div[@role="combobox" and not(@aria-disabled="true")]'
+        )
+        try:
+            combobox = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        except Exception as e:
+            raise Exception(f"Failed to locate or click dropdown component with XPath '{xpath}': {e}")
+        SearchDropdownUtils._selectSearchDropdownValueByComboboxComponent(wait, combobox, value)
+
+    @staticmethod
+    def _selectSearchDropdownValueByComboboxComponent(wait: WebDriverWait, combobox: WebElement, value: str):
+        id = combobox.get_attribute("id")
+        if id is not None:
+            component_id = id.rsplit("_value", 1)[0]
+        else:
+            raise Exception("Combobox element does not have an 'id' attribute.")
+
+        wait.until(EC.element_to_be_clickable(combobox))
+        combobox.click()
+
+        SearchDropdownUtils.__selectSearchDropdownValueByDropdownId(wait, component_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/SearchInputUtils.py

@@ -0,0 +1,63 @@
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support import expected_conditions as EC
+from robo_appian.components.InputUtils import InputUtils
+from robo_appian.utils.ComponentUtils import ComponentUtils
+
+
+class SearchInputUtils:
+    """
+    Utility class for handling search input operations in Selenium WebDriver.
+    Example usage:
+        from selenium import webdriver
+        from selenium.webdriver.support.ui import WebDriverWait
+        from robo_appian.components.SearchInputUtils import SearchInputUtils
+
+        driver = webdriver.Chrome()
+        wait = WebDriverWait(driver, 10)
+        SearchInputUtils.selectSearchDropdownByLabelText(wait, "Search Label", "Value")
+        driver.quit()
+    """
+
+    @staticmethod
+    def __findSearchInputComponentsByLabelPathAndSelectValue(wait: WebDriverWait, xpath: str, value: str):
+        search_input_components = ComponentUtils.findComponentsByXPath(wait, xpath)
+        input_components = []
+        for search_input_component in search_input_components:
+            attribute: str = "aria-controls"
+            dropdown_list_id = search_input_component.get_attribute(attribute)
+            if dropdown_list_id:
+                InputUtils._setValueByComponent(wait, search_input_component, value)
+                xpath = f'.//ul[@id="{dropdown_list_id}" and @role="listbox" ]/li[@role="option" and @tabindex="-1" and ./div/div/div/div/div/div/p[normalize-space(.)="{value}"][1]]'
+                try:
+                    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 Exception(
+                        f"Dropdown item with value '{value}' not found for component '{search_input_component.text}'."
+                    ) from e
+                drop_down_item.click()
+            else:
+                raise ValueError(
+                    f"Search input component with label '{search_input_component.text}' does not have 'aria-controls' attribute."
+                )
+
+        return input_components
+
+    @staticmethod
+    def __selectSearchInputComponentsByPartialLabelText(wait: WebDriverWait, label: str, value: str):
+        xpath = f".//div[./div/span[contains(normalize-space(.)='{label}']]/div/div/div/input[@role='combobox']"
+        SearchInputUtils.__findSearchInputComponentsByLabelPathAndSelectValue(wait, xpath, value)
+
+    @staticmethod
+    def __selectSearchInputComponentsByLabelText(wait: WebDriverWait, label: str, value: str):
+        xpath = f".//div[./div/span[text()='{label}']]/div/div/div/input[@role='combobox']"
+        SearchInputUtils.__findSearchInputComponentsByLabelPathAndSelectValue(wait, xpath, value)
+
+    @staticmethod
+    def selectSearchDropdownByLabelText(wait: WebDriverWait, label: str, value: str):
+        SearchInputUtils.__selectSearchInputComponentsByLabelText(wait, label, value)
+
+    @staticmethod
+    def selectSearchDropdownByPartialLabelText(wait: WebDriverWait, label: str, value: str):
+        SearchInputUtils.__selectSearchInputComponentsByPartialLabelText(wait, label, value)

robo_appian/components/TabUtils.py

@@ -0,0 +1,60 @@
+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 TabUtils:
+    """
+    Utility class for handling tab components in a web application using Selenium.
+    Example usage:
+        from selenium import webdriver
+        from selenium.webdriver.support.ui import WebDriverWait
+        from robo_appian.components.TabUtils import TabUtils
+
+        driver = webdriver.Chrome()
+        wait = WebDriverWait(driver, 10)
+
+        # Find a selected tab by its label
+        selected_tab = TabUtils.findSelectedTabByLabelText(wait, "Tab Label")
+
+        # Select an inactive tab by its label
+        TabUtils.selectTabByLabelText(wait, "Inactive Tab Label")
+
+        driver.quit()
+    """
+    @staticmethod
+    def __click(wait: WebDriverWait, component: WebElement, label: str):
+        try:
+            component = wait.until(EC.element_to_be_clickable(component))
+            component.click()
+        except Exception:
+            raise Exception(f"Tab with label '{label}' is not clickable.")
+
+    @staticmethod
+    def findTabByLabelText(wait: WebDriverWait, label: str) -> WebElement:
+        xpath = f'//div/div[@role="link" ]/div/div/div/div/div/p[normalize-space(.)="{label}"]'
+        try:
+            component = wait.until(EC.visibility_of_element_located((By.XPATH, xpath)))
+        except Exception:
+            raise Exception(f"Tab with label '{label}' not found.")
+        return component
+
+    @staticmethod
+    def selectTabByLabelText(wait: WebDriverWait, label: str):
+        component = TabUtils.findTabByLabelText(wait, label)
+        TabUtils.__click(wait, component, label)
+
+    @staticmethod
+    def checkTabSelectedByLabelText(wait: WebDriverWait, label: str):
+        component = TabUtils.findTabByLabelText(wait, label)
+
+        select_text = "Selected Tab."
+        xpath = f'./span[normalize-space(.)="{select_text}"]'
+        try:
+            component = ComponentUtils.findChildComponentByXpath(wait, component, xpath)
+        except Exception:
+            return False
+
+        return True

robo_appian/components/TableUtils.py

@@ -0,0 +1,149 @@
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support import expected_conditions as EC
+from selenium.webdriver.support.ui import WebDriverWait
+from robo_appian.utils.ComponentUtils import ComponentUtils
+
+
+class TableUtils:
+    """
+    Utility class for handling table operations in Selenium WebDriver.
+    Example usage:
+        from selenium import webdriver
+        from selenium.webdriver.support.ui import WebDriverWait
+        from robo_appian.components.TableUtils import TableUtils
+
+        driver = webdriver.Chrome()
+        wait = WebDriverWait(driver, 10)
+        table = TableUtils.findTableByColumnName(wait, "Status")
+        row_count = TableUtils.rowCount(table)
+        component = TableUtils.findComponentFromTableCell(wait, 1, "Status")
+        driver.quit()
+
+    """
+
+    @staticmethod
+    def rowCount(tableObject):
+        """
+        Counts the number of rows in a table.
+
+        :param tableObject: The Selenium WebElement representing the table.
+        :return: The number of rows in the table.
+        Example:
+            row_count = TableUtils.rowCount(table)
+        """
+
+        xpath = "./tbody/tr[./td[not (@data-empty-grid-message)]]"
+        try:
+            rows = tableObject.find_elements(By.XPATH, xpath)
+        except Exception as e:
+            raise Exception(f"Could not count rows in table: {e}")
+        return len(rows)
+
+    @staticmethod
+    def __findColumNumberByColumnName(tableObject, columnName):
+        """
+        Finds the column number in a table by its column name.
+
+        :param tableObject: The Selenium WebElement representing the table.
+        :param columnName: The name of the column to search for.
+        :return: The index of the column (0-based).
+        Example:
+            column_number = TableUtils.__findColumNumberByColumnName(table, "Status")
+        """
+
+        xpath = f'./thead/tr/th[@scope="col" and @abbr="{columnName}"]'
+        component = tableObject.find_element(By.XPATH, xpath)
+
+        if component is None:
+            raise ValueError(f"Could not find a column with abbr '{columnName}' in the table header.")
+
+        class_string = component.get_attribute("class")
+        partial_string = "headCell_"
+        words = class_string.split()
+        selected_word = None
+
+        for word in words:
+            if partial_string in word:
+                selected_word = word
+
+        if selected_word is None:
+            raise ValueError(f"Could not find a class containing '{partial_string}' in the column header for '{columnName}'.")
+
+        data = selected_word.split("_")
+        return int(data[1])
+
+    @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[@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
+
+    @staticmethod
+    def findComponentFromTableCell(wait, rowNumber, columnName):
+        """
+        Finds a component within a specific cell of a table by row number and column name.
+
+        :param wait: Selenium WebDriverWait instance.
+        :param rowNumber: The row number (0-based index).
+        :param columnName: The name of the column to search in.
+        :return: WebElement representing the component in the specified cell.
+        Example:
+            component = TableUtils.findComponentFromTableCell(wait, 1, "Status")
+        """
+
+        tableObject = TableUtils.findTableByColumnName(wait, columnName)
+        columnNumber = TableUtils.__findColumNumberByColumnName(tableObject, columnName)
+        rowNumber = rowNumber + 1
+        columnNumber = columnNumber + 1
+        xpath = f'.//table[./thead/tr/th[@abbr="{columnName}"]]/tbody/tr[@data-dnd-name="row {rowNumber}"]/td[not (@data-empty-grid-message)][{columnNumber}]/*'
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        except Exception as e:
+            raise Exception(f"Could not find component in cell at row {rowNumber}, column '{columnName}': {e}")
+        return component
+
+    @staticmethod
+    def selectRowFromTableByColumnNameAndRowNumber(wait, rowNumber, columnName):
+        row = TableUtils.__findRowByColumnNameAndRowNumber(wait, rowNumber, columnName)
+        row = wait.until(EC.element_to_be_clickable(row))
+        row.click()
+
+    @staticmethod
+    def findComponentByColumnNameAndRowNumber(wait, rowNumber, 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)
+        columnNumber = int(parts[-1])
+
+        tableRow = TableUtils.__findRowByColumnNameAndRowNumber(wait, rowNumber, columnName)
+        xpath = f"./td[{columnNumber + 1}]/*"
+        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/components/__init__.py

@@ -0,0 +1,22 @@
+from robo_appian.components.ButtonUtils import ButtonUtils
+from robo_appian.components.DateUtils import DateUtils
+from robo_appian.components.DropdownUtils import DropdownUtils
+from robo_appian.components.InputUtils import InputUtils
+from robo_appian.components.LabelUtils import LabelUtils
+from robo_appian.components.LinkUtils import LinkUtils
+from robo_appian.components.SearchDropdownUtils import SearchDropdownUtils
+from robo_appian.components.TableUtils import TableUtils
+from robo_appian.components.TabUtils import TabUtils
+
+
+__all__ = [
+    "ButtonUtils",
+    "DateUtils",
+    "DropdownUtils",
+    "InputUtils",
+    "LabelUtils",
+    "LinkUtils",
+    "SearchDropdownUtils",
+    "TableUtils",
+    "TabUtils",
+]