robo_appian 0.0.8__tar.gz → 0.0.10__tar.gz

{robo_appian-0.0.8 → robo_appian-0.0.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: robo_appian
-Version: 0.0.8
+Version: 0.0.10
 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.8 → robo_appian-0.0.10}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "robo_appian"
-version = "0.0.8"
+version = "0.0.10"
 description = "Automate your Appian code testing with Python. Boost quality, save time."
 authors = ["Dinil Mithra <dinilmithra@mailme@gmail.com>"]
 readme = "README.md"

{robo_appian-0.0.8 → robo_appian-0.0.10}/robo_appian/components/ButtonUtils.py

@@ -1,7 +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.remote.webdriver import WebDriver
+
 
 class ButtonUtils:
     """
@@ -37,7 +37,16 @@ class ButtonUtils:
         # This method locates a button that contains a span with the specified label text.
 
         xpath = f".//button[./span[contains(translate(normalize-space(.), '\u00a0', ' '), '{label}')]]"
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        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
         return component
 
     @staticmethod
@@ -54,6 +63,7 @@ class ButtonUtils:
         """
         component = ButtonUtils.find(wait, label)
         component.click()
+
     @staticmethod
     def clickInputButtonById(wait: WebDriverWait, id: str):
         """
@@ -67,5 +77,15 @@ class ButtonUtils:
             ButtonUtils.clickInputButtonById(wait, "button_id")
 
         """
-        component = wait.until(EC.element_to_be_clickable((By.ID, id)))
-        component.click()
+        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
+        except Exception as e:
+            raise RuntimeError(
+                f"Input button with id '{id}' not found or not clickable."
+            ) from e
+
+        component.click()

{robo_appian-0.0.8 → robo_appian-0.0.10}/robo_appian/components/DateUtils.py

@@ -1,7 +1,6 @@
 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.webdriver import WebDriver
 from selenium.webdriver.remote.webelement import WebElement
 
 from robo_appian.components.InputUtils import InputUtils
@@ -37,11 +36,18 @@ class DateUtils:
         """
 
         xpath = f".//div/label[text()='{label}']"
-        component: WebElement = wait.until(
-            EC.element_to_be_clickable((By.XPATH, xpath))
-        )
-        if not component:
-            raise ValueError(f"Could not find date component with label '{label}'.")
+        try:
+            component: WebElement = wait.until(
+                EC.element_to_be_clickable((By.XPATH, xpath))
+            )
+        except TimeoutError as e:
+            raise TimeoutError(
+                f"Could not find clickable date component with label '{label}': {e}"
+            )
+        except Exception as e:
+            raise Exception(
+                f"Could not find clickable date component with label '{label}': {e}"
+            )
 
         attribute: str = "for"
         component_id = component.get_attribute(attribute)  # type: ignore[reportUnknownMemberType]
@@ -50,7 +56,16 @@ class DateUtils:
                 f"Could not find component using {attribute} attribute for label '{label}'."
             )
 
-        component = wait.until(EC.element_to_be_clickable((By.ID, component_id)))
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.ID, component_id)))
+        except TimeoutError as e:
+            raise TimeoutError(
+                f"Could not find clickable date input with id '{component_id}': {e}"
+            )
+        except Exception as e:
+            raise Exception(
+                f"Could not find clickable date input with id '{component_id}': {e}"
+            )
         return component
 
     @staticmethod
@@ -101,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-0.0.8 → robo_appian-0.0.10}/robo_appian/components/DropdownUtils.py

@@ -1,9 +1,6 @@
-import stat
-from turtle import st
 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.webdriver import WebDriver
 from selenium.webdriver.remote.webelement import WebElement
 
 from robo_appian.components.InputUtils import InputUtils
@@ -26,10 +23,18 @@ class DropdownUtils:
 
     @staticmethod
     def __findDropdownComponentsByXpath(wait: WebDriverWait, xpath: str):
-
         try:
             # Wait for at least one element to be present
-            wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+            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)}'
+                )
 
             # Find all matching elements
             driver = wait._driver
@@ -59,12 +64,23 @@ class DropdownUtils:
 
     @staticmethod
     def selectDropdownValueByComponent(wait, combobox, value):
-        dropdown_id = combobox.get_attribute("aria-controls")  # type: ignore[reportUnknownMemberType]
+        dropdown_id = combobox.get_attribute("aria-controls")
         combobox.click()
 
         option_xpath = f'.//div/ul[@id="{dropdown_id}"]/li[./div[normalize-space(text())="{value}"]]'
-        component = wait.until(EC.presence_of_element_located((By.XPATH, option_xpath)))
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, option_xpath)))
+        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)}'
+            )
+        except Exception as e:
+            raise Exception(
+                f'Could not find or click dropdown option "{value}" with xpath "{option_xpath}": {str(e)}'
+            )
         component.click()
 
     @staticmethod
@@ -78,7 +94,6 @@ class DropdownUtils:
     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)
 
@@ -86,13 +101,11 @@ class DropdownUtils:
     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)
 
     @staticmethod
     def __selectSearchDropdownValueByXpath(wait, xpath, value):
-
         components = DropdownUtils.__findDropdownComponentsByXpath(wait, xpath)
 
         for component in components:
@@ -102,13 +115,33 @@ class DropdownUtils:
                 component.click()
 
                 input_component_id = str(component_id) + "_searchInput"
-                input_component = wait.until(
-                    EC.element_to_be_clickable((By.ID, input_component_id))
-                )
+                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]'
-                component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+                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()
 
     @staticmethod
@@ -122,7 +155,6 @@ class DropdownUtils:
     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)
 
@@ -130,7 +162,16 @@ class DropdownUtils:
     def selectValueByDropdownWrapperComponent(
         wait: WebDriverWait, component: WebElement, value: str
     ):
-        xpath = f'./div/div[@role="combobox" and @tabindex="0"]'
-        combobox = component.find_element(By.XPATH, xpath)
+        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

{robo_appian-0.0.8 → robo_appian-0.0.10}/robo_appian/components/InputUtils.py

@@ -1,12 +1,9 @@
-import stat
-from numpy import size
 from robo_appian.utils.ComponentUtils import ComponentUtils
 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.support.ui import WebDriverWait
 from selenium.webdriver.remote.webelement import WebElement
-from typing import List
 
 
 class InputUtils:
@@ -22,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.
 
@@ -34,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.
@@ -49,29 +46,38 @@ 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:
             attribute: str = "for"
             component_id = label_component.get_attribute(attribute)  # type: ignore[reportUnknownMemberType]
             if component_id:
-                component = wait.until(
-                    EC.element_to_be_clickable((By.ID, component_id))
-                )
-                input_components.append(component)
+                try:
+                    component = wait.until(
+                        EC.element_to_be_clickable((By.ID, component_id))
+                    )
+                    input_components.append(component)
+                except TimeoutError as e:
+                    raise TimeoutError(
+                        f"Timeout or error finding input component with id '{component_id}': {e}"
+                    )
+                except Exception as e:
+                    raise Exception(
+                        f"Timeout or error finding input component with id '{component_id}': {e}"
+                    )
         return input_components
 
     @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
@@ -109,6 +115,15 @@ class InputUtils:
 
     @staticmethod
     def setValueById(wait: WebDriverWait, component_id: str, value: str):
-        component = wait.until(EC.element_to_be_clickable((By.ID, component_id)))
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.ID, component_id)))
+        except TimeoutError as e:
+            raise TimeoutError(
+                f"Timeout or error finding input component with id '{component_id}': {e}"
+            )
+        except Exception as e:
+            raise Exception(
+                f"Timeout or error finding input component with id '{component_id}': {e}"
+            )
         InputUtils._setComponentValue(component, value)
         return component

{robo_appian-0.0.8 → robo_appian-0.0.10}/robo_appian/components/LabelUtils.py

@@ -1,7 +1,6 @@
 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.webdriver import WebDriver
 
 
 class LabelUtils:
@@ -36,7 +35,17 @@ class LabelUtils:
         # It uses XPath to find the element that matches the text.
 
         xpath = f".//*[normalize-space(text())='{label}']"
-        component = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
+        try:
+            component = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
+        except TimeoutError as e:
+            raise TimeoutError(
+                f"Label '{label}' not found within the timeout period."
+            ) from e
+        except Exception as e:
+            raise Exception(
+                f"Label '{label}' not found within the timeout period."
+            ) from e
+
         return component
 
     @staticmethod

{robo_appian-0.0.8 → robo_appian-0.0.10}/robo_appian/components/LinkUtils.py

@@ -1,11 +1,9 @@
 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.webdriver import WebDriver
 
 
 class LinkUtils:
-    
     """
     Utility class for interacting with link components in Appian UI.
 
@@ -16,15 +14,22 @@ class LinkUtils:
         LinkUtils.click(wait, "Learn More")
 
     """
+
     @staticmethod
     def find(wait: WebDriverWait, label: str):
         xpath = f'.//a[normalize-space(text())="{label}"]'
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        except TimeoutError as e:
+            raise TimeoutError(
+                f"Could not find clickable link with label '{label}': {e}"
+            )
+        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.
 
@@ -35,7 +40,7 @@ class LinkUtils:
         Example:
             LinkUtils.click(wait, "Learn More")
         """
-        
-        component = LinkUtils.find(wait. label)
+
+        component = LinkUtils.find(wait, label)
         component.click()
         return component

{robo_appian-0.0.8 → robo_appian-0.0.10}/robo_appian/components/SearchInputUtils.py

@@ -6,7 +6,6 @@ from robo_appian.utils.ComponentUtils import ComponentUtils
 
 
 class SearchInputUtils:
-
     @staticmethod
     def __findSearchInputComponentsByLabelPathAndSelectValue(
         wait: WebDriverWait, xpath: str, value: str
@@ -19,9 +18,18 @@ class SearchInputUtils:
             if dropdown_list_id:
                 InputUtils._setComponentValue(search_input_component, value)
                 xpath = f".//ul[@id='{dropdown_list_id}' and @role='listbox' ]/li[@role='option']/div/div/div/div/div/div/p[text()='{value}'][1]"
-                drop_down_item = wait.until(
-                    EC.element_to_be_clickable((By.XPATH, xpath))
-                )
+                try:
+                    drop_down_item = wait.until(
+                        EC.element_to_be_clickable((By.XPATH, xpath))
+                    )
+                except TimeoutError as e:
+                    raise TimeoutError(
+                        f"Dropdown item with value '{value}' not found for component '{search_input_component.text}'."
+                    ) from e
+                except Exception as e:
+                    raise RuntimeError(
+                        f"Dropdown item with value '{value}' not found for component '{search_input_component.text}'."
+                    ) from e
                 drop_down_item.click()
             else:
                 raise ValueError(
@@ -52,7 +60,6 @@ class SearchInputUtils:
 
     @staticmethod
     def selectSearchDropdownByLabelText(wait: WebDriverWait, label: str, value: str):
-
         SearchInputUtils.__selectSearchInputComponentsByLabelText(wait, label, value)
 
     @staticmethod

{robo_appian-0.0.8 → robo_appian-0.0.10}/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,16 +30,21 @@ 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.
 
         xpath = f".//div[./div[./div/div/div/div/div/p/strong[normalize-space(text())='{label}']]/span[text()='Selected Tab.']]/div[@role='link']"
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        except TimeoutError as e:
+            raise TimeoutError(f"Could not find selected tab with label '{label}': {e}")
+        except Exception as e:
+            raise RuntimeError(f"Could not find selected tab with label '{label}': {e}")
         return component
 
     @staticmethod
-    def select_tab(wait, label):
+    def selectInactiveTab(wait, label):
         """
         Selects a tab by its label.
 
@@ -48,11 +53,16 @@ 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.
 
         xpath = f".//div[@role='link']/div/div/div/div/div[./p/span[text()='{label}']]"
         # xpath=f".//div[./div[./div/div/div/div/div/p/strong[normalize-space(text())='{label}']]/span[text()='Selected Tab.']]/div[@role='link']"
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        except TimeoutError as e:
+            raise TimeoutError(f"Could not find tab with label '{label}': {e}")
+        except Exception as e:
+            raise RuntimeError(f"Could not find tab with label '{label}': {e}")
         component.click()

robo_appian-0.0.10/robo_appian/components/TableUtils.py

@@ -0,0 +1,157 @@
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support import expected_conditions as EC
+from selenium.webdriver.support.ui import WebDriverWait
+
+
+class TableUtils:
+    """
+    Utility class for interacting with table components in Appian UI.
+
+        Usage Example:
+
+        # Find a table using a column name
+        from robo_appian.components.TableUtils import TableUtils
+        table = TableUtils.findTableByColumnName(wait, "Status")
+
+    """
+
+    @staticmethod
+    def findTableByColumnName(wait: WebDriverWait, columnName: str):
+        """
+        Finds a table component that contains a column with the specified name.
+
+        Parameters:
+            wait: Selenium WebDriverWait instance.
+            columnName: The name of the column to search for in the table.
+
+        Returns:
+            The Selenium WebElement for the table component.
+
+        Example:
+            table = TableUtils.findTableByColumnName(wait, "Status")
+
+        """
+        # This method locates a table that contains a header cell with the specified column name.
+        # It uses XPath to find the table element that has a header cell with the specified 'columnName'.
+        # The 'abbr' attribute is used to match the column name, which is a common practice in Appian UI tables.
+
+        # xpath = f".//table[./thead/tr/th[@abbr='{columnName}']]"
+        xpath = f'.//table[./thead/tr/th[@abbr="{columnName}"]]'
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        except TimeoutError as e:
+            raise TimeoutError(
+                f"Could not find table with column name '{columnName}': {e}"
+            )
+        except Exception as e:
+            raise RuntimeError(
+                f"Could not find table with column name '{columnName}': {e}"
+            )
+        return component
+
+    @staticmethod
+    def rowCount(tableObject):
+        """
+        Returns the number of rows in a table, excluding empty grid messages.
+
+        Parameters:
+            tableObject: The Selenium WebElement representing the table.
+
+        Returns:
+            The number of rows in the table.
+
+        Example:
+            count = TableUtils.rowCount(table)
+
+        """
+        # This method counts the number of rows in a table by finding all the table row elements
+        # that do not have the 'data-empty-grid-message' attribute.
+
+        xpath = "./tbody/tr[./td[not (@data-empty-grid-message)]]"
+        rows = tableObject.find_elements(By.XPATH, xpath)
+        return len(rows)
+
+    @staticmethod
+    def findColumNumberByColumnName(tableObject, columnName):
+        """
+        Finds the column number in a table based on the column name.
+
+        Parameters:
+            tableObject: The Selenium WebElement representing the table.
+            columnName: The name of the column to find.
+
+        Returns:
+            The index of the column (0-based).
+
+        Example:
+            column_number = TableUtils.findColumNumberByColumnName(table, "Status")
+
+        """
+        # This method locates the column header cell with the specified column name
+        # and extracts the column index from its class attribute.
+
+        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 findComponentFromTableCell(wait, rowNumber, columnName):
+        """
+        Finds a component within a specific table cell based on the row number and column name.
+
+        Parameters:
+            wait: Selenium WebDriverWait instance.
+            rowNumber: The row number (0-based index) where the component is located.
+            columnName: The name of the column where the component is located.
+
+        Returns:
+            The Selenium WebElement for the component within the specified table cell.
+
+        Example:
+            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.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
+        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 TimeoutError as e:
+            raise TimeoutError(
+                f"Could not find component in cell at row {rowNumber}, column '{columnName}': {e}"
+            )
+        except Exception as e:
+            raise RuntimeError(
+                f"Could not find component in cell at row {rowNumber}, column '{columnName}': {e}"
+            )
+        # childComponent=component.find_element(By.xpath("./*"))
+        return component

{robo_appian-0.0.8 → robo_appian-0.0.10}/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
@@ -35,7 +34,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":
@@ -77,7 +75,9 @@ class ComponentDriver:
             case "Search Drop Down":
                 match action:
                     case "Select":
-                        DropdownUtils.selectSearchDropdownValueByLabelText(wait, label, value)
+                        DropdownUtils.selectSearchDropdownValueByLabelText(
+                            wait, label, value
+                        )
                     case _:
                         raise ValueError(f"Unsupported action for {type}: {action}")
             case "Button":
@@ -89,7 +89,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-0.0.8 → robo_appian-0.0.10}/robo_appian/utils/ComponentUtils.py

@@ -203,7 +203,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.8/robo_appian/components/TableUtils.py

@@ -1,194 +0,0 @@
-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.webdriver import WebDriver
-
-
-class TableUtils:
-    """
-    Utility class for interacting with table components in Appian UI.
-
-        Usage Example:
-
-        # Find a table using a column name
-        from robo_appian.components.TableUtils import TableUtils
-        table = TableUtils.findTableUsingColumnName(wait, "Status")
-
-    """
-
-    @staticmethod
-    def findTableUsingColumnName(wait: WebDriverWait, columnName: str):
-        """
-        Finds a table component that contains a column with the specified name.
-
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            columnName: The name of the column to search for in the table.
-
-        Returns:
-            The Selenium WebElement for the table component.
-
-        Example:
-            table = TableUtils.findTableUsingColumnName(wait, "Status")
-
-        """
-        # This method locates a table that contains a header cell with the specified column name.
-        # It uses XPath to find the table element that has a header cell with the specified 'columnName'.
-        # The 'abbr' attribute is used to match the column name, which is a common practice in Appian UI tables.
-
-        # xpath = f".//table[./thead/tr/th[@abbr='{columnName}']]"
-        xpath = f'.//table[./thead/tr/th[@abbr="{columnName}"]]'
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-        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}']]"
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-        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)]"
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-        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}']]"
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-        component.click()
-
-    @staticmethod
-    def rowCount(tableObject):
-        """
-        Returns the number of rows in a table, excluding empty grid messages.
-
-        Parameters:
-            tableObject: The Selenium WebElement representing the table.
-
-        Returns:
-            The number of rows in the table.
-
-        Example:
-            count = TableUtils.rowCount(table)
-
-        """
-        # This method counts the number of rows in a table by finding all the table row elements
-        # that do not have the 'data-empty-grid-message' attribute.
-
-        xpath = "./tbody/tr[./td[not (@data-empty-grid-message)]]"
-        rows = tableObject.find_elements(By.XPATH, xpath)
-        return len(rows)
-
-    @staticmethod
-    def findColumNumberUsingColumnName(tableObject, columnName):
-        """
-        Finds the column number in a table based on the column name.
-
-        Parameters:
-            tableObject: The Selenium WebElement representing the table.
-            columnName: The name of the column to find.
-
-        Returns:
-            The index of the column (0-based).
-
-        Example:
-            column_number = TableUtils.findColumNumberUsingColumnName(table, "Status")
-
-        """
-        # This method locates the column header cell with the specified column name
-        # and extracts the column index from its class attribute.
-
-        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 find_component_from_tabele_cell(wait, rowNumber, columnName):
-        """
-        Finds a component within a specific table cell based on the row number and column name.
-
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            rowNumber: The row number (0-based index) where the component is located.
-            columnName: The name of the column where the component is located.
-
-        Returns:
-            The Selenium WebElement for the component within the specified table cell.
-
-        Example:
-            component = TableUtils.find_component_from_tabele_cell(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
-        )
-        # 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
-        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}]/*'
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-        # childComponent=component.find_element(By.xpath("./*"))
-        return component